http_api |
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
http_api [2024/03/19 18:21] admin [drs_tamarisk_settings] |
http_api [2024/04/05 15:35] (current) anthony [Overlay] |
||
|---|---|---|---|
| Line 1640: | Line 1640: | ||
| ---- | ---- | ||
| - | Add/Update the overlay values in the Database. | + | Display text or a PNG overlayed on the video feed for a given Channel. |
| == Parameters: == | == Parameters: == | ||
| Line 1648: | Line 1648: | ||
| //**chn**// Get the encoder channel number. The default is encoder channel 1. Select between encoder channels. Possible values: 1, 2, 3, or 4. | //**chn**// Get the encoder channel number. The default is encoder channel 1. Select between encoder channels. Possible values: 1, 2, 3, or 4. | ||
| - | **Ambarella Specific** \\ | + | **//rgn_idx // **//(Ambarella Specific)// Region Index, index to map overlay. The region index value is system-wide and can be in the range of 1 to 16. Ambarella provides 16 total color look-up tables for Overlay (for all Channels), rgn_idx signifies which color look-up table(CLUT) is in use. |
| - | **//rgn_idx//** Index to map overlay. The region index value can be in the range of 1 to 16. Ambarella provides 16 total color look-up tables for Overlay, rgn_idx signifies which color look-up table is in use. | + | <code> |
| + | TEXT type=text source=”Channel 1” instance=1 rgn_idx=1 | ||
| + | type=text source=”Channel 2” instance=2 rgn_idx=1 | ||
| + | |||
| + | </code> | ||
| + | |||
| + | In the above example, identical region indices are used, effectively reusing the CLUT. The text will be correct on each channel. When changing the color of the text, when using identical region indices, the last Overlay command issued will override all Overlay instances that are using the same region index, the text will still be different but the color will be the same because they are using the same shared rgn_idx. | ||
| + | |||
| + | <code> | ||
| + | PNG type=png source=”/opt/config/images/image.png” instance=1 rgn_idx=2 | ||
| + | type=png source=”/opt/config/images/image.png” instance=2 rgn_idx=2 | ||
| + | |||
| + | </code> | ||
| + | |||
| + | PNG overlay will work in the same way as text overlay when re-using region indices, but this is only helpful when overlaying identical PNGs.\\ | ||
| + | Using different PNGs would cause colors to go wonky due to differing CLUTs for the different PNGs. | ||
| + | |||
| + | The encoder writes the entire CLUT at the rgn_idx with each overlay command. | ||
| - | **Qualcomm and HiSilicon** \\ | + | //**rgn_idx ** (//Qualcomm and DCK//)// Index to map overlay. The region index value can be in the range of 0 to 128, per channel. |
| - | //**rgn_idx**// Index to map overlay.The region index value can be in the range of 0 to 128, per channel. | + | |
| //**type**// Type of overlay to be used possible values: text or png. | //**type**// Type of overlay to be used possible values: text or png. | ||
| Line 10378: | Line 10394: | ||
| JSON formatted table with values below | JSON formatted table with values below | ||
| - | //**ret**// Custom return code of the HTTP POST request. 0 on success, -1 on failure. | + | //**ret**// Custom return code of the HTTP GET request. 0 on success, -1 on failure. |
| //**preset**// TEXT, | //**preset**// TEXT, | ||
| Line 10575: | Line 10591: | ||
| ---- | ---- | ||
| + | |||
| ==== filepicker ==== | ==== filepicker ==== | ||
http_api.1710872498.txt.gz · Last modified: 2024/03/19 18:21 by admin
Page Tools
