Obiekt event: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
(lights)
 
(Nie pokazano 45 wersji utworzonych przez 5 użytkowników)
Linia 1: Linia 1:
Każdy wpis '''event''' zaczyna się od tych samych parametrów:
+
Dostępne typy zostały opisane poniżej.
    <span style="color:tomato;font-weight:bold">event</span> ''nazwa typ opoznienie obiekt''
 
  
{| class="wikitable"
+
* [[Obiekt event::AddValues|AddValues]]
|+ Opis parametrów
+
* [[Obiekt event::CopyValues|CopyValues]]
! Nazwa parametru
+
* [[Obiekt event::GetValues|GetValues]]
! Znaczenie parametru
+
* [[Obiekt event::LogValues|LogValues]]
! Typ wartości
+
* [[Obiekt event::PutValues|PutValues]]
! Uwagi
+
* [[Obiekt event::UpdateValues|UpdateValues]]
|-
 
| nazwa
 
| Nazwa zdarzenia
 
| Tekst
 
|
 
|-
 
| typ
 
| Typ zdarzenia.
 
| Słowo kluczowe
 
| Dostępne typy zostały opisane poniżej.
 
|-
 
| opoznienie
 
| Opóźnienie wykonania zdarzenia [s].
 
| Liczba
 
| Można wpisać -1, wtedy zdarzenie będzie wykonywać się cyklicznie.
 
|-
 
| obiekt
 
| Obiekt, na rzecz którego zostanie wywołane zdarzenie.
 
| Nazwa obiektu.
 
| Typ obiektu zależy od typu zdarzenia.
 
|}
 
  
== AddValues ==
+
* [[Obiekt event::animation|animation]]
Działa podobnie jak [[Obiekt_event#UpdateValues|'''event::UpdateValues''']], jednak zamiast zastępować poprzednie wartości komórki pamięci nowymi, dodaje je do siebie. Tekst jest dołączany na końcu tego w komórce pamięci, a liczby są dodawane jako zmiennoprzecinkowe.
+
* [[Obiekt event::lights|lights]]
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">addvalues</span> 0 ''komorka wartosci'' <span style="color:tomato;font-weight:bold">endevent</span>
+
* [[Obiekt event::trackvel|trackvel]]
 +
* [[Obiekt event::visible|visible]]
 +
* [[Obiekt event::voltage|voltage]]
 +
* [[Obiekt event::whois|whois]]
 +
* [[Obiekt event::friction|friction]]
 +
* [[Obiekt event::multiple|multiple]]
 +
* [[Obiekt event::switch|switch]]
 +
* [[Obiekt event::sound|sound]]
 +
* [[Obiekt event::texture|texture]]
 +
* <s>message</s>
  
{| class="wikitable"
+
[[Kategoria:Scenerie]]
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| komorka
 
| Komórka pamięci, do której dodane zostaną wartości
 
| Nazwa obiektu [[Obiekt_node#memcell|'''node::memcell''']]
 
|
 
|-
 
| wartosci
 
| Dodawane wartości.
 
| Tekst, Liczba, Liczba
 
| Można nie podawać wartości, wstawiając w jej miejsce znak '''*'''
 
|}
 
 
 
== CopyValues ==
 
Umożliwia przekopiowanie zawartości jednej komórki do innej.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">copyvalues</span> 0 ''komorka1 komorka2 flaga'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| komorka1
 
| Komórka pamięci, z której kopiowane są wartości.
 
| Nazwa obiektu [[Obiekt_node#memcell|'''node::memcell''']]
 
|
 
|-
 
| komorka2
 
| Komórka pamięci, do której kopiowane są wartości.
 
| Nazwa obiektu [[Obiekt_node#memcell|'''node::memcell''']]
 
|
 
|-
 
| flaga
 
| Suma liczb określająca, które wartości mają być skopiowane.
 
| Liczba
 
| 1 - kopiowanie pierwszej wartości
 
 
 
2 - kopiowanie drugiej wartości
 
 
 
4 - kopiowanie trzeciej wartości
 
 
 
Przykład: Aby skopiować wartość pierwszą i trzecią, należy wpisać liczbę 5 (bo 1 + 4 = 5).
 
|}
 
 
 
== GetValues ==
 
Pobiera informacje z komórki pamięci i wysyła do pojazdu stojącego na torze.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">getvalues</span> 0 ''komorka'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
== LogValues ==
 
Jeśli nie istnieje dana komórka pamięci to zostanie wypisana do logu zawartość wszystkich komórek w scenerii.
 
 
 
== PutValues ==
 
Wysyła informacje do pojazdu stojącego na torze z pominięciem komórki pamięci.
 
 
 
== UpdateValues ==
 
Ładuje informacje do komórki pamięci.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">updatevalues</span> 0 ''komorka wartosci'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| komorka
 
| Komórka pamięci, do której dodane zostaną wartości
 
| Nazwa obiektu [[Obiekt_node#memcell|'''node::memcell''']]
 
|
 
|-
 
| wartosci
 
| Wartości do ustawienia w komórce.
 
| Tekst, Liczba, Liczba
 
| Można nie podawać wartości, wstawiając w jej miejsce znak '''*'''
 
|}
 
 
 
== animation ==
 
Pozwala animować model przez zmianę jego położenia lub kąta obrotu.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">animation</span> 0 ''model typ_animacji submodel wektor tempo'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| model
 
| Model, którego submodel będzie animowany.
 
| Nazwa obiektu [[Obiekt_node#model|'''node::model''']]
 
|
 
|-
 
| typ_animacji
 
| Typ animacji submodelu.
 
| Słowo kluczowe
 
| <span style="color:orange;font-weight:bold">rotate</span> - obrót
 
 
 
<span style="color:orange;font-weight:bold">translate</span> - przemieszczenie
 
|-
 
| submodel
 
| Submodel, który będzie animowany.
 
| Nazwa submodelu z modelu [[Format T3D|T3D]]
 
|
 
|-
 
| wektor
 
| Wektor przesunięcia [m] lub obrotu [deg] modelu.
 
| Liczby
 
|
 
|-
 
| tempo
 
| Tempo przesunięcia w [j/s]
 
| Liczba
 
| Jednostka zależy od typu animacji.
 
|}
 
 
 
== lights ==
 
Zmienia stan świateł modelu.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">lights</span> 0 ''model stany_swiatel'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| model
 
| Model, któremu zostaną ustawione stany świateł.
 
| Nazwa obiektu [[Obiekt_node#model|'''node::model''']]
 
|
 
|-
 
| stany_swiatel
 
| W zależności od ilości zdefiniowanych świateł w modelu, znaleźć tu się muszą liczby opisujące ich stan.
 
| Liczby
 
| 0 - zgaszone
 
 
 
1 - zapalone
 
 
 
2 - pulsujące
 
 
 
3 - świecące tylko nocą
 
|}
 
 
 
Możliwe jest podanie wartości z ułamkiem. Interpretacja wtedy jest następująca:
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! wartość
 
! intepretacja
 
|-
 
| 0.01-0.99
 
| migotanie z pulsacją ułamka t<1s (f>1Hz), np. 0.1 => t=0.1 (f=10Hz)
 
|-
 
| 1.01-1.99
 
| migotanie z wypełnieniem ułamkiem, np. 1.25 => zapalony przez 1/4 okresu
 
|-
 
| 2.01-2.99
 
| migotanie z częstotliwością ułamka f<1Hz (t>1s), np. 2.2 => f=0.2Hz (t=5s)
 
|-
 
| 3.01+
 
| zapalenie świateł zależne od oświetlenia scenerii, gdzie ułamek jest procentowym naświetleniem sceny
 
|}
 
 
 
== trackvel ==
 
Umożliwia zmianę prędkości szlakowej toru.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">trackvel</span> 0 ''tor predkosc'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| tor
 
| Tor, któremu zostanie zmieniona prędkość szlakowa.
 
| Nazwa obiektu [[Obiekt_node#track|'''node::track''']]
 
|
 
|-
 
| predkosc
 
| Wartość prędkości szlakowej [km/h].
 
| Liczba
 
|
 
|}
 
 
 
== visible ==
 
Umożliwia zmianę widoczności obiektu.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">visible</span> 0 ''obiekt widocznosc'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| obiekt
 
| Obiekt typu node.
 
| Nazwa obiektu [[Obiekt_node|'''node''']]
 
|
 
|-
 
| widocznosc
 
| Stan widoczności obiektu
 
| Liczba
 
| 0 - obiekt niewidoczny
 
 
 
1 - obiekt widoczny
 
|}
 
 
 
== voltage ==
 
Umożliwia zmianę wartości napięcia podstacji.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">voltage</span> 0 ''zrodlo_zasilania napiecie'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| zrodlo_zasilania
 
| Źródło zasilania, któremu zmieniane jest napięcie.
 
| Nazwa obiektu [[Obiekt_node#tractionpowersource|'''node::tractionpowersource''']]
 
|
 
|-
 
| napiecie
 
| Wartość napięcia [V].
 
| Liczba
 
|
 
|}
 
 
 
== whois ==
 
Umożliwia identyfikację składu przez wpisanie do komórki pamięci danych pobranych ze składu.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">whois</span> 0 ''komorka jakie_dane'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
! Parametr
 
! Tekst (+1)
 
! Liczba 1 (+2)
 
! Liczba 2 (+4)
 
|-
 
| +0 (1..7)
 
| Plik rozkładu
 
| Ile stacji do końca
 
| 1=postój, 0=przelot
 
|-
 
| +8 (9..15)
 
| Miejsce docelowe
 
| Kierunek w składzie: 1 albo -1
 
| Moc silników (0=wagon)
 
|-
 
| +16 (17..23)
 
| Nazwa ładunku
 
| Ilość ładunku
 
| Maksymalna ilość ładunku
 
|-
 
| +24 (25..31)
 
| Typ pojazdu (CHK)
 
| Stopień zahamowania
 
| 0 (zero)
 
|}
 
 
 
Przykład: W torze umieszczony jest wpis '''event2 test_whois''', którego zadaniem zapisanie do komórek informacji o jadącym taborze
 
 
 
//komórki pamięci
 
node -1 0 mem-typ memcell 0 0 0 none 0 0 none endmemcell
 
node -1 0 mem-lad memcell 0 0 0 none 0 0 none endmemcell
 
node -1 0 mem-doc memcell 0 0 0 none 0 0 none endmemcell
 
node -1 0 mem-roz memcell 0 0 0 none 0 0 none endmemcell
 
//eventy zgrupowane pod jedną nazwą (nie jest to wymagane)
 
config joinduplicatedevents yes endconfig
 
event test_whois whois 0 mem-roz  7 endevent //rozkład
 
event test_whois whois 0 mem-doc 15 endevent //docelowość
 
event test_whois whois 0 mem-lad 23 endevent //ładunek
 
event test_whois whois 0 mem-typ 31 endevent //typ pojazdu
 
event test_whois logvalues 0 none endevent //wpisz do logu
 
config joinduplicatedevents no endconfig
 
 
 
== friction ==
 
Umożliwia zmianę globalnego współczynnika tarcia.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">friction</span> 0 none ''tarcie'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| tarcie
 
| Współczynnik tarcia
 
| Liczba z zakresu <0-1>
 
| Wartości poniżej 0.5 zmniejszają tarcie, a powyżej 0.5 - zwiększają.
 
|}
 
 
 
== multiple ==
 
Umożliwia wywołanie kilku zdarzeń jendocześnie.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">multiple</span> 0 ''komorka'' <span style="color:orange;font-weight:bold">condition</span> ''warunki'' <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| komorka
 
| Komórka piamięci testowana przy warunku. Przy braku wpisać 'none'.
 
| Nazwa komorki [[Obiekt_node#memcell|'''memcell''']]
 
|
 
|-
 
| zdarzenia
 
| Zdarzenia, które mają zostać wywołane.
 
| Nazwy obiektów '''event'''
 
| Można podać maksymalnie 8 zdarzeń do wywołania.
 
|}
 
 
 
== switch ==
 
Umożliwia przestawienie zwrotnicy.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">switch</span> 0 ''zwrotnica przelozenie'' <span style="color:tomato;font-weight:bold">endevent</span>
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| zwrotnica
 
| Zwrotnica, której stan ma być zmieniony.
 
| Nazwa obiektu [[Obiekt_node#switch|'''node::track::switch''']]
 
|
 
|-
 
| przelozenie
 
| Przełożenie zwrotnicy.
 
| Liczba
 
| 0 - jazda na wprost
 
 
 
1 - jazda na bok
 
|}
 
Uwaga! Częściej spotykaną praktyką jest przekładanie zwrotnic za pomocą zdarzeń zaimplementowanych w plikach INC. Realizuje się je za pośrednictwem obiektu [[Obiekt_event#multiple|'''event::multiple''']], podając ich nazwy w parametrze ''zdarzenia'' i dodając do każdej z nich znak:
 
* + (plus) - jazda na wprost
 
* - (minus) - jazda na bok
 
 
 
== <s>disable</s> ==
 
Występuje w kodzie źródłowym, ale nie jest używany.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">disable</span> 0 ? <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
== <s>dynvel</s> ==
 
Występuje w kodzie źródłowym, ale nie jest używany.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">dynvel</span> 0 ? <span style="color:tomato;font-weight:bold">endevent</span>
 
 
 
== <s>message</s> ==
 
Występuje w kodzie źródłowym, ale nie jest używany.
 
    <span style="color:tomato;font-weight:bold">event</span> zdarzenie <span style="color:orange;font-weight:bold">message</span> 0 ? <span style="color:tomato;font-weight:bold">endevent</span>
 

Aktualna wersja na dzień 09:51, 31 mar 2023

Dostępne typy zostały opisane poniżej.