301 lines
5.7 KiB
Markdown
301 lines
5.7 KiB
Markdown
# INERTIA
|
|
|
|
Interfejs do wbudowanego silnika fizycznego 2D o tej samej nazwie (Inertia). Zarządza ciałami sztywnymi: tworzeniem obiektów, ich wiązaniem z animacjami, polem grawitacji, prędkościami, tłumieniem i przykładaniem sił. Wykorzystany w *Reksio i Kretes w Akcji*.
|
|
|
|
Każdy obiekt fizyczny ma identyfikator (`objectId`) — wartość całkowitą używaną przez większość metod do wskazania ciała. Plik definiujący świat fizyczny ma rozszerzenie [`.INE`](../engine/index.md) i jest ładowany jednorazowo metodą [`LOAD`](#load).
|
|
|
|
## Metody
|
|
|
|
### ADDFORCE
|
|
|
|
```
|
|
void ADDFORCE(INTEGER objectId, INTEGER forceX, INTEGER forceY)
|
|
```
|
|
|
|
Przykłada siłę do obiektu w osiach X i Y.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
- `forceX`, `forceY` — składowe siły.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^ADDFORCE(1,-500,0);
|
|
EXTWORLD^ADDFORCE(1,0,-50);
|
|
```
|
|
|
|
### CREATESPHERE
|
|
|
|
```
|
|
void CREATESPHERE(INTEGER objectId, INTEGER posX, INTEGER posY, INTEGER radius)
|
|
```
|
|
|
|
Tworzy w silniku fizycznym sferę o podanej pozycji środka i promieniu, przypisując jej wskazany identyfikator.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator nowego obiektu.
|
|
- `posX`, `posY` — pozycja środka sfery.
|
|
- `radius` — promień sfery.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^CREATESPHERE(5,10,10,10);
|
|
```
|
|
|
|
### DELETEBODY
|
|
|
|
```
|
|
void DELETEBODY(INTEGER objectId)
|
|
```
|
|
|
|
Usuwa obiekt z silnika fizycznego.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator usuwanego obiektu.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^DELETEBODY(IHANDLEDEL);
|
|
EXTWORLD^DELETEBODY(IRAKIETAOBJ);
|
|
```
|
|
|
|
### GETPOSITIONX
|
|
|
|
```
|
|
INTEGER GETPOSITIONX(INTEGER objectId)
|
|
```
|
|
|
|
Zwraca aktualną pozycję X obiektu o podanym identyfikatorze.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
|
|
**Zwraca**: [`INTEGER`](INTEGER.md) — koordynata X.
|
|
|
|
### GETPOSITIONY
|
|
|
|
```
|
|
INTEGER GETPOSITIONY(INTEGER objectId)
|
|
```
|
|
|
|
Zwraca aktualną pozycję Y obiektu o podanym identyfikatorze.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
|
|
**Zwraca**: [`INTEGER`](INTEGER.md) — koordynata Y.
|
|
|
|
### GETSPEED
|
|
|
|
```
|
|
DOUBLE GETSPEED(INTEGER objectId)
|
|
```
|
|
|
|
Zwraca prędkość obiektu o podanym identyfikatorze (długość wektora prędkości liniowej).
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
|
|
**Zwraca**: [`DOUBLE`](DOUBLE.md) — wartość prędkości.
|
|
|
|
### LINK
|
|
|
|
```
|
|
void LINK(INTEGER objectId, STRING animoName, BOOL flag1, BOOL flag2)
|
|
```
|
|
|
|
Wiąże obiekt fizyczny z animacją [`ANIMO`](ANIMO.md) — pozycja animacji jest aktualizowana na podstawie symulacji fizyki. Znaczenie obu flag boolowskich nie zostało jeszcze ustalone (w grach zawsze podawane są jako `TRUE`).
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu fizycznego.
|
|
- `animoName` — nazwa zmiennej [`ANIMO`](ANIMO.md).
|
|
- `flag1`, `flag2` — flagi konfiguracyjne (znaczenie nieustalone).
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^LINK(1,"ANNSZCZUREK",TRUE,TRUE);
|
|
EXTWORLD^LINK(IOBIEKT,["ANNSTRZAL_"+ISTRZAL],TRUE,TRUE);
|
|
```
|
|
|
|
### LOAD
|
|
|
|
```
|
|
void LOAD(STRING path)
|
|
```
|
|
|
|
Ładuje plik `.INE` z definicją świata fizycznego.
|
|
|
|
**Parametry**
|
|
|
|
- `path` — ścieżka do pliku `.INE`.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^LOAD("WORLD.INE");
|
|
```
|
|
|
|
### RESETTIMER
|
|
|
|
```
|
|
void RESETTIMER()
|
|
```
|
|
|
|
Resetuje wewnętrzny zegar symulacji.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^RESETTIMER();
|
|
```
|
|
|
|
### SETGRAVITY
|
|
|
|
```
|
|
void SETGRAVITY(DOUBLE gravityX, DOUBLE gravityY)
|
|
```
|
|
|
|
Ustawia globalny wektor grawitacji. Wartość `(0, 0)` wyłącza grawitację.
|
|
|
|
**Parametry**
|
|
|
|
- `gravityX`, `gravityY` — składowe grawitacji.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^SETGRAVITY(0,0);
|
|
```
|
|
|
|
### SETLINEARDAMPING
|
|
|
|
```
|
|
void SETLINEARDAMPING(INTEGER objectId, INTEGER linearDamping)
|
|
```
|
|
|
|
Ustawia tłumienie liniowe (stopniowe spowalnianie prędkości liniowej) dla obiektu.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
- `linearDamping` — wartość tłumienia.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^SETLINEARDAMPING(1,300);
|
|
```
|
|
|
|
### SETMATERIAL
|
|
|
|
```
|
|
void SETMATERIAL(INTEGER objectId, STRING material)
|
|
```
|
|
|
|
Ustawia materiał obiektu. Materiały kontrolują, w jaki sposób obiekty reagują na kontakt (sztywność, sprężystość, tarcie). W skryptach gier spotykana jest m.in. nazwa `"TRIGGER"`, dla której silnik wywołuje na powiązanej animacji sygnał `ONSIGNAL^TRIGGER`.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
- `material` — nazwa materiału.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^SETMATERIAL(IOBIEKT,"TRIGGER");
|
|
```
|
|
|
|
### SETPOSITION
|
|
|
|
```
|
|
void SETPOSITION(INTEGER objectId, INTEGER posX, INTEGER posY)
|
|
```
|
|
|
|
Ustawia bezwzględną pozycję obiektu w świecie fizycznym.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
- `posX`, `posY` — nowa pozycja.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^SETPOSITION(IOBIEKT,[ANNSZCZUREK^GETCENTERX()+70],[ANNSZCZUREK^GETCENTERY()-1]);
|
|
EXTWORLD^SETPOSITION(IRAKIETAOBJ,ANNDODATKI_7^GETPOSITIONX(),ANNDODATKI_7^GETPOSITIONY());
|
|
```
|
|
|
|
### SETVELOCITY
|
|
|
|
```
|
|
void SETVELOCITY(INTEGER objectId, INTEGER speedX, INTEGER speedY)
|
|
```
|
|
|
|
Ustawia prędkość obiektu w osiach X i Y.
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
- `speedX`, `speedY` — składowe prędkości.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^SETVELOCITY(1,0,0);
|
|
EXTWORLD^SETVELOCITY(IOBIEKT,8,0);
|
|
```
|
|
|
|
### TICK
|
|
|
|
```
|
|
void TICK()
|
|
```
|
|
|
|
Wykonuje pojedynczy krok symulacji. Bez wywołania `TICK` świat fizyczny pozostaje zamrożony — typowo wywoływane z sygnału [`ONTICK`](TIMER.md#ontick) [`TIMER`](TIMER.md).
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^TICK();
|
|
```
|
|
|
|
### UNLINK
|
|
|
|
```
|
|
void UNLINK(INTEGER objectId)
|
|
```
|
|
|
|
Zrywa powiązanie obiektu z animacją utworzone metodą [`LINK`](#link).
|
|
|
|
**Parametry**
|
|
|
|
- `objectId` — identyfikator obiektu.
|
|
|
|
**Przykłady**
|
|
|
|
```
|
|
EXTWORLD^UNLINK(IID);
|
|
EXTWORLD^UNLINK(1);
|
|
```
|
|
|
|
## Sygnały
|
|
|
|
### ONINIT
|
|
|
|
Wywoływany w momencie inicjalizacji obiektu.
|
|
|
|
### ONSIGNAL
|
|
|
|
Wywoływany po otrzymaniu sygnału (zobacz [Zdarzenia i sygnały](../engine/events.md#onsignal)).
|