Merge branch 'main' into debugging-client
This commit is contained in:
MihailRis
@@ -4,6 +4,10 @@
|
||||
|
||||
Callbacks specified in block script.
|
||||
|
||||
> [!WARNING]
|
||||
> events such as on_block_tick, on_block_present, and on_block_removed
|
||||
> can cause performance issues if used carelessly or excessively.
|
||||
|
||||
```lua
|
||||
function on_placed(x, y, z, playerid)
|
||||
```
|
||||
@@ -53,6 +57,21 @@ function on_block_tick(x, y, z, tps: number)
|
||||
Called tps (20 / tick-interval) times per second for a block.
|
||||
Use 1/tps instead of `time.delta()`.
|
||||
|
||||
```lua
|
||||
function on_block_present(x, y, z)
|
||||
```
|
||||
|
||||
Called for a specific block when it appears in the world (generated/loaded/placed).
|
||||
The call occurs within a time period that may depend on the event queue load.
|
||||
Under light load, it occurs during the first tick interval of the block.
|
||||
on_block_tick is not called until the event is called.
|
||||
|
||||
```lua
|
||||
function on_block_removed(x, y, z)
|
||||
```
|
||||
|
||||
Called when chunk containing the block unloads.
|
||||
|
||||
```lua
|
||||
function on_player_tick(playerid: int, tps: int)
|
||||
```
|
||||
|
||||
@@ -201,6 +201,14 @@ Here, *color* can be specified in the following ways:
|
||||
| data:mul(*color* or Canvas) | multiplies a color by the specified color or canvas |
|
||||
| data:add(*color* or Canvas) | adds a color or another canvas to a color |
|
||||
| data:sub(*color* or Canvas) | subtracts a color or another canvas to a color |
|
||||
| data:encode(format: str) | encodes image to specified format and returns bytearray |
|
||||
|
||||
To decode a byte array into a Canvas, use the static method:
|
||||
```lua
|
||||
Canvas.decode(data: Bytearray, format: str) -> Canvas
|
||||
```
|
||||
|
||||
Currently, only png is supported.
|
||||
|
||||
## Inline frame (iframe)
|
||||
|
||||
|
||||
@@ -4,6 +4,10 @@
|
||||
|
||||
Функции для обработки событий, прописываемые в скрипте блока.
|
||||
|
||||
> [!WARNING]
|
||||
> Mass events such as on_block_tick, on_block_present, and on_block_removed,
|
||||
> if used carelessly or excessively, can lead to performance issues.
|
||||
|
||||
```lua
|
||||
function on_placed(x, y, z, playerid)
|
||||
```
|
||||
@@ -53,6 +57,21 @@ function on_block_tick(x, y, z, tps: number)
|
||||
Вызывается tps (20 / tick-interval) раз в секунду для конкретного блока.
|
||||
Используйте 1/tps вместо `time.delta()`.
|
||||
|
||||
```lua
|
||||
function on_block_present(x, y, z)
|
||||
```
|
||||
|
||||
Вызывается для конкретного блока при появлении (генерации/загрузке/размещении).
|
||||
Вызов происходит в течение времени, которое может зависеть от нагрузки очереди событий.
|
||||
При малой нагрузке происходит в течение первого такта блока (tick-interval).
|
||||
До вызова события on_block_tick не вызывается.
|
||||
|
||||
```lua
|
||||
function on_block_removed(x, y, z)
|
||||
```
|
||||
|
||||
Вызывается при выгрузке чанка, в котором находится блок.
|
||||
|
||||
```lua
|
||||
function on_player_tick(playerid: int, tps: int)
|
||||
```
|
||||
|
||||
+23
-15
@@ -186,21 +186,29 @@ document["worlds-panel"]:clear()
|
||||
- r: int, g: int, b: int
|
||||
- r: int, g: int, b: int, a: int
|
||||
|
||||
| Метод | Описание |
|
||||
|----------------------------------------------------------|------------------------------------------------------|
|
||||
| data:at(x: int, y: int) | возвращает RGBA пиксель по указанным координатам |
|
||||
| data:set(x: int, y: int, *цвет*) | изменяет RGBA пиксель по указанным координатам |
|
||||
| data:line(x1: int, y1: int, x2: int, y2: int, *цвет*) | рисует линию с указанным RGBA цветом |
|
||||
| data:blit(src: Canvas, dst_x: int, dst_y: int) | рисует src-холст на указанных координатах |
|
||||
| data:clear() | очищает холст |
|
||||
| data:clear(*цвет*) | заполняет холст указанным RGBA цветом |
|
||||
| data:update() | применяет изменения и загружает холст в видеопамять |
|
||||
| data:set_data(data: table<int>) | заменяет данные пикселей (ширина * высота * 4 чисел) |
|
||||
| data:create_texture(name: str) | создаёт и делится текстурой с рендерером |
|
||||
| data:unbind_texture() | отвязывает текстуру от холста |
|
||||
| data:mul(*цвет* или Canvas) | умножает увет на указанный цвет или холст |
|
||||
| data:add(*цвет* или Canvas) | прибавляет цвет или другой холст к цвету |
|
||||
| data:sub(*цвет* или Canvas) | вычитает цвет или другой холст к цвету |
|
||||
| Метод | Описание |
|
||||
|----------------------------------------------------------|-----------------------------------------------------------------|
|
||||
| data:at(x: int, y: int) | возвращает RGBA пиксель по указанным координатам |
|
||||
| data:set(x: int, y: int, *цвет*) | изменяет RGBA пиксель по указанным координатам |
|
||||
| data:line(x1: int, y1: int, x2: int, y2: int, *цвет*) | рисует линию с указанным RGBA цветом |
|
||||
| data:blit(src: Canvas, dst_x: int, dst_y: int) | рисует src-холст на указанных координатах |
|
||||
| data:clear() | очищает холст |
|
||||
| data:clear(*цвет*) | заполняет холст указанным RGBA цветом |
|
||||
| data:update() | применяет изменения и загружает холст в видеопамять |
|
||||
| data:set_data(data: table<int>) | заменяет данные пикселей (ширина * высота * 4 чисел) |
|
||||
| data:create_texture(name: str) | создаёт и делится текстурой с рендерером |
|
||||
| data:unbind_texture() | отвязывает текстуру от холста |
|
||||
| data:mul(*цвет* или Canvas) | умножает увет на указанный цвет или холст |
|
||||
| data:add(*цвет* или Canvas) | прибавляет цвет или другой холст к цвету |
|
||||
| data:sub(*цвет* или Canvas) | вычитает цвет или другой холст к цвету |
|
||||
| data:encode(format: str) | кодирует изображение в указанный формат и возращает массив байт |
|
||||
|
||||
Для декодирования массива байт в Canvas используйте статический метод:
|
||||
```lua
|
||||
Canvas.decode(data: Bytearray, format: str) -> Canvas
|
||||
```
|
||||
|
||||
На данный момент, из форматов поддерживается только png.
|
||||
|
||||
## Рамка встраивания (iframe)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user