Differences

This shows you the differences between two versions of the page.

--- scripting:reference:scriptedosd [2014/06/07 20:30] – [OSDCreate] mit
+++ scripting:reference:scriptedosd [2025/05/28 16:35] (current) – external edit 127.0.0.1
@@ Line 6: / Line 6: @@
 ==== OSDCreate ====
-^ Parameters | ''OSD_TYPE'', ''Name'', ''Title'' |
+^ Parameters | ''OSD_TYPE'', ''Name'', ''Title'', ''[Expiry Time]'' |
 ^ Example | ''osdcreate(OSDBUILDING,"Main", "" )'' |
 ^ Description | This function is used to start a new osd block. |
-The OSD_TYPE can be one of :\\
-- OSDWINDOW\\
+OSD_TYPE determine the location and appearance of the OSD background (See list below).
+The ''Name'' of the OSD is used to identify its components : See [Responding to OSD Button Presses].
+''Expiry Time'' is optional - if used, it specifies the number of seconds the OSD will appear for before automatically closing.
+OSD_TYPE can be one of :\\
+- OSDWINDOW \\
 - OSDBUILDING\\
 - OSDPOPUP\\
@@ Line 20: / Line 25: @@
 - OSDSPECLOWER \\
 - OSDBLANKCENTER \\
+- OSDSCRIPTEDBUILDING \\
-If ''OSDWINDOW'' is used a background window is created 400x300, in the center of the screen. With ''OSDBUILDING'', the OSD is displayed within the region of the building access window.
+''OSDWINDOW'' is used a background window is created 400x300, in the center of the screen. With ''OSDBUILDING'', the OSD is displayed within the region of the building access window.
-The ''Name'' of the OSD is used to identify its components : See [Responding to OSD Button Presses].
 ==== OSDAddItem ====
-Parameters :  ''OSD_ITEMTYPE'', ''Name'', ''Title'' \\
+^ Parameters | ''OSD_ITEMTYPE'', ''Name'', ''Text'' |
-Example : ''OsdAddItem(OSDIMAGE,"", "http://myweb.com/image.jpg" )'' \\
+^ Example | ''OsdAddItem( IMAGE, "", "http://myweb.com/image.jpg" )'' |
-Description :
+^ Description | This is a basic function to add an OSD item to the screen. Each item appears below any previously added items. If you want more control of the layout of your OSD then you would use the OSDAddAt command.. |
 ==== OSDAddAt ====
 Parameters :  ''OSD_ITEMTYPE'', X, Y, W, H, ''Name'', ''Title'' \\
@@ Line 36: / Line 40: @@
 ==== OSDSet ====
-Parameters :
+^ Parameters | ''Flag to set'' |
-Example :
+^ Example | ''osdset( "BlockEscape" )'' |
-Description :
+^ Description | This function is used to set a specific OSD behaviour flag. |
+Currently, "BlockEscape" is the only valid flag and is used to remove the user control to press escape to close an osd screen.
+//Example//
+<code>
+osdcreate( OSDLOWER, "Help", "Help Guide" )
+osdset( "BlockEscape" )
+osdaddat( TEXT, 100,0, 400, 100, "", "Welcome to my world, press the button to start" )
+osdaddat( BUTTON, 200, 70, 200, 35, "", "Start Game" )
+osdactivate()
+</code>
 ==== OSDActivate ====
 Parameters : None
@@ Line 48: / Line 62: @@
 ===== ScriptedOSD Item Types =====
-==== BUTTON ====
+==== Text Types ====
-==== TEXT ====
+Text can be added to your OSD using various text types, that specify the size, alignment and colour of the text to be displayed.
-==== IMAGE ====
+Valid text types are as follows :\\
-==== BULLET ====
+  * TEXT
-==== EXITBUTTON ====
+  * BIGTEXT
-==== LISTBUTTON ====
+  * FADEDTEXT
-==== BIGTEXT ====
+  * SMALLTEXT
-==== FADEDBUTTON ====
+  * TEXTRIGHT
-==== TEXTENTRY ====
+  * SMALLTEXTRIGHT
-==== BUTTONMINWIDTH ====
+  * BIGTEXTRIGHT
-==== MINHEIGHT ====
+  * BOLDTEXT
-==== FADEDIMAGE====
+  * SMALLFADEDTEXT (or FADEDSMALLTEXT)
+  * BIGFADEDTEXT
+  * WARNINGTEXT
+  * BIGWARNINGTEXT
+  * TEXT2
+  * FADEDTEXT2
+  * TEXT2RIGHT
+  * GIANTTEXT
+  * GIANTTEXTRIGHT
+  * GIANTFADEDTEXT
+  * BLINKINGWARNINGTEXT
+  * BULLET
+==== Button Types ====
+  * BUTTON
+  * EXITBUTTON
+  * FADEDBUTTON
+  * APPLYBUTTON
+  * APPLYEXITBUTTON
+==== Image Types ====
+  * IMAGE
+  * FADEDIMAGE
+  * EXITIMAGE
-==== FADEDTEXT ====
+==== Graphic Types ====
-==== SMALLTEXT ====
+  * RECT
+  * LINE
+  * BOX
-==== TEXTRIGHT ====
+==== User Input Types ====
-==== SMALLTEXTRIGHT ====
+  * TEXTENTRY
+  * VALUE
+  * CASHVALUE
-==== BIGTEXTRIGHT ====
+==== Display Control Types ====
-==== VALUE ====
+  * HTTPSET
+  * BUTTONMINWIDTH
+  * MINHEIGHT
-==== APPLYBUTTON ====
+==== Other OSD Types ====
-==== APPLYEXITBUTTON ====
+  * LISTBUTTON
+  * DATE