home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / PMVU85A.ZIP / PMVIEW.DOC < prev    next >
Text File  |  1993-06-21  |  31KB  |  671 lines

  1. INTRODUCTION
  2. ============
  3. This is the documentation for PMView BETA VERSION 0.85a. You don't have
  4. to read this file if you don't want to, though you might miss out on
  5. some useful information.
  6.  
  7. PMView 0.85a has some interesting new features that I'll document
  8. quickly in the next section:
  9.  
  10. NEW FEATURES
  11. ============
  12. 1) New menu structure. We no longer stuff everything under _Edit. ;-).
  13.  
  14. 2) A "quick BMP dump" for our registered users. The full save will be
  15. in 0.87.
  16.  
  17. 3) New clipboard support.
  18.  
  19. 4) _Transform _Size to resize your actual bitmap, either proportionally
  20. or not.
  21.  
  22. 5) _Transform _Quick Dither to make your bitmap more suitable for use
  23. as a background (again, you need to register in order to save your
  24. bitmap).
  25.  
  26. 6) _View _Zoom, with many hotkeys, to let you zoom in or out of your
  27. bitmap.
  28.  
  29. 7) Support for scrolling using arrow keys.
  30.  
  31. 8) A renamed _Options notebook
  32.  
  33. 9) A key for hiding the mouse pointer while in Fullscreen mode.
  34.  
  35. 10) Various bug and "feature" fixes.
  36.  
  37. There are probably other additions that have slipped my mind for the
  38. moment. The user interface for the slideshow is *still* not quite
  39. right, but we will improve it significantly (honest!) in 0.86. We
  40. decided to release 0.85a now because of the added convenience
  41. (especially to our registered users), and because it fixes a rather
  42. nasty bug that can crop up under the March beta (and thus might show up
  43. under OS/2 2.1 GA.)
  44.  
  45.                            *      *      *
  46.  
  47. Let me introduce myself. I'm Raja Thiagarajan, Official Documenter (tm)
  48. of PMView. Peter Nielsen, who wrote PMView, asked me to write the docs.
  49. I'd appreciate any comments or questions about these docs, just as
  50. Peter would appreciate any comments or questions about PMView itself.
  51. Both of our electronic mail addresses are in Appendix 1 at the end of
  52. this file; Peter's address can also be found by selecting _Help _About
  53. from the PMView menu.
  54.  
  55. If you have a uudecoder and an electronic mailbox that can be reached
  56. from the Internet, you can join our beta program by sending me an
  57. e-mail message. It doesn't cost anything; we just expect you to fill
  58. out an e-mailed survey form and give us bug reports (or other
  59. feedback!) on new versions of PMView as they're released. To join our
  60. beta program, just drop me a line at sthiagar@nickel.ucs.indiana.edu.
  61.  
  62. All the above provisions are void where prohibited, and subject to
  63. change (though that's not likely).
  64.  
  65. Please read the License and Warranty information in LICENSE.DOC. If
  66. you've read some of the repressive provisions of other companies'
  67. software, you may be in for a pleasant surprise.
  68.  
  69. (I'll just make one short comment here: Since PMView is shareware, you
  70. are permitted [even encouraged!] to pass on the PMView ZIP file. You
  71. may NOT modify this file, or pass on any of its individual components.)
  72.  
  73. PROGRAM REQUIREMENTS
  74. ====================
  75. To use this program, you *must* be running OS/2 2.0 or later. PMView
  76. is a fully 32-bit program. (This is part of the reason PMView is so
  77. fast. The other part is because Peter has spent literally *hundreds* of
  78. hours fine-tuning the decoding routines by hand, in 80486 assembly
  79. language.)
  80.  
  81. Our beta testers report that if you are running the original,
  82. shrinkwrapped version of OS/2 2.0, you must install CSD 6055 (also
  83. known as "the Service Pack") for everything to work. The version of
  84. OS/2 2.0 that IBM sold initially had some bugs in the Palette Manager
  85. subsystem that will prevent PMView from running. All other versions
  86. (preinstalled 2.00.1, the various 2.1 betas, and 2.1GA itself) are
  87. reputed to work fine.
  88.  
  89. USING THE PROGRAM
  90. =================
  91. To use the program, set the PMVIEW_INI environment variable (see the
  92. next section), place PMVIEW.EXE somewhere on your path and enter the
  93. command
  94.  
  95.     PMVIEW [flag(s)] [filename]
  96.  
  97. where "flag(s)" and "filename" are optional. The flags are documented
  98. two sections below this one. "Filename" is an optional name of a file
  99. you want to view. (If you don't  provide a filename, PMView will start
  100. up with a black screen.) The filename can include a drive, directory
  101. path, or both. If you don't give an extension, PMView will try to
  102. "guess" it anyway. (Specifically, if you leave off the extension and
  103. PMView can't find a file with that name, it'll try the extensions .BMP,
  104. .GIF, .JPG, .TGA, and .PCX, in that order. You can modify this using
  105. the _Extensions page on PMView's options notebook.)
  106.  
  107. ENVIRONMENT VARIABLES
  108. =====================
  109. To backtrack a little, there is an OS/2 environment variable that
  110. PMView uses: PMVIEW_INI. This variable specifies the filename
  111. (including full path) that PMView should use for storing its options.
  112. If this environment variable is not set, PMView will create the file
  113. PMVIEW.INI in the current directory and store its information there.
  114. Thus, if you don't want *lots* of copies of PMVIEW.INI scattered around
  115. your hard drive, we recommend that you put the line
  116.  
  117.    set PMVIEW_INI=C:\OS2\PMVIEW.INI
  118.  
  119. in your CONFIG.SYS. (Of course, you can use any other path or filename
  120. that you want; we find it convenient to keep all our OS/2 INI files in
  121. one place.)
  122.  
  123. FLAGS
  124. =====
  125. There are five optional flags that you can use when invoking PMView.
  126.  
  127. /IDLE_LOAD, /NO_IDLE_LOAD: Use these flags to temporarily force (or
  128. disable) idle-time priority for PMView's image-loading thread. See
  129. BUGS.DOC for a discussion of idle-time priority.
  130.  
  131. /PAL_MAN, /NO_PAL_MAN: Use these flags to temporarily force (or
  132. disable) the use of Palette Manager.
  133.  
  134. /INI: Use this flag to temporarily set the pathname for PMView's INI
  135. file. For example:
  136.  
  137.     PMVIEW /INI=D:\TEMP\PMVIEW.INI
  138.  
  139. will cause this PMView session to read (and write) its settings to
  140. D:\TEMP\PMVIEW.INI instead of the file specified by the PMVIEW_INI
  141. environment variable. For instance, you could have several different
  142. INI files with different settings and put an icon for each on your
  143. desktop, with different "/INI=" flags in the Parameters field of each
  144. object's settings notebook.
  145.  
  146. PMVIEW COMMANDS
  147. ===============
  148. Here's a list of the menu commands and a comment on what each one does:
  149.  
  150. _File _Open: This starts a dialog box that lets you open (i.e., load
  151. and look at) a new file. This should be fairly straightforward.
  152. Initially, PMView will list all the *.BMP, *.GIF, *.JPG, *.TGA, and
  153. *.PCX files in the current directory. To change this, type the filename
  154. filter you want in the "Open Filename:" area and then click the "Open"
  155. button. For instance, to get a list of GIF files that start with "ray",
  156. enter RAY*.GIF and click "Open". You can put several of these together,
  157. separated by semicolons (";"). So, for instance, "RAY*.GIF;*.BMP" will
  158. list all the files that either start with "RAY" and have the extension
  159. "GIF" *or* have the extension "BMP."
  160.  
  161. A shortcut for selecting one of these extensions is to pick it off the
  162. "Type of file:" list. Check it out.
  163.  
  164. You can use the ^O (that is, Control-O) shortcut key to invoke this
  165. command at any time, as long as a slideshow isn't running. ^O will work
  166. even if PMView is in Full Screen mode (e.g., after hitting F3) or
  167. iconified. If you have the "Override system colors in fullscreen mode"
  168. option set, this dialog will appear, but it will *not* necessarily be
  169. readable. That's *why* overriding system colors isn't the default.
  170.  
  171. To start up a slideshow, simply select several files before clicking
  172. the "Open" button. The images will be loaded, one at a time, in
  173. alphabetical order. (I *know* that's dumb, but we can't fix it until we
  174. do 0.86.) You can jump forward to the next image by pressing either
  175. mouse button, or by hitting the SPACEBAR. To end the slideshow, press
  176. ESC.
  177.  
  178. _File _Reopen: This reloads your current file from disk, which means
  179. any changes you had made to it (or your view of it) are lost.
  180.  
  181. _File _Save: This feature doesn't work in the unregistered version. In
  182. the registered version of 0.85a, this lets you do a "quick BMP dump" of
  183. your current image. We hope that the registered version of PMView will
  184. eventually let you write files in any format that it can read;
  185. currently, we've got that scheduled for version 0.87. 
  186.  
  187. _File Save _as: This doesn't work in the unregistered version. In the
  188. registered version, it currently does exactly the same thing as _File
  189. _Save.
  190.  
  191. _File _Delete: This deletes the file that you're viewing. See BUGS.DOC
  192. for a note about a "feature" of WPS that affects this. You can use ^D
  193. as a shortcut.
  194.  
  195. _File E_xit: This quits PMView and returns you to OS/2. ^X is the
  196. shortcut key.
  197.  
  198. _Edit: These commands copy images to or from the OS/2 clipboard.
  199. Palette information is preserved for 256-color images; thus, you can
  200. copy from one PMView session and paste into another without color
  201. distortions.
  202.  
  203. _Edit _Cut: This removes the current image from PMView (giving you an
  204. empty window) and puts it on the clipboard.
  205.  
  206. _Edit _Copy: This puts a copy of the current image on the clipboard
  207. (without removing it from PMView).
  208.  
  209. _Edit _Paste: This pastes the image that is currently on the clipboard
  210. into PMView. 
  211.  
  212. _Transform: These commands change the image that you have loaded in
  213. PMView. (The original copy on your disk is unaffected, of course.)
  214.  
  215. _Transform _Flip: This turns the image upside down. If you had an image
  216. of a big "M", it would look like the image of a big "W".
  217.  
  218. _Transform _Mirror: This reverses left and right on the image. If you
  219. had an image of a left parenthesis, it would look like a right
  220. parenthesis.
  221.  
  222. _Transform _Rotate->90 _Clockwise: This rotates the image clockwise by
  223. 90 degrees. An arrow that pointed up would now point right.
  224.  
  225. _Transform _Rotate->90 Counter CounterClock_Wise: This rotates the
  226. image counterclockwise by 90 degrees. An arrow that pointed up would
  227. now point left.
  228.  
  229. _Transform _Size: This opens a control that changes the actual size of
  230. the image. You can specify the new size of the image in pixels or
  231. percentage (%). If Keep Proportional is checked (the default), the new
  232. image will have the same proportions as the original (eg, a circle
  233. would still be a circle).
  234.  
  235. _Transform _Quick Dither: This does a quick job of reducing an image to
  236. OS/2's default 256-color palette. If you want to save an image to use
  237. as a background for your desktop or a folder, doing a quick dither on
  238. it first may improve its appearance. If you plan to also size the
  239. image, do quick dithering *last*.
  240.  
  241. _Color: These commands change the colors in your image. (Your pixel
  242. data will also change to go along with the changing colors.)
  243.  
  244. _Color _Brightness/Contrast: This opens a control that lets you adjust
  245. the brightness, contrast, and saturation of your image. Brightness and
  246. contrast work pretty much the way they do on a TV set. Saturation
  247. refers to how much color appears in the image (some TV sets have a
  248. control marked "color" that does this). If you turn the saturation all
  249. the way down, you'll get a black-and-white image.
  250.  
  251. Peter notes that if you're handling 24-bit images and don't use the
  252. Palette Manager, you should adjust saturation *last*. This is because
  253. the other adjustments take *twice* as long when saturation has been
  254. moved away from 0% under those circumstances. To reiterate: If you're
  255. running OS/2 in 24-bit (or 15- or 16-bit) mode, or if you've loaded a
  256. 24-bit image (i.e., a Targa, JPEG, or 24-bit BMP image) and disabled
  257. Palette Manager, change saturation *last*.
  258.  
  259. If you change your mind later, you can come back to this control and
  260. press the Reset button. This will return you to your original settings
  261. for brightness, contrast, and saturation.
  262.  
  263. _Color RGB B_alance: This opens a control that lets you adjust the
  264. relative strengths of red, green, and blue in your image. As with
  265. _Brightness/Contrast, you can use Reset if you change your mind later.
  266.  
  267. _Color _Negative: This creates a "negative" of your image; for example,
  268. black pixels will become white. Of course, if you do this twice, you'll
  269. have your original image again.
  270.  
  271. _View: These commands change how you see the image, but don't actually
  272. change the image itself.
  273.  
  274. _View _Zoom: This opens a secondary menu that lets you zoom in or out
  275. on your image or jump directly to certain zoom factors. For instance,
  276. to zoom in so that your image is twice normal size, type ^2. In
  277. general, the Control key zooms you in, and the Alt key zooms you out.
  278.  
  279. _View _Full Screen: Choosing this command (or pressing F3) erases your
  280. WHOLE screen (and not just the PMView window) and draws the image on
  281. it. F3 acts like a toggle; pressing it again redraws the screen and
  282. puts the image "back" in the PMView window.
  283.  
  284. (Why would you want to do this? If you have an image that's as large as
  285. the whole screen, you won't be able to see it while you have PMView's
  286. window border, menu bar, title bar, etc. on the screen. For instance,
  287. if you installed the optional bitmaps with OS/2, try loading
  288. OS2LOGO.BMP. You won't be able to see the whole image because it's too
  289. big. Now press F3. The whole image will be visible. Press F3 again to
  290. go back to having the image in the PMView window.)
  291.  
  292. PMView's options notebook has a _Fullscreen page that has three
  293. settings to handle centering or scaling the image when you press F3.
  294. See below under _View _Options for more information.
  295.  
  296. _View Fit _Image: Choosing this command (or pressing F4) will shrink or
  297. grow the window so that you can see the whole image and nothing but.
  298. Unless:
  299.    1) The image is too big (in which case you should try F3 instead), OR
  300.    2) The image isn't wide enough (PM will NOT let the window become
  301.      too narrow for the menu bar), OR
  302.    3) You have "Never" selected as your option in "Automatically Adjust
  303.       Window Position" (on the _Window page of PMView's options notebook)
  304.       and the only way to show the whole image would be to move the
  305.       window. (This might happen if your window is positioned too close to
  306.       the right or bottom edge of the screen.) In this case, you can change
  307.       the option to "When required"; see the _View S_ettings documentation
  308.       below.
  309.  
  310. _View _Refresh: Choosing this (or pressing F5) will redraw the image in
  311. the window. You may want to do this if (for whatever reason) the image
  312. gets corrupted. Unfortunately, as of this writing, there is a bug in
  313. *all* the available 256-color screen drivers that support Palette
  314. Manager. (This is not a bug in PMView.) When you drop down a menu and
  315. then get rid of it, the area that was under the menu is drawn with the
  316. wrong colors. To redraw the image with the correct colors, hit F5.
  317.  
  318. _View _Options: This opens a notebook that lets you control PMView's
  319. many options. Taking one page at a time:
  320.  
  321.    _View:
  322.  
  323. -- _Center image if it is smaller than window: If set, PMView will draw
  324. an image that's smaller than its window in the center of the window. If
  325. not set, PMView will draw the image in the upper left corner.
  326.  
  327. -- Zoom image to _fit window: If set, then whenever you load an image
  328. or resize PMView's window, PMView will zoom the image so that it fits
  329. perfectly either horizontally or vertically in the window. Otherwise,
  330. the image will always be drawn at "actual size" until you use a Zoom
  331. command. All zooming in PMView is proportional; circles will *always*
  332. stay circles.
  333.  
  334.    _Fullscreen:
  335.  
  336. -- _Center image if it is smaller than screen: If set, PMView will
  337. center the image when drawing in Full Screen Mode. Othewise, the image
  338. will be drawn in the upper left corner of the screen.
  339.  
  340. -- Zoom image if it is _larger than screen: If set, PMView will zoom
  341. out so that your image will fit onscreen, if necessary. As mentioned
  342. above, zooming is done proportionally.
  343.  
  344. -- Zoom image if it is _smaller than screen: If set, PMView will zoom
  345. in so that your image will reach completely across the screen either
  346. vertically or horizontally. Again, zooming is proportional.
  347.  
  348. -- _Hide mouse pointer: If set, PMView will initially hide the mouse
  349. pointer when you enter Fullscreen mode. See below under "Special Keys
  350. in PMView" for more information on turning the mouse pointer off and
  351. on.
  352.  
  353. As is noted on the page, two other options that modify Full Screen mode
  354. can be found elsewhere.
  355.  
  356.    _Window:
  357.  
  358. Automatically adjust window size and position:
  359.  
  360. -- When _loading a new image: If set, PMView will automatically adjust
  361. the window's size and position to display newly-loaded images at actual
  362. size. 
  363.  
  364. -- When _editing or zooming: If set, PMView will adjust the window's
  365. size and position if it's appropriate during an edit or zoom operation.
  366. For instance, if you take a tall, narrow image and rotate it, it will
  367. become a short, wide image. If this option is set, PMView's window will
  368. resize (and possibly move) accordingly. Otherwise, you might get a
  369. horizontal scroll bar and some blank space in your window.
  370.  
  371. Automatically adjust window position:
  372.  
  373. o _Never
  374. o When _required
  375. o _Always move to upper left corner
  376.  
  377. If you pick the first option, the upper left corner of PMView's window
  378. will never budge. If you pick the second option, PMView will leave the
  379. upper left corner in place *unless* moving it a short distance will let
  380. you see your whole image. Then it will move. Finally, "Always move to
  381. upper left corner" means that your window will move to the upper left
  382. corner of your screen every time you hit F4 (or load a new image, if
  383. the first option on this page is checked).
  384.  
  385. _Loading:
  386.  
  387. Loading/Startup options:
  388. o Startup _minimized (iconized)
  389. o N_ormal
  390. o _Fullscreen each loaded image automatically
  391.  
  392. If you pick the first option, PMView will start up minimized when you
  393. *first* load it. The second option will make it start up with the size
  394. of the image you specify on the command line (or the size it was when
  395. it last closed). (To make it do this *every* time it loads an image,
  396. select "When loading a new image" on the window page.) The last option
  397. will make PMView go into Full Screen mode *every* time it loads an
  398. image.
  399.  
  400. (Why would you want to start up PMView iconified? Suppose you have
  401. associations set in OS/2 so that whenever you double-click on the name
  402. of a GIF file, it starts up PMView automatically. It's quite convenient
  403. to be able to double-click on *several* GIF files and have each one
  404. appear as an icon at the bottom of your screen, so you can pick which
  405. ones to look at *after* they're done loading. One of our beta testers
  406. wanted this feature, so here it is. He also said he'd register if we
  407. added this feature, so I'm waiting for his check to arrive ;-)
  408.  
  409. Progress indicator options:
  410. o _Never show progress indicator
  411. o _Hide when PMView is started with a filename
  412. o _Always show progress indicator
  413.  
  414. These options decide the visibility of the progress indicator, that
  415. sliding bar that some people love and some people hate. Select the
  416. first option if you hate seeing it, select the last if you like seeing
  417. it. If you select the second option, PMView will display the progress
  418. indicator *except* when you first start up with a filename on the
  419. command line.
  420.  
  421. _Slideshow:
  422.  
  423. Here's where you set the options for a slideshow. To run a slideshow,
  424. select several files while doing _File _Open. Then use SPACEBAR to move
  425. forward an image or ESC to end the slideshow.
  426.  
  427. o Manual
  428. o Automatic
  429. If you select manual, you must always move to the next image manually.
  430. If  you select automatic, you also have the option of waiting for the 
  431. next slide to be loaded automatically.
  432.  
  433. Delay between images
  434. Here, you specify how many seconds PMView spends before automatically
  435. moving to the next image. In order to work around a bug, we set the
  436. minimum delay to 5 seconds. This "lower limit" will almost certainly be
  437. removed in 0.86.
  438.  
  439. -- _Cycle slideshow: If this option is set, the slideshow will go back
  440. and load the first image after it finishes with the last one.
  441. Otherwise, you'll get a message box at the end of the slideshow.
  442.  
  443. _Directory:
  444.  
  445. On this page you can type the paths for the default load directory
  446. (where PMView will initially go the first time you do a _File _Open)
  447. and the default save directory (where PMView will save files by
  448. default). File saves are *not* enabled in the unregistered version of
  449. PMView.
  450.  
  451. _Extensions:
  452.  
  453. This page is allows you to change the ordering, lettering, or comments
  454. on the extensions that PMView loads. For instance, if you're running
  455. HPFS and use the extension .JPEG for your JPEG files, you can type
  456. "JPEG" in the Extension field, type "My JPEGs" in the description
  457. field, and click "Ok >>". Then whenever you do a _File _Open, PMView
  458. will *also* display files with the extension of *.JPEG. What's more "My
  459. JPEGs" will appear in the Type of File list. *And* if you enter PMVIEW
  460. filename at an OS/2 prompt, PMView will be able to add the .JPEG
  461. extension automatically. Way to go, Peter!
  462.  
  463. _Palette:
  464.  
  465. -- Use _palette manager: If on, PMView will use the palette manager to
  466. display images. (Of course, if you don't have palette manager support,
  467. this option won't be available.)
  468.  
  469. -- _Smooth palette change in adjustment dialogs: If on, PMView will use
  470. palette animation to show brightness/contrast/saturation or color
  471. adjustment changes *in real time*. Pretty nifty!
  472.  
  473. -- _Override system colors in Full Screen mode: If on, PMView will use
  474. all 256 colors in Full Screen mode, rather than letting OS/2 reserve 20
  475. for the user interface. Of course, if you chose this option and then
  476. type ^O, you may not be able to read the resulting dialog box....
  477.  
  478. Spe_cial:
  479.  
  480. -- Use PMView's _own scaling routines: If on, PMView will use its own
  481. scaling routines rather than using the ones built into the screen
  482. driver. (As of this writing, I know of four platforms that support
  483. palette manager, and *three* of them don't scale correctly. All four of
  484. them are reputed to work fine in the GA version of OS/2 2.1, though.)
  485. Even if you have a platform that scales correctly, you may want to try
  486. this option because it may be *faster* this way. Of course, it will
  487. take up more memory.
  488.  
  489. -- Use _idle time loading and saving: If on, PMView will use the lowest
  490. priority in OS/2 when it loads and saves files. This can be a problem
  491. if you're running a "greedy" OS/2 or DOS program that "eats" lots of
  492. CPU; idle-time threads *never* have their priority boosted and can thus
  493. get "stuck". On the other hand, if you turn this option off, PMView
  494. will use ordinary priority, which may degrade your multitasking
  495. performance while it's running.
  496.  
  497. Whew! We're done with the options notebook! If you think it took a
  498. long time to read all that, just imagine how long it took me to *write*
  499. it ;-). On to the last menu, which is _Help.
  500.  
  501. _Help _Image: This gives you various statistics about your current
  502. image: The name and size of the file it was taken from (0 if it came
  503. from the clipboard), that file's image format, the size of the image in
  504. pixels, how much RAM the image is currently taking up in your system
  505. (this is usually the height times the width [rounded up to the nearest
  506. multiple of four] times your screen's color depth), the file's "color
  507. space," and how many colors are in the image. If you load a JPEG or
  508. TARGA file, the latter will be slowly counted by a background thread.
  509. In this case, you can close this dialog, carry out other operations,
  510. and check back later for the actual color count.
  511.  
  512. _Help _System: This gives information on your system's current status:
  513. what version of OS/2 PM you're running, how wide and tall your screen
  514. is (in pixels), whether your screen driver supports Palette Manager,
  515. how many colors you have, how many physical colors you have (what's the
  516. difference? Beats me) and how much physical RAM you have.
  517.  
  518. _Help _About: Finally, this displays product information about PMView,
  519. as well as information about how to register the program. If you like
  520. PMView, please support shareware by registering it. Registered versions
  521. of PMView will include working _File _Save (and _File Save _As)
  522. commands, a niftier icon, and probably some other extras as well.
  523.  
  524. SPECIAL KEYS IN PMVIEW
  525. ======================
  526. In addition to the menu commands given above, we have a few special
  527. keys in PMView.
  528.  
  529. While you are in Fullscreen mode, you can turn the mouse pointer off
  530. and on by typing ^M. This will only work while you're in Fullscreen
  531. mode, and only while PMView has the focus.
  532.  
  533. If you have scrollbars visible, you can scroll around via the keyboard.
  534. The up, down, right, and left arrows move 8 pixels in the direction
  535. you'd expect. Alt and an arrow moves 1 pixel. Ctrl and an arrow moves a
  536. screenful. Thus, if your PMView window is 200 pixels tall and you type
  537. ^Up, your viewport will move 200 pixels up.
  538.  
  539. In addition to the arrow keys, PgUp and PgDn are "synonyms" for ^Up and
  540. ^Dn respectively. ^PgUp and ^PgDn move all the way up and down.
  541. Finally, Home moves your viewport all the way to the left, and End
  542. moves it all the way to the right. (To move one screenful left or
  543. right, use ^Left or ^Right.)
  544.  
  545. The scrolling keys may sound confusing, but they're really what you'd
  546. expect. If you want to keep it simple, just stick to the arrows, and
  547. remember that Alt moves a smaller amount and Ctrl moves a larger amount
  548. (just like Alt zooms to make a smaller image, and Ctrl zooms to make a
  549. larger image).
  550.             *    *    *
  551.  
  552. If you've made it this far, congratulations. Here's a cute trick for
  553. you to try: Make OS/2 minimize to the desktop (by opening OS/2
  554. System->System Setup->System and selecting "Minimize _window to
  555. desktop" on the _Window page of the notebook). Now, load a colorful
  556. image and then minimize PMView. Pretty neat, huh? Thanks to Steve Ryner
  557. (the Official Artist [tm] of PMView) for discovering this trick.
  558.  
  559. ACKNOWLEDGEMENTS
  560. ================
  561. The Graphics Interchange Format (c) is the Copyright property of
  562. CompuServe Incorporated. GIF (sm) is a Service Mark property of
  563. CompuServe Incorporated.
  564.  
  565. This software is based in part on the work of the Independent JPEG
  566. Group.
  567.  
  568. APPENDIX 1: HOW TO CONTACT US
  569. ==============================
  570. Both Peter and I would love to hear from you. If you have any comments,
  571. suggestions, or wishes for new PMView features, please write to us.
  572.  
  573. Peter can be reached on the Internet at pnielsen@finabo.abo.fi or
  574. pnielsen@aton.abo.fi.
  575.  
  576. Alternatively, you can send Peter a paper letter at Gertrudsgatan 22 D
  577. 73, SF-20520, Turku, Finland. (Take into account the delays of
  578. international mail when you do this!)
  579.  
  580. You can reach me, Raja Thiagarajan, on the Internet at
  581. sthiagar@nickel.ucs.indiana.edu. Generally speaking, I read my Internet
  582. mail almost every day (except for holidays!).
  583.  
  584. If you prefer to support the U.S. Post Office, you can send me paper
  585. mail at 4423 East Trailridge Road, Bloomington, IN 47408-9633. However,
  586. I recommend that you save a tree (and some time) by sending me e-mail
  587. instead.
  588.  
  589. APPENDIX 2: WHERE TO GET NEW VERSIONS OF PMVIEW
  590. ===============================================
  591. When a new version of PMView comes out, the first thing we will do is
  592. send it to registered users. If you give us an e-mail address when you
  593. register, we will e-mail the new PMView to you immediately.
  594.  
  595. After we have finished sending copies to registered users, we will post
  596. a copy to Hobbes on the Internet. This is the world's best ftp site for
  597. finding OS/2 software. Its official designation is cdrom.com.
  598. PMView will be put in the /pub/uploads directory initially; after a
  599. while, it will be moved to the /pub/os2/2.x/graphics directory.
  600.  
  601. After we have posted a copy to Hobbes, we will post a copy to
  602. CompuServe. [*********WHERE!?!?!?!?!?*********] So, to find the latest
  603. version of PMView, look on Hobbes and CompuServe.
  604.  
  605. NOTE: The above appendix refers to new release versions of PMView. New
  606. beta versions are sent to people on our beta list (with registered
  607. users getting them first, if it's necessary to do it in more than one
  608. batch ;-) and may not end up on Hobbes. If you *really* want to get all
  609. the new beta versions of PMView, send us a bug report (or a short note
  610. saying you want to join the beta program) and an e-mail address at
  611. which you can accept big, uuencoded mail messages from the Internet. We
  612. reserve the right to limit the number of beta testers.
  613.  
  614. APPENDIX 3: TECHNICAL SPECIFICATIONS
  615. ====================================
  616. Architecture: 32 bit, 4 threads
  617. Internal image format: 8 and 24 bit
  618. Transformations: All formats
  619. Palette Manager support: Yes, 256 colors (if your display driver
  620.                              supports Palette Manager)
  621. True Color support: Yes, 24 bit, 16.7 million colors or less (if your
  622.                              display driver supports True Color)
  623.  
  624. Image formats that can be read and written
  625. ------------------------------------------
  626. GIF: Full support: 87a, Basic support: 89a
  627.  
  628. BMP (OS/2 1.x): Full support: 1, 4, 8 and 24-bit bitmaps or bitmaparrays.
  629. BMP (OS/2 2.x): Full support: 1, 4, 8 and 24-bit bitmaps or bitmaparrays.
  630.                               HUFFMAN1D, RLE_4, RLE_8 and RLE_24 compressions
  631.                               supported.
  632. BMP (Windows 3.0): Full support: 1, 4, 8 and 24-bit bitmaps.
  633.                    RLE_4 and RLE_8 compressions.
  634.  
  635. JFIF: Support in accordance with the Independent JPEG Group's revision 4.0.
  636.  
  637. PCX: Full support
  638.  
  639. TARGA: PMView supports Targa formats 1, 2, 3, 9, 10, and 11.
  640. #1 is uncompressed, color-mapped images with 16, 24, or 32-bit palette entries
  641. #2 is uncompressed RGB images with 15, 16, and 24 bit support
  642. #3 is uncompressed grayscale (256 shades) support
  643. #9 is RLE color-mapped images with 16, 24, or 32-bit palette entries
  644. #10 is RLE RGB with 15, 16, and 24 bit support
  645. #11 is compressed grayscale (256 shades) support
  646. These are the most popular Targa formats. We've succeeded in loading
  647. every Targa file that we've found. If PMView fails to load a Targa file
  648. that you need, please contact us so we can figure out how to support
  649. your file's format in our next release.
  650.  
  651. APPENDIX 4: DEVELOPMENT SYSTEM
  652. ==============================
  653. If you're curious, Peter Nielsen is developing PMView on the following
  654. system:
  655.  
  656.         IBM PS/2 model 95       486/50MHz
  657.                                 64 Mb RAM
  658.                                 2400 Mb hardfile
  659.                                 XGA-2 + 21" multisync
  660.         IBM OS/2 2.0 GA + SP
  661.  
  662. He's using the following tools:
  663.         IBM C-SET/2
  664.         IBM OS/2 developers toolkit + IBM Workframe/2
  665.         Microsoft MASM 6.0
  666.         Solution System's BRIEF 3.0 for OS/2
  667.  
  668. Th-th-that's all, folks!
  669.  
  670. Raja Thiagarajan / PMVIEW.DOC / 6-21-93 release
  671.