home *** CD-ROM | disk | FTP | other *** search
/ PC Media 15 / PC MEDIA CD15.iso / util / st / readme.doc < prev    next >
Encoding:
Text File  |  1994-03-06  |  6.6 KB  |  167 lines
  1. ****** SCREEN Thief v1.56 ****** README.DOC ******
  2.  
  3. Welcome to SCREEN Thief! The following instructions will show you
  4. how to install the software and get up and running in next to no
  5. time. They will also contain details of any last minute changes
  6. not documented elsewhere.
  7.  
  8.  
  9. Installation
  10. ------------
  11.  
  12. To install SCREEN Thief, insert the disk supplied into a drive
  13. and then select that drive by typing "A:" or "B:" as appropriate
  14. followed by <ENTER>. Next, type "INSTALL", press <ENTER> and
  15. follow the on-screen instructions. You will be asked for a
  16. destination drive and path for SCREEN Thief which default to
  17. "C:" and "\ST" respectively. Change these if necessary, although
  18. it will be easier to stay with the defaults as they will be used
  19. in the various examples.
  20.  
  21.  
  22. Running SCREEN Thief
  23. --------------------
  24.  
  25. To run SCREEN Thief with the default settings, change to the
  26. "\ST" directory and simply type "ST". SCREEN Thief will then be
  27. installed and you can run whatever program you need to grab a
  28. screen from. To actually grab a screen, press the <CTRL>, <ALT>
  29. and <T> keys together and you will hear a clicking noise from
  30. your PC speaker as SCREEN Thief is working. The image file
  31. produced will be in colour GIF format and given a name
  32. consisting of the first 6 letters of the name of the program
  33. currently being run followed by a number, eg, "FILENA01.GIF".
  34. This file will be saved to the current directory but you can
  35. specify a different directory when you run SCREEN Thief as
  36. follows:
  37.  
  38. ST C:\CAPTURE
  39.  
  40. This will save all captured image files to the "C:\CAPTURE"
  41. directory.
  42.  
  43.  
  44. The Command Line
  45. ----------------
  46.  
  47. All of SCREEN Thief's operational characteristics are controlled
  48. by command line parameters, mostly switches. Once installed, all
  49. changes to the way SCREEN Thief operates can only be made via
  50. the command line. All the various command line parameters are
  51. covered in detail in the Reference Section of this manual, but
  52. the more commonly used ones will be covered here. These
  53. parameters are:
  54.  
  55. /OUTPUT Sets the Output Image File Format to either GIF, TIFF,
  56. PCX or BMP. The default setting is GIF and the syntax of this
  57. switch is /O:TIFF.
  58.  
  59. /MONO   Enables and disables Mono Translation, ie, producing a
  60. black and white image. The default setting is disabled and the
  61. syntax of this switch is /M+ to enable and /M- to disable.
  62.  
  63. /UNLOAD Removes SCREEN Thief from memory. This is the only way
  64. to correctly remove SCREEN Thief from memory; do not use
  65. programs such as MARK and RELEASE. The syntax of this switch is
  66. /U.
  67.  
  68. Example
  69.  
  70. To use SCREEN Thief to capture screens and output them in mono
  71. PCX format to a directory called C:\PICTURES, type the following:
  72.  
  73. ST C:\PICTURES /M+ /O:PCX
  74.  
  75. Once SCREEN Thief is loaded in this way, you could then, for
  76. example, change the output file format by typing the following
  77. from the \ST Directory:
  78.  
  79. ST /O:GIF
  80.  
  81. Each time you make a change, the SCREEN Thief window will pop up
  82. showing the new setup.
  83.  
  84.  
  85. The SCREENTHIEF Environment Variable
  86. ------------------------------------
  87.  
  88. If you regularly use a particular setup for SCREEN Thief that is
  89. not the same as the default setup, you can avoid having to type
  90. all the command line switches each time, as in the example
  91. above, by using an environment variable. This is a string
  92. containing the required command line parameters that is placed
  93. in the AUTOEXEC.BAT file using the DOS SET command as in the
  94. example below:
  95.  
  96. SET SCREENTHIEF=C:\PICTURES /M+ /O:PCX
  97.  
  98. This will then use these parameters every time SCREEN Thief is
  99. run, overriding the defaults so that you only need to type "ST"
  100. to access your most used setup. The command line parameters will
  101. override the environment variable so you can still run SCREEN
  102. Thief differently as necessary.
  103.  
  104.  
  105. The SCREEN Thief Configuration File
  106. -----------------------------------
  107.  
  108. Although the Environment Variable allows you to set SCREEN Thief
  109. up to a certain extent, you may have various configurations for
  110. specific tasks that you would like to automate. This is possible
  111. using the Configuration File. Any parameters on the command line
  112. (or within the SCREENTHIEF environment setting) which do not
  113. follow a switch character will first be compared against the
  114. Configuration File. This is a simple text file such as can be
  115. created with any text editor or word processor in ascii mode. It
  116. must be called CONFIG.ST and exist in the same directory as the
  117. ST executable file. 
  118.  
  119. Configuration entries are implemented in the same way as the
  120. environment string, but each is preceded with a unique name.
  121. Each configuration must start on a new line, with a maximum line
  122. length of 255 characters including the config name. Any
  123. characters beyond this are truncated. For example:
  124.  
  125. REVIEWS=N:\PUB\REVIEWS\PCX /RGB+ /M- /O:PCX /K:50 /SH:OFF
  126. BOOKS=N:\PUB\BOOKS\GRABS /RGB- /MONO /O:GIF /K:01 /SH:CL
  127.  
  128. This allows easy switching between different configurations
  129. based solely on a customer, project or user name. However, note
  130. that any option changed in one configuration will need to be
  131. changed in every other configuration unless valid for all cases.
  132.  
  133. Configuration names are allowed within the environment string
  134. and on the command line. Multiple configuration names are also
  135. permitted, but nesting is not. This means that a config entry
  136. cannot name another within its command line. Configurations can
  137. also be used in isolation or in addition to other command line
  138. switches.
  139.  
  140. If no matching entry is found within the CONFIG.ST file SCREEN
  141. Thief will then attempt to use it as an image file directory
  142. name and check its validity accordingly.
  143.  
  144.  
  145. The Help System
  146. ---------------
  147.  
  148. SCREEN Thief has an extensive help system that may be used in
  149. one of two ways. Firstly, if an error occurs, the help system
  150. will be automatically started, the error message displayed and
  151. the correct subject highlighted. Simply press the right-arrow
  152. key to expand the help screen for further information. Please
  153. note that not all errors will produce this automatic help; some,
  154. such as "Directory Non Existent" that are self-explanatory, just
  155. bring up an error message and quit the program.
  156.  
  157. Secondly, the help system may be started without actually
  158. loading SCREEN Thief, by typing "ST /?" from the "\ST"
  159. directory. You will see the SCREEN Thief window on the screen at
  160. this point containing a list of help subjects. Select the
  161. subject you require using the up-arrow and down-arrow keys and
  162. then press the right-arrow key to expand the help screen. Where
  163. applicable, use the up-arrow and down-arrow or the page-up and
  164. page-down keys to view the text in the expanded help screen. The
  165. left-arrow key will return you to the list of help subjects.
  166.  
  167.