4]------------------------- 3]LIREPIC (v2.2) 3]ฉ1990 by Charles Vassallo 4]------------------------- TERMS FOR USING LIREPIC: This program and its documentation are copyright material and MAY NOT be distributed, re-published, or placed on bulletin boards. However, permission is granted to purchasers of JUMPDISK to use LIREPIC in their own non-commercial, creative applications. That is, you may include LIREPIC on a disk where it is used solely to display text/image files which you have created. Such disks containing LIREPIC may not be sold. For information on commercial use of LIREPIC, contact JUMPDISK, 1493 Mt. View Ave., Chico, CA 95926 (916) 343-7658. 3]SHORT MANUAL This notice is a short "User Manual" to prepare illustrated texts to be displayed with LirePic. You can print it with the PRT/COPY gadget. 3]THE CONTROL SEQUENCES The text must begin with special declarations (only one declaration per line, beginning on the extreme left) : D]n sets the depth to n (n=2,3 or 4). Can be omitted if there is no ญญญ figure; the depth is then set to 2. This instruction must be the first one in the file. G] rgb xyz uvw sets the colors in the gadget line. The triplets "rgb","xyz" ญญญญญญญญญญญญญญ and "uvw" are hex numbers (0 to F) for the red, green and blue components of three colors, namely the background, the pen color and the color for the box and the cursor of the page gadget. This command can be omitted. It is provided because the default adjustment might prove non satisfactory. When used, it must be the second command. Use upper case A,B,C,D,E,F for hex numbers. The spaces between triplets are optional. P]xxFigFile declaration for the figure stored in the file "FigFile". ญญญญญญญญญญญ "xx" is a 2-character identifier which will be used later on to call the picture (for instance, 00, 01, 02, etc.). The name "FigFile" must include all the relevant path information to locate the file. Mind that this information depends on whether LIREPIC is invoked from CLI or through a Workbench icon. In the latter case, the current directory is set to the one containing the icon and no path is required, provided the figure files are in the same directory as the text file. There must be no space in the declaration sequence. The text itself begins just after the last picture declaration. The control sequences can be separated in two classes : - sequences x]... (at the extreme left of a line), announcing a global change for the whole line. - sequences ]....]xxx... with a first ] at the extreme left. The first ] means that the line will be analyzed character by character, looking for the subsequent ]xx codings embedded in the line. The first class contains only two instructions : f] (at the beginning of a line) prints the line with the f-th color in the ญญ the palette, i.e. "f" starts from 1 and is written as a hex number (1,2...A,B,C,D,E,F). This notation was adopted for historical reasons and it will not be extended to other color commands (where colors will be numbered from 0, and not 1) 3]PALETTE COMMAND p] RGB UVW XYZ... ("p" is precisely the lower case "p"). The various ญญญญญญญญญญญญญญญญ triplets RGB, UVW, XYZ are the amounts of red, green and blue for the various colors of the palette, written as hex numbers from 0 to F (upper case only for A,B,..F). If one uses a palette instruction with fewer RGB triplets than possible colors, only the first colors are changed by this instruction. The spaces are optional. There must be no text after this command. The second class of instructions contains extended color instructions and picture instructions. ]...]fb (the first "]" must be at the beginning of the line) sets up the ญญญญญญญ f-th color for the pen and the b-th color for the background, until a second color code or the end of the line. The internal Amiga numbering is used, i.e. f or b = 0,1,2...F. The default colors are restored at the end of the line. ]]f (or ]...]f), immediately followed with the end of line, means that the ญญญ pen color is switched to the f-th color, but this will not be changed until a new similar instruction occurs. This will be generally used only once, at the beginning of the text, to change the default pen color (color 1). ]... ]Pxx nn inserts the line "nn" (nn=00,01,02...) of the picture ญญญญญญญญญญญญ identified with "xx" in the declaration instructions. There must be a space between "xx" and "nn". Be sure to use the same "nn" as in the declaration (upper case and lower case are different). For instance, one can insert a 4-line picture with the identifier "1a" with the following coding: ]...(text)....]P1a 00....(text)... (for the first line) ]...(text)....]P1a 01....(text)... (next line) ]...(text)....]P1a 02....(text)... (next line) ]...(text)....]P1a 03....(text)... (last line) The picture will appear with text on both sides. Of course, either the left text or the right text can be suppressed (if there is no left text, each line must begin with "]]P"). Notice that all the "]Pxx nn" sequences must be perfectly aligned vertically if there is no extra color coding added to the text. 3]IF SOMETHING GOES WRONG Normally, all special codes are filtered out. Errors are signalled precisely by displaying the code sequences that have not been understood. If there is a problem when loading a figure, its declaration code is printed ahead of the text (the following declarations also are printed, but in fact the corresponding figures are not checked). Generally, the file can't be found because of an incorrect name or an incorrect path. Another possible reason is that the figure has more bit-planes than the depth previously declared. If a picture "line" cannot be displayed, the calling sequence "]Pxx nn" is printed on screen. Probable cause: an erroneous identifier, or too high a line number. 3]HOW TO INVOKE LIREPIC LIREPIC can be called from the Workbench or from the CLI. From CLI, simply type: lirepic filename Take care of the current directory, so the figures files can be found. To use it with Workbench icons, attach a Project type icon to the text file you wish to read. Click this icon once and select "Info" from the pulldown Workbench menu at top left of the Workbench screen. In the ToolTypes box, type: :lirepic . . . and click the Save box at bottom left of the screen. You must copy LIREPIC to the same diskette as the text file. 4]END