Overview
On-Screen Display is a feature of Just Add Power 2G, 2GΩ/3G, and 3G Receivers. This article references Receivers in 2G Systems. Please see this article for 3G Systems.
In a 2G System, On-Screen Display creates an invisible 640x480-pixel floating frame textbox in the center of the screen. A command can be sent to the Receiver to show text with variations in size, color, and transparency.
Alignment
In 2G Systems, the on-screen display frame is always centered on the display. There are no options to move the frame.
The frame is always 640x480, so the output resolution of the Receiver determines the relative size of the frame:
Text box on 720p video
Text box on 1080p video
Text box on 4K video
Customization Commands
The text inside the textbox has the following options for customization:
Function | Command | Variable(s) | Description |
---|---|---|---|
Text | export OSD_STR='$string' |
$string | The text that will show up on the screen |
Font Size | export OSD_FONT_SIZE='$size' |
$size | A whole number representing the font size |
Font Color | export OSD_FONT_COLOR='0xAARRGGBB' |
AARRGGBB | AA=text alignment within text box. 00=left aligned, ff=right aligned RRGGBB=hex values for text color. RR=red, GG=green, BB=blue Default is 0xff00ff00 |
Transparency | export OSD_TRANSPARENT='$trans' |
$trans | A whole number from 1 (nearly invisible) to 15 (opaque) |
Enable/Disable Commands
Once the options for the On-Screen Display message have been set, the message must be enabled and disabled:
Function | Command | Variable(s) | Description |
---|---|---|---|
Turn OSD On | osd_on.sh |
none | Enable On-Screen Display |
Turn OSD Off | osd_off.sh $X& |
$X | X is the number of seconds to wait before turning off On-Screen Display Example: osd_off.sh - turns off OSD immediatelyExample: osd_off.sh 15& - waits 15 seconds, then turns off OSD |
Examples
Commands separated by a semicolon (;) can be joined together into one command to send the entire OSD function at once.
On-Screen Display examples:
1. To set the OSD to display "Doorbell" in red text, font 26, fully visible, to show for 10 seconds:
export OSD_STR='Doorbell';export OSD_FONT_SIZE='26';export OSD_FONT_COLOR='0x00ff0000';export OSD_TRANSPARENT='15';osd_on.sh;osd_off.sh 10&
2. To set the OSD to display "A Ghost!" in blue text, font 20, high transparency, to show for 30 seconds:
export OSD_STR='A Ghost!';export OSD_FONT_SIZE='20';export OSD_FONT_COLOR='0x000000ff';export OSD_TRANSPARENT='3';osd_on.sh;osd_off.sh 30&