One And Only Media P.O. Box 218 Vauxhall, NJ 07088-0218 (908) 964-4546 All Rights Reserved Copyright © 1995 One And Only Media W · E · L · C · O · M · E · T · O · M · A · C · R · O · F · O · R · M ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 7/16/95 «««««««««««CONTENTS»»»»»»»»»»» Installing MacroForm.........I Release Notes...............II Tech Support...............III Legal Stuff.................IV ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ I. INSTALLING MACROFORM --------------------------------------------------------------------- Note: If you have trouble installing MacroForm, you should perform the installation in expert mode; you will have to tell the installer exactly were to install the various files. If you still experience problems, create an "Arexx_Examples" directory in your "NewTek" directory, create an "lwm" directory inside of that new "Arexx_Examples" directory, and activate the MacroForm installer. If the MacroForm key-set will not work properly, you will have to create a new one. Look at the KeyMaster requester figure on page 73 of your MacroForm manual to get the key assignments. If KeyMaster should fail when you try to activate it by hitting F1 in Modeler, there may be an extra space before the path name; activate Configure Keys in Modeler and delete the space that exists before the path name(s). If the problem happens after you have loaded the "MacroForm" Fkey-set, get rid of all the spaces in Cofigure Keys, activate KeyMaster(F1) and resave this set-up as "MacroForm". Arexx MUST be alreading running before installing MacroForm! Once Arexx is active, installing MacroForm is essentially a 4 step process... 1. Insert "Disk1" into your floppy drive (already done) 2. Double-click on the MacroForm_Install icon 3. Follow the installer instructions if any 4. Restart your computer During the installation you may come across the "Assign Keymaster to F-Key 1..." screen. What this means is if the Modeler is running, the installer will assign the MacroForm utility "KeyMaster" to function key 1 in your Modeler function key assignments. It will also make this assignment by creating a new Mod-config file (the original is renamed "Mod-config-B4MacroForm"). This is performed as a convenience; with KeyMaster properly installed, you will be able to access the entire MacroForm environment with just a few mouse clicks (see page 20 of your MacroForm manual). Also, since MacroForm is compiled with the RexxPlus Compiler, RPStart is added to your user-startup file if RexxPlus has not previously been installed. If something should go wrong with the installation, it is possible to do it manually... Manual Installation ·············································· To install MacroForm you will need to copy files from the MacroForm disks to the appropriate directories on your hard drive. If you are using a directory utility this installation will be easier; if not, you will have to select "Show -> All Files" from the "Window" menu on the Workbench screen (otherwise you won't be able to see the files that you need to drag). 1. Insert "Disk1" into your floppy drive 2. Drag the "MacroForm" folder from "Disk1" over to your "Toaster" directory 3. Select the contents of the "C" directory on "Disk1" and drag them over to your "Workbench/C" directory 4. Select the contents of the "S" directory on "Disk1" and drag them over to your "Workbench/S" directory 5. Select the contents of the "lwm" directory on "Disk1" and drag them over to your "Toaster/Arexx_Examples/lwm" directory 6. Insert "Disk2" into your floppy drive 7. Select the contents of the "LIBS" directory on "Disk2" and drag them over to your "Workbench/LIBS" directory 8. Select the contents of the "lwm" directory on "Disk2" and drag them over to your "Toaster/Arexx_Examples/lwm" directory 9. Drag the "Tutorials" directory from "Disk2" over to your "Toaster/MacroForm" directory 10.Insert "Disk3" into your floppy drive 11.Select the contents of the "tutorials" directory on "Disk3" and drag them over to your "Toaster/MacroForm/Tutorials" directory Next you will need to alter your user-startup file. Add these lines to the end of your user-startup file if you don't currently have RexxPlus Compiler installed... ;BEGIN RexxPlus RPStart ;END RexxPlus Lastly, you MUST re-start your system! Also, after your system is restarted, you will have to assign "OAO--KeyMaster.lwm" to function key 1 in Modeler. ===================================================================== II. Release Notes --------------------------------------------------------------------- Although we've tried to be as thorough as possible with the MacroForm manual, some things inevitably slip through the cracks... a. In the "Fixing Curve Order" example on page 60, step # 8 says "activate Apply (F8)". Actually, you will have to repeat steps 3 thru 8 of the "Curve Order Test" example on page 58. This is because the formfile that was created had the wrong point associations. So, activating Apply will not produce the desired results. b. In the "Breathing Can" Class Discussion on page 205, in the second paragraph it states: "Next we moved the middle point on the model horizontally...". It should say: "... middle point on the CURVE horizontally...". Also, if you have trouble loading the "Breathing_Can" scene into Layout from the "/MacroForm/Scenes" directory, when you are asked for a new directory, the objects are located in the "/MacroForm/Tutorials/Discussions/Can" directory. c. Click OK or hit Return after Step #10 of the 'Rounded Square Bottle' on page 37. d. In the sub-note of Step #8 of the 'Apply and Reset Mode Demonstrations' on page 39, it indicates that a curve will be created. The curve was already created by the Bottle Twist tutorial; no new curve will be created. e. Do not be alarmed by the display after a rail tool operation. You will have to force it to redraw by moving it or moving to a different layer. f. If you hit the Right Amiga - X keystrokes to get rid of the path name in the Formfile and/or Tempfile fields in RailToolz Preferences and click OK, you will presented with a file requester. This is provided as a convenience since you may not always know the proper path name. g. A height of 0 (zero) entered in the height field in NewBox will create a single rounded polygon in the top view. This is not true for the width and depth. h. The MOD section of the RailToolz requester will have different symbols if you enter Modeler by clicking on its icon in the Toaster directory (rather than entering through Layout with the Modeler button). The Apply symbol will become "·" and the Control curve symbol will become "¤". The Clone mode symbol will be the same. i. The Resistance values in RailStretch will use floating point values as well as integers (i.e., 1.5, 3.398, 0.75, etc.) Negative numbers will be converted to thier absolute value. j. In the manual it states that your Curves should always be in the foreground when you activate Apply(F8). While this is the safest method, there is another; if the data that you are editing is brought to the foreground, and if you put your curves in the background, Apply will still perform properly when you activate it. You can use either method but, NEVER ACTIVATE APPLY WHEN YOUR MODEL IS IN THE FOREGROUND AND YOUR CURVES ARE NOT IN THE BACK...if you have a formfile in the layer that holds your model, you may inadvertantly alter data in another layer. Initialize RailToolz whenever possible to get rid of old formfiles. k. The LAYER/INFO section of the RailToolz requester was briefly touched upon in a few Tips, Hints, and FYI sidebars. We would like to have included a chart for this area in the Appendix. What this area does is list the layer number that a particular tool is currently in Apply mode. This is provided for those occasions when you have multiple Apply mode curves, but, can't remember which curve was performing a given rail tool operation. Also, for RailRout, it displays the current router file name if there is one. ===================================================================== III. Tech Support --------------------------------------------------------------------- Sorry...we are sorely under-staffed; and, unless the Amiga market picks up, and unless we all do our part to prevent piracy of this software, this situation is not likely to change. In our effort to provide you with the clearest and most thorough documentation ever created for a 3D product, we have created the 220+ page and 150+ figure Macroform Manual (we have also included the Tutorials macro). So, in most cases, if you consult your MacroForm manual, your questions will be answered. However, if you have any major problems, bug reports, comments or suggestions, we may be contacted at 908-964-4546. But, please...read your MacroForm manual thoroughly before calling for tech support. Also, minor upgrades and manual adendums will be sent to you automatically whenever we feel it's needed; and, you will receive special deals on major upgrades and new products only if you are a registered user. In the near future we are hoping to set up a web page that should aid in the flow of information on tips & troubleshooting. If you send in your registration card, we'll keep you posted... ===================================================================== IV. Legal Stuff --------------------------------------------------------------------- * TradeMark Information MacroForm is a registered trademark of One And Only Media (also known as OAO Media). LightWave 3D is a registered trademark of NewTek Inc.) * Copyright This software is a proprietary product of One And Only Media and is protected by both United States Copyright Law and International Treaty provisions. ..................................................................... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -LM