home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / GR / GR030.ZIP / OKDOCS.DOC < prev    next >
Text File  |  1988-10-22  |  41KB  |  835 lines

  1.  
  2.                                     OPTIKS
  3.  
  4.                          The Spread Sheet for Graphics
  5.  
  6.                                     Preface
  7.  
  8.                  At long last, OPTIKS is going to be documented. I
  9.         have been working on OPTIKS and its forbearers for the last
  10.         year and hundreds of people have actually been using OPTIKS
  11.         without any help at all. This is probably a tribute to the
  12.         fact that OPTIKS has been developed with Lotus 1-2-3 as a
  13.         model. Functionally the two programs are totally different,
  14.         but 1-2-3 has proved to be the standard in "user friendly"
  15.         software. Lotus 1-2-3 is actually "user seductive". When I had
  16.         to choose a face for OPTIKS I decided to make it similar in
  17.         many ways to 1-2-3's friendly smile. If you use 1-2-3, you
  18.         already know much about using OPTIKS. What 1-2-3 is to the
  19.         cell, OPTIKS is to the pixel.
  20.  
  21.                  What's a pixel? Pixel is the name of the kitten in
  22.         Robert Heinlein's book "The Cat Who Could Walk Through Walls",
  23.         but it means a point of light on the screen - a picture
  24.         element. OPTIKS deals with points. You can organize these
  25.         points into pictures and you can grab a bunch of points in the
  26.         shape of a rectangle and call it a "RANGE". The thing you
  27.         might want to remember in OPTIKS is that it knows nothing
  28.         about letters or characters, lines or shapes. It knows dots on
  29.         the screen and at best can be told about a bunch of dots.
  30.  
  31.                  OPTIKS is a 1-2-3 like menu which leads to little
  32.         routines to do things with pixels. The main thing that OPTIKS
  33.         is used for is to RETRIEVE files from a disk so that we can
  34.         view them. The files are almost always pictures of some sort
  35.         created by OPTIKS or by specialized "paint" or "draw"
  36.         programs. There are other routines which allow you to move
  37.         pieces of the picture around, type in various fonts and do
  38.         various things to change and (hopefully) improve the picture.
  39.         OPTIKS will even allow you to MERGE another picture (perhaps
  40.         from another type of paint program) into an existing picture.
  41.  
  42.                  After you have viewed a picture and used some of the
  43.         OPTIKS features to alter the picture you can SAVE the picture
  44.         in one two dozen or more different file formats supported by
  45.         OPTIKS for both read and write. This makes OPTIKS ideal as a
  46.         file conversion utility. The version which writes out files in
  47.         a variety of formats is available to paid users only, but the
  48.  
  49.  
  50.         price is less than that of the competition. Although competing
  51.         file conversion utilities are all very good, OPTIKS has a few
  52.         extra features that make it easy to use and is usually very
  53.         fast on file loads and saves compared to most programs.
  54.  
  55.                  An important point to make about OPTIKS is that it is
  56.         an evolutionary product. It started on PC bulletin Boards as a
  57.         small view utility called FMAC and then grew into a prototype
  58.         program called PCRGB. It has been around for a while now as
  59.         OPTIKS, but it has doubled in features so that now it has over
  60.         300 menu items. And it is still not done! How can I sell a
  61.         product that's not finished? My answer is that OPTIKS may
  62.         never be finished. The menu items that tell you apologetically
  63.         that this or that feature is not installed are really goals
  64.         for the immediate future. I am constantly adding to and
  65.         refining the program. There is always a new file type I'd like
  66.         to support or a new way of changing a picture I'd like to add.
  67.         I look at paint and publishing programs every day and very
  68.         often I see something that should be added to OPTIKS.
  69.         Sometimes I see a feature that the competition has installed,
  70.         but it could be improved.
  71.  
  72.                  OPTIKS is not really competing with programs like PC
  73.         Paintbrush or Ventura Publishing. I can't do the good job that
  74.         the coders who worked hard on these programs have done. OPTIKS
  75.         occupies a niche somewhere in between these giants and off to
  76.         the side. OPTIKS can read files that other programs can't, and
  77.         create files that are perfect for inclusion in paint and
  78.         publishing programs. OPTIKS is a graphics utility for creating
  79.         output to be used by specialty programs. Its a "Jack of all
  80.         trades" program that is like having a Swiss Army Knife in your
  81.         pocket. It saves you hours of time when you need it. But I
  82.         would never use OPTIKS as a replacement for a Paint program or
  83.         expect it to do the very specific functions of a Publish
  84.         program.
  85.  
  86.                  One last thing. I am Keith Graham. I am writing
  87.         OPTIKS, I am writing this. I (or my wife) answers the phone
  88.         when you call (914) 623-4161. There is no one else involved in
  89.         the project. This is good and this is bad. I can't make a
  90.         living off of OPTIKS so 10 hours a day I am out in the jungle
  91.         busting my butt for other people. This makes me hard to reach.
  92.  
  93.         You can reach information of PC Rockland and make voice orders
  94.         at (914) 358-8145. This number is only for orders of ordering
  95.         information, and no one there has tech support information. The
  96.         advantage of this number is that a real person answers during
  97.         normal east coast working hours and phone messages will be
  98.         returned (for order information only).
  99.  
  100.  
  101.  
  102.                               OPTIKS USER MANUAL
  103.  
  104.                                    CHAPTER 1
  105.  
  106.                       HARDWARE AND SOFTWARE REQUIREMENTS
  107.  
  108.  
  109.                  OPTIKS runs on IBM PC's and PC compatibles with
  110.         graphics screens and more than 256K free memory. If you want
  111.         to print with OPTIKS you will need a graphics printer.
  112.  
  113.                  SOFTWARE:
  114.  
  115.                  OPTIKS works on all versions of PC-DOS and MS-DOS
  116.         from 2.00 on up. OPTIKS will grab as much free memory as it
  117.         can, and needs at least 256k free to be useful. It will
  118.         sometimes conflict with memory resident programs or time
  119.         slicing programs which can't handle graphics or do not use
  120.         memory well. OPTIKS is what you would call a "Well Behaved"
  121.         program in that it does everything it can according to the
  122.         rules. It should peacefully coexist with most applications. If
  123.         you find an application which causes OPTIKS to crash or some
  124.         other program to crash, I would like to know about it. I will
  125.         try to fix the problem. DOS 3.x uses an internal stack for
  126.         interrupts. Pressing the CTRL-BREAK repeatedly to bring back
  127.         the OPTIKS menu will eventually blow the DOS stack. This is
  128.         DOS problem and refer to the DOS manual for a fix. OPTIKS
  129.         needs no special CONFIG.SYS options such as BUFFERS or FILES
  130.         statements. OPTIKS opens one file at a time and then closes
  131.         it. There is never more than one file open at a time.
  132.                  OPTIKS is designed as a single user program and may
  133.         get into conflicts when placed on a network. If there is a
  134.         need to run OPTIKS on a network and conflicts occur I will add
  135.         DOS file locking commands to the file open and closes. This
  136.         seems unlikely to be a problem so I will wait until I hear of
  137.         a need for this.
  138.  
  139.                  HARDWARE:
  140.  
  141.                  GRAPHICS BOARDS:
  142.  
  143.                  OPTIKS makes an attempt to identify the graphics
  144.         board plugged into your system. It can identify EGA, AT&T 6300
  145.         and CGA boards. If you have a monochrome system, OPTIKS will
  146.         check first to see if you have an EGA and if that fails will
  147.         send you into Hercules graphics mode. If you have neither an
  148.         EGA, AT&T 6300 or a monochrome system the program enters into
  149.         640*200 mode CGA graphics.
  150.  
  151.  
  152.                  In addition to these modes OPTIKS can be made to
  153.         select VGA modes, Paradise 480, Tseng Labs or Nec graphics
  154.         modes, Compaq graphics and AMDEK/WYSE 1280 modes. The 1280
  155.         boards work well in 640 mode, but not all of OPTIKS features
  156.         will work at 1280 mode. 1280 mode should be used for viewing
  157.         graphics only.
  158.  
  159.                  MEMORY:
  160.  
  161.                  OPTIKS needs about 200k for the program itself and
  162.         its work areas and then grabs pages of memory in 32k chunks
  163.         until it runs out of memory. These pages are used for storing
  164.         the picture data. If you do not have EMS memory, OPTIKS can
  165.         grab, at most, around 384K. This is not enough for many large
  166.         scanned images, but it is perfectly adequate for Apple
  167.         MacPaint pictures which are narrow and not very long.
  168.                  If you have EMS memory you can assign some or all of
  169.         it to be used by OPTIKS. OPTIKS now automaitically grabs all
  170.         of the EMS memory it can. If you do not want OPTIKS to use
  171.         all of the EMS memory you must go into the EMS menu and
  172.         release all of the EMS memory and then re-allocate the
  173.         correct amount. Use the KEEP option under CONFIG to have
  174.         OPTIKS automatically use the correct amount of EMS memory
  175.         the next time you start up OK.
  176.                 Since OPTIKS uses only a few simple features of EMS
  177.         memory it should not matter which EMS card or version of the
  178.         EMS driver that you use. The most EMS memory that can be used
  179.         with OPTIKS is 4 megs. This should be enough for the most
  180.         humungous image.
  181.                 If you don't have EMS memory then try using OKEMS.COM
  182.         which will emulate EMS to a disk drive. There are instructions
  183.         on how to use OKEMS in a separate DOC file.
  184.  
  185.                  MOUSES:
  186.  
  187.                  Yes, it says mouses not mice. Mice are small rodents,
  188.         mouses are small hand held pointing devices. OPTIKS will
  189.         identify and use a Microsoft mouse driver. I have a Logitech
  190.         mouse and I use it with OPTIKS. I have used a Genius mouse
  191.         with OPTIKS. This leads me to the assumption that OPTIKS will
  192.         work with a Microsoft mouse. There are no settings for the
  193.         mouse. The keyboard will always work. I have a Mouse Systems
  194.         mouse driver that I have used with a Mouse Systems mouse
  195.         clone, but it is crude and difficult to control. I would
  196.         suggest using a Microsoft Driver with the Mouse Systems Mouse
  197.         and letting OPTIKS handle the details.
  198.                  Microsoft recently changed the mouse driver so that a
  199.         reset resets the entire hardware involved. I use a reset to
  200.         clear the mouse in order to stop at a line or position better,
  201.         but this causes delays on computers using a new mouse driver.
  202.         I have tried their suggested fix and it does nothing except
  203.         make the mouse unstable for older versions of the driver.
  204.  
  205.  
  206.                  PRINTERS:
  207.  
  208.                  OPTIKS works with Laser printers and Dot matrix
  209.         printers. I have seen the output of IBM graphics printers, IBM
  210.         Proprinters, Epson FX series printers, Toshiba 3x1 printers,
  211.         Canon Laserbeam printers, Hewlett Packard Laserjet Printers
  212.         and Ricoh Laser Printers. I have tested OPTIKS on Panasonic
  213.         printers. Other printers are being tested. OPTIKS will write
  214.         Encapsulated PostScript Files which can be printed on
  215.         PostScript Compatible printers. JLASER board printing works. I
  216.         have added LaserMaster CAPcard support which I have not seen
  217.         work, but there should be no problem.
  218.                  OPTIKS supports only single pass graphics so if you
  219.         have an EPSON printer which software utilizes the double pass
  220.         graphics, the output may look a little light. This is under
  221.         investigation. I will be purchasing an Epson compatible
  222.         printer in order to better test the graphics.
  223.  
  224.                  SCANNERS:
  225.  
  226.                  OPTIKS works on CANON IX-12 scanners and Princeton
  227.         Graphics Scanners. JLASER is a constant challenge, but you
  228.         should be able to use it in current versions. I am told that
  229.         DEST scanners work by specifying CANON.
  230.  
  231.  
  232.                  ENHANCEMENTS:
  233.  
  234.                  As technology advances, OPTIKS will be adding new
  235.         hardware support. As soon as I receive the specifications on
  236.         new iron I will add routines to OPTIKS to support it. I often
  237.         work in the dark in that I can't test my work. This is
  238.         frustrating to me and to my users who must wait through
  239.         several revisions in order to get some features working
  240.         correctly. Sometimes suppliers support me directly with
  241.         hardware loans. This is appreciated and I always try to thank
  242.         suppliers who help out by trying to present their hardware in
  243.         a good light. The features developed with the help of
  244.         suppliers are always the best parts of OPTIKS because I can do
  245.         my best work when I have good support.
  246.  
  247.  
  248.  
  249.                               OPTIKS USER MANUAL
  250.  
  251.                                    CHAPTER 2
  252.  
  253.                              GETTING STARTED QUICK
  254.  
  255.                  If you can read this you have gotten OPTIKS out of
  256.         its ARC and onto a disk. I will not tell you how to put OPTIKS
  257.         on a disk or warn you to make backup copies, because you are
  258.         already on your way to being a "power user" or you wouldn't be
  259.         interested in OPTIKS. You need OK.EXE or OKPRIV.EXE to use
  260.         OPTIKS. OK.EXE is the free version which is distributed for
  261.         evaluation purposes. It is identical to OKPRIV.EXE except that
  262.         OKPRIV.EXE allows you to write out graphics images in a wider
  263.         variety of formats. OKPRIV.EXE also has an internal serial
  264.         number which can be used to verify ownership. When I talk
  265.         about OPTIKS I will refer OKPRIV.EXE or OK.EXE as OK. This
  266.         saves time.
  267.  
  268.                  OK needs to be on the current path to work (you knew
  269.         that). It does not have to be on the current disk or
  270.         sub-directory as long as it is on the path. You type OK (or
  271.         OKPRIV) to get OPTIKS started. It will take a fraction of a
  272.         second to load in and grab memory and clear it out. Its
  273.         housekeeping chores include looking on the current disk and
  274.         sub-directory for a file called CONFIG.OK This file contains
  275.         information on how you have set your defaults. You don't need
  276.         it, but you may want to create one later on. The first time
  277.         OPTIKS starts up it uses its defaults which 99% of the time
  278.         are what you need.
  279.  
  280.                  OPTIKS bloops at you when its done housekeeping
  281.         (usually under 2 seconds). It displays the OPTIKS logo and
  282.         throws you into menu mode.
  283.  
  284.                  DEFINITION: MENU MODE. That's the mode where you can
  285.         see a menu and make selections from the menu.
  286.  
  287.                  The menu is the row of words in capital letters going
  288.         across the top of the screen. The choices are:
  289.  
  290.         FILE   ENVIRN   PRINT   IMAGE   DRAW    TYPE    SCAN    QUIT
  291.  
  292.         The word FILE is in reverse video. Underneath the menu line is
  293.         an explanation of what the word in reverse video can do for
  294.  
  295.  
  296.         you. If you move the reverse video cursor using the left and
  297.         right arrow keys you can see a short explanation of each of
  298.         the menu items and what it does for you.
  299.  
  300.                  Right now we are interested in looking at a graphics
  301.         image file in the disk. I always use an Apple MacPaint file
  302.         called REFLECT.MAC to test so I include it with the OPTIKS
  303.         disk. We want to get this file into OPTIKS. You can find the
  304.         word FILE on the menu. I try my best to get the menu word to
  305.         correspond to the function of the menu selection. It should be
  306.         obvious most of the time what each menu does. You will become
  307.         an expert user before you know it. Getting through the first
  308.         time is all it takes.
  309.  
  310.                  Move the reverse video cursor to the word file and
  311.         press the return key. OPTIKS gives you another menu. (You
  312.         could have just pressed the F key and OPTIKS would have found
  313.         the menu item that starts with an F.) The new menu looks like:
  314.  
  315.         RETRIEV SAVE    MERGE   LIST    DEFAULT CHECK
  316.  
  317.         We are interested in retrieving a file so we can choose the
  318.         retrieve function. If we had a picture that we wanted to save
  319.         we could enter S to save it or we could merge a new picture
  320.         with the existing picture using merge. List is used to list
  321.         out all or some of the files on a disk and default can move us
  322.         to a new disk drive or sub-directory. Check is used when we
  323.         can't figure out what kind of a graphic image we have. Check
  324.         will look at the file and see if it can recognize it. (Handy
  325.         when you have 30 or more different types of graphic files
  326.         cluttering your disks).
  327.  
  328.                  By the way, if you accidentally get into the wrong
  329.         menu branch you can always back out the way you got in by
  330.         hitting the Esc key. Don't panic! - Escape.
  331.  
  332.                  Press R (or move the cursor to RETRIEV and press
  333.         return). Your are given another %#!@ menu which looks like:
  334.  
  335.         PCR     TEXT    LANG    BLOAD   FONTS   MORE->
  336.  
  337.         PCR files are ultra-squished image files. PCR is a format
  338.         unique to OPTIKS and you may want to use this file format if
  339.         disk space is at a premium. But we are trying to look at an
  340.         Apple MacPaint file. Text is an ascii text file, LANG is for
  341.         Lotus PIC and Postscript. Bload is for Basic BLOAD/BSAVE files
  342.  
  343.  
  344.         and FONTS is for typing and such. None of these have anything
  345.         to do with Apple MacPaint. By process of elimination you are
  346.         going to have to choose the MORE option.
  347.  
  348.                  Press M or move the cursor to MORE and press return.
  349.         Oh no! another menu:
  350.  
  351.         APPLE   PCB     IMG     WIPS    RLE     CUT     FONTASY MORE->
  352.  
  353.                  Finally there is Apple and all you have to do is
  354.         press the return because the cursor is right on the APPLE menu
  355.         option. Pressing A will also work.
  356.  
  357.                  The disk drive light comes on as OPTIKS takes a look
  358.         to see what you've got on the disk and then shows you a
  359.         directory of the disk. OPTIKS knows that Apple MacPaint files
  360.         have an extension of .MAC and shows you only those files that
  361.         match this extension. If you have none, OPTIKS will show you
  362.         exactly that - nothing. OPTIKS has looked at the disk and made
  363.         a list of the files that it found. You may press the up arrow
  364.         or the down arrow to display all of the file names. If
  365.         reflect.MAC were the only MAC file on the diskette then that
  366.         would be displayed. You can use the up and down arrows looking
  367.         for a file, or you can change default disks and directories by
  368.         pressing the page down key. You can get a new file list by
  369.         pressing the page up key. Your last resort is to type the
  370.         complete name of the file that you want to load.
  371.  
  372.                  If you typed everything correctly and OPTIKS finds
  373.         REFLECT.MAC on the disk, a neat little hourglass will appear
  374.         and the sand will drain while the file is loaded. When OPTIKS
  375.         is finished (it only takes a few seconds) it will beep and you
  376.         will be looking at the etching by M.C. Escher of Escher
  377.         himself holding a silver reflecting sphere.
  378.  
  379.                  Actually Reflect is a big picture and you will only
  380.         be looking at the top part of it. The menu will be gone (thank
  381.         goodness) and you will be in VIEW MODE.
  382.  
  383.                  DEFINITION: VIEW MODE. The mode that you use to view
  384.         a picture.
  385.  
  386.                  When in View mode you can use the cursor control keys
  387.         to move around the picture. Home brings you to the upper left
  388.         hand corner of the work area and END brings you to the lower
  389.         right hand corner. END does not bring you to the lower right
  390.         hand corner of the picture image which is quite a bit smaller
  391.  
  392.  
  393.         than the whole work space. PgUp and PgDn go up and down the
  394.         picture in chunks. The up and down arrows move you through the
  395.         picture slower. The left and right arrows move you
  396.         horizontally through the picture.
  397.  
  398.                  The picture may be too big to view all at once, but
  399.         you can browse through it using the cursor control keys.
  400.  
  401.                  You can only look at the picture for so long before
  402.         you decide its time to do something like print it out. You
  403.         will have to get into Menu mode to print the picture (remember
  404.         PRINT was on the first menu).
  405.  
  406.                  You can get back to the menu by pressing the / key
  407.         (same as Lotus 1-2-3) or you can press Esc. Press / now and
  408.         the menu will appear.
  409.  
  410.                  This time we are interested in printing so press P or
  411.         move the cursor over to the PRINT option and press return. The
  412.         menu that comes up is:
  413.  
  414.         PRINT   FILE    CAPcard
  415.  
  416.         You now have the option to print to a printer or to a file.
  417.         You may have some need in the future to print to a file, but
  418.         for now press the P to print to the printer. The menu is now:
  419.  
  420.         RANGE   PAGE    LINEF   GO      CONFIG
  421.  
  422.                  PAGE is to eject the current page from the printer.
  423.         LINEF is to give the printer a line feed. RANGE is to tell
  424.         OPTIKS how much of the printer you would like to print.
  425.  
  426.                  You must specify a range before you can print!
  427.  
  428.                  Press R or move the cursor to RANGE and press return
  429.         to set the range.
  430.  
  431.                  The menu disappears and you are given instructions to
  432.         move a pointer to the upper left hand corner of the range. One
  433.         problem is that the message has covered part of the picture.
  434.         You can enter Alt-C to clear off any clutter on the screen.
  435.         Let's just print Escher's head for now. Press the down arrow
  436.         and you will notice that the pointer is a finger. You are in a
  437.         new mode now called RANGE mode.
  438.  
  439.                  DEFINITION: RANGE MODE: The mode you are in whenever
  440.         a finger is on the screen. Range mode is used for 1) pointing
  441.         and 2) defining a range.
  442.  
  443.  
  444.                  Move the finger to a point just above and to the left
  445.         of Escher's head. As you move the finger down, the picture
  446.         will move up so you won't fall off of the bottom of the
  447.         screen.
  448.  
  449.                  When you get the finger positioned you can start the
  450.         range by hitting the return key. When you hit the return
  451.         another message will appear telling you to move to the lower
  452.         right hand corner of the range. Move the finger down and to
  453.         the right until Escher's head is in reverse video. The part of
  454.         the picture that shows in reverse video is the range. Press
  455.         the return key when you have got the range you want to print
  456.         in reverse video.
  457.  
  458.                  That's all there is to range. You should be back into
  459.         the menu. Now, assuming that you have an Epson or IBM
  460.         compatible graphics printer you can press G or move over to
  461.         the GO option and press return. This will start you printing.
  462.         (If you don't have a printer, I would skip this part.)
  463.  
  464.                  If you don't have an IBM graphics type printer you
  465.         will have to use CONFIG and then MODEL and then DOT or LASER
  466.         and then select the correct printer from the menu. You would
  467.         then use Esc to get back up to the printing menu to press G.
  468.  
  469.                  OPTIKS prints pretty fast compared to some graphics
  470.         programs, but graphics printing is slow at best (its all those
  471.         darn little dots). When you are through printing you may want
  472.         to press P for page to eject the page from the printer.
  473.  
  474.                  You can press Esc to get back up to the Main menu.
  475.         And from there you can explore the rest of the menu items. The
  476.         last time I counted I came up with 300 different menu items
  477.         and I've added more since then. Many are hardware specific or
  478.         are used for changing the defaults. Most lead to menus within
  479.         menus.
  480.  
  481.  
  482.                  LEAVING OPTIKS:
  483.  
  484.                  OPTIKS is a great program, but sometime even I want
  485.         to get back to the DOS prompt. You have to get to the main
  486.         menu. If you are in view mode press the Esc key or / and the
  487.         main menu will appear. If you are in a menu press Esc until
  488.         you get to the main menu. (Hint: you are looking for QUIT).
  489.         From the main menu press Q. You will be asked to confirm and
  490.         you press Y if you are sure. OPTIKS will then clean up the
  491.         mess it made of memory and return to DOS. If you are in a
  492.         floppy disk based system you may be asked to put the boot disk
  493.         with COMMAND.COM back into the A: drive before DOS will let
  494.         you continue.
  495.  
  496.                  Whew, you did it. Next time will be a breeze. From
  497.         now on you can either hunt through the menus or dip into the
  498.         rest of the documentation for information about how to read,
  499.         write and alter images. You have already done all of the hard
  500.         stuff. Everything else is either more of the same or obvious.
  501.  
  502.                  The best way to learn about OPTIKS and its
  503.         capabilities is to explore the menus. Start with REFLECT.MAC
  504.         and try all the neat stuff under IMAGE which allows you do
  505.         shrink and stretch and tilt and rotate plus other nifty
  506.         things. Try saving the image in different formats. Saving a
  507.         file is similar to printing, when you choose SAVE and then a
  508.         type of file you will be asked for a range. Also try pressing
  509.         the F1 key and you will be given lots of information in a very
  510.         small space.
  511.  
  512.  
  513.                                 OPTIKS DEFAULTS
  514.  
  515.                  OPTIKS in a attempt to be as helpful as possible
  516.         tries to anticipate your needs. OPTIKS starts up and looks
  517.         around your hardware for 1) a mouse, 2) an EMS driver, 3) a
  518.         recognizable video board and 4) a CONFIG.OK file. The
  519.         CONFIG.OK file is a record of your stored configuration. It is
  520.         written to the current subdirectory whenever you go to /ECK.
  521.         (That is / Environment Config Keep.) This "keeps" your current
  522.         variation from the default on disk. In this way you won't have
  523.         to change display modes, EMS, screen width, favorite printer,
  524.         etc. every time you start up.
  525.  
  526.                  There is no default for mouse. Either a mouse driver
  527.         is there or it is not. On early versions of DOS, there may be
  528.         a problem with DOS not cleaning up the interrupts and OPTIKS
  529.         can be fooled into thinking there is a Mouse when there is
  530.         not. OPTIKS works best in DOS 3.x. If your version of 2.1 or
  531.         2.11 is working, there is no reason to change, but if OPTIKS
  532.         hangs the machine when you start up, consider trying a newer
  533.         version of DOS. (I have used no DOS 3.x specific features so
  534.         if you get to the menu without hanging by all means use the
  535.         leaner, meaner DOS 2.)
  536.  
  537.                  Below are listed some of the more important defaults
  538.         which are saved in the CONFIG.OK file. If you don't use any of
  539.         them, then don't worry about defaults and try another chapter.
  540.  
  541.                           VIRT - Virtual Screen Width
  542.  
  543.                  Virtual in computerese means: It looks and acts like
  544.         its there, but it really isn't. Your REAL screen width is
  545.         either 640 pels or 720 pels depending on your monitor. A
  546.         Hercules screen is 720, most of the others are 640. OPTIKS
  547.         figures this out when it starts up, and you can't tell it
  548.         different. It is possible to have a virtual screen much bigger
  549.         than the real screen. You can use the cursor controls to move
  550.         around inside the virtual page so that a piece at a time shows
  551.         up on your real screen.
  552.  
  553.                  The default virtual screen is 1024 pels wide, but you
  554.         can double that (and double it again and a again) up to 8192
  555.         pels wide. If you think of the way a Laser Printer prints at
  556.         300 dots per inch, 8,192 pels is 27+ inches wide. That's a big
  557.         picture. (divide the # of pels by the print density to get
  558.         inches).
  559.  
  560.  
  561.  
  562.                  There is price for fooling with the virtual page
  563.         width. You only have so much memory. You can display the
  564.         current memory situation from the Environment menu, and by
  565.         adding total EMS memory allocated and real memory used for
  566.         pictures you can get the total picture memory. That is all the
  567.         memory you get. The wider the virtual page width the fewer
  568.         lines of picture can be allocated. Number of lines times the
  569.         width of a virtual page equals total picture memory. Picture
  570.         memory is a constant so if you want a longer picture you need
  571.         a narrower page.
  572.  
  573.                  If you have no EMS memory and not much free DOS
  574.         memory you will cut off the bottoms of most pictures. If you
  575.         make the virtual page width very wide, you may not be able to
  576.         see more than a screen of any image. 1024 pels is best for
  577.         Readmacs which are fixed at 576 pels wide. 2048 is best for
  578.         the large .PCC files on the OPTIKS conference. 4096 pels will
  579.         give you more than 13 inches width at 300 DPI. Only power mad
  580.         DTP users will consider the 8,196 pel virtual page width.
  581.  
  582.                  Once you select a virtual page width you like, "KEEP"
  583.         it by going into Config and using the Keep option. This will
  584.         place a CONFIG.OK on the current directory. The next time
  585.         OPTIKS starts up it will look at the CONFIG.OK to see what
  586.         size virtual page you prefer and set it correctly.
  587.  
  588.                       CHAPTER 2
  589.  
  590.                 THE OPTIKS COMMAND LINE
  591.  
  592.         The command OK (or OKPRIV if you have a private version)
  593.         will start up OPTIKS. This is the normal way to enter into
  594.         optiks. Once in OPTIKS you would use the keyboard or the
  595.         mouse to manipulate graphics.
  596.  
  597.         There are times when it may be convient for OPTIKS to do
  598.         some action from a BAT file or from the command line. You
  599.         can do this by entering:
  600.                   OK keystrokes
  601.         The keystrokes are the slash key: "/" and any valid
  602.         sequence of OPTIKS menu items. Menu items, if you recall,
  603.         can be entered by typing the first letter of each item.
  604.         There are a few special keys also. They are:
  605.           ~ (tilde) =     Return key
  606.           ^ (hat)   =     Escape Key
  607.           @         =     Home
  608.           !         =     End
  609.           ?         =     Wait forever for a keystroke
  610.                           If the escape is pressed, the key sequence
  611.                           ends.
  612.           $         =     wait 2 seconds
  613.                           If the escape is pressed, the key sequence
  614.                           ends.
  615.           *         =     restart the command line.
  616.                           This is for slide shows.
  617.           +         =     up arrow
  618.           -         =     down arrow
  619.           (         =     left arrow
  620.           )         =     right arrow
  621.  
  622.  
  623.         An Example:
  624.  
  625.             OK frma!reflect~$$$/qy
  626.  
  627.         Does the following:
  628.            f=FILE
  629.            r=RETRIEVE
  630.            m=MORE
  631.            a=APPLE
  632.            !=END (clears any found names from the line)
  633.            reflect=name of mac file "REFLECT.MAC"
  634.            ~=return
  635.            $$$$$=wait 10 seconds
  636.            /=menu
  637.            q=QUIT
  638.            y=YES
  639.  
  640.        I have set up a slid show displays 3 Zsoft PC Paint files
  641.        over and over again and scrolls around a little in each.
  642.        I put it in a BAT file to make it easier to create and run
  643.  
  644.         OK /frmp~$)))---$((($@^p-~$)))---$((($@^p--~$)))---$((($@*
  645.  
  646.        Using the * key in a command line allows you to have a
  647.        continously running show. However I would suggest that
  648.        you have a $ or a ? in there somewhere or you will have
  649.        to reboot to exit the show.
  650.  
  651.  
  652.        NOTES ON COLOR:
  653.  
  654.        With release 2.08 I have added the ability show 16 color
  655.        graphics in EGA and VGA modes. The file types supported
  656.        are ZSOFT PCC and PCX, Compuserve GIF and DR's GEM Paint
  657.        IMG files. I have not tested GEM IMG files yet.
  658.        The default for all systems is single plane 2 colors.
  659.        To change the default you must go to the ENVIRONMENT
  660.        menu down to SCREEN and select IBM. The various sorts of
  661.        IBM screens will be displayed along with PLANES. The planes
  662.        can be either 1 or 4. To use color you must select 4 before
  663.        you read the file or the palette will not be set.
  664.        If you try to read a normal black and white file the planes
  665.        will be reset to 1. Planes will not work unless you are in
  666.        a valid EGA or VGA mode.
  667.  
  668.        Color and Black and White graphics can not be mixed.
  669.  
  670.        Color images can be saved and manipulated a little, but
  671.        many functions will not work with color. No drawing and few
  672.        of the image manipulators work correctly. Typing will be
  673.        very strange.
  674.  
  675.        Some Color images will set the palette so that the menu is
  676.        nearly invisible. The finger move destructively on the screen
  677.        and this is a real bug which is being addressed
  678.  
  679.        Old EGA cards with less than 256k on them will show odd
  680.        patterns on the screen. Owners of such cards should order
  681.        an upgrade to get full use of all of the new graphics coming
  682.        out.
  683.  
  684.  
  685.        TIPS on using HP LaseJet fonts.
  686.  
  687.        2.08 also saw the ability to read laserjet fonts. There is
  688.        not enough memory to run OPTIKS and keep a font resident
  689.        so LJ fonts are treated as files. /FR will read files and
  690.        fonts, but ERASES the workspace first. Use /FM (merge) to
  691.        type on an existing graphic. Fonts are XOR'd to the image
  692.        so that they overlay the data in a non-destructive manner.
  693.        The image will show through the letters. This may not be
  694.        acceptable for some typing. Clear a space for the letters
  695.        using /IFD or /IFE.
  696.  
  697.        Since the fonts are loaded as files, if a letter is not in
  698.        the file buffer, the file will be re-read from the beginning
  699.        to find the file. This is very slow in large fonts. Fonts up
  700.        to about 16 point will fit entirely in the file buffer and
  701.        they will go much faster.
  702.  
  703.        Since most fonts are variable spaced, the backspace key will
  704.        backspace the width of the last letter typed. To erase a letter
  705.        you re-type it. Accurate typing will save you hours of
  706.        repositioning.
  707.  
  708.  
  709.  
  710.            FILE MENU TREE
  711.  
  712.      The floowing is a summary of the OPTIKS menu tree as it pertains
  713.      to files. This will help you to determine what files OPTIKS can
  714.      read and write.
  715.  
  716.      ROOT menu:
  717.  
  718.      FILE    ENVIRN  PRINT   IMAGE   DRAW  TYPE   SCAN   QUIT
  719.  
  720.      FILE:   Load, save, merge, and list files
  721.      ENVIRN: OPTIKS Environment and optional features
  722.      PRINT:  Print a Picture to a Disk file or a Printer
  723.      IMAGE:  Alter Picture shape, size and other attributes
  724.      DRAW:   Draw lines and boxes.
  725.      TYPE:   Type to screen using OPTIKS fonts.
  726.      SCAN:   Read/write image data from scanners.
  727.      QUIT:   Leave Optiks.
  728.  
  729.      The FILE menu items are:
  730.  
  731.      RETREIV SAVE    MERGE   LIST    DEFAULT CHECK
  732.  
  733.      RETREIV: Load a file from disk into the workspace
  734.      MERGE:   Combine a file from disk with the current picture
  735.      SAVE:    Write picture information to disk
  736.      LIST:    List the files on the current directory
  737.      DEFAULT: Change the current directory and/or logged drive
  738.      CHECK:   Check For Recognizeable file header
  739.  
  740.  
  741.  
  742.      OPTIKS can RETREIVE or MERGE the following types of files:
  743.  
  744.      PCR:    PC Rockland ultra-squished data format
  745.      TEXT:   ASCII text files with OPTIKS escape sequences
  746.      LANG:   these are interpreted vector files which are:
  747.              LOTUS:  Lotus PIC files (Without text, color or fill)
  748.              POST:   Post Script files (Scanner Graphics)
  749.      BLOAD:  Bload/Bsave files from basic supporting the following
  750.              CGA:     CGA B800 16K interlaced screens
  751.              EGA:     EGA A000 32K 640*350 single plane screens
  752.              AT&T:    AT&T B800 640*400 interlace 4 screens
  753.              HERC:    Hercules B000 720*348 interlace 4 screens
  754.              640x400: VGA and similar modes 32k at A000
  755.              480:     Enahanced EGA 640*480 modes - A000
  756.              720:     720 wide modes at A up to 48k
  757.      FONTS:  Load PCR Fonts
  758.      APPLE:  Apple MacIntosh MacPaint format (READMACS)
  759.      PCB:    PC Paintbrush (PCC or PCX files from Zsoft)
  760.      IMG:    EFS Image files (raw data format)
  761.      WIPS:   Datacopy Corp. uncompressed WIPS Files
  762.      RLE:    RLE Run Length Encoded Files from Compuserve
  763.      CUT:    Dr. Halo II CUT files
  764.      FONTASY: FONTASY load block or BASIC PUT/GET files
  765.      SFP:    Type to screen with HP Soft font
  766.      LJET:   Printer output files for HP LaserJet
  767.      MSP:    Microsoft Paint
  768.      PIG:    Ricoh IS30 Pixel Image Generation files
  769.      RAS:    Show file RAS format
  770.      TIFF:   Aldus - Microsoft TIFF files
  771.      GEM:    GEM Paint file
  772.      ISF:    IBM Image Support Facility 2 v1.00
  773.      DEGAS:  DEGAS Atari ST files
  774.      ART:    PFS First Publisher .ART files
  775.      1.0PIC: PC PAINT version 1.0
  776.      PDA:    PALANTIR PDA Uncompressed
  777.      IFF:    ATARI IFF Graphics files
  778.      GIF:    Compuserve Graphics Interchange Format
  779.      TRY:    Best Guess: MicroSoft Paint, GEM, Zsoft PCX, GIF, TIF or MacPaint
  780.  
  781.  
  782.      OPTIKS can SAVE in the following formats:
  783.  
  784.      PCR     APPLE   BRUSH   MSP     EPSF    LOAD    IMG
  785.  
  786.      PCR:    PC Rockland ultra-squished data format
  787.      APPLE:  Apple MacIntosh MacPaint format (READMACS)
  788.      PCB:    PC Paintbrush (PCC or PCX files from Zsoft)
  789.      EPSF    Post Script files (Scanner Graphics)
  790.      MSP:    Microsoft Paint
  791.      BLOAD:  Bload/Bsave files from basic supporting the following
  792.              CGA:     CGA B800 16K interlaced screens
  793.              EGA:     EGA A000 32K 640*350 single plane screens
  794.              AT&T:    AT&T B800 640*400 interlace 4 screens
  795.              HERC:    Hercules B000 720*348 interlace 4 screens
  796.              640x400: VGA and similar modes 32k at A000
  797.              480:     Enahanced EGA 640*480 modes - A000
  798.              720:     720 wide modes at A up to 48k
  799.      IMG:    EFS Image files (raw data format)
  800.      WIPS:   Datacopy Corp. uncompressed WIPS Files
  801.      CUT:    Dr. Halo II CUT files
  802.      TIFF:   Aldus - Microsoft TIFF files
  803.      GEM:    GEM Paint file
  804.      RAS:    Show file RAS format
  805.      FONTASY: FONTASY load block or BASIC PUT/GET files
  806.      PIG:    Ricoh IS30 Pixel Image Generation files
  807.      GEM:    GEM Paint file
  808.      TIFF:   Aldus - Microsoft TIFF files
  809.      ISF:    IBM Image Support Facility 2 v1.00
  810.      ART:    PFS First Publisher .ART files
  811.      HP-SOFT: Write HP soft font letter. Use OKHL to create a font
  812.      1.0PIC: PC PAINT version 1.0
  813.      PDA:    PALANTIR PDA Uncompressed
  814.      IFF:    ATARI IFF Graphics files
  815.  
  816.  
  817.                     COMING SOON - MORE GREAT DOCUMENTATION!
  818.  
  819.  
  820.                  I will be issuing documentation at the rate of a
  821.         couple of chapters a month for the next few months until its
  822.         time to go back and rewrite the whole thing. The
  823.         documentation, like OPTIKS itself, will evolve as I find need
  824.         to explain things. I will follow the format of the menus going
  825.         from left to right. Chapter 3 will probably be a discussion of
  826.         the modes in OPTIKS plus a more detailed description of the
  827.         features of the program itself. I will discuss the General
  828.         Help screens. Chapter 4 will start with FILE information and
  829.         should give you some hints on how to load and save files. In
  830.         the mean time I hope this is helpful to someone.
  831.  
  832.  
  833.  
  834.  
  835.