home *** CD-ROM | disk | FTP | other *** search
/ NeedleCraft Plus / needlecraftplusvolume1.iso / dos / gifxts51 / gif2xts.doc < prev    next >
Text File  |  1994-06-26  |  76KB  |  2,094 lines
  1.  
  2.                 GIF2XTS version 5.0
  3.  
  4.    Minimum requirements: EGA monitor, AT or compatable, 360K free
  5. conventional memory 300K free XMS, EMS or virtual memory
  6.  
  7. DISCLAIMER - AGREEMENT . . . . . . . . . . . . . . . . . . . .3
  8.  
  9. ACKNOWLEDGMENTS. . . . . . . . . . . . . . . . . . . . . . . .4
  10.  
  11. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . .4
  12.  
  13. OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . .5
  14.  
  15. EXECUTION PARAMETERS . . . . . . . . . . . . . . . . . . . . .5
  16.  
  17. SCREEN LAYOUT. . . . . . . . . . . . . . . . . . . . . . . . .6
  18.  
  19. DIRECTORIES. . . . . . . . . . . . . . . . . . . . . . . . . .7
  20.  
  21. MOUSE & KEYBOARD CONTROLS. . . . . . . . . . . . . . . . . . .7
  22.  
  23. EDITING CAPABILITIES . . . . . . . . . . . . . . . . . . . . 11
  24.  
  25. MENUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  26.  
  27. FILE MENU (F1) . . . . . . . . . . . . . . . . . . . . . . . 12
  28.  
  29. EDIT MENU (F2) . . . . . . . . . . . . . . . . . . . . . . . 14
  30.  
  31. VIEW (F3). . . . . . . . . . . . . . . . . . . . . . . . . . 18
  32.  
  33. DO CHART (F4). . . . . . . . . . . . . . . . . . . . . . . . 19
  34.  
  35. INFORMATION MENU (F5). . . . . . . . . . . . . . . . . . . . 20
  36.  
  37. LIBRARY (F6) . . . . . . . . . . . . . . . . . . . . . . . . 20
  38.  
  39. HELP (F7). . . . . . . . . . . . . . . . . . . . . . . . . . 21
  40.  
  41. CURRENT SYMBOL (F8). . . . . . . . . . . . . . . . . . . . . 21
  42.  
  43. GIF VIEWER MODES . . . . . . . . . . . . . . . . . . . . . . 21
  44.      VIEW MODE . . . . . . . . . . . . . . . . . . . . . . . 22
  45.      SELECT SECTION TO PRINT . . . . . . . . . . . . . . . . 22
  46.      SCALE IMAGE . . . . . . . . . . . . . . . . . . . . . . 23
  47.      CHANGE SIZE OF IMAGE. . . . . . . . . . . . . . . . . . 24
  48.      INCORPORATE LIBRARY IMAGE . . . . . . . . . . . . . . . 24
  49.      CUT AND PASTE . . . . . . . . . . . . . . . . . . . . . 25
  50.  
  51. SYMBOL REDUCTION/DITHERING ALGORITHMS. . . . . . . . . . . . 25
  52.  
  53.                               1    
  54.  
  55.  
  56.  
  57.  
  58. A FEW WORDS ABOUT SPEED. . . . . . . . . . . . . . . . . . . 26
  59.  
  60. REVISION HISTORY . . . . . . . . . . . . . . . . . . . . . . 28
  61.  
  62. CONFIGURING/SELECTING A PRINTER. . . . . . . . . . . . . . . 32
  63.  
  64. HOW & WHY TO REGISTER. . . . . . . . . . . . . . . . . . . . 33
  65.  
  66. INTERNATIONAL REGISTRATIONS. . . . . . . . . . . . . . . . . 34
  67.  
  68. REPORTING PROBLEMS/MAKING SUGGESTIONS. . . . . . . . . . . . 35
  69.  
  70. REGISTERED USERS . . . . . . . . . . . . . . . . . . . . . . 35
  71.      THE LIBRARY ELEMENTS. . . . . . . . . . . . . . . . . . 35
  72.      CONVERT.EXE . . . . . . . . . . . . . . . . . . . . . . 36
  73.      MASTER.DMC. . . . . . . . . . . . . . . . . . . . . . . 36
  74.      RGB2DMC.EXE . . . . . . . . . . . . . . . . . . . . . . 36
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.                              2            
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                         DISCLAIMER - AGREEMENT
  115.  
  116. Users of GIF2XTS must accept this disclaimer of warranty:
  117.  
  118.     "GIF2XTS is supplied as is.  The author disclaims all
  119. warranties expressed or implied, including, without limitation,
  120. the warranties of merchantability and of fitness for any purpose.
  121. The author assumes no liability for damages, direct or
  122. consequential, which may result from the use of GIF2XTS".
  123.  
  124.     GIF2XTS is a "shareware program" and is provided at no charge
  125. to the user for evaluation.  Feel free to share it with your
  126. friends, but please do not give it away altered or as part of
  127. another system.  The essence of "user-supported" software is to
  128. provide personal computer users with quality software without
  129. high prices, and yet to provide incentive for programmers to
  130. continue to develop new products.  If you find this program
  131. useful and find that you are using GIF2XTS and continue to use
  132. GIF2XTS after a reasonable trial period, you must make a
  133. registration payment of $40.00 to Chris O'Donnell at the address
  134. below. The $40.00 registration fee will license one copy to YOU
  135. for use on any one computer at any one time.
  136.  
  137.     Anyone distributing GIF2XTS for any kind of remuneration must
  138. first contact Chris O'Donnell at the address below for
  139. authorization. You are encouraged to pass a copy of GIF2XTS along
  140. to your friends for evaluation.  Please encourage them to
  141. register their copy if they find that they can use it.  All
  142. registered users will are entitled to FREE minor upgrades, that
  143. will be mailed to you. Please indicate preferred disk size. I
  144. will notify you when the next version is available. The cost for
  145. mailing a MAJOR upgrade is $5.00, payable BEFORE I mail it.
  146.  
  147.     If you encounter a problem, or have any questions or comments
  148. please contact me.  Anyone who reports a problem will receive a
  149. copy of the non-registered version (if a non-registered user), or
  150. a FREE major upgrade (if a registered user).
  151.  
  152. Chris O'Donnell
  153. PO Box 113
  154. Middlebury, Ct 06762
  155. CIS: 70431,1427
  156. Delphi: CHRISOD
  157. Internet: 70431.1427@compuserve.com
  158.           chrisod@delphi.com
  159.  
  160.  
  161.  
  162.  
  163.                                    3    
  164.  
  165.  
  166.  
  167.  
  168.  
  169.                               ACKNOWLEDGMENTS
  170.  
  171.    To Kathy and Duck for all their help in "breaking" the
  172. program.
  173.    To all the people who volunteered to Beta Test the program and
  174. gave constructive input.
  175.    To Steve Rimmer of Alchemey MindWorks who wrote the graphics
  176. books that became my constant reference on "how-to"           
  177. Especially to my husband & our boys who semi-understand that I
  178. was "working"
  179.  
  180.                               INTRODUCTION
  181.  
  182.      This section will explain WHAT the GIF2XTS program is
  183. intended to do. During the testing of the program, there was a
  184. lot of confusion regarding the display, the output and what
  185. exactly should be expected. In order to ensure that the phrases
  186. and "buzz" words that are used mean the same to everyone, let's
  187. start with some terminology.
  188.  
  189.      PIXEL - a graphical point of resolution. Each graphics
  190. monitor is defined by the number of horizontal and vertical
  191. pixels, EGA is 640x350, VGA is 640x480. When GIF2XTS is started
  192. it sets the pixel resolution, a Super-VGA monitor is normally set
  193. to 640x480, 256 colors. A monitor can be changed to another mode
  194. by specifying that the graphics driver is to use, for example,
  195. the EGA resolution of 640x350. Thus pixel is the individual point
  196. that can be referenced on the monitor.
  197.  
  198.      GIF - Graphics Interchange Format - A method of encoding and
  199. decoding the graphical information presented on a monitor. Thus a
  200. GIF image is a graphical image that has been encoded using this
  201. methodology. In order to re-generate the display, the decode
  202. methodology is used.
  203.  
  204. * GIF and "Graphics Interchange Format" are trademarks (TM) of
  205. Compuserve, Inc., an H&R block company.
  206.  
  207.      When an image is originally created, the artist has decided
  208. which colors are to be used and has loaded these colors into a
  209. "palette". The next step is to "draw" the image. Each pixel of
  210. the image has one color assigned to it. The color is indicated by
  211. the palette entry, therefore a pixel whose color is 1, is using
  212. the color located in the first entry of the palette. If the color
  213. located in entry 1 is changed, the pixel will immediately change
  214. to the new color.
  215.  
  216.  
  217.  
  218.  
  219.                               4                            
  220.  
  221.  
  222.  
  223.     When the image is saved, the palette configuration and the
  224. color of each individual pixel is recorded, usually
  225. left-to-right, top-to-bottom.  Thus to restore the image, the
  226. file is read, the palette is loaded and the pixels are colored,
  227. left-to-right, top-to-bottom.
  228.  
  229.                            COLORS AND SYMBOLS
  230.  
  231.     When a GIF file is read into GIF2XTS, each palette entry is
  232. assigned a character. Entry 1 is a '!', entry 2 is a '\' and so
  233. on. There are 256 different characters that can be used (257
  234. including a background symbol). When an image is loaded, the
  235. LIGHTEST color in the palette will be used as the background
  236. against which the grid and all menus are drawn, the DARKEST color
  237. in the palette will be used for the grid lines and all text.
  238.  
  239.     EGA AND 16 COLOR VGA: 16 color monitors are limited to 16
  240. colors out of a possible 64. When an image is loaded, each of the
  241. RGB colors users are converted to the corresponding colors out of
  242. the possible 64 colors. The first 16 unique colors are then used
  243. to draw the image. The original color palette remains intact and
  244. will be used for DMC color assignment and symbol reduction.
  245.  
  246.                                OVERVIEW
  247.  
  248.      The purpose of this program is to take GIF files (some of
  249. which are great pictures) and change them into charted stitch
  250. patterns. The default maximum image size is 640 pixels x 480
  251. pixels. The simplest use is to load in a GIF image and create the
  252. hard copy of the chart.  
  253.  
  254.      Notations used: <alt> or <cntl> indicates to hold down the
  255. alt or cntl key while simultaneously depressing the indicated
  256. key. Thus <alt>R means hold down alt and depress the R key
  257. (upper/lower case is irrelevant) <cntl>page up means hold down
  258. the cntl key and depress the page up key. 
  259.  
  260.                           EXECUTION PARAMETERS
  261.                                     
  262.      Start the program by typing GIF2XTS. There are 2 optional
  263. parameters you can supply:
  264.  
  265.     L/l - set up the mouse as a left-handed mouse, that is swap
  266. the functions of the left and right buttons. If you use this
  267. option, remember to swap the words left and right when reading
  268. the documentation.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.                               5            
  275.  
  276.  
  277.  
  278.     P/p# - Direct the printer output to LPT#. The default is 
  279. LPT1: 
  280.  
  281. Any, all or none of these parameters can be supplied. The order
  282. does NOT matter.
  283.  
  284.                               SCREEN LAYOUT
  285.  
  286.      The screen shows a grid with every tenth line being a dashed
  287. line. Across the top of the screen is an  option bar presenting
  288. the various menus and options. Here is a brief description of the
  289. options, see the section entitled MENUS for complete details of
  290. the menus, see the section entitles GIF VIEWER MODE for details
  291. on View mode.
  292.  
  293.     FILE (F1) - this menu contains options related to file
  294. controls i.e. loading files, saving file, changing directories.  
  295.  
  296.     EDIT (F2) - this menu contains options related to editing the
  297. loaded image.
  298.  
  299.     VIEW (F3) - This menu allows you to either view the image as
  300. in a gif viewer, or view the symbols used in the image and the
  301. currently assigned DMC color number and name.
  302.  
  303.     DO CHART (F4) - This menus allows you to produce a chart of
  304. either the entire image or a section of the image
  305.  
  306.     INFORMATION (F5) - This menu presents you with information
  307. about the current image.
  308.  
  309.     LIBRARY (F6) - This menu allows you to create or edit library
  310. elements, and/or incorporate library elements into the current
  311. image. (SEE LIBRARY FOR MORE INFORMATION)
  312.  
  313.     HELP (F7) - this menu presents you with the various help
  314. topics available.
  315.  
  316.     CURRENT SYMBOL (F8) - this option allows you to change the
  317. current symbol that will be used when adding new symbols
  318.  
  319.     Across the bottom of the screen, and on the right and side
  320. are 2 scroll bars. The marker indicates which section of the
  321. image is currently being seen.
  322.      
  323.     If the entire height or width of the image is visible, then
  324. the corresponding scroll bar will be white, and will NOT respond
  325. to the mouse. 
  326.  
  327.  
  328.  
  329.                          6                                    
  330.  
  331.  
  332.  
  333.     When moving around the image, the edges of the image, and/or
  334. the grid, are indicated by a thick black line.
  335.  
  336.                     DIRECTORIES
  337.  
  338. The program keeps track of 4 independent directories:
  339.  
  340.    1) the current working directory This is the directory used    
  341.       for GIF and XTS file input and output. DEFAULT: directory   
  342.       where GIF2XTS is running.
  343.  
  344.    2) the print directory - This is the directory where charted   
  345.       gifs are stored. DEFAULT: \XTSPRT under the directory where 
  346.       GIF2XTS is running, it will be created.
  347.  
  348.    3) the library directory - This is the directory used for      
  349.       library element input and output. DEFAULT: \LIB under the   
  350.       directory where GIF2XTS is running, it will be created.
  351.  
  352.    4) The directory where GIF2XTS is running from - This is the   
  353.       place were the printer and machine configuration files are  
  354.       expected to be found.
  355.  
  356.     The first 3 directories can be changed via the file selection
  357. window.  If you change any directory, it will be "remembered"
  358. until it is changed again. In addition, you can change the
  359. defaults by using the configuration option on the FILE MENU and
  360. specify the default directories and DMC file to be used.
  361.  
  362.     The default file for RGB-DMC color mapping is MASTER.DMC,
  363. located in the same directory where GIF2XTS is located. This
  364. default can also be changed via the configuration menu. In
  365. addition, you can change the dmc file using the SELECT DMC DATA
  366. FILE on the FILE MENU. 
  367.  
  368.               MOUSE & KEYBOARD CONTROLS
  369.                           
  370.     Personally I can't stand the mouse and I object to any
  371. software that requires the mouse. Therefore, everything that can
  372. be done via the mouse can be done via the keyboard. The menu
  373. options can be invoked via an <alt> key combination. The key
  374. combination is indicated on the menu by a diamond followed
  375. by the key. This information is also available vie the help menu
  376. option "Keystrokes". 
  377.  
  378.     The menus themselves can be invoked by the corresponding
  379. Function key, F1 is FILE, F2 is edit and so on. 
  380.  
  381.  
  382.  
  383.  
  384.                               7                    
  385.  
  386.  
  387.  
  388.     All up and down scroll bars can be activated as follows:
  389.  
  390.     1) position the arrow on the marker,  depress the left mouse
  391. button and move the marker up and down.
  392.  
  393.     2) position the arrow on the up or down arrow and depress the
  394. left button    
  395.  
  396.     3) position the arrow in the black section above or below the
  397. marker and depress the left mouse button.
  398.  
  399.     As long as the mouse button is depressed, the marker will
  400. move. The arrows increment/decrement the marker by 1, the
  401. black section of the scroll bar moves the marker by 1 "page". A
  402. menu "page" is the next section of menu option, a grid "page" is
  403. the next section of the grid. Page Up and Page Down will also
  404. perform a "page" scroll.  The menu, file list or grid will NOT be 
  405. updated until the mouse button is released and the marker stops
  406. moving.
  407.  
  408.     The left and right scroll bars responds in an identical
  409. manner. The key combination to move the marker is <cntl>L to
  410. scroll 1 page left and <cntl>R to scroll 1 page right. 
  411.  
  412.    In addition the scroll bars for the grid will also respond to
  413. <cntl>Page Up to scroll to the top of the image, <cntl>Page Down
  414. to scroll to the bottom, <cntl>End to scroll to the far right of
  415. the image and <cntl>Home to scroll to the far left.
  416.  
  417.     The arrow itself will also respond to the keyboard. The arrow
  418. keys will move the arrow 1 space. The Home key will position the
  419. arrow at the furthest most left square and End will position the
  420. arrow the furthest most right square.
  421.  
  422.     All of the windows use the same format to present
  423. information. The CANCEL button or ESC key will terminate windows
  424. without performing any action. The OK button or ENTER will
  425. perform the selected action. To select from a list, position the
  426. arrow on the desired option and depress the left button. A
  427. highlight bar will appear indicating the selected option. Keeping
  428. the button depressed and moving the mouse will move the highlight
  429. bar up and down. Release the mouse button  and select OK to
  430. finish making a selection. To view more of a list, use the scroll
  431. bar.
  432.  
  433.     To make a selection via the keyboard, depress the S key to
  434. activate the highlight bar. Use the up and down arrow keys to
  435. move the highlight bar up and  down. When the desired option is
  436.  
  437.  
  438.  
  439.                          8                                            
  440.  
  441.  
  442.  
  443. highlighted, hit ENTER. Use Page Up and Page Down to active the
  444. scroll bars.
  445.  
  446.     If you have highlighted an option and then scroll, the
  447. highlight bar will go away and you will have to re-select and
  448. option. 
  449.  
  450.     To select a checkbox, such as a dithering algorithm, the
  451. keystroke is presented in parenthesis. Depressing the indicated
  452. key will 'X' the associated box, indicating that the option is
  453. selected. To use the mouse, position the arrow on the check box
  454. and depress the left button. To de-select a checkbox, select the
  455. box again. Some check boxes are exclusive, so that selecting
  456. another option may de-select the selected option.
  457.  
  458.     Editable text is presented in a box filled with the
  459. information to be edited. Select the box either by positioning
  460. the arrow on the box, of by depressing the associated key. A
  461. cursor marker will appear at the beginning of the text. The
  462. cursor can be moved left and right via the arrow keys. The DEL
  463. key will delete characters to the right of the cursor, the
  464. backspace arrow will delete the character to the left of the
  465. cursor. Additional characters can be inserted at the cursor
  466. marker. The maximum number of characters is limited by the length
  467. of the box.
  468.  
  469.     The window for selecting files for loading or saving files
  470. presents the current directory path and file extension used, a
  471. scrollable list of the files found in the directory, and an
  472. editable field. When loading a file, the editable field is blank.
  473. When a file is selected the editable field displays the file
  474. name. Selecting OK will load the selected file. When saving a
  475. file, the name of the previously loaded file, with the
  476. appropriate extension is presented in the editable field. To save
  477. using this file name, select OK. To save to a different file, 
  478. select desired file and select OK. To save to new and different
  479. file name, edit the name in the editable field and select OK.
  480.  
  481.     To change the directory, select ..\ to go up 1 level or
  482. select the directory name in the file list, to go down 1 level.
  483. The file list will be update to reflect the files in the new
  484. directory. The new directory will be saved and used for
  485. subsequent file selections.
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.                               9                            
  494.  
  495.  
  496.  
  497.  
  498.  
  499.                          KEY STROKES & HOT KEYS
  500.           
  501.      Right arrow/R/r - move mouse arrow 1 square to the right *
  502.      
  503.      Left arrow//L/r - move mouse arrow 1 square to the left *
  504.      
  505.      Up arrow/U/u - move mouse arrow 1 square up *
  506.      
  507.      Down arrow/D/d - move 1 mouse arrow square down *
  508.      
  509.      home/H/h - move mouse arrow to farthest left visible square
  510.      
  511.      end/E/e - move mouse arrow to the farthest right visible     
  512.                square
  513.      
  514.      page up - scroll up 1 screen height of the grid
  515.      
  516.      page down  - scroll down 1 screen height of the grid
  517.      
  518.      <cntl>R - scroll to the right 1 screen width of the grid  
  519.      
  520.      <cntl>L - scroll to the left 1 screen width of the grid
  521.      
  522.      <Cntl>Home - move to the left edge of the design *
  523.      
  524.      <Cntl>End - move to the right edge of the design *
  525.      
  526.      <Cntl>Page up - Move to the top of the design *
  527.      
  528.      <Cntl>Page down - Move to the bottom of the design *
  529.      
  530.      C/c - move to the center of the grid no matter where in the
  531.            grid you are
  532.  
  533.      F1 - File Menu
  534.      F2 - Edit Menu
  535.      F3 - View Menu
  536.      F4 - Do Chart Menu
  537.      F5 - Information Window
  538.      F6 - Library Menu
  539.      F7 - Help Menu
  540.      F8 - Change Current Symbol
  541.      <alt>A - Save Image as a GIF
  542.      <alt>B - Toggle Background Stitch on/off
  543.      <alt>C - Cut & Paste Edit
  544.      <alt>D - Use a different DMC data file
  545.  
  546.  
  547.  
  548.                                    10        
  549.  
  550.  
  551.  
  552.  
  553.  
  554.      <alt>E - Select a section to print
  555.      <alt>F - Change configuration
  556.      <alt>G - Load a GIF
  557.      <alt>I - Show Information about a GIF file
  558.      <alt>J - Show Information about an XTS file
  559.      <alt>M - Mass symbol update
  560.      <alt>N - Reduce number of symbols
  561.      <alt>P - Change Color Palette
  562.      <alt>Q - Quit without Saving
  563.      <alt>R - Restore current image
  564.      <alt>S - Scale current image
  565.      <alt>T - Toggle between B&W symbols and colored symbols
  566.      <alt>V - View current image in GIF Viewer
  567.      <alt>W - Print entire chart
  568.      <alt>X - Load XTS file
  569.      <alt>Z - Save XTS file
  570.      <alt>1 - View symbols and DMC color number and name
  571.      <alt>2 - Edit Rows and/or Columns
  572.      <alt>3 - Change current symbol color
  573.      <alt>6 - Load library element for editing
  574.      <alt>7 - Save library element
  575.      <alt>8 - Incorporate library element into image
  576.      
  577.     * These commands will also control the box in gif viewer mode
  578.      
  579.  
  580.                     EDITING CAPABILITIES
  581.               
  582.     There are 3 ways to edit the image. One method is a
  583. symbol-by-symbol method, another is to use the cut & paste option
  584. on the edit menu (SEE GIF VIEWER MODE FOR DETAILS), and finally
  585. the MASS UPDATE option on the EDIT menu (<ALT>M) can be used to
  586. change ALL OCCURRENCES of specified symbols.
  587.  
  588.      Symbols can be added to the pattern and deleted from the
  589. pattern using the ENTER key and DEL key, or the left and  right
  590. mouse buttons, respectively.  These keys will perform their
  591. actions on the grid square where the cursor is.  Symbols can be
  592. replaced by positioning the arrow on the symbol to be replaced,
  593. and hitting enter or the left mouse button. The Current Symbol
  594. will replace the previous symbol. With the mouse you can do
  595. repeated adds/deletes by continuing to hold down the mouse button
  596. as you move it. Any square the arrow passes over will have the
  597. symbol added or deleted. 
  598.  
  599.      In addition to editing 1 symbol at a time technique, the
  600.  
  601.  
  602.  
  603.                               11                                
  604.  
  605.  
  606.  
  607.  
  608. borders of the image can be adjusted. Using the Edit Menu, it is
  609. possible add rows or columns to the edges of the design. The
  610. border markers will be moved out 1 row/column. It is also
  611. possible to move the border IN to the current cursor position.
  612. When the borders are moved in, all symbols the are beyond the new
  613. border(s) are deleted. This technique can be used to trim or crop
  614. an image by positioning the cursor at the edges of the desired
  615. section, and moving the borders in.                               
  616.  
  617.  
  618.                         MENUS
  619.     
  620.     The menus are listed across the top of the screen. The hot
  621. keys for the menus is the corresponding function key. NOTE: IF
  622. YOU HAVE RE-DEFINED YOUR FUNCTION KEYS THEN THEY WILL NOT BE HOT
  623. KEYS.
  624.     
  625.      Every menu functions in the same manner, the options for the
  626. menu are presented in a scrollable list. The list can be scrolled
  627. either by the mouse or the keyboard. To select an option using
  628. the mouse, position the mouse arrow on the desired option and hit
  629. the left mouse button. Keeping the button depressed and moving
  630. the mouse will move the highlight box up and down. Moving the
  631. arrow off the menu list will shut off the highlight bar.
  632. Releasing the mouse button will leave the highlight bar on the
  633. selected option. After highlighting the desired option, click
  634. the OK button. Selecting CANCEL will terminate the menu with no
  635. action taken.  To select an option via the keyboard, depress
  636. the 'S' key and the highlight bar will appear. Using the up and
  637. down arrows, position the highlight bar on the desired option.
  638. Hit ENTER to activate the selected option, hit ESC to cancel.
  639.  
  640.                     FILE MENU (F1)
  641.  
  642.     The file menu has all the options for file input and output.
  643. From here you can select the image to load, where to save the
  644. current image, get information about an image, change the DMC
  645. file to use, change the configuration of the machine, either
  646. permanently or temporarily and exit from the program. The 10
  647. options are:
  648.  
  649. LOAD GIF FILE - This option will display a list of GIF files in
  650. the current directory. Select the GIF file to load, or change
  651. directories.OK/ENTER will load the selected file, CANCEL/ESC will
  652. NOT load.
  653.  
  654. LOAD XSTITCH FILE - This option will display a list of XTS files
  655. in the current directory. Select the XTS file to load, or change
  656.  
  657.  
  658.  
  659.                               12                                    
  660.  
  661.  
  662.  
  663.  
  664. directories. OK/ENTER will load the selected file, CANCEL/ESC
  665. will NOT load.
  666.           
  667. INFORMATION ABOUT GIF - This option will display a list of GIF
  668. files in the current directory. Select the GIF file for
  669. information, or change directories. If you select a file, the
  670. height and width will be display. At this point you can select to
  671. Load (ENTER) or Not Load (CANCEL) the GIF.
  672.  
  673. INFORMATION ABOUT XTS - This option will display a list of XTS
  674. files in the current directory. Select the XTS file for
  675. information, or change directories. If you select a file, the
  676. height and width will be display. At this point you can select to
  677. Load (ENTER) or No Load (CANCEL) the XTS.
  678.  
  679. SAVE CURRENT PATTERN (XTS) - This option will display a list of
  680. XTS files in the current directory. Select the XTS file to be
  681. written to, or enter a new file name. OK/ENTER will write to the
  682. file the symbols colors, the DMC information and the current
  683. image.  Although the image information is in standard GIF
  684. format, the rest of the information is unique to this program,
  685. and thus this file can ONLY be read by this program.
  686.  
  687. SAVE AS GIF FILE - This option will display a list of GIF files
  688. in the  current directory. Select the GIF file to be written to,
  689. or enter a new file name. OK/ENTER will create a standard GIF
  690. file that can be read by any GIF viewer.
  691.  
  692. QUIT (NO SAVE) - The program willl gracefully exit,without saving
  693. the current image.  
  694.      
  695. SAVE (XTS) & EXIT - This option is a combination of SAVE CURRENT
  696. PATTERN and QUIT.
  697.      
  698. SELECT DMC DATA FILE - This option will present a list of .DMC
  699. file in the current working directory. Select the file to use for
  700. subsequent images. The file will be read immediately and the DMC
  701. information will be assigned to the current image.
  702.  
  703. CHANGE CONFIGURATION - This option allows you to change the
  704. graphics resolution of the monitor, the maximum image height and
  705. width, the spacing for the dashed lines and the default startup
  706. directories and files. The maximum height multiplied by the
  707. maximum width cannot exceed the largest amount of free memory.
  708. This information can be saved and will then be the default
  709. configuration, or it can set for just the current session. 
  710.  
  711.  
  712.  
  713.  
  714.                               13
  715.                                                                                                                                                                         
  716.  
  717.  
  718. WARNING: IF YOU SET THE GRAPHICS SCREEN RESOLUTION FOR GREATER
  719. THAN YOUR MONITOR/VIDEO CARD CAN HANDLE YOU WILL DAMAGE YOUR
  720. MONITOR/CARD. IT IS YOUR RESPONSIBILITY TO KNOW THE MAXIMUM
  721. RESOLUTION. I AM NOT RESPONSIBLE FOR DAMAGE CAUSED BY SETTING THE
  722. RESOLUTION TOO HIGH. 
  723.  
  724.                     EDIT MENU (F2)
  725.  
  726.     The edit menu contains 10 options for changing both the image
  727. and the presentation of the image. 
  728.  
  729. MASS SYMBOL UPDATE - This option performs deletion, addition and
  730. replacement of all occurrences of specified symbols. When this
  731. option is selected a second window presents the options for Mass
  732. Update. These options are:
  733.      
  734. 1) RE-INITIALIZE GRID - Clear the grid of all symbols and reset
  735. the size of the grid to the maximum height and width, and reset
  736. the color palette.
  737.      
  738. 2) DELETE 1 SYMBOL - A window displaying all the symbols is
  739. presented with a "select symbol to delete" message across the 
  740. top. Select the desired symbol by selecting the associated
  741. checkbox. The arrow starts at the current symbol. The arrow will
  742. move according to the mouse or via the arrow keys. When the
  743. desired symbol is selected, select OK (Enter).  To abort this
  744. function select CANCEL.
  745.      
  746. 3) REPLACE 1 SYMBOL WITH ANOTHER - A window displaying all the
  747. symbols is presented with a "Replace This symbol...." message
  748. across the top. Select the desired symbol by selecting the
  749. associated checkbox. The arrow starts at the current symbol. The
  750. arrow will move according to the mouse or via the arrow keys. To
  751. abort this function select CANCEL.  When the desired symbol is
  752. selected, select OK (Enter). The message has "...With This
  753. Symbol" appended to it.  Select the symbol to be used for
  754. replacement. Select OK to perform the replacement, select CANCEL
  755. to abort process.
  756.      
  757. 4) FILL BLANK SQUARES WITH A SYMBOL - A window displaying all the
  758. symbols is presented with a "Select symbol to fill in blanks"
  759. message across the top. Select the desired symbols by selecting
  760. the associated checkbox. The arrow starts at the current symbols. 
  761. The arrow will move according to the mouse or via the arrow keys.
  762. When the desired symbol is selected, select OK (Enter). To abort
  763. this function select CANCEL.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.                          14    
  770.  
  771.  
  772.  
  773. SCALE - This option allows the image to be scaled up or down, in
  774. or out. In the lower left corner of the window is the current
  775. size in stitches and inches. As scale options are selected and
  776. changed, this information is updated. The scale options are:
  777.      
  778. 1) SCALE HEIGHT UP (U) - Select this option to increase the
  779. HEIGHT of the image. A second line will appear: (R) Expand 1 row
  780. into X, where X is an editable field.
  781.      
  782. 2) SCALE HEIGHT DOWN (D) - Select this option to decrease the
  783. HEIGHT of the image. A second line will appear: (R) Combine X
  784. rows into 1, where X is an editable field.
  785.      
  786. 3) SCALE WIDTH OUT (O) - Select this option to increase the WIDTH
  787. of the image. A second line will appear: (C) Expand 1 row into X,
  788. where X is an editable field.
  789.      
  790. 4) SCALE WIDTH IN (I) - Select this option to decrease the WIDTH
  791. of the image. A second line will appear: (C) Combine X rows into
  792. 1, where X is an editable field.
  793.      
  794. After setting the scale options, select OK, or hit the Enter key.
  795. You will be put into GIF viewer mode, showing the image as it
  796. looks with the scale factors applied. From here you can save the
  797. image, or not. (See GIF VIEWER MODES for more information about
  798. the various GIF viewer modes)
  799.  
  800. CUT & PASTE - This option will put you into GIF viewer mode. In
  801. this mode the box can be used to encompass the section of the
  802. image to the moved, copied or deleted. See GIF VIEWER MODES for
  803. the various options.
  804.  
  805. EDIT ROWS/COLUMNS - The option allows you to add or insert blanks
  806. rows and/or colunms, or delete or clip rows and/or columns from
  807. the image. A window presents 2 groups of options, the ACTION to
  808. be performed and the DIRECTION of the action. The actions are:
  809.      
  810. Add (A) - Add to the EDGE of the image
  811. Insert (I) - Insert within the image
  812. Delete (D) - Delete within the image
  813. Clip (C) - Delete everything to the edge and move the edge to a
  814. new position. 
  815.      
  816. Any 1 of these options can be selected. The next 4 options
  817. control the DIRECTION of the action:
  818.      
  819. Left (L)
  820.  
  821.  
  822.  
  823.  
  824.                               15
  825.  
  826.  
  827.  
  828.  
  829. Right (R)
  830. Top (T)
  831. Bottom (B)
  832.      
  833. Any and all of these directions can be selected at the same time.
  834.  
  835. Finally, for Add, Insert and Delete you can change the NUMBER of
  836. rows and/or columns to Add, Insert or Delete:
  837.  
  838. This Many (#): The default is 1, but this can be changed.
  839.  
  840. If you selected Insert or Delete you will be prompted to position
  841. the mouse at the row or column where you wish the insertion or
  842. deletion to begin. You will receive this message once for every
  843. direction you choose, thus if you selected to insert 1 row/column
  844. in all 4 directions you will be prompted 4 times to specify a
  845. location. The prompt will contain information about the
  846. direction. 
  847.  
  848. CHANGE SYMBOL COLOR - This option will present the entire color
  849. palette from which  you can select the color to be used by the
  850. current symbol. There may be 2 "pages" of colors. Select Next or
  851. Prev to switch between pages. The arrow will respond to both the
  852. mouse movement, and the arrow keys.
  853.  
  854. CHANGE COLOR PALETTE - This option will also present the entire
  855. color palette. When you have selected the color you wish to 
  856. change, a window will display a large colored square and 3 scroll
  857. bars. At the top of each scroll bar is a number. As indicate by
  858. the label at the bottom of each scroll bar, each bar represents
  859. the red, green and blue components of the selected color.
  860. Changing the amount of red, green and/or blue will change the
  861. color. You can change the red, green or blue by either sliding
  862. the scroll thumb up or down, or by selecting the number at the 
  863. top of the bar, and typing in a new value. The valid value range
  864. is 0 to 255. Using the keyboard, R will active the red bar, G the
  865. green and B the blue. The thumb will respond to the page up and
  866. page down keys. Once the new color is ready, select OK/enter and
  867. the new color will replace the old.
  868.  
  869. TOGGLE COLOR/B&W SYMBOLS - This option will toggle between
  870. displaying colored symbols in the grid and displaying "black"
  871. symbols in the grid. 
  872.  
  873. TOGGLE BACKGROUND SYMBOLS - This option will change every blank
  874. square to a "background symbol", using the background colored
  875. defined for the image.
  876.  
  877.  
  878.  
  879.                               16    
  880.  
  881.  
  882.  
  883. REDUCE NUMBER OF SYMBOLS - This option will let you reduce the
  884. total number of symbols used in the image. The process of
  885. reducing the number of symbols involves creating a new color
  886. palette and then remapping (with or without dithering) the old
  887. image to a new image. Since this involves reading every single
  888. symbols twice, the bigger the image, the longer it takes.
  889. Messages identifying the various steps are displayed.  
  890.  
  891. The window pre sents 2 categories of options: How many symbols to
  892. reduce to and What algorithm to use (if any) after creating the
  893. new color palette.  You can reduce the number of symbols to:
  894.      
  895. No More Than 8 Symbols (1)
  896. No More Than 16 Symbols (2)
  897. No More Than 32 Symbols (3)
  898. No More Than 64 Symbols (4)
  899. No More Than 128 Symbols (5)
  900.      
  901. The phrase "No More Than" is used because depending on the
  902. initial color palette,  you may not get EXACTLY 8 symbols, it
  903. might be 7 or even 5.
  904.  
  905.     There are 7 different algorithms that can be selected for
  906. adjusting the image to the new palette. These options are:
  907.       
  908. Floyd Dither Algorithm (F)
  909. Stucki Dither Algorithm (S)
  910. Burkes Dither Algorithm (B)
  911. ReMap - No Dither (R)
  912. Magic Square Matrix (M)
  913. Dispersed Dot Matrix (D)
  914. Clustered Dot Matrix (C)
  915.     
  916. When an image has the number of colors reduced, a brand new
  917. palette is created. This new palette is created by determining
  918. the most commonly used colors and the most unique colors in the
  919. exiting palette. After creating the NEW palette, every single
  920. symbol is then examined to determine which color in the NEW
  921. palette is the BEST substitute for the color in the OLD palette. 
  922. This is a simple re-map, without any dithering. Most of the time,
  923. the resulting image is so-so. In an attempt to make a "better"
  924. image there are 6 different dithering algorithms. The first 3
  925. options are different mathematical filters. 
  926.  
  927.      As the new color for each occurrence of each symbol is
  928. determined, an "error" is computed. This error indicated how far
  929. "off" the new RGB is from the old RGB. This error is than
  930.  
  931.  
  932.  
  933.  
  934.                               17        
  935.  
  936.  
  937.  
  938. distributed, adding or subtracting a number to the R, G and B
  939. values of the surrounding pixels. Each filter uses a different
  940. calculation for this distribution.  For more details about the
  941. math involved in each algorithm, see the section entitled
  942. DITHERING ALGORITHMS.
  943.  
  944. There are also 3 Matrix filters. These 3 matrixes provide a
  945. pattern for dithering. The Magic Square matrix is a pretty good
  946. matrix. The Dispersed Dot matrix uses a crosshatched pattern
  947. while Clustered-Dot uses a pattern similar to the pattern used by
  948. newspapers. All 3 were provided by the graphics library I use,
  949. and as such I don't have any way to provide any feedback while
  950. it's working. 
  951.  
  952. RESTORE IMAGE - This option will restore the original image by
  953. re-decoding the GIF or XTS file. 
  954.  
  955.                     VIEW (F3)
  956.    
  957.     There are 2 options on the view menu: View image and View
  958. symbols.Selecting View image will put you in GIF viewer mode.
  959. (See GIF VIEWER MODES for details of the various functions that
  960. can be performed.) The image will be drawn without the grid
  961. lines, but with a box showing the section of the image that was
  962. visible in grid mode. The box can be moved and new location
  963. selected.
  964.  
  965.     View Symbols will present you with a scrollable list of all
  966. the symbols currently used in the image, and the DMC color number
  967. and color name assigned to the symbol. This color number and name
  968. can be changed by selecting a symbol. The DMC information will
  969. appear in 2 appropriately labeled files. You can selected either
  970. field and change, edit or erase the information. 
  971.  
  972.     You can also get a copy of just the symbol table by selecting
  973. PRINT. This copy can either be printed or put to a GIF file. If
  974. you choose to create a GIF file of the symbol table, you will be
  975. presented a window showing the files in the current print
  976. directory.  You can change the directory, select a file, or enter
  977. a name for a new file. The symbol table will then be encoded
  978. to the file. 
  979.  
  980.     If you choose to print to the printer you will be presented
  981. the following information:      
  982. Page Height (H):
  983. Page Width (W):
  984. Title etc (T):
  985.      
  986.  
  987.  
  988.  
  989.                          18        
  990.  
  991.  
  992.  
  993.     Changing the Page height and/or width will change how much of
  994. the symbol table can be printed in each page. Using the Title
  995. field, you can add up to 50 characters for a title, copyright or
  996. other information. Select OK when the information is correct.
  997.  
  998.                          DO CHART (F4)
  999.  
  1000.     This option allows you to create a chart of the current
  1001. image. You can select to create the full chart, or create a chart
  1002. of a section of the image. If you choose to select a section of
  1003. the image to chart,  you will be put into gif viewer mode to
  1004. select the section.  If there is no gifxtspt.cfg file present, a
  1005. GIF file is the default, otherwise the printer is the default. To
  1006. create a gifxtspt.cfg file see the section entitled
  1007. "CONFIGURING/SELECTING A PRINTER" 
  1008.  
  1009.     In either case, when you are ready to create the chart you
  1010. have 2 options:  Print the chart on the printer or create a GIF
  1011. file of the chart.  If you choose to create a GIF file of the
  1012. chart, you will be presented a window showing the files in the
  1013. current print directory. You can change the directory, select a
  1014. file, or enter a name for a new file. The image will then be
  1015. charted to the file.
  1016.  
  1017.     If you choose to print to the printer you will be presented
  1018. the following information:
  1019.      
  1020. Page Height (H):
  1021. Page Width (W):
  1022. Title etc (T):
  1023.      
  1024.     Changing the Page height and or width will change how much of
  1025. the chart can be printed in each page. Using the Title field, you
  1026. can add up to 50 characters for a title, copyright or other
  1027. information.
  1028.  
  1029.     At this point you wil also have to select the Dots Per Inch
  1030. (DPI) that you want the printer to use. The avaialble DPI options
  1031. are presented as checkboxs. Select the density you want to use.
  1032. The higher the DPI, the smaller the squares. Select OK when the
  1033. information is correct. 
  1034.  
  1035.     In addition to any title, on the top of each page will ba a
  1036. page number, for example page 1.1, page 1.2, page 2.1 The first
  1037. number is the "column" the second number is the row. This
  1038. information is presented to help with multi-paged charts.
  1039.  
  1040.  
  1041.  
  1042.  
  1043.                          19        
  1044.  
  1045.  
  1046.  
  1047.  
  1048.     If the chart of the image plus the symbol table take up more
  1049. than 1 page, the symbol table will be printed on a separate page.
  1050.  
  1051.                     INFORMATION MENU (F5)
  1052.  
  1053.     The information menu presents the information for the current
  1054. image, including the size in stitches and inches and the current
  1055. evenweave count. Any and all of these bits of information can be
  1056. changed and the associated information will reflect the change.
  1057. But NO physical change is made to the image until OK is selected.
  1058.  
  1059.     To change any field, select the box where the information is,
  1060. or depress the associated key. A cursor marker will appear at the
  1061. far left of the box. As long as the cursor marker is visible the
  1062. field can be edited. The marker moves via the left and right
  1063. arrows, the home and end keys, and the backup and delete key.
  1064. After makeing your changes, select  OK or hit enter. If you
  1065. changed the Image height and/or width, in stitches or inches, you
  1066. will be put into the GIF Viewer Mode to view the resulting image.
  1067. (See GIF VIEWER MODE for information about the various modes and
  1068. menus). If  you changed the EvenWeave count you will return to
  1069. the grid, with no visible changes. 
  1070.  
  1071.                     LIBRARY (F6)
  1072.  
  1073.     The library function allows you to incorporate other GIF
  1074. images into the current image. A library element is defined as
  1075. any GIF file located in the directory defined as the library.
  1076. There are 3 options on the menu: 
  1077.  
  1078. EDIT LIBRARY ELEMENT - This option allows you to load a GIF image
  1079. from the library directory and edit it. The library directory can
  1080. be changed to any directory. The default directory is /LIB under
  1081. the directory where GIF2XTS is running from. 
  1082.  
  1083. SAVE LIBRARY ELEMENT - This option allows you to save the current
  1084. image into the library directory for later incorporation.
  1085.  
  1086. INCORPORATE LIBRARY ELEMENT - This option allows you to select an
  1087. image from the current library directory to incorporate into the
  1088. current image. After selecting the element, you will be switched
  1089. into GIF Viewer mode. This box indicates the relative of the
  1090. selected library element. The box can be moved around, the size
  1091. changed until it is positioned where you want the element.
  1092. Hitting the left mouse button/Enter will incorporate the element
  1093. into the image. See GIF VIEW MODE for other details of the gif
  1094. viewer mode. 
  1095.  
  1096.  
  1097.  
  1098.                          20
  1099.  
  1100.  
  1101.  
  1102.  
  1103.                          HELP (F7)
  1104.    
  1105.     This menu contains extracts from this document. The menu
  1106. options are:
  1107.      
  1108. SCREEN LAYOUT
  1109. MENUS
  1110. FILE
  1111. EDIT
  1112. SYMBOL
  1113. VIEW
  1114. VIEW IMAGE
  1115. VIEW SYMBOLS
  1116. PRINTING CHART
  1117. INFORMATION/RESIZE
  1118. SCALE
  1119. KEYSTROKES
  1120. LIBRARY FUNCTION
  1121. GIF VIEW MODES
  1122. DMC COLORS
  1123. COLOR/SYMBOL REDUCTION
  1124.     
  1125.                     CURRENT SYMBOL (F8)
  1126.  
  1127.     The current symbol is the symbol that will be added to the
  1128. image. To select another symbol, select the CURRENT SYMBOL or
  1129. depress F8. This will present a window of all the symbols.  The
  1130. current symbol has an 'X' in the associated checkbox. To select a
  1131. new symbol to be used as the current symbol, move the 'X' to a
  1132. new symbol. OK will save this symbol as the current, CANCEL will
  1133. terminate this function.
  1134.  
  1135.                          GIF VIEWER MODES
  1136.  
  1137.     There are 6 functions that use a GIF viewer mode. Each of
  1138. these functions has it's own menu. Whenever you start a GIF
  1139. viewer function, or change a gif viewer function, a message will
  1140. remind you that to get the menu for the function, hit Enter/left
  1141. mouse button.  Each menu has 8 identical options:
  1142.  
  1143. RETURN TO GRID - This option will return you to grid mode showing
  1144. the same section of the image that was visible  before entering
  1145. the gif viewer mode.
  1146.  
  1147. PRINT ENTIRE IMAGE - This option will chart the entire image as
  1148. you currently see it. As with the chart option on grid mode, you
  1149. will be able to create either a GIF of the chart or a hard copy
  1150. of the chart. If you have changed the size of the image, either
  1151.  
  1152.  
  1153.  
  1154.                               21
  1155.  
  1156.  
  1157.  
  1158. by scaling or re-sizing, the chart be printed exactly as you are
  1159. viewing it.
  1160.  
  1161. SCROLL IMAGE - If the dimensions of the image are greater than
  1162. the screen resolution, you can scroll the image. Two scroll bars
  1163. will appear, one down the right side of the image, and one across
  1164. the bottom. Using the scroll bars you can change the section of
  1165. the image that you are viewing.
  1166.  
  1167. CHANGE TO  SIZE FUNCTION 
  1168. CHANGE TO SCALE FUNCTION
  1169. CHANGE TO PRINT FUNCTION
  1170. CHANGE TO LIBRARY FUNCTION
  1171. CHANGE TO EDIT FUNCTION
  1172. CHANGE TO VIEW FUNCTION - Each of these options will change the
  1173. menu you get when you hit enter. You will reminded to hit enter
  1174. to get the menu, because physically the only change the screen
  1175. may be the appearance, or disappearance of the box. PRINT,
  1176. LIBRARY, EDIT and VIEW use the symbol table to perform their
  1177. functions. Therefore if you change to these modes and HAVE NOT
  1178. saved the  current image to the symbol table, you will be given
  1179. the option to either save the current image, or restore the 
  1180. original image. You cannot PRINT, EDIT, INCORPORATE LIBRARY
  1181. ELEMENTS, or VIEW a scaled or re-sized image.
  1182.  
  1183.                          VIEW MODE
  1184.    
  1185.     This mode is a simple VIEW of the image. The box represents
  1186. the section of the image that was visible in grid mode. There two
  1187. additional menu options. 
  1188.  
  1189. MOVE BOX - The box will now respond to the movement of the mouse
  1190. or the arrow keys, Home and End keys, Page Up and  Page Down, and
  1191. the <CNTL>L, <CNTL>R, <CNTL>Page Up and <CNTL>Page Down key
  1192. combinations. Hitting enter or the left mouse button will
  1193. terminate this option, leaving the box wherever it may be. 
  1194.  
  1195. SAVE THIS LOCATION - This option will return you to grid mode
  1196. showing the section of the image that was enclosed in the box.
  1197.  
  1198.                     SELECT SECTION TO PRINT 
  1199.  
  1200.      This mode will allow you to define a section of the image to
  1201. chart. 
  1202.  
  1203. MOVE BOX - The entire box will follow the movement of the mouse.
  1204.  
  1205. MOVE TOP EDGE OF BOX
  1206.  
  1207.  
  1208.  
  1209.                          22        
  1210.  
  1211.  
  1212.  
  1213. MOVE BOTTOM EDGE OF BOX
  1214. MOGE LEFT EDGE OF BOX
  1215. MOVE RIGHT EDGE OF BOX - These options allow you to move any 1
  1216. side  of the box. The selected side will move in accordance to
  1217. the or via the same keystrokes that move the entire box.
  1218.  
  1219. CHART THIS SECTION - The area encompassed by the box will be
  1220. charted.  You will be given the option to chart to a GIF file or
  1221. to the printer.If you choose to create a GIF file of the  chart,
  1222. you will be presented a window showing the files in the current
  1223. print directory.  You can change the  directory, select a file,
  1224. or enter a name for a new file. The image will  then be charted
  1225. to the file. 
  1226.  
  1227.     If you choose to print to the printer you will be presented
  1228. the following information: 
  1229.      
  1230. Page Height (H):
  1231. Page Width (W):
  1232. Title etc (T):
  1233.      
  1234.    Changing the Page height and/or width will change how much of
  1235. the chart can be printed in each page. Using the Title field, you
  1236. can add up to 50 characters for a title, copyright or other
  1237. information. At this point you wil also have to select the Dots
  1238. Per Inch (DPI) that you want the printer to use. The avaialble
  1239. DPI options are presented as checkboxs. Select the density you
  1240. want to use. The higher the DPI, the smaller the squares. Select
  1241. OK when the information is correct. 
  1242.  
  1243.      In addition to any title, on the top of each page will be a 
  1244. page number, for example page 1.1, page 1.2, page 2.1 The first
  1245. number is the "column" the second number is the row. This
  1246. information is presented to help with multi-paged charts.
  1247.  
  1248.      If the chart of the image plus the symbol table take up more
  1249. than 1 page, the symbol table will be printed on a separate page.
  1250. The symbols table will have only the symbols that are  used in
  1251. this section of the image.
  1252.  
  1253.  
  1254. ABOUT THIS SECTION.... - This option will give you the stitch
  1255. size of the current section. 
  1256.  
  1257.                          SCALE IMAGE
  1258.   
  1259.     This mode will show how the image will look if the scaling
  1260. factor is applied. The menu has the following options:
  1261.  
  1262.  
  1263.  
  1264.                          23        
  1265.  
  1266.  
  1267.  
  1268. SAVE THIS SIZE - The current size can be saved either to as an
  1269. XTS file and/or to the symbol table. If you choose the XTS  
  1270. file, you will be presented with a list of XTS files in the
  1271. current directory. Select a file, or enter a new file name. 
  1272. Unless you save to the symbol table, you will be reminded that
  1273. the new size was NOT save when you return to grid mode.
  1274.  
  1275. RESET TO ORIGINAL SIZE - This option will restore the image to
  1276. it's original size.  
  1277.  
  1278. SCALE MENU - This option will present the scale menu. You can 
  1279. change the scale factors. The current scale factors will be shown
  1280. in the edit windows. Any additional scaling will be  performed on
  1281. THIS image, NOT the original image.
  1282.  
  1283.                     CHANGE SIZE OF IMAGE
  1284.  
  1285.     This option displays the new size of the image, as specified
  1286. on the Information menu. 
  1287.  
  1288. SAVE THIS SIZE - The current size can be saved either to as an
  1289. XTS file and/or to the symbol table. If you choose the XTS  
  1290. file, you will be presented with a list of XTS files in the 
  1291. current directory. Select a file, or enter a new file name.
  1292. Unless you save to the symbol table, you will be reminded that
  1293. the new size was NOT save when you return to grid mode.
  1294.  
  1295. RESET TO ORIGINAL SIZE - This option will restore the image to
  1296. it's original size. 
  1297.  
  1298.  
  1299. SIZE MENU - This option will present the size/information menu. 
  1300. You can change the current size. The current size is the size of
  1301. the image being shown. 
  1302.  
  1303.                     INCORPORATE LIBRARY IMAGE
  1304.  
  1305.     This mode will allow you to incorporate library images into
  1306. the current image. The box defines the size of the library 
  1307. element. 
  1308.  
  1309. MOVE BOX - The box will now follow the movement of the mouse,
  1310. and/or respond to the arrow keys.
  1311.  
  1312. CHANGE BOX SIZE - This option allows you to change the size of
  1313. the box. Up/down mouse movements will increase/decrease  the
  1314. height.  Left/right will  increase/decrease the width.  When the
  1315.  
  1316.  
  1317.  
  1318.  
  1319.                          24            
  1320.  
  1321.  
  1322.  
  1323. library element is incorporated it will be scaled up or down in
  1324. accordance to the box size.
  1325.  
  1326. SHOW BOX DIMENSIONS - This option will show you the current size
  1327. of the box. 
  1328.  
  1329. RESET BOX SIZE - This option will reset the box to the original
  1330. element size.
  1331.  
  1332. PUT HERE - This option will incorporate the element into the
  1333. image at the current box location and size.
  1334.  
  1335. GET ANOTHER - This option will present a file listing of the
  1336. current library directory. Another library element can be
  1337. selected and incorporated.
  1338.  
  1339.                          CUT AND PASTE
  1340.  
  1341.     This option lets you select a section of the image and delete
  1342. it, move it or copy it. The menu options are:
  1343.  
  1344. MOVE BOX - The entire box will follow the movement of the mouse.
  1345.  
  1346. MOVE TOP EDGE OF BOX
  1347. MOVE BOTTOM EDGE OF BOX
  1348. MOVE LEFT EDGE OF BOX
  1349. MOVE RIGHT EDGE OF BOX - These options allow you to move any 1
  1350. side  of the box. The selected side will can be controlled either
  1351. by the mouse movement of by the keyboard. 
  1352.  
  1353. DELETE CONTENTS OF BOX - Everything within the confines of the
  1354. box will be deleted.
  1355.  
  1356. MOVE CONTENTS OF BOX
  1357. COPY CONTENTS OF BOX - Everything within the confines of the box
  1358. will be captured. The box will now respond to the movement of the
  1359. mouse. When the box is where you want the selected section to be,
  1360. hit the left mouse button/enter. The original section will be
  1361. moved/copied to the new section. 
  1362.  
  1363.        
  1364.        SYMBOL REDUCTION/DITHERING ALGORITHMS
  1365.  
  1366.      For those of you interested in the mathmatical calculations
  1367. performed for the different dithering algorithms, this section
  1368. is extracted from Steve Rimmers SUPERCHARGED BITMAPPED GRAPHICS
  1369. published by WindCrest Books, an imprint of TAB books a division
  1370. of MacGraw-Hill pages 579-580
  1371.  
  1372.  
  1373.                
  1374.                               25
  1375.  
  1376.  
  1377.  
  1378.  
  1379.     "...The process of dithering images being remapped is called
  1380. error diffusion. Error diffusion is handled using a diffusion
  1381. "filter" of which there are quite a few around. The most commonly
  1382. encountered one is the Floyd-Steinberg filter.  It's drawn like
  1383. this: 
  1384.  
  1385.    X  7
  1386. 3  5  1
  1387.  
  1388.     In this diagram, the X represents the pixel to be remapped.
  1389. The other numbers represent adjacent pixels. The 5, for example,
  1390. is the pixel one line down and immediately below the pixel being
  1391. remapped. In looking at error diffusion filter diagrams, any
  1392. pixels that extend beyond the edges of the picture are ignored.
  1393.  
  1394.     In this filter all the numbers add up to 16. The numbers
  1395. represent the numerators of fractions whose denominators are 16.
  1396. These fractions represent the proportion of the total error to be
  1397. diffused to each of the pixels in the diagram. 
  1398.  
  1399.     To apply this filter to remapping an image, then, you would
  1400. begin with the first pixel.... Having found the nearest match for
  1401. it in the destination palette, you would derive a color error for
  1402. the two RGB values by subtracting the destination red value from
  1403. the source red value, the destination green value from the source
  1404. green value, and the destination blue value from the source blue
  1405. value. We'll call these three numbers rd, gd, and bd
  1406. respectively. 
  1407.  
  1408.     Having derived the color error for the pixel being remapped,
  1409. it can be replaced be the palette entry in question. 
  1410.  
  1411.     Looking at the filter diagram, the pixel to the immediate
  1412. right of the one being remapped should recieve 7/16 of the color
  1413. error. As such, you would find the red value for this pixel and
  1414. add (rd X 7)/16 to it. The same thing can be done for the green
  1415. and blue values. Having done this, you would repeat the process
  1416. for any other pixels affected by this filter. The pixel indicated
  1417. by 3 would be ignored in this case, as it extends beyond the left
  1418. edge the of the picture if you're working with the first pixel in
  1419. a line.
  1420.  
  1421.     Having remapped and diffused one pixel, the filter moves
  1422. right by 1 pixel and the whole circus can start again.....
  1423. Error-diffused dithering can produce distinctly better results if
  1424. you scale a source image up and then dither it. 
  1425.  
  1426.  
  1427.  
  1428.  
  1429.                               26    
  1430.  
  1431.  
  1432.  
  1433.      The results of error-diffused dithering are also affected by
  1434. the filter you use. A filter that communicates with a larger
  1435. number of pixels usually produces more attractive results, as it
  1436. is less likely to make the picture look as if it has a pattern
  1437. built into it. The Stucki filter, for example, usually does much
  1438. better work than the Floyd-Steinburg filer. It looks like this:
  1439.  
  1440.       X  8  4
  1441. 2  4  8  4  2
  1442. 1  2  4  2  1
  1443.  
  1444.     The Stucki filter works with fractions of the color error in
  1445. which the denominator is 42, the sum of alll  the numbers in the
  1446. filter diagram. It's pretty slow compared to the Floyd-Stienburg
  1447. filer. 
  1448.  
  1449.     The Burkes filers is somewhere in between the two preceding
  1450. filter.  It looks like this:
  1451.  
  1452.        X  8  4
  1453.  2  4  8  4  2
  1454.  
  1455. ......."
  1456.  
  1457.  
  1458.                     A FEW WORDS ABOUT SPEED
  1459.  
  1460.     The production of the chart is NOT fast. On my machine (an AT
  1461. compatible) a 640x480 image charted to a GIF file takes 30
  1462. minutes. Why does it take sooooo long?  To create the chart,
  1463. reach individual symbol is converted to an 10x10 dotted symbol.
  1464. Thus ! becomes
  1465.                .
  1466.           .    .
  1467.          ...   .
  1468.         .....  .
  1469.         .....  .
  1470.         .....  .
  1471.          ...   .
  1472.                .
  1473.           .    .
  1474.                .
  1475.  
  1476. Therefore each image row is printed as a chart by making 10 rows
  1477. (and a line).  I'll gladly take any suggestions for speeding up
  1478. the printing and/or creating of the GIF image of the chart.
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.                               27            
  1485.  
  1486.  
  1487.  
  1488.                REVISION HISTORY
  1489.  
  1490.      This is a brief list of the enhancements and fixes for each
  1491. version of GIF2XTS. For detail information of the enhancements
  1492. see the appropriate section.
  1493.  
  1494. June 1994 - Version 5.0
  1495. 1) add sVGA 256 color support
  1496.  
  1497. 2) Automatic use of XMS, EMS or virtual memory
  1498.  
  1499. 3) Full complement of 256 symbols, plus a "background" symbols
  1500. for  a total of 257 different symbols.
  1501.  
  1502. 4) Symbol/color reduction with optional dithering algorithms 
  1503.  
  1504. 5) Special color manipulations for 16 color monitors to give
  1505. "better" looking images. 
  1506.  
  1507. 6) Screen resolution and maximum GIF image size under complete 
  1508. user control. Can be adjusted "on the fly". The only limitation
  1509. is the total amount of free XMS, EMS or virtual memory available.
  1510.  
  1511. 7) Added DMC color number and color name assignment based on RGB 
  1512. value of color.
  1513.  
  1514. 8) REGISTERED USERS ONLY: 2 utility  programs are available:
  1515.      1) Convert - a simple conversion program from PCX, BMP, IFF
  1516. and LBM to GIF
  1517.       2) RGB2DMC - Create your own files mapping the RGB values
  1518. to a DMC color number and name.
  1519.  
  1520. October 1993 - Version 4.3
  1521. 1) Only printing first page of chart on Laser Jet printers -
  1522. FIXED
  1523.  
  1524. 2) If printing from different directory or drive program would
  1525. hang - FIXED
  1526.  
  1527. June 1993 - Version 4.2
  1528.  
  1529. 1) Error message for insufficient memory was hanging - FIXED
  1530.  
  1531. June 1993 - Version 4.1
  1532.  
  1533. 1) Problem running on Super-VGA - FIXED
  1534.  
  1535.  
  1536.  
  1537.  
  1538.                               28            
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544. May 1993 - Version 4.0
  1545.  
  1546. Program renamed to GIF2XTS because the zipped file as now
  1547. self-extracting and as such is named GIF2XTS.exe. If I kept the
  1548. program name the same as the  self-extracting executable I would
  1549. overlay the self extracting executable.  So I changed the name of
  1550. the program.
  1551.  
  1552. First the fixes and modifications:
  1553. 1) I removed EGA monochrome. It never did work right.
  1554.  
  1555. 2) The program now needs 510K/512K (registered/non-registered) 
  1556. of free memory to load and will give you a message if there
  1557. is not enough memory to run. No more than an additional 2K may be
  1558. needed during the printing option of the program depending on
  1559. the size of the chart you are printing.
  1560.  
  1561. 3) You can now specify a SIZE that is greater than twice the
  1562. current size. That is, if the image is 100 and you want it to be
  1563. 225, you can specify 225. In earlier version(s) you had to scale
  1564. up by 2 to 200 and then specify 225.
  1565.  
  1566. 4) You can specify the scale or size for BOTH directions at the
  1567. same time. Previously you could only to 1 direction at a time.
  1568.  
  1569. 5) You can go between functions that use a GIF viewer WITHOUT 
  1570. returning to the grid. That is, you can scale the image, and then
  1571. go the size options without, generally, redrawing anything.
  1572.  
  1573. 6) The program now supports LOTS more printers, including Laser
  1574. Jets, Paint Jets, Desk Jets and 24-Pin printers, in  addition
  1575. to the 9-Pin printers previously supported. RIGHT NOW ONLY EPSON
  1576. EMULATION IS SUPPORTED. IF YOU HAVE AN IBM EMULATOR CONTACT ME
  1577. FOR INFO ABOUT ADDING YOUR PRINTER.
  1578.  
  1579. 7) The program is faster, the production of a GIF image of the
  1580. chart 640x480 takes 30 minutes on MY machine. I have  an AT
  1581. compatible. When printing the chart, or creating a GIF of the
  1582. chart a time estimate is given. Since this time is based on MY
  1583. machine and MY Epson FX-80 9-pin printer, you can run your own
  1584. benchmarks (the test GIF is provided) and change the timer
  1585. numbers. 
  1586.  
  1587.     The new features added to this version include:
  1588.  
  1589. 1) While changing the size of the image, you can SAVE a copy of
  1590. the image to a file, without changing the copy you're working
  1591.  
  1592.  
  1593.  
  1594.                               29        
  1595.  
  1596.  
  1597.  
  1598. with.
  1599.  
  1600. 2) You can PRINT a copy of the entire chart, without changing the
  1601. copy you're working with.
  1602.  
  1603. 3) There is now the ability to CUT AND PASTE within the image.
  1604. Using the GIF viewer and box you can define the area to be
  1605. manipulated and delete, copy or move the designated area.
  1606.  
  1607. 4) There is also a LIBRARY utility. You can set up a library and
  1608. load it with "elements" to be incorporated into the  image. You
  1609. can create as many libraries as you want and load them with as
  1610. many elements as you want. NOTE: REGISTERED USERS WILL RECEIVE A
  1611. LIBRARY OF ABC's and 123's  
  1612.  
  1613. December 1992 - Version 3.5
  1614.  
  1615. 1) Fixed EGA Monochrome support
  1616.  
  1617. November 1992 - Version 3.4
  1618.  
  1619. 1) Added EGA Monochrome support
  1620.  
  1621. 2) The program could not be run from the root directory - FIXED
  1622.  
  1623. November 1992 - Version 3.3
  1624.  
  1625. 1) When using the INFORMATION menu to decrease the height and/or 
  1626. width of the image, the resulting image was "off" - FIXED
  1627.  
  1628. 2) When using the INFORMATION menu to decrease the height and/or
  1629. width of the image, "garbage" symbols were added to the right and
  1630. bottom -FIXED 
  1631.  
  1632. 3) When returning from using the INFORMATION menu to decrease the
  1633. height and/or width of the image, the 'X' was not responding
  1634. correctly -FIXED
  1635.  
  1636. October 1992 - Version 3.2
  1637.  
  1638. 1) added CGA support
  1639.  
  1640. 2) when reading GIF2XTS.cfg file program terminated with a divide 
  1641. by 0 error - FIXED
  1642.  
  1643. 3) when saving an XTS file, if the Stitches/inch or Rows/inch had
  1644. decimal point positions (ie 15.25) the numbers after the decimal
  1645. point were lost - FIXED
  1646.  
  1647.  
  1648.  
  1649.                               30    
  1650.  
  1651.  
  1652.  
  1653. 4) When changing the color PALETTE, the screen was not restored
  1654. correctly - FIXED
  1655.  
  1656. October 1992 - Version 3.1
  1657.  
  1658. 1) Amount of free memory reduced to 532000 BYTES
  1659.  
  1660. 2) In View mode, after scrolling IMAGE, box disappeared - FIXED
  1661.  
  1662. 3) When using FILE MENU, and changing directory or drive, cursor
  1663. disappeared - FIXED
  1664.  
  1665. October 1992 - Version 3.0
  1666.  
  1667. 1) Amount of FREE memory required reduced to 520K
  1668.  
  1669. 2) Hot keys:
  1670.    F1: Load GIF file
  1671.    F2: Load XTS file
  1672.    F3: Save as XTS file
  1673.    F4: Save as GIF file
  1674.    F5: Change directory
  1675.    F6: Change drive
  1676.    F7: Scale
  1677.    F8: not used
  1678.    F9: Save as XTS and exit
  1679.    F10: "quit" - no save just get out
  1680.    F11: Clear grid
  1681.    F12: Toggle black symbols/color symbols
  1682.  
  1683.  
  1684. 3) There's a new menu INFORMATION, included in this is:
  1685.     WIDTH: - # of stitches/pixels wide       
  1686.     HEIGHT: - # of stitches/pixels high      
  1687.     STITCHES/INCH: - user set value  
  1688.     ROWS/INCH: - user set value 
  1689.     INCHES WIDE: - computed value width divided by stitches/inch 
  1690.     INCHES HIGH: - computer value height divided by rows/inch 
  1691.     DASH LINES VERTICAL: - # of solid lines between dash lines 
  1692.     DASH LINE HORIZONTAL:  # of solid lines between dash lines 
  1693.     SAVE AS DEFAULT CONFIGURATION FILE 
  1694.     RESTORE DEFAULT CONFIGURATION 
  1695.  
  1696. 4) All GIF view give "true" picture. You can "scroll" up/down and 
  1697. left/right.
  1698.  
  1699. 5) Scale Function: This function is accessible from either the
  1700. EDIT menu, or F7. A GIF view of the image is presented with a
  1701.  
  1702.  
  1703.  
  1704.                               31
  1705.  
  1706.  
  1707.  
  1708. menu across the top. You can change the size of the image by 
  1709. selecting a menu option. The image is NOT save until you select
  1710. "save".  Hitting ESC will terminate this option. 
  1711.  
  1712. 6) Print: You can now print either directly to a 9-pin printer, 
  1713. or create a GIF file of the charted image. If you "select
  1714. section" you will be presented with a GIF image, and a selection
  1715. box. You can move and/or re-size the box to select the area you
  1716. with to print. 
  1717.  
  1718. 7) SETPRINT - This standalone program is used to create the 
  1719. print  configuration file. MUST BE RUN AT LEAST ONCE IF YOU PLAN
  1720. TO PRINT DIRECTLY TO PRINTER. You select manufacturer and model
  1721. of printer you will be using, or emulating. A quick test of the
  1722. printer is optional. 
  1723.  
  1724. May 1992 - Version 2.0
  1725.  
  1726. 1) Mouse can now control the cursor movement
  1727.  
  1728. 2) There is a second option bar to be used with the mouse
  1729.  
  1730. 3) 253 different symbols
  1731.  
  1732. 4) Changes to EDIT MENU
  1733.  
  1734. 5) Automatically scroll the VIEW image if the box moves past the 
  1735. visible section of the image.
  1736.  
  1737. April 1992 - Version 1.0
  1738.  
  1739.        
  1740.             CONFIGURING/SELECTING A PRINTER
  1741.  
  1742.      To select a printer, run SETPRINT.EXE. This program will
  1743. create a printer configuration file for GIF2XTS.
  1744.  
  1745.      The program MUST be run from the same directory as GIF2XTS,
  1746. since it uses the symbol file for the printer test & the file
  1747. that is generated is "assumed" to be in the same directory as
  1748. GIF2XTS when you run it.
  1749.  
  1750.      To run the program, type SETPRINT, at the DOS prompt. You
  1751. will be shown an alphabetic list of MANUFACTURERS. You can
  1752. scroll the list using the scroll bar. Location and select the
  1753. manufacture of the printer, or the emulator you plan to use.
  1754.  
  1755.      The next display is of the different models made by this
  1756.  
  1757.  
  1758.                               32    
  1759.  
  1760.  
  1761.  
  1762.  
  1763. manufacturer. The (E) or (HP) indicates the codes that are used
  1764. to run the printer. If your printer has a choice between Epson
  1765. and IBM, select (E) for the Epson code set  and set the printer
  1766. for Epson. Mismatching the code set with the emulation will
  1767. result in a printer that does not respond to the print codes.
  1768.  
  1769.      You will be given the chance to run a "quick" test of the
  1770. printer.  If you say "yes", a number different test will be run,
  1771. one for each different dots per inch. 
  1772.  
  1773.     If the test fails, rerun the program: setprint d x . The D
  1774. will generate a printer.tst file. The X will use the current
  1775. gifxtspt.cfg. Without the X you'll have to re-select the printer.
  1776. Without the D you'll re-run the printer test. printer.tst
  1777. contains the commands that were sent to the printer and the of
  1778. data to be printed. Only 1 density will be used. Send this file
  1779. to Chris O'Donnell.  This should help me fix what ever problems
  1780. you are having running your printer. 
  1781.  
  1782.     Even if you don't run the test, the configuration file will
  1783. be created.  If you don't plan to change printers, you can delete
  1784. the following files:
  1785.  
  1786.      setprint.exe
  1787.      prtcode.asc
  1788.      prtmodel.asc
  1789.  
  1790. DO NOT DELETE gifxtspt.cfg. If you do, you will have to re-run
  1791. SETPRINT.  If you DO delete these files, and find that you need
  1792. to re-create the configuration, contact Chris O'Donnell,
  1793. specifying the make and model of the your printer, and I'll
  1794. generate you a new configuration file.  OR send $5.00 (to cover
  1795. postage) and I'll mail you a disk with SETPRINT and all the
  1796. files.
  1797.  
  1798.  
  1799.                          HOW & WHY TO REGISTER
  1800.  
  1801.     Why should you register? Well, if you're NOT using this
  1802. program then you shouldn't. If you are using the program then the
  1803. honest thing to do is register. Of course I have no way of
  1804. knowing whose not registered yet using the program, so for
  1805. registered users I offer the following:
  1806.      
  1807.      1) a copy of the program without the obnoxious reminder to
  1808. register, a printed manual, a library of abc's and 123's, a
  1809. master.DMC of all 360 DMC colors, a conversion program to go 
  1810. from BMP, PCX, IFF, LBM and TIF to GIF and the RGB2DMC program.
  1811.      
  1812.  
  1813.  
  1814.                          33                                                                                                                        
  1815.  
  1816.  
  1817.  
  1818.      2) Free minor upgrades, mailed at my expense via USPS
  1819.      
  1820.      3) Major upgrades for $5.00 (Shipping and handling)
  1821.      
  1822.      4) Information on joining Delphi and getting 5 free hours.
  1823.      
  1824.     There are 2 ways to register GIF2XTS:
  1825.  
  1826.      1) If you are a member of CompuServe, GO SWREG and follow
  1827. the directions. The $40.00 will be charged to your credit card.
  1828.  
  1829.      2) Printoff REG.TXT and mail it with $40.00 to:
  1830.            Chris O'Donnell
  1831.            PO Box 113
  1832.            Middlebury Ct. 06762
  1833.            USA
  1834.      
  1835.     I will accept Cash, personal check, money order or bank
  1836. checks. If you are nervous about mailing cash, you can obtain a
  1837. Certificate of Mailing (USPS form 3817) from your Post Office.
  1838. This form is evidence that you mailed "something" to my address.
  1839.  
  1840.     In general, I will contact you by e-mail (if you included
  1841. your e-mail address) as soon as I receive your registration
  1842. informing you that I receive your registration and when
  1843. (approximately) will be getting your package into the mail.
  1844.  
  1845.     If you don't hear from me within 14 days of mailing your
  1846. registration, PLEASE CONTACT ME! I usually get the registered
  1847. package out within 3-5 days of recieving the registration.  I do
  1848. NOT wait for a check to clear. Depending on the circumstances,
  1849. you will get a replacement registration package for little or no
  1850. charge. You will need to fill out USPS form 4314-C (US Postal
  1851. Customer Service Card) so we can get the Post Office offically
  1852. involved. Then: 
  1853.  
  1854.     If my package failed to reach you, I will put another in the
  1855. mail ASAP. (return receipt requested if you desire).
  1856.  
  1857.     If you sent your registration by return reciept or recorded
  1858. delivery, send me a copy of the document with form 4314C and I'll
  1859. send you a registered user package. 
  1860.  
  1861.     If you used form 3817, send me a copy of the form, form 4314C
  1862. and $5.00 (for S&H)  and I'll send you a registered user package.
  1863.  
  1864.     If all you did was put a check in the mail, send form 4314C
  1865. and $5.00 (S&H) and I'll send you a registered user package.
  1866.  
  1867.  
  1868.                                                                                                                                         
  1869.                          34
  1870.                                                                                                                                         
  1871.  
  1872.  
  1873.                     INTERNATIONAL REGISTRATIONS
  1874.  
  1875.     If you live outside the United States and want to register,
  1876. you have the same options, BUT, I will also accept:
  1877.      
  1878.      1) foriegn currancy ONLY IF THE EXCHANGE RATE IS LISTED IN
  1879. BUISNESS WEEKMAGAZINE. (& add 10% for my hassle at the bank).
  1880.      
  1881.      2) American Express Money Orders, payable in US dollars.
  1882.      
  1883.      3) American Express travelers cheques   
  1884.  
  1885.      4) International Postal Money Orders in US dollars
  1886.  
  1887.      5) A Check drawn on a US bank, written in US dollars.
  1888.      
  1889.  
  1890.     I will send to you a registered user package identifing the
  1891. contents as: Diskette, Book and Intellectual Property License. In
  1892. general, only the book and diskette will be taxable.  I will send
  1893. it Airmail.
  1894.  
  1895.           REPORTING PROBLEMS/MAKING SUGGESTIONS
  1896.  
  1897.     If you find a "bug", something that doesn't work quite right
  1898. or hangs your system. Please report it to me. If I can duplicate
  1899. the error, or in any way verify the problem, you will recieve a
  1900. free upgrade, regardless of registration status. (Typos in the
  1901. manual don't count)  
  1902.  
  1903.     If you have a suggestion for future versions (except
  1904. backstitch, I've already thought of that), please let me know. If
  1905. I incorporate your suggestion, you will receive a free upgrade,
  1906. non-registered if you're not registered, registered if you are.
  1907.        
  1908.        
  1909.                       REGISTERED USERS
  1910.  
  1911.     This section contains the instructions for use the 2 utility
  1912. programs, the different MASTER.DMC file and the library of ABC's
  1913. and 123's that registered users recieve.           
  1914.       
  1915.                     THE LIBRARY ELEMENTS
  1916.  
  1917.     When you follow the directions to unzip the registered
  1918. version of GIF2XTS a \LIB directory will be created under the
  1919. directory where GIF2XTS is being stored. In this library are 62
  1920.  
  1921.  
  1922.  
  1923.  
  1924.                               35    
  1925.  
  1926.  
  1927.  
  1928. gifs containing 10x10 images of the alphabet, both upper and
  1929. lower cases, and the numbers 0- 9.
  1930.  
  1931.                          CONVERT.EXE
  1932.   
  1933.     This is a simple conversion program just in case some people
  1934. don't have one. It will read and display any BMP, PCX, IFF, LBM
  1935. or TIFF formated picture and create a GIF format. If the image is
  1936. 24-bit format, you will be given a choice of dithering algorithms
  1937. or matrix (same as in GIF2XTS) and a 256 color GIF image will be
  1938. produced.
  1939.  
  1940.     If anyone has another format that you would like included in
  1941. this program, please let me know. If I have, or can track down,
  1942. the decoding algorithm I will be glad to incorporate it.
  1943.  
  1944.  
  1945.                     MASTER.DMC
  1946.   
  1947.     MASTER.DMC is the default DMC file that GIF2XTS reads. The 
  1948. version in the non-registered version contains maps 64 RGB
  1949. combinations to 64 DMC colors. The MASTER.DMC the registered
  1950. users will receive maps the 360 DMC colors to 360 RGB
  1951. combinations. Using RGB2DMC.EXE you can modify and/or expand this
  1952. file.
  1953.  
  1954.                     RGB2DMC.EXE
  1955.   
  1956.     Since there are over 16 million possible colors that can be
  1957. used in a GIF image, and only 360 (as of this writing) DMC
  1958. colors, and since the colors on monitors vary from system to
  1959. system, I decided to NOT hard-code the relationship between the
  1960. RGB values and the DMC colors.  Instead I wrote this program.
  1961.  
  1962.     There a couple of ways to use the program. You can create a
  1963. .DMC file for a specific GIF file, you can build a .DMC file
  1964. from scratch, or you can modify an existing .DMC file.
  1965.  
  1966.                BUILD A DMC FILE FROM A GIF
  1967.  
  1968.     To build a .DMC file from a GIF, select this option and then
  1969. select GIF. The color palette will be loaded. The screen will
  1970. display the colors as colored boxes. Each box is numbered
  1971. 1,2,3....Most likely there will be more than 1 page of boxes.
  1972. Underneath each box are 2 edit fields. The first field is for
  1973. the DMC number. Select this field either with the mouse, or by
  1974. depressing the # key and entering the box number you want to
  1975.  
  1976.  
  1977.  
  1978.  
  1979.                               36
  1980.  
  1981.  
  1982.  
  1983. edit. After entering the DMC number hit enter. The bottom box
  1984. will become active. This box is for a color name. You have 20
  1985. characters. Hit enter when you are done.
  1986.  
  1987.     To view other colors, use either the right/left arrows, or
  1988. the arrow buttons at the top of the display. When you are done
  1989. entering DMC informtation, select DONE, or hit 'D'. You will be
  1990. given the choice to save the information or not. If you choose to
  1991. save the information you entered, you will be shown the file
  1992. window. The default file name is the same as the gif file
  1993. name, but with a .DMC suffix. The DMC and RGB information will be
  1994. sorted and written to the output file.
  1995.  
  1996.  
  1997.             BUILDING A DMC FILE FROM SCRATCH
  1998.  
  1999.     To build a .DMC file from scratch, select that option. You
  2000. will be shown a large square and 3 scroll bars. The scroll bars
  2001. control the Red, Green and Blue component of the large square. At
  2002. the top of each scroll bar is an edit field containing 0-255, the
  2003. numeric representation of the R,G and B  component.
  2004.  
  2005.     Using the mouse, you can adjust the R,G or B component by
  2006. moving the thumb up and/or down. Once the thumb has stopped
  2007. moving, the new numeric value will be displayed, and the new
  2008. color will be used to color the large square.   
  2009.  
  2010.     You can activate a scroll bar by hitting R, G or B. Page
  2011. Up/Page Down will move the scroll bar thumb up/down 8 increments,
  2012. the up and down arrows will scroll the thumb up and down 1.
  2013. Hitting ENTER will cause the new values to be used.
  2014.  
  2015.     If you wish to enter a value in the edit fields, the R, G or
  2016. B keys will activate the edit field too. Or you can use the mouse
  2017. to point and click. You can enter any number from 0 to 255. Hit
  2018. ENTER when you are done.  
  2019.  
  2020.     When you have a color you want to save, select SAVE (or hit
  2021. the S key). A window will appear with edit fields for the DMC
  2022. number and name. Fill in the information. OK will save it, CANCEL
  2023. (ESC) will abort the save. 
  2024.  
  2025.     When you are done entering colors, select DONE (or hit the D
  2026. key). You will be given the option to SAVE the colors you've
  2027. done, or to cancel. If you want to keep the colors, the you will
  2028. be given the file window to select, or enter, and .DMC file name.
  2029. The RGB values and associated DMC information will then be sorted
  2030. and saved. 
  2031.  
  2032.  
  2033.  
  2034.                          37                        
  2035.  
  2036.  
  2037.  
  2038.                MODIFYING AN EXISTING DMC FILE
  2039.  
  2040.     Modifying an existing .DMC file is a combination of the above
  2041. methods. Select the Modify option and you will be presented with
  2042. a list of .DMC files. Select the one you want to modify. You will
  2043. be shown a page of colored squares, with the current DMC
  2044. information filled in. To change the existing information, edit
  2045. the appropriate box fields. 
  2046.  
  2047.     To ADD new RGB/DMC information, select Add (A) and you will
  2048. get the scroll bars and colored square. 
  2049.  
  2050.     To MODIFY the RGB values, Click on the box number, or select
  2051. Modify to enter a box number. You will be shown the selected
  2052. color with the R G and B scroll bars set to the current values. 
  2053.  
  2054.     To DELETE an RGB/DMC combination, click on the DELETE box of
  2055. the square you want to delete. Or select DELETE and enter the
  2056. square number. The actual deletion will NOT take place until the
  2057. information is being saved, so if you change you mind, you can
  2058. UNDELETE by re-selecting that square.
  2059.  
  2060.     After you have made your modifications, you will again be
  2061. given the choice to save or not. You can save to the SAME .DMC
  2062. file, or create a new one.
  2063.  
  2064.     After you have created the .DMC files, when running GIF2XTS,
  2065. select the LOAD DMC FILE option from the FILE MENU. Thereafter
  2066. any GIF file you load will use that information for assigning the
  2067. DMC numbers and names to the RGB values in the color palette.
  2068. When you load an XTS file, you will be given to the option to
  2069. override the stored DMC information with the information in the
  2070. .DMC file.
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.                               38
  2090.  
  2091.  
  2092.  
  2093.  
  2094.