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.)
