@DATABASE "AmiCAD" @Index INDEX @$VER : version 2.08e (10 February 2001) @AUTHOR "FLORAC Roland" @NODE MAIN Sommaire --------------------------------------- AmiCAD Version 2.08 February 10 2001 --------------------------------------- Warning: This guide is an incomplete translation of the french guide. The latest ARexx functions may not be present, and some menus docs are not updated or not present. @{"Distribution " LINK Distribution} @{"Requirements " LINK Requirements} @{"Installation " LINK Installation} @{"Running the program " LINK Running} @{"The title bar " LINK "Barre de titre"} @{"Configuration files " LINK Fichiers_Configuration} @{"Menus " LINK Menus} @{"Use of the keyboard " LINK "Commandes clavier"} ARexx Commands @{"Alphabetical list " LINK Fonctions} @{"The numbers " LINK Nombres} @{"Thematic list " LINK "Index thématique"} @{"Character strings " LINK "Chaînes de caractères"} @{"BUGS (?) " LINK Bugs} @{"History " LINK Historique} @{"Future " LINK Améliorations} @{"The author " LINK Auteur} @{"Help me! " LINK "AidezMoi"} @{"Some useful macros " LINK "Macros utiles"} @{"Translation " LINK Translation} @{"AmiCAD2META " LINK AmiCAD2META} @ENDNODE @NODE Distribution Distribution @TOC MAIN AmiCAD has been written by R.Florac. The AmiCAD package is Copyright © 1998 R.Florac, it's not public domain. AmiCAD is distributed under the concept of giftware/emailware. It can be used only for personal usage, professional usage is strictly forbidden without my permission, contact me for that. It is allowed to put this program only · into AmiNet · on AmiNetCDs You can @{"reach me" LINK Auteur} by sending your E-mails on the net. @ENDNODE @NODE Requirements "Requirements" @TOC MAIN AmiCAD is a program written in C (SAS C Compiler 6.58), and also with Devpac 3.14 for some little assembly routines. AmiCAD requires the following: - Workbench 3.0+ - 68020 processor or better. It's an electronics vector sheets editor. It uses only integers for faster and simpler working. It's ARexx interface gives it more than 130 commands, user defined functions are also available. It can use it's own variables (integer maths and strings). The @{"bgui.library" LINK BGUI} version 39+ can be used for loading and looking for symbols, although it's not necessary for running the program. This library is not included in the package, you can get it on Aminet. The program will work perfectly without it, but the loading of libraries will be a lot harder, and the choice of the components too... The program can work with many windows at the same time, as long as memory is available. The advanced options of the 3.0 system are used: @{"AppIcon" LINK AppIcon}, @{"Pools" LINK Pools}... @ENDNODE @NODE Installation Installation @TOC MAIN The simplest method of installation is to use the provided Installer script. The Installer program is required for this to work. The preference files AmiCAD.prefs and AmiCAD.keys must be copied into the same drawer as the AmiCAD program. The AmiCAD.guide @{"help" LINK "Aide en ligne"} file can be copied anywhere you like, you only have to set the AmiCAD tooltype @{"HELPFILE" LINK HELPFILE} to the corresponding path (HELP: for example). WARNING: the program can't be run without the 3.0 ROM system (or 3.1). @ENDNODE @NODE Running "Running the program / ToolTypes" @TOC MAIN The stack used by AmiCAD can be set to 4 kB only. AmiCAD can be started from the CLI or the Workbench (by double clicking on it's icon). @{b}Running from a CLI (or Shell)@{ub} The template of the command is: AmiCAD FILE/M,HELPFILE/K,LIBS/K,CLIPS/K,STARTUP/K,MACRO/K,SHEET_WIDTH/N,SHEET_HEIGHT/N The program detaches from the console, so the "Run" command is not required. AmigaDOS wildcards can be used: AmiCAD #?.sheet ==> all files with the extension ".sheet" will be loaded into individual windows. You can start the program without giving it a file name: the title "NoName" will be used by default. The keyword HELPFILE gives the path where the help file can be found: Example: AmiCAD HELPFILE HELP:AmiCAD.guide The keyword LIBS gives the path where the symbol libraries are stored: Example: AmiCAD LIBS Work:AmiCAD/Symbols The keyword CLIPS gives the path where the clips are stored: Example: AmiCAD CLIPS Work:AmiCAD/Clips The keyword STARTUP gives the program the name of an ARexx script that will be run at startup. Example: AmiCAD STARTUP startup.AmiCAD The keyword MACRO gives a command that will be executed at startup. Example: AmiCAD MACRO=LOADPREF("Config2") The keyword @{"SHEET_WIDTH" LINK SHEET_WIDTH} gives the width of the SuperBitmap window. Example: AmiCAD SHEET_WIDTH=1000 The keyword @{"SHEET_HEIGHT" LINK SHEET_HEIGHT} gives the height of the SuperBitmap window. Example: AmiCAD SHEET_HEIGHT=700 All these keywords can be associated in a single command: AmiCAD HELPFILE HELP:AmiCAD.guide LIBS Work:AmiCAD/Symbols NewSheet @{b}Running from Workbench@{ub} You only have to click twice on the icon of the program or on an icon associated to a file saved with AmiCAD. The program icon accepts the ten tooltypes described here: @{" WINDOW " LINK "OUTIL WINDOW"}, @{" HELPFILE " LINK HELPFILE}, @{" STARTUP " LINK STARTUP}, @{" LIBS " LINK LIBS}, @{" MACRO " LINK _MACROS}, @{" CLIPS " LINK CLIPS}, @{" X_ICON " LINK X_ICON}, @{" Y_ICON " LINK Y_ICON}, @{"SHEET_WIDTH " LINK SHEET_WIDTH}, @{"SHEET_HEIGHT" LINK SHEET_HEIGHT}, @{" GRIDSIZE " LINK GRIDSIZE}. Use the Workbench Information menuitem to display and modify them. When the program is running, all the requesters that are open can be closed by clicking on the gadgets or with the keyboard, (sometimes with the right mouse button also). ESC can replace a click on CANCEL, ENTER can replace YES or OK. @ENDNODE @NODE "Barre de titre" "Title bar format" There are some indicators on the titlebars of the windows: - The name of the file associated to the window (with the @{"complete" LINK "Full name"} path or not), - some letters between two braces []:, - a + sign if the document has been modified - the letter G if @{"snap on grid" LINK "Snap on grid"} is valid, - the letter R if components are placed with their @{"Reference" LINK "Place reference"}, - the letter V if components are placed with their @{"Value" LINK "Place value"}, - the letter N if components are placed with their @{"pins numbers" LINK "Place pins numbers"}, - the letter L if lines are @{"pulled" LINK "Pull lines"} while moving components, - a number that gives the width of the actual lines that are drawn (0 for dashed lines). - the cursor coordinates X=...,Y=... The windows have two proportional gadgets to scroll big sheets larger than the screen. The windows can be @{"iconified" LINK Iconify}, then they have no more gadgets, but they take only a little space on the screen. Select this window and click on the right button of the mouse to open it again. @ENDNODE @NODE HELPFILE "The HELPFILE tooltype" @TOC Running This tooltype gives to the program the path to find the guide file. This word must be followed by the sign "=" and the path and name of the guide file. So you can place it where you want and even rename it. Example: HELPFILE=HELP:AmiCAD.guide @ENDNODE @NODE "OUTIL WINDOW" "The WINDOW tooltype" @TOC Running This tooltype gives the program the dimensions and location of the window that is opened when the program is run. The word must be followed by the sign "=", then the coordinates of the upper left corner, then the window width and height. No space can be inserted between the fields, just a ",". Note: if you load a file at startup, this tooltype will be ignored, the data will be taken from the file. Example: WINDOW=0,1,1000,500 If the screen is smaller than the requested dimensions, the window is opened at the maximum available. @ENDNODE @NODE STARTUP "The STARTUP tooltype" @TOC Running This tooltype gives to the program the name of an @{"ARexx script" LINK Script} that will be run at startup. So you can @{"define" LINK DEF} the usual functions you often use, if you want. Examples: STARTUP=startup.amiCAD STARTUP=startup @ENDNODE @NODE LIBS "The LIBS tooltype" @TOC Running This tooltype gives the path where the symbols files are found. The default path is the Libs sub-directory, in the AmiCAD directory. Examples: LIBS=Work:AmiCAD/Symbols LIBS=Symbols See also: @{"LIBSPATH" LINK LIBSPATH} @ENDNODE @NODE CLIPS "The CLIPS tooltype" @TOC Running This tooltype gives the path where the clips are found. The default path is the Clips sub-directory, in the AmiCAD directory. Examples: CLIPS=Work:AmiCAD/Clips CLIPS=User_symbols See also: @{"CLIPPATH" LINK CLIPPATH} @ENDNODE @NODE _MACROS "The MACRO tooltype" @TOC Running This tooltype can specify a command that will be executed at the program startup. All ARexx commands can be used, you can also specify many commands, using the ":" separator. Example: MACRO=LOADPREF("Configuration2"):LOADLIB("Symbols special") @ENDNODE @NODE X_ICON "The X_ICON tooltype" @TOC Running This tooltype is used to locate the AmiCAD AppIcon on the Workbench screen. Example: X_ICON=10 puts the icon at the left of the screen. See also: @{"Y_ICON" LINK Y_ICON} @ENDNODE @NODE Y_ICON "The Y_ICON tooltype" @TOC Running This tooltype is used to locate the AmiCAD AppIcon on the Workbench screen. Example: Y_ICON=500 puts the icon at the bottom of the screen. See also: @{"X_ICON" LINK X_ICON} @ENDNODE @NODE SHEET_WIDTH "The SHEET_WIDTH tooltype" @TOC Running This tooltype defines the width of the document that will be opened when the program is run (default value). The window is a SuperBitmap window, all the objects will be drawn in it. Big values require a large amount of CHIP memory, but you can then draw big sheets on the same document. Adjust this value to your needs and to your configuration. This value will be adjusted to a multiple of 16. Example: SHEET_WIDTH=750 See also: @{"SHEET_HEIGHT" LINK SHEET_HEIGHT} @ENDNODE @NODE SHEET_HEIGHT "The SHEET_HEIGHT tooltype" @TOC Running This tooltype defines the height of the document that will be opened when the program is run. See also: @{"SHEET_WIDTH" LINK SHEET_WIDTH} @ENDNODE @NODE GRIDSIZE "The GRIDSIZE tooltype" @TOC Running This tooltype defines the grid size. This default size is 10. If you prefer using a size of 5, use the example below: Example: GRIDSIZE=5 @ENDNODE @NODE Menus "AmiCAD menus" @TOC Main AmiCAD handles 5 menus, they can be used with the right mouse button, like any other application on Amiga. Many of them can be called using the keyboard, without the right Amiga key. @{"Project " LINK Project} @{"Drawing " LINK Drawing} @{"Edit " LINK Edition} @{"Macros " LINK Macros} @{"Preferences" LINK Preferences} Many of these menus can be called using the ARexx function @{"MENU" LINK MENU}. @ENDNODE @NODE Project "Project menu" @TOC Menus This menu has 16 entries: @{"Load file " LINK "Load file"} Load a file in the active window. @{"Save file " LINK "Save file"} Save the current document. @{"Save as " LINK "Save as"} Sve the current document using the asl requester. @{"Save IFF " LINK "Save IFF"} Save the current document in an IFF file. @{"Rename " LINK Rename} Rename the current document. @{"Filenote " LINK Filenote} Annotate a file. @{"Kill file " LINK "Kill file"} Delete a file. @{"Iconify " LINK Iconify} Iconify the current window. @{"Hide " LINK Hide} Close the current window, the document is always in memory. @{"Other window " LINK "Other window F3"} Open a new window. @{"Initialize " LINK Initialize} The current window is cleaned. @{"Print " LINK "Print document"} Printing of the current document. @{"Informations " LINK Informations} Displays some informations. @{"Sheets " LINK Sheets} Displays the document list. @{"Help  " LINK Help?} Displays the AmigaGuide help. @{"Quit " LINK Quit} Close all the documents. @ENDNODE @NODE "Load file" "Project menu/Load file" @TOC Project You can choose the document to load with the asl.library requester. This library is loaded only when needed. The window takes the name of the loaded file. If the window was not empty and it's content had not been saved, a requester will ask you if you want to save the document. Keyboard shortcut: AMIGA-O (open) or O Note: you can use the @{"AppIcon" LINK AppIcon} present on the Workbench screen for loading a file. See also: @{"LOAD" LINK LOAD}, @{"OPEN" LINK OPEN}. ARexx call: MENU("Charger") @ENDNODE @NODE "Save file" "Project menu/Save file" @TOC Project The document is saved using the current file name in the window. Keyboard shortcut: AMIGA-S (save) or S See also: @{"SAVE" LINK SAVE}. ARexx call: MENU("Save file") Warning: solid space between (ALT SPACE) the words save and file. @ENDNODE @NODE "Save as" "Project menu/Save as" @TOC Project The current document is saved using the asl.library requester to choose the filename. If the file already exists a requester will ask you to confirm that you want to overwrite it. Keyboard shortcut: AMIGA-A (save As) or A See also: @{"SAVE" LINK SAVE}. ARexx call: MENU("Save as") Warning: solid space between (ALT SPACE) the words save and as. @ENDNODE @NODE "Save IFF" "Project menu/Save IFF" @TOC Project The current document is saved in a file using the IFF format. You can then load this file into a bitmap drawing program like Personal Paint, Deluxe Paint or other... You can also import the file with a program like ProPage or Wordworth. The files are saved using only two colours (black lines, white background). The grid is not represented. The file is selected using the asl.library requester. There is no keyboard shortcut for this entry. See also: @{"SAVEIFF" LINK SAVEIFF}. ARexx call: MENU("Save IFF") Warning: solid space between (ALT SPACE) the words Save and IFF. @ENDNODE @NODE Rename "Project menu/Rename" @TOC Project The asl.library requester is opened and you can choose a filename, the current window is renamed using this filename. Keyboard shortcut: AMIGA-= or = See also: @{"FILENAME" LINK FILENAME}. ARexx call: MENU("Rename") @ENDNODE @NODE Filenote "Project menu/Filenote" @TOC Project The asl.library requester is opened, if you select a file a requester asks you for a note to attach to the file. This note will be displayed using the AmigaDOS command List or with the Workbench menu Icon/Information. There is no keyboard shortcut for this entry. ARexx call: MENU("Filenote") @ENDNODE @NODE "Kill file" "Project menu/Kill file" @TOC Project The asl.library requester is opened, if you select a file, it will be deleted. Warning: you can't recover the file... There is no keyboard shortcut for this entry (dangerous...). ARexx call: MENU("Kill file") Warning: solid space between (ALT SPACE) the words kill and file. @ENDNODE @NODE Iconify "Project menu/Iconify" @TOC Project The window is closed, a small window is opened in the top of the screen, including only the name of the document (without the path). You can select this window and use the right button to reopen it. This menu is useful when you work with multiple windows. You can place the iconified window whereever you want, when the window is iconified again, it will return to this place. To close an iconified window without opening it, type CTRL-Q with the keyboard when it's selected. Keyboard shortcut: AMIGA-I (icon) I ARexx call: MENU("Iconify") @ENDNODE @NODE Hide "Project menu/Hide" @TOC Project The window is closed but the document remains in memory. To reopen this window, click on the AppIcon, (on the Workbench screen), if it's the only window. If you are working with another window, use a double click on the right button of the mouse: a requester is opened with a button for each document that is in memory, just click on the button of the document you want to work with. Keyboard shortcut: AMIGA-$ or $ ARexx call: MENU("Hide") @ENDNODE @NODE "Other window F3" "Project menu/Other window" @TOC Project A new window is opened, the asl.library requester is opened and you can select a file to load in it. If you want to open a window without loading a file, just use the F4 key. Keyboard shortcut: F3 or F4 (no asl.requester) The keyboard shortcuts can also be used by selecting an iconified window and using the key. See also: @{"NEW" LINK NEW}, @{"OPEN" LINK OPEN}. ARexx call: MENU("Other window") Warning: solid space between (ALT SPACE) the words Other and window @ENDNODE @NODE Initialize "Project menu/Initialize" @TOC Project All the objects of the current window are deleted. If the document was modified but not saved, a requester is opened asking you to confirm the operation. There is no keyboard shortcut for this entry. ARexx call: MENU("Initialize") @ENDNODE @NODE "Print document" "Project menu/Print document" @TOC Project The document is printed using the printer.device. The current system Preferences are used, (printer driver...) A requester will ask you for a ratio, if you reply with a value of 1, a pixel on screen will be equivalent to a dot on the paper, if you reply by 2, the document will be printed twice the size. Try to find the best value for your printer density and the dimensions of your document. WARNING: If the value of the ratio is 0, the operation is aborted. Large values consume a lot of CHIP memory. If you reply with a good positive value, a second requester will ask you if you want to print the document rotated or not, this feature lets you print the document horizontally, (no rotation), or vertically. The windows are iconified during this process to make more CHIP memory available. If you have any problem, try to close some windows or screens not in use at the moment. Keyboard shortcut: AMIGA-P (Print) or P See also: @{"PRINT" LINK PRINT} ARexx call: MENU("Print") @ENDNODE @NODE Informations "Project menu/Informations" @TOC Project A requester is opened to display some information : copyright, number of objects in the current document, name of the ARexx @{"port" LINK Port}, free memory... Keyboard shortcut: AMIGA-K or K ARexx call: MENU("Informations") @ENDNODE @NODE Sheets "Project menu/Sheets" @TOC Project A requester is opened with all the document names and the number of objects they include. At the left of the display, a number is displayed. This number is the number of the window. It's useful because you can select any window without the mouse but with the keyboard, simply by pressing an ALT key with one of the numeric keys (0 to 9): then the window with this number is placed in front of the screen. So the keyboard shortcut ALT-1 places the first window in front of the screen, ALT-2 puts the second window, and so on. You can also use the - and + keys (always with an ALT key) to go to the previous or next window. The sign (+ or -) that is present at the right of the window number, in the requester says if the document has been modified (+) or not (-). Another way to call a window is to use a double click on the right @{b}mouse button@{ub}: a requester will be opened with a button for each document. Just click on the right button to put it's window in front of the screen. There is no keyboard shortcut for this entry. See also: @{"REQSHEET" LINK REQSHEET}. ARexx call: MENU("Sheets"). @ENDNODE @NODE Help? "Project menu/Help?" @TOC Project A requester is opened to ask you the name of the node of the AmiCAD.guide file you want to be displayed. This file contains many items, there is a node for each ARexx macro, with it's name (Ex: COPY, PASTE...) You can also have help for each menu entry by selecting the menu entry with the right mouse button and pressing the HELP key. When there is an error displayed in a requester, if this error is relative to an ARexx function, just type the HELP key while the requester is open, the AmiCAD.guide will be opened to the corresponding node. Keyboard shortcut: AMIGA-? or ? See also: @{"HELP" LINK HELP}. ARexx call: MENU("Help") @ENDNODE @NODE Quit "Project menu/Quit" @TOC Project All the documents present in memory are closed. If some of them were modified and not saved, a requester will ask you to continue or not. The program frees all memory it was using when everything is closed. Keyboard shortcut: AMIGA-Q (all the windows are closed) Q (the current window only is closed) See also: @{"CLOSE" LINK CLOSE}. Arexx call: MENU("Quit") Note: No save requesters will be displayed. @ENDNODE @NODE "AppIcon" "AmiCAD AppIcon" @TOC MAIN When AmiCAD is @{"running" LINK Running}, an AppIcon is placed on the Workbench screen. It's name is AmiCAD. It's purpose is to load any document by dragging it's icon onto this AppIcon. Simple, no? This AppIcon has another function: clicking twice on it brings the AmiCAD screen to the front. You can use it to recover a window that was closed previously (see menu @{"Project/Hide" LINK Hide}). If the program seems locked after executing an ARexx script you can also try to click on it, if this situation is caused by bad usage of the ARexx function @{"LOCK" LINK LOCK}, the problem will be solved. @ENDNODE @NODE "Pools" "Memory handler" @TOC MAIN Pools are handled by the operating system version 3.0 and later. Its purpose is to have a better memory handler, it's faster and reduces memory fragmentation. @ENDNODE @NODE "Drawing" "Drawing menu" @TOC Menus This menu is for drawing objects on the document. All these objects are vector oriented. They can be modified with a double click from the left mouse button (a requester is opened with gadgets, depending on the object type). This menu has 26 entries: @{"Grid size " LINK "Grid size"} @{"Snap on grid " LINK "Snap on grid"} @{"Choose component " LINK "Choose component"} @{"Place component " LINK "Place component"} @{"Place reference " LINK "Place reference"} @{"Place value " LINK "Place value"} @{"Place pins numbers " LINK "Place pins numbers"} @{"Rotation " LINK Rotation} @{"Reflection " LINK Reflection} @{"Alternate symbol " LINK "Alternate symbol"} @{"Normal position " LINK "Normal position"} @{"Place line " LINK "Place line"} @{"Orthogonal mode " LINK "Orthogonal mode"} @{"Continuous drawing " LINK "Continuous drawing"} @{"Double line " LINK "Double line"} @{"Bus " LINK Bus} @{"Dashed line " LINK "Dashed line"} @{"Any width " LINK "Any width"} @{"Place box " LINK "Place box"} @{"Place ellipse " LINK "Place ellipse"} @{"Place arc " LINK "Place arc"} @{"Place junction " LINK "Place junction"} @{"Place text " LINK "Place text"} @{"Place input connector " LINK "Place input connector"} @{"Place output connector" LINK "Place output connector"} @{"Redraw all " LINK "Redraw all"} @ENDNODE @NODE "Grid size" "Drawing menu/Grid size" @TOC Drawing With this menu, you can define the size of the grid that is used to space the objects on the document. The default size is 10. The components defined in the symbol libraries all use this size. But you can choose another size if you want, some users prefer working with a size of 5. Keyboard shortcut: AMIGA-µ or µ See also: @{"SETGRID" LINK SETGRID}. ARexx call: MENU("Grid size") Warning: solid space between or MENU("Grid") (ALT SPACE) the words Grid and size. @ENDNODE @NODE "Snap on grid" "Drawing menu/Snap on grid" @TOC Drawing When this entry is marked, the objects are placed on the grid, if it's not marked you can place the objects wherever you want, but if you place some components like that, you will have some difficulties when placing the wires... Keyboard shortcut: AMIGA-G or G ARexx call: MENU("Snap") @ENDNODE @NODE "Choose component" "Drawing menu/Choose component" @TOC Drawing A requester is opened to look for a component in the libraries. This function needs the @{"bgui.library" LINK BGUI}. The window has two lists: the left one is for the libraries, the right one for the symbols. You can load or flush any library using the buttons. The buttons labeled "Before" and "After" are used to change the order of the libraries in the list, symbols are searched in the first library, then in the second... The other buttons have the same role of the equivalent menus. The selected component is displayed in the upper left corner of the document window. Keyboard shortcut: AMIGA-% or % See also: @{"GETPART" LINK GETPART}, @{"LOADLIB" LINK LOADLIB}. ARexx call: MENU("Choose component") Warning: "solid" space (ALT SPACE) between the words Choose and component. @ENDNODE @NODE "Place component" "Drawing menu/Place component" @TOC Drawing This entry enables the component mode. The current symbol is drawn under the cursor and you can place it on the document. If no symbol is valid, the @{"bgui requester" LINK Choose component} is opened. Click with the left mouse button to place a component on the document. You are greatly encouraged to use the option @{"Snap on grid" LINK "Snap on grid"} to place the components. Keyboard shortcut: AMIGA-H or H See also: @{"PUTPART" LINK PUTPART} ARexx call: MENU("Place component") Warning: solid space (ALT SPACE) between the words Place and component. @ENDNODE @NODE "Place reference" "Drawing menu/Place reference" @TOC Drawing When this entry is marked, when components are @{"placed" LINK Place component} with the mouse, it's reference will also be placed next to it. This reference can be edited by a double click on the component or on the reference itself. You can also move this object at another place with the left mouse button (click on it, and drag the mouse while the button is held down). Default references are defined in the libraries and can't be changed. You can call the @{"ARexx script" LINK "Call script"} AddRefs to add the part numbers. There is no keyboard shortcut for this entry, but you can also change it's state under the bgui.requester. See also: @{"SETREF" LINK SETREF}. This menu can't be called by ARexx. @ENDNODE @NODE "Place value" "Drawing menu/Place value" @TOC Drawing When this entry is marked, when components are @{"placed" LINK Place component} with the mouse, it's default value will also be placed next it. This value can be edited by a double click on the component or on the value itself. You can also move this object at another place with the left mouse button (click on it, and drag the mouse while the button is held down). The default value is the name of the object. There is no keyboard shortcut for this entry. See also: @{"SETVAL" LINK SETVAL}. This menu can't be called by ARexx. @ENDNODE @NODE "Place pins numbers" "Drawing menu/Place pins numbers" @TOC Drawing When this entry is marked, when components are @{"placed" LINK Place component} with the mouse, it's pins will be numbered, if this component is defined with pin numbers in the library (always in this case for IC). If a component is placed on the document and you want to modify this indication, double click on it with the left mouse button and click on the button "Pins numbers" to change this option, if it can be edited (resistances for example have no pin number). There is no keyboard shortcut for this entry. This menu can't be called by ARexx. @ENDNODE @NODE "Rotation" "Drawing menu/Rotation" @TOC Drawing When this entry is selected the current symbol or the selected objects are rotated by 90 degrees. If you press a SHIFT key while selecting the menu the rotation will be anti-clockwise. This operation can also be performed on a clip (just select the menu Edit/Paste, then this one). Keyboard shortcut: AMIGA-R or R (clockwise) AMIGA-SHIFT-R or SHIFT-R (anti-clockwise) See also: @{"ROTATE" LINK ROTATE}. ARexx call: MENU("Rotation") @ENDNODE @NODE "Reflection" "Drawing menu/Reflection" @TOC Drawing When this entry is selected the current symbol or the selected objects are mirrored. This operation is done around the vertical axis of the objects (or horizontal if they were rotated). This operation can also be performed on a clip (just select the menu Edit/Paste, then this one). Keyboard shortcut: AMIGA-/ or / See also: @{"SYMMETRY" LINK SYMMETRY}. ARexx call: MENU("Reflection") @ENDNODE @NODE "Alternate symbol" "Drawing menu/Alternate symbol" @TOC Drawing Select this menu to toggle the symbol definition of a component, when it exists in the library. You can perform this operation on the current symbol being placed or the selected components. This feature is useful for amplifiers for inverting the + and - inputs. In some libraries the alternate symbol is an american symbol (try the resistance). Keyboard shortcut: AMIGA-~ or ~ See also: @{"CONVERT" LINK CONVERT}. ARexx call: MENU("Alternate") @ENDNODE @NODE "Normal position" "Drawing menu/Normal position" @TOC Drawing This entry invalidates the effects of the precedents @{"rotation" LINK Rotation}, @{"reflection" LINK Reflection} and @{"Alternate symbol" LINK "Alternate symbol"}. You can perform this operation on the current symbol being placed or on the selected components. Keyboard shortcut: AMIGA-N ou N. ARexx call: MENU("Normal position") Warning: solid space between (ALT SPACE) the words Normal and position. @ENDNODE @NODE "Place line" "Drawing menu/Place line" @TOC Drawing This entry enables the wire mode (or line mode). When it's selected the cursor is changed (into a cross). To place a line, move the cursor to the start and click the left mouse button, now place the cursor at the end point and click again with the left button. Click on the right button to abort a placement. To stop this mode, click on the right button or select another mode. The current line width is indicated in the @{"title bar" LINK "Barre de titre"}. It can be modified using one of these menus: @{"Double line" LINK "Double line"}, @{"Bus" LINK Bus}, @{"Dashed line" LINK "Dashed line"} or @{"Any width" LINK "Any width"}. To modify a line, click on an extremity with the left button, and holding the button down, drag the mouse to another place. You can also use the keyboard to adjust a line: select the line by clicking on it, and use the cursor keys with the ALT or CTRL keys to modify the beginning or the ending of the line. You can also use the SHIFT key to move faster (grid size). Keyboard shortcut: AMIGA-SPACE or SPACE See also: @{"Orthogonal mode" LINK "Orthogonal mode"}, @{"Continuous drawing" LINK "Continuous drawing"}, @{"Double line" LINK "Double line"}, @{"Bus" LINK Bus} et @{"Dashed line" LINK "Dashed line"}. @{"DRAW" LINK DRAW}. ARexx call: MENU("Place line") Warning: solid space (ALT SPACE) between the words Place and line. @ENDNODE @NODE "Orthogonal mode" "Drawing menu/Orthogonal mode" @TOC Drawing When this entry is marked, the lines are always placed horizontally or vertically, or at an angle of 45 degrees. Select this menu to toggle its state. Keyboard shortcut: AMIGA-| or | ARexx call: MENU("Orthogonal mode") Warning: solid space (ALT-SPACE) between the words Orthogonal and mode. @ENDNODE @NODE "Continuous drawing" "Drawing menu/Continuous drawing" @TOC Drawing When this entry is marked, when @{"line mode" LINK "Place line"} is active, a new line is placed at the extremity of the precedent. Click on the right mouse button to interrupt the continuity of the lines. Select this menu to toggle its state. There is no keyboard shortcut for this entry. This menu can't be called by ARexx. @ENDNODE @NODE "Double line" "Drawing menu/Double line" @TOC Drawing When this entry is marked, the lines are drawn with 2 pixels width. To stop this mode, select this entry again or choose another mode: @{"Bus" LINK Bus}, @{"Dashed line" LINK "Dashed line"} or @{"Any width" LINK "Any width"}. Note that the current line width is written in the @{"title bar" LINK "Barre de titre"}. Keyboard shortcut: AMIGA-\ or \ See also: @{"DRAWMODE(1)" LINK DRAWMODE}. ARexx call: MENU("Double line") Warning: solid space (ALT SPACEC) between the words Double and line. @ENDNODE @NODE "Bus" "Drawing menu/Bus" @TOC Drawing When this entry is marked, the lines are drawn with 7 pixels width. To stop this mode, select this entry again or choose another mode: @{"Double line" LINK "Double line"}, @{"Dashed line" LINK "Dashed line"} or @{"Any width" LINK "Any width"}. Note that the current line width is written in the @{"title bar" LINK "Barre de titre"}. Keyboard shortcut: AMIGA-. or . See also: @{"DRAWMODE(2)" LINK DRAWMODE}. ARexx call: MENU("Bus") @ENDNODE @NODE "Any width" "Drawing menu/Any width" @TOC Drawing When this entry is marked, the lines can be drawn at any width. A requester will ask you for the width you want. Enter a value between 1 and 255. All the objects that will be placed after this choice, will be drawn with this line width. If you select this entry while it's marked, the line width becomes 1. There is no keyboard shortcut for this entry. See also: @{"DRAWMODE(2)" LINK DRAWMODE}. This menu can't be called by ARexx. @ENDNODE @NODE "Dashed line" "Drawing menu/Dashed line" @TOC Drawing When this entry is marked, the lines are drawn like dashed lines. To cancel this mode, select it again or choose another mode: @{"Double line" LINK "Double line"}, @{"Bus" LINK "Bus"} or @{"Any width" LINK "Any width"}. Keyboard shortcut: AMIGA-: or : See also: @{"DRAWMODE(0)" LINK DRAWMODE}. ARexx call: MENU("Dashed line") Warning: solid space (ALT-SPACE) between the words Dashed and line. @ENDNODE @NODE "Place box" "Drawing menu/Place box" @TOC Drawing When you select this entry, the cursor changes to box mode (like in line mode). Click on a corner of the box you want to draw with the left button mouse, go to the opposite corner and click again. If you want to cancel the operation, click on the right button. The boxes are drawn using the current width. To modify an existing box, click in a corner, and with the left button mouse held down, place this corner wherever you want and release the button. To cancel the operation, click on the right mouse button. To modify the line width of a box, double click on the box and give a new value in the requester. Keyboard shortcut: AMIGA-B or B ARexx call: MENU("Place box") Warning: solid space (ALT-SPACE) between the words Place and box. @ENDNODE @NODE "Place ellipse" "Drawing menu/Place ellipse" @TOC Drawing When you select this entry, an ellipse is drawn under the cursor. To place an ellipse on the document, move the mouse and when this ellipse is where you want it to be, click on the left button. You can also modify it's diameters using the cursor keys (UP and DOWN for the vertical axis, LEFT and RIGHT for the vertical axis). If you use also the SHIFT key, the modification will be faster. You can also use the + and - keys to modify the two axis' at the same time. To modify an ellipse that is on the document, you can use a double click on it or click on one of it's axis', near it's border, and drag the mouse. If you press the CTRL key while you are performing this operation the ellipse will always be drawn as a circle. To modify the position of an existing ellipse, click in it's center and drag the mouse wherever you want on the document. To cancel this mode, choose another placement mode (lines, components or connectors...) or click on the right mouse button. You can use the menu Rotation for a selected ellipse (Reflection makes no sense). Keyboard shortcut: AMIGA-E or E See also: @{"ELLIPSE" LINK ELLIPSE}. ARexx call: MENU("Place ellipse") Warning: solid space (ALT-SPACE) between Place and ellipse. @ENDNODE @NODE "Place arc" "Drawing menu/Place arc" @TOC Drawing When you select this entry, an arc is drawn under the cursor. To place this arc on the document, place the cursor where you want and click on the left mouse button. To cancel this mode, use a click on the right mouse button. You can modify it's dimensions using the cursor keys with or without the ALT, CTRL and SHIFT keys. With the ALT key you can change the radius, with CTRL you can change the angles, the SHIFT key provides faster changes. To edit an existing arc, you can use a double click to select it and use the ALT, CTRL and SHIFT keys in combination with the cursor keys, as above. If you none of these qualifier keys is used you can move the arc when you use the cursor keys. You can also use the menus Rotation and Reflection to modify the selected arc. Keyboard shortcut: AMIGA-§ or § See also: @{"ARC" LINK ARC}. ARexx call: MENU("Place arc") Warning: solid space (ALT-SPACE) between Place and arc. @ENDNODE @NODE "Place junction" "Drawing menu/Place junction" @TOC Drawing When you select this entry a junction is drawn under the cursor. To place it, click on the left mouse button. To cancel this mode, click on the right mouse button. Keyboard shortcut: AMIGA-J or J See also: @{"JUNCTION" LINK JUNCTION}. ARexx call: MENU("Place junction") Warning: solid space (ALT-SPACE) between Place and junction. @ENDNODE @NODE "Place text" "Drawing menu/Place text" @TOC Drawing A requester is opened to let you give a text to place on the document. If you accept this requester, the text is placed under cursor and you can place it where you want, just use the left mouse button to place it. To cancel this mode, use the right mouse button. You can rotate or reflect a text before placing it. To modify a text, double click on it and choose a gadget in the requester. Keyboard shortcut: AMIGA-T or T See also: @{"WRITE" LINK WRITE}, @{"LINKVAL" LINK LINKVAL}, @{"LINKREF" LINK LINKREF}. ARexx call: MENU("Place text") Warning: solid space (ALT-SPACE) between Place and text. @ENDNODE @NODE "Place input connector" "Drawing menu/Place input connector" @TOC Drawing A requester is opened to ask you for the connector name. This object is attached to its right. The size of this object depends on the length of its name. Use the left mouse button to place it on the document. To cancel this mode, use the right mouse button. To modify an existing object of this type double click on it with the left mouse button, then choose a gadget in the requester. If you want a right pointing arrow, choose the menu @{"Drawing/Reflection" LINK Reflection}. Keyboard shortcut: AMIGA-< or < See also: @{"INPUT" LINK INPUT}. ARexx call: MENU("Place input connector") Warning: solid spaces (ALT-SPACE) between the words. @ENDNODE @NODE "Place output connector" "Drawing menu/Place output connector" @TOC Drawing A requester is opened to ask you for the connector name. This object is attached to its left. The size of this object depends on the length of its name. Use the left mouse button to place it on the document. To cancel this mode, use the right mouse button. To modify an existing object of this type double click on it with the left mouse button, then choose a gadget in the requester. If you want a left pointing arrow, choose the menu @{"Drawing/Reflection" LINK Reflection}. Keyboard shortcut: AMIGA-> or > See also: @{"OUTPUT" LINK OUTPUT}. ARexx call: MENU("Place output connector") Warning: solid spaces (ALT-SPACE) between the words. @ENDNODE @NODE "Redraw all" "Drawing menu/Redraw all" @TOC Drawing When you select this entry, the complete document is cleared and redrawn. It's useful after some selections, block moves, or to display the grid correctly after some edits... Keyboard shortcut: AMIGA-Z or Z ARexx call: MENU("Redraw") @ENDNODE @NODE "Edition" "Menu Edition" @TOC "Menus" These menus are relative to the objects being selected. You can select some objects with the mouse, in two ways: - clicking in a zone where there is no object, and with the left mouse button depressed, drag the mouse. All the objects that are present in the rectangle you are drawing will be selected, - clicking on an object, this one will be selected. However if the menu entry @{"Edition/Multiselection" LINK Multiselection} is not marked, only one object at a time can be selected, except if you hold one of the SHIFT keys when you click. When a block is already selected, you can add objects using one of the SHIFT keys while using the left mouse button. To select an object that is behind another (to back), select the first object, then click on the second while the ALT key is pressed. To cancel the selection of an object or of a block, push the CTRL key when you use the mouse (with a SHIFT key if necessary...) To cancel all the selections, press the ESC key or click twice anywhere in the window. @{"Copy to clip " LINK "Copy to clip"} @{"Paste from clip " LINK "Paste from clip"} @{"Cut to clip " LINK "Cut to clip"} @{"Delete selection" LINK "Delete selection"} @{"Clone " LINK Clone} @{"Fix on grid " LINK "Fix on grid"} @{"To Front " LINK "To Front"} @{"To Back " LINK "To Back"} @{"Double size " LINK "Double size"} @{"Divide size " LINK "Divide size"} @{"New group " LINK "New group"} @{"Kill group " LINK "Kill group"} @{"Save clip " LINK "Save clip"} @{"Load clip " LINK "Load clip"} @{"Multiselection " LINK Multiselection} @{"Undo " LINK Undo} @ENDNODE @NODE "Copy to clip" "Edition menu/Copy to clip" @TOC Edition This entry handles the copying of the selected objects in memory. If it succeeds, the selection is canceled. AmiCAD handles 10 buffers (clips), so you can save 10 different blocks (see @{"CLIPUNIT" LINK CLIPUNIT}). Keyboard shortcut: AMIGA-C (copy) or C See also: @{"COPY" LINK COPY}, @{"PASTE" LINK PASTE}. ARexx call: MENU("Copy") @ENDNODE @NODE "Paste from clip" "Edition menu/Paste from clip" @TOC Edition The current clip is copied under the cursor. To place it on the sheet, place the cursor where you want using the mouse and click on the left mouse button. Keyboard shortcut: AMIGA-V or V See also: @{"CLIPUNIT" LINK CLIPUNIT}, @{"PASTE" LINK PASTE}, @{"COPY" LINK COPY}. ARexx call: MENU("Paste") @ENDNODE @NODE "Cut to clip" "Edition menu/Cut to clip" @TOC Edition This entry deletes all the selected objects, the block is copied into the current clip. Warning: This function can modify the numbers of the objects present on the document. Keyboard shortcut: AMIGA-X or X See also: @{"CLIPUNIT" LINK CLIPUNIT}, @{"PASTE" LINK PASTE}, @{"COPY" LINK COPY}. ARexx call: MENU("Cut") @ENDNODE @NODE "Delete selection" "Edition menu/Delete selection" @TOC Edition This entry deletes all the selected objects. Warning: This function can modify the numbers of the objects present on the document. Keyboard shortcut: AMIGA-Y, Y or DEL ARexx call: MENU("Delete") @ENDNODE @NODE "Clone" "Edition menu/Clone" @TOC Edition This entry clones the selected objects. You can obtain the same result using first the @{"Copy" LINK "Copy to clip"} menu, then the @{"Paste" LINK "Paste from clip"} menu. Keyboard shortcut: AMIGA-TAB or TAB ARexx call: MENU("Clone") @ENDNODE @NODE "Fix on grid" "Edition menu/Fix on grid" @TOC Edition This menu fixes all the selected objects on the grid. This entry is useful to align some objects. The point of the objects that is fixed on the grid is the upper left corner. Groups are not correctly handled by this menu entry. Keyboard shortcut: AMIGA-! or ! ARexx call: MENU("Fix") @ENDNODE @NODE "To Front" "Edition menu/To Front" @TOC Edition All the selected objects are placed before the others, so when you click on one of them you can reach them easily. Note: you can reach an object placed behind another one using the ALT key when clicking on them, the first time you'll get the first object, the second one you'll get the second object. Warning: This function modifies the objects numbering. Keyboard shortcut: AMIGA-M or M ARexx call: MENU("To front") Warning: solid space (ALT-SPACE) between the words To and front. @ENDNODE @NODE "To Back" "Edition menu/To Back" @TOC Edition All the selected objects are placed at the end of the list. So when you click on them they are not selected if there are other objects in the same location. Warning: This function modifies the objects numbering. Keyboard shortcut: AMIGA-D or D ARexx call: MENU("To Back") Warning: solid space (ALT-SPACE) between the words To and Back. @ENDNODE @NODE "Double size" "Edition Menu/Double size" @TOC Edition The size of the selected elements is doubled. You can also use this function to double the current object under the cursor, or while placing an object (from a clip). The objects can't go outside the window to permit to the function to succeed. Keyboard shortcut: AMIGA-+ or + See also: @{"SETSCALE" LINK SETSCALE}. ARexx call: MENU("Double size") Warning: solid space (ALT-SPACE) between the words Double and Size @ENDNODE @NODE "Divide size" "Edition Menu/Divide size" @TOC Edition The size of all the selected objects is halved. The size of these objects have to be a multiple of two (scale of 2, 4, 6...) This function can also divide the size of the currrent object placed under the cursor, or while placing an object (from a clip). Keyboard shortcut: AMIGA-- or - See also: @{"SETSCALE" LINK SETSCALE}. ARexx call: MENU("Divide size") Warning: solid space (ALT-SPACE) between the words Divide and size. @ENDNODE @NODE "New group" "Edition Menu/New group" @TOC Edition All the selected objects are grouped together. Then you can select all of them by clicking on one. The wires connected to a group can be used like a component, when this group is moved. Grouping the objects of a clip is a good way to create clips that look like components. Keyboard shortcut: AMIGA-{ or { ARexx call: MENU("New group") Warning: solid space (ALT-SPACE) between the words New and group. @ENDNODE @NODE "Kill group" "Edition Menu/Kill group" @TOC Edition The selected group is deleted. All the objects that where in a group are unselected. Keyboard shortcut: AMIGA-} or } ARexx call: MENU("Kill group") Warning: solid space (ALT-SPACE) between the words Kill and group. @ENDNODE @NODE "Save clip" "Menu Edition/Save clip" @TOC Edition This menu is used to save the selected block in a file, this file is selected with the asl.library requester. Keyboard shortcut: AMIGA-W or W See also: @{"SAVECLIP" LINK SAVECLIP}, @{"LOADCLIP" LINK LOADCLIP} functions. ARexx call: MENU("Save clip") Warning: solid space (ALT-ESPACE) between the words Save and clip. @ENDNODE @NODE "Load clip" "Menu Edition/Load clip" @TOC Edition This menu is used to read a block that was previously saved in a file (selected with the asl.library requester). If the operation succeeds the block is displayed under the mouse cursor and is moved with it. Use a left mouse button click to place it, or on the right mouse button to cancel the operation. The anchor point of a clip is the upper left corner of the box defined by all the objects in this clip. If you create clips with this point on the grid, their placement will be easier later. Keyboard shortcut: AMIGA-L or L See also: @{"LOADCLIP" LINK LOADCLIP}, @{"SAVECLIP" LINK SAVECLIP} functions. ARexx call: MENU("Load clip") Warning: solid space (ALT-ESPACE) between the words Load and clip. @ENDNODE @NODE "Multiselection" "Menu Edition/Multiselection" @TOC Edition When this entry is marked, you can select all the objects you want, clicking on them without using a SHIFT key. You have to select this menu to toggle its state. Keyboard shortcut: AMIGA-* No ARexx call is possible. @ENDNODE @NODE "Undo" "Menu Edition/Undo" @TOC Edition This menu can be used to cancel the last operation that was done on the document in memory. But the ARexx scripts or ARexx functions will be canceled only if the @{"SAVEALL" LINK SAVEALL} macro is used in them. Keyboard shortcut: AMIGA-U or U ARexx call: MENU("Undo") @ENDNODE @NODE "Macros" "Menu Macros" @TOC "Menus" These menus are used for @{"macro-commands" LINK "Ecriture commandes"} and @{"ARexx scripts" LINK Script}. @{"Direct mode" LINK Direct} Ask for a command, execute it @{"Call script" LINK "Call script"} Calls a selected ARexx script. @{"ARexx... " LINK "ARexx..."} 20 Programmable ARexx scripts. @ENDNODE @NODE "Direct" "Menu Macros/Mode direct" @TOC "Macros" This menu allows the entry of a @{"macro-command" LINK "Ecriture commandes"}, then its execution. Note that you can also use the combination of a key ALT and a function key to obain 10 preprogrammed macros (see @{"Function Keys" LINK "Touches fonction"}). It should be noted that these programmed sequences are backed up in the file "s:AmiCAD.keys", using the menu @{"Preferences/Keys/Save" LINK Keys}. Those are then reloaded during each launching of the program. You can cause the display of a result of a command by beginning the text specifying this command with the equal sign (=). Example: =4*95 displays the result of the multiplication (4 times 95) =FIRSTSEL displays the number of the first selected object Keyboard shortcut: AMIGA-; ou ; See also: functions @{"EXEC" LINK EXEC}, @{"MACRO" LINK MACRO}, @{"MAP" LINK MAP}. ARexx call: MENU("Mode direct") Warning: space "solid" (ALT-ESPACE) between Mode and direct. @ENDNODE @NODE "Call script" "Menu Macros/Call script" @TOC "Macros" This menu allows the entry of a ARexx command, (give the name of the @{"script" LINK Script }, the extension "AmiCAD" is not obligatory). Keyboard shortcut: AMIGA -, or , See also: function @{"CALL" LINK CALL }. ARexx call: MENU("Appel script") Warning: space "solid" (ALT-SPACE) between Appel and script. @ENDNODE @NODE "ARexx..." "Menu Macros/ARexx..." @TOC "Macros" These 20 menuitems are used to define 20 commands able to be launched by the selection of the corresponding menu. At the time of the first call of the menu, the user must define it's command, by giving the name of the script to execute, (without the path). The calls which will follow allow the call of the defined @{"script" LINK Script}. The name of the script then appears in the menu. The 20 definitions can be saved to the file "AmiCAD.prefs", and be reloaded automatically at the execution of the AmiCAD program. These menus can be redefined while pressing one of the SHIFT keys during menu selection. Note that the @{b}editing of a defined script@{ub} can be made in an automatic way in a new window by calling the menu while @{i}pressing the CTRL key,@{ui} (the name must naturally have been defined before). The program then launches the ARexx script EditScript.AmiCAD, passing to it the name of this script in argument. This script, (EditScript), must be adapted to the editor which you use and to your installation, it's written for my text editor, Amitex. The command must comprise the name of the script to be executed, (always without the extension "AmiCAD"). The name can only be a maximum of 11 characters long. It is not possible to transmit parameters to the script. The communications with ARexx are made thanks to the @{"port" LINK Port} AmiCAD.0, (or AmiCAD.1, AmiCAD.2... AmiCAD.999 if several tasks are running at the same time). Use the command port=ADDRESS() to find the port name, if necessary. @{i}Short cuts keyboard:@{ui} AMIGA-0 with AMIGA-9 @{i}See also:@{ui} function @{"CALL" LINK CALL}. No possible ARexx call for these menus, use function CALL. @ENDNODE @NODE "Port" "Port ARexx" @TOC "Macros" The program normally opens a port of communication with the ARexx interpreter during it's launching, this port is called AmiCAD.0, for the first task being launched. If several windows are opened, the second port is called AmiCAD.1, then AmiCAD.2 for the following one, and so (AmiCAD.999 is the limit...) @ENDNODE @NODE "Preferences" "Menu Preferences" @TOC "Menus" This series of menus makes it possible to save certain adjustments to the program in the files AmiCAD.prefs and AmiCAD.keys. These files are saved in the current directory. These files are read automatically at program execution, in order to reload the adjustments desired by the user. These two files are in ASCII format and can thus be viewed and even modified using a text editor. You can in fact, create mini-configuration files containing only part of the configuration, like the palette for example, (see the AmiCAD.palette file for an example). @{"Auto scroll " LINK "Auto scroll"} @{"Backup file " LINK "Backup file"} @{"Save icon " LINK "Save icon"} @{"Pull lines " LINK "Pull lines"} @{"Display grid " LINK "Display grid"} @{"Horizontal scale" LINK "Horizontal"} @{"Vertical scale " LINK "Vertical"} @{"Sheet size " LINK "Sheet size"} @{"Screen mode " LINK "Screen mode"} @{"Palette " LINK Palette} @{"Font " LINK Font} @{"Configuration " LINK Configuration} @{"Function keys " LINK Keys} @ENDNODE @NODE "Auto scroll" "Menu Preferences/Auto scroll" @TOC Preferences When this item is enabled, if the cursor arrives at an edge of the current work window, the contents is automatically scrolled if necessary. There is no keyboard shortcut for this entry. No possible ARexx call for these menus. @ENDNODE @NODE "Backup file" "Menu Preferences/Backup file" @TOC Preferences When this item is enabled, a backup file with the extension ".bis", is created when the sheet is saved. There is no keyboard shortcut for this entry. See also: function @{"SAVECOPY" LINK SAVECOPY }. No possible ARexx call for this menu. @ENDNODE @NODE "Save icon" "Menu Preferences/Save icon" @TOC Preferences If this item is enabled an icon is created when the sheet is saved. The name of the program appears in the Default Tool field. The icon used is the default "Project" icon, stored in directory ENV:Sys. There is no keyboard shortcut for this entry. See also: function @{"SAVEICON" LINK SAVEICON }. No possible ARexx call for this menu. @ENDNODE @NODE "Pull lines" "Menu Preferences/Pull lines" @TOC Preferences If this item is enabled, during the relocation of one or more components by using the mouse, any wires connected to these components will be also moved. Warning: This operation takes place only after having released these components in their new position. Keyboard shortcut: AMIGA-F or F ARexx call: MENU("Pull") @ENDNODE @NODE "Display grid" "Menu Preferences/Display grid" @TOC Preferences If this item is enabled, a grid is displayed on the screen. The step used is that defined in the menu @{"Drawing/Grid size" LINK "Grid size"}. The screen is updated after the call of the menu. There is no keyboard shortcut for this entry. No possible ARexx call for this menu. @ENDNODE @NODE "Full name" "Menu Preferences/Full name" @TOC Preferences If enabled, this menuitem will display the complete name of the document in the @{"titlebar" LINK "Barre de titre"}. If it is not, the name is displayed without the path, this allows more space for other indicators in the titlebar, the co-ordinates of the cursor in particular, when the window is not sufficiently wide or when the complete name is very long (multiple (sub)- directories)). @ENDNODE @NODE "Horizontal" "Menu Preferences/Horizontal scale" @TOC Preferences The value associated with this menu makes it possible to define the default scale of the components which will be placed on the diagram. There is no keyboard shortcut for this entry. See also: functions @{"HSCALE" LINK HSCALE}, @{"SETSCALE" LINK SETSCALE}. ARexx call: MENU("Horizontal scale") @ENDNODE @NODE "Vertical" "Menu Preferences/Vertical scale" @TOC Preferences The value associated with this menu makes it possible to define the default scale of the components which will be placed on the diagram. There is no keyboard shortcut for this entry. See also: functions @{"VSCALE" LINK VSCALE}, @{"SETSCALE" LINK "SETSCALE"}. ARexx call: MENU("Vertical scale") @ENDNODE @NODE "Sheet size" "Menu Preferences/Sheet size" @TOC Preferences This menuitem makes it possible to define the width and the height of the worksheet. The window is in fact of the SuperBitmap type, which makes it possible to profit from very fast operations, but requires a significant quantity of "CHIP" memory. There is no keyboard shortcut for this entry. See also: function @{"DIMSHEET" LINK DIMSHEET}. ARexx call: MENU("Dimensions") @ENDNODE @NODE "Screen mode" "Menu Preferences/Screen mode" @TOC Preferences This menuitem makes it possible to choose the type of screen used to display the windows. An ASL requester is displayed to choose this mode. The low-resolution modes make it possible to work on certain details whereas the high-resolution modes make it possible to have an overall picture of the diagram. Keyboard shortcut: AMIGA-] or ] See also: function @{"SCREEN" LINK SCREEN}. ARexx call: MENU("Choose mode") Warning: space "solid" (ALT-SPACE) between Choose and mode. @ENDNODE @NODE "Palette" "Menu Preferences/Palette" @TOC Preferences This menu makes it possible to choose the colours of the screen used by AmiCAD. Note that these colours are saved in the configuration file. This function requires the reqtools.library. Ensure that you have a copy of it in your "LIBS:" directory. Warning: Do not use a too dark a colour for colour 0, black for example, because then the cursor used to place wires would become invisible... There is no keyboard shortcut for this entry. ARexx call: MENU("Palette") @ENDNODE @NODE "Font" "Menu Preferences/Font" @TOC Preferences This menu makes it possible to choose the font used in the AmiCAD screen. In the absence of the configuration file (see below), it is the font chosen for the default public screen which is used. Keyboard shortcut: AMIGA-[ or [ See also: function @{"SCREEN" LINK SCREEN}. ARexx call: MENU("Choose font") Warning: space "solid" (ALT-SPACE) between Choose and font. @ENDNODE @NODE "Configuration" "Menu Preferences/Configuration" @TOC Preferences This menu comprises three headings, making it possible to save or read the names of the @{"ARexx scripts" LINK Script} as well as, the various modes (run, to save with or without icon, copy diagram...). LOAD : allows the loading of a configuration file of your choice, saved beforehand using the option SAVE or SAVE AS. SAVE : allows the saving of the preferences into the AmiCAD.prefs file. This file is loaded at each program execution. It must be located in the current directory. SAVE AS : allows the saving of the preferences to a file of your choice (asl.library requester). No ARexx call for these menus. @ENDNODE @NODE "Keys" "Menu Preferences/Keys" @TOC Preferences This menu comprises three headings, making it possible to save or read the sequences of programmed keys (function keys, combinations of keys). LOAD : allows the loading of the configuration file of your choice, saved beforehand using the option SAVE or SAVE AS. SAVE : allows the saving of the preferences into the AmiCAD.keys file. This file is loaded at each program execution. SAVE AS : allows the saving of the preferences to a file of your choice (asl.library requester). See also: function @{"MAP" LINK MAP}, @{"Mode direct" LINK Direct}. No ARexx call for these menus. @ENDNODE @NODE Fichiers_Configuration "Format of the configuration files" @TOC Preferences The files AmiCAD.prefs and AmiCAD.keys are ASCII format files, they can thus be viewed, (and also modified), using a simple text editor. Their format follows some elementary rules however. Each one of these two files starts with a heading which should not be changed, it in particular includes the version number of these files, AmiCAD recognizes only the version in force for a given AmiCAD version. Version 1.2 of AmiCAD uses the headings: "AmiCADPrefs 1.1" for the AmiCAD.prefs file, "AmiCADKeys 1.0" for the AmiCAD.keys file. The AmiCAD.prefs file then includes several paragraphs, these paragraphs can be removed to create a particular configuration, including for example only one palette of colours (AmiCAD.palette file for example). Each one of these paragraphs begins with texts placed between two hooks ([Menus_ARexx], [Screen], [Palette] and [Mode]), these texts are followed by several lines including each different information. Whole or part of these lines can be removed. In the same way the AmiCAD.keys file includes two paragraphs [FunctionKeys] and [Macros]. You can add or remove lines in each one of these paragraphs, to suit your configuration. Warning: The words located on the left of the signs = must be written just as they are (no major/minor changes). @ENDNODE @NODE "Ecriture commandes" "Writing a line of command(s)" @TOC "Macros" The macro-commands can be carried out in local mode or by the intermediary of an @{"ARexx script" LINK Script}. You can refer to the scripts given, for example, in the ARexx directory. These must have the extension ".AmiCAD" in their name. Each one of these macro-commands can call one of the ARexx functions, or even several. Some of them require one or more arguments, finally the majority of them return a result. The program also makes it possible to handle @{"variables" LINK Variable }, (both numerical or character string type). Also you can define your own functions. The call of a function is done by giving its name, followed by of one or more arguments, surrounded by brackets, possibly separated by commas. The traditional mathematical operators are of course available: operator signs priority rise with a power: ^ 10 division: / 9 multiplication: * 9 modulo: % 9 addition: + 8 subtraction: - 8 AND logic: & 6 OR exclusive ? 5 OR logic | 4 assignment = 2 This last operator (=) can be used to affect @{"variables" LINK Variable }. Example: A=2, assigns value 2 to variable A. It should be noted that writing A=B=3 is not allowed, it will involve an error message "Impossible Assignment". Rather, write A=3:B=3. Other operators: shift on the left: << shift on the right: >> These two operators have a priority equal to 7. higher test: > higher or equal test: >= lower test: < lower or equal test: <= inequality test: <> test equality: == The tests return the value 1 if they are true, 0 in the othercases. Their priority is equal to 3. There is a particular operator which in fact isn't one, it is the sign ':', this allows the separation of two statements, (or more), in order to be able to place several assignments of @{"variables" LINK Variable} in the same function. Thus you can place A=2:B=3:C=0 in only one command instead of using three of them. The returned result is then that of the last operation carried out, (0 in this example). This possibility can also be of interest for the function FOR, (see further), in order to carry out multiple initializations at the beginning of a loop. It should be noted that you can place a comment in a macro comprising a mathematical expression by using the apostrophe seen previously. Example: DELETE(FIRSTSEL) 'Deletion of the first selected element Lastly, you can place several function calls on the same line, by separating them with a colon. Example: SETSCALE(FIRSTSEL,200,2000):SETSCALE(NEXTSEL(FIRSTSEL),200,200) @ENDNODE @NODE Variable "The variables" @TOC Macros The variables handled by AmiCAD can be of two types: @{b}numeric@{ub } or @{b}character strings@{ub }. The type is selected at the time of the assignment, it cannot then be changed, unless the variable is reinitialized, (see function @{"INIT" LINK INIT}). To assign a value to a variable it is enough to follow its name with the sign = and the value to be assigned to it. Examples: A = 1 B2 = "text string" A2 = "First"+B2 gives "First text string" The @{"character strings" LINK "Chaînes de caractères"} must be framed by quotation marks if they are constants. Numerical @{"valeurs" LINK Nombres} are limited to integers, (long), use ARexx to handle real numbers. The names of variables can include from 1 to 21 characters, they must begin with a letter, the following characters are able to be letters (accentuated or not), numbers or the character _. Examples of valid names: TEST TYPE_DONNÉE LINE1 Note that the program normally converts the names of functions and variables into capital letters during input, therefore there will not be a difference between two names like variable and VARIABLE, (or even Variable), however in an @{"ARexx script" LINK Script}, preferably use capital letters because the strings resulting from the interpreter are not converted, and inevitably the program will then differentiate between names written in lower case and/or upper case. Warning: The variables are not usable directly with ARexx, they are internal to the program AmiCAD and the ARexx interpreter has it's own variables. It is however possible to simply return a value of variable to the interpreter by giving it's name: Example: 'NAME_VARIABLE'; v=result The contents of variable NAME_VARIABLE is thus transferred in the variable ARexx v. It is often advantageous to use internal variables with AmiCAD because their processing is faster, in addition it can avoid the sending of certain messages between the interpreter and the program, which involves an enormous speed profit, (see scripts Zoom and Unzoom). @ENDNODE @NODE "Nombres" "Numeric Variables" @TOC Maths The numbers handled by AmiCAD are limited to integers. These are signed 32 bit long integers. The maximum value is 2^31-1 (2147483647) and the minimum value -2^31 (-2147483648). Use the capacities of the ARexx interpreter to handle numbers in floating point. @ENDNODE @NODE "Chaînes de caractères" "Character string variables" @TOC Variable The character strings can include an unspecified number of characters, (theoretically limited only by the memory size of your microcomputer), while starting with null strings which do not include any character. To define a character string, you must frame it's contents by two quotation marks. If this string includes itself one or more quotation marks, those must be doubled. Examples: "This is a character string" "" "It is a quotation mark "" !" @ENDNODE @NODE "Script" "Structure of ARexx scripts" ARexx scripts are ASCII files, conforming to a format allowing their interpretation by this software. They can include all the functions specific to ARexx and its libraries, (I refer you to their documentation for more precise details), like all the commands supported by the program AmiCAD, (a hundred, plus any functions defined by yourself). @{b}Location@{ub} These scripts must be located in the AmiCAD/ARexx directory. It is advised to name them with the AmiCAD extension, but it is not obligatory. @{b}Format@{ub} These scripts must always start with a remark included between the characters /* and */, as in language C. The AmiCAD commands must imperatively appear in upper case. They are the same ones as those which are used in @{"local mode" LINK Direct}, however their analysis by ARexx requires some precautions, thus these commands must imperatively be framed by apostrophes (') or quotation marks, in order to differentiate them from the internal functions within ARexx. @{b}Example@{ub} The following structure is recommended for these scripts: /* This file gives you an example of structure possible for a script called by AmiCAD */ options results /* essential to recover the results of the macros */ signal on error /* for the interception of errors */ signal on syntax /* your program must be located in this zone */ exit /* Processing of errors, interruption of the program */ syntax: error = RC 'MESSAGE("Syntax error"+CHR(10)+"in line 'SIGL'"+CHR(10)+"'errortext(error)'")' exit error: 'MESSAGE("Error in line 'SIGL'")' exit This example exists already ready in the ARexx directory, under the name @{b}New.AmiCAD@{ub }. @ENDNODE @NODE "Fonctions" "List of ARexx functions" @TOC "Macros" @{"ABS " LINK ABS} computes the absolute value of a number @{"ARC " LINK ARC} places an arc @{"ARRAYDIM" LINK ARRAYDIM} read an element of an array @{"ASC " LINK ASC} returns an ASCII code @{"ASK " LINK ASK} ask for a string from the user @{"ASKNUM " LINK ASKNUM} ask for a number from the user @{"ASKTEXT " LINK ASKTEXT} ask for a string from the user @{"BLINK " LINK BLINK} draws and clears an object @{"BOX " LINK BOX} draws a rectangle @{"CALL " LINK CALL} calls an ARexx script @{"CHR " LINK CHR} returns the character having the ASCII code specified @{"CLIPPATH" LINK CLIPPATH} specify the drawer containing clips @{"CLIPUNIT" LINK CLIPUNIT} specify the memory area used for the operations CUT, COPY, PASTE @{"CLOSE " LINK CLOSE} close the window @{"COL " LINK COL} number of the column where an object is located @{"CONVERT " LINK CONVERT} display alternate symbol for component @{"COORDS " LINK COORDS} returns the co-ordinates of an object @{"COPY " LINK COPY} copy one or more objects into memory @{"CURSMODE" LINK CURSMODE} chose an object placement mode @{"DATE " LINK DATE} returns the actual date @{"DEF " LINK DEF} defines a new function @{"DELARRAY" LINK DELARRAY} removes an array from memory @{"DELETE " LINK DELETE} removal of an object @{"DEVPINS " LINK DEVPINS} returns the number of connexions of a component @{"DIMARRAY" LINK DIMARRAY} set an array @{"DIMSHEET" LINK DIMSHEET} dimensions the window (SuperBitmap) @{"DRAW " LINK DRAW} trace a line @{"DRAWMODE" LINK DRAWMODE} selection of the type of layout @{"EDIT " LINK EDIT} call the edit requester @{"ELLIPSE " LINK ELLIPSE} traces an ellipse or a circle @{"ENDCOL " LINK ENDCOL} returns the abciss of an end of line @{"ENDLINE " LINK ENDLINE} returns the number of the line of an end of line @{"EXEC " LINK EXEC} interpret a string of characters @{"FILENAME" LINK FILENAME} name of complete file, (including path) @{"FILEPART" LINK FILEPART} name of file @{"FINDLAB " LINK FINDLAB} look for a label @{"FINDLINE" LINK FINDLINE} look for a line @{"FINDOBJ " LINK FINDOBJ} look for an object @{"FINDPART" LINK FINDPART} look for a component @{"FINDREF " LINK FINDREF} search for a component by its reference @{"FINDVAL " LINK FINDVAL} search for a component by its value @{"FOR " LINK FOR} processing of a loop @{"GETARRAY" LINK GETARRAY} returns the value of an array object @{"GETCOLOR" LINK GETCOLOR} returns the RGB levels of a given colour @{"GETDEVS " LINK GETDEVS } number of gates in a circuit @{"GETLABEL" LINK GETLABEL} read the label number of a line @{"GETLINE " LINK GETLINE} get a line @{"GETNET " LINK GETNET} read the line number associated with a label @{"GETPART " LINK GETPART } choose component to use @{"GETPOINT" LINK GETPOINT} get a point @{"GETPOS " LINK GETPOS} returns the placement mode (rotation, symmetry) @{"GETREF " LINK GETREF } read the reference of a component @{"GETVAL " LINK GETVAL } read the value or some type of component @{"GETZONE " LINK GETZONE} get a box @{"GROUP " LINK GROUP } creates a new group @{"HEIGHT " LINK HEIGHT } return the width of a object @{"HELP " LINK HELP } display an AmigaGuide help @{"HSCALE " LINK HSCALE } return the horizontal scale value of an object @{"IF " LINK IF } test @{"INIT " LINK INIT } initialization of variable @{"INPUT " LINK INPUT } place an input connector @{"JUNCTION" LINK JUNCTION } place a connection @{"LANGUAGE" LINK LANGUAGE} name of the locale @{"LEN " LINK LEN} length of the character string @{"LIBRARY " LINK LIBRARY} return the name of a component library @{"LIBSPATH" LINK LIBSPATH} specify drawer containing the symbol libraries @{"LINE " LINK LINE} number of the line where to locate a object @{"LINKLAB " LINK LINKLAB} links a label to a line @{"LINKREF " LINK LINKREF} assignment of a reference with a component @{"LINKVAL " LINK LINKVAL} assignment of a value with a component @{"LOAD " LINK LOAD} loading of a diagram @{"LOADCLIP" LINK LOADCLIP} load a clip @{"LOADLIB " LINK LOADLIB} load a symbol library @{"LOCK " LINK LOCK} lock user input @{"MAP " LINK MAP} program a keyboard sequence @{"MARK " LINK MARK} marking of one or more objects @{"MARKZONE" LINK MARKZONE} marking of elements in the specified zone @{"MENU " LINK MENU} executes the function associated to a menu @{"MESSAGE " LINK MESSAGE} display a message @{"MESURE " LINK MESURE} return the dimensions of a window @{"MODIF " LINK MODIF} test for modification @{"MOVE " LINK MOVE} move an object @{"NBSHEETS" LINK NBSHEETS} number of diagrams present in memory @{"NEWSHEET" LINK NEWSHEET} @{"NEXTSEL " LINK NEXTSEL} number of next element selected @{"OBJECTS " LINK OBJECTS} returns the number of objects @{"OPEN " LINK OPEN} open a diagram @{"OUTPUT " LINK OUTPUT} place an output connector @{"PARTNAME" LINK PARTNAME} read the name of a component @{"PASTE " LINK PASTE} paste the contents of the clipboard @{"PENWIDTH" LINK PENWIDTH} establish the width of features @{"PICKOBJ " LINK PICKOBJ} choose an object using the mouse @{"PINCOL " LINK PINCOL} returns the column placement of a pin @{"PINLINE " LINK PINLINE} returns the line placement of a pin @{"PINNUM " LINK PINNUM} returns a pin number @{"PRINT " LINK PRINT} print the diagram @{"PUTPART " LINK PUTPART} place a component @{"READCONV" LINK READCONV} read the type of symbol @{"READDEF " LINK READDEF} reads the definition of a programmed function @{"READDEV " LINK READDEV} read the number of a circuit or a component @{"READMAP " LINK READMAP} reads the definition of a programmed key sequence @{"READTEXT" LINK READTEXT} read the text associated with an object @{"REMLIB " LINK REMLIB} removal of a library @{"REQFILE " LINK REQFILE} choose a file @{"REQLIST " LINK REQLIST} choose an item among several @{"REQSHEET" LINK REQSHEET} choose a diagram @{"REQUEST " LINK REQUEST} display a message with a choice of YES/NO @{"RESET " LINK RESET} reinitialization of variables @{"REXXPORT" LINK REXXPORT} returns the name of the ARexx port @{"ROTATE " LINK ROTATE} rotate an object @{"SAVEIFF " LINK SAVEIFF} save in IFF format @{"SAVE " LINK SAVE} save a diagram @{"SAVEALL " LINK SAVEALL} saves the document in the Undo cache @{"SAVECLIP" LINK SAVECLIP} saves a clip @{"SAVECOPY" LINK SAVECOPY} specify the saving of backup files @{"SAVEICON" LINK SAVEICON} specify saving with an icon @{"SCREEN " LINK SCREEN} choose a screen mode @{"SCRMODE " LINK SCRMODE} return the screen mode @{"SECURITY" LINK SECURITY} determine the maximum number of loops before overflow @{"SELECT " LINK SELECT} choose an option from several @{"SETARRAY" LINK SETARRAY} gives a value to an array object @{"SETCOLOR" LINK SETCOLOR} set the screen colour @{"SETLABEL" LINK SETLABEL} place a label on a wire @{"SETDEV " LINK SETDEV} choose a circuit or gate of a component @{"SETFILL " LINK SETFILL} set the filling mode @{"SETGRID " LINK SETGRID} set the grid step @{"SETORTHO" LINK SETORTHO} set mode for drawing lines @{"SETPINS " LINK SETPINS} display pin numbers @{"SETREF " LINK SETREF} set the reference of an object @{"SETSCALE" LINK SETSCALE} set the horizontal and vertical scales @{"SETTEXT " LINK SETTEXT} set the text of an object @{"SETVAL " LINK SETVAL} set the value or the type of an object @{"SGN " LINK SGN} test the sign (+/-) of a number @{"SHEIGHT " LINK SHEIGHT} return the height of the screen @{"SNAPGRID" LINK SNAPGRID} sets the placement mode @{"STOBACK " LINK STOBACK} move screen to the back @{"STOFRONT" LINK STOFRONT} move screen to the front @{"STR " LINK STR} conversion of a number into a character string (decimal) @{"SWIDTH " LINK SWIDTH} return the width of the screen @{"SYMMETRY" LINK SYMMETRY} change the symmetry of an object @{"TEST " LINK TEST} test if an object is selected @{"TIME " LINK TIME} returns the actual hour @{"TITLE " LINK TITLE} set the title displayed in a STANDARD window @{"TOOLBAR " LINK TOOLBAR} load a toolbar @{"TRIANGLE" LINK TRIANGLE} places a triangle @{"TYPE " LINK TYPE} returns the type of an object @{"TXHEIGHT" LINK TXHEIGHT} returns the height occupied by a text @{"TXWIDTH " LINK TXWIDTH} returns the width occupied by a text @{"UNGROUP " LINK UNGROUP} deletes the links of a group @{"UNLINK " LINK UNLINK} deletes the links of a component @{"UNLOCK " LINK UNLOCK} cancels the locking user input @{"UNMAP " LINK UNMAP} deletes a programmed key sequence @{"UNMARK " LINK UNMARK} cancellation of the marking of an object @{"VAL " LINK VAL} conversion of a character string into a number @{"VERSION " LINK VERSION} returns the version number of AmiCAD @{"VSCALE " LINK VSCALE} returns the value of the vertical scale of an object @{"WHEIGHT " LINK WHEIGHT} returns the total height of the schematic @{"WHILE " LINK WHILE} loop so many times... @{"WIDTH " LINK WIDTH} returns the width of an object @{"WINDOW " LINK WINDOW} dimensions the diagram window @{"WRITE " LINK WRITE} place text @{"WTOBACK " LINK WTOBACK} moves the active window to the back @{"WTOFRONT" LINK WTOFRONT} moves the active window to the front @{"WWIDTH " LINK WWIDTH} returns the total width of the schematic @{"ZOOM " LINK ZOOM} sets the scale of the display @{"Theme Index" LINK "Index thématique"} @ENDNODE @NODE "Index thématique" "ARexx functional theme classification" @TOC Fonctions @{" " LINK "Traitement chaînes"} Processing of @{"Character strings" LINK "Chaînes de caractères"} @{" " LINK "Placement objets"} Place a new object on the diagram @{" " LINK "Gestion des objets"} Editing, modification of existing object @{" " LINK "Gestion blocs"} Function to implement on a block of objects @{" " LINK "Maths"} Mathematical functions @{" " LINK "Interactivité"} Interactive functions @{" " LINK "Gestion fenêtres"} Management of windows @{" " LINK "Gestion préférences"} Management of preferences @{" " LINK "Divers"} Various functions @ENDNODE @NODE "Traitement chaînes" "ARexx functions for processing of character strings" @TOC "Index thématique" @{"ASC" LINK ASC} returns an ASCII code @{"CHR" LINK CHR} return the character for the specified ASCII code @{"LEN" LINK LEN} length of character string @{"STR" LINK STR} conversion of a number to a character string (decimal) @{"VAL" LINK VAL} conversion of a character string to a number @ENDNODE @NODE "Placement objets" "ARexx functions to place objects" @TOC "Index thématique" @{"ARC " LINK ARC} places an arc @{"BOX " LINK BOX} places a box @{"CURSMODE" LINK CURSMODE} chose an object placement mode @{"DELETE " LINK DELETE} deletes an object @{"DRAW " LINK DRAW} places a line @{"DRAWMODE" LINK DRAWMODE} select the current line mode @{"ELLIPSE " LINK ELLIPSE} place an ellipse @{"GETDEVS " LINK GETDEVS} number of gates in a circuit @{"GETLINE " LINK GETLINE} get a line @{"GETPOINT" LINK GETPOINT} get a point @{"GETZONE " LINK GETZONE} get a box @{"GETPART " LINK GETPART} choose the current component @{"GROUP " LINK GROUP} creates a new group @{"INPUT " LINK INPUT} place an input connector @{"JUNCTION" LINK JUNCTION} place a junction @{"OUTPUT " LINK OUTPUT} place an output connector @{"PUTPART " LINK PUTPART} place a component @{"SETFILL " LINK SETFILL} set the filling mode @{"SETGRID " LINK SETGRID} set the grid step @{"SETORTHO" LINK SETORTHO} set mode for drawing lines @{"SNAPGRID" LINK SNAPGRID} sets the placement mode @{"TRIANGLE" LINK TRIANGLE} places a triangle @{"UNGROUP " LINK UNGROUP} deletes the links of a group @{"WRITE " LINK WRITE} places a text @ENDNODE @NODE "Gestion blocs" "ARexx functions to manage a block of objects" @TOC "Index thématique" @{"CLIPUNIT" LINK CLIPUNIT} specify the memory area used for the operation @{"COPY " LINK COPY} copy of one or more objects into memory @{"FIRSTSEL" LINK FIRSTSEL} return the number of first object selected @{"LOADCLIP" LINK LOADCLIP} loading of a clip @{"MARK " LINK MARK} marking of one or more objects @{"MARKZONE" LINK MARKZONE} marking of elements included in the specified zone @{"NEXTSEL " LINK NEXTSEL} number of next element selected @{"PASTE " LINK PASTE} joining of content of a buffer report @{"SAVEALL " LINK SAVEALL} saves the document in the Undo cache @{"SAVECLIP" LINK SAVECLIP} saves a clip @{"TEST " LINK TEST} test if an object is selected @{"UNMARK " LINK UNMARK} unmark marked object(s) @ENDNODE @NODE "Gestion des objets" "ARexx functions for managing objects" @TOC "Index thématique" @{"BLINK " LINK BLINK} draws and clears an object @{"CLIPPATH" LINK CLIPPATH} specify the drawer containing clips @{"COL " LINK COL} number of the column where an object is located @{"CONVERT " LINK CONVERT} display alternate symbol for component @{"COORDS " LINK COORDS} returns the co-ordinates of an object @{"DELETE " LINK DELETE} removal of an object @{"DEVPINS " LINK DEVPINS} returns the number of connexions of a component @{"EDIT " LINK EDIT} call the edit requester @{"ENDCOL " LINK ENDCOL} returns the abciss of an end of line @{"ENDLINE " LINK ENDLINE} returns the number of the line of an end of line @{"FINDLAB " LINK FINDLAB} look for a label @{"FINDLINE" LINK FINDLINE} look for a line @{"FINDOBJ " LINK FINDOBJ} look for an object @{"FINDPART" LINK FINDPART} look for a component @{"FINDREF " LINK FINDREF} search for a component by it's reference @{"FINDVAL " LINK FINDVAL} search of a component by it's value @{"GETLABEL" LINK GETLABEL} read the label number of a line @{"GETNET " LINK GETNET} read the line number associated with a label @{"GETPOS " LINK GETPOS} returns the placement mode (rotation, symmetry) @{"GETREF " LINK GETREF} read the reference of a component @{"GETVAL " LINK GETVAL} read the value or type of component @{"GROUP " LINK GROUP} creates a new group @{"HEIGHT " LINK HEIGHT} height of an object @{"HSCALE " LINK HSCALE} return the value of scale horizontal of a object @{"LIBRARY " LINK LIBRARY} return the name of a component library @{"LIBSPATH" LINK LIBSPATH} specify the drawer containing the symbol libraries @{"LINE " LINK LINE} number of the line where an object is located @{"LINKLAB " LINK LINKLAB} links a label to a line @{"LINKREF " LINK LINKREF} assignment of a reference to a component @{"LINKVAL " LINK LINKVAL} assignment of a value to a component @{"LOADLIB " LINK LOADLIB} load a symbol library @{"MOVE " LINK MOVE} move an object @{"OBJECTS " LINK OBJECTS} returns the number of objects @{"PARTNAME" LINK PARTNAME} read the name of a component @{"PENWIDTH" LINK PENWIDTH} establishes the width of features @{"PINCOL " LINK PINCOL} returns the column placement of a pin @{"PINLINE " LINK PINLINE} returns the line placement of a pin @{"PINNUM " LINK PINNUM} returns a pin number @{"READCONV" LINK READCONV} read the type of symbol @{"READDEV " LINK READDEV} read the number of circuits of a component @{"READTEXT" LINK READTEXT} read a text associated with an object @{"REMLIB " LINK REMLIB} removal of a library @{"ROTATE " LINK ROTATE} rotation of an object @{"SETLABEL" LINK SETLABEL} place a label on a wire @{"SETDEV " LINK SETDEV} specify the circuit or a gate of a component @{"SETFILL " LINK SETFILL} set the filling mode @{"SETORTHO" LINK SETORTHO} set mode for drawing lines @{"SETPINS " LINK SETPINS} display pin numbers @{"SETREF " LINK SETREF} fixes the reference of a horizontal object @{"SETSCALE" LINK SETSCALE} sets the horizontal and vertical scales @{"SETTEXT " LINK SETTEXT} fixes the text of an object @{"SETVAL " LINK SETVAL} fixes the value or the type of an object @{"SYMMETRY" LINK SYMMETRY} symmetry of a STANDARD object @{"TYPE " LINK TYPE} returns the type of an object @{"TXHEIGHT" LINK TXHEIGHT} returns the height occupied by a text @{"TXWIDTH " LINK TXWIDTH} returns the width occupied by a text @{"UNGROUP " LINK UNGROUP} deletes the links of a group @{"UNLINK " LINK UNLINK} deletes the links of a component @{"VSCALE " LINK VSCALE} returns the value of the vertical scale of an object @{"WIDTH " LINK WIDTH} returns the width of an object @ENDNODE @NODE "Gestion préférences" "ARexx functions to manage preferences" @TOC "Index thématique" @{"FONTNAME" LINK FONTNAME} name of character font to use @{"FONTSIZE" LINK FONTSIZE} size of character font to use @{"GETCOLOR" LINK GETCOLOR} returns the RGB levels of a given colour @{"LANGUAGE" LINK LANGUAGE} name of the locale @{"SAVECOPY" LINK SAVECOPY} choose to save backup copies @{"SAVEICON" LINK SAVEICON} choose to create icons for saved files @{"SCREEN " LINK SCREEN} choose screen mode @{"SCRMODE " LINK SCRMODE} return the screen mode @{"SETCOLOR" LINK SETCOLOR} set the palette @{"SETGRID " LINK SETGRID} set the grid size @{"SHEIGHT " LINK SHEIGHT} return the height of the screen @{"SWIDTH " LINK SWIDTH} return the width of the screen @{"TOOLBAR " LINK TOOLBAR} load a toolbar @ENDNODE @NODE "Maths" "ARexx calculation functions" @TOC "Index thématique" @{"ABS " LINK ABS} computes the absolute value of a number @{"FOR " LINK FOR} processing of a loop @{"IF " LINK IF} test @{"INIT " LINK INIT} initialization of variable @{"RESET " LINK RESET} reinitialization of variables @{"SECURITY" LINK SECURITY} number of maximum loops before overflow @{"SGN " LINK SGN} test the sign of a number @{"STR " LINK STR} conversion of a number into a character string @{"VAL " LINK VAL} conversion of a character string into a number @{"WHILE " LINK WHILE} loop so many times... @ENDNODE @NODE "Interactivité" "Interactive ARexx functions" @TOC "Index thématique" @{"ASK " LINK ASK} ask for a string from the user @{"ASKNUM " LINK ASKNUM} ask for a number from the user @{"ASKTEXT " LINK ASKTEXT} ask for a string from the user @{"CURSMODE" LINK CURSMODE} chose an object placement mode @{"GETLINE " LINK GETLINE} get a line @{"GETPOINT" LINK GETPOINT} get a point @{"GETZONE " LINK GETZONE} get a box @{"LOCK " LINK LOCK} lock user input @{"MESSAGE " LINK MESSAGE} display a message @{"PICKOBJ " LINK PICKOBJ} choose an object using the mouse @{"REQFILE " LINK REQFILE} choose a file @{"REQLIST " LINK REQLIST} choose an item among several @{"REQUEST " LINK REQUEST} display a message with a choice, YES/NO @{"SELECT " LINK SELECT} choose an option among several @{"UNLOCK " LINK UNLOCK} cancels the locking of user input @ENDNODE @NODE "Divers" "Various ARexx functions" @TOC "Index thématique" @{"ARRAYDIM" LINK ARRAYDIM} read an element of an array @{"CALL " LINK CALL} calls an ARexx script @{"DATE " LINK DATE} returns the actual date @{"DEF " LINK DEF} defines a new function @{"DIMARRAY" LINK DIMARRAY} set an array @{"DELARRAY" LINK DELARRAY} removes an array from memory @{"EXEC " LINK EXEC} interpret a string of characters @{"FINDLAB " LINK FINDLAB} look for a label @{"FINDLINE" LINK FINDLINE} look for a line @{"FINDOBJ" LINK FINDOBJ} look for an objec @{"FINDPART" LINK FINDPART} look for a component @{"GETARRAY" LINK GETARRAY} returns the value of an array object @{"HELP " LINK HELP} displays an AmigaGuide help @{"MAP " LINK MAP} programs a keyboard sequence @{"MENU " LINK MENU} executes the function associated to a menu @{"READDEF " LINK READDEF} reads the definition of a programmed function @{"READMAP " LINK READMAP} reads the definition of a programmed key sequence @{"SETARRAY" LINK SETARRAY} gives a value to an array object @{"TIME " LINK TIME} returns the actual time @{"UNMAP " LINK UNMAP} deletes a programmed key sequence @{"VERSION " LINK VERSION} returns the version number of AmiCAD @ENDNODE @NODE "Gestion fenêtres" "ARexx functions for window management" @TOC "Index thématique" @{"CLOSE " LINK CLOSE} close the specified window @{"DIMSHEET" LINK DIMSHEET} dimension the window (SuperBitmap) @{"FILENAME" LINK FILENAME} name of file complete with path @{"FILEPART" LINK FILEPART} name of file @{"FONTNAME" LINK FONTNAME} name of character font used @{"FONTSIZE" LINK FONTSIZE} size of character font used @{"LOAD " LINK LOAD} load a diagram @{"MESURE " LINK MESURE} return a dimension of window @{"MODIF " LINK MODIF} test for modification @{"NBSHEETS" LINK NBSHEETS} number of diagrams present in memory @{"NEWSHEET" LINK NEWSHEET} open a new window @{"OPEN " LINK OPEN} open a diagram @{"PRINT " LINK PRINT} print a diagram @{"REQSHEET" LINK REQSHEET} choose a diagram @{"REXXPORT" LINK REXXPORT} returns the name of the ARexx port @{"SAVEIFF " LINK SAVEIFF} save in IFF format @{"SAVE " LINK SAVE} save a diagram @{"SAVEALL " LINK SAVEALL} saves the document in the Undo cache @{"SETCOLOR" LINK SETCOLOR} specify screen palette @{"SETGRID " LINK SETGRID} specify grid step @{"STOBACK " LINK STOBACK} move the screen to the background @{"STOFRONT" LINK STOFRONT} move the screen to the foreground @{"TITLE " LINK TITLE} specify the title displayed in a window @{"TOOLBAR " LINK TOOLBAR} load a toolbar @{"WHEIGHT " LINK WHEIGHT} returns the total height of a window @{"WINDOW " LINK WINDOW} dimensions the diagram window @{"WTOBACK " LINK WTOBACK} moves the active window to the background @{"WTOFRONT" LINK WTOFRONT} moves the active window to the foreground @{"WWIDTH " LINK WWIDTH} returns the total width of the worksheet @{"ZOOM " LINK ZOOM} sets the scale of the display @ENDNODE @NODE DEF "ARexx function DEF" @TOC Fonctions You can define an unspecified number of functions using the internal functions like any operator. One of these functions can even call upon another function previously defined. The arguments can be of an unspecified type, it must simply correspond to the types used by the functions which will be called or be compatible with the operators used. There cannot be more than one declaration in the same line. The form of these definitions is as follows: DEF name_function(argument...) = definition of the operations. Key word DEF must imperatively begin the definition, without any preliminary space. The name of the functions can include/understand from 1 to 13 alphanumerics, including the accented letters and underlines (_). The first character must however always be a letter. The internal functions cannot be redefined. The number of the arguments is limited to 15 maximum. This number is fixed for a given definition, (you cannot declare a function having a variable number of arguments). There must be at least one argument in the definition, but this one can not be used. The arguments must of course have distinct names. Examples: DEF EXPAND(object) = SETSCALE(OBJECT, HSCALE(OBJECT)+1,VSCALE(OBJECT)+1) The call of the function will be then made as for all other function: EXPAND(FIRSTSEL) for example. The redefinition of a function having already been defined is possible, the new definition then replaces the old one. This can be useful when you try to define a complex function. See also : @{"READDEF" LINK READDEF} @ENDNODE @NODE ABS "ARexx function ABS" @TOC Maths @{b}ABS(number)@{ub} This function returns the absolute value of the specified number. This number can be a @{"variable" LINK Variable}. Examples: ABS(-8) returns 8 ABS(4) returns 4 ABS(N) returns the absolute value of the number in the N variable Note: Numbers can only be long integers. @ENDNODE @NODE ARC "ARexx function ARC" @TOC "Placement objets" @{b}ARC(x,y,horizontal_radius,vertical_radius,angle_begin,angle_end)@{ub} Draws an arc. The center is specified by the two first arguments x and y. The angle_begin must be lower than the angle_end value. Their units are degrees (negative values allowed). If the operation is OK the function returns the number of the new object. Examples: ARC(100,100,25,25,0,90):ARC(100,100,25,25,90,180) draws half a circle can be done with only one instruction: ARC(100,100,25,25,0,180) or ARC(100,100,25,25,-180,0) (complementary) To draw a rounded box (x0,y0,x1,y1): (all these lines have to be placed on the same line) DEF ROUNDED_BOX(x0,y0,x1,y1)= ARC(x0+10,y0+10,10,10,-90,0):DRAW(x0+10,y0,x1-10,y0):ARC(x1-10,y0+10,10,10,0,90): DRAW(x1,y0+10,x1,y1-10):ARC(x1-10,y1-10,10,10,90,180):DRAW(x1-10,y1,x0+10,y1): ARC(x0+10,y1-10,10,10,180,270):DRAW(x0,y1-10,x0,y0+10) See also: menu @{"Drawing/Place arc" LINK "Place arc"}, @{"ELLIPSE" LINK ELLIPSE} @ENDNODE @NODE ARRAYDIM "ARexx function ARRAYDIM" @TOC Divers @{b}ARRAYDIM(arrayname)@{ub} This function returns the number of elements of an array, if it exists. Else 0 is returned. So you can now if an array has been declared at the beginning of a script. See also : @{"DIMARRAY" LINK DIMARRAY}, @{"DELARRAY" LINK DELARRAY}, @{"GETARRAY" LINK GETARRAY}, @{"SETARRAY" LINK SETARRAY} @ENDNODE @NODE ASC "ARexx function ASC" @TOC Fonctions @{b}ASC("text",position)@{ub} This function returns the ASCII code of the character in the text, the position of this character is given by the second argument, this argument must be set between 1 (first char) and the length of the text. Examples: ASC("element",1) returns 101 (ASCII code of char e) ASC(TEXT,LEN(TEXT)) returns the code of the last char in the @{"variable" LINK Variable} TEXT. See also: @{"CHR" LINK CHR} @ENDNODE @NODE ASK "ARexx function ASK" @TOC Interactivité This function has been suppressed in version 1.6 Use one of the @{"ASKNUM" LINK ASKNUM} or @{"ASKTEXT" LINK ASKTEXT} functions instead. It can be defined using the following definition: DEF ASK(T)=ASKTEXT(T,"") @ENDNODE @NODE ASKNUM "ARexx function ASKNUM" @TOC Interactivité @{B}ASKNUM("title",number)@{UB} @{I}Version 1.6@{UI} Open a requester to get a number. The second argument is used for the default content of the box. If the user clicks on Cancel, an empty string is returned, in the other case, the number in the box is returned. @{I}See also :@{UI} @{"ASKTEXT" LINK ASKTEXT}. @ENDNODE @NODE ASKTEXT "ARexx function ASKTEXT" @TOC Interactivité @{B}ASKTEXT("title","text")@{UB} @{I}Version 1.6@{UI} Displays a requester to get a string. The second parameter is used for the default content of the box. A null string is returned if the user clicks on Cancel. @{I}See also :@{UI} @{"ASKNUM" LINK ASKNUM}. @{i}Example:@{ui} ASKTEXT("Enter the first"+CHR(10)+"word then press"+CHR(10)+"the ENTER key","") @ENDNODE @NODE BLINK "ARexx function BLINK" @TOC "Gestion des objets" @{b}BLINK(object_number)@{ub} The specified object is cleared and drawn three times. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. @ENDNODE @NODE BOX "ARexx function BOX" @TOC "Placement objets" @{b}BOX(x1, y1, x2, y2)@{ub} Place a box on the document, using the specified coordinates for each of the opposite corners. The width of the lines depends on the current line width (see @{"DRAWMODE" LINK DRAWMODE}). If the placement is OK, the function returns the number of the new object, else 0. See also: @{"DRAW" LINK DRAW}. @ENDNODE @NODE CALL "ARexx function CALL" @TOC Divers @{b}CALL("script name", argument1, argument2...)@{ub} Calls an ARexx script. The name of the script can be specified without any path and extension, ".AmiCAD", if the script is in the ARexx drawer of AmiCAD. This function can be used to call a script with some arguments in a @{"macro-command" LINK Direct}, (ALT-Fx), or direct mode. You can use 0 to 15 arguments, (@{"numbers" LINK Nombres} or @{"character strings" LINK "Chaînes de caractères"}). The execution of the script is asynchronous. The returned value is the script name... Examples: 'CALL("EditScript","Zoom")' 'CALL("multiply",1.5,X)' @ENDNODE @NODE CHR "ARexx function CHR" @TOC Fonctions @{b}CHR(code)@{ub} Return the character having the specified ASCII code. Used to obtain a linefeed (CHR(10)) or a special character not present on the keyboard. The code can vary from 1 to 255 maximum. This function can also be used to write special characters, which do not form part of the character set of the Amiga. Thus the following characters are usable: - 128: symbol of amplification (triangle pointed on the right) - 129: open collecting symbol - 130: symbol of OR (greater than or equal) - 131: arrow directed on the right - 133: symbol used for the active inputs (greater than) - 134: symbol of hysteresis - 135: symbol "tri-state" (high impedance) - 136: symbol of an impulse - 137: arrow directed on the left - 138: symbol describing an analog signal - 139: letter corresponding to the sign "ohm" (for the value of resistance) - 140: letter "alpha" (for potentiometers) - 141: letter TAU (time-constants) Test these codes using the macro: WRITE(CHR(140), 100, 100) You can add one of these characters (or any other to a character string by writing the following: "Arrow on the right: "+CHR(131) See also: @{"ASC" LINK ASC} @ENDNODE @NODE CLIPPATH "ARexx function CLIPPATH" @TOC "Gestion blocs" @{b}CLIPPATH("path")@{ub} Determine the directory where the clips are located. This function makes it possible to modify the path used for @{"CLIPS" LINK CLIPS}. The function returns the previous path used. If the specified path is a null string, CLIPPATH(""), there is no modification of the path used, only the current path is returned. Example: CLIPPATH("Work:AmiCAD/Clips") @ENDNODE @NODE CLIPUNIT "ARexx function CLIPUNIT" @TOC "Gestion blocs" @{b}CLIPUNIT(unit)@{ub} This function sets the current memory unit used for the Copy/Paste functions. The unit number can be from 1 to 10. Unit 5 is often used in ARexx scripts, if necessary. The value returned by this function is the number of the unit that was active BEFORE this call. If you want to know it without changing it, give a negative or null argument. Warning: if the returned value is null, the function couldn't get access to the clip. This can be possible if another task is using this clip in the same time (Version 2.05). Example of script: 'CLIPUNIT(2)' select a new unit (number 2) clip=RESULT keeps the old active unit in variable clip ... 'CLIPUNIT('clip')' select again the old clip unit See also: @{"COPY" LINK COPY}, @{"PASTE" LINK PASTE}. @ENDNODE @NODE CLOSE "ARexx function CLOSE" @TOC "Gestion fenêtres" @{b}CLOSE(window)@{ub} This function causes the closing of the current window (argument positive or null) or of all the windows if argument is -1. There is no returned value. If a window was modified all the changes will be lost, use the @{"MODIF" LINK MODIF} function to know if saving is needed before closing the window. To hide a window, without losing its text in memory, use the MENU("Hide"), to reduce it to its minimal size, use the MENU("Iconify"). See also: @{"OPEN" LINK OPEN}, @{"LOAD" LINK LOAD}. @ENDNODE @NODE COL "ARexx function COL" @TOC "Gestion des objets" @{b}COL(object_number)@{ub} This function makes it possible to know the number of the column where the specified object is located. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. If the argument is null, the left edge of the current selection is returned (or -1 if there is no selection). See also: @{"ENDCOL" LINK ENDCOL}, @{"LINE" LINK LINE}, @{"COORDS" LINK COORDS}. @ENDNODE @NODE CONVERT "ARexx function CONVERT" @TOC "Gestion des objets" @{b}CONVERT(object_number, 0/1/-1)@{ub} The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. If it is null, the action will confirm the current mode of placement of components, (as by using the menu Drawing/@{"Place Component" LINK "Place component"} for example). The returned value will be equal to 0 if the current mode of placement is the "normal" mode, if the "alternate" mode were valid the returned value is different from 0. This function makes it possible to choose the type of symbol for a component. According to the value of the second argument, the action will be the following one: - equal to 0: it is the normal symbol which will be used, - equal to 1: it is the second symbol which will be used, - equal to -1: symbol is changed. The returned value is then equal to 0 or 1 if the selected object is a component, if not it is -1. See also: menu Drawing/@{"Alternate symbol" LINK "Alternate symbol"}, @{"READCONV" LINK READCONV} @ENDNODE @NODE COORDS "ARexx function COORDS" @TOC "Gestion des objets" @{b}COORDS(object_number)@{ub} This function returns the co-ordinates of the object specified in the form of a character string, separated by commas. If the object is a line the co-ordinates are the form x0, y0, x1, y1. For a triangle the form is x0,y0,x1,y1,x2,y2. For an arc the form is x,y,horizontal_radius,vertical_radius,begin_angle,end_angle. For an ellipse the form is x,y,horizontal_radius,vertical. They are the form x,y for all other objects. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. @{i}Example of use:@{ui} 'COORDS('line')'; coord=result /* find the different coordinates */ PARSE VAR coord x0 ',' y0 ',' x1 ',' y1 @{i}See also:@{ui} @{"COL" LINK COL}, @{"LINE" LINK LINE}, @{"ENDCOL" LINK ENDCOL}, @{"ENDLINE" LINK ENDLINE}. @ENDNODE @NODE COPY "ARexx function COPY" @TOC "Gestion blocs" @{b}COPY(clip)@{ub} This function makes it possible to recopy the objects selected in the specified memory area. The number of the clip can vary from 1 to 10. Use the function @{"PASTE" LINK PASTE} to place the objects or choose the default unit, (@{"CLIPUNIT" LINK CLIPUNIT}), then use the menu @{"Edition/Paste from clip" LINK "Paste from clip"}. The returned value is equal to 1 if all occurs normally. @ENDNODE @NODE CURSMODE "ARexx function CURSMODE" @TOC Interactivité @{B}CURSMODE(type)@{UB} @{I}Version 2.00@{UI} This function makes it possible to place the cursor in a specified mode: - if type is equal to @{B}0@{UB}: @{B}clip@{UB} placement mode, - if type is equal to @{B}1@{UB}: @{B}component@{UB} placement mode, - if type is equal to @{B}2@{UB}: @{B}wires@{UB} placement mode, - if type is equal to @{B}3@{UB}: @{B}arcs@{UB} placement mode, - if type is equal to @{B}4@{UB}: @{B}text@{UB} placement mode, - if type is equal to @{B}7@{UB}: @{B}junctions@{UB} placement mode, - if type is equal to @{B}10@{UB}: @{B}ellipse@{UB} placement mode, - if type is equal to @{B}22@{UB}: @{B}box@{UB} placement mode, - if type is equal to @{B}26@{UB}: @{B}triangle@{UB} placement mode. Any other value clears the current mode. The returned value is the one corresponding to the previous mode (before applying this function). To choose a text or connector placement mode, use one of the functions @{"WRITE" LINK WRITE}, @{"INPUT" LINK INPUT} or @{"OUTPUT" LINK OUTPUT}. @ENDNODE @NODE DATE "ARexx function DATE" @TOC Divers @{b}DATE(day)@{ub} Return the current date. If the argument day is not zero, the day of the week is included. @{i}Examples:@{ui} DATE(0) returns 18-Oct-97 DATE(1) returns Saturday 18-Oct-97 @{i}See also:@{ui} @{"TIME" LINK TIME}. @ENDNODE @NODE DELARRAY "ARexx function DELARRAY" @TOC Divers @{b}DELARRAY(arrayname)@{ub} This function frees the memory allocated for an array. If the array doesn't exists no error occurs, but a 0 is returned. The number of objects in the array is returned. See also: @{"ARRAYDIM" LINK ARRAYDIM}, @{"DIMARRAY" LINK DIMARRAY}, @{"GETARRAY" LINK GETARRAY}, @{"SETARRAY" LINK SETARRAY} @ENDNODE @NODE DELETE "ARexx function DELETE" @TOC "Gestion des objets" @{b}DELETE(object_number)@{ub} Remove the object whose number is specified. Return the number of remaining objects. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. If the argument is null, all the selected objects are deleted, if the argument is -1, ALL the objects on the document are deleted (Version 2.01). Warning: This function can modify the numbers of the remaining objects. @ENDNODE @NODE DEVPINS "ARexx function DEVPINS" @TOC Gestion des objets @{B}DEVPINS(object_number)@{UB} This function is used to create a netlist. The value of the argument must be set between 1 and @{"OBJECTS" LINK OBJECTS}. The specified object must be a component, the function then returns the number of connexions of this component, else an error message is displayed. @{I}See also :@{UI} @{"PINCOL" LINK PINCOL}, @{"PINLINE" LINK PINLINE}. @ENDNODE @NODE DIMARRAY "ARexx function DIMARRAY" @TOC Divers @{b}DIMARRAY(arrayname,number_of_objects)@{ub} This function allocates some memory to handle an array. Data placed in arrays can be integers or strings, the first affectation sets the variable type, like for variables. The number of objects can be set between 1 and 2^24 (16777216). See also: @{"ARRAYDIM" LINK ARRAYDIM}, @{"GETARRAY" LINK GETARRAY}, @{"DELARRAY" LINK DELARRAY}, @{"SETARRAY" LINK SETARRAY} @ENDNODE @NODE DIMSHEET "ARexx function DIMSHEET" @TOC "Gestion fenêtres" @{b}DIMSHEET(width,height)@{ub} This function allows you to change the dimensions of the current worksheet. These dimensions are given in pixels. Use menu @{"Project/Informations" LINK Informations} to find out the dimensions of the worksheet. The limits of size available for the window depend, of course, on the quantity of CHIP memory installed on your system. Dimensions of 1100 by 700 are suitable for a system equipped with 2MB CHIP. Returned value: 1 if the operation succeeded, 0 if it didn't Warning: No control is made on the values passed in arguments. See also: menu @{"Preferences/Dimensions document" LINK "Sheet size"}, functions @{"WWIDTH" LINK WWIDTH}, @{"WHEIGHT" LINK WHEIGHT} @ENDNODE @NODE DRAW "ARexx function DRAW" @TOC "Placement objets" @{b}DRAW(x0, y0, x1, y1)@{ub} Draw a line using the specified coordinates. The line width is dependent on the current mode (see @{"DRAWMODE" LINK DRAWMODE}). If the line can be drawn, the function returns the object number that has been placed, if there was an error 0 is returned. @{I}See also :@{UI} @{"BOX" LINK BOX}, @{"COORDS" LINK COORDS}. @ENDNODE @NODE DRAWMODE "ARexx function DRAWMODE" @TOC "Placement objets" @{b}DRAWMODE(line_type)@{ub} Determines which will be the type of line which will be traced (see @{"DRAW" LINK DRAW}). If line_type is equal to 0: they will be dotted lines, equal to 1: they will be "normal" lines (connections), equal to 2: they will be double lines, equal to 3: they will be buses. If type_line is lower than 0 and higher than -256, lines of a personalized width will be traced, with a width equal to the absolute value of that which was specified (v1.1). The Drawing menu is updated according to the selected type. This function returns the type of line which was in force BEFORE the call of the function. @ENDNODE @NODE EDIT "ARexx function EDIT" @TOC "Gestion des objets" @{b}EDIT(object_number)@{ub} This function calls a requester making it possible to edit/modify an element of the diagram. It has the same effect as a double clicking on an object using the left button of the mouse. No value is returned. The value of the argument must be set between 1 and @{"OBJECTS" LINK OBJECTS}. This function is useful when mapped to a key combination on the keyboard. Example: MAP("alt-e","EDIT(FIRSTSEL)") You can then select an object and use the combination of ALT-e keys on the keyboard to call the edit requester on the first selected element. @ENDNODE @NODE ELLIPSE "ARexx function ELLIPSE" @TOC "Placement objets" @{b}ELLIPSE(x, y, horizontal_radius, vertical_radius)@{ub} Place an ellipse, the center is given by the two first args, x and y, the radius by the others. If the placement is OK this function returns the number of the new object, else 0. The width of the line depends on the current line width (see @{"DRAWMODE" LINK DRAWMODE}). To draw a circle you can use the macro: DEF CIRCLE(x,y,r)=ELLIPSE(x,y,r,r) If the x and y coordinates are -1, the dimensions of the radius are used to set the current radius of the ellipses placement mode. Use the @{"COORDS" LINK COORDS} function to get the ellipses datas. See also: @{"ARC" LINK ARC} @ENDNODE @NODE ENDCOL "ARexx function ENDCOL" @TOC Gestion des objets @{B}ENDCOL(object_number)@{UB} This function returns the abciss of the point defining the end of a line (dashed line or any width). If the object is another type (component, junction or other) the returned value has no signification. The objet number must be set between 1 and @{"OBJECTS" LINK OBJECTS}. @{I}See also :@{UI} @{"COL" LINK COL}, @{"LINE" LINK LINE}, @{"ENDLINE" LINK ENDLINE}, @{"COORDS" LINK COORDS}. @ENDNODE @NODE ENDLINE "Fonction ARexx ENDLINE" @TOC Gestion des objets @{B}ENDLINE(object_number)@{UB} This function returns the number of the line where the specified object (a line, any width) is ending. If the object is not a line the returned value is no significant. The objet number must be set between 1 and @{"OBJECTS" LINK OBJECTS}. @{I}See also :@{UI} @{"COL" LINK COL}, @{"LINE" LINK LINE}, @{"ENDCOL" LINK ENDCOL}, @{"COORDS" LINK COORDS}. @ENDNODE @NODE EXEC "ARexx function EXEC" @TOC Divers @{b}EXEC("character string")@{ub} Request the interpretation and execution of the character string passed in the argument, as if it were about a line of command. The result depends naturally on the contents of the string passed in the argument. Example: EXEC(READTEXT(OBJECT)) interprets the line of text associated with the object specified EXEC(READMAP("CTRL-)") carries out the sequence associated with the combination with keys CTRL -) EXEC(READMAP("F5")) executes the associated sequence for key F5. Using a function in the @{"startup" LINK STARTUP} file can be usefull: DEF EXECKEY(X)=EXEC(READMAP(X)) you can there write : EXECKEY("F5") or EXECKEY("CTRL-)") @ENDNODE @NODE FILENAME "ARexx function FILENAME" @TOC "Gestion fenêtres" @{b}FILENAME(name)@{ub} The current window is renamed with the file name given in the argument. If it's an empty string ("") no renaming is performed, it only returns the current name of the window with complete path. See also: @{"FILEPART" LINK FILEPART} @ENDNODE @NODE FILEPART "ARexx function FILEPART" @TOC "Gestion fenêtres" @{b}FILEPART("name")@{ub} Renames the current window, preserving the path. If a null string ("") is passed in the argument, this function returns the name of the current window, without the complete path. Example: Let us suppose that the file running is "RAM:sources/Scheme" function FILEPART("") would return Scheme, whereas the function FILEPART("New scheme") would rename the file to "RAM:sources/New scheme". See also: @{"FILENAME" LINK FILENAME} @ENDNODE @NODE FINDLAB "ARexx function FINDLAB" @TOC Gestion des objets @{b}FINDLAB(first_object,"Label")@{ub} This function searchs for a wire with the specified label. The first argument defines where the search begins. It must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. The returned value is the object number that was found (if any) or 0. The search is no case sensitive. You can include some AmigaDOS jokers (#?) in the label string. @{i}Note:@{ui} it's the number of the wire object that is returned, not the label one (use @{"GETLABEL" LINK GETLABEL} to have this one). @{I}Examples :@{UI} FINDLAB(1,"0") Return the number of the first wire with label 0 FINDLAB(1,"Lab#?") Retun the number of the first label beginning with letters 'Lab' @ENDNODE @NODE FINDLINE "ARexx function FINDLINE" @TOC Gestion des objets @{B}FINDLINE(first_object,x,y)@{UB} @{I}Version 1.4@{UI} This function searchs for a line at the specified coordinates. It is used to build netlists. The first argument defines where the search begins. It must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. The returned value is the object number that was found (if any) or 0. If the founded line is beginning or ending exactly at the specified coordinates, the result is in negative form. Warning: vertical or horizontal lines only are checked. Other lines are only checked on their extremities. Only lines with a width of 1 are checked (wires). To draw frames or anything else than a circuitry, use the @{"special lines" LINK Any width}". @{I}Example :@{UI} to know if a line is present on coordinates x0,y0 'ABS(FINDLINE(1,'x0','y0'))'; l=result if l>0 then line_is_present @{I}See also :@{UI} @{"FINDOBJ" LINK FINDOBJ} @ENDNODE @NODE FINDOBJ "ARexx function FINDOBJ" @TOC "Gestion des objets" @{b}FINDOBJ(first_object,type,x,y)@{ub} @{I}Version 1.4@{UI} This function searchs for an object at the specified coordinates. The first argument defines where the search begins. It must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. If this value is set to 1, all the objects on the current document will be scanned. The second argument gives the type of object that is searched (as returned by the @{b}TYPE@{ub} function). If it is 0, the first object found will be returned. The coordinates must match an extremity for lines, or the point where the cursor was at the moment the object was placed. For the components it is the point where the cursor was when it was placed (upper left corner). If one of the coordinates is negative, it is not taken in account, if the two are negatives, the object will be found elsewhere it is placed. The returned value is the object number of the object that was found, else 0. @{I}Examples :@{UI} FINDOBJ(1,1,-1,-1) returns the number of the first component. FINDOBJ(1,2,100,200) returns the number of a line that have an extremity at 100,200, if there is on there. FINDOBJ(1,7,50,-1) renvoie le number of the first junction place on column 50. @{I}See also :@{UI} @{"FINDLINE" LINK FINDLINE} @ENDNODE @NODE FINDPART "ARexx function FINDPART" @TOC "Gestion des objets" @{b}FINDPART(first_object,"component")@{ub} Begin the search for the component whose name is specified on the current document. This name corresponds in the name of the symbol, "RESISTANCE" for example for a resistance. The first argument is used to begin search after an object already found. This argument must take a value ranging between 1 (search will be carried out on all the objects of the diagram) and @{"OBJECTS" LINK OBJECTS}. Search is carried out without taking into account the case of letters, i.e. upper case and lower case are not differentiated. In addition, you can include "wildcards" (or general characters) in the required string, (see AmigaDOS documentation for the various possibilities). The returned value is equal to the number of the object which was found, or to 0 if no object corresponds. @{i}Examples:@{ui} 'FINDPART(1,"RESISTANCE")'; object=result 'FINDPART(1,"(Res|Cond)#?")' @ENDNODE @NODE FINDREF "ARexx function FINDREF" @TOC "Gestion des objets" @{b}FINDREF(first_object, "reference")@{ub} Begin the search for the component whose reference is specified, R3 for example for a resistance or IC9 for an integrated circuit. The first argument is used to begin the search after an object already found. This argument must take a value ranging between 1 (search will be carried out on all the objects of the diagram) and @{"OBJECTS" LINK OBJECTS}. Search is carried out without taking into account the case of letters, i.e. upper case and lower case are not differentiated. In addition, you can include "wildcards" (or general characters) in the required string, (see AmigaDOS documentation for the various possibilities). The returned value is equal to the number of the object which was found, or to 0 if no object corresponds. @{i}Examples:@{ui} 'FINDREF(1,"R4")'; object=result 'FINDREF(1,"R#?")'; object=result IF(O=FINDREF(1,"C2"),BLINK(O),0) @{i}See also:@{ui} @{"FINDVAL" LINK FINDVAL} @ENDNODE @NODE FINDVAL "ARexx function FINDVAL" @TOC "Gestion des objets" @{b}FINDVAL(first_object, "value")@{ub} Begin the search for the component whose value or type is specified, 10k for example for a resistance or 7400 for an integrated circuit. The first argument is used to begin search after an object already found. This argument must take a value ranging between 1 (search will be carried out on all the objects of the diagram) and @{"OBJECTS" LINK OBJECTS}. Search is carried out without taking into account the case of letters, i.e. upper case and lower case are not differentiated. In addition, you can include "wildcards" (or general characters) in the required string, (see AmigaDOS documentation for the various possibilities). The returned value is equal to the number of the object which was found, or to 0 if no object corresponds. @{i}Examples:@{ui} 'FINDVAL(1,"10k")'; object=result IF(O=FINDVAL(1,"10µF"),MARK(O),0) @{i}See also:@{ui} @{"FINDREF" LINK FINDREF} @ENDNODE @NODE FIRSTSEL "ARexx function FIRSTSEL" @TOC "Gestion blocs" @{b}FIRSTSEL@{ub} This function returns the number of the first selected object. It does not require any argument. If no object is marked the returned value is null. @{i}See also:@{ui} @{"NEXTSEL" LINK NEXTSEL} @ENDNODE @NODE FONTNAME "ARexx function FONTNAME" @TOC "Gestion préférences" @{b}FONTNAME@{ub} Version 2.05 (argument suppressed) Return the name of the font used in the current window. @{i}Example:@{ui} FONTNAME returns topaz.font (for example) @{i}See also:@{ui} @{"FONTSIZE" LINK FONTSIZE}. @ENDNODE @NODE FONTSIZE "ARexx function FONTSIZE" @TOC "Gestion préférences" @{b}FONTSIZE@{ub} Version 2.05 (argument suppressed) Return the size of the font used in the current window. @{i}Example:@{ui} FONTSIZE returns 11 (for example) See also: @{"FONTNAME" LINK FONTNAME}. @ENDNODE @NODE FOR "ARexx function FOR" @TOC Maths @{b}FOR(init,condition_end,action1,...)@{ub} This function makes it possible to define loops. The first argument (init) is carried out only once, when the call of the function has been just made. The second argument defines the condition to end the loop. Finally the third argument as well as the following arguments if they exist are evaluated with each execution of the loop. The use of this function often allows a saving of significant time in the execution of a script, the number of messages can decrease to a significant degree if it is used advisedly. @{i}Examples:@{ui} FOR (I=0, I<10, I=I+1) In this example @{"variable" LINK Variable} I is initialized with value 0, as long as this value is lower than 10, one increments this value. I, thus will successively take values 1 to 10. FOR (I=1, I<=10, I=I+1, DELETE(I)) This formula includes an additional instruction making it possible to remove the first 10 objects. N=100:FOR (I=0:J=0, I<=N, J=J+I, I=I+1):J This formula makes it possible to calculate the sum of the first 100 numbers. The result of the sum is returned (:J at the end). Note: A blocked loop can be stopped by two means: either by the maximum number of loops (defined by function @{"SECURITY" LINK SECURITY}, or while pressing simultaneously on three keys CTRL, ALT and ESC. @{i}See also:@{ui} @{"WHILE" LINK WHILE}. @ENDNODE @NODE GETARRAY "ARexx function GETARRAY" @TOC Divers @{b}GETARRAY(arrayname,ord)@{ub} This function returns the value of a variable in an array. Ord must be included between 0 and the size of the array minus 1. See also: @{"ARRAYDIM" LINK ARRAYDIM}, @{"DIMARRAY" LINK DIMARRAY}, @{"DELARRAY" LINK DELARRAY}, @{"SETARRAY" LINK SETARRAY} @ENDNODE @NODE GETCOLOR "ARexx function GETCOLOR" @TOC "Gestion fenêtres" @{b}GETCOLOR(colour)@{ub} This function makes it possible to find the RGB levels of a given colour. The number of the colour can vary from 0 to 15. The levels are returned in the form $rrr, $ggg, $bbb in a character string. This string is the same form as that which is in the preference file. @{i}See also:@{ui} @{"SETCOLOR" LINK SETCOLOR}. @ENDNODE @NODE GETDEVS "ARexx function GETDEVS" @TOC "Gestion des objets" @{b}GETDEVS("circuit_name")@{ub} Version 1.4 This function returns the number of gates in a circuit present in a library of symbols. The name can be specified in lower or uppercase. If the component doesn't exist or is not in the libraries that are loaded in memory, the message "Incorrect argument name" is displayed. @{i}Examples:@{ui} GETDEVS("LM324") returns 4 (4 amplifiers) GETDEVS("4011") returns 4 (4 NAND gates) GETDEVS("4017") returns 1 (1 counter) GETDEVS("RESISTANCE") returns 0 (no pins number) @{i}See also:@{ui} @{"READDEV" LINK READDEV}, @{"SETDEV" LINK SETDEV}. @ENDNODE @NODE GETLABEL "ARexx function GETLABEL" @TOC Gestion des objets @{b}GETLABEL(object_number)@{ub} Return the number of the label object associated to the specified object (a line). The object number must be the number of a line object. If this object is another type, -1 is returned. If the label doesn't exist, 0 is returned. The object number must be included between 1 and @{"OBJECTS" LINK OBJECTS}. @{I}Example :@{UI} READTEXT(GETLABEL(FIRSTSEL)) @{I}See also :@{UI} @{"SETLABEL" LINK SETLABEL}, @{"FINDLAB" LINK FINDLAB}, @{"LINKLAB" LINK LINKLAB}, @{"UNLINK" LINK UNLINK} @ENDNODE @NODE GETLINE "ARexx function GETLINE" @TOC Interactivité @{B}GETLINE("title1","title2")@{UB} This function permits to define a line with the mouse. The first title is displayed in the title bar while waiting for the first click on the left mouse button by the user. After it's done, the second title is displayed and a line is drawn when the mouse is moved. At the second click the coordinates are returned (the format is the same than with the @{"COORDS" LINK COORDS} function). The function can be cancelled at any time if the user uses the keyboard or another mouse button (a null string is returned in this case). The current preferences are used to draw the line (orthogonal, fix on grid...) @{I}See also :@{UI} @{"SETORTHO" LINK SETORTHO}, @{"SNAPGRID" LINK SNAPGRID}, @{"GETZONE" LINK GETZONE}. @ENDNODE @NODE GETNET "ARexx functionGETNET" @TOC Gestion des objets @{b}GETNET(object_number)@{ub} This function returns the number of the line object linked to a label. The object number must be the one of a label, or a value of -1 is returned. See also : @{"GETLABEL" LINK GETLABEL}, @{"SETLABEL" LINK SETLABEL}, @{"LINKLAB" LINK LINKLAB}, @{"FINDLAB" LINK FINDLAB} @ENDNODE @NODE GETPART "ARexx function GETPART" @TOC "Placement objets" @{b}GETPART("name_component")@{ub} This function has been removed in version 2.0. Use function @{"PUTPART" LINK PUTPART} in place. You can use the next definition to replace it, in the startup.AmiCAD file, by example, see tooltype @{"STARTUP" LINK STARTUP}): DEF GETPART(C)=PUTPART(C,-1,-1) @ENDNODE @NODE GETPOINT "ARexx function GETPOINT" @TOC Interactivité @{B}GETPOINT("title")@{UB} @{I}Version 1.6@{UI} This function displays the specified message in the title bar and returns the coordinates of the point where the user clicks with the left mouse button. These coordinates are returned under the form column*32768+line. To get the coordinates, you can use something like that in an ARexx script: 'GETPOINT("Click on a point")' p=result col=bitand(p,'FFFF0000'x) col=col/32768 line=bitand(p,'FFFF'x) If the user clicks on the right mouse button or on the keyboard the returned value is -1 (operation cancelled). The next macros can be defined to recover the coordinates of the point : DEF POINTLINE(P)=P&0xFFFF DEF COLONN(P)=P>>15 @ENDNODE @NODE GETPOS "ARexx function GETPOS" @TOC Gestion des objets @{B}GETPOS(object_number)@{UB} Returns a value defining the placement mode of a component, a text or a connector. If the object was placed without any rotation, this value is equal to 1, else it can be 2 to 4. If the specified object had a symmetry, the returned value is negative. If the object is another type the returned value is always 0. @{I}See also :@{UI} @{"ROTATE" LINK ROTATE}, @{"SYMMETRY" LINK SYMMETRY}. @ENDNODE @NODE GETREF "ARexx function GETREF" @TOC "Gestion des objets" @{b}GETREF(object_number)@{ub} Returns the reference's object number that's associated with the specified component. The number of the object passed in the argument must naturally be a component. If the object is of another type the function returns -1. If this reference does not exist the function returns 0. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. Example : READTEXT(GETREF(FIRSTSEL)) See also: @{"SETREF" LINK SETREF}, @{"LINKREF" LINK LINKREF}, @{"UNLINK" LINK UNLINK}, @{"GETVAL" LINK GETVAL} @ENDNODE @NODE GETVAL "ARexx function GETVAL" @TOC "Gestion des objets" @{b}GETVAL(object_number)@{ub} Returns the value's object number that's associated with the specified component. The number of the object passed in argument must naturally be a component. If the object is of another type the function returns -1. If this reference does not exist the function returns 0. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. @{i}Example :@{ui} READTEXT(GETVAL(FIRSTSEL)) @{i}See also:@{ui} @{"SETVAL" LINK SETVAL}, @{"LINKVAL" LINK LINKVAL}, @{"UNLINK" LINK UNLINK}, @{"GETREF" LINK GETREF} @ENDNODE @NODE GETZONE "ARexx function GETZONE" @TOC Interactivité @{B}GETZONE("title")@{UB} Version 2.05 (Second argument removed) This fonction permits to define a box using the mouse. The title is displayed in the title bar during the operation. To define the zone, the user must click on the left mouse button, keeps it while movin the mouse, and leaves it when the mouse is at the second corner. Any action on the keyboard or on another button cancel the function (a null string is then returned). If the function succeeds, a string defining the coordinates is returned (like by the @{"COORDS" LINK COORDS} function. @{I}See also :@{UI} @{"GETLINE" LINK GETLINE}. @ENDNODE @NODE GROUP "ARexx function GROUP" @TOC "Gestion des objets" @{b}GROUP(object_number1,object_number2...)@{ub} Create a new group with all the specified objects. Returns the number of the new group. GROUP(object_number) Only one argument Returns the group number of the object (0 if not included in a group). The object numbers must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. See also: @{"UNGROUP" LINK UNGROUP}. @ENDNODE @NODE HEIGHT "ARexx function HEIGHT" @TOC "Gestion des objets" @{b}HEIGHT (object_number)@{ub} Returns the height of the specified object, in pixels. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. If it's null, the height of the selected block is returned (-1 if nothing is selected). See also: @{"WIDTH" LINK WIDTH} @ENDNODE @NODE HELP "ARexx function HELP" @TOC Divers @{b}HELP("node")@{ub} This function allows the call of AmigaGuide, as by the menu @{"Project/Help" LINK "Help?"}. The argument must be the name of a node, (node), of the AmiCAD.guide file. You can specify the name of any function or menu. @{i}Examples:@{ui} HELP("Copy to clip") HELP("DRAW") @ENDNODE @NODE HSCALE "ARexx function HSCALE" @TOC "Gestion des objets" @{b}HSCALE(object_number)@{ub} This function returns the value of the horizontal scale of the specified object. The object number must be set between the values 1 and @{"OBJECTS" LINK OBJECTS}. If the argument is null, the current horizontal scale is returned (v2.07). See also: @{"VSCALE" LINK VSCALE}, @{"SETSCALE" LINK SETSCALE}. @ENDNODE @NODE IF "ARexx function IF" @TOC Maths @{b}IF(x, a1, a2)@{ub} If x is different from zero, returns a1 if not returns a2. Only a1 OR a2 will be evaluated, according to the result of x. Note that the arguments a1 and a2 can be of any type, they can also call upon other functions, including other IF functions. @{i}Examples:@{ui} IF(A>B,A,B) returns the maximum value of A and B DEF MIN(A,B)=IF(A