#
Terminology

Before even beginning to try programming REXX scripts to interact with Photo>Graphics it is important that you are familiar with the terms used to describe the various elements of a PhotoGraphics composition.

TOOL
  The fill that makes up an EFFECT
REGION
  The shape of any single particular EFFECT
OBJECT
  Any single item can be interacted with. Examples are REGIONS, TOOLS, EFFECTS, GROUPS and dialogs
EFFECT
  The result of combining a TOOL with a REGION
GROUP
  Any number of effects combined together into a single object
VIEW
  A workspace in which objects reside. For example there is the main workspace and each Custom Region or Custom Tool has it's own workspace (or view).
HANDLE
  The *internal* program name for any particular object. This is not the same as the NAME of the object but is instead just a pointer or reference to the object.
PROPERTY
  Any of the numerous settings that are available for any OBJECT. Includes things like an object's color, position, rotation, size, name, etc.
RENDER
  Whenever an image needs to be updated or created it is RENDERED. This includes everything from resizing the window to moving one of the objects in the image to outputting the image to printer or file. Because PhotoGraphics is multithreaded it will take a "snapshot" of the image to be rendered and then will allow you to continue working while it renders.

  (With REXX you can suspend rendering (CwStartRender/CwStopRender) so that the image is only updated at the end of your manipulations and the program does not have to try and keep up with you.)

Index