AREXX Returned Variables Aug 18 1992

Here's a new  section of Vapor Paint's AREXX support:
some AREXX commands create variables which are available to your AREXX 
macro programs. This is tremendously useful when called from a Pum macro.

 For example,
 GetRMNum  returns the number of rawmouse points available for reading.
 GetRMVal <x> gets an instance of those RM's in new variables:
     RM_Time
     RM_X
     RM_Y

There's even a pair of new Mouse Tools, "Shift-F1 F6" and "Shift-F1 F7"
which do nothing but leave raw mice unprocessed and calls the macro
"VRMTool".  This allows you to write a custom Mouse Tool in AREXX.

The function "String <heading>\<default>", which puts up a string requester
with the title <heading> and default value <default>, returns a value in
VRETURN.  If Cancel is chosen, VRETURN is set to CANCEL.

The function "YorN <heading>" puts up a yes-or-no requester and returns
YES or NO in VRETURN.

The next screen has a more comprehensive list of "RVI" functions.

Next Page| -| Home Page| First Here| Using Macros| AREXX | AREXX Commands


GETRMNUM      gets number of RM vertices into RM_NUM
GETRMVAL <n>  gets the nth RM vertice into 
    RM_Time,RM_X,RM_Y
GETVTNUM      gets number of vertices in current icon into VT_NUM
              if the current icon is a Vector (VT) or note vector (NV)
GETVTVAL <n>  gets the nth Vertice of current VT into
    VT_S,VT_X,VT_Y,VT_Z,VT_R,VT_M
PUTVTVAL <n>  puts the previous variables values into said Vector

STRING <head>\<def>  with a Heading of <head>,and default value <def>,
                     get a string or CANCEL,  into VRETURN
YORN   <head>        Get "YES" or "NO" into VRETURN.

There's a big function on the next page: GetInfo
A useful function to use in conjunction with GetInfo is
EYEPOS <icon code> <n> 
Which sets the current icon to then <n>th instance of <icon code>.
Those codes? VT VC CX MV RM NV MI VW LK IN AN SQ KF  CL PN 

Next Page| Previous Page


GetInfo           Gets lots of info about the current icon:
    EYE: the current link number
    LK_L,LK_R,LK_P,LK_C: left,right,parent,child of current icon
    LK_T:two-letter abbreviation of the type of node:
         VT VC DS CX RF MV RM NT NV MI SX VW LK
         IN AR VZ AN NX AP SQ KF PX CL PN XX FI
    LK_I: the instance of that type (not useful yet)
    LK_ET,LK_EI instance and type of equivalence link
    LK_F: flags   LK_LABEL: label of this node
And if the type of this node is AN,SQ,VW,KF,CL,PN then you get the
values of the node decoded as well:
For Views:
   VW_T VW_X VW_Y VW_F VW_E VW_ANGLE VW_SCALE 
For Animations:
   AN_START AN_END AN_RENDER AN_WIDTH AN_HEIGHT AN_PIXW AN_PIXH 
   AN_RPRF AN_RPSF AN_BIAS AN_SLICES AN_FLAG AN_OPT AN_AA 
For Sequences: 
SQ_START SQ_FLAG SQ_NUM 
For  keyframes:
KF_T 
For Colors
CL_R CL_G CL_B CL_T 
For Pens:
PN_OPT PN_P1 

Next Page| Previous Page


    Here is another set of goodies from the command GETDFLT 
which creates these variables and is roughly equivalent to
the PumTop command (numbers in parens can be used in PUMTOP):

 statistics: STAT_VTN  STAT_VCN  STAT_LKN  STAT_MIN
 flags: STAT_FL1 STAT_FL2 STAT_FL3 STAT_FL4 STAT_FL5 STAT_FL6

 The current Time: STAT_TIMEW(1)
 The Current Selected Tool modes(major/Minor): DFLT_MAM  DFLT_MIM
 Default Vertice:
       DFLT_X(2) DFLT_Y(3) DFLT_Z(4) DFLT_R(5) DFLT_M(6)
 Default Pen: DFLT_PN1(10)  DFLT_PN2(11)
 Default Color:
       DFLT_CLR(12) DFLT_CLG(13) DFLT_CLB(14) DFLT_CLT(15)
 Default Edge Color:
       DFLT_CLER(16) DFLT_CLEG(17) DFLT_CLEB(18) DFLT_CLET(19)
 Default number of KeyFrames: DFLT_KF
 Clamp Value: CLAMP(7)
 File Compression: COMPRS(9)
 Frames Per Second: FRAMES(8)

Next Page| Previous Page


    Here is yet another set of goodies from the command GETVSTRS 
which creates these variables and allows you to set up your own fave
default directories and filenames for VFiles:,VFrames: and even VHelp:.
But the big feature is to be able to preset the complicated callback
string for PI interfaces.

VFILEDIR   currently VFiles:
VFILENAME  currently unnamed.vee

VFRAMEDIR  currently VFrames:
VFRAMENAME currently unimportant.vee

VHELPDIR   currently VHelp:
VHELPNAME  currently !Home

RENDERSTR  currently impi:WraAud -f$.snd -n$ -j# -s15040 -h2000 -x0 -t4

This is the end| Previous Page

[Back to the main page| Back to the main Vapor Paint page ]
Henry Lowengard, jhhl-at-panix.com / 324 Wall St. Apt 5 / Kingston NY 12401

© 1998-2022 Henry Lowengard