home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / windows / picl182.zip / PL.HLP < prev    next >
Text File  |  1990-03-15  |  34KB  |  915 lines

  1. PL.HLP : Help file for Piclab 1.60
  2. Compiled 1/4/90
  3.  
  4. ~MAKEPAL
  5.  
  6. Syntax: MAKEPAL
  7.  
  8. Makes a palette appropriate for the NEW buffer.  Operates on only
  9. true-color images.  The variable PALETTE determines the number of
  10. colors in the new map, and the MAKEPAL command picks that many colors
  11. to best fit those in the image.
  12.  
  13. The MAP command must be used to map the image onto the palette.
  14.  
  15. ~EGAPAL
  16.  
  17. Syntax: EGAPAL
  18.  
  19. Makes a 16-of-64-color palette appropriate for the NEW buffer.
  20. Operates on only true-color images.  This is designed primarily for
  21. reducing full-color images to a form better suited for display on
  22. an IBM EGA or similar device.
  23.  
  24. The MAP command must be used to map the image onto the palette.
  25.  
  26. ~MAP
  27.  
  28. Syntax: MAP
  29.  
  30. Maps NEW buffer onto the current palette.  Operates only on true-color
  31. images, and produces a color-mapped image.  The variable DITHER
  32. determines whether each pixel is simply mapped onto the nearest color
  33. in the map, or whether dithering is used to achieve a more accurate
  34. mapping.  DITHER defaults to ON, and is recommended for most uses.
  35.  
  36. The MAKEPAL command should be used to create the best possible palette
  37. for the image before mapping, but any palette may be used for special
  38. purposes such as mapping several images to the same palette.
  39.  
  40. ~PLOAD
  41.  
  42. Syntax: PLOAD file [offset [count]]
  43.  
  44. Loads a MAP file into the current palette.  First argument is the name
  45. of the MAP file which is assumed to be in the PICDIR directory.  If a
  46. second argument is given, the palette is loaded starting at that index.
  47. If a third argument is given, only that many colors are loaded.
  48.  
  49. MAP files are plain text files that contain the RGB values for each
  50. palette index on one line.
  51.  
  52. ~PSAVE
  53.  
  54. Syntax: PSAVE file [offset [count]]
  55.  
  56. Saves a MAP file from the current palette.  First argument is the name
  57. of the MAP file which is assumed to be in the PICDIR directory.  If a
  58. second argument is given, the palette is loaded starting at that index.
  59. If a third argument is given, only that many colors are loaded.
  60.  
  61. This can be used to save a palette created with MAKEPAL so that it need
  62. not be calculated again, or so that it can be used with other images.
  63.  
  64. MAP files are plain text files that contain the RGB values for each
  65. palette index on one line.
  66.  
  67. ~UNMAP
  68.  
  69. Syntax: UNMAP
  70.  
  71. Produces a true-color image from a color-mapped one.  This must be done
  72. before applying true-color transformations such as rescaling.  After
  73. transformations have been performed in true-color, the image may be
  74. reduced to a color-mapped one again with the MAKEPAL and MAP commands.
  75.  
  76. ~HELP
  77.  
  78. Syntax: HELP [subject]
  79.  
  80. Looks like you have figured this one out already.
  81.  
  82. ~CALL
  83.  
  84. Syntax: CALL program [args]...
  85.  
  86. Calls the external program named by its first argument passing along
  87. any subsequent arguments to that program.  Many programs do not
  88. release all of the memory given to them when they terminate, so
  89. Piclab will reserve a large portion of memory for itself before
  90. calling a program.  If you do not have much more memory than Piclab
  91. reserves, this may result in the program not being able to run in the
  92. memory left.
  93.  
  94. If this is a problem, you can use the DOS or SHELL commands to exit
  95. to DOS with all of the free memory available.
  96.  
  97. ~CANCEL
  98.  
  99. Syntax: CANCEL
  100.  
  101. Cancels the most recent operation.  If there are point
  102. transformations pending that have not yet been saved with the
  103. TRANSFORM command, these are cancelled and no changes are made to the
  104. edit buffers.  Otherwise, the NEW and OLD buffers are exchanged.
  105.  
  106. There are some operations (like SAVE) that do not alter the edit
  107. buffers.  If one of these operations was the last one performed, UNDO
  108. will undo the operation before that.  No arguments.
  109.  
  110. ~UNDO
  111.  
  112. Syntax: UNDO
  113.  
  114. Cancels the most recent operation.  If there are point
  115. transformations pending that have not yet been saved with the
  116. TRANSFORM command, these are cancelled and no changes are made to the
  117. edit buffers.  Otherwise, the NEW and OLD buffers are exchanged.
  118.  
  119. There are some operations (like SAVE) that do not alter the edit
  120. buffers.  If one of these operations was the last one performed, UNDO
  121. will undo the operation before that.  No arguments.
  122.  
  123. ~SHELL
  124.  
  125. Syntax: SHELL [command]
  126.  
  127. Calls up the DOS command line.  All available memory is released to
  128. DOS when this command is given, and is reclaimed when DOS is exited.
  129. For this reason, some programs that cannot be CALLed may be run from
  130. with DOS.
  131.  
  132. Any arguments to this command will be passed to the system as a
  133. command line, and will cause it to return immediately after the
  134. command is done.  One particularly useful action of this program is
  135. "SHELL COPY /B PDAT PRN", which copies the print file to the printer.
  136. "SHELL DIR" can be used to view file directories when you want to see
  137. all files, not just pictures.
  138.  
  139. ~DOS
  140.  
  141. Syntax: DOS [command]
  142.  
  143. Calls up the DOS command line.  All available memory is released to
  144. DOS when this command is given, and is reclaimed when DOS is exited.
  145. For this reason, some programs that cannot be CALLed may be run from
  146. with DOS.
  147.  
  148. Any arguments to this command will be passed to the system as a
  149. command line, and will cause it to return immediately after the
  150. command is done.  One particularly useful action of this program is
  151. "DOS COPY /B PDAT PRN", which copies the print file to the printer.
  152. "DOS DIR" can be used to view file directories when you want to see
  153. all files, not just pictures.
  154.  
  155. ~QUIT
  156.  
  157. Syntax: QUIT [flag]
  158.  
  159. Exits Piclab.  If there is a point transformation pending, it must be
  160. cancelled or saved before exiting.  If the exit command is given any
  161. arguments, it exits immediately regardless of pending transformations.
  162.  
  163. Inside a program, QUIT merely sets a flag so that Piclab will exit after
  164. the program is complete.
  165.  
  166. ~EXIT
  167.  
  168. Syntax: EXIT [flag]
  169.  
  170. Exits Piclab.  If there is a point transformation pending, it must be
  171. cancelled or saved before exiting.  If the exit command is given any
  172. arguments, it exits immediately regardless of pending transformations.
  173.  
  174. Inside a program, EXIT merely sets a flag so that Piclab will exit after
  175. the program is complete.
  176.  
  177. ~LIST
  178.  
  179. Syntax: LIST [item]
  180.  
  181. If given without an argument, shows what things may can be listed.
  182. If one of these things (e.g. FORMATS, COMMANDS, BUFFERS) is given as
  183. an argument, the appropriate items are listed.  Especially useful are
  184. LIST COMMANDS if you forget the name of a command you are looking for
  185. and LIST BUFFERS to check the size and format of the image in the OLD
  186. and NEW edit buffers.
  187.  
  188. ~PAUSE
  189.  
  190. Syntax: PAUSE [time]
  191.  
  192. With no arguments, Piclab waits for a key to be pressed before
  193. continuing.  If one argument is given, Piclab waits for that number
  194. of seconds (but will break early if a key is pressed).  This is for
  195. use within programs.
  196.  
  197. ~PRINT
  198.  
  199. Syntax: PRINT [x-offset [y-offset]]
  200.  
  201. Prints the image in the NEW buffer into the file specified by the
  202. PRINTFILE variable.  The current setting of the PRINTER variable
  203. determines what codes are sent to the file.
  204.  
  205. For hard-to-explain reasons, the current release of Piclab does not
  206. allow the use of a device name such as PRN in the PRINTFILE
  207. variable.  Images must therefore be printed to disk and copied to the
  208. printer with DOS.
  209.  
  210. If arguments are given, the first two are used as the X and Y offsets
  211. of the first dot to print on the first page of output.
  212.  
  213. ~RUN
  214.  
  215. Syntax: RUN program [ECHO]
  216.  
  217. Takes one argument--the name of a text file containing Piclab
  218. commands.  These are interpreted as if they had been typed from the
  219. command line, but they are not echoed, and messages are turned off
  220. while a program runs.  Subsequent arguments are passed along to the
  221. program as %1, etc.
  222.  
  223. A program can also be run by giving its name as an argument to the PL
  224. command when starting Piclab.
  225.  
  226. ~SHOW
  227.  
  228. Syntax: SHOW [x-offset [y-offset]]
  229.  
  230. Used to display as much of the image in the NEW buffer as will fit on
  231. the computer's display screen.  If arguments are given, the first is
  232. used as a horizontal offset into the image buffer and the second as a
  233. vertical offset.  This can be used to look at different parts of an
  234. image too big for the screen.  Certain video modes allow scrolling
  235. with the arrow keys, but not all.  If no arguments are given, the
  236. current values of the XORIGIN and YORIGIN variables are used.
  237.  
  238. If any point transformations are pending, the image you see on screen
  239. reflects the image as it would be AFTER the pending transformation.
  240. This can be used to look at the effect of a transformation before
  241. saving or cancelling it.
  242.  
  243. Because Piclab often stores data more accurately than the display can
  244. render it, what you see on the screen is only an approximation of the
  245. actual image.  In particular, because Piclab does not yet support any
  246. true-color display hardware, true-color images will be shown in grayscale
  247. on displays capable of it, or in 8-color dither on others.
  248.  
  249. ~SET
  250.  
  251. Syntax: SET [variable [value]]
  252.  
  253. Without any arguments, lists all Piclab variables and their current
  254. values.  Variables can be numbers, character strings, or TRUE/
  255. FALSE.  Variables set system defaults and control the specifics of
  256. how many commands perform.
  257.  
  258. If the set command is given one argument, the variable named is
  259. cleared.  That is, set to 0 if it is numeric, to "" if it is a
  260. string, and to FALSE if it is TRUE/FALSE.
  261.  
  262. If SET is given with two arguments, the variable named by the first
  263. is set to the value specified by the second.  If a numeric variable
  264. is given a string value, it is set to 0.  String values should not be
  265. put in quotes.  TRUE/FALSE values may be set by the keywords
  266. TRUE/FALSE, YES/NO, ON/OFF, or by the numeric values 1/0.
  267.  
  268. Within the SSTOOLS.INI file, the syntax is <variable>=<value>.
  269.  
  270. Help on individual variables is available by typing HELP <variable>.
  271.  
  272. ~HISTOGRAM
  273.  
  274. Syntax: HISTOGRAM [RED | GREEN | BLUE]...
  275.  
  276. If no arguments are given, plots histograms for all planes; if one or
  277. more arguments are given, a histogram is plotted for each plane
  278. specified as an argument.  The histograms plotted reflect the image
  279. as it would be after any pending transformations, so you can look at
  280. the results of many processes before saving or cancelling them.
  281.  
  282. Each vertical bar of the histogram represents the total number of
  283. pixels in the image with values in the range beginning with the value
  284. listed below the histogram in hexadecimal.  Each bar covers a range
  285. of four values and there are 64 bars.  The height of each bar is in
  286. logarithmic proportion to the frequency of occurrence of values in
  287. the range it represents.  The bars are automatically scaled so that
  288. the tallest one is made 20 characters high.
  289.  
  290. ~NEGATE
  291.  
  292. Syntax: NEGATE [RED | GREEN | BLUE]...
  293.  
  294. Arguments are handled as in HISTOGRAM.  Inverts each value in the
  295. lookup table for the planes specified.  This can be used after
  296. digitizing a negative or for special effects.
  297.  
  298. ~DARKEN
  299.  
  300. Syntax: DARKEN [[RED | GREEN | BLUE] value]...
  301.  
  302. Subtracts a constant value to each point in the planes specified.  If
  303. only one argument is given, all planes are brightened by that amount.
  304. Otherwise, arguments are interpreted in order, and any arguments that
  305. specify planes determine which plane the next numerical argument will
  306. affect.  For example, DARKEN RED 10 BLUE 15 would subtract 10 from
  307. the values in the red plane and 15 from those in the blue.  Any
  308. values that would be taken out of the 0..255 range by the transform
  309. are clamped.
  310.  
  311. Because this darkening is a linear operation, the image to be
  312. brightened or darkened should be encoded with a gamma of 1.0.  That
  313. is, there should be a linear relationship between values in the image
  314. and intensities on the display.  If this is not the case, gamma
  315. correction may be applied with the GAMMA command before adjusting
  316. brightness.
  317.  
  318. ~BRIGHTEN
  319.  
  320. Syntax: BRIGHTEN [[RED | GREEN | BLUE] value]...
  321.  
  322. Adds a constant value to each point in the planes specified.  If only
  323. one argument is given, all planes are brightened by that amount.
  324. Otherwise, arguments are interpreted in order, and any arguments that
  325. specify planes determine which plane the next numerical argument will
  326. affect.  For example, BRIGHTEN RED 10 BLUE 15 would add 10 to the
  327. values in the red plane and 15 to those in the blue.  Any values that
  328. would be taken out of the 0..255 range by the transform are clamped.
  329.  
  330. Because this brightening is a linear operation, the image to be
  331. brightened or darkened should be encoded with a gamma of 1.0.  That
  332. is, there should be a linear relationship between values in the image
  333. and intensities on the display.  If this is not the case, gamma
  334. correction may be applied with the GAMMA command before adjusting
  335. brightness.
  336.  
  337. ~CONTRAST
  338.  
  339. Syntax: CONTRAST [[RED | GREEN | BLUE] value]...
  340.  
  341. This stretches or squeezes the contrast of an image.  Arguments are
  342. interpreted like those in BRIGHTEN.  If a given value is positive,
  343. the image contrast is stretched so that values that were equal to the
  344. given value become 0, and those that were equal to (255-value) become
  345. 255.  If the given value is negative, the inverse operation is
  346. performed.  Because contrast is always stretched equally around the
  347. midpoint of the range, it is a good idea to brighten or darken an
  348. image as necessary to center its histogram before performing a
  349. contrast stretch.
  350.  
  351. Also, the contrast stretching formula operates on color values
  352. assuming a linear relationship between these values and the
  353. intensities they represent (as do the BRIGHTEN and DARKEN commands). 
  354. Therefore, if an image has been scanned with a device with a gamma
  355. value not equal to 1.0, the image should be gamma corrected before
  356. contrast stretching.
  357.  
  358. ~GAMMA
  359.  
  360. Syntax: GAMMA [[RED | GREEN | BLUE] value]...
  361.  
  362. The color values of the specified planes are adjusted so that values
  363. encoded for display on a monitor with a gamma value equal to the
  364. argument become linear.
  365.  
  366. For example, images encoded for display on PCs usually expect a
  367. monitor with a gamma near 2.0.  The GAMMA 2.0 command will convert
  368. these values to a linear scale.
  369.  
  370. Images encoded on Macintoshes and similar equipment have linear
  371. values already.  Such images can be adjusted for display on PCs with
  372. the inverse transformation, i.e. GAMMA 0.5.
  373.  
  374. See Piclab.DOC for more background on gamma correction.
  375.  
  376. ~COLOR
  377.  
  378. Syntax: COLOR [mapfile]
  379.  
  380. Converts a grayscale image into a color-mapped image.  If the first
  381. argument is the name of a MAP file, the image is pseudo-colored with
  382. that map, otherwise the color map will contain the original grays.
  383.  
  384. ~GRAY
  385.  
  386. Syntax: GRAY
  387.  
  388. Converts true-color or color-mapped image to grayscale.  The formula
  389. used for conversion to grayscale is the same as used by black and
  390. white televisions and is designed to mimic the eye's response: gray =
  391. (.287 * red) + (.589 * green) + (.114 * blue).
  392.  
  393. ~TRANSFORM
  394.  
  395. Syntax: TRANSFORM
  396.  
  397. Saves the result of a series of point-process transformations to the
  398. edit buffer.  This must be done before any other transformation may
  399. be performed on the image.  If you wish to cancel the pending
  400. transformations without saving them, use UNDO or CANCEL.
  401.  
  402. ~MEDIAN
  403.  
  404. Syntax: MEDIAN [WEIGHTED]
  405.  
  406. Reduces spot noise in an image.  Each point is replaced by the median
  407. of the points in its 3 x 3 area.  That is, the nine points in this
  408. area are sorted and the fifth one is taken.  If the one argument to
  409. this routine is WEIGHTED, then the center point is added twice more
  410. to the list and the sixth of the 11 points is taken.
  411.  
  412. The median filter results in some smoothing, but not as much as with
  413. the SMOOTH command.  This effect is a little less drastic with the
  414. weighted median filter.  Repeated application of this operation will
  415. result in an oil-paint texture appearing on the image.
  416.  
  417. This filter will not help reduce periodic or other noise--only small
  418. spot noise such as from dust on a lens.
  419.  
  420. ~SHARPEN
  421.  
  422. Syntax: SHARPEN [value]
  423.  
  424. Applies what is called (somewhat inaccurately) a LaPlace transform to
  425. the image.  The effect is that edges in the image are sharpened as if
  426. the image had been re-focused.  Unfortunately, it also increases the
  427. amount of noise in the image, making it appear more grainy.
  428.  
  429. The command can be given a single numerical argument, which specifies
  430. the severity of the transform.  It is basically a tradeoff between
  431. sharpness and noise, and defaults to 1.0.  This value provides a
  432. noticeable increase in both sharpness and noise, and is about the
  433. best value for sharpening when the purpose is to bring out
  434. information.  When applying to a real image, a less severe value of
  435. .2 to .5 is often better.  Values greater than 1.0 should be used
  436. only when trying to locate specific objects in an image.  They
  437. produce too much noise for accurate reproduction.
  438.  
  439. This function works by amplifying the differences between each point
  440. and its neighbors.  This has the effect of amplifying high spatial
  441. frequency details such as edges and noise.
  442.  
  443. ~SMOOTH
  444.  
  445. Syntax: SMOOTH [value]
  446.  
  447. Replaces each point with the average of the values of the nine points
  448. in its neighborhood.  This has the effect of smoothing the image and
  449. reducing high frequency effects like aliasing and noise, as well as
  450. high frequency details.  If an argument is given, it is taken as a
  451. value of the severity of the transform as with the SHARPEN command. A
  452. value of 1.0 is exactly as described.  Values less than 1.0 change
  453. the center value less than if a straight average had been done. 
  454. Values greater than 1.0 are not recommended.  If more smoothing is
  455. desired, perform SMOOTH more than once rather than with a high value.
  456.  
  457. ~ADD
  458.  
  459. Syntax: ADD [WRAP]
  460.  
  461. Adds the OLD and NEW edit buffers storing the result in the NEW
  462. buffer.  If the only argument to the command is WRAP, then values
  463. that are taken out of the 0..255 range by the addition are taken mod
  464. 255; otherwise, values are clamped.
  465.  
  466. ~SUBTRACT
  467.  
  468. Syntax: SUBTRACT [WRAP]
  469.  
  470. Subtracts the NEW edit buffers from the OLD buffer storing the result
  471. in the NEW buffer.  If the only argument to the command is WRAP, then
  472. values that are taken out of the 0..255 range by the addition are
  473. taken mod 255; otherwise, values are clamped.
  474.  
  475. ~AVERAGE
  476.  
  477. Syntax: AVERAGE
  478.  
  479. Averages the OLD and NEW buffers, storing the result in NEW.  This
  480. can be used to reduce random digitizer noise by averaging the results
  481. of different samplings.  Can also be used to produce a double exposure
  482. effect when two different images are averaged.  No arguments.
  483.  
  484. ~CLIP
  485.  
  486. Syntax: CLIP [x-size y-size]
  487.  
  488. If no arguments are given, image is clipped from (XORIGIN,YORIGIN) to
  489. lower right corner (upper right for bottom-up images).  If two
  490. arguments are given, the image is clipped from (XORIGIN,YORIGIN) to
  491. the horizontal and vertical size specified by the arguments.  XORIGIN
  492. and YORIGIN are set to 0 after this operation.  One argument is an
  493. error; more than two are ignored.
  494.  
  495. ~EXPAND
  496.  
  497. Syntax: EXPAND x-size y-size [(BLACK | WHITE | value) [value]...]
  498.  
  499. This command increases the size of the image to the width and height
  500. specified by its first two arguments by adding extra rows and columns
  501. of pixels.  If a third argument is given, it can be either BLACK or
  502. WHITE to indicate what color the extra pixels should be.  If three
  503. numeric arguments are given after the bounds arguments, they are
  504. taken as the red, green, and blue value of the extra pixels. 
  505.  
  506. Multiple images can be placed in a montage by using EXPAND and
  507. OVERLAY.  Parts of an image may be joined with these functions as
  508. well, but it is not recommended for separately digitized image
  509. pieces, as no mosaicking is performed.
  510.  
  511. For color-mapped images, the third argument is treated as a color map
  512. index rather than a color value.
  513.  
  514. ~MIRROR
  515.  
  516. Syntax: MIRROR
  517.  
  518. Flips the image horizontally.  No Arguments.
  519.  
  520. ~OVERLAY
  521.  
  522. Syntax: OVERLAY [x-offset y-offset]
  523.  
  524. Overlays the image in the NEW buffer on top of the OLD buffer.  The
  525. image in the NEW buffer must not be larger than the image it is to
  526. overlay.  If two arguments are given, they are used as the horizontal
  527. and vertical offsets into the base image at which the overlay image
  528. is to be placed.  Otherwise, XORIGIN and YORIGIN are used.
  529.  
  530. ~RESCALE
  531.  
  532. Syntax: RESCALE value | (x-size y-size)
  533.  
  534. Resamples the image at a different resolution.  This is useful for
  535. scaling images up to a larger size for printing, or for scaling them
  536. down for display.  It is recommended that image data always be saved
  537. at its original sampling resolution to preserve as much data as
  538. possible and only scaled when necessary to conform to hardware.
  539.  
  540. If only one argument is given, horizontal and vertical resolution are
  541. both increased in the given proportion.  For example, if a 320 x 240
  542. image is in the NEW buffer when the command RESCALE 1.5 is given, the
  543. NEW buffer will contain the same image at 480 x 360.
  544.  
  545. More useful, though, is the case where two arguments are present.  In
  546. this case, the arguments are treated directly as the new horizontal
  547. and vertical resolution of the image.  The transformation above could
  548. be expressed as RESCALE 360 480.  This is most often used to
  549. compensate for differing aspect ratios.  For example, a 320 x 400
  550. from an Amiga can be rescaled to 320 x 200 to be viewed on a VGA, or
  551. to 720 x 540 for printing on the HP PaintJet.
  552.  
  553. Because RESCALE interpolates color values, it cannot be used on
  554. color-mapped images.
  555.  
  556. ~REVERSE
  557.  
  558. Syntax: REVERSE
  559.  
  560. Changes the storage order of an image from top-down to bottom-up or
  561. vice versa.  This is used primarily to save an image loaded from a
  562. file in one format (like PCX) to a format requiring the opposite
  563. order (like GIF).
  564.  
  565. Targa files can be stored either way, and contain information in the
  566. header specifying which way they are stored.  Thus, any image can be
  567. saved in Targa format at any time with minimal memory usage.
  568.  
  569. ~ROTATE
  570.  
  571. Syntax: ROTATE value
  572.  
  573. Rotates image in 90-degree increments.  The single argument may
  574. specify 1, 2, or 3, in which case that number of clockwise 90-degree
  575. rotations are performed.  If a number >= 90 is given as the argument,
  576. the image is rotated that number of degrees (truncated to the nearest
  577. 90-degree increment).
  578.  
  579. This is very useful for rotating screen-oriented images for printing
  580. on paper.  Because this operation requires large amounts of memory
  581. for large images, it is recommended in this case to rotate the image
  582. before scaling it up to size for printing.
  583.  
  584. ~DIR
  585.  
  586. Syntax: DIR [directory]
  587.  
  588. Lists all files in the PICDIR directory in the current file format.  If
  589. an argument is given, files in that directory are listed.  No other
  590. file specifications can be given.  If FILEFORMAT is set to GIF or
  591. TARGA, statistics on the files will be listed as well.
  592.  
  593. ~GDIR
  594.  
  595. Syntax: GDIR [directory]
  596.  
  597. Lists only GIF files from PICDIR or from the directory given as sole
  598. argument.  Statistics are listed from each file as well.
  599.  
  600. ~TDIR
  601.  
  602. Syntax: TDIR [directory]
  603.  
  604. Lists only Targa files from PICDIR or from the directory given as
  605. sole argument.  Statistics are listed from each file as well.
  606.  
  607. ~LOAD
  608.  
  609. Syntax: LOAD file [args]...
  610.  
  611. Loads a file in the current file format into the NEW buffer, moving
  612. the current contents of the NEW buffer to OLD.  Any arguments are
  613. passed along to the function that handles loading for the current
  614. format and are interpreted by that routine.  The first argument is
  615. always the file to be loaded, but other arguments vary with the format.
  616.  
  617. LIST FORMATS will give you a list of all the available file formats,
  618. and HELP is available for each.
  619.  
  620. ~GLOAD
  621.  
  622. Syntax: GLOAD file
  623.  
  624. Loads image in GIF format regardless of the current setting of
  625. variable FILEFORMAT.  Sole argument is filename.
  626.  
  627. ~TLOAD
  628.  
  629. Syntax: TLOAD file
  630.  
  631. Loads image in Targa format regardless of the current setting of
  632. variable FILEFORMAT.  Sole argument is filename.
  633.  
  634. ~RLOAD
  635.  
  636. Syntax: RLOAD file x-size y-size [COLOR | MONO]
  637.  
  638. Loads image in RAW format regardless of the current setting of
  639. variable FILEFORMAT.  The width and height of the image must be
  640. specified as the second and third arguments to RLOAD.  A fourth
  641. argument may be either of the words COLOR or MONO to specify the
  642. number of planes.  COLOR is default.
  643.  
  644. Color-mapped RAW files must be loaded as MONO, then colored with the
  645. COLOR command after the palette is loaded with PLOAD.
  646.  
  647. ~SAVE
  648.  
  649. Syntax: SAVE file [args]...
  650.  
  651. Saves the image in the NEW buffer to the file specified by the first
  652. argument.  Subsequent arguments are passed along to the file save
  653. routine of the current file format.
  654.  
  655. LIST FORMATS will give you a list of all the available file formats,
  656. and HELP is available for each.
  657.  
  658. ~GSAVE
  659.  
  660. Syntax: GSAVE file [INTERLACE]
  661.  
  662. Saves the NEW buffer to the file named by the first argument in GIF
  663. format regardless of the current setting of variable FILEFORMAT.  If
  664. the second argument is the word INTERLACE, image is interlaced.
  665.  
  666. ~TSAVE
  667.  
  668. Syntax: TSAVE file [bits]
  669.  
  670. Saves the NEW buffer to the file named by the first argument in Targa
  671. format regardless of the current setting of variable FILEFORMAT.  If
  672. the second argument is 16, 24, or 32, it is used as the number of
  673. bits per pixel stored in the file.
  674.  
  675. ~RSAVE
  676.  
  677. Syntax: RSAVE file
  678.  
  679. Saves image in RAW format regardless of the current setting of
  680. variable FILEFORMAT.  No arguments.
  681.  
  682. ~XORIGIN
  683.  
  684. Used to set the left limit of an image for operations such as CLIP
  685. and SHOW.  Legal values are 0..(image width - 1).
  686.  
  687. ~YORIGIN
  688.  
  689. Used to set the upper limit of an image for operations such as CLIP
  690. and SHOW.  Legal values are 0..(image height - 1).  If image in NEW
  691. buffer is stored with bottom-up raster, YORIGIN is measured from the
  692. bottom counting upwards.
  693.  
  694. ~PALETTE
  695.  
  696. Number of colors in palette for palette mapping operations.  Valid
  697. values are 2..256.
  698.  
  699. ~CREZ
  700.  
  701. Color resolution or "depth" for GIF saving.  This value indicates the
  702. size of the palette from which an image was digitized.  Legal values
  703. are 1..8.
  704.  
  705. ~DPI
  706.  
  707. Graphics resolution for LaserJet printing.  May be 75, 150, or 300.
  708.  
  709. ~MULTIIMAGE
  710.  
  711. T/F flag for GIF loading.  If true, Piclab will assume that any GIF
  712. files to be loaded may contain multiple images and will act
  713. accordingly.  This requires more memory, so it defaults to FALSE.
  714.  
  715. ~MULTIMAP
  716.  
  717. T/F flag for GIF loading.  If true, Piclab will assume than any GIF
  718. files to be loaded may contain multiple images, and further, that
  719. each image may contain a local color map that differs from the global
  720. map.  This takes three times the memory of MULTIIMAGE mode, so it
  721. should be used only when absolutely necessary.
  722.  
  723. ~DITHER
  724.  
  725. T/F flag used by the MAP command to determine whether or not
  726. dithering is performed.  Defaults to TRUE, and is recommended.
  727.  
  728. ~DISPLAY
  729.  
  730. Selects display type for SHOW command.  LIST DISPLAYS will list the
  731. available modes and HELP is available for each.
  732.  
  733. ~PRINTER
  734.  
  735. String variable indicating what type of printer the PRINT command
  736. should address.  For a list of legal values, type LIST PRINTERS.
  737.  
  738. ~PRINTFILE
  739.  
  740. Disk file to which the PRINT command is directed.  If blank, as is
  741. the default, printing is sent directly to LPT1.
  742.  
  743. ~PRINTSCALE
  744.  
  745. *** NOTE: The PRINTSCALE variable is not implemented.  What follows is
  746. a description of what it will do when I get around to writing it.
  747.  
  748. Printer output is scaled up by this factor when printing.  This can
  749. be used to print large banners and posters.  If the image after
  750. scaling is wider than the paper, it will be printed in strips.
  751.  
  752. ~TEMPDIR
  753.  
  754. Name of the drive and directory where Piclab stores its temporary
  755. files (including the NEW and OLD edit buffers).  This directory must
  756. have six bytes free for every pixel in an image with which you intend
  757. to work plus some overhead.  This defaults to the setting of the TMP
  758. environment variable.
  759.  
  760. ~PICDIR
  761.  
  762. Directory in which picture files are stored.  If you use the DIR,
  763. LOAD, and SAVE commands without specifying a directory, they will
  764. look here.  MAP files are also found here.
  765.  
  766. ~FILEFORMAT
  767.  
  768. Default file format for DIR, LOAD, and SAVE commands.  To operate on
  769. most file formats it is necessary to set this variable
  770. appropriately.  GIF and TGA are special:  separate commands (GDIR,
  771. TLOAD, etc) exist to load and save these formats regardless of
  772. current setting.  For legal values, type LIST FORMATS.
  773.  
  774. ~SILENT
  775.  
  776. This variable is not listed, but can be set from the SSTOOLS.INI
  777. file.  Its only function is to supress the program ID that prints
  778. when Piclab is started.
  779.  
  780. ~LEAVETEMPS
  781.  
  782. If this hidden variable is set to TRUE, the temporary file that
  783. Piclab creates will not be deleted upon exit.  This can be used to
  784. optimise performance by placing the temporaries in a fixed location.
  785.  
  786. ~HELPFILE
  787.  
  788. Hidden variable identifying the HELP file.  This defaults to PL.HLP,
  789. but can be set in the SSTOOLS.INI file to anywhere.
  790.  
  791. ~TARGA
  792.  
  793. Truevision Targa and Vista format.  No arguments are needed to the
  794. LOAD command.  For the SAVE command, if the second argument is 16,
  795. 24, or 32, it is used as the number of bits per pixel in the file.
  796.  
  797. ~GIF
  798.  
  799. No arguments are interpreted from the command line, but GIF loading
  800. is affected by the values of the variables MULTIIMAGE and MULTIMAP.
  801. These are both set false by default to save memory, but one or both
  802. may be necessary to load some files.  LOAD will issue warnings when
  803. loading a multiimage or multimap file with improper settings.
  804.  
  805. If the word INTERLACE is given as an argument to the SAVE command,
  806. the file is stored in GIF interlaced format.  A GIF file is always
  807. saved as a single-image file with the screen size and image size
  808. identical.  Because color GIF files are limited to a palette of 256
  809. colors, only monochrome and mapped images can be saved.
  810.  
  811. 'GIF' and 'Graphics Interchange Format' are trademarks of
  812. CompuServe Incorporated, an H&R Block company.
  813.  
  814. ~RIX256
  815.  
  816. Only uncompressed 256-color file formats from ColoRix are
  817. supported--the old EGAPaint files are not.  Because so many different
  818. file extensions are used, file extension must be specified when
  819. loading.  The global palette is taken from the image file regardless
  820. of the file extension, unlike ColoRix.
  821.  
  822. The SAVE command is not supported for this format.
  823.  
  824. ~IP
  825.  
  826. This is the Amiga DigiView's raw storage format.  It consists of
  827. nothing but three planes of data, one byte per pixel, followed by 12
  828. bytes not associated with the image.  Because there is no size
  829. information in a IP file, the width and height of the image must be
  830. specified as the second and third arguments to LOAD.  A fourth
  831. argument may be the words COLOR or MONO to specify the number of
  832. planes.  COLOR is default.
  833.  
  834. The SAVE command is not supported for this format.
  835.  
  836. ~RAW
  837.  
  838. One file per plane, one byte per pixel, nothing else.  The width and
  839. height of the image must be specified as the second and third
  840. arguments to LOAD.  A fourth argument may be either of the words
  841. COLOR or MONO to specify the number of planes.  COLOR is default.
  842.  
  843. The file for plane one must have the .R8 extension, and the second
  844. and third planes, if any, must have .G8 and .B8.
  845.  
  846. ~CGA
  847.  
  848. Puts the CGA into standard 640 x 200 x 2 mode and displays two screen
  849. pixels for each image pixel, covering an image area of 320 x 200.
  850. Image data is halftoned while displaying, so it is quite slow.  No
  851. color can be shown.
  852.  
  853. ~EGA
  854.  
  855. Puts the EGA into standard 640 x 350 x 16 mode and displays one
  856. screen pixel per image pixel.  8-color dithering is used to get an
  857. approximation of the colors in the original image, so this mode is
  858. rather slow.  Also note that this mode stretches the pixels
  859. vertically more than any other mode.
  860.  
  861. ~VGA1
  862.  
  863. Puts the VGA into standard 320 x 200 x 256-color mode and displays
  864. one screen pixel for each image pixel.  Color-mapped images will
  865. appear in full color; true-color and grayscale images will appear in
  866. pseudo-gray which allows the VGA to display more than 64 shades but
  867. with some slight tinges of color.
  868.  
  869. ~VGA2
  870.  
  871. Puts the VGA into non-standard 360 x 480 x 256-color mode and
  872. displays five screen pixels for every nine image pixelsso that an
  873. image area of 640 x 480 is shown.  Color-mapped images will appear
  874. in full color; true-color and grayscale images will appear in
  875. pseudo-gray which allows the VGA to display more than 64 shades
  876. but with some slight tinges of color.
  877.  
  878. ~SVGA1
  879.  
  880. Puts an extended VGA into 640 x 400 x 256-color mode.  This mode is
  881. available on adapters from Ahead Systems, ATI, Chips & Technologies,
  882. Everex, Paradise, Trident, Tseng Labs (including Orchid) and Headland
  883. Technologies (Video 7).  Only 256k of video RAM is required for this
  884. mode, but some adapters may require a multi-frequency monitor.
  885.  
  886. ~SVGA2
  887.  
  888. Puts an extended VGA into 640 x 480 x 256-color mode.  This mode is
  889. available on most non-IBM adapters (see SVGA1 mode description) and
  890. requires 512k of video RAM and a multi-frequency monitor.
  891.  
  892. ~SVGA3
  893.  
  894. Puts an extended VGA into 800 x 600 x 256-color mode.  This mode is
  895. available on some adapters and requires 512k of video RAM and a high-
  896. resolution multi-frequency monitor
  897.  
  898. ~PAINTJET
  899.  
  900. Images are printed to the HP PaintJet at 90 DPI.  Currently only
  901. true-color images may be printed, so COLOR and UNMAP must be used to
  902. print others.
  903.  
  904. ~LASERJET
  905.  
  906. Currently only grayscale images may be printed to the HP LaserJet.
  907. The variable DPI can be set to 75, 150, or 300 to determine the
  908. output resolution.  If DPI is set to 300, the LaserJet must have more
  909. than 1 MB of memory to print properly.
  910.  
  911. Each image pixel will generate four pixels on the printer, regardless
  912. of DPI.  This is so that more accurate grayscale can be obtained.
  913.  
  914. ~
  915.