home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 597a.lha / CassetteCoverPrinter_v1.1 / Cass.doc < prev    next >
Encoding:
Text File  |  1991-12-22  |  10.9 KB  |  231 lines
  1.  
  2.                         Cassette Cover Printer V1.1
  3.  
  4.                            ©1991 by Jörn Clausen
  5.  
  6.  
  7.  
  8.  
  9.  1. Introduction
  10.  
  11.  What is Cassette Cover Printer? It is a program to generate labels for
  12.  compact cassettes (you didn't guess that, did you?). I know, there a lot of
  13.  programs of this type out there, but this one is different a little bit:
  14.  
  15.  1 - It is written in Pascal. I used Maxon's Kick-Pascal 2.0, mainly to learn
  16.      programming with the library functions that make the Amiga so great.
  17.      Maybe other people can learn something from this, too?
  18.  
  19.  2 - It is able to generate LaTeX-files for printing cassette covers in a
  20.      much better way than printing them with ASCII-characters.
  21.  
  22.  It works under KickStart 1.2, 1.3 and OS2.0.
  23.  
  24.  
  25.  
  26.  
  27.  2. What you find on the disk
  28.  
  29.  In this directory you find the following programs:
  30.  
  31.     Cass.doc              this file
  32.     Cass_PAL              THE program (PAL-mode 640x256 pixel)
  33.     Cass_PAL.p            the source
  34.     Cass_NTSC             THE program (NTSC-mode 640x200 pixel)
  35.     Cass_NTSC.p           the source
  36.     Cass.data             an example-cover, to be read from the program
  37.     Cass.ascii            the example-cover made with ASCII-characters
  38.     Cass.tex              the same cover as LaTeX-source
  39.     Cass.dvi              the same after TeX has seen it
  40.  
  41.  The cass.ascii-file can be send directly to the next printer. For the
  42.  .tex- and the .dvi-file you need a LaTeX-system. (If you don't have TeX,
  43.  read the last section of this documentation).
  44.  
  45.  
  46.  
  47.  
  48.  3. How to use the program
  49.  
  50.  There are two versions of Cassette Cover Printer, Cass_PAL and Cass_NTSC.
  51.  It is rather obvious, that the first one is for all european users, who
  52.  have a PAL Amiga that can display 256 lines. If you have an NTSC Amiga,
  53.  please use the other version of the program. I heard, that with OS2.0, NTSC
  54.  Amigas can display 256 lines. So maybe all owners of this operating system
  55.  check out, which version they prefer.
  56.  
  57.  When starting the program from CLI or Shell, set the stack to 12000 or so.
  58.  Be sure to have the arp.library in your LIBS: directory. To start it from
  59.  WorkBench, simply double-click on its icon. (Hey, if you didn't know that,
  60.  how can you read this document?)
  61.  
  62.  Once the screen is completed, you see several string gadgets. The gadgets
  63.  on the left side are for the A-side of your cassette, the gadgets on the
  64.  right for the B-Side. As the PAL and NTSC version are not so much
  65.  different, I will explain the PAL version first and then show, how to work
  66.  with the NTSC version.
  67.  
  68.  At first, there are two rows of fifteen string-gadgets. These are for the
  69.  songtitles. Below them, in each row are two gadgets for the artist (upper
  70.  gagdet) and the title of the record (lower one). Then there are gadgets to
  71.  adjust noise-reduction and source for each side of the cassette. You can
  72.  specify a recording date. In the last line are two gagdets for setting the
  73.  length and type of the cassette. The last gagdet is for switching to a
  74.  second page of songs. It can happen that you need more than fifteen lines
  75.  of text on a cassette. For this reason the program prints another page if
  76.  it is needed.
  77.  
  78.  The only difference in the NTSC version is, that there are only ten lines
  79.  for the songtitles visible. If you press on the "Switch Sides"-Gadget, you
  80.  can flip between three pages of songs. But as the lengths of the printed
  81.  covers are the same in both versions of the program, the second page,
  82.  showing songs 11 to 20, is for the front page of the cover, and, if there
  83.  are entries in lines 16 to 20, for the additional page. So here the
  84.  additional songs are not seperated as clearly as in the PAL version, but
  85.  this was the easiest way to do it, except giving the program a totally
  86.  different style.
  87.  
  88.  You can load from and save data to disk by using the corresponding option
  89.  from the pull-down-menu. To give you a quick start-up, I have enclosed a
  90.  demonstration file called 'cass.data'. The data is written line per line as
  91.  ASCII-text; not very economical, but useful and easy.
  92.  
  93.  The second pull-down-menu is for printing. You can print a cover made of
  94.  ASCII-characters either to a printer or to a file. Both outputs are
  95.  identical, but maybe you want to collect some covers on disk and print them
  96.  later in one session. I presume (better: I hope) that the printing size of
  97.  different printers is the same. The program works with a Star LC-10, but I
  98.  deeply believe, covers made on other printers fit as well. I used the PRT:
  99.  port and ANSI-escape-sequences, so the printer.device should recognize them.
  100.  The cover will look like this:
  101.  
  102.    +-------------------------------------------------------------------+
  103.    | Magical Mystery Tour            | Taxman                          |
  104.    | The Fool On The Hill            | Eleanor Rigby                   |
  105.    | Flying                          | I'm Only Sleeping               |
  106.    | Blue Jay Way                    | Love You Too                    |
  107.    | Your Mother Should Know         | Here, There And Everywhere      |
  108.    | I Am The Walrus                 | Yellow Submarine                |
  109.    | Hello Goodbye                   | She Said She Said               |
  110.    | Strawberry Fields Forever       | Good Day Sunshine               |
  111.    | Penny Lane                      | And Your Bird Can Sing          |
  112.    | Baby You're A Rich Man          | For No One                      |
  113.    | All You Need Is Love            | Doctor Robert                   |
  114.    |                                 | I Want To Tell You              |
  115.    |                                 | Got To Get You Into My Life     |
  116.    |                                 | Tomorrow Never Knows            |
  117.    |                                 |                                 |
  118.    +-------------------------------------------------------------------+
  119.    | The Beatles                       Magical Mystery Tour            |
  120.    |                                   Revolver                        |
  121.    +-------------------------------------------------------------------+
  122.    | NR: Dolby C    Source: CD       | NR: Dolby C    Source: CD       |
  123.    | Date: 31.07.91                  | Date: 12.08.91                  |
  124.    |               C90                         Position: Chrome        |
  125.    +-------------------------------------------------------------------+
  126.  
  127.  The LaTeX-output can be done of course only to disk. The LaTeX-file is
  128.  ready to translate, you don't have to \include it in any environment in
  129.  another file. Simply type
  130.  
  131.          virtex &latex Cass.tex
  132.  
  133.  in your CLI if your .tex-file is called Cass.tex. (Maybe you have a
  134.  different LaTeX version. I know only C-TeX V3.0 and V3.14. Please check
  135.  your manual or your Local Giude for detailed information, how to start
  136.  LaTeX).
  137.  
  138.  
  139.  
  140.  
  141.  4. Known Bugs and other disgusting things
  142.  
  143.  There are a few, well not really bugs, but annoying things. Some of them
  144.  are result of my laziness, others I blame on Maxon and their run-time-system.
  145.  I thought about the possibility to insert and delete single lines, but then
  146.  I decided, that this is not worth the effort. Okay, they would give the
  147.  program a professional outfit, but I would rarely use them, so I didn't
  148.  worked on this feature. The other thing is, that when you are making
  149.  LaTeX-files, it is not checked if a line gets to long. If a line exeeds
  150.  the width statet in the \makebox-command, then nobody cares, neither my
  151.  program nor LaTeX. If this happens, I'm afraid you have to edit the
  152.  .tex-file by yourself. Although I have the widths of the single
  153.  TeX-characters, I don't know how to check the length of a string in the
  154.  string-gadget while I am typing it. If anybody has any suggestions, please
  155.  let me know.
  156.  
  157.  The other faults are Maxon's problem (I guess). Before leaving the program
  158.  or erasing data, a requester checks if you are kidding or if the program
  159.  should continue. This requester has a sizing-gadget. If you click on it,
  160.  the requester vanishes, before the mousebutton is released. I don't know,
  161.  why there is a gadget and why it is not checked correctly (fortunately it
  162.  does not appear with OS2.0, so this problem seems to be just a matter of
  163.  time). The other problem is, that I used to have the RightAmiga-Q-shortcut
  164.  in my pulldown-menu to quit the program. But when using this within a
  165.  string-gadget, where it should only clear the present text, it called the
  166.  menu-item and terminated the program. I don't know if this is some kind of
  167.  speciality of Kick-Pascal (I saw it happen in "Aquarium") or can be avoided
  168.  somehow. For this reason I removed the shortcut.
  169.  
  170.  
  171.  
  172.  
  173.  5. The copyright and other legal stuff
  174.  
  175.  This program was written and is copyrighted by
  176.  
  177.             Jörn Clausen
  178.             Oppenwehe 459
  179.             D-4995 Stemwede 3
  180.             Germany (Western Part)
  181.  
  182.  It is Freeware.
  183.  
  184.  The icon was created by Marcus Kramer, who was also my beta-tester.
  185.  
  186.  I have enclosed the source to encourage other people to take a look at it and
  187.  either shake their heads or learn something from it. Feel free to adjust it
  188.  to your specific needs, but please keep my copyright-notice in it. You may
  189.  give it to everybody you like (maybe you want to give it to people you don't
  190.  like), as long as you don't charge money for it. It may be enclosed in every
  191.  Public-Domain-library, that does not take more than a reasonable fee for a
  192.  disk. This excludes people charging more than about $6/DM10 per disk.
  193.  
  194.  I am not responsible for any damage caused directly by this program or by
  195.  using it together with other programs.
  196.  
  197.  If you feel the strong urge to give money away for the program, don't give it
  198.  to me, look around and you will find organisations that can use it much
  199.  better than I, e.g. Greenpeace, Amnesty International or organisations
  200.  caring for handicapped people. Support these groups in the great job they are
  201.  doing.
  202.  
  203.  
  204.  
  205.  
  206.  6. Some words about TeX and LaTeX
  207.  
  208.  If you have to write some more or less good-looking texts, that may contain
  209.  a mathematical formula, a table or something more complicated (like cassette
  210.  covers), then TeX is superior to ALL other editors or DTP-programs that are
  211.  available on any computer. It cares about distributing the text over the
  212.  pages, numbering them, placing formulas in a readable way, making a table of
  213.  contents, footnotes, and many many more things. Have you ever tried to make
  214.  a simple equation with a common word-processor? TeX can handle formulas of
  215.  nearly arbitrary complexity, no matter how many square roots, powers or
  216.  fraction lines it may contain. Once you've seen it you'll never want to miss
  217.  it. And I think lots of people are realizing this, as there are already many
  218.  utilities, especially on Fred Fish's disks, that are for use with TeX (and
  219.  with my program you got another one).
  220.  
  221.  And the best is yet to come: TeX is nearly free, you have to pay DM 5,-/disk.
  222.  To obtain a copy of a very good TeX-package (Passau-TeX) write to:
  223.  
  224.             Karl Skibinski
  225.             Gewerbering 20
  226.             D-8398 Pocking
  227.             Germany (Western Part)
  228.  
  229.  The basic package contains the main program, a previewer and a printer
  230.  driver. The programs support ARexx. This package costs DM 25,-.
  231.