home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 411b.lha / PrintStudio_v1.2 / English_Doc / Documentation.pp / Documentation
Text File  |  1990-09-08  |  45KB  |  1,011 lines
  1.  
  2.                    Documentation of PrintStudio
  3.                    ----------------------------
  4.  
  5.  
  6.             PrintStudio V1.2 (c) 6/1990 by Andreas Krebs
  7.  
  8.  
  9. Following parts belong to PrintStudio and have to be copied too, when you
  10. copy PrintStudio.
  11.  
  12.   -PrintStudio            (the program itself)
  13.   -PrintStudio.info       (the icon for PrintStudio)
  14.   -PrintStudio.dat        (the data-file containing the graphics)
  15.  
  16.   -Deutsche_Anleitung     (drawer containing the german documentation)
  17.     -LIESMICH_zuerst        (the german README_first-file)
  18.     -LIESMICH_zuerst.info   (the icon for the german README_first-file)
  19.     -Anleitung              (the german documentation)
  20.     -Anleitung.info         (the icon for the german documentation)
  21.   -English_Doc            (drawer containing the english documentation)
  22.     -README_first           (the english README_first-file)
  23.     -README_first.info      (the icon for the english README_first-file)
  24.     -Documentation          (the english documentation)
  25.     -Documentation.info     (the icon for the english documentation)
  26.  
  27.  
  28. About PrintStudio:
  29. ------------------
  30. The program PrintStudio is an all-purpose printer-utility with a very
  31. comfortable graphic surface. Some of the capabilities of PrintStudio:
  32.  
  33.   - Hardcopies of IFF-Pictures (also HAM, EXTRA_HALFBRITE and OVERSCAN)
  34.   - Hardcopies of any part of a picture
  35.   - Hardcopies of screens and windows
  36.   - Printings of texts
  37.   - Printings of blocks out of a text
  38.   - Saving screens and windows to IFF-files
  39.   - Changing the colors of screens and pictures
  40.   - comfortable adjustment of the printing parameters
  41.   - comfortable loading and saving with a file requester
  42.   - automatical starting of the preferences program
  43.   - and much more
  44.  
  45. As you see PrintStudio has the capabilities of a lot of other utilities, and
  46. that was the main object I had, when writing PrintSrudio. Instead of many
  47. uncomfortable printer utilities, I wanted to write an all-purpose printing
  48. utility, that's able to handle text as well as graphics and all that with a
  49. very comfortable surface.
  50. The surface is the main difference between PrintStudio and other programs.
  51. The surface can be totally controlled by the mouse, so that it is very
  52. easy and fast to handle by the user.
  53.  
  54. Following programs were used to realize PrintStudio:
  55.  
  56.   - CygnusEd Professional: The best editor on the Amiga, that was a great
  57.         help to write the more than 200KByte source code.
  58.  
  59.   - Aztec-C V3.6a: The compiler making it possible to write this program.
  60.         (the version compiled with Aztec-C v5.0a caused a lot of guru's.
  61.         For the length of this version was almost the same as before, I
  62.         decided to save the work necesarry to adjust it. Therefore I
  63.         distribute the version compiled with Aztec-C v3.6a, that seems
  64.         to work quite ok).
  65.  
  66.   - Deluxe Paint III: The fantastic graphic-programm, that was a great help
  67.         by creating to over 30 more or less large graphics for the surface.
  68.  
  69.  
  70.  
  71. PrintStudio and your Amiga:
  72. ---------------------------
  73. PrintStudio should run on all Amigas with at least 512Kbyte ram, because
  74. PrintStudio itself needs about 190Kbyte ram, of which 110Kbyte must be chip-
  75. ram for the graphical surface.
  76. With following configurations PrintStudio was successfully tested:
  77.  
  78.   - Amiga 500  (512Kbyte + 1Mbyte)
  79.   - Amiga 1000 (512Kbyte + 2.5Mbyte)
  80.   - Amiga 2000
  81.   - Amiga 2000 with 1Mbyte chip-ram
  82.   - Amiga 2000 with 68030-turbocard and 4Mbyte 32Bit-ram
  83.  
  84. When running PrintStudio on a Amiga with only 512Kbyte be carefull, that no
  85. other large programs run beside PrintStudio, or there may be memory problems
  86. especially when you work on large graphics, because then the memory needed
  87. for the printer device can't be alloced. (At the moment I'm working on a
  88. version, whose surface is simpified and therefore saves a lot of chip-memory,
  89. but I can't say when it'll be released.)
  90.  
  91. On all Amigas with more memory there shouldn't be problems, because Print-
  92. Studio fully supports Amiga's multitasking.
  93. The test have been made with kickstart 1.2 as well as kickstart 1.3, but you
  94. should only use workbench 1.3, because PrintStudio uses some functions of the
  95. printer device that are not available under version 1.2.
  96.  
  97. PrintStudio should run on PAL Amigas as well as on NTSC Amigas. I never had
  98. a chance to test it on a real NTSC Amiga, but because of the bug in the
  99. operating system, that regular turns a PAL Amiga into a NTSC Amiga by cutting
  100. down the lower part of the display, it was possible to test it under NTSC
  101. conditions. (one thing this bug is good for)
  102.  
  103.  
  104. PrintStudio and printers:
  105. -------------------------
  106. PrintStudio works together with all printers, as long as a suitable printer
  107. driver is used (can be determined through the preferences).
  108. This is very important, when you make hardcopies, because in this area are
  109. the greates differences between the printers.
  110. When you have problems with hardcopies, you should at first check your
  111. printer driver, because very often they are responsible for problems with
  112. hardcopies.
  113.  
  114.  
  115. Starting PrintStudio:
  116. ---------------------
  117. You can start PrintStudio from the workbench by a double click as well as
  118. through the CLI by typing in its name, but in this case the files PrintStudio
  119. and PrintStudio.dat must be placed in the current directory, because Print-
  120. Studio automatically tries to load the file PrintStudio.dat.
  121. After being started PrintStudio changes the workbench colors an the mouse
  122. pointer, because PrintStudio uses its own colors and pointers. When these
  123. things are changed PrintStudio opens the About-window in the middle of the
  124. workbench screen, that contains short information about PrintStudio and a
  125. copyright notice.
  126. After reading this text press one of the mouse buttons somewhere inside
  127. the window. This causes the About-window to disappears and the Main-window 
  128. opens.
  129.  
  130.  
  131. The Main-window:
  132. ----------------
  133. On the Main-window you see 10 gadgets, whose functions are explained below.
  134. At first the gadgets, that are placed in the top border of the Main-window.
  135. (from left to right)
  136.  
  137. The Quit-gadget:
  138.    The Quit-gadget is placed in the left top corner and looks like 3 squares.
  139.    With this gadget you can quit PrintStudio after a request, if you really
  140.    want to quit it.
  141.  
  142. The Grey-gadget:
  143.    The Grey-gadget converts the brown colors of PrintStudio into grey colors.
  144.    While I was drawing the graphics, I couldn't decide which colors I should
  145.    use, so I decided to use both in the program. Now everybody can select the
  146.    colors he prefers.
  147.  
  148. The Memory-gadget:
  149.    The Memory-gadget is placed right of the Grey-gadget. If you don't see it,
  150.    click on the word "PrintStudio" and keep the left mouse button pressed.
  151.    While the left mouse button iss pressed, there appears a window containing
  152.    information about the available memory.
  153.  
  154. The Brown-gadget:
  155.    The Brown-gadget reactivates the brown colors. This only works, when you've
  156.    activated the grey colors before.
  157.  
  158. Beside the small gadgets in the top border there are the large gadgets in the
  159. window itself. These gadgets are described below.
  160.  
  161. The ILBM-gadget:
  162.    The ILBM-gadget starts a subprogram that is responsible for all functions
  163.    concerning pictures in the IFF/ILBM-format. (see "The ILBM-subprogram")
  164.  
  165. The Screen-gadget:
  166.    The Screen-gadget starts a subprogram that controlls all open screens on
  167.    your Amiga. (see "The Screen-subprogram")
  168.  
  169. The Text-gadget:
  170.    The Text-gadget starts a subprogram that is responsible for all functions
  171.    concerning texts in the ASCII-format. (see "The Text-subprogram")
  172.  
  173. The Preferences-gadget:
  174.    The Preferences-gadget starts the Preferences program, if it is placed in
  175.    one of the following directories:
  176.  
  177.      - Preferences (in the current directory)
  178.      - SYS:Preferences (in the man directory of the boot disk)
  179.      - SYSTEM:Preferences (in the System directory of the boot disk)
  180.      - SYS:Prefs/Preferences (in the Prefs directory of the boot disk)
  181.  
  182.    If the program is not in one of this directories, there appears an error
  183.    message. Otherwise the Preferences-window appears as usual, but before
  184.    PrintStudio changes the colors and the mouse pointer into the original
  185.    one. After leaving the Preferences program the Main-window of PrintStudio
  186.    appears again.
  187.    This function is of great value, when you want to change some parameters
  188.    like printer drivers or other things, that can't be changed through
  189.    PrintStudio.
  190.  
  191. The About-gadget:
  192.    The About-gadget opens the About-window, that was also opened at the
  193.    beginning. (see "Starting PrintStudio")
  194.  
  195. The Iconify-gadget:
  196.    The Iconify-gadget makes PrintStudio to wait until it is reactivated by
  197.    the user. This function closes the Main-window and activates the old
  198.    colors and the old mouse pointer again. After this it opens a small window
  199.    with the text "PrintStudio" left of the Depth-gadgets of the workbench
  200.    screen. To reactivate PrintStudio simply click the right mouse button
  201.    somewhere in this window and at once the Main-window appears again.
  202.    This function is of great value, when you don't want to quit PrintStudio,
  203.    but want to do something on the workbench, at which the Main-window in the
  204.    middle of the screen would be troublesome.
  205.  
  206.  
  207. The following part describes the ILBM-, Screen- and Text-subprogram. They all
  208. open a screen at the bottom of the display, that can be placed in the back-
  209. ground by a click on the right mouse button. After a second click it is placed
  210. in the foreground again. But now the the single subprograms.
  211.  
  212. The ILBM-subprogram:
  213. --------------------
  214. After a click on the ILBM-gadget of the Main-window this subprogram is
  215. activated. This subprogram is responsible for the handling of IFF-pictures
  216. and brushes. At first there appears a file requester (see "The file
  217. requester") to determine a picture that should be load.
  218. When you've determined a picture PrintStudio tries to load it. If it fails
  219. a error message appears, otherwise a screen is opened to display the picture.
  220. In front of the screen with the picture the ILBM-screen ist opened. This
  221. screen contains the ILBM-window with following gadgets:
  222. (from top left to right bottom)
  223.  
  224. The 'Close Screen'-gadget:
  225.   With this gadget you close the screen with the loaded picture and remove the
  226.   picture unrecoverably out of the memory, so that you have to load it again,
  227.   if you need it. This function is of needed, if you want to load another
  228.   picture than the active one, because PrintStudio is only able to load one
  229.   picture in memory. When quitting PrintStudio a loaded pictures is removed
  230.   out of the memory and the belonging screen is closed.
  231.  
  232. The 'Select Part'-gadget:
  233.   This gadgets starts the Part-subprogram (see "The Part-subprogram"). This
  234.   subprogram allows you to select a rectangle part of the picture, that can
  235.   be printed out, so that you don't have to print the whole picture, if you
  236.   are only interested in a part of the picture.
  237.  
  238. The PRINT-gadget:
  239.   This gadget you start the Grapic print-subprogram (see "The Graphic print-
  240.   subprogram"). This subprogram allows you to set the printing parameters
  241.   and start afterwards the printing.
  242.  
  243. The Palette-gadget:
  244.   This gadget starts the Palette-subprogram (see "The Palette-subprogram").
  245.   With this subprogram you can easyly change the colors of the loded picture.
  246.  
  247. The 'Whole Picture'-gadget:
  248.   With this gadget you reset the part of the picture defined with the Part-
  249.   subprogram to the maximal size (the whole picture). When the whole picture
  250.   is selected no border is drawn around the part.
  251.  
  252. The RETURN-gadget:
  253.   With this gadget you leave the ILBM-subprogram and go back to the main
  254.   program. The difference to the 'Close Screen'-gadget ist, that the loaded
  255.   picture is not deleted. Instead it is only placed in the background.
  256.   If you click again on the ILBM-gadget the picture is again placed into the
  257.   foreground.
  258.  
  259.  
  260. The Screen-subprogram:
  261. ----------------------
  262. After a click on the Screen-gadget of the Main-window this subprogram is
  263. activated. This subprogram is responsible for the hardcopies of screens.
  264. It is able to handle up to 16 screens, but mostly it is used together with
  265. the workbench screen, but it is also able to work with all other screens
  266. open. This subprogram opens opens a small screen in front of the active
  267. screen and in the bottom of the display. This screen contains the Screen-
  268. window with following gadgets on it:
  269. (from top left to right bottom)
  270.  
  271. The 'Act.: Screen/Window'-gadget:
  272.   With this gadget you start a subprogram (see "The ScreenSpecial-subprogram")
  273.   allowing you to select a window from the active screen for printing.
  274.   Moreover it allows you to save a screen or window to an IFF-file.
  275.   When a window is selected the text in this gadget is "Act.: Window", other-
  276.   wise the text is "Act.: Screen".
  277.  
  278. The 'Next Screen'-gadget:
  279.   With this gadget the next screen of the screen list is placed into the
  280.   foreground. If already all screens have been shown PrintStudio again starts
  281.   with the first screen (normally the workbench screen). This new screen is
  282.   automatically activated for the printing, but if a window has been selected,
  283.   it'll be lost.
  284.  
  285. The PRINT-gadget:
  286.   This gadget you start the Grapic print-subprogram (see "The Graphic print-
  287.   subprogram"). This subprogram allows you to set the printing parameters
  288.   and start afterwards the printing.
  289.  
  290. The Palette-gadget:
  291.   This gadget starts the Palette-subprogram (see "The Palette-subprogram").
  292.   With this subprogram you can easyly change the colors of the active screen.
  293.  
  294. The 'Last Screen'-gadget:
  295.   With this gadget the last screen of the screen list is placed into the
  296.   foreground and activated.
  297.  
  298. The RETURN-gadget:
  299.   With this gadget you leave the Screen-subprogram and go back to the main
  300.   program, at which the active screen gets lost, so that you have to activate
  301.   it again, if you wan't to print it out. This is possible, because the
  302.   Screen-subprogram only places screens in the fore- or background, but it
  303.   doesn't close a screen.
  304.  
  305.  
  306. The Text-subprogram:
  307. --------------------
  308. After a click on the Text-gadget of the Main-window this subprogram is
  309. activated. This subprogram is responsible for the printings of texts and
  310. parts out of a text. But a first the file requester appears (see "The file
  311. requester"), that allows you to select a file that should be loaded.
  312. When you've selected a file PrintStudio tries to load it. If it fails a
  313. error message appears, otherwise the text is displayed on a screen with a
  314. window containing Scroll-gadgets at the top (see "Scrolling a text").
  315. In front of the screen with the text a screen is opened in the bottom of the
  316. display. This screen contains the Text-window with following gadgets on it:
  317. (from top left to right bottom)
  318.  
  319. The 'Close File'-gadget:
  320.   With this gadget you close the screen with the loaded text and remove the
  321.   text unrecoverably out of the memory, so that you have to load it again,
  322.   if you need it. This function is of needed, if you want to load another
  323.   text than the active one, because PrintStudio is only able to load one
  324.   text in memory. When quitting PrintStudio a loaded text is removed out of
  325.   the memory and the belonging screen is closed.
  326.  
  327. The 'Select Block'-gadget:
  328.   This gadgets starts the Block-subprogram (see "The Block-subprogram"). This
  329.   subprogram allows you to select a block out of the loaded text, that can be
  330.   printed out, so that you don't have to print the whole text, if you are only
  331.   interested in a block of the text.
  332.  
  333. The PRINT-gadget:
  334.   This gadget you start the Text print-subprogram (see "The Text print-
  335.   subprogram"). This subprogram allows you to set the printing parameters
  336.   and start afterwards the printing.
  337.  
  338. The Options-gadget:
  339.   With this gadget you start the Options-subprogram (see "The Options-
  340.   subprogram"). This subprogram allows you to set some special printing
  341.   information for text, like page number, date, and so on.
  342.   When the options are active the text in this gadget is "Options: ON",
  343.   otherwise the text is "Options: OFF".
  344.  
  345. The 'Whole Text'-gadget:
  346.   This gadget resets the text block set by the Block-subprogram to the maximal
  347.   possible size (the whole text), so that the whole text is use for further
  348.   printings. Afterwards the the whole text is displayed on the screen.
  349.  
  350. The RETURN-gadget:
  351.   With this gadget you leave the Text-subprogram and go back to the main
  352.   program. The difference to the 'Close File'-gadget ist, that the loaded
  353.   text is not deleted.
  354.   If you click again on the Text-gadget the text is automatically displayed
  355.   on the screen.
  356.  
  357. Scrolling a text:
  358. -----------------
  359. As PrintStudio is normally not able to display the whole text at once on the
  360. screen, you can scroll the text up and down with following gadgets and keys.
  361.  
  362. At first the gadgets of the Scroll-window (the window above the text):
  363.  
  364.  - The Start-gadget:
  365.      jumps to the beginning of the text
  366.  - The Up-gadget (arrow left):
  367.      scrolls the text up, as long as you click on this gadget
  368.  - The Down-gadget (arrow right):
  369.      scrolls the text down, as long as you click on this gadget
  370.  - The End-gadget:
  371.      jumps to the end of the text
  372.  - The Proportional-gadget (long box in the middle):
  373.      By moving the knob around you can scroll the text, at which the left
  374.      side is the beginning of the text and the right side the end.
  375.  
  376. Besides the Scroll-gadgets it is also possible to scroll the text with the
  377. mouse by pressing the left mouse button down. If you now move the mouse the
  378. text is scrolled in the direction you move the mouse and the more you move it
  379. up or down the faster the text is scrolled.
  380.  
  381. But it is also possible to scroll the text with the keyboard by using
  382. following key combinations:
  383.  
  384.  - Cursur up or 8 on the numeric pad:
  385.      scrolls one line up
  386.  - Cursur down or 2 on the numeric pad:
  387.      scrolls one line down
  388.  - Cursur up or 8 (numeric pad) + ALT:
  389.      scrolls 12 lines up
  390.  - Cursur down or 2 (numeric pad) + ALT:
  391.      scrolls 12 lines down
  392.  - Cursur up or 8 (numeric pad) + SHIFT:
  393.      scrolls the text one page up
  394.  - Cursur down or 2 (numeric pad) + SHIFT:
  395.      scrolls the text one page down
  396.  - 9 on the numeric pad (Pg Up):
  397.      scrolls the text one page up
  398.  - 3 on the numeric pad (Pg Dn):
  399.      scrolls the text one page down
  400.  - Cursur up or 8 (numeric pad) + CTRL:
  401.      jumps to the beginning of the text
  402.  - Cursur down or 2 (numeric pad) + CTRL:
  403.      jumps to the end of the text
  404.  - 7 on the numeric pad (Home):
  405.      jumps to the beginning of the text
  406.  - 1 on the numeric pad (End):
  407.      jumps to the end of the text
  408.  
  409.  - 5 (numeric pad) or ESC:
  410.      This keys have a special funktion, and are used to place the Text-
  411.      screen into the fore- or background (same function as a click on the
  412.      left mouse button). This is the necessary when this screen covers a
  413.      part of the text.
  414.  
  415.  
  416. The file requester:
  417. -------------------
  418. Many functions use the file requester, because he allows a very easy way to
  419. select a file. Depending on the function that uses the file requester the
  420. text in the title line is changing. The entries in the display field are still
  421. active, this means the last loaded directory is still active. The file
  422. requester removes all icons (files with the ending ".info") from the list of
  423. the files.
  424. The gadgets in the file requester are:
  425.  
  426. The Drawer-gadget:
  427.   This gadget contains the name of the active directory and its path. A new
  428.   directory can be read in by typing its name in this gadget and pressing
  429.   RETURN.
  430.  
  431. The File-gadget:
  432.   This gadget contains the name of the selected file. If you want to create
  433.   a non existing file you have to type its name in this gadget.
  434.  
  435. The UP-gadget (arrow up):
  436.   While pressed this gadget scrolls the display field up.
  437.  
  438. The DOWN-gadget (arrow down):
  439.   While pressed this gadget scrolls the display field down.
  440.  
  441. The Scroll-gadget:
  442.   With this Proportional-gadget you can scroll the display field by moving the
  443.   knob up and down.
  444.  
  445. The display field:
  446.   The display field consists of 6 lines containing the entries of the active
  447.   directory. When started this field contains a list of all connected drives,
  448.   inserted disks and logical devices for directories.
  449.   By clicking on one name the name is placed in the Drawer-gadget if it is a
  450.   directory or in the File-gadget if it is a file. If it is a file, it'll be
  451.   automatically read in.
  452.   The first 3 lines of the display field can contain some special text, de-
  453.   pending on what is read in. Possible texts are:
  454.  
  455.    -"" Current Directory: This text is always active. By a click on it the
  456.       current directory is read in. This is normally the directory Print-
  457.       Studio is started from.
  458.    -VOLUMES: This text is active, when a directory is read in. This text
  459.       shows again the list of drives, that was also shown at the beginning.
  460.    -/Parent (DIR): This text  is active, when the path contains at least one
  461.       subdirectory. By a click on this text the last directory in read in.
  462.  
  463.   At the end of each name in the display field a suffix is appended. This
  464.   suffix shows of which type the entry is. Possible suffixs are:
  465.  
  466.    - (DEV) = Device: One of the disk drives (e.g. DF0-Df3) or another device
  467.       like a Ramdisk, Harddisk, ...
  468.    - (VOL) = Volume: A disk inserted in one drive.
  469.    - (DIR) = Directory: A subdirectory in the active directory or a logical
  470.       device in the list of drives.
  471.    - no suffix: A file in the active directory (except "" Current Directory
  472.       and VOLUMES, see above).
  473.  
  474.   All entries with an suffix can be read in equal whether it is a disk or a
  475.   directory. In difference to files, whose name is only placed in the File-
  476.   gadget, if they are selected.
  477.  
  478. The OK-gadget:
  479.   This gadget is placed in the left bottom. Its text is changing depending on
  480.   the function, that started the file requester. With this gadget you leave
  481.   the file requester, at which the selected name is send to the function, that
  482.   started the file requester, so that it can continue its work. The same
  483.   effekt has an double click on a file in the display field.
  484.  
  485. The CANCEL-gadget:
  486.   With this gadget you leave the file requester, at which the function, that
  487.   stated the file requester, breaks off its work.
  488.  
  489.  
  490.  
  491. In the following part the subprograms are explained, that are started by the
  492. ILBM-, Screen- or Text-subprogram.
  493.  
  494. The Part-subprogram:
  495. --------------------
  496. With this subprogram you can select a part out of a picture, that should be
  497. use for printing. The active part has a border around. (With HAM-pictures
  498. there may be some horrible looking lines, but they are remove before the
  499. printing starts.)
  500. The following gadgets are in the Part-window: (from left to right)
  501.  
  502. The Max-gadget:
  503.   This gadget sets the active part to the maximum (whole picture). This
  504.   is identically with the function "Whole Picture" of the ILBM-subprogram,
  505.   except that a border is drawn. This part is also active, when the Part-
  506.   subprogram is started for the first time.
  507.  
  508. The Pos-gadgets:
  509.   This gadgets show the active x- and y-position of the left top edge of the
  510.   active part. It is also possible to write values into this gadgets. If the
  511.   values are possible they become active.
  512.  
  513. The Size-gadgets:
  514.   This gadgets show the size of the part in x- and y-direction. They can also
  515.   be set by hand.
  516.  
  517. The Move-gadget:
  518.   When this gadget is active (is looks pressed down) it is possible to move
  519.   the active part with the Arrow-gadgets in the direction the arrow points at,
  520.   until you reach the border of the picture.
  521.  
  522. The Size-gadget:
  523.   When this gadget is active (is looks pressed down) it is possible to change
  524.   the size of the active part with the Arrow-gadgets. The "+/-"-gadgets shows
  525.   in which way the size is changed ("+" stands for lager and "-" for smaller).
  526.   The change os size always goes in the direction the arrow points at.
  527.   The Size- and the Move-gadget exclude each other, so that only one can be
  528.   active. If one is activated, the other is automatically deactivated.
  529.  
  530. The Arrow-gadgets:
  531.   See "The Move-gadget" and "The Size-gadget".
  532.  
  533. The "Set Edge"-gadget:
  534.   This gadget allows you to define your part with the mouse. After a click on
  535.   this gadget the screen with the picture is placed in the foreground. If you
  536.   press the left mouse button once the first edge is set. Now move the mouse
  537.   until you've found the correct part. Now press the left mouse button again
  538.   to activate the part.
  539.  
  540. The OK-gadget:
  541.   With this gadget you leave the Part-subprogram, at which the active part
  542.   is taken over by the ILBM-subprogram.
  543.  
  544. The CANCEL-gadget:
  545.   With this gadget you leave the Part-subprogram, at which the active part
  546.   gets lost, because the part that was active before the Part-subprogram was
  547.   started is reactivated again.
  548.  
  549. The Palette-subprogram:
  550. -----------------------
  551. With this subprogram you can change the colors of a screen, at which Print-
  552. Studio makes no difference between its own screen (e.g. a loaded picture),
  553. the screens of other programs and the workbench.
  554. (At HAM-pictures not all colors can be changed, because this colors are
  555. created with a special method.)
  556. The Palette-window contains following gadgets (from left to right)
  557.  
  558. The R/G/B-gadgets:
  559.   This 3 Proportional-Gadgets are used to change the red- (R), green- (G) and
  560.   blue- (B) values of the active color, at which the left side is a value of 0
  561.   and the right side a value of 15.
  562.   By moving th knob or a click in the box you change change the corresponding
  563.   value. This function only has effect on one color of the palette all others
  564.   stay unchanged.
  565.  
  566. The color display:
  567.   This fiels (right of the R/G/B-gadgets) shows the active color. The display
  568.   also shows how the color is changed, when you move the R/G/B-gadgets.
  569.  
  570. The color select-gadgets:
  571.   Each of this 20 gadgets shows one color of the screen or picture palette.
  572.   If not all gadgets are needed, the gadgets left contain a cross to show,
  573.   that they are inactive.
  574.   If you click on one of the active gadgets, the color in this gadget is
  575.   automatically activated and shown in the color display, so that it now can
  576.   be changed.
  577.  
  578. The color scroll-gadgets:
  579.   This 2 gadgets contain a arrow. This gadgets are only active, when a screen
  580.   or picture has 32 colors (LORES). For PrintStudio is not able to show all
  581.   32 colors at once, you can scroll the palette through the color select-
  582.   gadgets. The colors are scrolled in the direction the arrows point at.
  583.  
  584. The Negative-gadget: (Neg)
  585.   This gadget converts the active palette into the negative palette, at which
  586.   the new RGB-values are calculated as follows:
  587.     new value = 15 - old value
  588.  
  589. The Bg<->FG-gadget:
  590.   This gadget exchanges the background color (0) and the foreground color (1).
  591.   This function is of usefull, when the background is very dark in comparision
  592.   to the foreground, because then this function helps to spare the ribbon of
  593.   your printer.
  594.  
  595. The Grey-gadget:
  596.   This gadget converts the active palette into a grey palette, at which the
  597.   grey values are calculated as follows:
  598.     R-, G-, B-value = (R-value + G-value + B-value) / 3
  599.  
  600. The UNDO-gadget:
  601.   This gadget reactivates the color palette, that was active before the
  602.   Palette-subprogram was started.
  603.  
  604. The OK-gadget:
  605.   With this gadget you leave the Palette-subprogram, at which the active
  606.   palette is taken over by the ILBM-subprogram.
  607.  
  608. The CANCEL-gadget:
  609.   With this gadget you leave the Palette-subprogram, at which the active
  610.   palette gets lost, because the palette that was active before the Palette-
  611.   subprogram was started is reactivated again.
  612.  
  613. The ScreenSpecial-subprogram:
  614. -----------------------------
  615.   With this subprogram you can select a window of the active screen, that can
  616.   be saved or printed out.
  617.   The ScreenSpecial-window contains following gadgets: (from left to right)
  618.  
  619. The 'Select Screen'-gadget:
  620.   This gadget reactivates the active Screen, so that the whole screen is
  621.   printed and not only a window. The active window will be lost.
  622.  
  623. The title line:
  624.   This line shows the name of the active window. Additional the window is
  625.   placed in the foreground (except Backdrop-windows).
  626.   If no window is active this line contains "---------".
  627.  
  628. The 'Select Window'-gadget:
  629.   This gadget activates the window mode, this means you can now select a
  630.   window for printing. The name of the active window is shown in the title
  631.   line.
  632.  
  633. The Next/Last-gadget:
  634.   This gadgets activate the next/last window of the window list. The active
  635.   window is placed in the foreground and its name is written in the title
  636.   line. This function is only active, if you have prior clicked on the
  637.   'Select Window'-gadget.
  638.  
  639. The 'Save Screen'-gadget:
  640.   With this gadget you can save the active screen as an IFF/ILBM-file, whose
  641.   name has been defined with the file requester.
  642.  
  643. The 'Save Window'-gadget:
  644.   With this gadget you can save the active window as an IFF/ILBM-file, whose
  645.   name has been defined with the file requester. This function is only active,
  646.   if you have prior clicked on the 'Select Window'-gadget.
  647.  
  648. The 'Clone it'-gadget:
  649.   This function copies the active screen or window to the ILBM-screen. If
  650.   there was a picture loaded it'll be deleted without warning and afterwards
  651.   the screen or window is copied. Now it is treaded in the same way, as a
  652.   loaded picture. This allows you to select a part, which is not possible
  653.   with normal screen or windows. This function works with all screens except
  654.   to the ILBM-screen, for it is impossible to close a screen and then copy it.
  655.  
  656. The RETURN-Gadget:
  657.   With this gadget you leave the ScreenSpecial-subprogram, at which the active
  658.   screen or window is taken over by the Screen-subprogram. The active type is
  659.   shown in the 'Act.: Screen/Window'-gadget.
  660.  
  661. The Block-subprogram:
  662. ---------------------
  663.   With this subprogram you can select a block for printing out of a text. 
  664.   The Block-window contains following gadgets: (from left to right)
  665.  
  666. The MAX-gadget:
  667.   This gadget activates the whole text for printing. This is only possible,
  668.   if you have selected a block before. (Identical to the 'Whole Text'-
  669.   gadget of the Text-subprogram)
  670.  
  671. The Block-gadgets:
  672.   This 2 gadgets contain the starting line (Beg) and the ending line (End) of
  673.   the active block. With this gadgets you can also set the block by typing the
  674.   line numbers into the gadgets. The numbers in this gadgets refer to the
  675.   original text.
  676.  
  677. The Line-gadget:
  678.   This gadget contains the number of the active line, wheras the line 1 ist
  679.   the first line of the active block. The active line is printed in other
  680.   colors than normal. It is also possible to type a number direct into this
  681.   gadget, but you can also scroll the active line (see "Scrolling a text").
  682.  
  683. The Mark-gadget (identical with F1- or Del-Key):
  684.   Press this gadget, when you've reached the first line of the new block.
  685.   Now scroll the text, until you've reached the last line of your block. The
  686.   new block is now written in same color as the active line before. If you
  687.   want to break of the marking press the gadget again.
  688.  
  689. The Show-gadget (identical with F2- or Help-Key):
  690.   Press this gadget, when you've marked a new block (see "The Mark-gadget")
  691.   and now want to activate this block. After you've pressed this gadget the
  692.   new block is displayed on the screen and the gadgets actualized.
  693.  
  694. The Scroll-gadgets:
  695.   This gadgets have the same function as the UP- and DOWN-gadget of the
  696.   scroll-window, at which the arrow up moves the active line up and the arrow
  697.   down moves the active line down.
  698.  
  699. The OK-gadget:
  700.   With this gadget you leave the Block-subprogram, at which the active block
  701.   is taken over by the Text-subprogram.
  702.  
  703. The CANCEL-gadget:
  704.   With this gadget you leave the Block-subprogram, at which the active block
  705.   gets lost, because the block that was active before the Block-subprogram was
  706.   started is reactivated again.
  707.  
  708. The Options-subprogram:
  709. -----------------------
  710.   With this subprogram it is possible to define additional information for the
  711.   text printing. This subprogram opens a window on the workbench screen. This
  712.   gadget contains following gadgets: (from top to bottom)
  713.  
  714. The Options-gadget:
  715.   This gadget is in the title line of the window. When this subprogram is
  716.   started it is alway ON. With it you can define whether the options should
  717.   be turned ON or OFF, when leaving the Options-subprogram.
  718.  
  719. The Headline-gadgets:
  720.   With this gadgets you can define a headline, that is be printed above the
  721.   text. The gadgets are:
  722.  
  723.   - The point-gadget:
  724.       When the point in front of the word "Headline" is filled, the Headline-
  725.       function is active, this means the headline will be printed.
  726.   - The Style-gadget:
  727.       This gadget is the word "Headline" itself. When you click on it a small
  728.       window is opened to define the printing style for the headline. Possible
  729.       styles are:
  730.         + Normal: no special style (turns all other styles off)
  731.         + Italic: the headline is printed italic
  732.         + Bold: the headline is printed bold
  733.         + Enlarged: the headline is printed enlarged
  734.         + Underlined: the headline is printed underlined
  735.       When you've defined the printing style, use the OK-gadget to go back to
  736.       the Options-subprogram.
  737.   - once-gadget:
  738.       When this gadget is pressed down, the headline, the date and the time
  739.       are only printed on the first page. Otherwise on all pages.
  740.   - The left-gadget (arrow left):
  741.       When this gadget is active, the headline is printed on the left side.
  742.   - The center-gadget (double arrow):
  743.       When this gadget is active, the headline is printed centered.
  744.   - The right-gadget (arrow right):
  745.       When this gadget is active, the headline is printed on the right side.
  746.   - The text-gadget:
  747.       In this string-gadget (below th word "Headline") you can type in the
  748.       headline (up to 60 chars).
  749.  
  750. The Date-gadgets:
  751.   With this gadget you can define, how the date is printed.
  752.  
  753.   - The point-gadget:
  754.       With this gadget you activate the date for the printing (filled point),
  755.       at which the date is always printed in the top right corner.
  756.   - The Date-gadget:
  757.       This gadget is the word "Date" itself. When clicking on it the date is
  758.       actualized (the active date is written in the text-gadget).
  759.   - The text-gadget:
  760.       This string-gadget is set at the beginning with the active date. You
  761.       can change the date by hand, if it is wrong.
  762.  
  763. The Time-gadgets:
  764.   With this gadget you can define, how the time is printed.
  765.  
  766.   - The point-gadget:
  767.       With this gadget you activate the time for the printing (filled point),
  768.       at which the time is always printed in the top left corner.
  769.   - The Date-gadget:
  770.       This gadget is the word "Time" itself. When clicking on it the time is
  771.       actualized (the active time is written in the text-gadget).
  772.   - The text-gadget:
  773.       This string-gadget is set at the beginning with the active time. You
  774.       can change the time by hand, if it is wrong.
  775.   - The Buf-gadget:
  776.       When this gadget is active (filled box), the time is printed, that is
  777.       written in the text-gadget.
  778.   - The Act-gadget:
  779.       When this gadget is active (filled box), the time in the moment of
  780.       printing is printed and the time in the text-gadget is neglected.
  781.  
  782. The page number-gadgets:
  783.   With this gadget you can define, how the page number is printed.
  784.  
  785.   - The point-gadget:
  786.       With this gadget you activate the page number for the printing (filled
  787.       point), at which the page number is always printed at the bottom of the
  788.       page.
  789.   - The 'Page No.'-gadget:
  790.       This gadget is the word "Page No." itself. When clicking on it a small
  791.       window is opened. With this window you define the position of the page
  792.       number. Possible positions are:
  793.  
  794.         +altering: When this position is active, the page number is first
  795.           printed on the right and then on the left side and so on. This
  796.           function is usefull, when you print on both sides of a paper.
  797.         +left: The page number is printed on the left side.
  798.         +center: The page number is printed in the middle.
  799.         +right: The page number is printed on the right side.
  800.       When you've defined the position, leave the window by a click on the 
  801.       OK-gadget.
  802.   - The 'Page xx'-gadget:
  803.       When this gadget is active (filled box), the page number is printed in
  804.       the format "Page xx", at which xx stands for the page number.
  805.   - The '-xx-'-gadget:
  806.       When this gadget is active (filled box), the page number is printed in
  807.       the format "-xx-", at which xx stands for the page number.
  808.  
  809. The line number-gadgets:
  810.   With this gadget you can define, how the line number is printed.
  811.  
  812.   - The point-gadget:
  813.       With this gadget you activate the line number for the printing (filled
  814.       point), at which the line number is always printed in front of the line.
  815.   - The all-gadget:
  816.       When this gadget is active (filled box), the line number is printed for
  817.       all lines.
  818.   - The every-gadget:
  819.       When this gadget is active (filled box), the line number is printed
  820.       every n lines, at which n is written in String-gadget behind the every-
  821.       gadget.
  822.  
  823. The 'Line free'-gadgets:
  824.   With this gadgets you can define between which Options lines a free line
  825.   should be printed.
  826.  
  827.   - The 'after Headline'-gadget:
  828.       When this gadget is active (filled box), a free line is printed after
  829.       the headline and before the text.
  830.   - The 'after Date/Time'-gadget:
  831.       When this gadget is active (filled box), a free line is printed after
  832.       the date/time and before the headline.
  833.   - The 'before Page No.'-gadget:
  834.       When this gadget is active (filled box), a free line is printed before
  835.       the page number and after the text.
  836.  
  837. The ACCEPT-gadget:
  838.   With this gadget you leave the options-subprogram, at which the active
  839.   options are taken over by the Text-subprogram. If the options are switched
  840.   on, depends on the status of the Option-gadget (see "The Option-Gadget").
  841.  
  842. The CANCEL-gadget:
  843.   With this gadget you leave the Options-subprogram, at which the active
  844.   options get lost, because the options that were active before the Options-
  845.   subprogram was started are reactivated again. But the options are switched
  846.   off, so that in the Options-gadget of the Text-window is written
  847.   "Options: OFF".
  848.  
  849.  
  850. The text print-subprogram:
  851. --------------------------
  852. This subprogram opens a window on the workbench screen. With the gadgets of
  853. this window you define the different printing parameters for the text print.
  854. The window contains following gadget: (from top to bottom)
  855.  
  856. The Quality-gadgets:
  857.   With this gadgets you define the printing quality. The active quality looks
  858.   pressed down. Possible qualities:
  859.     - Draft (faster printing, but not so good quality)
  860.     - Letter (good quality, but slow)
  861.  
  862. The Spacing-gadgets:
  863.   With this gadgets you define the spacing between the lines. The active
  864.   spacing looks pressed down. Possible spacings:
  865.     - 6 LPI: 6 lines per inch (large spacing)
  866.     - 8 LPI: 8 lines per inch (small spacing)
  867.  
  868. The Pitch-gadgets:
  869.   With this gadgets you define the pitch of the chars. The active pitch looks
  870.   pressed down. Possible pitches:
  871.     - 10-Pica: 10 chars per inch (largest pitch)
  872.     - 12-Elite: 12 chars per inch
  873.     - 15-Fine: 15 chars per inch (smallest pitch)
  874.         This is not used correct by the printer device, because it is
  875.         identical to the function condensed. But because of compability to
  876.         the preferences program this pitch also exists.
  877.  
  878. The page size-gadgets:
  879.   With this 3 gadgets you define the size of the page. The possible parameters
  880.   are:
  881.     - 'Form Length': the height of the page
  882.     - 'Left Margin': left margin in number of chars
  883.     - 'Right Margin': right margin in number of chars
  884.  
  885. The Spezial-gadgets:
  886.   With this 3 gadgets you define 3 parameters, that are not available from
  887.   the preferences. This parameters are:
  888.     - Proportional: switchs the proportinoal printing on (filled box)
  889.     - Condensed: switchs the condensed printing on (filled box)
  890.     - Doublestrike: switchs the double strike on (filled box), so that each
  891.         line is printed twice.
  892.  
  893. The PRINT-gadget:
  894.   This gadget starts the printing. At first the STOP-window is opened in front
  895.   of the Text-screen. By a click on the STOP-gadget the printing is broken
  896.   off, but the printer may still continue for a short time. (It may take some
  897.   time before the printing starts, because at first the new paramerters have
  898.   to be set.)
  899.  
  900. The WRITE-gadget:
  901.   With this gadget the printing is diverted to a file, whose name has been set
  902.   with the file requester. When the options are switched off the text is saved
  903.   without all printer commands. Otherwise the text is saved with all printer
  904.   commands, which allows you to create text files with printer commands and
  905.   things like page or line numbers. To print such a file simply type in 'type
  906.   >PRT: filename' from the cli and the file is printed without PrintStudio.
  907.  
  908. The CANCEL-gadget:
  909.   With this gadget you leave the text print-subprogram, at which the active
  910.   parameters are kept active. This gadget only quits printing and goes back
  911.   to the Text-subprogram.
  912.  
  913. The graphic print-subprogram:
  914. -----------------------------
  915. This subprogram opens a window on the workbench screen. With the gadgets of
  916. this window you define the different printing parameters for the graphic
  917. print. The window contains following gadget: (from top to bottom)
  918.  
  919. The Aspect-gadgets:
  920.   With this gadgets you define the printing aspect. The active aspect looks
  921.   pressed down. Possible aspect:
  922.     - Horizontal: the graphic is printed horizontal
  923.     - Vertical: the graphic is printed vertical
  924.  
  925. The Image-gadgets:
  926.   With this gadgets you define the printing image. The active image looks
  927.   pressed down. Possible images:
  928.     - Positive: the graphic is printed positive
  929.     - Negative: the graphic is printed negative
  930.  
  931. The Shade-gadgets:
  932.   With this gadgets you define the printing shade. The active shade looks
  933.   pressed down. Possible shades:
  934.     - B&W: the graphic is printed in back and white
  935.     - Grey: the graphic is printed in grey tones
  936.     - Grey2: the graphic is also printed in grey tones, but they are created
  937.         in a different way
  938.     - Color: the graphic is printed in colors, when a color printer is 
  939.         connected
  940.  
  941. The Density-gadgets:
  942.   With this 7 gadgets you define the printing density. The active density
  943.   looks pressed down. Not all printers drivers support all 7 densities, but
  944.   the higher number the higher is the density and the more time takes the
  945.   printing.
  946.  
  947. The printing size-gadgets:
  948.   With this gadgets you define the printing size. At first I wanted to support
  949.   all combinations of the printer device, but I only supported the most
  950.   important directly, but all others are also available.
  951.   The aktive size has a filled point in front. The other 3 points are empty.
  952.  
  953.     - The Cols/Rows/Special-gadgets:
  954.         With this gadgets you can directly define the values for io_DestCols,
  955.         io_DestRows and io_Special. For the possible combinations see the
  956.         ROM Kernel Reference Manual: Libraries and Devices (Device Summaries,
  957.         B-56)
  958.         A special gadget is the word "Special". It opens a window, that shows
  959.         you the active special flags, but its also possible to change them.
  960.         When you have set the flags, leave this window with a click on the OK-
  961.         gadget.
  962.         (Attention: When the FRACCOLS- or FRACROWS-flag is activated, the
  963.          maximum is no more 0xFFFFFFFF, but 100000.)
  964.     - The %-gadgets:
  965.         With this gadgets you define, how much % of the maximal width (%W) and
  966.         % of the maximal height (%H) the printing should be. The maximum is
  967.         the size of the page.
  968.     - The MaxSize-gadget:
  969.         If this gadget is active, the maximal page size is used. (identical
  970.         with 100 in the %W and %H-gadget)
  971.     - The Size-gadgets:
  972.         With this gadgets you can define the size of the printing in mm. It is
  973.         possible, that the size is a few mm smaller than defined. This is
  974.         normal and seems to be a failure in the printer device.
  975.  
  976. The Spezial-gadgets:
  977.   With this 3 gadgets you define 3 special parameters for the printing. This
  978.   parameters are:
  979.     - Center: The picture is printed centered, when this funtion is active.
  980.     - Aspect: The proportion of the original graphic is kept, this means the
  981.         width or height is changed in order to keep the proportion.
  982.     - NoFormFeed: After the printing no form feed is done, when this function
  983.         is active.
  984.         This function is only usefull for page orientated printers like laser
  985.         printers.
  986.  
  987. The PRINT-gadget:
  988.   This gadget starts the printing. At first the STOP-window is opened in front
  989.   of the graphic-screen. By a click on the STOP-gadget the printing is broken
  990.   off, but the printer may still continue for a short time.
  991.  
  992. The CANCEL-gadget:
  993.   With this gadget you leave the graphic print-subprogram, at which the active
  994.   parameters are kept active. This gadget only quits printing and goes back
  995.   to the subprogram, that started the graphic print-subprogram.
  996.  
  997.  
  998.  
  999. I hope PrintStudio allows you to print your texts and graphics easier and
  1000. better than before. And please remeber that PrintStudio is a SHAREWARE-
  1001. program (see README_first).
  1002. If you have suggestions, bug reports or other comments, please send them to:
  1003.  
  1004.    Andreas Krebs
  1005.    Mittelweg 9
  1006.    7110 Oehringen 2
  1007.    West Germany
  1008.  
  1009.  
  1010.  
  1011.