Rexx-Scripts under StWTV can call the following functions: ******************************************************************************** Function: StWTVGetVersion Since: Bld 2140 Purpose: returns the version of StWTV Parameters: VersionType Returns: Requested version information Parameter VersionType=FULL (default) return full version info string VersionType=VERSION return version number string VersionType=BUILD return build level string ******************************************************************************** Function: StWTVEnumStations Since: Bld 2140 Purpose: Enumerates all defined stations or all stations in a toolbar into a Stem variable Parameters: StemVar [Toolbarhandle] Returns: number of stations in StemVar Parameter: StemVar On return, StemVar.0 contains the number of defined stations. StemVar.1 contains the handle of the first station, StemVar.2 contains the handle of the second station and so on Toolbarhandle if given, all stations for this toolbar are enumerated. if omitted all definded stations are enumerated ******************************************************************************** Function: StWTVGetStation Since: Bld 2140,2215 Purpose: returns some informations about a station Parameters: type [station] [StemVar](required only when type=FULL) Returns: requested information. If type=FULL the handle is returned If there is no station and type is not HANDLE the script will stop If type is HANDLE and there is no station, 0 will be returned (eg. while initialisation when there is no station defined) Parameter: type=FULL returns the handle of the station. full station info will be stored in StemVar: StemVar.Handle StemVar.Name StemVar.Signal (only since Bld 2215 !) StemVar.Channel StemVar.Frequency StemVar.Brightness StemVar.Contrast StemVar.Saturation StemVar.Hue StemVar.Bitmap type=HANDLE returns the handle of the station type=NAME returns the name of the station type=SIGNAL (only since Bld 2215 !) returns the signal source type=CHANNEL returns the channel number of the station type=FREQUENCY returns the frequency of the station type=BRIGHTNESS returns the brightness of the station type=CONTRAST returns the contrast of the station type=SATURATION returns the saturation of the station type=HUE returns the hue of the station type=BITMAP returns the name of the bitmap file for the station button station=CURRENT (default) returns the information for the currently active station station=PREVIOUS returns the information for the previously active station station= returns the information for the station with the handle ******************************************************************************** Function: StWTVSetStation Since: Bld 2140 Purpose: sets some settings for a station Parameters: type station Var/StemVar (StemVar only when type=FULL) [ACTION] Returns: Handle of the station. Parameter: type=FULL full station info will be retreived from StemVar into requested station StemVar.Name StemVar.Signal (only since Bld 2215 !) StemVar.Channel StemVar.Frequency StemVar.Brightness StemVar.Contrast StemVar.Saturation StemVar.Hue StemVar.Bitmap type=NAME sets the name of the station type=SIGNAL (only since Bld 2215 !) sets the signal source for the station type=CHANNEL sets the channel number of the station type=FREQUENCY sets the frequency of the station type=BRIGHTNESS sets the brightness of the station type=CONTRAST sets the contrast of the station type=SATURATION sets the saturation of the station type=HUE sets the hue of the station type=BITMAP sets the name of the bitmap file for the station button station=CURRENT sets the information for the currently active station station=PREVIOUS sets the information for the previously active station station= sets the information for the station with the handle action=SET (default) the new values will be set action=CREATE creates a new station. station will be ignored. action=DELETE deletes a station ******************************************************************************** Function: StWTVActivateStation Since: Bld 2140 Purpose: Activates a new station so that it is visible in the TV-Screen Parameters: Handle Returns: Handle Parameter: Handle handle of the station ******************************************************************************** Function: StWTVEnumToolbars Since: Bld 2140 Purpose: Enumerates all defined station toolbars into a Stem variable Parameters: Returns: number of toolbars in StemVar Parameter: StemVar On return, StemVar.0 contains the number of defined toolbars. StemVar.1 contains the handle of the first toolbar, StemVar.2 contains the handle of the second toolbar and so on ******************************************************************************** Function: StWTVGetToolbar Since: Bld 2140 Purpose: returns some informations about a toolbar Parameters: type toolbar [StemVar](required only when type=FULL) Returns: requested information. If type=FULL the handle is returned If there is no toolbar and type is not HANDLE the script will stop If type is HANDLE and there is no toolbar, 0 will be returned (eg. while initialisation when there is no toolbar defined) Parameter: type=FULL returns the handle of the toolbar full toolbar info will be stored in StemVar: StemVar.Handle StemVar.Name StemVar.Location StemVar.Position StemVar.NumOfStationsPerLine StemVar.NumStations type=HANDLE returns the handle of the station type=NAME returns the name of the station type=LOCATION returns TOP, BOTTOM, LEFT, RIGHT, FLOATING or HIDDEN type=POSITION returns the position of the toolbar in the form x;y type=NUMSTATIONSPERLINE returns max. number of stations per line type=NUMSTATIONS returns the number of stations defined in this toolbar ******************************************************************************** Function: StWTVSetToolbar Since: Bld 2140 Purpose: sets some settings for a toolbar Parameters: type toolbar Var/StemVar (StemVar only when type=FULL) [ACTION] Returns: Handle of the toolbar Parameter: type=FULL full toolbar info will be retreived from StemVar into requested toobar StemVar.Name StemVar.Location StemVar.Position StemVar.NumOfStationsPerLine type=NAME sets the name of the station type=LOCATION sets the new location type=POSITION sets the new position (format must be x;y ) type=NUMSTATIONSPERLINE sets max. number of stations per line action=SET (default) the new values will be set action=CREATE creates a new toolbar. toolbar will be ignored. action=DELETE deletes a toolbar ******************************************************************************** Function: StWTVAddStation Since: Bld 2140 Purpose: adds a station to a toolbar Parameters: station toolbar Returns: Handle of the toolbar Parameter: station= station handle to add CURRENT = current active station PREVIOUS = previous active station toolbar= toolbar handle to add to ******************************************************************************** Function: StWTVRemoveStation Since: Bld 2140 Purpose: removes a station from a toolbar Parameters: station toolbar Returns: Handle of the toolbar Parameter: station= station handle to add CURRENT = current active station PREVIOUS = previous active station toolbar= toolbar handle to remove from ******************************************************************************** Function: StWTVShutDown Since: Bld 2186 Purpose: ends StWTV. A Close request is posted to the StWTV main window. So this function call returns, while StWTV is still running. After finishing the script, StWTV will shutdown Parameters: Returns: Nothing Parameter: ******************************************************************************** Function: StWTVSetDriverVar Since: Bld 3002 Purpose: Sets a driver specific variable Parameters: varName varValue Returns: Nothing Parameter: varName = The name of the driver variable varValue = Value to set