home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / tapecove.lha / TapeCover / TapeCover.doc < prev    next >
Encoding:
Text File  |  1995-06-20  |  25.2 KB  |  574 lines
  1.                       ==============================
  2.                       =T A P E - C O V E R   V 2.12=
  3.                       ==============================
  4.                            Release : 20.06.1995
  5.                              Copyright 1992-5
  6.  
  7.                                Carsten Wich
  8.                              Hagebuttenweg 34
  9.                              D-44289 Dortmund
  10.                                  Germany
  11.                            Tel. +49-2304-43692
  12.  
  13.                        Bank Account No. 315 1048 400
  14.                               BLZ 441 600 14
  15.                             Volksbank Dortmund
  16.  
  17.  
  18. Preface
  19. =======
  20.  
  21.   'TapeCover' Copyright (c) 1992-1995 Carsten Wich can be freely distributed,
  22.   as long as the whole archive 'TC_211.lha' is copied and all of the files are
  23.   in their original form without any changes.
  24.   Upload to BBS's and includions on any cover disks or CD's is WELCOMED.
  25.   This software is published without any warranties. The author does NOT take
  26.   any responsibilities for any defects on soft- or hardware, that may result
  27.   by this program or by using this program.
  28.   I have tried to write the program code according to the AMIGA User Interface
  29.   Style Guide and the AMIGA ROM Kernel Reference Manuals V2.04 so that the
  30.   program should run correctly on any future operating systems.
  31.   'TapeCover' was permanently used by me in the last years and will be im-
  32.   proved steadily. If anybody finds a bug or has any tips for improvement I
  33.   would be very glad to hear from them.
  34.   Although this program may be freely distibuted and used it would be very nice
  35.   of the people who permanently use it to send me a small fee (I would say at
  36.   least 15,- DM or $10,- US) as a little acknowledgement for my work. You can
  37.   send it cash, as a EuroCheque or via a Bank Transfer on my Bank Account.
  38.   This would naturally increase my motivation to develop the program even
  39.   further (My plans are to develop this little tool into a whole music archive
  40.   including CD's, Vinyl's, DAT Cassettes,... You should for example be able to
  41.   transfer your CD titles directly to the TapeCover program to print the
  42.   corresponding covers)
  43.  
  44.  
  45. What is TapeCover
  46. =================
  47.  
  48.   TapeCover is a very simple to use and short program to print tape covers.
  49.   I have written it because I didn't know any program of this kind that satis-
  50.   fied me one hundret percent.
  51.   It should even run on a stock A500 with 512K and OS2.1 (although this has
  52.   not been tested, but anyway, is there anybody out there still using this
  53.   kind of envirenment ???).
  54.   As of now TapeCover only uses Text Printing for output but this may change
  55.   future releases.
  56.  
  57.  
  58. Advantages
  59. ==========
  60.  
  61.   - The program does not need any GUI enhancement tools like MUI or any other
  62.     libraries than the ones distributed with the official OS2.1 release
  63.     (actually you only need the V38 asl.library, all the other needed libraries
  64.     require a minimum version of 37 only).
  65.   - Requires only minimum system resources.
  66.   - Programmed according to the Commodore Guidelines (e.g. it runs fine on a
  67.     third party graphics board in high resolution)
  68.   - Uses the Preferences Printer Driver for output (output is currently only
  69.     possible in text mode, but maybe future versions will also support the
  70.     graphic mode printing using the density setting to scale the output).
  71.   - Own input routine that lets you jump between every text gadget by using the
  72.     cursor keys (Does anybody know how to realize this with Intuition
  73.     gadgets ?).
  74.   - Will be able to import data from future database applications that are under
  75.     developement (e.g. CD-Archive and LiveTape-Manager).
  76.  
  77.  
  78. Disadvantages
  79. =============
  80.  
  81.   - Static data structure for the text input (but that is the reason why this
  82.     program is so short compared to the other contestants).
  83.   - Needs a printer which is capable of printing text in 15cpi mode (that
  84.     shouldn't be a problem these days, but who knows...).
  85.   - Needs at least a 640x400 screen when using topaz 8 fonts (Users without a
  86.     flickerfixer / AGA chipset / graphics board can run TapeCover on it's own
  87.     Hires NonInterlace Screen with the autoscroll option).
  88.  
  89.  
  90. Systemrequirements
  91. ==================
  92.  
  93.   The program only needs a minimal Amiga System :
  94.  
  95.     - Any Amiga with at least 512 KB RAM
  96.     - min. OS 2.1 (2.04 ROM & WB 2.1)
  97.     - min. a NTSC Hires Interlace Screen
  98.       The minimal window height ist 387 pixels (when using topaz 8), which is
  99.       sadly not enough to fit on a non interlaced screen. This should be no
  100.       problem today to display a productivity or DblPAL / DblNTSC screen mode.
  101.       If there are many complaints about this I may make a preferences option
  102.       to reduce the window height (this would obviously look not so nice as it
  103.       is now).
  104.     - A printer that is supported by the standard Preferences and which can
  105.       print 15cpi !!!
  106.       TapeCover has been positivly tested on HP Deskjet, Panasonic KX-P1124
  107.       and the Epson Stylus Series.
  108.  
  109.  
  110. Development environment
  111. =======================
  112.  
  113.   Hardware :
  114.  
  115.     - Amiga 2000C Big Tower with ECS Chipset (1MB Chip RAM)
  116.     - GForce 030 50MHz with 8MB 32Bit RAM
  117.     - GVP EGS 28/24 LC
  118.     - NEC 3D
  119.     - Toshiba MK-537 1 GB HD
  120.     - HP-38470A DAT Streamer
  121.  
  122.   Software :
  123.  
  124.     - Kickstart V40.63 ROM
  125.     - Workbench V40.42
  126.     - SAS-C V6.55
  127.     - GoldEd V3.1.0 reg.
  128.     - Enforcer / Mungwall / Sushi
  129.     - Diavolo Backup V1.27 (Yeah, the best backup program around)
  130.     - DOpus 4.11
  131.  
  132.  
  133. Files
  134. =====
  135.  
  136.      Icons (dir)
  137.        def_project.info                 
  138.      Catalogs (dir)
  139.           deutsch (dir)
  140.             tapecover.catalog                
  141.      Source (dir)
  142.        SCOPTIONS                        tapecover.c
  143.        tapecover.cd                     tapecover.ct
  144.        tapecover_io.c                   tapecover_strings.h
  145.      Export (dir)
  146.        Bruce-River.asc                  
  147.      Tapes (dir)
  148.        Adams-WakingUp.tpc               Bap-BessDemnaexh.tpc
  149.        BonJovi-KeepFaith.tpc            Bruce-92-06-25-I.tpc
  150.        Bruce-92-06-25-II.tpc            Bruce-93-06-26-I.tpc
  151.        Bruce-93-06-26-II.tpc            Bruce-River.tpc
  152.        Cougar-Daddy-Whenever.tpc        Etheridge.tpc
  153.        Stones-SteelWheels.tpc           U2-AchtungBaby.tpc
  154.   TapeCover                        TapeCover.doc
  155.   TapeCover.doc.info               TapeCover.info
  156.   Tapes.info                       
  157.  
  158.  
  159. HD - Installation
  160. =================
  161.  
  162.   Just extract the archiv to the directory of your choice on your harddrive.
  163.   Attention !!!
  164.   Introducing Version 2.00 TapeCover needs to know in which path it could be
  165.   found. The default setting is "TapeCover:", but you can change this via
  166.   the Shell-Argument or Tooltype "PATH=xxx" (where xxx stands
  167.   for the path in which TapeCover can be found).
  168.   The assign TapeCover: is therefor not necessarily needed.
  169.   The default language installed into TapeCover is English.
  170.  
  171.  
  172. What can YOU do ???
  173. ===================
  174.  
  175.   If you find any bugs or if you have any proposals then let me know. Maybe
  176.   I include them in future versions.
  177.   I have included all source code including the locale files so you can easily
  178.   adapt the program to your own language. If you have translated the catalog
  179.   to a new language than please send a copy to me (preferable per E-Mail).
  180.   And please forgive me for any possible mistakes regarding the english
  181.   language, my native language is german.
  182.  
  183. Menus
  184. =====
  185.  
  186.   Project
  187.   -------
  188.  
  189.     New               - The current dataset will be erased. A safety requester
  190.                         will appear if the current dataset was not saved
  191.                         already.
  192.  
  193.     Open...           - With the use of an ASL File Requester you can choose a
  194.                         file to load. Only TAPECOVER V1.x datasets (Header:
  195.                         'TPCV1.0T') will be loaded, otherwise an error message
  196.                         will appear.
  197.                         A safety requester will appear if the current dataset
  198.                         was not saved already.
  199.                         The default settings for the Filerequester Pattern field
  200.                         ist '#?.tpc', that means that only files with the exten-
  201.                         sion '.tpc' will be displayed.
  202.     
  203.     Save              - The current dataset will be saved under its original
  204.                         file name.
  205.                         If the current dataset was just created then an ASL File
  206.                         Requester appears just as in the menuitem "Save As".
  207.  
  208.     Save As...        - The current dataset will be saved. The filename can be
  209.                         edited via an ASL-File-Requester and if necessary the
  210.                         extension '.tpc' will be added.
  211.                         A safety requester will appear if the choosen file exist
  212.                         already.
  213.  
  214.     Print...          - The current dataset will be printed with the help of the
  215.                         Workbench Preferences Printer. Before printing a window
  216.                         showing the current preferences printer driver appears
  217.                         and the user has the possibility to cancel the printing.
  218.                         During printing a window with a progress indicator
  219.                         appears.
  220.     
  221.     Edit              - The current dataset can be edited. The following keys
  222.                         have special functions :
  223.     
  224.                         Cursor left,
  225.                         Cursor right  - The cursor can be moved left and right
  226.                                         on the inbounds of the field.
  227.                         Cursor down,
  228.                         Cursor up     - The next resp. previous field will be
  229.                                         activated.
  230.                         Return        - Has the same effect as "Cursor down"
  231.                         Escape        - The editing will be finished and the
  232.                                         menu will be activated again.
  233.                         Delete        - Deletes the character under the cursor
  234.                                         and  shifts the characters right to the
  235.                                         cursor one place to the left.
  236.                         Ctrl-X        - Deletes the whole field.
  237.                         Ctrl-S        - Inserts a space.
  238.                         F1            - The Cursor is placed on the beginning of
  239.                                         the first line of side A.
  240.                         F2            - The Cursor is placed on the beginning of
  241.                                         the first line of side B.
  242.                         F3            - The Cursor is placed on the beginning of
  243.                                         the first line of the Titel field.
  244.                         F4            - The Cursor is placed on the beginning of
  245.                                         the first line of the Info field.
  246.  
  247.     Preferences...    - A new Preferences Window will appear on the same screen
  248.                         as the mainwindow is. See below...
  249.  
  250.     About...          - The program version and the author's address will be
  251.                         shown in a new window.
  252.  
  253.     Quit Program      - The program will be ended (The activation of the CLOSE-
  254.                         GADGET has the same effect). A safety requester will
  255.                         appear if the current dataset has not been saved
  256.                         already.
  257.  
  258.   Mask
  259.   ----
  260.  
  261.     Labelline 1 bold   - If this menuitem is choosen the text in label line 1
  262.                          will be bolder (46 character than 67 characters)
  263.                          displayed.
  264.  
  265.     Labelline 2 bold   - The same as above only for label line 2
  266.  
  267.     Clear Side Fields  - Erases all the text fields on side A and side B
  268.  
  269.   Export
  270.   ------
  271.  
  272.     ASCII-File...      - The current dataset will be saved as an ASCII file.
  273.                          The file extension will be changed from ',tpc' to
  274.                          '.asc'.
  275.  
  276.  
  277. Gadgets
  278. =======
  279.  
  280.   The gadgets in the mainwindow have the same function as the menuitems with the
  281.   same name.
  282.  
  283.  
  284. Preferences
  285. ===========
  286.  
  287.   PublicScreen                 - If this option is selected, TapeCover will try
  288.                                  to open its windows one the PublicScreen named
  289.                                  in the String gadget that is displayed to the
  290.                                  right of this one.
  291.                                  If this fails, TapeCover will use the Default
  292.                                  PublicScreen instead.
  293.  
  294.   Own Screen                   - If this option is selected, TapeCover will open
  295.                                  its own new PublicScreen using the screen mode
  296.                                  selected by the next Gadget.
  297.                                  Defaultsetting: Use Workbench Screen
  298.  
  299.   Screen Mode...               - An ASL ScreenMode Requester opens and you can
  300.                                  choose your desired mode for TapeCovers own
  301.                                  PublicScreen.
  302.                                  Only selectable when the "Own Screen" option is
  303.                                  selected.
  304.                                  Defaultsetting: PAL Hires Lace 640x512
  305.  
  306.   Create Icons?                - With the use of this gadget you can set the
  307.                                  option to create Workbench icons when you save
  308.                                  a project file.
  309.                                  Therefore a valid def_Project.info file must be
  310.                                  in the "Icons" directory.
  311.                                  Defaultsetting: Don't create Icons
  312.  
  313.   Form Feed ?                  - With the use of this gadget you can set the
  314.                                  option of sending a form feed after a printout
  315.                                  or not.
  316.                                  Some printers (especially the Epson Stylus
  317.                                  Color) have problems with a shorter form length
  318.                                  and a form feed so that the whole paper is
  319.                                  ejected after the first printout. So no second
  320.                                  cover can be printed on the same page.
  321.                                  Defaultsetting: No Formfeed
  322.  
  323.   Snapshot Mainwindow Position - When use choose this option the current
  324.                                  position of the mainwindow will be snapshot and
  325.                                  saved so that the mainwindow will always open
  326.                                  in this position on future startups.
  327.  
  328.   Center Mainwindow            - The mainwindow will be centered (as the other
  329.                                  windows) on the screen.
  330.                                  Defaultsetting: Center Mainwindow
  331.  
  332.   Tapes Path...                - Here you can choose via an ASL-Directory-
  333.                                  Requester a default path for the Tapes
  334.                                  directory.
  335.                                  Defaultsetting: "Tapes"
  336.  
  337.   Export Path...               - Here you can choose in the same manner as in
  338.                                  the gadget above the default export path.
  339.                                  Defaultsetting: "Export"
  340.  
  341.   Mask Font...                 - Here you can choose the font via an ASL Font
  342.                                  Requester that is used for writing the dataset
  343.                                  mask.
  344.                                  Defaultsetting: "topaz.font" 8 Point
  345.  
  346.   General Font...              - Here you can choose in the same manner as in
  347.                                  the gadget above the font which will be used
  348.                                  for all other text outputs than in the mask.
  349.                                  Defaultsetting: "topaz.font" 8 Point
  350.  
  351.   Open...                      - With the help of an ASL-Requester you can load
  352.                                  a TapeCover Preferences file.
  353.   
  354.   Save as...                   - With the help of an ASL-Requester you can save
  355.                                  the current settings under a new path / file
  356.                                  name.
  357.                                  If the saving was successful the path and the
  358.                                  filename will be the new default path and
  359.                                  filename for the settings file (But not saved
  360.                                  permanently in the Tooltype !!!)
  361.  
  362.   Save                         - The current settings will be saved under the
  363.                                  current settings path and filename.
  364.  
  365.   Ok                           - The mainwindow will be closed and it will be
  366.                                  reopened by using the choosen settings.
  367.                                  If this should fail the default settings will
  368.                                  be used.
  369.  
  370.   Set Default                  - Sets all settings to its default values.
  371.  
  372.   Cancel                       - Returns control to the mainwindow.
  373.  
  374.  
  375. Tooltypes
  376. =========
  377.  
  378.   SETTINGS    - Sets the filename (inclusive path) for the Preferences file.
  379.                 At start the program first tries to load this file as the
  380.                 settings if this is present.
  381.                 If this fails the file PROGDIR:TapeCover.prefs will be tried
  382.                 to open and if this also fails the program searches in the path
  383.                 TapeCover: for the desired file.
  384.                 Otherwise the default settings are used.
  385.   
  386.   PATH        - Sets the path for the main TapeCover program.
  387.  
  388.   FILE        - When this Tooltype is used, the program tries to load the
  389.                 following file as a project.
  390.  
  391.  
  392. Shell Arguments
  393. ===============
  394.  
  395.   Exactly the same arguments as by the tooltypes are used, so no further
  396.   explanation here.
  397.  
  398.  
  399. Thanks to
  400. =========
  401.  
  402.   - The SAS-Institute for a very good C-Compiler (now what about a very good
  403.     C++ Compiler for the Amiga ???) and a very good support in the past. It is
  404.     too sad that they stopped the Amiga developement.
  405.   - All the people who designed the Amiga and who kepp it alive.
  406.   - Martin Huttenloher for the wunderful MagicWB 2.0.
  407.   - Mr. Bruce Springsteen and John Mellencamp for making the best music.
  408.     Without them I surely would not be able to develop such a big project over
  409.     the years. Keep on rockin... Tramps like us, baby we were born to run !!!
  410.   - Christoph Stoppe (wilson) for uploading this gem to aminet and for
  411.     supplying me with the latest aminet stuff.
  412.   - Markus Eggers for his critics and propositions
  413.   - and finally to all the ones who have supported me in making this project
  414.     (???) and who will support me in the future (!!!).
  415.  
  416.  
  417. Bugs
  418. ====
  419.  
  420.   - None known by me right now (Are there any more ???)
  421.  
  422.  
  423. Planned Features
  424. ================
  425.  
  426.   - Currently the programm terminates if the mainwindow does not fit on the
  427.     choosen screen. In later version the programm will fall back to the
  428.     default settings instead
  429.   - Using the Commodore Installer for installation
  430.   - Documentation in Guide format
  431.   - Support of other languages
  432.   - ARexx Port
  433.   - Other Export- and Import-Formats
  434.   - Change in the printing format (vertical lines)
  435.   - Add a Stop gadget in the print window
  436.   - Add the ability to print up to four tape covers on one printer page
  437.  
  438.  
  439. History
  440. =======
  441.  
  442. V2.12 - Release : 20.06.1995 (Second AmiNet Release !!!)
  443.       - Changed the Prefs TapePath and ExpPath gadgets from TextEntry to Text-
  444.         Display type
  445.       - New E-Mail address. Now full internet account, so every sent mail should
  446.         arrive at my site. The previous one was just an german Z-Net account,
  447.         which was not capable of sending / receiving mails to other states than
  448.         germany
  449.  
  450. V2.11 - Internal Version : 24.02.1995
  451.       - Bugfix: When you choose Cancel in the preferences window the preferences
  452.         were not reset to the old ones
  453.       - Bugfix: When using another language than german the printer output was
  454.         wrong for the Side line
  455.       - The feature of clearing the filename after erasing the side fields only
  456.         is removed
  457.  
  458. V2.10 - Release : 17.02.1995 (First AmiNet Release !!!)
  459.       - Now requires at least OS2.1 because of the asl screenmode requester
  460.       - Makes use of some special OS3.x features, e.g. scalable checkboxes,
  461.         radio buttons and the default busy pointer if available
  462.       - Some complete rewritten routines using new data structures including a
  463.         new preferences data structure (TPCV2.1C) which is incompatible with the
  464.         older ones
  465.         This makes it alot easier to use some of the routines from TapeCover in
  466.         future projects
  467.       - Removed Settings Menu and introduced a Preferences Window instead
  468.       - Can now open its own Public Screen
  469.       - Implemented the option to choose between centering the mainwindow on the
  470.         used screen or to save the current window position
  471.       - Removed the PUBSCREEN Tooltype / Shellargument in favour of the new
  472.         preferences screen options
  473.       - Now scans the PROGDIR: first for the TapeCover.prefs file and only if
  474.         that fails it checks the TapeCover: path for it
  475.       - Implemented the feature to load a file using the project option
  476.       - Added AppWindow to the mainwindow for loading project files
  477.       - Removed some bugs, e.g. the one that draws the menu black on black when
  478.         running under OS2.04 (sorry but I have got the 3.1 ROM)
  479.       - Some internal changes
  480.       - Currently I am heavily in my studies so that the german documentation
  481.         has been dropped for this and future versions
  482.  
  483. V2.06 - Internal Version : 01.12.1994
  484.       - removed the bug in the textinput routine which didn't let you use all
  485.         the special characters in the Amiga character set
  486.       - Added MenuItem : Mask/Clear Side Fields
  487.  
  488. V2.05 - Release : 17.11.1994
  489.       - Tooltypes / Shellarguments EXPORTPATH and PROJECTPATH removed
  490.       - Introduced FormFeed Flag -> You can now choose between sending a form
  491.         feed after a printout and not
  492.       - Added MenuItem: Preferences/Form Feed ?
  493.  
  494. V2.04 - Internal Version : 16.11.1994
  495.       - Added a routine to proof that the mainwindow can be opened on the
  496.         publicscreen
  497.       - Redesigned infowindow
  498.       - Added internal routine to write centered 3D text
  499.       - Printing routine printed labels twice when they were bold. Fixed
  500.       - From now on no formfeed will be send after printing a dataset,
  501.         because my new Epson Stylus Color the whole ejected the whole sheet
  502.  
  503. V2.03 - Internal Version : 28.08.1994
  504.       - Again a redesign of the mainwindow, now every editable line is
  505.         surrounded by a recessed box
  506.       - While editing a line this will be emphasized by a raised box
  507.       - Two new gadgets in the mainwindow : 'About' and 'Quit'
  508.       - New Tooltype and Shell Argument PUBSCREEN
  509.       - Added a internal routine for raised boxes
  510.       - The centering of the gadgets in the mainwindow was improved
  511.       - Attention: New E-Mail address !!!
  512.  
  513. V2.02 - Internal Version : 25.08.1994
  514.       - The mainwindow has been compleatly redesigned. Therefore six gadgets
  515.         that control the most important functions have been added to the
  516.         mainwindow
  517.       - Added a BusyPointer
  518.       - Added a progress indicator during printing in a new window
  519.       - Added a internal routine to localize the gadget shortcut keys
  520.       - Added a internal routine for 3D surroundings
  521.       - Parted the textoutput routine into two parts
  522.       - Oops, I just forgot to include the german catalog file in the last two
  523.         versions, fixed
  524.  
  525. V2.01 - Internal Version : 23.08.1994
  526.       - Added english documentation
  527.       - Added some errortrap functions
  528.       - Added the window that shows the printer driver again
  529.       - Usage of the gadtools functions GT_GetIMsg and GT_ReplyIMsg instead
  530.         of the equivalent intuition functions
  531.  
  532. V2.00 - Release : 18.08.1994
  533.       - Completly rewriting of all routines in SAS-C
  534.       - New menu structur under awareness of the Style Guides
  535.       - Support of Shell arguments and Tooltypes
  536.       - Creates Icons for project files
  537.  
  538. V1.30 - Release : 10.01.1994
  539.       - New menu Preferences which allows the choice and saving of fonts and
  540.         directory paths
  541.       - Functions to add the extensions '.tpc' and '.asc' have been added to
  542.         the Load- and Save routines. The ASL-Filerequester now allows pattern
  543.         matching with the corresponding default settings
  544.       - Internal change: The modul TapeCoverFunctions was integrated into the
  545.         TapeCover main module
  546.       
  547. V1.20 - Release : 07.11.1993
  548.       - The program now supports the locale.library. It exists at this time
  549.         only a german catalog. If anybody has interest in translating the
  550.         programs texts to other languages, just give me a message.
  551.       - New menu Export with the menu item "ASCII-File"
  552.       - No documentation in TEX-DVI format anymore because of lack of time
  553.  
  554. V1.10 - Release : 22.07.1993
  555.       - The program is now completly font sensitiv, that means it uses the
  556.         default System-Font to render its texts. This feature was necessary
  557.         because more and more highresolution Grafikcards will be available
  558.         and then you can use TapeCover also in these high resolution with
  559.         the use of bigger fonts
  560.  
  561. V1.03 - Release : 05.07.1993
  562.       - New German ZIP Code added in Info-Window
  563.       - Some texts improved
  564.       - File comment "TapeCover V1.x Dataset" will be automatically created when
  565.         saving
  566.       - Documentation in TEX-DVI Format added
  567.  
  568. V1.02 - Release : 26.02.1993
  569.       - First published Version
  570.       - Filename-String Bug removed
  571.  
  572. V1.01 - First Version in M2Amiga
  573.  
  574.