home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / autobmp.zip / MANUAL.TXT < prev    next >
Text File  |  1994-09-04  |  16KB  |  372 lines
  1. AutoBMP Version 1.0
  2.  
  3. Have a new BackGround on your DeskTop each time OS/2 is started.  Why look at
  4. the same thing each day, have a new LockUp BackGround each day too, if you
  5. like.  AutoBMP can do both, and save you disk space for storing these images
  6. as well.
  7.  
  8.  
  9.  
  10. IF ALL ELSE FAILS, READ THESE INSTRUCTIONS
  11.  
  12.  
  13.  
  14. Licensing Information:
  15. ---------------------
  16.  
  17. AutoBMP is Copyright (C) 1994 by ATN Enterprises.
  18. AutoBMP is not public domain software, nor is it free software.
  19.  
  20. Full licensing information is provided in the License.Txt File.
  21.  
  22.  
  23.  
  24. Ordering Information:
  25. --------------------
  26.  
  27. The registration fee for continued use of AutoBMP after the 30 day
  28. evaluation period is $19.95.  Full ordering information is provided in
  29. the Order.Txt file.
  30.  
  31.  
  32.  
  33. Files Included:
  34. --------------
  35.  
  36. The following files should be included with the Evaluation Copy of AutoBMP.
  37. If you did not receive all of these files in the archive that contained
  38. AutoBMP then you have an unauthorized copy of AutoBMP and should inform
  39. the source that provided this archive to you of this fact.
  40.  
  41. AutoBMP.Exe  - The AutoBMP program
  42. AutoBMP.Ico  - WPS Icon
  43. Install.Cmd  - The AutoBMP automatic installation program
  44. Order.Txt    - Ordering instructions and order form
  45. License.Txt  - ShareWare 30 day evaluation license agreement
  46. Manual.Txt   - Operating instructions (This file)
  47. BBS.Txt      - Instructions for posting AutoBMP to public BBS systems
  48.  
  49.  
  50.  
  51. Purpose:
  52. -------
  53.  
  54. The AutoBMP utility is used to change the WPS OS/2 DeskTop Background
  55. each time that the computer system is started or rebooted and to store
  56. the BitMaps to be used in a compressed archive file to save disk space.
  57. This change is done without manipulating the WPS settings or making any
  58. changes to the OS2.INI or OS2SYS.INI files.  The archive contaning the
  59. BitMaps can be placed on any fixed drive on the system, it does not have
  60. to be on the OS2 default drive.
  61.  
  62.  
  63.  
  64. Installation requirements:
  65. -------------------------
  66.  
  67. 1.  AutoBMP requires OS/2 Version 2.x or OS/2 for Windows.  AutoBMP will not
  68. install on OS/2 Version 1.x or on any version of DOS.
  69.  
  70. 2.  AutoBMP requires an external archiving utility to be used to process the
  71. BitMaps to be used, into an archive file to save space.  All access to the
  72. archive and its processing are controlled by AutoBMP, however, the actual
  73. archiving utility is not included with AutoBMP.  The following archiving
  74. utilities are supported: (only OS/2 versions of these utililties should
  75. be used)
  76.  
  77.     Actual Exe File Name:      Source:
  78.     --------------------       ------
  79.  
  80. a.  PKZIP2.EXE / PKUNZIP2.EXE  (C) PKWare Inc.
  81.     PKZIP.EXE  / PKUNZIP.EXE   (C) PKWare Inc.
  82.  
  83. b.  LH.EXE                     Peter Fitzsimmons
  84.  
  85. c.  InfoZip as:                (C) Mark Adler, Richard B. Wales, Jean-loup
  86.                                    Gailly, Kai Uwe Rommel
  87.     ZIP.EXE / UNZIP16.EXE or UNZIP32.EXE
  88.  
  89. These utilities can be obtained from almost any BBS, CompuServe, Prodigy,
  90. America On Line, or any source of ShareWare applications.
  91.  
  92. 3.  The archive utility to be used must be located in a directory that
  93. is contained in the OS/2 path statement in the config.sys file.
  94.  
  95. 4.  OS/2 Rexx and the OS/2 Rexx Utilities must be installed for AutoBMP and
  96. the AutoBMP installation program to be used.  These are normally installed
  97. as part of the normal installation process, if they are not installed then
  98. select the OS2 System Folder , Setup, Selective Installation Object to
  99. install Rexx prior to using AutoBMP.
  100.  
  101.  
  102.  
  103. Installation procedure:
  104. ----------------------
  105.  
  106. Automatic Installation
  107.  
  108. 1.  Copy all of the files that you received with AutoBMP to a temporary
  109. directory on any fixed drive, or to a floppy disk.
  110.  
  111. 2.  Set the default drive and directory to the location in 1. above.
  112.  
  113. 3.  Type INSTALL, press ENTER.
  114.  
  115. 4.  The Install program will determine the location of OS/2 on your system,
  116. find all supported archive utilities that are in the OS/2 search path,
  117. determine if the VROBJ.DLL is already installed on the system, and install
  118. it if necessary, create a DeskTop WPS object for AutoBMP, and create an
  119. AutoBMP object in the StartUP Folder to automaticly change the DeskTop when
  120. the system is booted.
  121.  
  122. 5.  After the installation is completed, AutoBMP will be started, you
  123. should then switch to the OS/2 WPS DeskTop, you now can begin to add the
  124. BitMaps desired to the AutoBMP archive as outlined in the Operating
  125. Instruction portion of this manual.
  126.  
  127. 6.  When at least one BitMap has been added to the AutoBMP archive, select
  128. "SETTINGS" from the tool bar, then select "LOAD NEXT BITMAP FROM ARCHIVE."
  129. This will create a BitMap named "AutoBMP.BMP" in the OS2_Drive:\ OS2\BitMap
  130. directory.  This BitMap will contain the image of the first BitMap in the
  131. AutoBMP archive.
  132.  
  133. 7.  Once the AutoBMP.BMP BitMap has been created in 6. above, open the
  134. DeskTop Settings Folder using the right mouse button on an empty part of
  135. the DeskTop, select the BackGround Tab and select the AutoBMP.BMP
  136. BitMap as the default BackGround BitMap, close the DeskTop Settings Folder.
  137. The first BitMap that was added to the AutoBMP archive is now displayed as
  138. the DeskTop WPS BackGround.
  139.  
  140. 8.  After adding additional BitMaps perform step 6. above again.  This
  141. will change the AutoBMP.BMP to the next BMP in the archive, so that when
  142. the system is rebooted this will become the new DeskTop WPS BackGround.
  143. If this is not done, then at the first reboot after installation the system
  144. will display the same BitMap again, however, all reboots after this initial
  145. one will change the BitMaps properly.  See 10. below for details.
  146.  
  147. 9.  The installation is now complete.  Each time that the system is rebooted
  148. AutoBMP will be run from the AutoBMP object in the StartUp Folder, this will
  149. automaticly change the DeskTop BitMap to the next one in the archive, when
  150. the last BitMap in the archive is used, the system will reset and start
  151. from the first BMP in the archive.
  152.  
  153. 10. REMEMBER, the BitMap being displayed is the image that was in the
  154. AutoBMP.BMP BitMap when the system was booted, after booting and automaticly
  155. running AutoBMP, the AutoBMP.BMP will contain the image that will be
  156. displayed at the next reboot of the system.
  157.  
  158. 11. When the installation has been completed delete the temporary directory
  159. that was used to hold the AutoBMP files during installation.
  160.  
  161.  
  162.  
  163. Manual Installation:
  164. -------------------
  165.  
  166. 1.  Create a directory for AutoBMP on any system fixed drive.
  167.  
  168. 2.  Copy AutoBMP.Exe and AutoBMP.Ico to this directory.  You should also
  169. copy the Order.Txt and License.Txt files to this directory for your
  170. future reference at the end of the Evaluation Period.
  171.  
  172. 3.  Copy the file VROBJ.DLL to any directory that is contained in the OS/2
  173. config.sys file LIBPATH.
  174.  
  175. 4.  Change to the directory containing AutoBMP and enter START AUTOBMP.
  176.  
  177. 5.  Switch to the WPS DeskTop and perform 6. thru 10. of the "Automatic
  178. Installation Instructions" above.
  179.  
  180. 6.  You must manually create the DeskTop Objects for AutoBmp and the
  181. StartUp Folder Object for AutoBMP.  To cause AutoBMP to start in the
  182. "Change BitMap Mode," that is to automaticly load the next image from the
  183. archive into the AutoBMP.BMP BitMap during OS/2 Boot up, and object for
  184. AutoBMP must be placed in the StartUp Folder or a line placed in the OS/2
  185. StartUp.Cmd file in the following manner:  AutoBMP must be started with the
  186. following Command Line option:  CHANGE  if you place this in your STARTUP.CMD
  187. file the Syntax is:   START AUTOBMP CHANGE  if you create an Object in the
  188. STARTUP FOLDER for AutoBMP then  CHANGE  should be entered in the
  189. "OPTIONAL PARAMETERS" entry on page one of the Object.
  190.  
  191. To start AutoBMP in the normal user entry mode, simply enter AUTOBMP at a
  192. command line prompt, after changing to the dir containing AutoBMP or
  193. create a DeskTop Object for AutoBMP.
  194.  
  195.  
  196.  
  197. Method of operation:
  198. -------------------
  199.  
  200. AutoBMP makes use of the fact that the BitMap (BMP) that is used for the
  201. WPS background is loaded into memory during the initialization of OS/2
  202. when the system is booted.  This is the only time that this BitMap is loaded
  203. unless there is a system (WPS) failure during the operation of OS/2 which
  204. would require the WPS to reboot.  The method that AutoBMP uses to change
  205. the DeskTop is to set the WPS Background (DeskTop) (via the DeskTop Settings
  206. Folder) to use a specific named Bitmap (AutoBMP.BMP) and then after the
  207. DeskTop has been loaded from that BitMap during booting, changing the
  208. content of that BitMap to be the new background BitMap that will be used
  209. at the next reboot.  This also allows an interesting method of changing the
  210. lockup BitMap display at the same time, since the lockup screen background
  211. is loaded into memory each time that the lockup funciton is called, if the
  212. lockup BitMap selection is also set to use the AutoBMP.BMP BitMap then it will
  213. display the BitMap that will be used at the next reboot, which is different
  214. from the one that is being used by the current DeskTop background.  This
  215. allows both the Desktop Background and the Lockup Screen background to be
  216. changed each time the system is rebooted and have only one BitMap using
  217. space on the system to accomplish this, (two for the disk space of one).
  218. If you elect to also use the AutoBMP.BMP BitMap for the LockUp Screen
  219. background and have set the LockUp function to lock the DeskTop during
  220. OS/2 startup, this initial LockUp screen will display the same background
  221. as the DeskTop, since the AutoBMP.BMP file has not yet been updated during
  222. the boot process, however, all subsequent LockUp screens will display the
  223. new image contained in the AutoBMP.BMP file after AutoBMP has been run
  224. from the StartUp Folder or the StartUP.Cmd file during the completion of
  225. the OS/2 boot process.
  226.  
  227.  
  228.  
  229. Operating Instructions:
  230. ----------------------
  231.  
  232. AutoBMP runs in two modes:
  233.  
  234. The NORMAL mode of AutoBMP is started either by clicking the mouse on the
  235. DeskTop AutoBMP object or from the command line by issuing the command
  236. START AutoBMP  in this mode, the user interface window is started and
  237. BitMaps can be added or deleted and all functions of AutoBMP can be
  238. accesed.
  239.  
  240. The AUTOMATIC BitMap CHANGE mode is started by the AutoBMP Object in the
  241. StartUp Folder or, in the command line mode, by an entry in the StartUp.Cmd
  242. file.  This mode automaticly changes the image contained in the AutoBMP.BMP
  243. (the next DeskTop background that will be displayed) each time the system
  244. is rebooted.  This mode will display a window showing the current DeskTop
  245. background image and the image that will be displayed the next time the
  246. system is rebooted.  This window has no user access and will be displayed
  247. for a period of 10 seconds after both BitMap images have be updated from
  248. the AutoBmp archive.  The total time that this window displays is
  249. dependent upon the speed of the archive utility that was selected to
  250. process the BitMap BMPs.  The command line instruction for this mode is
  251. START AUTOBMP CHANGE.
  252.  
  253.  
  254.  
  255. Operating AutoBMP In The Normal Mode:
  256. ------------------------------------
  257.  
  258. Adding BitMaps, Creating AutoBMP Archive:
  259.  
  260. To Create an archive of BitMaps simply click the SELECT button to select a
  261. BiTMap, this BitMap will be displayed in the BitMap Window, and its name
  262. placed into the "New BitMap(s)" List.  When you have finished selecting the
  263. BitMaps you want, then click the ADD button to add the BitMaps to the
  264. archive, if there is a BitMap in the list that you decide you do not wish
  265. to add just unhighlite it prior to clicking the ADD button.  If you already
  266. have BitMaps in the archive, you will not be able to place a BitMap in the
  267. "New BitMaps(s)" List that is already in the archive.
  268.  
  269.  
  270. Deleting BitMaps From The AutoBMP Archive:
  271.  
  272. Highlite the BitMaps to delete in the "AutoBMP List" window, then click on
  273. REMOVE.  The selected BitMaps will be removed, and the BitMap window will
  274. display the current AutoBMP.BMP.
  275.  
  276.  
  277.  
  278. Tool Bar SETTINGS Selections:
  279.  
  280.  
  281. 1.  Change Next DeskTop BitMap:
  282.  
  283. This selection allows you to change the next BitMap to be displayed to
  284. any BitMap that is in the archive, and to optionally change the display
  285. count to point to next BitMap after the one selected.
  286.  
  287.  
  288. 2.  Load Next BitMap From Archive:
  289.  
  290. This selection will cause the AutoBMP.BMP BitMap to be updated with the
  291. image from the next BitMap in the archive, and the BitMap count to be
  292. set to the next BitMap after the one just loaded.  This has the same effect
  293. as if you had started AutoBMP with the  CHANGE  Command Line parameter.
  294.  
  295.  
  296. 3.  ReSet AutoBMP Archive:
  297.  
  298. This selection will cause AutoBMP to read the names of all BitMaps currently
  299. in the AutoBMP archive and set its list of BitMaps to match, it will also
  300. reset the next BitMap to be displayed count to the first BitMap in the
  301. archive.  You should use this selection if your archive contents get out
  302. of sync with the INI files settings of AutoBMP, or if you would manually
  303. change the contents of the AutoBMP archive.
  304.  
  305.  
  306.  
  307. Help:
  308. ----
  309.  
  310. At the bottom of each window a short discription of each control, list box,
  311. and window item is displayed when the mouse cursor is placed on that item.
  312. Pressing F1 will display addition help for some items when that item has the
  313. action focus.
  314.  
  315.  
  316.  
  317. Errors:
  318. ------
  319.  
  320. Error recover is built in for most processing/install errors that may occur.
  321. However, in the event of an external archiver error, the Vx-Rexx console
  322. screen will be brought to the foreground and display the error message, you
  323. may then take the necessary action to correct the error and continue
  324. processing with AutoBMP.  This console screen will normally remain in the
  325. background as it will be blank as long as no errors occur.
  326.  
  327.  
  328.  
  329. Addition OS/2 BitMap Display Information:
  330. ----------------------------------------
  331.  
  332. 1.  The OS/2 2.x WPS DeskTop BackGround is displayed by a fixed palette
  333. application, this means that all colors that are in the BitMap to be
  334. displayed must be in the OS/2 default palette in order for the BitMap to
  335. be displayed properly.  Many BitMaps have more than these colors in them,
  336. these types of BitMaps will be displayed with shifted colors and may or may
  337. not be usable as DeskTop BackGrounds.
  338.  
  339. 2.  The BackGround display BMP is loaded into memory during the OS/2 boot
  340. process, this memory is lost to the system for all processing functions
  341. from that time on.  You should consider using small size BMPs if you have
  342. limited memory resources in your system.  If you are using a BitMap that
  343. has a small picture image in its center and this is surrounded by a solid
  344. color for the remainder of the image, you should crop this BitMap to the
  345. size of the picture at its center.  The color that has been set for the
  346. DeskTop color, using the settings folder BackGround settings, will then
  347. be displayed around this image.  This may make a significant decrease in
  348. the size of the BitMap, which will save both disk storage space and memory
  349. as well.  This smaller image will also cause the screen displays to change
  350. more quickly during the operation of OS/2.  There are many ShareWare
  351. image processing utilities that can be used for BitMap cropping.
  352.  
  353.  
  354. 3.  The speed of processing of the archived BitMaps and the compressed size
  355. of the archive will depend upon the type of archiver that you select to use.
  356. Some of the supported archivers compress quickly, but do not make as small an
  357. archive as one that processes slower.  You should consider this when selecting
  358. the archiver to use.
  359.  
  360.  
  361.  
  362. Problem Reports, Comments, or Questions:
  363. ---------------------------------------
  364.  
  365. These may be mailed to the address listed for Registration/Ordering or
  366. may be Emailed on CompuServe to 71021,2531.
  367.  
  368.  
  369.  
  370. IF ALL ELSE FAILS, READ THESE INSTRUCTIONS
  371.  
  372.