home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / rexx / library2 / gbmrexx / gbmv2 / gbmv2.scr < prev    next >
Text File  |  1993-11-10  |  30KB  |  662 lines
  1. .*
  2. .* GBMV2.SCR - Help for GbmV2
  3. .*
  4. .* Important: Only edit the original .SCR file.
  5. .* If this file is not by the filename given above, then it has been put
  6. .* through IPFCPREP and so will be regenerated next MAKE.
  7. .*
  8. .imd gbmdlgrc.h
  9. .*...vgbmdlgrc\46\h:0:
  10. .imd gbmv2hlp.h
  11. .*...vgbmv2hlp\46\h:0:
  12. :userdoc.
  13. .*...sprolog:0:
  14. :prolog.
  15. :title.GbmV2 Help
  16. :author.Andy Key
  17. :eprolog.
  18. .*...e
  19. :toc.
  20. :body.
  21. .*...sHID_INTRO         \45\ Introduction to GbmV2:0:
  22. :h1 res=&HID_INTRO..Introduction to GbmV2
  23. :i1.Introduction to GbmV2
  24. :p.This is a simple bitmap viewer.
  25. :p.Bitmap files in various formats may be loaded into memory.
  26. This is the :hp2.actual bitmap data:ehp2..
  27. :p.The program displays a view of the bitmap in its window.
  28. This is called the :hp2.view bitmap:ehp2..
  29. The choice of how the view is made from the actual data may be changed
  30. from the
  31. :link reftype=hd res=&HID_VIEW..View menu:elink..
  32. :p.If the bitmap is smaller than the window, it is displayed centralised
  33. within the window.
  34. :p.If the bitmap is larger than the window, then scrollbars may be used to
  35. pick the visible part of the bitmap.
  36. :p.Once a bitmap is loaded, it may be printed to the default PM printer.
  37. :p.All, or a part of, the current bitmap can be selected, and then copied
  38. to the clipboard.
  39. :p.1bpp bitmaps are typically tricky to handle under OS/2 PM.
  40. :p.This program will display a 1bpp bitmap using the 2 colours in the
  41. bitmap files header, rather than the users current PM colour scheme.
  42. :p.While files are loading, saving, printing etc., this program prevents you
  43. from using its other functions.
  44. :p.From the menu bar you can use&colon.
  45. :dl compact tsize=7 break=all.
  46. :dt.:link reftype=hd res=&HID_FILE..File:elink.
  47. :dd.To transfer the text to and from disk
  48. :dt.:link reftype=hd res=&HID_EDIT..Edit:elink.
  49. :dd.To transfer some or all of the bitmap to the OS/2 clipboard
  50. :dt.:link reftype=hd res=&HID_BITMAP..Bitmap:elink.
  51. :dd.To perform simple operations on the bitmap
  52. :dt.:link reftype=hd res=&HID_VIEW..View:elink.
  53. :dd.To select how you see the current bitmap
  54. :dt.Help
  55. :dd.To display various types of help for using this utility.
  56. :edl.
  57. :p.You can display online help for GbmV2 by using the following methods.
  58. :ul compact.
  59. :li.For help about any pull-down option, highlight it and press F1.
  60. :li.For help about any displayed dialog box, select the Help pushbutton.
  61. :li.To see the Help Index, use the Help pull-down, or press F11.
  62. :li.To see the Help table of contents, display a help panel and use the
  63. Help Options pull-down (or press Ctrl+C).
  64. :eul.
  65. .*...e
  66. .*...sHID_FILE          \45\ File menu:0:
  67. :h1 res=&HID_FILE..File menu
  68. :i1 id=file.File menu
  69. :p.The File menu allows you to load a new bitmap, to save to a bitmap file,
  70. and to print.
  71. You can use&colon.
  72. :dl tsize=7 break=all.
  73. :dt.:link reftype=hd res=&HID_NEW..New:elink.
  74. :dd.To clear out the current bitmap.
  75. :dt.:link reftype=hd res=&HID_OPEN..Open:elink.
  76. :dd.To discard the current bitmap and read a new file from disk.
  77. The file to load is selected via the
  78. :link reftype=hd res=&HID_GBM_FILEDLG..Bitmap File dialog:elink..
  79. :dt.:link reftype=hd res=&HID_SAVE..Save:elink.
  80. :dd.To save the current bitmap to a file, under the current filename.
  81. The actual bitmap data, rather than the view what you see of it that is saved.
  82. :dt.:link reftype=hd res=&HID_SAVE_AS..Save as:elink.
  83. :dd.To save the current bitmap to a file with a filename you specify.
  84. The filename to save to is specified via the
  85. :link reftype=hd res=&HID_GBM_FILEDLG..Bitmap File dialog:elink..
  86. The actual bitmap data, rather than the view what you see of it that is saved.
  87. :edl.
  88. .*...e
  89. .*...sHID_NEW           \45\   New:0:
  90. :h2 res=&HID_NEW..New
  91. :i2 refid=file.New
  92. :p.Will clear any loaded bitmap from memory.
  93. :p.
  94. You can also begin a :hp2.New:ehp2. file by pressing
  95. :hp2.Ctrl+N:ehp2..
  96. .*...e
  97. .*...sHID_OPEN          \45\   Open:0:
  98. :h2 res=&HID_OPEN..Open
  99. :i2 refid=file.Open
  100. :p.Brings up a dialog box which allows you to specify the bitmap file to
  101. load.
  102. The file to load to is specified via the
  103. :link reftype=hd res=&HID_GBM_FILEDLG..Bitmap File dialog:elink..
  104. :p.You can also :hp2.Open:ehp2. a file by pressing
  105. :hp2.Ctrl+O:ehp2..
  106. .*...e
  107. .*...sHID_SAVE          \45\   Save:0:
  108. :h2 res=&HID_SAVE..Save
  109. :i2 refid=file.Save
  110. :p.Saves the currently loaded bitmap.
  111. :p.It is the actual bitmap data, not the view you see, that is actually
  112. saved. For example, the actual bitmap map can be 24 bit, but you may be looking
  113. at an (8 bit) error diffused version on the screen. 
  114. :p.If you wish to save under a new filename, use
  115. :link reftype=hd res=&HID_SAVE_AS..Save as:elink. instead.
  116. :p.You can also :hp2.Save:ehp2. to a file by pressing
  117. :hp2.Ctrl+S:ehp2..
  118. .*...e
  119. .*...sHID_SAVE_AS       \45\   Save As:0:
  120. :h2 res=&HID_SAVE_AS..Save As
  121. :i2 refid=file.Save As
  122. :p.Saves the currently loaded bitmap, but under a new filename.
  123. The filename to save to is specified via the
  124. :link reftype=hd res=&HID_GBM_FILEDLG..Bitmap File dialog:elink..
  125. :p.If you wish to save under the current name, use
  126. :link reftype=hd res=&HID_SAVE..Save:elink. instead.
  127. :p.It is the actual bitmap data, not the view you see, that is actually
  128. saved. For example, the actual bitmap can map be 24 bit, but you may be looking
  129. at an (8 bit) error diffused version on the screen. 
  130. :p.You can also :hp2.Save as:ehp2. to a named file by pressing
  131. :hp2.Ctrl+A:ehp2..
  132. .*...e
  133. .*...sHID_PRINT         \45\   Print:0:
  134. :h2 res=&HID_PRINT..Print
  135. :i2 refid=file.Print
  136. :p.Prints the currently loaded bitmap to the default PM printer.
  137. :p.It is the screen view of the bitmap, not the actual bitmap data itself,
  138. that is transferred to the printer.
  139. :p.Works best when the default PM printer is a PostScript printer, as they
  140. typically can simulate 26 gray-scale levels via halftoning.
  141. :p.
  142. You can also :hp2.Print:ehp2. by pressing :hp2.Ctrl+P:ehp2..
  143. .*...e
  144. .*...sHID_EDIT          \45\ Edit menu:0:
  145. :h1 res=&HID_EDIT..Edit menu
  146. :i1 id=edit.Edit menu
  147. :p.The Edit menu allows you to select a sub-rectangle of the bitmap and then
  148. copy it to the clipboard.
  149. :p.
  150. You can use&colon.
  151. :dl tsize=7 break=all.
  152. :dt.:link reftype=hd res=&HID_UNDO..Undo:elink.
  153. :dd.To undo the last operation performed on the bitmap.
  154. :dt.:link reftype=hd res=&HID_SELECT..Select:elink.
  155. :dd.To select a part of the current bitmap.
  156. :dt.:link reftype=hd res=&HID_SELECT_ALL..Select all:elink.
  157. :dd.To select all the current bitmap.
  158. :dt.:link reftype=hd res=&HID_DESELECT..Deselect:elink.
  159. :dd.To cancel the current selection.
  160. :dt.:link reftype=hd res=&HID_COPY..Copy:elink.
  161. :dd.This copies the current selection to the clipboard.
  162. :edl.
  163. .*...e
  164. .*...sHID_UNDO          \45\   Undo:0:
  165. :h2 res=&HID_UNDO..Undo
  166. :i2 refid=edit.Undo
  167. :p.The Undo operation undoes the last change to the bitmap.
  168. :p.It is only selectable after a change has been done to the bitmap,
  169. such as those provided under the
  170. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  171. :p.In low memory situations, it may be impossible to undo a
  172. previous operation.
  173. :p.Certain operations, such as
  174. :link reftype=hd res=&HID_NEW..New:elink.
  175. and
  176. :link reftype=hd res=&HID_OPEN..Open:elink.
  177. are not undoable.
  178. .*...e
  179. .*...sHID_SELECT        \45\   Select:0:
  180. :h2 res=&HID_SELECT..Select
  181. :i2 refid=edit.Select
  182. :p.After choosing this menu selection, the mouse pointer changes into a
  183. angle-bracket-L shape which you move to the bottom left of the region of the
  184. bitmap you wish to select, and then press the left mouse button.
  185. Then it changes to an angle-bracket-7 shape, which you then move to the top
  186. right of the region you wish to select, and then press the left mouse button.
  187. :p.This newly selected region becomes selected and is marked with a
  188. rectangle.
  189. :p.This is the region that can subsequently become copied to the clipboard
  190. using
  191. :link reftype=hd res=&HID_COPY..Copy:elink..
  192. :p.Alternatively, the whole bitmap can be selected using
  193. :link reftype=hd res=&HID_SELECT_ALL..Select all:elink..
  194. :p.The Esc key cancels the selection process.
  195. .*...e
  196. .*...sHID_SELECT_ALL    \45\   Select all:0:
  197. :h2 res=&HID_SELECT_ALL..Select all
  198. :i2 refid=edit.Select all
  199. :p.After choosing this menu selection, the whole current bitmap is selected.
  200. :p.This newly selected region becomes selected and is marked with a
  201. a rectangle.
  202. :p.This is the region that can subsequently become copied to the clipboard
  203. using
  204. :link reftype=hd res=&HID_COPY..Copy:elink..
  205. :p.Alternatively, just a part of the bitmap can be selected using
  206. :link reftype=hd res=&HID_SELECT..Select:elink..
  207. :p.You can also :hp2.Select all:ehp2. by pressing :hp2.Ctrl+/:ehp2..
  208. .*...e
  209. .*...sHID_DESELECT      \45\   Deselect:0:
  210. :h2 res=&HID_DESELECT..Deselect
  211. :i2 refid=edit.Deselect
  212. :p.This menu item removes the current selection.
  213. :p.
  214. You can also :hp2.Deselect:ehp2. by pressing :hp2.Esc:ehp2., or
  215. by clicking the right mouse button on the bitmap.
  216. .*...e
  217. .*...sHID_COPY          \45\   Copy:0:
  218. :h2 res=&HID_COPY..Copy
  219. :i2 refid=edit.Copy
  220. :p.This can only occur if there is a selected region.
  221. :p.This menu item copies the current selected region to the clipboard.
  222. :p.A region can be selected using
  223. :link reftype=hd res=&HID_SELECT..Select:elink. or
  224. :link reftype=hd res=&HID_SELECT_ALL..Select all:elink..
  225. :p.It is the version you see on the screen that is copied to the clipboard,
  226. not the actual original bitmap data itself.
  227. :p.You can also :hp2.Copy:ehp2. by pressing
  228. :hp2.Ctrl+Ins:ehp2..
  229. .*...e
  230. .*...sHID_BITMAP        \45\ Bitmap menu:0:
  231. :h1 res=&HID_BITMAP..Bitmap menu
  232. :i1 id=bmp.Bitmap menu
  233. :p.The Bitmap menu allows you to perform simple operations on the
  234. current bitmap.
  235. :p.You can use&colon.
  236. :dl tsize=7 break=all.
  237. :dt.:link reftype=hd res=&HID_REF_HORZ..Reflect horizontally:elink.
  238. :dd.To reflect the bitmap left-to-right.
  239. :dt.:link reftype=hd res=&HID_REF_VERT..Reflect vertically:elink.
  240. :dd.To reflect the bitmap left-to-right.
  241. :dt.:link reftype=hd res=&HID_ROT_90..Rotate 90 degrees:elink.
  242. :dd.To rotate the bitmap 90 degrees anticlockwise.
  243. :dt.:link reftype=hd res=&HID_ROT_180..Rotate 180 degrees:elink.
  244. :dd.To rotate the bitmap 180 degrees.
  245. :dt.:link reftype=hd res=&HID_ROT_270..Rotate 270 degrees:elink.
  246. :dd.To rotate the bitmap 90 degrees clockwise.
  247. :dt.:link reftype=hd res=&HID_TRANSPOSE..Transpose x for y:elink.
  248. :dd.To transpose the bitmap x for y.
  249. :dt.:link reftype=hd res=&HID_CROP..Crop to selection:elink.
  250. :dd.To discard all but the selected part of the bitmap.
  251. :dt.:link reftype=hd res=&HID_COLOUR..Colour space...:elink.
  252. :dd.To map bitmap pixels / palettes between colour spaces.
  253. :dt.:link reftype=hd res=&HID_MAP..Map...:elink.
  254. :dd.To map between various numbers of bits per pixel and between
  255. various palettes.
  256. :edl.
  257. :p.The
  258. :link reftype=hd res=&HID_UNDO..Undo:elink.
  259. menuitem can be used to undo the last operation performed on
  260. a bitmap.
  261. .*...e
  262. .*...sHID_REF_HORZ      \45\   Reflect horizontally:0:
  263. :h2 res=&HID_REF_HORZ..Reflect horizontally
  264. :i2 refid=bmp.Reflect horizontally
  265. :p.This reflects the whole bitmap left-to-right.
  266. :p.Reflecting vertically can be done using the similar
  267. :link reftype=hd res=&HID_REF_VERT..Reflect vertically:elink.
  268. selection.
  269. :p.Other operations on the bitmap can be accessed from the
  270. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  271. .*...e
  272. .*...sHID_REF_VERT      \45\   Reflect vertically:0:
  273. :h2 res=&HID_REF_VERT..Reflect vertically
  274. :i2 refid=bmp.Reflect vertically
  275. :p.This reflects the whole bitmap top-to-bottom.
  276. :p.Reflecting horizontally can be done using the similar
  277. :link reftype=hd res=&HID_REF_HORZ..Reflect horizontally:elink.
  278. selection.
  279. :p.Other operations on the bitmap can be accessed from the
  280. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  281. .*...e
  282. .*...sHID_ROT_90        \45\   Rotate 90 degrees:0:
  283. :h2 res=&HID_ROT_90..Rotate 90 degrees
  284. :i2 refid=bmp.Rotate 90 degrees
  285. :p.This rotates the bitmap through 90 degrees clockwise.
  286. :p.Other rotations may be acheived via the
  287. :link reftype=hd res=&HID_ROT_180..Rotate 180 degrees:elink. and
  288. :link reftype=hd res=&HID_ROT_270..Rotate 270 degrees:elink. commands.
  289. :p.Other operations on the bitmap can be accessed from the
  290. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  291. .*...e
  292. .*...sHID_ROT_180       \45\   Rotate 180 degrees:0:
  293. :h2 res=&HID_ROT_180..Rotate 180 degrees
  294. :i2 refid=bmp.Rotate 180 degrees
  295. :p.This rotates the bitmap through 180 degrees clockwise.
  296. :p.Other rotations may be acheived via the
  297. :link reftype=hd res=&HID_ROT_90..Rotate 90 degrees:elink. and
  298. :link reftype=hd res=&HID_ROT_270..Rotate 270 degrees:elink. commands.
  299. :p.Other operations on the bitmap can be accessed from the
  300. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  301. .*...e
  302. .*...sHID_ROT_270       \45\   Rotate 270 degrees:0:
  303. :h2 res=&HID_ROT_270..Rotate 270 degrees
  304. :i2 refid=bmp.Rotate 270 degrees
  305. :p.This rotates the bitmap through 270 degrees clockwise.
  306. :p.Other rotations may be acheived via the
  307. :link reftype=hd res=&HID_ROT_90..Rotate 90 degrees:elink. and
  308. :link reftype=hd res=&HID_ROT_180..Rotate 180 degrees:elink. commands.
  309. :p.Other operations on the bitmap can be accessed from the
  310. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  311. .*...e
  312. .*...sHID_TRANSPOSE     \45\   Transpose x for y:0:
  313. :h2 res=&HID_TRANSPOSE..Transpose x for y
  314. :i2 refid=bmp.Transpose x for y
  315. :p.This reflects the bitmap through the line y=x.
  316. :p.Other operations on the bitmap can be accessed from the
  317. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  318. .*...e
  319. .*...sHID_CROP          \45\   Crop to selection:0:
  320. :h2 res=&HID_CROP..Crop to selection
  321. :i2 refid=bmp.Crop to selection
  322. :p.This discards all the bitmap except the selected bit.
  323. :p.Other operations on the bitmap can be accessed from the
  324. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  325. .*...e
  326. .*...sHID_COLOUR        \45\   Colour space\46\\46\\46\:0:
  327. :h2 res=&HID_COLOUR..Colour space...
  328. :i2 refid=bmp.Colour space...
  329. :p.This menuitem will cause the
  330. :link reftype=hd res=&HID_COLOUR_DLG..Colour space dialog:elink.
  331. to appear.
  332. From here mappings between :hp2.intensity:ehp2., :hp2.L* cyclometric:ehp2.
  333. and :hp2.gamma corrected:ehp2. colour spaces may be performed.
  334. :p.Other operations on the bitmap can be accessed from the
  335. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  336. .*...e
  337. .*...sHID_MAP           \45\   Map\46\\46\\46\:0:
  338. :h2 res=&HID_MAP..Map...
  339. :i2 refid=bmp.Map...
  340. :p.This menuitem will cause the
  341. :link reftype=hd res=&HID_MAP_DLG..Map dialog:elink.
  342. to appear.
  343. From here mappings between various numbers of bits per pixel and
  344. various palettes may be performed.
  345. :p.Other operations on the bitmap can be accessed from the
  346. :link reftype=hd res=&HID_BITMAP..Bitmap menu:elink..
  347. .*...e
  348. .*...sHID_VIEW          \45\ View menu:0:
  349. :h1 res=&HID_VIEW..View menu
  350. :i1 id=view.View menu
  351. :p.The View menu allows you to choose what representation (or view) of the
  352. bitmap you have loaded will be used for display on the screen.
  353. :p.
  354. You can use&colon.
  355. :dl tsize=7 break=all.
  356. :dt.:link reftype=hd res=&HID_VIEW_NULL..Raw PM mapping:elink.
  357. :dd.To tell this program to perform no image enhancment for display
  358. purposes. The view bitmap is displayed as good as PM will, with no improvement.
  359. :dt.:link reftype=hd res=&HID_VIEW_HALFTONE..Halftoned:elink.
  360. :dd.To tell this program to show a halftoned version of the bitmap to the
  361. user, rather than the actual bitmap data itself.
  362. This generally looks slightly better and is quick to do.
  363. :dt.:link reftype=hd res=&HID_VIEW_ERRDIFF..Error diffused:elink.
  364. :dd.To tell this program to show a error-diffused version of the bitmap to the
  365. user, rather than the actual bitmap data itself.
  366. This generally looks much better, but takes longer to do.
  367. :edl.
  368. :p.This program makes a guess at the type of display adaptor you are using
  369. and chooses the most appropriate form of halftoning or error-diffusion to
  370. use.
  371. Specifically, it has algorithms known to work well on &colon.-
  372. :sl.
  373. :li.16 colour VGA
  374. :li.256 colour 8514/A, XGA and Image Adaptor/A.
  375. :li.65536 direct colour XGA-2.
  376. :esl.
  377. :p.If you actually wish to change the bitmap data itself, then you can use the
  378. :link reftype=hd res=&HID_MAP_DLG..Map dialog:elink. to do this.
  379. .*...e
  380. .*...sHID_VIEW_NULL     \45\   Raw PM mapping:0:
  381. :h2 res=&HID_VIEW_NULL..Raw PM mapping
  382. :i2 refid=view.Raw PM mapping
  383. :p.This tells this program to not perform any image enhancement that will make
  384. a bitmap look closer to its true colours and shades on the screen.
  385. :p.You can also select view :hp2.Raw PM mapping:ehp2. by pressing
  386. :hp2.Ctrl+R:ehp2..
  387. :p.It is possible to select other views from the
  388. :link reftype=hd res=&HID_VIEW..View menu:elink..
  389. .*...e
  390. .*...sHID_VIEW_HALFTONE \45\   Halftoned:0:
  391. :h2 res=&HID_VIEW_HALFTONE..Halftoned
  392. :i2 refid=view.Halftoned
  393. :p.This tells this program that it should present a halftoned view
  394. of the current bitmap to the user.
  395. :p.The actual bitmap data itself is not affected, only what you see on the
  396. screen.
  397. :p.Hence if
  398. :link reftype=hd res=&HID_SAVE..Save:elink. or
  399. :link reftype=hd res=&HID_SAVE_AS..Save as:elink.
  400. are used, the unchanged actual bitmap data is saved.
  401. :p.Halftoning is generally quicker than error diffusion.
  402. :p.You can also select view :hp2.Halftoned:ehp2. by pressing
  403. :hp2.Ctrl+H:ehp2..
  404. :p.It is possible to select other views from the
  405. :link reftype=hd res=&HID_VIEW..View menu:elink..
  406. .*...e
  407. .*...sHID_VIEW_ERRDIFF  \45\   Error diffused:0:
  408. :h2 res=&HID_VIEW_ERRDIFF..Error diffused
  409. :i2 refid=view.Error diffused
  410. :p.This tells this program that it should present an error-diffused picture
  411. of the current bitmap to the user.
  412. :p.The actual bitmap data itself is not affected, only what you see on the
  413. screen.
  414. :p.Hence if
  415. :link reftype=hd res=&HID_SAVE..Save:elink. or
  416. :link reftype=hd res=&HID_SAVE_AS..Save as:elink.
  417. are used, the unchanged actual bitmap data is saved.
  418. :p.Error diffusion takes longer than halftoning, but the quality is
  419. generally higher, especially on continuous tone images.
  420. :p.You can also select view :hp2.Error diffused:ehp2. by pressing
  421. :hp2.Ctrl+E:ehp2..
  422. :p.It is possible to select other views from the
  423. :link reftype=hd res=&HID_VIEW..View menu:elink..
  424. .*...e
  425. .*...sHID_HELP          \45\ Help menu:0:
  426. :h1 res=&HID_HELP..Help menu
  427. :i1 id=help.Help menu
  428. :p.Use this menu to bring up the help system.
  429. .*...e
  430. .*...sHID_HELP_FOR_HELP \45\   Help for help:0:
  431. :h2 res=&HID_HELP_FOR_HELP..Help for help
  432. :i2 refid=help.Help for help
  433. :p.Use this choice to bring up the help for the help system.
  434. .*...e
  435. .*...sHID_HELPEXTENDED  \45\   Extended Help:0:
  436. :h2 res=&HID_HELPEXTENDED..Extended Help
  437. :i2 refid=help.Extended Help
  438. :p.Use this choice to bring up general help for GbmV2.
  439. .*...e
  440. .*...sHID_HELPKEYS      \45\   Keys help:0:
  441. :h2 res=&HID_HELPKEYS..Keys help
  442. :i2 refid=help. Keys Help
  443. :p.The following keys may be used in the main window &colon.-
  444. :ul.
  445. :li.:hp2.Ctrl+N:ehp2. selects
  446. :link reftype=hd res=&HID_NEW..New:elink. which clears the bitmap.
  447. :li.:hp2.Ctrl+O:ehp2. to
  448. :link reftype=hd res=&HID_OPEN..Open:elink. a new bitmap file via the
  449. :link reftype=hd res=&HID_GBM_FILEDLG..Bitmap File dialog:elink..
  450. :li.:hp2.Ctrl+S:ehp2. to
  451. :link reftype=hd res=&HID_SAVE..Save:elink. the current bitmap.
  452. :li.:hp2.Ctrl+A:ehp2. selects
  453. :link reftype=hd res=&HID_SAVE_AS..Save as:elink. which saves the bitmap
  454. under a new filename, specified via the
  455. :link reftype=hd res=&HID_GBM_FILEDLG..Bitmap File dialog:elink..
  456. :li.:hp2.Ctrl+P:ehp2. to
  457. :link reftype=hd res=&HID_PRINT..Print:elink. the current bitmap.
  458. :li.:hp2.Ctrl+R:ehp2. to select
  459. :link reftype=hd res=&HID_VIEW_NULL..Raw PM mapping:elink. view mode.
  460. :li.:hp2.Ctrl+H:ehp2. to select
  461. :link reftype=hd res=&HID_VIEW_HALFTONE..Halftoned:elink. view mode.
  462. :li.:hp2.Ctrl+E:ehp2. to select
  463. :link reftype=hd res=&HID_VIEW_ERRDIFF..Error diffused:elink. view mode.
  464. :li.:hp2.Ctrl+/:ehp2. to
  465. :link reftype=hd res=&HID_SELECT_ALL..Select all:elink. all of
  466. the current bitmap.
  467. :li.:hp2.Ctrl+\:ehp2. to
  468. :link reftype=hd res=&HID_DESELECT..Deselect:elink. any current selection.
  469. :li.:hp2.Esc:ehp2. to
  470. :link reftype=hd res=&HID_DESELECT..Deselect:elink. any current selection.
  471. :li.:hp2.Ctrl+Ins:ehp2. to
  472. :link reftype=hd res=&HID_COPY..Copy:elink. the current selection
  473. to the clipboard.
  474. :li.The :hp2.Arrow:ehp2. keys may be used to scroll around the bitmap.
  475. Note that :hp2.Shift+Arrows:ehp2. behave like page up/down/left or right.
  476. :li.:hp2.F3:ehp2. to close GbmV2.
  477. :eul.
  478. .*...e
  479. .*...sHID_HELPINDEX     \45\   Help index:0:
  480. :h2 res=&HID_HELPINDEX..Help index
  481. :i2 refid=help.Help index
  482. :p.Use this to bring up an index of the help.
  483. .*...e
  484. .*...sHID_COLOUR_DLG    \45\ Colour space dialog:0:
  485. :h1 res=&HID_COLOUR_DLG..Colour space dialog
  486. :i1 id=cspace.Colour space dialog
  487. :p.If a light is physically twice as bright, the eye does not
  488. necessarily see it as twice as bright. Also, if a pixel is
  489. written onto a monitor screen with twice the value, the physical
  490. intensity of the pixel is not necessarily double.
  491. :p.How exactly should numbers inside a bitmap file relate to
  492. physical or perceived intensitys when displayed on the screen?
  493. :p.In OS/2 PM perceived intensitys are proportional to the values
  494. in the bitmap file.
  495. Pixels in such a bitmap are in the :hp2.L* cyclometric:ehp2. colour space.
  496. This is done to ensure that an even scale of pixel values gives an even
  497. scale of brightness, when viewed by the human eye.
  498. :p.Ray Tracers often write pixel values in the bitmap proportional to
  499. the physical intensity computed for that ray.
  500. Also this may be more suitable if certain image processing/enhancement
  501. techniques are to be applied to the image data.
  502. Such data is in the :hp2.intensity:ehp2. colour space.
  503. :p.Finally, if a bitmap holds values computed in such a way as to
  504. compensate for the gamma of the monitor (ie: intensitys transformed
  505. to cancel out the gamma of the monitor), then the data is in
  506. a :hp2.gamma corrected:ehp2. colour space.
  507. Bitmap data that has come directly from a greyscale or colour scanner may
  508. also be in a gamma corrected colour space.
  509. :p.Of course, despite OS/2 PM using the L* cyclometric colour space, this
  510. machine is attached to a monitor with specific characteristics and your eyes
  511. also have their own characteristics.
  512. But it is the responsibility of OS/2 PM screen drivers to perform the mapping
  513. from the L* cyclometric colour space to suitable palette entrys which take
  514. into account both the gamma (and shelf) of the monitor in use, and the
  515. visual characteristics of the human eye.
  516. This is done transparently to PM applications.
  517. :p.The various :hp2.mappings:ehp2. allow you map between any 2 of these
  518. 3 colour spaces. Examples of typical usage follow &colon.-
  519. :dl tsize=7 break=all.
  520. :dt.Intensity to L* cyclometric
  521. :dd.You have loaded a bitmap file where the pixel values are proportional
  522. to the physical intensity.
  523. Such bitmaps often tend to look too dark under OS/2 PM.
  524. This will map the pixels to the L* cyclometric colour space, giving a better
  525. rendition under OS/2 PM.
  526. :dt.Intensity to gamma corrected
  527. :dd.The resulting bitmap, may still look too dark/light under OS/2 PM, but
  528. when saved, and displayed on a monitor with the relevant
  529. :hp2.gamma:ehp2. and :hp2.shelf:ehp2. with a program that directly controls
  530. the hardware, the correct rendition will result.
  531. :dt.L* cyclometric to Intensity
  532. :dd.You have a regular OS/2 PM bitmap, and wish to make the pixel values in
  533. the file directly proportional to the physical intensity.
  534. You might do this to generate a bitmap suitable for feeding into a
  535. Ray Tracer as a 2D texture map.
  536. :dt.L* cyclometric to gamma corrected
  537. :dd.As above, but generating bitmap bits suitable for directly placing in
  538. hardware registers.
  539. :dt.Gamma corrected to Intensity
  540. :dd.You have loaded a bitmap that has come directly from some scanner
  541. hardware, and wish to make bitmap where bits are proportional to intensity.
  542. :dt.Gamma corrected to L* cyclometric
  543. :dd.You have loaded a bitmap from a scanner, and wish to make a bitmap
  544. best suited for OS/2 PM.
  545. :edl.
  546. :p.When mapping to or from the gamma corrected colour space, the
  547. :hp2.gamma:ehp2. and :hp2.shelf:ehp2. values are significant.
  548. When the gamma corrected colour space is not involved, the gamma and
  549. shelf parameters are greyed.
  550. For example, the gamma of the 8514 monitor is about 2.1.
  551. :p.The shelf parameter will normally be left 0.0, but has significance for
  552. some monitors.
  553. For example, on some 8514 monitors, if a greyscale of bitmap pixels 0 to 255
  554. is displayed, the first 35 values come out equally black. So, here a shelf
  555. of 0.136 (as 0.136*255=35) should be used.
  556. :p.Mapping of this sort should really be done on 24 bit data, before
  557. error-diffusion or halftoning takes place.
  558. :p.If the current bitmap is 24 bpp, then each bitmap pixel is mapped.
  559. Otherwise, the palette entrys are mapped.
  560. :p.This dialog is brought up from the
  561. :link reftype=hd res=&HID_COLOUR..Colour space...:elink. menuitem.
  562. .*...e
  563. .*...sHID_MAP_DLG       \45\ Map dialog:0:
  564. :h1 res=&HID_MAP_DLG..Map dialog
  565. :i1 id=map.Map dialog
  566. :p.When the :hp2.Convert:ehp2. pushbutton is pressed on this dialog,
  567. the current bitmap is expanded from however many bits per pixel it
  568. currently is to 24 bits per pixel (with no palette).
  569. :p.Then a mapping is performed, to the desired number of bits per pixel
  570. and palette specified.
  571. :p.For some mappings, some or all of the values in the :hp2.Values:ehp2.
  572. part of the dialog box are used.
  573. Those which have no effect are greyed.
  574. :p.Also, when mapping to some palettes, the option of using
  575. :hp2.halftoning:ehp2. or :hp2.error diffusion:ehp2. may be available.
  576. When these are unavailable, they are greyed.
  577. :dl tsize=7 break=all.
  578. :dt.1bpp, black and white
  579. :dd.The bitmap is mapped to black and white.
  580. This is done by mapping each pixel to a grey value, and then seeing
  581. if the brightness is in the high 50% or not.
  582. :dt.4bpp, 8 colours
  583. :dd.This maps each pixel to one of black, white, red, green, blue, cyan,
  584. magenta or yellow.
  585. This option is handy for generating bitmaps to be fed into colour printers.
  586. :dt.4bpp, 16 colour VGA palette
  587. :dd.Each pixel is mapped to a colour in the VGA palette used by DOS, Windows
  588. and OS/2 PM.
  589. :dt.4bpp, 16 shades of grey
  590. :dd.Each pixel is mapped to one of 16 shades of grey.
  591. :dt.8bpp, 7Rx8Gx4B palette (8514/A)
  592. :dd.This is a palette consisting of 7 levels of red, 8 levels of green and
  593. 4 levels of blue.
  594. It is constructed this way because the eye is most sensitive to green, then
  595. to red, and least to blue.
  596. Many OS/2 PM drivers (such as 16 bit 8514/A driver) use a palette with these
  597. colours in.
  598. Future OS/2 PM drivers (such as 32 bit drivers) should also use it to.
  599. :dt.8bpp, 6Rx6Gx6B palette (old XGA)
  600. :dd.An exception to the above is that the old 16 bit XGA-1 OS/2 PM driver
  601. used a 6 red by 6 green by 6 blue palette.
  602. The new 32 bit XGA-2 OS/2 PM driver uses the 7Rx8Gx4B palette.
  603. :dt.8bpp, 256 shades of grey
  604. :dd.Each pixel is mapped to a greyscale via a weighted sum of the red, green
  605. and blue components.
  606. Grey = 30% red + 59% green + 11% blue.
  607. These correspond to the eyes relative sensitivities to these primary colours.
  608. :dt.8bpp, 64R+64G+64B tri-pel palette
  609. :dd.The palette of the resulting bitmap has 64 shades of red, 64 of green
  610. and 64 of blue.
  611. Pixels in the source alternately have their red, green or blue component
  612. considered and a pixel written out from the relevant part of the palette.
  613. Therefore colour resolution is 6 bits of each of red, green and blue, at
  614. the expense of artifacts produced caused by the alternation and also at the
  615. expense of reducing the image brightness by a factor of 3.
  616. :dt.24 bpp, keep R bits red, G green, B blue
  617. :dd.Although the resulting image has 24bpp, only R bits of red, G of green
  618. and B of blue are non-zero.
  619. XGA-2 in its 16bpp mode has 65536 colours, which are composed from 32 levels
  620. of red, 64 of green and 32 of blue.
  621. Thus R=5, G=6, B=5 can be used to transform an image into what can be
  622. displayed on XGA-2.
  623. :dt.8bpp, as above, find N most used cols.
  624. :dd.After performing the above step, the 24bpp data is analysed to find the
  625. N most frequently occuring colours.
  626. Any pixels in the image in the N most used colours are mapped directly to
  627. that colour.
  628. Any pixel not in the N most used colours is mapped to the closest colour
  629. in the N most used.
  630. This may be used to make the best rendition for display by a DOS program
  631. that uses VGA 320x200 8bpp mode by setting R=6, G=6, B=6, N=256, since only
  632. 6 bits are significant in the VGA palette DACs, and we only have 256
  633. colours in the palette.
  634. :edl.
  635. :p.:hp9.Important:ehp9.
  636. :p.These mappings apply to the :hp2.actual bitmap data:ehp2. and are
  637. nothing to do with the viewing options available from the
  638. :link reftype=hd res=&HID_VIEW..View menu:elink..
  639. Therefore, if you load a bitmap, error diffuse via this dialog box,
  640. and then save, the saved file is error-diffused.
  641. This directly contrasts the View menu, where the error diffusion is
  642. purely for display purposes.
  643. :p.This dialog is brought up from the
  644. :link reftype=hd res=&HID_MAP..Map...:elink. menuitem.
  645. .*...e
  646. .*...sHID_CREDITS       \45\ Credits:0:
  647. :h1 res=&HID_CREDITS..Credits
  648. :i1 id=credits.Credits
  649. :p.This code is the work of &colon.-
  650. :xmp.
  651.  
  652. {{{ Andy Key
  653.  
  654. Internet: ak@vnet.ibm.com
  655. IBM-VNET: AKEY AT HVTVM5
  656.  
  657. :exmp.
  658. :p.Electronic addresses valid at least until 31st December 1993.
  659. .*...e
  660. :index.
  661. :euserdoc.
  662.