TAP_Osd_Create
Topfield Documentation
int TAP_Osd_Create(dword x, dword y, dword w, dword h, byte lutIdx, int flag);
It creates a region.
- x, y : starting position of the region. (upper, left)
- w, h : the width and height of the region.
- lutIdx : The LUT number used in the region. LUT is assigned by TAP_Osd_SetLut().
- flag : Osd creation flag.
return value : region number of created region or
0xFFFF in case of error (no region available)
| flag | comment |
|---|
| OSD_Flag_MemRgn | make virtual region in memory instead of screen |
| OSD_Flag_256 | make 256 color region. default is 16bit color |
| OSD_Flag_Plane2 | make region in Plane2 instead of Plane1 |
Additional Documentation
Region created for plane 2 (OSD_Flag_Plane2) is below the normal region i.e:
rgn1 = TAP_Osd_Create(0, 0, 720, 576, 0, 0);
rgn2 = TAP_Osd_Create(0, 0, 720, 576, 0, OSD_Flag_Plane2);
TAP_Osd_FillBox(rgn1, 100, 100, 100, 100, COLOR_Red);
TAP_Osd_FillBox(rgn2, 150, 150, 100, 100, COLOR_Green);
draws a red box into screen and green box below the red one (in a places where the boxes overlap).
Please note that plane 2 does not work very well in TF5100PVRc (Sep 12 2005 firmware) because after using plane 2 and if you press the next key sequence:
Guide -> RED key -> P+ the EPG screen is flushed totally and only the PIP figure can be seen (until the EPG data is updated!).
LUT = Look-Up Table