home *** CD-ROM | disk | FTP | other *** search
/ TopWare 18: Liquid / Image.iso / liquid / top1148 / gepackt.exe / PCX2EXE.DOC < prev    next >
Encoding:
Text File  |  1993-10-12  |  13.2 KB  |  369 lines
  1. PCX2EXE by Mike Williams, August 1993.
  2.  
  3.  
  4. Overview.
  5.  
  6.  
  7. PCX2EXE is a program for turning certain PCX files into self-displaying 
  8. executable programs ( referred to as 'host programs' ). 
  9. For best results, the files should be compatible with one of the following 
  10. screen modes:-
  11.  
  12.  -  800 by 600 16 colour SVGA mode.
  13.     The host file supports systems by Ahead Technologies, ATI, Chips & 
  14.     Technologies, Everex, Genoa, NCR, Oak Technologies, Paradise, Trident, 
  15.     Tseng, Video 7, and any VESA compatible system.
  16.  
  17.  -  640 by 480 16 colour VGA mode
  18.  
  19.  -  640 by 350 16 colour EGA mode.
  20.  
  21.  -  320 by 200 by 256 colour VGA/MCGA mode. 
  22.     256 colour images up to a resolution of 640 x 480 will be scaled to fit
  23.     the 320 x 200 x 256 mode. This may reduce image quality unacceptably.
  24.     
  25. The following two modes should work on any register compatible VGA card.
  26.  
  27.  -  320 by 400 by 256 colours.
  28.  
  29.  -  360 by 480 by 256 colours.
  30.  
  31. Some other modes will also work, though the aspect ratio may be altered.
  32.  
  33. The program works by adding the image to the end of one of a number of 
  34. possible 'stub' files. If you use an executable file compressor such as 
  35. PKLITE, LZEXE or DIET, then you can greatly reduce the file size. 
  36.  
  37. For example, the PCXHELP.PCX file starts as a 8K byte PCX file.
  38. PCX2EXE then produces a host file 16K in size. Use DIET on the 
  39. program and it reduces to under 5K ! 
  40.  
  41. Other utilities provided include :-
  42.  
  43.       - GET-PCX, a TSR screen grabber which saves images directly
  44.         to the PCX file format.
  45.  
  46.       - SCALEPCX, a utility to adjust a PCX file to a given size.
  47.  
  48.       - PACKPCX, a utility providing lossless compression of a 256
  49.         colour PCX file.
  50.  
  51.  
  52. Shareware.
  53.  
  54.  
  55. PCX2EXE is not free software. This means you can try it out to see if it 
  56. fits your needs before deciding to buy. If you regularly use PCX2EXE, or 
  57. distribute any of the host programs, you are required to register with the 
  58. author. Registration entitles you to the latest version of the software, 
  59. and technical support by phone.
  60.  
  61. There are two main registration options.
  62.  
  63. a. Single User, individual use only. This licence permits use of
  64.    PCX2EXE on one system only. The slideshow program SHOW.EXE,
  65.    and any host files you create, may be freely copied and 
  66.    distributed as long as:- 
  67.  
  68.    1. No charge is made.
  69.    2. They are not used for promotional purposes, such as 
  70.       producing a demonstration program.
  71.  
  72.    A single user licence is currently 12 pounds ( 20 US dollars ).
  73.  
  74. b. Corporate User. This licence permits use of PCX2EXE on one
  75.    system only. SHOW.EXE, along with any host files, may be 
  76.    freely copied, distributed or sold without any preconditions.
  77.    
  78.    A corporate licence is currently 25 pounds ( 40 US dollars )
  79.  
  80.  
  81. Shareware libraries, bulletin boards etc. may freely distribute
  82. this program as long as all files are included without alteration.
  83.  
  84.  
  85. If registering from outside the UK, please send either an 
  86. International Money Order, or cash by registered mail ( in pounds
  87. sterling, or your local equivalent in notes ). DO NOT send a 
  88. cheque, unless drawn from a UK bank and in pounds. It costs so
  89. much to cash them that they are effectively worthless.
  90.  
  91.  
  92. Order Form.
  93.  
  94.  
  95. Use the following form to order ( also in ORDER.FRM ).
  96.  
  97.  
  98.     +--------------------------------------------------------------------+
  99.     |                                                                    |
  100.     |  I wish to license _____ copy/copies of PCX2EXE.                   |
  101.     |                                                                    |
  102.     |  I have version _____.                                             |
  103.     |                                                                    |
  104.     |  Number of copies:                                                 |
  105.     |                                                                    |
  106.     |  Single User      _____ at £12/$20                                 |
  107.     |                                                                    |
  108.     |  Corporate User   _____ at £25/$40                                 |
  109.     |                                                                    |
  110.     |  Name ___________________________________________________________  |
  111.     |                                                                    |
  112.     |  Company (if applicable) ________________________________________  |
  113.     |                                                                    |
  114.     |  Address ________________________________________________________  |
  115.     |                                                                    |
  116.     |  Town/City ______________________________________________________  |
  117.     |                                                                    |
  118.     |  County/ State ______________________  Post/Zip Code ____________  |
  119.     |                                                                    |
  120.     |                                                                    |
  121.     |  Please Send:  _____ 3.5" disk(s);  _____ 5.25" disk(s)            |
  122.     |                                                                    |
  123.     +--------------------------------------------------------------------+
  124.  
  125.  
  126. Please send the form, with your remittance, to :-
  127.  
  128.      Mike Williams
  129.      36 Laithwaite Close
  130.      LEICESTER LE4 1BX
  131.      England
  132.  
  133.  
  134. Installation.
  135.  
  136.  
  137. Simply copy the program files into a directory on your hard disk.
  138.  
  139.  
  140. Running the software.
  141.  
  142.  
  143. There are two ways to convert PCX files.
  144.  
  145. 1. Running the program PCX2EXE produces a Windows-like dialog box. 
  146. Clicking on the arrow to the right of the Drives box allows you to
  147. select the drive containing the file you wish to convert.
  148. Click on the directory containing the file, and it should appear
  149. in the 'files' box. You may need to use the scroll bars.
  150. Click on the file name, then select either the "Make EXE" button
  151. to produce the host file, or "Make EXE and test" to produce the
  152. host file and try it out immediately.
  153.  
  154. 2. If you don't need a fancy front-end, mouse support, etc. 
  155. then P2E.EXE is all you need ( and it's much smaller ! )
  156. Simply supply it with the path name of the file to convert, 
  157. and it will do the hard work. For example,
  158.  
  159. P2E C:\ART\NICEPIC.PCX
  160.  
  161. NOTE: Both methods leave the .EXE file in the same directory
  162. as the PCX file. In the above example, P2E would produce the
  163. file C:\ART\NICEPIC.EXE .
  164.  
  165.  
  166. Selecting the host file.
  167.  
  168.  
  169. The system currently automatically chooses an appropriate host
  170. file depending on the type of image file you pass to it.
  171.  
  172. This may cause problems under certain circumstances.
  173.  
  174. For example, if the image was created in 640 x 480 x 16 colour 
  175. VGA mode, but the image depth is less than or equal to 350 pixels
  176. ( i.e. 640 x 300 ) then the software will use the EGA host file.
  177. The image still appears,but will be stretched vertically.
  178.  
  179.  
  180. The Self-Displaying Files.
  181.  
  182.  
  183. A self-displaying file may be run like any other DOS program, 
  184. either by typing its' name at the command line, or including 
  185. it in a batch file. After displaying the PCX picture embedded 
  186. within it, the file waits for a keypress OR a mouse click 
  187. ( either the left or right button ). When this occurs the 
  188. file restores the screen to text mode, and ends.
  189.  
  190. The file will only display correctly if the system on which it 
  191. is being run has a display capable of showing the stored image.
  192. For example, you cannot show a 320 x 200 x 256 colour VGA image
  193. on a CGA monitor. ( Though a monochrome VGA would be fine ).
  194.  
  195.  
  196. Compressing the Self-Displaying Files.
  197.  
  198.  
  199. PCX files have an unusual distinction in that they always use
  200. a form of compression ( to make the disk file smaller ), yet 
  201. often make the file actually larger than it should be.
  202. The worst offenders are scanned 256 colour photographs.
  203.  
  204. PCX2EXE uses a separate utility, PACKPCX, to shrink such files
  205. to a more manageable size, before converting them into an
  206. EXE file. Sometimes there is no saving, but other images can
  207. be reduced by 20 to 30 percent.
  208.  
  209. The most significant benefit is acheived by using an executable
  210. file compressor. This works like an archiving program. You tell
  211. it the program you want to compress, and it shrinks it by a
  212. significant amount ( typically 20-60% ).  The beauty of the system 
  213. is that the program decompresses automatically when you run it, so 
  214. the only change you notice is that you have more free disk space.
  215.  
  216. The most effective two programs are DIET and PKLITE; if having
  217. the smallest possible file is important, get hold of both.
  218.  
  219. Note ! DO NOT compress the host files ( STUB*.EXE ) or the PCX images.
  220. If you do, the system will not work correctly.
  221. Only compress the finished image, like this.
  222.  
  223. P2E logo.pcx            'Convert logo.pcx to an EXE file
  224. DIET logo.exe           'Compress logo.exe
  225.  
  226.  
  227. Creating more advanced displays.
  228.  
  229.  
  230. The standard behaviour of a self-displaying file is of little
  231. use if you want to display a number of pictures in succession
  232. without user interaction ( i.e. for some kind of rolling demo ).
  233. Alternatively, you may need more user interaction, such as 
  234. providing the means to step back through a list of files.
  235. The program SHOW.EXE is provided to fulfill these requirements.
  236.  
  237.  
  238. Using SHOW.EXE.
  239.  
  240.  
  241. Command Format: SHOW filename [/Pnn] [/NOTEXT] [/NOCLS] [/NOBLANK]
  242.  
  243. filename may be either :-
  244.  
  245.   a) An individual PCX2EXE-created executable, or
  246.  
  247.   b) A script file. This is a plain ASCII file containing
  248.      a list of all the files you wish to display. A script
  249.      file must have the extension '.SCR'.
  250.  
  251. /Pnn is an optional switch which causes SHOW to pause for nn
  252. seconds before moving to the next image.
  253.  
  254. /NOTEXT prevents SHOW resetting text mode between images, which
  255. can sometimes cause unsightly screen 'judder'.
  256.  
  257. /NOCLS prevents SHOW clearing the screen between images. This can
  258. produce a smoother transfer, as long as all images use the same
  259. video mode.
  260.  
  261. /NOBLANK prevents SHOW blanking the screen while an image is loading.
  262. This is done so that even when loading from a floppy, an image appears
  263. to just 'pop' onto the screen. However, if your system is very fast
  264. then using this switch can make for a smoother transfer between images.
  265.  
  266.  
  267. Examples:-
  268.  
  269.  
  270. SHOW PIC .............. Runs the file PIC.EXE. Equivalent to
  271.                         Running PIC.EXE directly.
  272.  
  273. SHOW PIC /P10 ......... Runs the file PIC.EXE. Terminates the 
  274.                         program automatically after 10 seconds
  275.                         if no keypress or mouseclick has occurred.
  276.  
  277. SHOW PICS.SCR /P8 ..... Create a rolling demo of all the files named
  278.                         in PICS.SCR, giving each image a maximum of 
  279.                         8 seconds before moving on.
  280.  
  281.  
  282. Run the batch file DEMO to see an example of SHOW.
  283.  
  284.  
  285. Help Facility.
  286.  
  287.  
  288. SHOW also contains a rudimentary HELP facility. If the user
  289. presses the F1 key when a picture is displayed, AND the current
  290. directory contains an embedded file called PCXHELP.EXE, then 
  291. that file will be displayed. When the user presses another key,
  292. the previous picture will be restored.
  293.  
  294.  
  295. Obtaining PCX files.
  296.  
  297.  
  298. PCX images are commonly produced by many graphics packages.
  299. You may use the package to produce the picture, save it to disk,
  300. then convert it using PCX2EXE. 
  301.  
  302. DOS users may find GET-PCX, included with the PCX2EXE package,
  303. quite useful. It is a TSR screen grabber which can be used to,
  304. er, grab screens from other packages, and save them as a PCX file.
  305.  
  306. Windows users are in the best position. Alt-<PrtSc> will copy the
  307. current window to the clipboard. Paste the image into PaintBrush,
  308. and you can then save it as a PCX file. There are a few pointers
  309. that will help you, though ( see below ).
  310.  
  311.  
  312. Windows-produced PCX files.
  313.  
  314.  
  315. If you want to use an image from Windows, bear in mind that
  316. PCX2EXE only works with standard VGA modes. To get results 
  317. using ( for example ) PaintBrush, try the following BEFORE
  318. importing/creating your picture.
  319.  
  320. 1. Select 'Options' and 'Image Attributes'.
  321.  
  322. 2. Click on the 'Pels' option button.
  323.  
  324. 3. If your standard Windows video mode uses 256 colours,
  325.    enter a width of 320 and a height of 200. If you only
  326.    use 16 colours, enter a width of 640 and a height of 480.
  327.    If you aren't sure, click on the 'Windows Setup' icon
  328.    which should be in your Main group, and check the current
  329.    display setting.
  330.  
  331. 4. Click on 'OK' to save. PaintBrush will now restart with
  332.    the new parameters.
  333.  
  334. When you save your image, give it an extension of '.PCX', and 
  335. select 'PCX Files' from the 'Save Files As Type' list box.
  336.  
  337.  
  338. A New Windows Logo ?
  339.  
  340.  
  341. You can use a PCX2EXE host file to display a new customised 
  342. Windows logo when Windows is loading. Follow these steps.
  343.  
  344. 1. Create the host file as normal; call it NEWLOGO.EXE and 
  345.    save it in the \WINDOWS directory.
  346.  
  347. 2. Change the batch file command that calls up Windows from
  348.  
  349.    WIN
  350.  
  351.    to 
  352.  
  353.    WIN :
  354.  
  355.    This will suppress the standard logo.
  356.  
  357. 3. Create a batch file called WINSTART.BAT, again in the 
  358.    WINDOWS directory. When Windows loads, this batch file
  359.    is automatically executed. If the file reads 
  360.  
  361.    NEWLOGO
  362.  
  363.    then the logo will be displayed until a key is pressed,
  364.    or the mouse clicked.
  365.  
  366.    To display the logo only briefly, use something like
  367.  
  368.    SHOW NEWLOGO /P2
  369.