home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / print / splt250.zip / SPLOT.DOC < prev    next >
Text File  |  1993-04-07  |  65KB  |  1,371 lines

  1.  
  2.  
  3.            S P L O T  -  The Pen Plotter Simulator V2.50
  4.            ---------------------------------------------
  5.            Copyright (C) 1989-93 by Alexandr NOVY
  6.                  All rights reserved.
  7.  
  8.  
  9.  
  10.       U S E R ' S   M A N U A L   F O R   MS-DOS   V E R S I O N
  11.       ----------------------------------------------------------
  12.                  April 1993
  13.  
  14.  
  15.  
  16.  
  17.                 1. INTRODUCTION
  18.                 ---------------
  19.  
  20.           The SPLOT program is  a highly effective tool  intended for
  21.         simulating the pen plotter on the display of an IBM PC.   The
  22.         SPLOT program is  the very thing  you need to  make your work
  23.         with the plotter more effective. The SPLOT program will  give
  24.         you a guarantee you will always draw on your plotter what you
  25.         really want. That is why it will save your nerves, your time,
  26.         your plotter, pens and paper, that means your money.
  27.  
  28.  
  29.          The SPLOT program can offer:
  30.  
  31.          - active support of about 50 HP-GL instructions (according
  32.        to the type of your plotter).
  33.  
  34.          - active support of 20 DXY-GL instructions (for ROLAND
  35.            plotters).
  36.  
  37.          - possibility of exporting a  picture to the printer and  in
  38.            this way to obtain an output of a high quality. The  SPLOT
  39.            program uses the  best graphics resolutions  available for
  40.            each printer  that it  supports and  optionally uses  data
  41.            packing to improve transfer speed.  In this way the  SPLOT
  42.            program will  make a  fast and  excellent plotter  of your
  43.            printer. It supports all usual types of printers including
  44.            color ones.
  45.  
  46.          - exporting a picture to the HP-GL, DXY-GL, PLOTCALL, DXF
  47.        and PostScript formats.
  48.  
  49.          - possibility of making picture cuts (the ZOOM function). In
  50.            this way you can scan,  draw on the plotter or  print only
  51.            the selected part of the picture.
  52.  
  53.          - possibility  of  completing  the  picture  with  a    text
  54.            including multilingual characters - in this way the  SPLOT
  55.            program will teach  your plotter German  (Spanish, French,
  56.            etc.)  easily  and  quickly  without complicated switching
  57.        between  character  sets!   The  built-in  HP-GL or DXY-GL
  58.            exports respectively, will make it possible. Due to  these
  59.            exports it is also possible:
  60.  
  61.            -  to  offer  a  highly  optimized output for your plotter
  62.              (where each pen is grasped only once).
  63.  
  64.            - to  teach  your  plotter  the advanced instructions  you
  65.              would get only  if you buy  a more expensive  plotter or
  66.              additional  hardware  (e.g.,   the  SPLOT  program   can
  67.              simulate  connecting  an  additional  HP 17440A graphics
  68.              enhancement cartridge to the HP 7440A ColorPro plotter).
  69.  
  70.  
  71.         The SPLOT program can be used by:
  72.  
  73.         - anybody who wants to work with his plotter in the WYSIWYG
  74.           style (What You See Is What You Get).
  75.  
  76.         - anybody  who  wants  to  develop  his  own plotter  program
  77.           applications.   You  can  reach  it  with the SPLOT program
  78.           easily even if you do not own the plotter at all!
  79.  
  80.         - anybody  who  wants  to  use  his  printer  as  a   plotter
  81.           occasionally or constantly. In  many cases using a  printer
  82.           may be faster and moreover, this may be an alternative of a
  83.           high quality.
  84.  
  85.         - anybody who wants to program a printer in graphics mode and
  86.           at  a  high  level  and  who  does  not  want  to   develop
  87.           complicated software which would enable it. In these  cases
  88.           using  the  HP-GL  language  in  connection  with the SPLOT
  89.           program  seems  to  be  very  advantageous for creating own
  90.           graphics outputs. The HP-GL  language can  be learned  very
  91.           easily and in addition, it offers unexpected possibilities.
  92.  
  93.  
  94.  
  95.           The  SPLOT  program  is   available  in  various   versions
  96.         according to  the type of simulated plotter. This  means that
  97.         each SPLOT.EXE  module is  designated for  a certain  plotter
  98.         type.   This  principle  gives  the  maximum  reliability  of
  99.         simulation of the given plotter type. At present versions for
  100.         the following plotter types are at your disposal:
  101.  
  102.            Plotter type                          | Plotter syntax
  103.          ------------------------------------------------------------
  104.            ROLAND DXY 1100/1200/1300             | DXY-GL / RD-GL I
  105.            HP 7470A                              | HP-GL
  106.            HP 7475A                              | HP-GL
  107.            HP 7440A ColorPro                     | HP-GL
  108.            HP 7550A                              | HP-GL
  109.            HP 7570A/7575A/7576A DraftPro DXL/EXL | HP-GL
  110.            HP 7595A/7596A DraftMaster I/II       | HP-GL
  111.  
  112.           An UNREGISTERED COPY  of the program  is available only  in
  113.         the version for the HP 7475A plotter. The versions for  other
  114.         plotter types can  be received only  on the basis  of regular
  115.         registration. See next chapter  for licensing, evaluation and
  116.         registration information or see file LICENCE.DOC for details.
  117.  
  118.           The  SPLOT  program  is  designated  for  using with IBM PC
  119.         computers  and  compatibles,  and  for  the MS-DOS and PC-DOS
  120.         version  3.00  and  higher  ones  (in  the  near  future  the
  121.     MS-WINDOWS version will be released too). In the DOS  version
  122.     graphics cards EGA  or VGA are  required. To run  the program
  123.     comfortably it is recommended to  use a Microsoft Mouse or  a
  124.     compatible one.
  125.  
  126.  
  127.  
  128.                 2. LICENSING, EVALUATION and REGISTRATION INFORMATION
  129.                 -----------------------------------------------------
  130.  
  131.         SPLOT  is  distributed  as  "Shareware"  or  "User  Supported
  132.         Software"  and  is  fully  copyrighted.  If  you register the
  133.         program you will receive these benefits:
  134.  
  135.           1) The latest version of SPLOT.
  136.           2) A printed user's manual.
  137.           3) A printed technical reference which describes
  138.              all plotter instructions supported by SPLOT.
  139.           4) An end to the nag screens and opening banners.
  140.           5) Deep discounts on the next major versions.
  141.           6) A collection of useful utilities:
  142.              - BPRINT.COM - prints binary files on a printer
  143.                             on time background with many options.
  144.              - BPLOT.COM  - plots files on a pen plotter on time
  145.                             background with many options.
  146.              - CLPT.COM - redirects printer ports to a disk file.
  147.              - CPORT.COM - redirects serial ports to a disk file.
  148.  
  149.  
  150.         The  single  user  registration  fee  for SPLOT is $70.00 US.
  151.         The multisystem site fee for SPLOT is $150.00. Users  outside
  152.         of   Europe   should   include   an   additional   $5.00  for
  153.         international airmail.
  154.  
  155.     Author can accept payment in these three ways only:
  156.  
  157.      1) In cash (money enclosed) - this is the preferred  method,
  158.         but at your risk.
  159.  
  160.      2) Bank or travelers cheque enclosed - please make  a cheque
  161.         payable in US funds. Unfortunately  our banks can  refund
  162.         most cheques  via foreign banks only.  In this case   you
  163.         will  wait  for SPLOT  a long time  (about  one month  or
  164.         longer).
  165.  
  166.      3) Bank transfer - you  may transfer payment from your  bank
  167.         to  Zivnostenska  Bank  Prague,  but  this  may  be  more
  168.         expensive for you. In this case do not forget include  my
  169.         and your full  addresses as a  part of this  transfer and
  170.         send me completed registration form too.
  171.  
  172.     Author can NOT accept payment via credit card numbers!
  173.  
  174.     Since the SPLOT program is always distributed in the  version
  175.     adapted for a certain plotter type, do not forget to  mention
  176.         the  plotter  type  with  which  you  want  to  use the SPLOT
  177.     program.  A list of plotters you can choose from is given  in
  178.         the  first  chapter  or  in  the  PLOTTERS.DOC  file.  In the
  179.         PLOTTERS.DOC  file  there  are  also  given the parameters of
  180.         these   plotters   together   with   a   list   of  supported
  181.     instructions. It makes possible to choose a suitable  plotter
  182.         type even if  your plotter is  not listed (most  plotters are
  183.         compatible with some plotter from the list).  Of course,  you
  184.         can order more SPLOT  program versions for different  plotter
  185.         types.  In this case the single user registration fee for any
  186.         further version is  $20.00 (+ $5.00  outside Europe) and  the
  187.         multisystem site fee is $40.00 (+ $5.00 outside Europe). This
  188.         principle  is  also  valid  for  an  upgrade.   If  you  have
  189.         registered at  least one  SPLOT program  version at  the full
  190.         price of $70.00 ($150.00), now and in the future only  $20.00
  191.         ($40.00) is to be paid for all other versions.
  192.  
  193.  
  194.         To register, please use the registration/order form  supplied
  195.     with this package (as provided in the file ORDER.FRM).
  196.     Please send the completed form along with a payment to:
  197.  
  198.             Alexandr Novy
  199.             Havlickova 2209
  200.             390 01 TABOR
  201.             Czech Republic
  202.  
  203.     NOTE: Czech users of SPLOT should contact Czech distributor,
  204.               SOFTECH, P.O.B. 69,  323 00 Plzen 23,  Czech Republic,
  205.               Tel./Fax  0042-19-226294.  A  special  Czech  language
  206.           version of the package is available from them as well.
  207.  
  208.  
  209.  
  210.                        EVALUATION AGREEMENT
  211.  
  212.         SPLOT  is not  and  has never been  public  domain  software,
  213.         nor is it free software.
  214.  
  215.         Non-licensed users are granted a limited license to use SPLOT
  216.         on  a  14-day  trial  basis  for  the  purpose of determining
  217.         whether SPLOT is suitable for their needs.  The use of SPLOT,
  218.         except for the initial 14-day trial,  requires  registration.
  219.         The use of unlicensed copies of SPLOT by any person,business,
  220.         corporation or any other entity is strictly prohibited.
  221.  
  222.         No one may modify or  patch the SPLOT executable file  in any
  223.         way, including but not limited to decompiling, disassembling,
  224.         or otherwise reverse engineering the program.
  225.  
  226.         A limited  license is  granted to  copy and  distribute SPLOT
  227.         only  for  the  trial  use  of  others,  subject to the above
  228.         limitations, and also the following:
  229.  
  230.         1) SPLOT must be  copied in unmodified form,  complete
  231.            with the file containing this license information.
  232.  
  233.         2) The full machine-readable SPLOT documentation  must
  234.            be included with each copy.
  235.  
  236.         3) SPLOT  may not  be distributed  in conjunction with
  237.            any other product without a specific license to  do
  238.            so from author.
  239.  
  240.         4) No  fee,  charge,  or  other  compensation  may  be
  241.            requested or accepted, except as authorized below:
  242.  
  243.            a) Operators of  electronic bulletin board  systems
  244.               (sysops)   may   make   SPLOT   available    for
  245.               downloading as long as the above conditions  are
  246.               met.   An overall  or time-dependent  charge for
  247.               the  use  of  the   bulletin  board  system   is
  248.               permitted as  long as  there is  not a  specific
  249.               charge for the download of SPLOT.
  250.  
  251.            b) Vendors of user-supported or shareware  software
  252.               may  distribute  SPLOT  after  obtaining written
  253.               permission  from  author.  Such  permission   is
  254.               usually granted. Vendors may charge a reasonable
  255.               disk duplication and handling fee.
  256.  
  257.  
  258.  
  259.                        LICENSING AGREEMENT
  260.  
  261.         Licensed user are bound to the following licensing agreement.
  262.  
  263.         You may not transfer your license without written  permission
  264.         from author.  A single  user license  permits a  user to  use
  265.         SPLOT only on a single computer at a time.
  266.  
  267.         This product is distributed  AS IS.  The  author specifically
  268.         disclaims all  warranties, expressed  or implied,  including,
  269.         but not limited to, implied warranties of merchantability and
  270.         fitness for a particular  purpose with respect to  defects in
  271.         the diskette and  documentation, and program  license granted
  272.         herein,  in  particular,  without  limiting  operation of the
  273.         program license with  respect to any  use or purpose.   In no
  274.         event shall the author  be  liable for any loss of  profit or
  275.         damage  including  but  not  limited  to special, incidental,
  276.         consequential or other damages.
  277.  
  278.         By licensing SPLOT you agree to the above licensing agreement.
  279.  
  280.  
  281.  
  282.                 3. THE SPLOT WORKING PRINCIPLES
  283.                 -------------------------------
  284.  
  285.           The plotter  simulation consists  in  interpreting  plotter
  286.         instructions contained  in a  disk file.   The SPLOT  program
  287.         reads these instructions from the file and plots them on  the
  288.         screen of the computer in  the same way as the  plotter would
  289.         do  on  paper.  The  file  is  plotted  in  the  window which
  290.         represents the plotting paper of the plotter.  The boundaries
  291.         of this window normally correspond to the hard clip limits of
  292.         the plotter (i. e., to the physical limits in which a plotter
  293.         pen  can  move  for  the  selected  paper  size). If the ZOOM
  294.         function is used,  the chosen plotting  area is displayed  in
  295.         this window.
  296.  
  297.  
  298.  
  299.                 4. WORKING WITH THE PROGRAM
  300.                 ---------------------------
  301.  
  302.           The SPLOT program can be  operated using the keyboard or  a
  303.         mouse. From the keyboard the program is operated by  pressing
  304.         the keys the list of which is given in chapters 4.2 and  4.3.
  305.         If you have a mouse installed, its cursor will appear on  the
  306.         screen.  The shape of the cursor is a cross which appears  in
  307.         the plotting  area (paper)  (see chapter  4.1), outside  this
  308.         area it is a rectangle of  one letter size.  The function  of
  309.     this cursor is to choose, activate and change items displayed
  310.         visually. You can make a  choice by moving the cursor  on the
  311.         selected item  and by  pressing any  button of  the mouse. At
  312.         this moment a  tick off character  appears on the  cursor and
  313.         only after releasing the pressed button the action associated
  314.     with the selected item is  realized. If you choose from  more
  315.         items in the menu (e.g., choosing a file to be plotted),  you
  316.         have to make a double  click since the first pressing  serves
  317.         to highlighting an item.
  318.  
  319.           The program can perform plotting the chosen file on one  of
  320.         two pages, they are called "a small view" and "a large  view"
  321.         here.
  322.  
  323.           A small view is used for setting the chosen parameters  and
  324.         selecting  the  file  to  be  plotted.  The  file can be also
  325.         plotted in a small area.
  326.  
  327.           The choice of the file to be plotted can be made either  by
  328.         entering its name  or by choosing  it from the  menu. In this
  329.         menu there are all the files of the given directory with  the
  330.         extension  .PLT  displayed  and   there  are  also  all   the
  331.         subdirectories the contents of which can be displayed  simply
  332.         by choosing a subdirectory from the menu. Any file group  can
  333.         be displayed also  by means of  the wildcards *  and ? (e.g.,
  334.         '*.*' will display all the files in the given directory).  As
  335.         soon as the file to be plotted is chosen, its plotting starts
  336.         on  the  page that is set up  by the F1 key (A SMALL VIEW  or
  337.         A LARGE VIEW).
  338.  
  339.           Plotting the file can be  stopped by pressing the keys  F1,
  340.         Esc, Ctrl-C or  Ctrl-Break at any  time. If the  plotting was
  341.         performed in a large view, after finishing plotting you  will
  342.         stay on the page of a large view.
  343.  
  344.           Returning from the large view page can be performed by  the
  345.         F1 key.
  346.  
  347.  
  348.  
  349.         4.1 ZOOMING
  350.                 -----------
  351.  
  352.           With the cursor run by the mouse or the keyboard resp., you
  353.     can make and enlarge the chosen cuts of the plotted area. The
  354.         control of the cursor is realized by the mouse control or  by
  355.         pressing the appropriate keyboard keys.
  356.  
  357.           There are two possible zoom modes named SLACK and EXACT.
  358.           In the SLACK mode the aspect ratio of the displayed cut  is
  359.         identical to the aspect  ratio of the original  plotting area
  360.         regardless of the aspect ratio of the selected cut. To ensure
  361.         proportional aspect ratio of  the displayed cut in  the SLACK
  362.         mode the  size of  the displayed  cut area  is usually larger
  363.         than the size of the selected cut area.
  364.           In the EXACT mode the aspect ratio of the displayed cut  is
  365.         exactly identical to  the aspect ratio  of the selected  cut.
  366.         To ensure proportional aspect  ratio of the displayed  cut in
  367.         the EXACT mode the screen plotting area is usually reduced.
  368.           You can set the default zoom mode in the OPTIONS menu  (see
  369.         chapter 6). However you  can apply the opposite  mode without
  370.         this setting (see below).
  371.  
  372.  
  373.       The movement of  the cross cursor  in the plotting  area is
  374.         realized by the mouse movement or by pressing the  Ctrl+arrow
  375.         keys (or plain  arrow keys in  large view).   By pressing any
  376.         mouse button or the Ins(ert) key when the cross cursor is  in
  377.     the plotting area you define first corner of the zooming box.
  378.         The next  mouse movement  or the  pressing of  the arrow  (or
  379.     Ctrl+arrow) keys expands and contracts the zooming box around
  380.         the area you desire to expand. If the Scroll Lock is switched
  381.         on or  the Shift  key is  pressed, or  if you  press the left
  382.         mouse button with the right mouse button simultaneously,  the
  383.         box moves as a whole.  By pressing the right mouse  button or
  384.     by pressing  the Enter  key you  can start  zooming. Starting
  385.     zooming with the Ctrl key depressed selects the opposite zoom
  386.         mode to  the default  (i.e., when  the default  zoom mode  is
  387.     SLACK  (EXACT),  you  must  press  Ctrl+right mouse button or
  388.     Ctrl+Enter key to perform zooming in EXACT (SLACK) mode). The
  389.         left button or  the Esc key  or the Ins(ert)  key cancels the
  390.         box cursor mode and  you get back to  the mode of the  simple
  391.         movement of the cross cursor.
  392.  
  393.       To expand the picture into the original size press the  Tab
  394.         key or  press both  the mouse  buttons simultaneously  in the
  395.         cross cursor mode.
  396.  
  397.           If you have a  three button mouse with  appropriate driver,
  398.         pressing the  middle mouse  button is  equivalent to pressing
  399.         the right and left buttons simultaneously.
  400.  
  401.           Note  that  in  the  small  view  the  Enter and arrow keys
  402.         normally serve  for control  of the  file menu  and the  edit
  403.     line. However in  the mode of  defining the zooming  box they
  404.         serve for this operation.
  405.  
  406.  
  407.  
  408.                 4.2  LIST OF KEYS IN "A SMALL VIEW"
  409.                 -----------------------------------
  410.  
  411.         F1 - It selects "A SMALL VIEW" or "A LARGE VIEW" for plotting
  412.              the file.
  413.  
  414.         F2 - The choice of a disk.
  415.  
  416.         F3 - It replots the selected file in the given picture box.
  417.  
  418.         F4 - The choice of parameters. In the menu initiated by  this
  419.              key it  is possible  to set  various program  parameters
  420.              concerning  also  exporting  a  picture to the supported
  421.              formats. See chapter 6 for more details.
  422.  
  423.         F5 - It changes the paper size according to the plotter  type
  424.              and the selected paper norm.
  425.  
  426.         Alt_F5 -  It switches  among the  paper norms (ISO,ANSI,ARCH)
  427.              defining the paper size according to the plotter type.
  428.  
  429.         Ctrl_F5, Alt_E - It switches  the EXPAND mode on and  off (on
  430.              condition it is supported for the given plotter type).
  431.  
  432.     F6 - In the ROLAND plotter version it switches between  RD-GL
  433.          and   DXY-GL   command   mode   (Note: the  RD-GL syntax
  434.              corresponds with the HP-GL syntax). In some versions  it
  435.              makes  a  choice  of  the  plotter  type (e.g. in the HP
  436.              DraftPro   version   it   switches   among   the   types
  437.              7570A/7575A/7576A). In the version for HP 7440A ColorPro
  438.              it switches on  or off the  simulation of the  HP 17440A
  439.              graphics enhancement cartridge.
  440.  
  441.         Alt_F6,Alt_U - In the  ROLAND plotter version in  DXY-GL mode
  442.              it changes the  plotter unit size  from 0.1 mm  to 0.025
  443.              mm.  In RD-GL mode  or HP-GL mode the plotter  unit size
  444.              is always 0.025 mm.
  445.  
  446.         Alt_F7, Alt_F - In the  ROLAND plotter version the choice  of
  447.              an initial font (the font set up after switching on  the
  448.              plotter or after its initialization).
  449.  
  450.         F7 - It switches on or off a multilingual TEXT filter in  the
  451.              LB command of HP-GL mode (or in the P command of  DXY-GL
  452.              mode  of  the  ROLAND  plotter).  See chapter 7 for more
  453.          detailed information.
  454.  
  455.         F8 - It activates  the export  of the  displayed part of  the
  456.              HP-GL or DXY-GL  file to alternative  formats (including
  457.              printing).  See chapter 5 for more details.
  458.  
  459.         F9 - It switches  on or  off the  tracing of  the  individual
  460.              plotter commands during plotting  the file. It is  valid
  461.              only  for  "A  LARGE  VIEW".  First  every  command   is
  462.              executed,  then  it  is  displayed  in  the  information
  463.              window.  The  next  command  is  executed after pressing
  464.              Enter  or  F7.  In  this  mode  the  S key or the F8 key
  465.              switches on and off automatic tracing.
  466.  
  467.         F10 - It stops  the program.  The program  can be stopped  by
  468.              using the F10 key practically at any moment.
  469.  
  470.         Alt_1 - Alt_0 - The identification of pens. See chapter 9 for
  471.              more details.
  472.  
  473.     Alt_P - The information about assigning colors to pens.
  474.  
  475.         Alt_S - It saves the  selected palette of colors assigned  to
  476.              individual pens to be registered in the setup file.
  477.  
  478.         Alt_R - It restores the original palette unless the saving of
  479.              the palette has been already done.
  480.  
  481.         Alt_I - The initialization of graphics mode (it can be  used,
  482.              e.g., if the screen graphics mode is damaged -  possibly
  483.              by a popup resident program).
  484.  
  485.         Alt_V -
  486.         Alt_F10 - Video configuration. More details in chapter 8.
  487.  
  488.  
  489.  
  490.                 4.3  LIST OF KEYS IN "A LARGE VIEW"
  491.                 -----------------------------------
  492.  
  493.     F3, F4, F8, F9, F10,
  494.         Alt_F10, Alt_V
  495.         Alt_P, Alt_S, Alt_R, Alt_I - See "A SMALL VIEW".
  496.  
  497.     F1 - The return to the page of "A SMALL VIEW".
  498.  
  499.     F2 - Opens a file selection dialog. Pressing F2 in this
  500.          dialog opens a drive selection dialog.
  501.  
  502.         1 - 0
  503.         Alt_1 - Alt_0 - See the identification of pens (chapter 9).
  504.  
  505.         F5 - Inserting a text  into the picture and the  manipulation
  506.              with it (see chapter 7 for more detailed information).
  507.  
  508.     Page_Up, Page_Dn - It switches between informative pages.  On
  509.                  the  first  page  there  is  the  size  of a plotted
  510.                  picture box expressed  in mm units.   On the  second
  511.                  page there is the  position in the plotted  file and
  512.                  the  position  of  the  cursor  in the plotting area
  513.                  expressed in plotter units. On both the pages  there
  514.                  are  the  most  important  parameters describing the
  515.                  state of the plotter.
  516.  
  517.  
  518.  
  519.                 5. EXPORT
  520.                 ---------
  521.  
  522.           The SPLOT program  enables to export  a plotted picture  to
  523.         the following formats:
  524.  
  525.                 - HP-GL
  526.                 - DXY-GL (ROLAND)
  527.                 - PLOTCALL
  528.                 - DXF (AutoCAD)
  529.                 - POSTSCRIPT (color)
  530.                 -----------------
  531.                 - IBM Graphics (IBM 9 pin printer)
  532.                 - IBM X24 (IBM 24 pin printer)
  533.                 - EPSON LX
  534.                 - EPSON EX/FX (color)
  535.                 - EPSON LQ (color)
  536.         - NEC 24 pin (color)
  537.                 - HP LaserJet
  538.                 - HP DeskJet (color)
  539.                 - HP PaintJet (color)
  540.                 - HP QuietJet
  541.                 - HP ThinkJet (HP mode)
  542.  
  543.           The HP-GL format executes  the export of a  plotted picture
  544.         to the HP-GL  plotter. It can  be employed, for  example, for
  545.         plotting a picture  cut on the  plotter, for the  output of a
  546.         multilingual text on the plotter (see chapter 7), or in  case
  547.         your  plotter  does  not  support  all  the  HP-GL   commands
  548.         supported  by   the  SPLOT   program.   The   last  case   is
  549.         characteristic especially  of the  situation you  own the  HP
  550.         ColorPro  7440A  plotter  and  you  have  not  the additional
  551.         graphics enhancement cartridge HP 17440A.
  552.  
  553.           The DXY-GL format realizes the  export of a picture to  the
  554.         DXY plotter (usually the ROLAND plotter).
  555.  
  556.       The PLOTCALL  format is  used in  the GoldenSoftware's PLOT
  557.         program which  supports a  wide range  of peripheral  devices
  558.         (printers, plotters).
  559.  
  560.           The DXF format converts a  picture to a form applicable  by
  561.         the AutoCAD program. From AutoCAD you can read this DXF  file
  562.         via the DXFIN command. The exported picture is written in the
  563.         form  of  LINES  where  each  pen  of the plotter has its own
  564.         LAYER. Pen  1 has  a layer  with the  name PEN1,  pen 2 has a
  565.         layer with the name PEN2, etc.
  566.  
  567.           The PostScript format can be used by any peripheral  device
  568.         which  has  implemented   PostScript  interpreter  (such   as
  569.         PostScript printer).
  570.  
  571.           The function of the other formats is to export a picture to
  572.         the corresponding peripheral devices - printers. The  (color)
  573.         word  indicates  a  possibility  of  color  printing  for the
  574.         appropriate format. Naturally, all formats can be used on all
  575.         printers compatible with these ones.
  576.  
  577.           The picture  can be  exported either  to the  disk file  or
  578.         directly to the corresponding peripheral device (a plotter, a
  579.         printer).  If  your  peripheral  device  is  connected to the
  580.         parallel interface, use PRN or LPT1 resp., LPT2, etc. as  the
  581.         output file. If it is connected to the serial interface,  use
  582.         COM1  or  COM2  respectively.  Set  the  parameters  of   the
  583.         corresponding serial interface by  the DOS MODE command  with
  584.         the parameter "p" beforehand, like this:
  585.  
  586.              MODE COM1:9600,,,,p
  587.  
  588.       If  you  export  a  picture  to  a disk file, which is less
  589.     time-consuming, you can use  the enclosed  programs BPLOT  or
  590.     BPRINT resp.,  for exporting  this file  to the corresponding
  591.     peripheral device  (in the  registered version  only).  These
  592.     programs  perform  exporting  files  to  the chosen serial or
  593.     parallel interface, on the time background.  Please,  realize
  594.     that it  is not  possible to  use the  DOS PRINT  command for
  595.     exporting binary files  (the files containing  graphics data)
  596.     to the printer.
  597.  
  598.       The export of the picture is started with the F8 key. In the
  599.     EXPORT menu you can specify:
  600.        - an exporting format,
  601.        - the size of the resultant picture,
  602.        - resolution (the size of a plotter unit) - in the case of
  603.          the DXY-GL export only,
  604.        - print density - if exporting to the printer,
  605.        - the output file name.
  606.  
  607.       You can choose from the following export sizes:
  608.        - ZOOM size,
  609.        - ORIGINAL size,
  610.        - A3, A4 or A5 size,
  611.        - USER size.
  612.  
  613.       The ZOOM size is offered only if a zoom cut is exported. It
  614.     is exactly identical  to the original  size of the  displayed
  615.     cut (1:1 scaling).  When  the   HP-GL  or  DXY-GL  export  is
  616.     performed it is possible to  keep  the original position   of
  617.     the selected   cut (note  that the  optional left  and bottom
  618.     margins are added  to this  position  too  -  for  specifying
  619.     the  left and bottom margins see  chapter 6).  This way   you
  620.     can  make  an HP-GL  or DXY-GL picture  which  contains  more
  621.     selected cuts positioned as on original picture.
  622.  
  623.       The ORIGINAL size is the whole size of the selected plotter
  624.     paper size (as defined by the F5, Alt_F5 or Ctrl_F5 keys). If
  625.     you use  this size  for exporting  the original  (non-zoomed)
  626.     image, you ensure the 1:1 scale for that export.
  627.  
  628.       The A3, A4 and A5 sizes are the predefined sizes.
  629.  
  630.           To  ensure  proportional  aspect  ratio  of  the  resultant
  631.         picture for ORIGINAL, A3, A4 and A5 sizes, only the one  side
  632.         from  selected  size  is  used.  This  determinant  side   is
  633.         displayed in bright color. The other side is counted so  that
  634.         the resultant picture would be proportional.  By default  the
  635.         choice  of  the  determinant  side  is  performed so that the
  636.         resultant size  lies entirely  within the  selected size. You
  637.         can override this by selecting the other determinant side. To
  638.         do this click  on the non-bright  side item or  press the Tab
  639.         key.
  640.  
  641.       The USER size serves for setting of the user defined  size.
  642.     If you set your  own size of the  output format, you have  to
  643.     give  only  the  size  of  the  one  side , the other side is
  644.     counted automatically so that the resultant picture would  be
  645.     proportional. Use the Tab key  or mouse control to switch  to
  646.     the editing of the desired side.
  647.  
  648.       The size is  given in cm  units or inch  units according to
  649.     the choice  from the  OPTIONS menu  (see chapter  6). The DXF
  650.     format is an exception -  here the output size is  understood
  651.     in units to be defined in AutoCAD.
  652.  
  653.       The  chosen  size  corresponds  with  the  real size of the
  654.     resultant picture realized by  exporting. It is necessary  to
  655.     consider it as the maximum  limits into which a picture  seen
  656.     in   the   program   plotting   area   can   be   transformed
  657.     proportionally. Therefore, for example, if you choose A4 size
  658.     paper  as  the  output  size  for  printing and if you have a
  659.         printer  of  the  same  size,  you  will reach a satisfactory
  660.         result only if you choose the LANDSCAPE orientation. For  the
  661.         PORTRAIT orientation it is necessary to choose the maximum A5
  662.         size for the  output so that  the resultant picture  could be
  663.         positioned on A4 size paper.
  664.  
  665.           The other parameters influencing the look of the  resultant
  666.         picture  can  be  set  in  the  menu activated by F4 key (see
  667.         chapter 6).
  668.  
  669.  
  670.  
  671.         6. OPTIONS
  672.         ----------
  673.  
  674.     With the menu activated by the F4 key it is possible to set:
  675.  
  676.     1. DEFAULT EXTENSIONS - this item sets default extensions
  677.          of the following file types:
  678.        1.1 PLOT FILES - the files given in the menu of files from
  679.          which  the  files  for  plotting  are  selected. For
  680.          example, if this extension is PLT, the displaying of
  681.          all  the  files  with  the  PLT  extension  will  be
  682.          standard. If this extension is *, the displaying  of
  683.          all the files will be standard.
  684.        1.2 HP-GL EXPORT -
  685.        1.3 DXY-GL EXPORT -
  686.        1.4 PLOTCALL EXPORT -
  687.        1.5 DXF EXPORT  -
  688.        1.6 POSTSCRIPT EXPORT -  sets standard  extensions  of the
  689.          output files according to  the  type of  export. The
  690.                  name of the output file is composed of the base part
  691.                  derived from the name of  the exported file +   this
  692.                  standard extension.  However, the  file name  of the
  693.                  output file can be  changed before the beginning  of
  694.          any export.
  695.            1.7 PRINT - sets  standard extensions of the  output files
  696.                  during  exporting  a  picture  designated  for   the
  697.                  printer.
  698.        1.8 TEXT - sets the standard extension of the output  file
  699.          determined for storing texts on the disk.
  700.  
  701.         2. SORT ORDER FOR FILES - the choice of order in which  files
  702.                  are displayed. The sorting can be done by the  NAME,
  703.                  EXTENSION or SIZE.
  704.  
  705.     3. BACKGROUND - switches between NORMAL  and BRIGHT intensity
  706.          of background white color  of plotting area  (paper)
  707.          (in color modes only).
  708.  
  709.     4. VIDEO SETUP - more detailed information in chapter 8.
  710.  
  711.     5. SOUND - switches on and off sound signals.
  712.  
  713.     6. DEFAULT ZOOM - sets the default zoom mode as SLACK or
  714.         EXACT (see chapter 4.1 for details).
  715.  
  716.     7. PEN WIDTHS  -   this  menu  item  enables  you  to  manage
  717.         a variable  pen widths feature  provided by the SPLOT
  718.         program:
  719.       7.1 SET PEN WIDTHS -  It  determines  the line  width   for
  720.         individual  pens.  By  default  the  line  width   is
  721.         determined  by  the  PT  (pen thickness) instruction.
  722.         The   line   width   is   controlled   by  the  HP-GL
  723.         instructions and   will  vary   according  to   value
  724.         issued  in  PT  instruction.  However note that  each
  725.         SP (select pen) instruction  resets  the  PT  to  its
  726.         default  value (mostly 0.3 mm).
  727.         The other way is to set the line width to fixed  user
  728.         defined value.  Unlike the  other measurement  values
  729.         the line width is expressed in millimeters (mm).
  730.       7.2 USE ON SCREEN - Check  this  option if you want  to use
  731.         variable pen widths for screen drawing.
  732.       7.3 USE ON PRINTER - Check  this option if you want to  use
  733.         variable  pen  widths  for  printing  and  PostScript
  734.         exporting (the variable pen widths are not  supported
  735.         for HP-GL, DXY-GL, PLOTCALL and AutoCAD exports).
  736.       7.4 ON PRINTER -  Select here  a mode  for use  of the  pen
  737.         widths when printing. It can be:
  738.         Absolute  -  a  real  printed  line  width  will   be
  739.                absolutely  equal  to  the  specified  pen
  740.                width.
  741.         Relative - a real printed line width will be computed
  742.                from the specified pen width relatively to
  743.                the  original  plotter  page  size (or its
  744.                printed cut).
  745.         Only  checking  of  the  relative  mode  can   ensure
  746.         printing in  the WYSIWYG  style. However  by checking
  747.         the absolute mode  along with PT  width type for  all
  748.         pens you get a native plotter simulation.
  749.         Note  that  on  screen  the  pen  widths  are  always
  750.         displayed in relative mode.
  751.       7.5 ZOOM PEN WIDTHS  -  Check  this option  if you  want to
  752.         enlarge the pen widths  along with enlarging an image 
  753.         cut (see the ZOOMING section).
  754.  
  755.  
  756.     8. TEMPORARY  PATH -  this menu  item sets  the directory  in
  757.            which  the  SPLOT  program  will  create its auxiliary
  758.            files  in  some  types  of  picture  exporting. If the
  759.            picture   exporting   stops   with  an  error  message
  760.            "DISK FULL", it means,  that there  is not  sufficient
  761.            disk space for the  created output or auxiliary  file.
  762.            In the latter  case you can  try to set  the temporary
  763.            directory to another disk.  You can choose from  three
  764.            possibilities:
  765.        8.1 The directory defined by the environment variable  TMP
  766.            by means of the DOS SET command (e.g., SET TMP=D:\).
  767.        8.2 The directory defined by the environment variable TEMP.
  768.        8.3 A current work directory i.e., the directory given  on
  769.            the  information  board  of  the  program  in "a small
  770.            view".
  771.  
  772.     9. USED UNITS  - it defines  units used for  setting the size
  773.         and distances during picture exporting. The units may
  774.         be given in cm (centimeters) or inch (inches).
  775.  
  776.     A. Parameters for the HP-GL EXPORT :
  777.       A.1 OUTPUT FORMAT can be like this:
  778.          a) NORMAL - every HP-GL  command is given on a  separate
  779.              line and it is ended with a character ";".
  780.          b) PACKED - all the HP-GL  commands follow closely   one
  781.              after  another  without  any separators. The
  782.              number of uses of PU and PD instructions  is
  783.              minimized.
  784.       A.2 ORIGIN IN CENTER - Activate this parameter only if  the
  785.         resultant HP-GL file is designated for the plotter in
  786.         which the origin of the coordinate system is situated
  787.         in the center of the plotting area (it is usual  with
  788.         large paper size  plotters,  e.g. HP  DraftPro or  HP
  789.         DraftMaster).
  790.       A.3 PEN --> PEN - by  means of this item it is  possible to
  791.         assign each  pen on  the input  a pen  on the output.
  792.         Thus  it  is  possible,  for  example, to convert the
  793.         picture that uses more pens to a single colored  one,
  794.         or it is  possible to exclude  using some pen (if you
  795.         assign PEN 0 as the output pen to it).
  796.       A.4 PEN OPTIMIZATION - if ON, the number of the grasping of
  797.         pens when the picture is exported will be  optimized.
  798.         This means that when the resultant  picture is  being
  799.         drawn, each pen is grasped only once.
  800.       A.5 PEN ORDER - specifies the sequence of pens according to
  801.         which the optimized picture will be drawn.
  802.       A.6 LEFT MARGIN -  specifies   the offset of  the  exported
  803.         picture from the left margin - it is on the X axis  -
  804.         it can also be a negative number.
  805.       A.7 BOTTOM MARGIN - specifies the  offset of the   exported
  806.         picture from the bottom margin - it is on the Y  axis
  807.         - it can also be a negative number.
  808.       A.8 PG AT END - specifies if the PG (Page Feed) instruction
  809.         will be attached to the end of the output file.
  810.  
  811.     B. Parameters for the DXY-GL EXPORT:
  812.       B.1 OUTPUT FORMAT can be like this:
  813.           a) NORMAL - every DXY-GL command is given on a separate
  814.               line.
  815.           b) PACKED - all the DXY-GL commands follow closely  one
  816.               after another  without any  separators. The
  817.               number of uses of  M and D instructions  is
  818.               minimized.
  819.       B.2 ORIGIN IN CENTER - activate this parameter only if  the
  820.         resultant DXY-GL file  is designated for  the plotter
  821.         whose origin of the  originate system is situated  in
  822.         the center of the plotting area.
  823.       B.3 PEN --> PEN - see the HP-GL export.
  824.       B.4 PEN OPTIMIZATION - see the HP-GL export.
  825.       B.5 PEN ORDER - see the HP-GL export.
  826.       B.6 LEFT MARGIN - see the HP-GL export.
  827.       B.7 BOTTOM MARGIN - see the HP-GL export.
  828.  
  829.     C. Parameters for the PLOTCALL EXPORT:
  830.       C.1 NUMBER OF DECIMAL DIGITS - It determines the number  of
  831.         figures  written  after  the  decimal  point  at  the
  832.         numbers on the output.
  833.       C.2 PEN --> PEN  - see the HP-GL export.
  834.       C.3 LEFT MARGIN - see the HP-GL export.
  835.       C.4 BOTTOM MARGIN - see the HP-GL export.
  836.  
  837.     D. Parameters for the DXF EXPORT:
  838.       D.1 NUMBER OF DECIMAL DIGITS - see the PLOTCALL export.
  839.       D.2 PEN --> PEN  - see the HP-GL export.
  840.       D.3 LEFT MARGIN - see the HP-GL export.
  841.       D.4 BOTTOM MARGIN - see the HP-GL export.
  842.  
  843.     E. Parameters for the POSTSCRIPT EXPORT:
  844.       E.1 PEN --> COLOR -  It assigns  the  output color to
  845.         individual pens for the color PostScript export.
  846.       E.2 90 DEGREES ROTATION - It determines the orientation of
  847.         an exported picture.
  848.       E.3 LEFT MARGIN - specifies   the offset of  the   exported
  849.         picture from the left margin - it is on the X axis  -
  850.         it can also be a negative number.
  851.       E.4  BOTTOM/TOP MARGIN  -  specifies  the   offset  of  the
  852.         exported picture from the bottom margin (when the  90
  853.         degrees  rotation  is  suppressed)  or  from  the top
  854.         margin (when the 90  degrees rotation is demanded)  -
  855.         it is  on the  Y   axis -  it can  also be a negative
  856.         number.
  857.  
  858.  
  859.     F. ALL PRINTERS - It sets   up various  parameters valid  for
  860.         printing on all kinds of printers:
  861.       F.1 ORIENTATION -   It  determines  the  orientation  of  a
  862.         printed  picture on the paper.  It may be either  the
  863.         LANDSCAPE orientation (breadthwise)  or  the PORTRAIT
  864.         orientation (heightwise).
  865.       F.2 FRAME - It  determines if  a printed  picture is  to be
  866.         situated in the frame limiting the plotted area.
  867.       F.3 PEN FOR A FRAME - It determines  the number of the  pen
  868.         with which the frame  will be drawn. Its  function is
  869.         important for color printers, where the color of  the
  870.         frame is determined by assigning PEN --> COLOR.   The
  871.         frame is drawn always with a thin line regardless  of
  872.         the current pen widths settings.
  873.       F.4 PAGE BREAK AT END - specifies  if the page break  (form
  874.         feed) command  will be  attached  to the end  of  the
  875.         output file.
  876.       F.5 LEFT MARGIN - specifies the distance from the left stop
  877.         of  the  printhead  to  the  start  printing position
  878.         independently of the orientation.
  879.       F.6 TOP MARGIN - specifies the size of shift of the printer
  880.         platen before starting printing independently of  the
  881.         orientation.
  882.          The  LEFT MARGIN  and  TOP MARGIN  parameters  enable to
  883.          place the printed picture in any place on the paper.  At
  884.          laser printers which have neither printheads nor platens
  885.          in a classic  sense of word,  the terms LEFT  MARGIN and
  886.          TOP MARGIN always  relate to the  paper oriented in  the
  887.          vertical   position   independently   of   the   picture
  888.          orientation on the paper.
  889.  
  890.     G.  DOT MATRIX PRINTERS -  In  this  item it is  possible  to
  891.         increase the  number of  the printhead  passes during
  892.         printing.  It can be used for emphasizing printing or
  893.         when the ribbon is written up.
  894.  
  895.     H. Parameters for IBM X24 - it sets parameters for the IBM
  896.           24 pin printers:
  897.       H.1 OUTPUT FORMAT can be like this:
  898.           a) NORMAL - without use of relative shift instructions.
  899.           b) PACKED - the instructions for the relative shift  of
  900.               the  printhead  are  used  for reducing the
  901.               output  code  size.
  902.       H.2 PANASONIC X24 - switches on and off Panasonic X24  mode
  903.          in which is used a different format for selecting  a
  904.          base line feed unit. This format is not strictly IBM
  905.          compatible and should be used with Panasonic 24  pin
  906.          printers in X24 mode.
  907.  
  908.     I. Parameters for EPSON - it sets parameters for the EPSON
  909.           printers:
  910.       I.1 OUTPUT FORMAT can be like this:
  911.           a) NORMAL - without use of relative shift instructions.
  912.           b) PACKED - the instructions for the relative shift  of
  913.               the  printhead  are  used  for reducing the
  914.               output  code  size  (not  used for EPSON LX
  915.               printers), but on  some older types  it may
  916.               cause substantial reducing print rate.
  917.       I.2 PEN --> COLOR  - It   assigns   the  output  color   to
  918.         individual pens  on the  color printers  of the EPSON
  919.         EX/LQ type. It is possible to choose from a fixed set
  920.         of 7 colors.
  921.  
  922.     J. Parameters for NEC 24 - it sets parameters for the NEC 24
  923.           pin printers:
  924.       J.1 OUTPUT FORMAT can be like this:
  925.           a) NORMAL - without use of relative shift instructions.
  926.           b) PACKED - the instructions for the relative shift  of
  927.               the  printhead  are  used  for reducing the
  928.               output  code  size.
  929.       J.2 PEN --> COLOR  - It   assigns   the  output  color   to
  930.         individual pens on the NEC 24 pin color printers.  It
  931.         is possible to choose from a fixed set of 8 colors.
  932.  
  933.     K. Parameters for HP LaserJet - it sets parameters for the HP
  934.         LaserJet printers:
  935.       K.1 OUTPUT FORMAT can be like this:
  936.           a) NORMAL - no special coding used.
  937.           b) PACKED - special  coding   is used for  reducing the
  938.               output code size. This coding is NOT a
  939.               standard feature of the HP LaserJet and
  940.               compatible printers and you must be sure
  941.               that your laser printer support this (it
  942.               must support ESC*b1M instruction - I have
  943.               tested this on the HP LaserJet IIIp model).
  944.  
  945.     L. Parameters for HP DeskJet - it sets parameters for  the HP
  946.         DeskJet printers:
  947.       L.1 OUTPUT FORMAT can be like this:
  948.           a) NORMAL - no special coding used.
  949.           b) PACKED - special  coding   is used for  reducing the
  950.               output code size. This coding is a standard
  951.               feature of the HP DeskJet printers.
  952.       L.2 PEN --> COLOR -  It  assigns   the   output   color  to
  953.         individual pens for color printing on the  HP DeskJet
  954.         printer. It is possible to choose from a fixed set of
  955.         7 colors.
  956.  
  957.  
  958.     M. Parameters for HP PaintJet - it sets parameters for the HP
  959.         PaintJet  printers:
  960.       M.1 OUTPUT FORMAT can be like this:
  961.           a) NORMAL - no special coding used.
  962.           b) PACKED - special  coding   is used for  reducing the
  963.               output code size. This coding is a standard
  964.               feature of the HP PaintJet printers.
  965.       M.2 PEN --> COLOR -  It  assigns   the   output   color  to
  966.         individual pens for color printing on the HP PaintJet
  967.         printer.  It  is  possible  to  choose  from  a fixed
  968.         (standard) or variable (extended) set of colors. Both
  969.         color sets have 7 colors.  The extended color set can
  970.         be redefined by user from offer of 17 colors.
  971.       M.3 COLOR SET  -   switches  between standard and  extended
  972.         color  set.  The  selected  color  set  is  used  for
  973.         defining assignment PEN --> COLOR.
  974.       M.4 EXTENDED COLOR SET - It is used  for setting individual
  975.         colors in the  extended color set.   If the  extended
  976.         color set is  selected as used  color set, then  if a
  977.         color  in  this  set  is  changed,  the corresponding
  978.         assignment  PEN --> COLOR  is changed  automatically.
  979.       M.5 MEDIA TYPE -  It selects  output media type -  paper or
  980.         foil.
  981.  
  982.  
  983.     N. TEXT FILTER  - It switches on or off  a multilingual  TEXT
  984.         filter in the LB command  of HP-GL mode (or in  the P
  985.         command of  DXY-GL mode  of the  ROLAND plotter). See
  986.         chapter 7 for more detailed information.
  987.  
  988.     O. CODE PAGE SELECTION  -  It  sets a  code page  for a  text
  989.         filter (see chapter 7).  The code page can  look like
  990.         this:
  991.         - United States
  992.         - German
  993.         - Multilingual
  994.         - Portugal
  995.         - Canada - French
  996.         - Norway
  997.  
  998.  
  999.  
  1000.         7. INSERTING TEXTS INTO PICTURES
  1001.                 --------------------------------
  1002.  
  1003.           The SPLOT program is able to process a multilingual text in
  1004.         your HP-GL (or DXY-GL) files. As known, plotters receive only
  1005.         the ASCII characters in the range of 0 to 127.  Therefore, if
  1006.         the instruction for the output of the text (LB at HP-GL and P
  1007.         at DXY-GL resp.) contains the ASCII characters with the value
  1008.         higher  than  127,  the  plotter  will  not draw them or will
  1009.         ignore  the  highest  bit  of  characters  and  will draw the
  1010.         corresponding characters  from the  lower half  of the  ASCII
  1011.         table.  For  example, if you  use the following  statement in
  1012.         GW-BASIC (handle #1 represents the plotter),
  1013.  
  1014.             PRINT #1, "LBGröße";CHR$(3)
  1015.  
  1016.         the plotter will draw only the text
  1017.  
  1018.             Gre  or  Grae  respectively.
  1019.  
  1020.         If you want to draw the  text correctly, you have to use  the
  1021.        following statements, e.g.:
  1022.  
  1023.             PRINT #1, "CS0;CA33;SS;LBGr";CHR$(3)
  1024.             PRINT #1, "SA;LB|~";CHR$(3)
  1025.             PRINT #1, "SS;LBe;CHR$(3)
  1026.  
  1027.         However,  e.g.,  if  you  own  the  HP ColorPro 7440A plotter
  1028.         without an  additional HP  17440A graphics cartridge, it will
  1029.         not help you either.
  1030.  
  1031.         The  above  mentioned  example  concerns  the use of a German
  1032.         text,  but  similar  problems  occur  also in other languages
  1033.         which use  the ASCII  characters from  the upper  half of the
  1034.         table.
  1035.  
  1036.         Therefore, the SPLOT program offers the TEXT FILTER  function
  1037.         with the  F7 key.  If you  switch on  this function,  all the
  1038.         ASCII  characters  from  the  value  of  128  to  175  and  ß
  1039.         character will be plotted according to the selected code page
  1040.         (see chapter 6).  And  it does not matter what  character set
  1041.         of  the  plotter  is  just  set.  This will enable  to  write
  1042.         multilingual  texts  in  your  HP-GL  (DXY-GL) files directly
  1043.         without complicated  switching of  character sets.  The HP-GL
  1044.         (DXY-GL) file created in this  way must be exported to  a new
  1045.         HP-GL (DXY-GL)  form through  the HP-GL  (DXY-GL) export (see
  1046.         chapter 5) with the TEXT filter switched on, and only such  a
  1047.         newly originated file can be drawn on the plotter.
  1048.  
  1049.         To demonstrate  using this   method of  writing  multilingual
  1050.         texts  we   recommend  you   to  study   over  the   enclosed
  1051.         demonstration file ASCII.PLT and display it at first with the
  1052.         TEXT filter being switched off and then on.
  1053.  
  1054.  
  1055.  
  1056.           Another function which the SPLOT program can offer for your
  1057.         work  with  the  HP-GL  text   is  the  function  of   direct
  1058.         (interactive) inserting texts into a picture. To do it, it is
  1059.         necessary to define its  position (XY), size (SI),  direction
  1060.         (DI), slant (SL), the character set number (CS), the selected
  1061.         pen (SP) and, naturally, the text itself.
  1062.  
  1063.           By means of the menu activated by the F5 key on the page of
  1064.         a  large  view  you  can  choose  the  following   individual
  1065.         functions necessary for the text manipulation :
  1066.  
  1067.          - define a new text item
  1068.          - edit already existing items
  1069.          - read the text items from the disk file
  1070.          - save the text items to the disk file
  1071.  
  1072.           On defining, editing or reading texts the SPLOT program  is
  1073.         brought  into  the  initial  state  which  corresponds   with
  1074.         executing IN;RO;IP;IW; instructions. The user's scale (if  it
  1075.         was set before) and rotation,  if there is any,  is cancelled
  1076.         then. The  position of  the text  is given  in plotter  units
  1077.         absolutely, the size  of the text  is in cm  (SI) absolutely,
  1078.         the direction of the text is also in degrees (DI) absolutely,
  1079.         the slant is  understood as a  tangent of the  required angle
  1080.         (SL).
  1081.  
  1082.           The position of the text and its size can be defined either
  1083.         by setting numeric  values from the  keyboard or by  moving a
  1084.         quadrangle which  demonstrates the  outline of  the text  and
  1085.         which is  controlled by  the mouse  in a  similar way as when
  1086.     making picture cuts (zooming). To do this it is necessary  to
  1087.         move the cursor  of the mouse  to the plotting  area. Then by
  1088.         pressing the  left button  and moving  the mouse  at the same
  1089.         time the position of the text changes, by pressing the  right
  1090.         button and moving the mouse at the same time the size of  the
  1091.         text changes. The other values are set in a numeric form from
  1092.         the keyboard.
  1093.  
  1094.           Of course,  the text  itself can  be written  in a  desired
  1095.         language  with  the  ASCII  characters  >  127.  In the HP-GL
  1096.         (DXY-GL) picture these characters will be displayed according
  1097.         to the  code page  you will  choose in  the OPTIONS menu. The
  1098.         corresponding  support  of  the  national environment must be
  1099.         installed in MS-DOS  (it must support graphics modes) if  you
  1100.         want to have the same characters on the edit line.
  1101.  
  1102.           The  function  of  direct  inserting  a  text  accepts  the
  1103.         following keys :
  1104.  
  1105.           a) when  defining  a  new  text item or correcting  already
  1106.              existing text items:
  1107.  
  1108.                Alt_T - setting the text string for plotting
  1109.  
  1110.                Alt_X - setting the position of the text (X,Y) [pu]
  1111.  
  1112.                Alt_S - setting the size (X,Y) [cm] (i.e. the size  of
  1113.                        one text character)
  1114.  
  1115.                Alt_D - setting the direction of the text [deg]
  1116.  
  1117.                Alt_L - setting the slant of the text
  1118.  
  1119.                Alt_C - setting the character set number
  1120.  
  1121.                Alt_P - setting the  number of a pen for  plotting the
  1122.                        text
  1123.  
  1124.                F1    - finishing  the editing of  the text with   the
  1125.                        changes saved
  1126.  
  1127.                F2    - the redrawing of the edited text
  1128.  
  1129.                F9 or Esc - finishing   the editing  of the text  with
  1130.                            canceling the changes
  1131.  
  1132.           b) when correcting already existing text items :
  1133.  
  1134.                F3 - skip to the correction of the previous text  item
  1135.                     (if it exists)
  1136.  
  1137.                F4 - skip to the correction of the next text item  (if
  1138.                     it exists)
  1139.  
  1140.                F6 - the choice of a text item for correcting (if  you
  1141.                     have defined more than one text item)
  1142.  
  1143.                F8 - the  canceling (erasing  from memory)  of a  text
  1144.                     item according to your choice
  1145.  
  1146.           In this  way it  is possible  to define  any number of text
  1147.         items  that  are  loaded  into  memory  and  after  finishing
  1148.         plotting the respective file they are drawn.
  1149.  
  1150.           It is  supposed that  the set  of the  text items  you have
  1151.         created relates to the plotted file. That is why when  coming
  1152.         to the plotting of  a new file (i.e.  when the plotting of  a
  1153.         file is  activated otherwise  than by  the F3  key or  F8 key
  1154.         resp.), all  the text  items are  always erased  from memory.
  1155.         Before it happens, the program enables to put the text on the
  1156.         disk if you did not do that before.
  1157.  
  1158.         There are two ways how to save the created texts :
  1159.  
  1160.         1) In the  HP-GL (or DXY-GL  resp.) form in  the plotted file
  1161.            (according to the item in the menu in the ORIGINAL  file).
  1162.            Respective commands for plotting the defined text items on
  1163.            the plotter are attached to  the end of the plotted  file.
  1164.            After the texts are saved on the disk in this manner, they
  1165.            are always erased from memory of the program, even if  you
  1166.            do not start plotting a  new file. This is the  final form
  1167.            of storing texts  which you can  use on condition  you are
  1168.            already satisfied with the  created texts and you  want to
  1169.            attach them to the displayed file for ever. If you want to
  1170.            display the texts  together with the  plotted file on  the
  1171.            plotter or on  the printer and  you do not  want to attach
  1172.            the texts to the original file for ever, use directly  the
  1173.            appropriate export format  with the F8  key (as the  texts
  1174.            loaded in the  memory of the  program are also  exported).
  1175.            Then  you  can  put  the  texts  on  the disk in the other
  1176.            described way.
  1177.  
  1178.         2) In a special format in a EXTRA file.  Only the texts saved
  1179.            in such a  way can be  read into the  program memory later
  1180.            again and thus you can continue in their editing.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                 8. VIDEO CONFIGURATION
  1186.                 ----------------------
  1187.  
  1188.           The  SPLOT  program  is  a  graphics  program  requiring  a
  1189.         graphics  card  EGA  or  VGA  and  supporting  the  following
  1190.         graphics modes:
  1191.  
  1192.           1) monochrome mode
  1193.  
  1194.              - EGA 640x350
  1195.  
  1196.           2) 16 color modes
  1197.  
  1198.              - EGA 640x350
  1199.              - VGA 640x380
  1200.              - SUPER EGA 640x480, 640x258, 800x600
  1201.          - SUPER VGA 800x600, 1024x768, 1280x1024
  1202.  
  1203.           The choice  of the  required mode  can be  made in the menu
  1204.         which is initiated by the Alt_F10 key or Alt_V key resp.   In
  1205.         this menu there are the following items :
  1206.  
  1207.          - AUTOMATIC MODE  - is determined  to set up  the video mode
  1208.               automatically according to the type of a video card and
  1209.               according to this it sets up the following modes:
  1210.               - EGA mono 640x350
  1211.               - EGA 16 color 640x350
  1212.               - VGA 16 color 640x480
  1213.  
  1214.          - BIOS MODE - is determined  to set up the mode you  require
  1215.               according  to  the  number  and  resolution.  The  mode
  1216.               numbers together with the appropriate resolution should
  1217.               be given  in the  documentation of  your graphics card.
  1218.               The BIOS  mode   number  is  to   be  set  in   decimal
  1219.               units standardly, if you want to set it in  hexadecimal
  1220.               units, write the H character  at  its end. This  way of
  1221.               setting the video mode is useful if you own an EGA card
  1222.               or  VGA card with high  resolution (SUPER EGA  or  VGA)
  1223.               and  you will  not find it in  the list of SUPER  cards
  1224.               offered  by the SPLOT program.
  1225.  
  1226.       - SUPER VIDEO  CARDS - contains  the lists of  SUPER EGA or
  1227.           VGA  cards  divided  according  to resolution (640x480,
  1228.           640x528, 800x600, 1024x768, 1280x1024).  Even  if  your
  1229.           card is not  in the list,  it is  possible that it will
  1230.           function when you choose  another card of the list.  In
  1231.           the other case you can try to set the  required mode by
  1232.           means of the BIOS MODE item  (except the resolutions of
  1233.           1024x768  and  1280x1024  which  are  highly   hardware
  1234.           dependent).
  1235.           Notice - not all listed SVGA cards have been tested.
  1236.           Only standard VESA video modes are supported (not OEM).
  1237.  
  1238.       - the other items of  the menu contain standard EGA  or VGA
  1239.         modes  in  which  the  SPLOT  program  can work (EGA mono
  1240.             640x350, EGA color 640x350 and VGA color 640x480). It  is
  1241.             possible to set any of  these three modes on VGA,  but on
  1242.             the  EGA  cards  it  is  possible  to  set only EGA modes
  1243.             according to the type  of the connected monitor  (mono or
  1244.             color).
  1245.  
  1246.           - the last item of the menu called `VGA GRAY-SCALE'  serves
  1247.             to  switch  ON/OFF  the  gray-scale  summing on VGA video
  1248.             adapter.  You will need switch ON this option in case you
  1249.             have an VGA video adapter with mono monitor and your  VGA
  1250.             adapter   doesn't   perform   the   gray-scale    summing
  1251.             automatically.   The  gray-scale  summing  enables use of
  1252.             color video modes  along with VGA  mono monitor.   If the
  1253.             gray-scale summing is  active, each color  is transformed
  1254.             to  corresponding  gray  level  and  thus you are able to
  1255.             distinguish  individual  colors  even  when  using a mono
  1256.             monitor.   If the  gray-scale summing  is inactive,  some
  1257.             colors are  undistinguishable on  mono monitor  (e.g., in
  1258.             SPLOT program you may not see some pen colors unless  you
  1259.             change its color value). The `VGA GRAY-SCALE' item is not
  1260.             displayed  if  your  video  adapter  or active video mode
  1261.             doesn't support it.
  1262.  
  1263.  
  1264.  
  1265.                 9. PEN IDENTIFICATION
  1266.                 ---------------------
  1267.  
  1268.           The identification of pens  serves to emphasizing parts  of
  1269.         the picture drawn  with the same  pen and to  informing about
  1270.         the number  of pens  used during  drawing the  given picture.
  1271.         This information is useful namely for the correct loading  of
  1272.         the plotter pens in case you decide to draw the given picture
  1273.         on the plotter.
  1274.  
  1275.           The keys from Alt_1 to Alt_0  in a small view and the  keys
  1276.         from 1 to 0 in a  large view are determined for indicating  a
  1277.         part of the picture drawn by the same pen.  If you press  the
  1278.         appropriate  key,  a  part  of  the  picture  drawn  by   the
  1279.         appropriate pen will begin to  flash and it will be  flashing
  1280.         until you press the key corresponding with the identification
  1281.         of another pen or if you do not cancel the identification  by
  1282.         pressing the Alt_0  key or 0  key resp.   This identification
  1283.         functions only in color video modes.
  1284.  
  1285.         Example: If you press  the key Alt_1 (in  a small view) or  1
  1286.                  (in a  large view)  resp., the  part of  the picture
  1287.                  drawn by the pen number 1 will begin to flash (Alt_2
  1288.                  or 2 resp. by the pen number 2, etc.).
  1289.  
  1290.           In color modes in the SPLOT program each pen is  associated
  1291.         with appropriate  color. It  is possible  to choose  from the
  1292.         palette of 62 colors for  each pen. You can change  the color
  1293.         of the pen when the identification of this pen is switched on
  1294.         by pressing  the Gray-Plus  key or  the Gray-Minus  key resp.
  1295.         (increasing or decreasing the number of the color  associated
  1296.         with this pen). When  the pen identification is  switched on,
  1297.         information about the color number of the pen in a large view
  1298.         is given in the right  bottom corner of the screen.  In large
  1299.         view you can change pen colors also after pressing the  Alt_1
  1300.         key, the Alt_2 key etc.  In this case there is no flashing of
  1301.         the part of the  picture as it is  in a small view,  but only
  1302.         information about the color number  of the pen, which can  be
  1303.         changed in  the described  way, appears  in the  right bottom
  1304.         corner.   You can  save the  palette of  the colors  you have
  1305.         chosen by  pressing the  Alt_S key,  or you  can restore  the
  1306.         original palette by the Alt_R key.
  1307.  
  1308.           The information panel containing the individual pen numbers
  1309.         serves to identify  the numbers of  pens used during  drawing
  1310.         the picture. At the beginning of drawing all the pen  numbers
  1311.         are  gray,   during  drawing   the  color   of  the    number
  1312.         corresponding with the  pen just being  used is white,  after
  1313.         finishing drawing the color of the numbers corresponding with
  1314.         all the used pens is white.
  1315.  
  1316.  
  1317.  
  1318.                 10. NOTES
  1319.                 ---------
  1320.  
  1321.         - When  the  SPLOT  program  is  started, it is in the  state
  1322.           corresponding with the state of the simulated plotter  just
  1323.           switched  on.  When  coming  to  plotting  a  new file, the
  1324.           program performs only the  operation of changing paper.  In
  1325.           this case the program (plotter) is in the state in which it
  1326.           has been left by the commands of the previous file. That is
  1327.           why  it  is  generally  recommended  to place an initiating
  1328.           command sequence  to the  beginning of  each file.  It will
  1329.           bring the plotter  to the well-known  state.  Otherwise  it
  1330.           can happen that the same  file can be drawn in  another way
  1331.           every time,  dependently of  the contents  of the  previous
  1332.           plotted files. The author recommends to use the  initiating
  1333.           sequence IN;RO;IP;IW; (in some plotters the IN command does
  1334.           not influence the setting of rotation).
  1335.             In  other  cases  the  program  is  brought  to the state
  1336.           corresponding with the switching off and on the plotter  in
  1337.           these cases:
  1338.            - at any change of the format or the paper size,
  1339.            - at the change of the language syntax (HP-GL <--> DXY-GL),
  1340.            - at  switching  on/off  the  simulation  of the  graphics
  1341.              cartridge HP 17440A (ColorPro).
  1342.  
  1343.         - After  finishing  the  SPLOT  program  saves  the important
  1344.           parameters (a palette of colors for pens, a choice of  view
  1345.           for plotting, a size of  paper, command mode, etc.) in  the
  1346.           SPLOT.INI file in  the directory in  which the program  EXE
  1347.           file is situated.  When starting the program, the SPLOT.INI
  1348.           file is used for resetting these parameters. If you want to
  1349.           set a permanent configuration of the program which will not
  1350.           be changed,set on the READ ONLY attribute of this file.
  1351.  
  1352.  
  1353.           NOTICE
  1354.  
  1355.           -  Hewlett-Packard,  HP-GL,  HP,  DraftPro,    DraftMaster,
  1356.              LaserJet, DeskJet and PainJet are registered  trademarks
  1357.              of the Hewlett-Packard Company.
  1358.  
  1359.           -  Microsoft,  MS,   MS-DOS  and  GW-BASIC  are  registered
  1360.              trademarks  and  Windows  is  a  trademark  of Microsoft
  1361.          Corporation.
  1362.  
  1363.           -  IBM and PC-DOS are registered trademarks of
  1364.              International Business Machines Corporation.
  1365.  
  1366.           -  EPSON is a registered trademark of EPSON Corporation.
  1367.  
  1368.           -  AutoCAD is a registered trademark of Autodesk, Inc.
  1369.  
  1370.       -  PostScript is a trademark of Adobe Systems, Inc.
  1371.