home *** CD-ROM | disk | FTP | other *** search
/ NeedleCraft Plus / needlecraftplusvolume1.iso / dos / fabr300 / fabric.doc < prev    next >
Text File  |  1994-07-03  |  42KB  |  1,322 lines

  1.  
  2.  
  3.  
  4.  
  5.                         Fabric Users Manual
  6.  
  7.                                          Copyright (C) 1991, 1994
  8.                                                  by Bjorn Jansson
  9.                                                   Bothell, WA USA
  10.  
  11.  
  12.                          Table Of Contents
  13.  
  14.  
  15. Introduction..................................................  2
  16. What's new ?..................................................  3
  17. Distribution..................................................  5
  18. License.......................................................  5
  19. System Requirements...........................................  6
  20. Installation..................................................  7
  21. Menu..........................................................  8
  22.      FILE.....................................................  8
  23.         NEW...................................................  8
  24.         OPEN..................................................  8
  25.         SAVE..................................................  8
  26.         SAVE AS...............................................  9
  27.         ERASE WEB.............................................  9
  28.         PUSH TO DOS........................................... 10
  29.         QUIT.................................................. 10
  30.      SETUP.................................................... 10
  31.      WEAVE...................................................  11
  32.      ZOOM....................................................  11
  33.         ZOOM ALL.............................................. 12
  34.         ZOOM MAXWORK.......................................... 12
  35.         ZOOM WINDOW........................................... 12
  36.         ZOOM CENTER........................................... 12
  37.         ZOOM IN............................................... 12
  38.         ZOOM OUT.............................................. 12
  39.      BLOCK...................................................  12
  40.         ERASE................................................. 13
  41.         DELETE................................................ 13
  42.         INSERT................................................ 13
  43.         MOVE.................................................. 13
  44.         COPY.................................................. 13
  45.         REPEAT................................................ 14
  46.         MIRROR................................................ 14
  47.      PRINT...................................................  14
  48.      HELP....................................................  15
  49.      PALETTE.................................................  15
  50. Sample Session...............................................  16
  51. Printing ....................................................  19
  52. Command Line Parameters......................................  20
  53. Technical Details............................................  21
  54. Questions, Comments..........................................  21
  55. Acknowledgements.............................................  22
  56.  
  57.  
  58.  
  59.  
  60.                                (1)
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. Introduction
  72.  
  73. Fabric is a CAD program (Computer Aided Design) that replaces graph
  74. paper and colored pencils used in traditional drawdowns. Drawdown
  75. is a technique used to preview patterns designed to be woven on a
  76. loom. You specify the threading, treadling, and tie-up of the loom
  77. and Fabric "weaves" the pattern in the drawdown area. It is assumed
  78. that the user is familiar with drawdowns.
  79.  
  80. Fabric is much faster to use than the traditional technique. A
  81. pattern can be designed in a matter of minutes with Fabric. Fabric
  82. encourages "try-it-and-see" whims of the designer. Many designs
  83. that never would have made it down on paper can quickly be tried
  84. out on the screen.
  85.  
  86. Fabric is written to use a mouse (a handheld pointing device). A
  87. mouse makes Fabric intuitive to use. Just move the upper tip of the
  88. mouse cursor (a miniature shuttle) to the grid square you want to
  89. colorize and click. To escape a screen or a function you have
  90. inadvertently chosen, just click the right mouse.
  91.  
  92. Fabric can show the design in many levels of magnification. See Zoom
  93. for details.
  94.  
  95. The largest level useful for design work, Zoom Maxwork, has 197
  96. threads usable for warp and 144 threads for weft (4 shafts, 4
  97. treadles setup). The maximum size design is 640 by 480 threads.
  98.  
  99. You can set Fabric up to use 2 to 16 shafts, and 2 to 32 treadles.
  100.  
  101. The color of each thread in both warp and weft can be chosen from
  102. a palette of 15 colors. Each of the 15 palette colors, and the
  103. background, can easily be redefined to have one out of 262,144
  104. colors (VGA monitor), or 64 colors (EGA monitor).
  105.  
  106. There is an easy to use file system in Fabric. Use the mouse to
  107. retrieve designs from disk. Point at a filename in a list and
  108. click, the pattern is loaded ready to be displayed.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                (2)
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. What's new ?
  130.  
  131. New for version 3.00 are:
  132.  
  133. *    Redefined menu system. Fabric now uses a pull-down menu
  134.      system which may be more familiar to many users.
  135.  
  136. *    Printing capabilities. The threading, treadling and tieup
  137.      are printed to aid in loom setup and during weaving.
  138.  
  139. *    New block functions; Insert, Copy and Delete. Improved block
  140.      Move and Copy. Move and Copy can now work across threading and
  141.      treadling. The old Delete function is renamed Erase.
  142.  
  143. *    Improved and amended Setup screen. The Setup screen is now
  144.      more graphical in nature and most selections can be done by
  145.      the mouse.
  146.  
  147. *    Support for left handed mouse users.
  148.  
  149. *    More function key assignments. Functions like File Open, 
  150.      File Save, and Print are assigned to function keys as well
  151.      available as menu selections.
  152.  
  153. *    Various improvements to protect the user from loosing the
  154.      design. For instance, detecting that the design has changed
  155.      since last Save, therefore warning the user before Quitting.
  156.  
  157.  
  158. New for version 2.11 (previous release) and 2.10 were:
  159.  
  160. *    Much faster (about 70 times faster) screen redraws have been
  161.      implemented.
  162.  
  163. *    Enhanced Zoom functions. The previous four levels have been
  164.      replaced by an almost unlimited number of levels. Among
  165.      others, a Zoom Window function have been added.
  166.  
  167. *    Panning, a new way to move around the design has been added.
  168.      Press the cursor arrow keys anytime and the image will pan
  169.      (move sideways or up/down) one half screen-full at the time.
  170.  
  171. *    More shortcut keys have been added. They are the previously
  172.      mentioned panning keys, and an assortment of zoom functions
  173.      assigned to keys F6, F7, F8, F9, and F10.
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                (3)
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189. *    The context sensitive, on-line help system has been fully
  190.      implemented. Press F1 to enter the help system from any
  191.      screen, and help for the current topic will be presented.
  192.  
  193. *    In the Setup screen, Fabric can be configured to use either
  194.      Sinking or Rising shed. This is useful for instance if you
  195.      want to view the back of the weft.
  196.  
  197. *    Fabric will no longer exit when it fails to detect a mouse.
  198.      This to enable users to view the demo files without a mouse.
  199.      No work can be done without a mouse, though.
  200.  
  201. The file format of the designs are fully compatible with version
  202. 2.00.
  203.  
  204.  
  205. New for version 2.00 were:
  206.  
  207. *    Support for VGA monitors. The full color capability of VGA
  208.      monitors are supported. A VGA can mix each palette color to 1
  209.      out of 262,144 colors, EGA 1 out of 64. Also the vertical
  210.      resolution is enhanced for VGA monitors, from 350 picture
  211.      elements to 480. EGA monitors are still supported.
  212.  
  213. *    The total width/length of the design has been increased from
  214.      approx. 147/75 to 640/480. This is the maximum number of
  215.      picture elements a VGA monitor can display at one time.
  216.  
  217. *    A new zoom level has been added, Zoom Full. In Zoom Full the
  218.      complete design is displayed. This zoom level is meant for
  219.      overview of the complete design, to be able to quickly move
  220.      from one extreme corner to the other, and to facilitate the
  221.      use of a "screen grabber" program. See "Zoom".
  222.  
  223. *    Block functions have been added. Now you can Repeat, Delete,
  224.      Move, and Mirror a selected block of threads in warp or weft.
  225.      See "Block".
  226.  
  227. *    If you have more designs than what can be displayed on one
  228.      screen (in the "Load" list screen) and you click on <<< or
  229.      >>>, the screen moves a screen-full in each direction rather
  230.      than one column at a time.
  231.  
  232. *    The color bars in the "Palette" editor go sideways instead of
  233.      up and down. This to facilitate VGA's increased number of
  234.      color intensities.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                (4)
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247. *    The sample square in the Palette editing screen is now much
  248.      larger to facilitate comparing nuances to a real piece of
  249.      yarn.
  250.  
  251. Fabrics designed with older versions can be read in to newer
  252. versions, but not vice versa. Once the old design is read in to the
  253. new version, it will be converted to the new format.
  254.  
  255.  
  256.  
  257.  
  258. Distribution
  259.  
  260.  
  261. Fabric is shareware. It is not free nor in the public domain.
  262. However, you are free to copy and/or distribute Fabric any way you
  263. want with the following two restrictions:
  264.  
  265.      1.   Do not charge a fee for distributing Fabric. You may
  266.      charge a reasonable cost for the distribution media (e.g.
  267.      diskette).
  268.  
  269.      2.   Do not alter Fabric in any way. If you want to give
  270.      Fabric to a friend or upload it to a BBS (Bulletin Board
  271.      System), please give the original archived file; add nothing,
  272.      change nothing, delete nothing. You may repack the content of
  273.      the original file with a different packer if you like. I used
  274.      LHA v 2.12 and PKZIP 2.04e to pack the files.
  275.  
  276. Sysops are encouraged to make Fabric available to their callers.
  277.  
  278.  
  279.  
  280. License
  281.  
  282.  
  283. You may try Fabric for a period of 60 days without paying for it.  If
  284. you after that time find Fabric useful and want to continue using it,
  285. you must send in your registration with a $20 payment to the author
  286. or else delete Fabric from your computer system. 
  287.  
  288. By registering, you personally (and all members of your household)
  289. are entitled to use Fabric as much as you like. You are also entitled
  290. to use all future and past shareware releases of Fabric, provided
  291. that you register before the release date of the new version. If you
  292. have not paid by that date, the conditions of the new version are in
  293. effect. One fee covers all future shareware releases of Fabric.
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                                (5)
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307. To register, send a check or money order to:
  308.  
  309.      Bjorn Jansson
  310.      7422 N.E. 145 St.
  311.      Bothell, WA 98011
  312.      USA
  313.  
  314. If you like you can print the registration form REGISTER.FRM
  315. delivered with Fabric in the distribution file.
  316.  
  317. The payment system is based on your honesty. Almost all of Fabric is
  318. functional as is. However, when you register, block-functions (Erase,
  319. Delete, Insert, Move, Copy, Repeat, and Mirror) will be available to
  320. you as an added incentive to register. When I receive your
  321. registration form and payment, I will mail you instructions on how to
  322. make your copy of Fabric registered and give it a serial number.
  323. Your name (as written on the registration sheet) and serial number
  324. will show up every time you start Fabric.
  325.  
  326. I have spent many late hours developing Fabric. By registering you
  327. will show appreciation for the work already done, and give me
  328. encouragement to continue the development.
  329.  
  330. I promise that your address will not be given out to anybody else
  331. under any circumstances, unless I have your written consent.
  332.  
  333.  
  334.  
  335. System Requirements
  336.  
  337.  
  338. Fabric should run on any IBM PC using a color VGA or EGA monitor
  339. and adapter card, or systems compatible with such. A VGA monitor
  340. will give you a 640 by 480 resolution screen, en EGA 640 by 350.
  341. Furthermore, a VGA monitor will allow mixing each of the 16 palette
  342. colors to 262,144 nuances, while EGA only allows 64. Naturally,
  343. these restrictions also applies to Fabric. Fabric will
  344. automatically detect your screen type and act accordingly.
  345.  
  346. I have tested the current version of Fabric on DOS version 5.00 and
  347. 6.20. The older version of Fabric I tested on DOS 3.10, 3.30, and
  348. 5.00. It may work on other versions of DOS as well, try it and see.
  349.  
  350. A Microsoft Mouse (or compatible) is required. You can not run
  351. Fabric from the keyboard alone. You can, however, view the demo
  352. files without a mouse, but your interactions with the program will
  353. be severely limited.
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                (6)
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370. Installation
  371.  
  372. Fabric can be installed over a prior version of Fabric. The old
  373. files will be overwritten, except the files in the DESIGNS sub-
  374. directory.
  375.  
  376. Follow this procedure to install Fabric:
  377.  
  378. 1.   Make a directory on your hard disk or floppy where you want to
  379. run Fabric.
  380.  
  381.      Example:  MD C:\FABRIC
  382.  
  383. 2.   Make this directory the current directory.
  384.  
  385.      Example:  C:
  386.                CD\FABRIC
  387.  
  388. 3.   Un-archive (unpack) the distribution file into this directory.
  389. In the following examples it is assumed that FABR300 (the
  390. distribution file) is in the root directory of the A: drive.
  391. Substitute as necessary.
  392.  
  393.      If the distribution file has an extension .LZH:
  394.      Example:  LHA E A:\FABR300
  395.  
  396.      If the distribution file has an extension .ZIP:
  397.      Example:  PKUNZIP A:\FABR300
  398.  
  399. Chances are, since you are reading this, that you already have un-
  400. archived the distribution file. Then you may just copy the un-
  401. archived files to the selected directory. Do this only if you know
  402. that nothing has been changed since you un-archived.
  403.  
  404. 4.   Run the INSTALL program.
  405.  
  406.      Example:  INSTALL
  407.  
  408. 5.   If you like you can start a demonstration program at this
  409. time. The demo will show you a number of designs. When done looking
  410.  at one design select File Quit from the menu at the top of the
  411. screen, or press the Esc key.
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                (7)
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430. Menu
  431.  
  432.  
  433. This section covers the menu selections on the screen from left to
  434. right.
  435.  
  436.  
  437.      FILE, NEW     (F3)
  438.  
  439. This menu selection will erase all squares in the threading, tieup,
  440. and treadling grids. The setup and palette remains unchanged.
  441.  
  442.  
  443.  
  444.      FILE, OPEN     (Ctrl+F4)
  445.  
  446.  
  447. Select Open when you want to retrieve an old design. You will be
  448. asked to type a filename or to click the left mouse button to get
  449. a listing.
  450.  
  451. If you select the listing, a list of designs in alphabetical order
  452. will appear on the monitor. Use the mouse to select a file by
  453. clicking the left mouse button on the filename.
  454.  
  455. If you have more designs than one screen will hold, a >>> and a <<<
  456. will appear. Click on the appropriate one of these to scroll the
  457. display one screen-full right or left.
  458.  
  459. The design presently in memory will be overwritten by the newly
  460. selected design. Fabric will detect if you have made any changes to
  461. the design since the last save and ask you if you want to keep the
  462. changes to the design before reading in a new one.
  463.  
  464.  
  465.      FILE, SAVE     (F4)
  466.  
  467.  
  468. Save your design to disk. When clicking on "Save" you will be asked
  469. to provide a filename. The filename can contain 1 to 8 characters,
  470. any extension will be ignored. An extension of .FAB will automatically
  471. be added to all design files.
  472.  
  473. If you only give a filename, the design will be saved in the defult
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.                                (8)
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490. designs directory. The default design directory is the sub-directoiry
  491. DESIGNS under the Fabric installation directory, e.g.,
  492. C:\FABRIC\DESIGNS\.
  493.  
  494. If you specify a path with the filename, the file will be saved in
  495. that directory. For instance B:\MYFABS\CLOTH will save the file CLOTH
  496. in the B:\MYFABS\ directory.
  497.  
  498. You can also specify a relative path. This may look something like
  499. this: ..\ADIR\FABRNAME. In this case the file FABRNAME is saved in a
  500. directory parallel to the default directory.
  501.  
  502. Once a file has been succesfully saved in a directory other than the
  503. default design directory, the new directory becomes the default
  504. design directory.
  505.  
  506. Once Save has been used the filename will appear to the far right on
  507. the menu bar. From now on, each time you select Save the file is
  508. saved without further interaction, preserving the file name.
  509.  
  510. Tip: Save your design often. It is very fast, especially on a hard
  511. disk. It can be quite frustrating to have been working on a design
  512. and the computer goes down for some reason. If you frequently save
  513. your design while working on it, you can always restart Fabric and
  514. load your design again.
  515.  
  516.  
  517.  
  518.      FILE, SAVE AS
  519.  
  520.  
  521. In the event that you want to save your design without loosing the
  522. previously saved version, use Save As. Here Fabric will ask you to
  523. provide a new file name. You can also provide new path to the
  524. directory where you want to save the design. See Save for more
  525. details on this.
  526.  
  527.  
  528.      FILE, ERASE WEB     (F2)
  529.  
  530.  
  531. Clears the drawdown area of the screen.
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.                                (9)
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.      FILE, PUSH TO DOS
  551.  
  552.  
  553. This command temporarily suspends the execution of Fabric and gives
  554. you a DOS prompt. Fabric remains dormant in memory and you can return
  555. to it where you left off by typing EXIT at the DOS prompt.
  556.  
  557. This may be useful if you need to perform some tasks, running
  558. programs, or copying files, for instance, but you don't want to exit
  559. Fabric. The amount of memory available to programs is reduced by
  560. approximately 146K bytes as compared with the usual amount at the DOS
  561. prompt. This is the size of Fabric plus the size of a second instance
  562. of the DOS command interpreter.
  563.  
  564.  
  565.  
  566.      FILE, QUIT     (Esc)
  567.  
  568.  
  569. Select this to end the current Fabric session. Remember to save your
  570. design before you select this item. (See "Save" below.) Should you
  571. not have saved your design before selecting "Quit", Fabric will ask
  572. you if you want to loose the changes to the design and Quit. If you
  573. answer 'Y' or click the left mouse button the program terminates.
  574. Otherwise, you will be returned to Fabric where you can save the
  575. design.
  576.  
  577.  
  578.  
  579.      SETUP
  580.  
  581.  
  582. Here you define how your loom is configured. You can select how many
  583. shafts (harnesses) you have, you can select how many treadles
  584. (pedals) you have. default for both is 4. You can tell what these
  585. settings are by the white square highlighting the current setting. To
  586. change the setting, click on the desired square.
  587.  
  588. There are three option button boxes. The first one lets you select
  589. rising or sinking shed. Select the one setting your loom has by
  590. clicking on 'Rising' or 'Sinking' or their associated buttons. The
  591. current setting will show highlighted, the inactive setting will have
  592. the background color. As you select a new setting in an option button
  593. box, the other buttons will turn off.
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                (10)
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610. The second option button box, Mousehand, lets you swap the operation
  611. of the mouse buttons. Some lefthanded mouse users find this easier to
  612. work with. This change will take effect first when you click on the
  613. OK button. Fabric keeps record of which mouse hand you prefer such
  614. that it can start up with that selection.
  615.  
  616. The third option button box selects which printer port Fabric will
  617. send the printout to. The three choices are LPT1, LPT2, and LPT3. If
  618. you don't know which port your printer is connected to, try LPT1.
  619. This is the most common one if you only have one printer.
  620.  
  621. The last configuration option on this screen is the Printer Width
  622. input box. This tells Fabric where to wrap the printout lines. This
  623. number is the number of characters the printer can print in one line
  624. of text. The most common setting is 80, but if your printer is set to
  625. compressed printing, settings in the neighbohood of 134 will take
  626. advantage of the higher density printing. The printer must be
  627. manually set to compressed printing. Fabric will not change the
  628. setting of the printer.
  629.  
  630. To cancel your changes to the setup, click on the Cancel button. To
  631. save the changes, click on the OK button.
  632.  
  633.  
  634.  
  635.      WEAVE
  636.  
  637.  
  638. The pattern you have designed will be "woven" on the screen. Before
  639. this selection is useful you should have specified your tie-up,
  640. threading, and treadling (see "Sample Session" below).
  641.  
  642. If you have erased part of your pattern since you last selected
  643. "Weave" then press the F2 key. This erases the old fabric from the
  644. drawdown area. If you don't use the F2 key, parts of the old design
  645. may remain on screen if they were erased from the grids just before
  646. the Weave.
  647.  
  648.  
  649.  
  650.      ZOOM
  651.  
  652. Zoom lets you take a closer or more distant look at your design.
  653. The following zoom functions are available:
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.                                (11)
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670. Zoom All:
  671. The complete design will be shown on screen. No grids can appear at
  672. this level. When Zoom All is complete it waits for you to click any
  673. mouse-button or type any key. This to facilitate the use of a
  674. "screen grabber", a program delivered with some printers and word
  675. processors to "grab" the image on screen and send it to the
  676. printer. (DOS also provides means to print the screen, see Printing
  677. below.) When you click the mouse, the mouse cursor will be visible
  678. again. Now specify a 'window' to zoom in on, see 'Zoom Window'
  679. below.
  680.  
  681. Zoom Maxwork:     (F10)
  682. This is the largest zoom level any work can be done at. When you
  683. select Zoom Maxwork, the current center of the image will be
  684. maintained if possible.
  685.  
  686. Zoom In:     (F7)
  687. The image is magnified by a factor of two at the current center.
  688.  
  689. Zoom Out:     (F8)
  690. The magnification of the image is reduced by a factor of two. The
  691. current center of the image is maintained.
  692.  
  693. Zoom Window:     (F9)
  694. Click the mouse and a 'window frame' will be drawn on screen. One
  695. corner of the window is fixed where you clicked the mouse. Now
  696. frame the area you want to zoom in on. click the mouse button
  697. again, and the zoom is performed. At any time, click right to abort
  698. the function.
  699.  
  700. Zoom Center:     (F6)
  701. The image is centered at where you click the mouse. When using F6,
  702. no click is necessary.
  703.  
  704.  
  705.  
  706.      BLOCK
  707.  
  708. There are six block-functions; Erase, Delete, Insert, Move, Copy,
  709. Repeat, and Mirror.  They have in common that they work with a
  710. contiguous block of threads. The functions work identically for warp
  711. and weft. Block-functions will be enabled when you register your copy
  712. of Fabric, see "License".
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.                                (12)
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. After selecting your choice of block-function, Fabric will prompt you
  731. to mark the first thread in the block you want to work with. Move the
  732. mouse to a thread at one end of the desired block and click. The
  733. thread position is marked by a crosshatched pattern.
  734.  
  735. Next you are prompted to mark the last thread of the block. It does
  736. not matter in which order you select your first and last thread.
  737. All thread positions in between and including the two threads you
  738. indicated are marked by a crosshatch pattern.
  739.  
  740. The operation now depends on the selected block-function.
  741.  
  742. Erase:
  743. The threads in the block will be erased. The places previosly
  744. occupied by the threads will be left blank.
  745.  
  746. Delete:
  747. The threads in the block will be erased but, unlike the Erase
  748. command, the sequence of threads is adjusted such that all threads to the
  749. right of the block (or below if in the treadling sequence) will be
  750. moved such that they overlay the space previously occupied by the
  751. block.
  752.  
  753. Insert:
  754. This is the opposite of the Delete command. The threads in the block
  755. will be made vacant by pushing to the right on threads in the block
  756. and all threads to the right of the block. Caution: If there are
  757. threads at the extreme right of the design (thread number 640), they
  758. will be pushed out of the design and lost. If this is the case, you
  759. may want to move the whole design to the left before performing
  760. Insert. This can be accomplished by using the Delete command on an
  761. unused section to the left of the insertion point.
  762.  
  763. Move:  After marking the block, you will be prompted to indicate the
  764. destination of the move. The marked block will then be moved to have
  765. its lowest numbered thread at the destination point. The block
  766. originally selected will then automatically be erased.
  767.  
  768. The block can be moved to another location either in the same grid or
  769. to the other grid (threading versus treadling.)
  770.  
  771. Copy:
  772. Copy works like Move, but the block will not be erased.
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.                                (13)
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790. Repeat:
  791. The marked block will be repeated a number of times in either
  792. direction.
  793.  
  794. First indicate in which direction you want to repeat the block.
  795. Simply click the left mouse button on the desired side of the
  796. block.
  797.  
  798. Next a new menu will appear on the top line where you can select the
  799. number of repetitions you want (max 18 at a time). Remember that the
  800. block you selected is not counted as a repetition. Example; if you
  801. want a total of 10 identical sections of a pattern, then first draw
  802. the pattern, mark it, and repeat it 9 times.
  803.  
  804. Mirror:
  805. The marked block is mirrored to either side of the block.
  806.  
  807. You are prompted to indicate which side to mirror to. Click the
  808. left mouse button on the desired side of the block. The block will
  809. then be mirrored to that side. The thread that will end up in the
  810. center of the completed image will not be repeated, it serves as
  811. the center axis of the mirror operation.
  812.  
  813. Example; if you mark 4 threads to be mirrored to the right, only
  814. the 3 left-most threads will be mirrored over to the right side.
  815. The right-most thread in the marked block will not be mirrored.
  816.  
  817. At any time during the Block operations you can use the arrow keys
  818. and functin keys to pan and zoom the image. This is especially useful
  819. when the blocks are large, or when the destination is far away.
  820.  
  821.  
  822.  
  823.      PRINT
  824.  
  825.  
  826. The Print command produces a printout of the tieup, threading, and
  827. treadling sequences. This is useful for setting up the loom and for
  828. actually weaving the design.
  829.  
  830. The colors of the palette are represented by the letters 'a' to 'o',
  831. 'a' being the first color of the palette, 'o' being the last.
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.                                (14)
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.      HELP
  851.  
  852. The "Help" selection on some menus starts the on-line help system.
  853. This function is also available at any time when pressing F1.
  854.  
  855. Help is context sensitive, that is, it knows what functions you are
  856. working on and show the appropriate help page.
  857.  
  858. Select an alternative topic from the top menu, from the list
  859. presented at the main help screen, or by pressing a function- or
  860. arrow-key.
  861.  
  862. To exit the help system, keep pressing the right button or the Esc
  863. key.
  864.  
  865.  
  866.  
  867.      PALETTE
  868.  
  869.  
  870. "Palette" lets you redefine the colors of the palette. It is
  871. analogous to the painting artist mixing up different nuances on his
  872. palette. There are 15 colors on the palette plus the background
  873. color, each which can be given 1 out of 262,144 colors with a VGA
  874. monitor, or one out of 64 colors with an EGA monitor. 
  875.  
  876. The colors in a VGA or EGA system are made up of 3 basic colors;
  877. red, blue, and green. By mixing different intensities of these 3
  878. base colors, different color nuances can be obtained. Your task in
  879. the palette editing screen is to increase or decrease the
  880. intensities of the 3 base colors for each palette color you want to
  881. change. A VGA monitor has 64 different intensities of each of the
  882. 3 base colors, while an EGA only has 4 different intensities.
  883.  
  884. When you have selected "Palette" you will be placed in the palette
  885. editing screen. By default the current color is selected to be
  886. edited first.
  887.  
  888. Chose the color you want to edit from the palette. The selected
  889. color is indicated by a triangle directly to its left.
  890.  
  891. You can also edit the background color. Click the left button on
  892. "Background".
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.                                (15)
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910. To increase the base color intensity in the selected color, click
  911. the left mouse button on the bar that represents that base color,
  912. or where that bar would have been if it was extended all the way.
  913. The corresponding base color is called out directly to the left of
  914. the 3 bars. To decrease the intensity click the right button
  915. instead.
  916.  
  917. Notice how the selected bar gets longer or shorter to reflect the
  918. new intensity. Notice also how the sample square below the bars
  919. change to show the new nuance. The sample square has been made
  920. extra big so you can easily hold up a piece of yarn and compare the
  921. colors. The selected color in the palette also changes.
  922.  
  923. When you are done changing the colors, click the left button on the
  924. "OK" button in the bottom right corner. To cancel all changes click
  925. the "Cancel" button instead.
  926.  
  927. I have decided to give the user full access to all the colors
  928. available in the palette. From this follows that you can redefine
  929. the colors of the menus, text, and the grids. The bottom two colors
  930. of the palette are used for this purpose. You should be careful
  931. when redefining these colors and the background color. It is
  932. possible to give the background the same color as the menus or the
  933. grids. The effect is that the menus or grids become invisible. It
  934. is then difficult to do most anything in Fabric.
  935.  
  936.  
  937.  
  938. Sample Session
  939.  
  940.  
  941. Different people use different methods and in a different order to
  942. do a drawdown. Therefore the following is intended only as a
  943. guideline to how to use Fabric.
  944.  
  945. Invoke Fabric, that is, in the directory where you installed Fabric,
  946. type FABRIC at the DOS command line.
  947.  
  948. A copyright message will be shown at the top of the screen for 2.5
  949. seconds. You can make this message go away earlier by pressing any
  950. key.
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.                                (16)
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970. If your loom has a different configuration than 4 shafts and 4
  971. treadles, you need to select "Setup" from the menu. Click the left
  972. mouse button while the upper tip of the mouse cursor is on "Setup".
  973.  
  974. Click the left mouse button on the item you want to change, for
  975. instance shafts. The square you clicked on will become highlighted to
  976. show your selection. To verify your change, click the left mouse
  977. button on the "OK" button in the bottom right of the screen. You are
  978. now back to the design screen. The number of rows in the warp grid
  979. should reflect your change in number of shafts. The number of columns
  980. in the weft grid will match the number of treadles.
  981.  
  982. The default zoom level is difficult to work in so select "Zoom" and
  983. "In" from the menu. Do this by clicking on Zoom, then as the pulldown
  984. menu appears click on In. You could also have pressed the F7 key
  985. instead wich is assigned to Zoom In.
  986.  
  987. Select a color from the palette over to the far right by clicking
  988. the mouse on the color you like. Notice how a triangle to the
  989. immediate left of the palette indicates your choice. This color has
  990. become the current color. All colorizing will be done in this color
  991. until you select another one.
  992.  
  993. Now move the mouse to the warp grid (horizontal). Here is defined
  994. to which shaft each warp thread is connected (on a real loom
  995. connected by means of heddles). Each horizontal row of squares
  996. represent a shaft with positions for heddles. Click the left mouse
  997. button on a square you want to define. The square is colorized,
  998. which means that a thread of that color goes through that heddle.
  999. Move the mouse one square to the right. Select a square in the
  1000. vertical column of squares and click the left mouse button. Another
  1001. square is colorized. Repeat this procedure a few times, selecting
  1002. squares on a varying vertical position as you go. Select another
  1003. color from the palette if you like during this operation. Notice
  1004. that if you click on two squares in the same vertical column, that
  1005. the first square is erased. This because there can only be one warp
  1006. thread at each heddle location.
  1007.  
  1008. You can erase a colored square by clicking the right button on it,
  1009. although, this is rarely needed because you can just select a new
  1010. square and the old one disappears.
  1011.  
  1012. Move the mouse over to the yellow grid. This is the tie-up area
  1013. which defines how the treadles are connected to the shafts.
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.                                (17)
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030. Fabric can work with both a rising or a sinking shed. That means that
  1031. when you step on a treadle it will either lift or sink those shafts
  1032. indicated in the tie-up area. By default the shed is rising. Click
  1033. the mouse on the squares to define a tie-up you know works, or just
  1034. randomly select squares (OK, it might not be weavable but just to
  1035. practice.) Notice that Fabric won't allow you to select all the
  1036. squares in a vertical column. Doing so would mean that a treadle lifts
  1037. all the shafts, clearly a violation of weaving good sense, right?
  1038.  
  1039. Now select a color from the palette that has not been used much in
  1040. the warp. Colorize squares in the weft grid (vertical) as you did
  1041. for the warp grid. The rules are the same, only the grid is rotated
  1042. a quarter turn.
  1043.  
  1044. When you are ready to try your design, select "Weave" from the
  1045. menu. You should see your pattern drawn in the drawdown area.
  1046.  
  1047. To make a larger design, select "Zoom" from the menu. Select "Out"
  1048. from the pull-down menu. Now select "Zoom" again, and then
  1049. "Window". Click the left mouse at a point immediately to the left
  1050. and above the area you want to work on. A 'window frame' is drawn
  1051. on screen. Notice that when you move the mouse around, the window
  1052. expands and contracts, pivoting around the point you clicked at.
  1053. Now move the mouse so that the area you want to work on is framed
  1054. by the window and click the left button. The area is magnified to
  1055. cover as much of the screen as possible.
  1056.  
  1057. Continue to colorize as many squares as you like. Then use the zoom
  1058. functions to see more of the result.
  1059.  
  1060. When you are done designing for this time you may want to save your
  1061. work. Click the mouse on the "File", then "Save" menu items. Now type
  1062. in a name you want to give the file, max 8 characters. Press Enter
  1063. and your design is saved. Notice that, as a reminder, the filename
  1064. will appear inside brackets to the far right on the menu line.
  1065.  
  1066. From now on, each time you select File and Save, your design will be
  1067. saved overwriting the old design. Try it. If you want to give the
  1068. design a different name, you must select File and Save As from the
  1069. menu.
  1070.  
  1071. The next time you start up Fabric you can retrieve your design
  1072. complete with the setup and palette you used the previous time
  1073. (provided that you saved it of course.) Select the File and Open
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.                                (18)
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090. items from the menu. You can now either type the filename, if you
  1091. remember it, or you can click the left mouse button and get a list of
  1092. all saved designs. On the list click the mouse on the filename you
  1093. want and you are ready to design some more again.  A faster way to
  1094. start fabric with the design you want is to specify your design on
  1095. the DOS command line as you invoke Fabric. Example:
  1096.  
  1097. FABRIC mydesign
  1098.  
  1099. where mydesign is a fabric design previously saved.
  1100.  
  1101. You can also specify another directory for Fabric to search for your
  1102. design. Example:
  1103.  
  1104. FABRIC B:\fabs\mydesign
  1105.  
  1106.  
  1107.  
  1108.  
  1109. Printing
  1110.  
  1111. Fabric can print the tieup, threading, and treadling sequences. See
  1112. PRINT for more information on this. 
  1113.  
  1114. Fabric has no built-in print function to graphically print the web.
  1115. There are other ways to do this, though. You can use DOS' Print
  1116. Screen if you want to print out your design. Before starting Fabric,
  1117. execute the DOS command GRAPHICS. This will add graphics printing
  1118. capability to Print Screen.
  1119.  
  1120. Then display the section of your design that you want to print and
  1121. press Shift-PrintScreen.
  1122.  
  1123. On black-and-white printers, DOS tries to adjust the gray scale to
  1124. simulate different colors. For instance, it simulates yellow as white,
  1125. that is, it will not print anything where the design is yellow. The
  1126. default for the menu and tie-up grid is yellow. To print these areas,
  1127. temporarily re-define yellow to a different color.
  1128.  
  1129. You can experiment with how different colors print by changing the
  1130. palette to the colors you want, and print the screen. The palette
  1131. will show up on the print-out as would any threads drawn in those
  1132. colors.
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.                            (19)
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150. Your printer or word processor could have been delivered with a
  1151. screen grabber program. It may prove superior to the DOS' Print
  1152. Screen function.
  1153.  
  1154.  
  1155.  
  1156. Command Line Parameters
  1157.  
  1158.  
  1159. This is the format of the command line (the command you type at the
  1160. DOS prompt) to start Fabric:
  1161.  
  1162. FABRIC [/options] [path][design] [/options]
  1163.  
  1164. All parameters are optional. This is indicated by square brackets.
  1165. Either upper or lower case is accepted.
  1166.  
  1167. Options are preceded by / or -.
  1168.  
  1169. Only one option is useful to the unregistered user;
  1170.  
  1171. /EGA
  1172. This option will force EGA mode if FABRIC wrongfully detects a VGA
  1173. monitor.
  1174. Example: FABRIC /ega
  1175.  
  1176. In the "design" field you can specify which design to load without
  1177. having to go through the menus. Do not specify a file extension. If
  1178. you do it will be ignored. The extension .FAB is assumed. The DESIGNS
  1179. sub-directory is assumed as a location of designs. If relative
  1180. directory references are to be used, they must be given with relation
  1181. to DESIGNS.  Example: "FABRIC mydesign" will load the design
  1182. mydesign.fab from the default design directory. You can also specify
  1183. another disk drive as a source for files.
  1184. Example: "fabric B:\adir\myfile" will load the design file myfile.fab
  1185. from the directory B:\adir\.
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.                                (20)
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210. Technical Details
  1211.  
  1212.  
  1213. It is not necessary to understand the following technical details 
  1214. to successfully operate Fabric, they are provided for the
  1215. interested user.
  1216.  
  1217. Explanation of zoom levels:  Fabric uses an integer number of pixels
  1218. to represent a thread, the same in the x and y direction. At "Zoom
  1219. All" there is only one pixel per thread, therefore it is impossible
  1220. to provide a grid at this level. At "Zoom Maxwork" there are three
  1221. pixels per thread, a grid is useful first at this level. When using
  1222. the zoom functions, any integer numbers of pixels per thread can be
  1223. used by Fabric to accommodate your desired zoom level, up to where
  1224. only one thread occupies the entire drawdown area. Further, Fabric
  1225. displays only whole threads on screen. When "Zoom Window" is executed,
  1226. Fabric calculates the zoom level such that it shows the threads
  1227. completely framed by the window, then the number of pixels per thread
  1228. is rounded down to the nearest integer.
  1229.  
  1230. Fast screen redraws:  The drawdown, "Weave", has been implemented in
  1231. assembly language, hence the dramatic increase in speed. It has been
  1232. timed to 70 - 100 times faster than the previous high level language
  1233. function. The speed increase made it feasible to implement the many
  1234. zoom-levels, and still have snappy screen redraws.
  1235.  
  1236. Fabric keeps an initialization file, FABRIC.INI, in the installation
  1237. directory. By reading this file on startup, Fabric can always start
  1238. up with the same, user specified, settings. The initialization file
  1239. is updated every time the OK button is clicked in the Setup screen.
  1240. The moushand preference, printer port number, and printer width is
  1241. specified in this file.
  1242.  
  1243.  
  1244. Questions, Comments
  1245.  
  1246.  
  1247. Should you have questions about Fabric, or just want to make a
  1248. comment, please do so. I want to hear from you - especially the
  1249. nice comments. :)
  1250.  
  1251. If you want to contact me, there are several ways to do this.
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.                                (21)
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270. 1.  You can write a letter to the address below.
  1271.  
  1272.           Bjorn and Lisa Jansson
  1273.           7422 N.E. 145 St.
  1274.           Bothell, WA 98011
  1275.           U.S.A.
  1276.  
  1277. 2.  You can leave a message on a BBS that I frequent.
  1278.  
  1279. A good, fiber-oriented BBS I call is:
  1280. FIBERNET: (218) 583-4337    in Henning, MN, U.S.A.
  1281.           8N1, 24 hrs, 365 days, all computer types.
  1282.           Fibernet accomodates high speed modem users.
  1283.  
  1284. 3.  Leave me a message on Internet. My Internet address is:
  1285.  
  1286. bjornj@uencoder.MHS.COMPUSERVE.COM
  1287.  
  1288. This is probably the quickest way.
  1289.  
  1290.  
  1291.  
  1292. Acknowledgements
  1293.  
  1294.  
  1295. The project of writing Fabric was undertaken to join my hobby/work
  1296. with my wife's. Lisa has been a weaver and spinner for years and I
  1297. have been tinkering with computers, both for fun and at work.
  1298.  
  1299. Lisa taught me all I know about weaving. She also put up with me
  1300. spending months at the computer writing, tweaking, and adjusting
  1301. Fabric.
  1302.  
  1303. I was first inspired to write Fabric when Lisa showed me an issue
  1304. of Weavers magazine (#6 '89) where a computer was used for just
  1305. this purpose; computerized drawdowns. The cover featured an
  1306. intricate pattern made on a computer. This is the 13 shafts, 32
  1307. treadles pattern I used in the DEMO3V design.
  1308.  
  1309. There may be other patterns in the DEMO files that I am not the
  1310. creator of. Be aware that someone may hold a copyright on them.
  1311. (Can a pattern be copyrighted? I don't know.) 
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.                                (22)
  1321. 
  1322.