DDE Specifications

ImageWarp behaves as a DDE server, and as such, the following information is needed to use it as a remote service.

Service name

"IMAGEWARP" is a service name for the ImageWarp DDE server. Specify this name as part of the initialization of a DDE conversation. If multiple instances of ImageWarp are running on your system, use "IMAGEWARP" for the first instance, "IMAGEWARP1" for the second one, "IMAGEWARP2" for the third one, etc. This allows for DDE communication with multiple copies of ImageWarp.

Topics

ImageWarp currently supports the SYSTEM and CONTROL topics. The SYSTEM topic provides a context for information of general interest to any DDE client. The following items are supported under the SYSTEM topic:

DDE Item   Description   Formats   A list of all clipboard formats potentially supported by the server   Topics   A list of the topics supported by the server at the current time.   SysItems   A list of items supported under the System topic   ItemList   A list of items supported under a non-System topic   HelpInfo   User-readable information of general interest

The CONTROL topics provides the items and commands for exchanging the information between a DDE client application and ImageWarp and allows the client to control the execution of scripts in ImageWarp. The following items and commands are supported under the CONTROL topic:

DDE Item   Description   STATUS   Status of the currently loaded script. Could be one of the following: "RUNNING", "PAUSED", "IDLE"   COMMAND   The set of script commands to be executed when poked into this item   VARIABLE   The value of the script variable selected by SelectVar   PARAMETER   The value of the parameter selected by SelectParam   CELL   The value of the global grid cell selected by SelectCell

DDEExecute Command   Description   [ Load ("filename") ]   Loads a script specified by "filename" into the Script Editor   [ Call (var[$]) ]   Executes a set of script commands specified by the var string   [ Run ]   Starts or continues execution of a current script   [ Stop ]   Terminates execution of a current script   [ Pause ]   Pauses execution of a current script   [ Minimize ]   Minimizes ImageWarp window   [ Maximize ]   Maximizes ImageWarp window   [ Hide ]   Hides ImageWarp window   [ Show ]   Shows ImageWarp window and restores its size and position   [ SelectVar (var[$]) ]   Selects a script variable for the VARIABLE item   [ SelectParam ( "param" ) ]   Selects a specified parameter for the PARAMETER item   [ SelectCell (obj[$], "param" ) ]   Selects a global grid cell for the CELL item

DDEAdvice Item   Description   STATUS   ImageWarp will send a hot-link notification to the client each time the script terminates or enter the Pause mode