API / mini Series API / 0x01 Set Layer Parameters
Set The Layer Parameters of The Preview Scene
Applicable Devices : mini-pro, mini-pro V3, mini v3, mini-ISO, mini-edge SDI, mini-mx SDI, mini-max, mini-extreme ISO
🚨 These commands contain a data block buffer[].
For clarity, the first 19 bytes are displayed as text, while the data block is displayed in HEX format.
| Symbol | Definition | Remarks |
|---|---|---|
| Start bit | < | The command uses "<" as the start bit |
| Transmit | T | |
| ADDR | 0x00 | |
| SN | 0x00 | |
| CMD | 0xF0 | |
| DAT1 | 0x01 | Set layer parameters |
| DAT2 | 0x00 | Layer index value 0-63 |
| DAT3 | 0x14 | buffer block length (low byte) |
| DAT4 | 0x00 | buffer block length (high byte) |
| CHKSUM | 0x05 | Check sum = ADDR + SN + CMD + DAT1 + DAT2 + DAT3 + DAT4 |
| End bit | > | The command uses ">" as the end bit |
| data block (hex) | buffer[0] | crop pos_x (low byte) |
| buffer[1] | crop pos_x (high byte) | |
| buffer[2] | crop pos_y (low byte) | |
| buffer[3] | crop pos_y (high byte) | |
| buffer[4] | crop size_w (low byte) | |
| buffer[5] | crop size_w (high byte) | |
| buffer[6] | crop size_h (low byte) | |
| buffer[7] | crop size_h (high byte) | |
| buffer[8] | scale pos_x (low byte) | |
| buffer[9] | scale pos_x (high byte) | |
| buffer[10] | scale pos_y (low byte) | |
| buffer[11] | scale pos_y (high byte) | |
| buffer[12] | scale size_w (low byte) | |
| buffer[13] | scale size_w (high byte) | |
| buffer[14] | scale size_h (low byte) | |
| buffer[15] | scale size_h (high byte) | |
| buffer[16] | freeze 0: active 1: frozen | |
| buffer[17] | mirror 0: normal 1: mirror | |
| buffer[18] | input port input source index 0-15 | |
| buffer[19] | Check sum = buffer[0] + buffer[1] + buffer[2]+... + buffer[18] |
Command list
| Start bit | Instruction Type | Address | SN | Command | Data 1 | Data 2 | Data 3 | Data 4 | Checksum | End bit | data block(Hex) | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Set layer parameters | < | T | 00 | 00 | F0 | 01 | 00 | 14 | 00 | 05 | > | 0000000080073804000000008007380400000C92 |
Application example
| Function | Send & readback | Result |
|---|---|---|
| Set layer 1 parameters (cropX:0,cropY:0,cropW: 1920,cropH:1080, scaleX:0, scaleY:0, scaleW:1920, scaleH:1080,freeze :0, mirror:0,input port:13) | <T0000F00100140005> 0000000080073804000000008007380400000C92 | |
| <F0000F01A0041004B> | Set successfully |
After configuring the basic layer parameters, synchronize the remaining layer parameters and save them to the scene.
| Function | Send & readback | Result |
|---|---|---|
| Set the alpha and order of layer 1 | Refer to 0xF0, 0x02 | |
| Set the screen group index of layer 1 | Refer to 0xF0, 0x1D | |
| Set the layer group of layer 1 | Refer to 0xF0, 0x1A | |
| Set the layer lock of layer 1 | Refer to 0xF0, 0x17 | |
| Save scene 1 | Refer to 0x68, 0x1A | |
| Push to the main output for display | Refer to 0xF0, 0x18 |