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