Arexx/JAH Notes 12/24/91 FractalPro 5.0's ARexx Port Name (for the ADDRESS command in ARexx) is FRACTALPRO Here are the ARexx/JAH commands for FractalPro5.0. The commands follow the menus pretty closely. ARexx commands for PROJECT MENU: FRACTAL n n is a digit, 0-9 designating which fractal function is in use 0 - Mandelbrot Set 1 - Julia Set 2 - Cube Mandelbrot Set 3 - Cube Julia Set 4 - Cosh Mandelbrot Set 5 - Cosh Julia Set 6 - Wolf Function 1 Mandelbrot Set 7 - Wolf Function 1 Julia Set SHADE col col is a three letter color designation, declaring which color shading mode is to be used (and, if necessary, causes the program to re-color the picture and load the appropriate color shading palette) RED GRN BLU NEGATIVE ON turns negative rendering ON NEGATIVE OFF turns negative rendering OFF SPECTRAL ON turns on spectral mode for drawing/saving/loading 24-bit pics SPECTRAL OFF turns off spectral mode for drawing/saving/loading 24-bit pics SCHEME2 ON turns on RBG color ordering instead of RGB ordering SCHEME2 OFF turns on RGB ordering instead of RBG ordering CYCLE n n is a number from 1 - 9 designating the color cycling speed THIS ALSO STARTS THE CYCLING PROCESS - YOU CAN'T STOP IT FROM A MOUSE CLICK ON THE SCREEN IF STARTED FROM AREXX. FORWARD ON sets color cycling 'forward' direction on FORWARD OFF sets color cycling 'forward' direction off REVERSE ON sets color cycling 'reverse' direction on REVERSE OFF sets color cycling 'reverse' direction off AUTOSTEP ON sets single step color cycling during sequencing on AUTOSTEP OFF sets single step color cycling during sequencing off SEQUENCE ON turns on sequencing mode for animation sequencing SEQUENCE OFF turns off sequencing mode for animation sequencing PICNAME string sets the file name for saving/loading images PICPATH string sets the file path for saving/loading images NOTE that file path names should usually be enclosed in quotes: when using this command with ARexx, for example: PICPATH "df0:picdirectory/" NOTE also that file path names should either end in a colon (:) or a slash (/) character. The colon is appropriate if the file path is simply a disk (like df1:) or assigned directory (like FratalPro:). The slash is appropriate if the path is leads to a subdirectory (like df1:picsdirectory/). NOTE also that the quotes aren't required when using JAH to set up a file path name, for example: JAH FRACTALPRO PICNAME df0:picdirectory/ SAVE saves current picture with current path and name settings also saves current FPRO.VIS file with same name and .VIS suffix LOAD PIC loads picture with current path and name settings LOAD XYW loads coordinate file NOTE you should truly have the coordinate file correctly named using PICNAME (the name should end in .XYW, as coordinate files always do!), for example: PICPATH "FractalPro:Pics/" PICNAME PIC0.XYW LOAD XYW would be a sensible way to use LOAD XYW to load the coordinate file corresponding to PIC0 in the PICS directory on the FractalPro disk. FractalPro:Pics/Pic0.XYW would be the file loaded by this combination of commands. No image file would be loaded or even attempted. I separated the loading of PIC and .XYW files so that ARexx won't see any attempt to first load a PIC file (which is what happens during manual use of the LOAD menu option, even if you put .XYW at the end of the file name - when doing it manually, you simply 'continue' when the requester pops up telling you 'Problem Loading Image' because there shouldn't be any pic file with an .XYW extension, but you don't want that 'error' to be noticed by ARexx, hence separate commands to separately load .XYW files and PIC files when you desire). Note that LOAD, when 24-bit is turned ON, loads a 24-bit pic and displays it on the FireCracker board if present. QUIT causes program to exit immediately if program is in PAUSE mode ARexx commands for the MATH MENU: COUNT n n is the count value you desire n can be 64, 128, 256, 512, 1024, 2048, 4096, 8192, or 16384 ANIMCOUNT n n is the number of pics you desire in the animation sequence n can be 16, 32, 64, 128, 256, or 512 (same as menu choices) DEEP ON turns on 24-bit mode DEEP OFF turns off 24-bit mode ARexx commands for the OPTIONS MENU: TOPEDGE n vertical positioning information for the virtual zoom window which corresponds to the distance from the top of the graphic screen where the zoom window would be placed if manually zooming n can range from 0 to 999 (larger than your screen height!) zoomwindow height varies with zoom window size (smaller for higher zoom factors) 0 would correspond to the virtual zoomwindow being right at the top of the graphic screen LEFTEDGE n horizontal position for the virtual zoom window corresponds to the distance from the left of the graphic screen where the zoom window would be placed if manually zooming n can range from 0 to 999 (larger than your screen width!) zoomwindow width varies with zoom window size (smaller for higher zoom factors) 0 would correspond to the virtual zoomwindow being at the leftmost edge of the graphic screen ZOOM n tells program to reset the coordinates for drawing the next image as if you had manually zoomed in by a factor of n, and according to a placement of the virtual zoom window by the TOPEDGE and LEFTEDGE commands n can be 1, 2, 4, 8, or 16 (just like the manual zoom factors) UNZOOM n tells program to reset coordinates for drawing the next image by expanding the image's width around its current center point, by a factor of n (just like using the menu) n can be 2, 4, 8, or 16 MOVE direction sets the animation motion type for sequencing direction can be one of twelve two-letter direction tokens: LE left RI right DO down UP up IN zoom in OU zoom out DL down & left diagonal UL up & left diagonal DR down & right diagonal UR up & right diagonal TW tween CA cascade INCREMENT n sets the motion increment for animation sequencing n can be: 32 same as 32/40 menu choice 16 same as 16/20 menu choice 8 same as 8/10 menu choice 4 same as 4/5 menu choice DEFAULT XY sets default XY coordinates for drawing next image START OVER forces next DRAW command to begin drawing from bottom of screen (instead of continuing where it left off) RESET # forces reset of -xxx image number to -001 when next image drawing begins AUTOSAVE ON turns on AUTOSAVE mode for automatically saving each image (and, if either VISTA mode is ON, the corresponding Vista DEM file) - most appropriate to use with SEQUENCE ON AUTOSAVE OFF turns off AUTOSAVE mode VISM ON turns on VISTA MOUNTAIN mode to create a FPro.VIS 'mountain' VISM OFF turns off the VISTA MOUNTAIN mode VISL ON turns on VISTA LAKE mode VISL OFF turns off VISTA LAKE mode NOTE that VISTA LAKE and VISTA MOUNTAIN can't both be ON at once, the last one you activate (VISM ON or VISL ON) will be the active one CORNER ON sets Vista DEM file to be lower left corner of the image CORNER OFF sets Vista DEM to be the center 258x258 pixel area of the image NOTE that CORNER ON/OFF doesn't really have any effect unless you also use VISM ON or VISL ON. It only affects Vista DEM creation, and only specifies which part of the next fully drawn image will become a FPro.VIS file (either the lower left corner if CORNER ON, or the center if CORNER OFF). SCRIPT ON turns on SCRIPT feature (ONLY IF STARTED FROM CLI) SCRIPT OFF turns off SCRIPT feature ARexx commands for the CONTROL MENU: DRAW begins or continues drawing image (PAUSE - DELIBERATELY NOT IMPLEMENTED!) How to Use These Commands All these commands work with ARexx or JAH. JAH is a AmigaDos command I've included here so you can have some remote control of FractalPro5.0 from an AmigaDos script even if you don't have or are unfamiliar with ARexx. JAH is simply a little command which can send a text message (like an ARexx command) to any program with a public (named) message port; like FractalPro's message port named FRACTALPRO (ALWAYS ALL UPPERCASE!). YOU SHOULD COPY JAH TO YOUR C: DIRECTORY (IT IS TINY, SO DON'T WORRY) FOR THE FOLLOWING EXAMPLE JAH SCRIPTS. JAH is NOT PUBLIC DOMAIN! Remember that all these commands should always be in UPPER CASE only! Remember also that all these commands bypass all of FractalPro's Requesters! Remember also that you can completely goof yourself up with these in ways which the menus normally prevent you from so doing! These commands won't prevent you from saving a picture with a set of coordinates which don't match the picture, for example - while the menus will try to 'ghost' themselves to prevent you from so doing. Most commands are simple and let you do some things with scripts that take several menu commands to do yourself. Just be careful and know what you're doing before using scripts to do your sequencing for you with AutoSave, etc.! Remember also that to use ARexx scripts you need ARexx and you need to have the ARexx program activated by calling REXXMAST in your startup sequence or from a CLI before you try to use ARexx scripts with FractalPro! Remember also that File Names and Path Names should be inside quotes ("") when using these commands with ARexx! DO NOT PUT COMMENTS ON THE SAME LINE AS A JAH COMMAND IN A SCRIPT! (e.g. do NOT do this: JAH FRACTALPRO DRAW ;NOW DRAW JAH DOESN'T LIKE COMMENTS ON THE SAME LINE AS A JAH COMMAND!! Here are a couple short examples. 1. A Simple JAH Script First start up FractalPro5.0, then use type these JAH commands into a CLI or Shell window, one after another. JAH FRACTALPRO DEEP OFF JAH FRACTALPRO TOPEDGE 50 JAH FRACTALPRO LEFTEDGE 50 JAH FRACTALPRO ZOOM 4 JAH FRACTALPRO COUNT 256 JAH FRACTALPRO DRAW The first command simply tells FractalPro to only work in HAM (turns 24-bit off). The next 3 commands set up a zoom operation and they happen quickly. The last command tells FractalPro to draw the zoomed picture. The CLI/Shell prompt won't return until the operation is completed (picture is fully drawn). You could also make this group of commands into an AmigaDos script and just execute it that way all at once. Here's another simple example which loads NICEM2 and color cycles it a bit: (works either with the FractalPro floppy disk or if you've installed the program on your hard disk and done the proper 'assign' of the FractalPro: directory) JAH FRACTALPRO PICPATH FRACTALPRO:PICS/ JAH FRACTALPRO PICNAME NICEM2 JAH FRACTALPRO LOAD PIC JAH FRACTALPRO FORWARD ON JAH FRACTALPRO REVERSE OFF JAH FRACTALPRO CYCLE 2 JAH FRACTALPRO FORWARD OFF JAH FRACTALPRO REVERSE ON JAH FRACTALPRO CYCLE 3 2. A simple ARexx Script ADDRESS FRACTALPRO DEEP OFF TOPEDGE 50 LEFTEDGE 50 ZOOM 4 COUNT 256 DRAW That is just the ARexx way to doing the same thing as the first short JAH script above. FractalPro's ARexx Port Name is FRACTALPRO. Here's the second example JAH script in ARexx format. ADDRESS FRACTALPRO PICPATH "FRACTALPRO:PICS/" PICNAME "NICEM2" LOAD PIC FORWARD ON REVERSE OFF CYCLE 2 FORWARD OFF REVERSE ON CYCLE 3 There are two icons with these script examples ready-to-run on the floppy. 1. JahScript - just double-click the icon! It will start up FractalPro and do a little JAH script combining the two short examples above. 2. RexxScript - same thing, only does it via ARexx (of course, you must have ARexx for this one!). Excuses, Excuses There is no way to present here all the complexities and varieties you can arrange with ARexx and JAH scripts. Watch for some examples of Art Department and ImageMaster 'combination' scripts with FractalPro on the bulletin boards. I'll be releasing some interesting combination scripts and uploading them to Compuserve's Amiga Arts forum libraries. Remember also that your FPro.SCR scripts (activated within FractalPro after an AutoSave'd image, see the Manual) can also call JAH or ARexx scripts. The script possibilities are limitless.