home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk937 / knit / knit.doc < prev    next >
Text File  |  1993-12-21  |  12KB  |  289 lines
  1.     Knit V1.01
  2.  
  3.     Written in Blitz Basic 2 by Don Finlay
  4.  
  5.     Restrictions:
  6.  
  7.     All rights to Knit are reserved.
  8.  
  9.     No representation or warranties are made with respect to the
  10.     accuracy, reliability, performance, or operation of this software,
  11.     and all such use is at your own risk.  The author does not assume
  12.     any responsiblity or liability whatsoever with respect to your
  13.     use of this software.
  14.  
  15.     STARTUP
  16.  
  17.     Knit may be started either from WorkBench via double clicking on the
  18.     icon or from the CLI.  In either case the file "KnitTitle" must be in
  19.     the same directory as Knit or the program will not find it when needed
  20.     and you are apt to see the familiar red and black fireworks.  For this
  21.     same reason if you wish to start Knit from the CLI you must first make
  22.     its home directory the current directory.
  23.  
  24.     OVERVIEW
  25.  
  26.         Knit is a program which will convert an IFF picture file
  27.     into a knitting pattern.
  28.  
  29.           Knit should work with all the old screen resolutions.
  30.     That is to say, I do not have a machine with AGA chips and know
  31.     nothing of the new possible screen sizes or resolutions.
  32.  
  33.         KNIT WILL ONLY ACCEPT A PICTURE WITH EIGHT OR LESS COLORS.
  34.     My wife, who is the knitter in the family and for whom the
  35.     program was written, assures me that eight colors is enough to
  36.     tax the patience of all but the most advanced knitters.  This
  37.     should not present too great a problem as there are many
  38.     programs about which will convert even the most complex
  39.     pictures to any number of colors desired.  The program was
  40.     tested with a picture of number three daughter which was
  41.     digitized with digi-view and converted from ham to eight colors
  42.     in Art Department Pro.  To keep things simple you may wish to
  43.     draw an eight color work of art with the drawing program of
  44.     your choice.
  45.  
  46.         Knit bases all of its calculations on the size of a
  47.     standard monitor screen which means that your finished knitting
  48.     should be about the size of your screen.  This is not to say
  49.     that you can not use Knit if you have a large or small monitor.
  50.     It's just that the size you see is NOT what you will get.
  51.  
  52.         Working your picture pattern into the front of a sweater
  53.     or the end of a scarf I leave to you.  The possibilities are
  54.     too numerous to work out a contingency for each.  The printout
  55.     resulting from the program will tell you how many stitches per
  56.     row are needed and how many rows are used.  Again, the knitter
  57.     of the family assures me that it should not be difficult to
  58.     work out how the Knit pattern fits into any standard knitting
  59.     pattern.  The knitter of the family may have a lot to answer
  60.     for!
  61.  
  62.     JUMPING IN
  63.  
  64.         When you run the program by double clicking on its icon,
  65.     you will first be greeted by the title screen.  By the standard
  66.     procedure of holding down the right mouse button and moving up
  67.     into the title bar you will see the first menu.  Perhaps in the
  68.     future this menu will offer more options.  For now, however,
  69.     you have the choice of LOAD or QUIT.  Choosing the latter
  70.     option will once again allow you to look upon your WorkBench
  71.     screen.
  72.  
  73.     LOAD
  74.  
  75.         By choosing this option a requester will allow you to
  76.     locate and load onto the screen the picture you wish to convert
  77.     to a knitting pattern.  It may be worth mentioning once again
  78.     that the picture must be in the Amiga IFF format and must not
  79.     contain more than eight colors.  Once the picture is loaded,
  80.     the original title/menu bar will disappear.  By holding down
  81.     the right mouse button, however, you will find that you have
  82.     not been left to your own devices.  A new menu will appear with
  83.     the headings of PROJECT, SETUP, COLOR and OUTPUT.  This menu
  84.     bar will for the most part stay out of your way, but when ever
  85.     you need it simply use the right mouse button once again.
  86.  
  87.     THE PROJECT MENU.................
  88.  
  89.     PROJECT -- CROP
  90.  
  91.         Use this option when you want to use only part of the
  92.     screen for your pattern.  After choosing CROP you will be led
  93.     by small alert windows to choose a stitch size either in metric
  94.     or inches. (See Setup...Stitch Size below.)  Having given Knit
  95.     the stitch information you will be instructed to hold down the
  96.     left mouse button at which point a box will appear.  Continue
  97.     to hold down the left mouse button, move the mouse and you can
  98.     drag the box around the part of the screen you want to use.
  99.     When you release the mouse button the box will be drawn
  100.     permanently in its present location and the stitch grid will be
  101.     drawn in.  From this point on, all calculations except color
  102.     changes will effect only the portion of the screen enclosed
  103.     within the crop box.  Since the upper left corner of the crop
  104.     box is always at x=0, y=0 or the upper left corner of the
  105.     screen you must be sure that the part of the screen you want to
  106.     use is up where the crop box can get at it.  If, for example,
  107.     you wanted to draw a small logo in a paint program and later
  108.     turn it into a knitting pattern, either draw it in the upper
  109.     left hand corner or move it there before you save it.
  110.  
  111.     YOU DO NOT HAVE TO USE CROP!  Knit will default to using the
  112.     whole screen if you have not told it to crop out a portion.  If
  113.     you do wish to crop your picture, however, you must crop it
  114.     before you preform any SET UP or OUTPUT operations upon it.
  115.     Knit will not allow you to crop a picture after you have set
  116.     the stitch size.
  117.  
  118.     PROJECT -- SAVE
  119.  
  120.         Will bring up a requester so that you may save your
  121.     project to finish later or use again.  SAVE will create two
  122.     files.  Filename".knt" and Filename".dat"  The file with the
  123.     .knt suffix is a screen save of the project.  This is the one
  124.     you load back in if you want to work with the project again.
  125.     The .dat file contains all the settings you have decided upon
  126.     up to the point when the file was saved.  If you load a .knt
  127.     file, Knit will read the .dat file and set things up just as
  128.     you left them.  I might mention, that to load a .knt file, or
  129.     any other file for that matter, you must quit and restart the
  130.     program in order to get back to the screen with the load menu
  131.     option.
  132.  
  133.     PROJECT -- QUIT
  134.  
  135.         Welcome to WorkBench!
  136.  
  137.     THE SET UP MENU ..................
  138.  
  139.     SET UP -- STITCH SIZE
  140.  
  141.         Because of the numerous wool thickness and knitting needle
  142.     sizes stitch sizes can vary considerably.  Knit, of course,
  143.     must know the stitch size upon which to base it calculations.
  144.     Choosing the Stitch Size menu option will bring up a small
  145.     requester which will give you a choice of basing your pattern
  146.     on inches or metric divisions.  Picking eater option with the
  147.     mouse will switch the requester to one which will ask you to
  148.     input the number of stitches per inch or per two centimeters.
  149.     It is important to realize at this point that the more stitches
  150.     per unit you use, the more detailed your finished product will
  151.     be.  Nine stitches per unit seems to be small enough to give a
  152.     fair resolution in the knitted product.  Again, there is no
  153.     reason why one could not set the program to do a very detailed
  154.     pattern of say ten stitches per inch and then do the actual
  155.     knitting with a yarn and needles which gave an actual yield of
  156.     five stitches per inch.  The finished product would, of course,
  157.     be roughly twice the size of the monitor picture but the detail
  158.     would be good.  What ever stitch size you choose, when you
  159.     input it and hit return, a grid of that size will be drawn upon
  160.     the screen to represent the stitches.
  161.  
  162.     SET UP -- BLOCK PATTERN
  163.  
  164.         This one sends Knit off scanning the screen and working
  165.     out the dominant color in each square of the stitch grid.  It
  166.     then fills the entire square with that color just as a stitch
  167.     would do.  This process takes a few moments but is quite quick
  168.     when you realize that the program is checking every pixel on
  169.     the screen and comparing it with its near neighbors.  Just sit
  170.     back and watch it work.
  171.  
  172.     THE COLOR MENU .......................
  173.  
  174.         Any windows which open on the main picture screen during
  175.     any of the color editing procedures may be moved about to get
  176.     them out of the way for a better view of your picture.  Simply
  177.     move the mouse pointer to the top of what ever window you want
  178.     to move, hold down the left mouse button and drag the window to
  179.     a new location.
  180.  
  181.     COLOR -- EDIT PIC COLORS
  182.