MyOSD : an over screen displayer for MyAES.
(c)2006 Arnaud BERCEGEAY.


0. OVERVIEW

run the deamon (MYOSD.PRG), then run the test program (TSTMYOSD.PRG),
follow the instruction on the screen (press a, b, c... keys) and see
what's happen.


1. USAGE

FIRST, the application requests MyOSD to display an OSD message by sending
an AES message to MyOSD:
message[0]   =  MYOSD_DISPLAY (1080)
message[1]   =  AES application ID of MYOSD.PRG
message[2]   = 0
message[3]   = 0
message[4,5] = pointer to the string (NULL terminated) to display
message[6,7] = 0 (reserved for futur use)

Note: appl_find("MYOSD   ") may be used to get the AES application ID of MYOSD.PRG

When MYOSD.PRG receives such message, it shows a TOPMOST window with the
string pointed by msg[4,5] displayed on it. This window is shown for few seconds, and
then the window is automatically closed.

IMPORTANT: the memory area pointed by message[4,5] HAS TO be a global memory (memory
shareable by all applications).

THEN, MyOSD responds by sending either an OK or NOK answer to the display request :
message[0]   =  MYOSD_OK (1081) or MYOSD_NOK (1082)
message[1]   =  AES application ID of the requester
message[2]   = 0
message[3]   = 0
message[4,5] = pointer to the string (NULL terminated) to display
message[6,7] = 0 (reserved for futur use)

The application may use such message to set as unused the global memory pointed by
message[4,5], and free it.


2. TODO

todo list to do :o)
