home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #26 / NN_1992_26.iso / spool / vmsnet / sources / 430 < prev    next >
Encoding:
Internet Message Format  |  1992-11-04  |  47.9 KB
  1. Path: sparky!uunet!news.univie.ac.at!chx400!ira.uka.de!yale.edu!yale!gumby!wupost!usc!news.service.uci.edu!unogate!mvb.saic.com!vmsnet-sources
  2. Newsgroups: vmsnet.sources
  3. From: dyson@iowasp.physics.uiowa.edu (Rick Dyson)
  4. Subject: xv-2-21a changes to run on VMS, part 04/08
  5. Date: Wed, 04 Nov 1992 21:12:39 GMT
  6. Message-ID: <8981990@MVB.SAIC.COM>
  7. Lines: 1114
  8. Organization: Department of Physics and Astronomy, University of Iowa
  9. Approved: Mark.Berryman@Mvb.Saic.Com
  10.  
  11. Submitted-by: dyson@iowasp.physics.uiowa.edu (Rick Dyson)
  12. Posting-number: Volume 3, Issue 236
  13. Archive-name: xv-2-21_vms_changes/part04
  14. Supersedes: xv-2-21_vms_changes: Volume 2, Issue 83-86
  15.  
  16. -+-+-+-+-+-+-+-+ START OF PART 4 -+-+-+-+-+-+-+-+
  17. Vo`20such`20a`20thing`20`20is`20`20that
  18. X`20`20`20`20`20`20`20`20using`20`20read/write`20color`20cells`20allows`20the
  19. V`20Apply`20function`20in`20the
  20. X`20`20`20`20`20`20`20`20xv`20color`20editor`20window`20to`20operate`20much`20f
  21. Vaster.
  22. X
  23. X`20`20`20`20`20`20`20`20-perfect`20`20(Resource`20name:`20perfect`20`20boolean
  24. V)
  25. X`20`20`20`20`20`20`20`20Makes`20XV`20`20try`20'extra`20hard'`20to`20get`20all
  26. V`20the`20colors`20it`20wants.`20`20In
  27. X`20`20`20`20`20`20`20`20particular,`20when`20-perfect`20`20is`20`20specified,
  28. V`20XV`20will`20allocate`20and
  29. X`20`20`20`20`20`20`20`20install`20its`20own`20colormap`20`20if`20`20(and`20
  30. V`20only`20`20if)`20it`20was`20unable`20to
  31. X`20`20`20`20`20`20`20`20allocate`20all`20the`20desired`20colors.`20`20`20`20Th
  32. Vis`20option`20is`20not`20allowed
  33. X`20`20`20`20`20`20`20`20in`20conjunction`20with`20the`20-root`20option.
  34. X
  35. X`20`20`20`20`20`20`20`20-owncmap`20`20(Resource`20name:`20ownCmap`20`20boolean
  36. V)
  37. X`20`20`20`20`20`20`20`20Like`20'-perfect',`20only`20this`20option`20forces`20X
  38. VV`20to`20always`20allocate
  39. X`20`20`20`20`20`20`20`20and`20`20install`20`20its`20`20own`20colormap,`20there
  40. Vby`20leaving`20`20the`20`20default
  41. X`20`20`20`20`20`20`20`20colormap`20untouched.
  42. X
  43. X`20`20`20`20`20`20`20`20-cecmap`20(Resource`20name:`20ceditColorMap`20boolean)
  44. V
  45. X`20`20`20`20`20`20`20`20Specifies`20whether`20xv`20installs`20the`20`20image's
  46. V`20`20colormap`20in`20the`20xv
  47. X`20`20`20`20`20`20`20`20color`20editor`20window,`20as`20well`20as`20`20in`20
  48. V`20the`20`20image's`20`20window.`20`20By
  49. X`20`20`20`20`20`20`20`20default,`20the`20program`20does`20install`20the`20colo
  50. Vrmap`20`20in`20`20the`20`20color
  51. X`20`20`20`20`20`20`20`20editor`20`20window,`20`20however`20this`20can`20occasi
  52. Vonally`20make`20the`20`20color
  53. X`20`20`20`20`20`20`20`20editor`20`20window`20unreadable.`20`20(This`20option
  54. V`20only`20apples`20when`20`20the
  55. X`20`20`20`20`20`20`20`20'-perfect'`20or`20'-owncmap'`20options`20create`20thei
  56. Vr`20own`20colormaps.)
  57. X
  58. X`20`20`20`20`20`20`20`20-ninstall`20`20(Resource`20name:`20ninstall`20`20boole
  59. Van)
  60. X`20`20`20`20`20`20`20`20Prevents`20`20XV`20`20from`20`20'installing'`20`20its
  61. V`20`20own`20colormap,`20when`20`20the
  62. X`20`20`20`20`20`20`20`20-perfect`20`20or`20`20-owncmap`20`20options`20`20are
  63. V`20`20in`20`20effect.`20`20Instead`20`20of
  64. X`20`20`20`20`20`20`20`20installing`20`20the`20`20colormap,`20`20it`20`20will
  65. V`20`20merely`20`20'ask`20`20the`20window
  66. X`20`20`20`20`20`20`20`20manager,`20nicely'`20`20to`20take`20care`20of`20it.
  67. V`20`20This`20is`20the`20correct`20way
  68. X`20`20`20`20`20`20`20`20to`20`20install`20`20a`20`20`20`20colormap`20`20(i.e.,
  69. V`20`20ask`20`20the`20`20WM`20`20to`20`20do`20`20it),
  70. X`20`20`20`20`20`20`20`20unfortunately,`20it`20doesn't`20actually`20seem`20to
  71. V`20work`20in`20many`20window
  72. X`20`20`20`20`20`20`20`20managers,`20`20so`20`20the`20`20default`20`20behavior
  73. V`20`20is`20`20for`20`20XV`20`20to`20`20handle
  74. X`20`20`20`20`20`20`20`20installation`20itself.`20`20However,`20this`20has`20be
  75. Ven`20seen`20to`20annoy`20one
  76. X`20`20`20`20`20`20`20`20window`20manager`20(dxwm),`20so`20this`20option`20is
  77. V`20`20provided`20`20if`20your`20WM
  78. X`20`20`20`20`20`20`20`20doesn't`20like`20programs`20installing`20their`20own
  79. V`20colormaps.
  80. X
  81. X3`2024-bit_Conversion_Options
  82. X`20`20`20`20`20`20`20`20The`20following`20options`20only`20come`20`20into`20pl
  83. Vay`20if`20you`20are`20using`20XV
  84. X`20`20`20`20to`20display`2024-bit`20RGB`20data`20(PPM`20files,`20color`20PM
  85. V`20files,`20JPEG`20files,
  86. X`20`20`20`20and`20the`20output`20of`20bggen).`20`20They`20`20have`20`20no`20ef
  87. Vfect`20whatsoever`20on`20how
  88. X`20`20`20`20GIF`20pictures`20or`208-bit`20greyscale`20images`20are`20displayed
  89. V.
  90. X
  91. X`20`20`20`20`20`20`20`20-quick24`20(Resource`20name:`20quick24`20boolean)
  92. X`20`20`20`20`20`20`20`20Forces`20`20xv`20`20to`20`20use`20`20the`20`20'quick'
  93. V`20`2024-bit`20`20to`208-bit`20conversion
  94. X`20`20`20`20`20`20`20`20algorithm.`20`20`20This`20`20algorithm`20dithers`20the
  95. V`20picture`20using`20a`20fixed
  96. X`20`20`20`20`20`20`20`20set`20of`20colors`20`20that`20`20span`20`20the`20`20en
  97. Vtire`20`20RGB`20`20colorspace.`20`20`20`20In
  98. X`20`20`20`20`20`20`20`20versions`20of`20xv`20prior`20`20to`202.10,`20this`20wa
  99. Vs`20the`20default`20algorithm.
  100. X`20`20`20`20`20`20`20`20It`20no`20longer`20is.
  101. X
  102. X`20`20`20`20`20`20`20`20-slow24`20`20(Resource`20name:`20slow24`20`20boolean)
  103. X`20`20`20`20`20`20`20`20Specifies`20that`20the`20'slow'`2024-bit`20to`208-bit
  104. V`20conversion`20algorithm
  105. X`20`20`20`20`20`20`20`20is`20to`20be`20used`20`20by`20`20the`20program.`20`20T
  106. Vhis`20algorithm`20uses`20a`20version
  107. X`20`20`20`20`20`20`20`20of`20Heckbert's`20median`20cut`20algorithm`20`20to`20
  108. V`20pick`20the`20'best'`20colors
  109. X`20`20`20`20`20`20`20`20on`20a`20per-image`20basis,`20and`20dithers`20`20with
  110. V`20`20those.`20`20`20`20This`20is`20the
  111. X`20`20`20`20`20`20`20`20current`20default`20conversion`20algorithm.
  112. X
  113. X`20`20`20`20`20`20`20`20Advantages:`20`20`20`20The`20`20-slow24`20`20algorithm
  114. V`20`20often`20produces`20`20better
  115. X`20`20`20`20`20`20`20`20looking`20pictures`20than`20the`20-quick24`20algorithm
  116. V.
  117. X
  118. X`20`20`20`20`20`20`20`20Disadvantages:`20`20The`20-slow24`20algorithm`20is`20a
  119. Vbout`20half`20`20the`20speed
  120. X`20`20`20`20`20`20`20`20of`20the`20-quick24`20algorithm.`20`20Also,`20since
  121. V`20the`20colors`20`20are`20chosen
  122. X`20`20`20`20`20`20`20`20on`20`20a`20`20per-image`20`20basis,`20it`20can't`20be
  123. V`20used`20to`20display`20`20multiple
  124. X`20`20`20`20`20`20`20`20images`20simultaneously,`20as`20`20each`20`20image`20
  125. V`20will`20`20almost`20certainly
  126. X`20`20`20`20`20`20`20`20want`20a`20different`20set`20`20of`20`20256`20colors.
  127. V`20`20The`20-quick24`20algorithm,
  128. X`20`20`20`20`20`20`20`20however,`20uses`20the`20same`20exact`20`20colors`20for
  129. V`20all`20images,`20so`20it`20can
  130. X`20`20`20`20`20`20`20`20display`20`20many`20`20images`20simultaneously,`20with
  131. Vout`20running`20`20out`20`20of
  132. X`20`20`20`20`20`20`20`20colors.
  133. X
  134. X`20`20`20`20`20`20`20`20-best24`20`20(Resource`20name:`20best24`20boolean)
  135. X`20`20`20`20`20`20`20`20Forces`20xv`20to`20use`20`20the`20`20same`20`20algorit
  136. Vhm`20`20used`20`20in`20`20the`20`20program
  137. X`20`20`20`20`20`20`20`20ppmquant,`20written`20by`20Jef`20Poskanzer.`20`20`20Th
  138. Vis`20algorithm`20also`20uses
  139. X`20`20`20`20`20`20`20`20a`20version`20of`20Heckbert's`20median`20cut`20`20algo
  140. Vrithm,`20`20but`20is`20capable
  141. X`20`20`20`20`20`20`20`20of`20picking`20'better'`20colors`20than`20the`20-slow2
  142. V4`20`20algorithm,`20and`20it
  143. X`20`20`20`20`20`20`20`20doesn't`20dither.
  144. X
  145. X`20`20`20`20`20`20`20`20Advantages:`20`20`20Generally`20`20produces`20`20sligh
  146. Vtly`20better`20images`20than
  147. X`20`20`20`20`20`20`20`20the`20-slow24`20algorithm.`20`20`20`20Also,`20`20the
  148. V`20images`20are`20undithered,`20so
  149. X`20`20`20`20`20`20`20`20they`20look`20better`20when`20expanded.
  150. X
  151. X`20`20`20`20`20`20`20`20Disadvantages:`20`20Much`20slower`20than`20the`20-slow
  152. V24`20algorithm.`20`20Like,
  153. X`20`20`20`20`20`20`20`205`20to`2010`20times`20slower.`20`20The`20images`20`20p
  154. Vroduced`20`20aren't`20`20that`20much
  155. X`20`20`20`20`20`20`20`20better`20than`20those`20produced`20by`20the`20-slow24
  156. V`20algorithm.
  157. X
  158. X`20`20`20`20`20`20`20`20-noqcheck`20`20(Resource`20name:`20noqcheck`20`20boole
  159. Van)
  160. X`20`20`20`20`20`20`20`20Turns`20off`20a`20'quick`20check'`20`20that`20`20is
  161. V`20`20normally`20made.`20`20Normally,
  162. X`20`20`20`20`20`20`20`20before`20`20running`20`20either`20`20of`20`20the`2024-
  163. Vbit`20`20to`20`208-bit`20`20conversion
  164. X`20`20`20`20`20`20`20`20algorithms,`20XV`20`20determines`20whether`20the`20pic
  165. Vture`20to`20be`20displayed
  166. X`20`20`20`20`20`20`20`20has`20more`20than`20`20256`20`20unique`20`20colors`20
  167. V`20in`20`20it.`20`20`20`20If`20`20the`20picture
  168. X`20`20`20`20`20`20`20`20doesn't,`20it`20will`20treat`20`20the`20`20picture`20
  169. V`20as`20`20an`208-bit`20colormapped
  170. X`20`20`20`20`20`20`20`20image`20(i.e.,`20GIF),`20and`20won't`20`20run`20`20eit
  171. Vher`20`20of`20`20the`20`20conversion
  172. X`20`20`20`20`20`20`20`20algorithms.
  173. X
  174. X`20`20`20`20`20`20`20`20Advantages:`20`20`20`20The`20`20pictures`20`20will`20
  175. V`20be`20displayed`20`20'perfectly',
  176. X`20`20`20`20`20`20`20`20whereas`20`20if`20`20they`20`20went`20`20through`20
  177. V`20either`20`20of`20`20the`20`20`20conversion
  178. X`20`20`20`20`20`20`20`20algorithms,`20they'd`20be`20dithered.
  179. X
  180. X`20`20`20`20`20`20`20`20Disadvantages:`20`20Often`20uses`20a`20lot`20of`20colo
  181. Vrs,`20which`20`20limits`20`20the
  182. X`20`20`20`20`20`20`20`20ability`20`20to`20`20view`20`20multiple`20images`20at
  183. V`20once.`20`20(See`20the`20`20-slow24
  184. X`20`20`20`20`20`20`20`20option`20above`20for`20further`20info`20about`20color
  185. V`20sharing.)
  186. X
  187. X3`20Root_Window_Options
  188. X`20`20`20`20`20`20`20`20XV`20has`20the`20ability`20to`20display`20images`20on
  189. V`20`20the`20root`20window`20of`20an
  190. X`20`20`20`20X`20`20display,`20`20rather`20`20than`20`20opening`20`20its`20`20o
  191. Vwn`20`20window`20(the`20`20default
  192. X`20`20`20`20behavior).`20`20`20`20When`20using`20the`20root`20window,`20the
  193. V`20program`20is`20`20somewhat
  194. X`20`20`20`20limited,`20because`20`20the`20`20program`20`20cannot`20`20receive
  195. V`20`20input`20events`20(key
  196. X`20`20`20`20press`20and`20mouse`20`20clicks)`20`20from`20`20the`20root`20windo
  197. Vw.`20`20As`20a`20result,`20you
  198. X`20`20`20`20cannot`20track`20pixel`20values,`20`20or`20`20crop,`20`20nor`20
  199. V`20can`20`20you`20`20use`20keyboard
  200. X`20`20`20`20commands`20while`20the`20mouse`20is`20in`20the`20root`20window.
  201. X
  202. X`20`20`20`20`20`20`20`20-root`20`20(Resource`20name:`20`20<none>)
  203. X`20`20`20`20`20`20`20`20Directs`20`20XV`20`20to`20`20display`20images`20in`20t
  204. Vhe`20root`20window,`20instead`20of
  205. X`20`20`20`20`20`20`20`20opening`20its`20`20own`20`20window.`20`20`20`20Exactly
  206. V`20`20how`20`20the`20`20images`20will`20be
  207. X`20`20`20`20`20`20`20`20displayed`20in`20the`20`20root`20`20window`20is`20dete
  208. Vrmined`20by`20the`20setting`20of
  209. X`20`20`20`20`20`20`20`20the`20-rmode`20option.
  210. X
  211. X`20`20`20`20`20`20`20`20-rmode`20`20mode`20`20(Resource`20name:`20rootMode`20
  212. V`20integer)
  213. X`20`20`20`20`20`20`20`20Determines`20how`20images`20are`20`20to`20be`20display
  214. Ved`20on`20the`20root`20window,
  215. X`20`20`20`20`20`20`20`20when`20-root`20has`20been`20specified.`20`20`20You`20c
  216. Van`20find`20the`20current`20list
  217. X`20`20`20`20`20`20`20`20of`20'modes'`20by`20using`20a`20mode`20`20value`20`20o
  218. Vf`20'-1'.`20`20XV`20will`20complain,
  219. X`20`20`20`20`20`20`20`20and`20show`20a`20list`20of`20valid`20modes.`20`20`20
  220. V`20The`20`20current`20list`20at`20of`20the
  221. X`20`20`20`20`20`20`20`20time`20of`20this`20writing`20is:
  222. X
  223. X`20`20`20`20`20`20`20`20`20`20`20`200:`20`20`20`20`20`20tiling
  224. X`20`20`20`20`20`20`20`20`20`20`20`201:`20`20`20`20`20`20integer`20tiling
  225. X`20`20`20`20`20`20`20`20`20`20`20`202:`20`20`20`20`20`20mirrored`20tiling
  226. X`20`20`20`20`20`20`20`20`20`20`20`203:`20`20`20`20`20`20integer`20mirrored`20t
  227. Viling
  228. X`20`20`20`20`20`20`20`20`20`20`20`204:`20`20`20`20`20`20centered`20tiling
  229. X`20`20`20`20`20`20`20`20`20`20`20`205:`20`20`20`20`20`20centered`20on`20a`20so
  230. Vlid`20background
  231. X`20`20`20`20`20`20`20`20`20`20`20`206:`20`20`20`20`20`20centered`20on`20a`20'w
  232. Varp'`20background
  233. X`20`20`20`20`20`20`20`20`20`20`20`207:`20`20`20`20`20`20centered`20on`20a`20'b
  234. Vrick'`20background
  235. X
  236. X`20`20`20`20`20`20`20`20The`20`20default`20mode`20is`20'0'.`20`20See`20`60`60S
  237. Vection`20`203.5:`20`20`20`20The`20`20Display
  238. X`20`20`20`20`20`20`20`20Modes`20Menu''`20for`20a`20description`20of`20the`20di
  239. Vfferent`20display`20modes.
  240. X
  241. X`20`20`20`20`20`20`20`20-noresetroot`20(Resource`20name:`20resetroot)
  242. X`20`20`20`20`20`20`20`20Normally,`20when`20changing`20from`20root`20to`20windo
  243. Vw`20display`20`20mode,`20the
  244. X`20`20`20`20`20`20`20`20root`20`20is`20`20set`20`20to`20`20the`20standard`20X
  245. V`20crosshatch`20pattern.`20`20`20`20Using
  246. X`20`20`20`20`20`20`20`20-noresetroot`20or`20setting`20resetroot`20to`20false
  247. V`20will`20force`20the`20root
  248. X`20`20`20`20`20`20`20`20to`20remain.`20`20`20`20This`20`20is`20useful`20when
  249. V`20comparing`20between`20different
  250. X`20`20`20`20`20`20`20`20tiled`20images.
  251. X`20`20`20`20`20`20`20`20
  252. X`20`20`20`20`20`20`20`20-rfg`20`20color`20`20(Resource`20name:`20rootForegroun
  253. Vd`20`20string)
  254. X`20`20`20`20`20`20`20`20Sets`20the`20'foreground'`20color`20used`20in`20some
  255. V`20of`20the`20`20root`20`20display
  256. X`20`20`20`20`20`20`20`20modes.
  257. X
  258. X`20`20`20`20`20`20`20`20-rbg`20`20color`20`20(Resource`20name:`20rootBackgroun
  259. Vd`20`20string)
  260. X`20`20`20`20`20`20`20`20Sets`20`20the`20'background'`20color`20used`20in`20som
  261. Ve`20of`20the`20root`20`20display
  262. X`20`20`20`20`20`20`20`20modes.
  263. X
  264. X`20`20`20`20`20`20`20`20-max`20`20(Resource`20name:`20<none>)
  265. X`20`20`20`20`20`20`20`20Makes`20`20XV`20`20automatically`20stretch`20the`20ima
  266. Vge`20to`20the`20full`20size`20of
  267. X`20`20`20`20`20`20`20`20the`20screen.`20`20This`20is`20mostly`20useful`20when
  268. V`20you`20want`20XV`20to`20display
  269. X`20`20`20`20`20`20`20`20a`20background.`20`20`20While`20`20you`20`20could`20
  270. V`20just`20`20as`20`20well`20`20specify`20the
  271. X`20`20`20`20`20`20`20`20dimensions`20of`20your`20display`20('-geom`201152x900'
  272. V`20for`20example),`20the
  273. X`20`20`20`20`20`20`20`20-max`20option`20is`20display-independent.`20`20If`20yo
  274. Vu`20suddenly`20decide`20to
  275. X`20`20`20`20`20`20`20`20start`20working`20on`20a`201280x1024`20display`20`20(f
  276. Verinstance)`20`20the`20`20same
  277. X`20`20`20`20`20`20`20`20command`20will`20still`20work.`20`20Note:`20`20`20If
  278. V`20you`20specify`20-max`20when`20you
  279. X`20`20`20`20`20`20`20`20aren't`20using`20-root,`20the`20behavior`20is`20slight
  280. Vly`20different.`20`20`20`20The
  281. X`20`20`20`20`20`20`20`20image`20will`20be`20made`20as`20large`20as`20possible
  282. V`20while`20still`20preserving
  283. X`20`20`20`20`20`20`20`20the`20normal`20aspect`20ratio.
  284. X
  285. X`20`20`20`20`20`20`20`20-maxpect`20`20(Resource`20name:`20<none>)
  286. X`20`20`20`20`20`20`20`20Makes`20`20the`20`20image`20`20as`20`20large`20`20as
  287. V`20possible`20while`20preserving`20the
  288. X`20`20`20`20`20`20`20`20aspect`20ratio.
  289. X
  290. X`20`20`20`20`20`20`20`20-quit`20`20(Resource`20name:`20<none>)
  291. X`20`20`20`20`20`20`20`20Makes`20`20XV`20display`20the`20(first)`20specified
  292. V`20file`20and`20exit,`20without
  293. X`20`20`20`20`20`20`20`20any`20user`20`20intervention.`20`20`20`20Since`20`20im
  294. Vages`20displayed`20on`20the`20root
  295. X`20`20`20`20`20`20`20`20window`20remain`20there`20`20until`20`20explicitly`20
  296. V`20cleared,`20`20this`20is`20very
  297. X`20`20`20`20`20`20`20`20useful`20for`20having`20XV`20`20display`20`20backgroun
  298. Vd`20`20images`20`20on`20the`20root
  299. X`20`20`20`20`20`20`20`20window`20in`20some`20sort`20of`20start-up`20script.
  300. V`20`20Needless`20to`20say,`20this
  301. X`20`20`20`20`20`20`20`20is`20only`20useful`20if`20you`20are`20using`20-root.
  302. X
  303. X`20`20`20`20`20`20`20`20-clear`20`20(Resource`20name:`20<none>)
  304. X`20`20`20`20`20`20`20`20Clears`20the`20root`20window`20of`20any`20extraneous
  305. V`20XV`20images.`20`20Note:`20`20it
  306. X`20`20`20`20`20`20`20`20is`20`20not`20`20necessary`20`20to`20`20do`20an`20'xv
  307. V`20`20-clear'`20`20before`20`20displaying
  308. X`20`20`20`20`20`20`20`20another`20`20picture`20`20in`20`20the`20root`20window.
  309. V`20`20XV`20`20will`20`20detect`20`20that
  310. X`20`20`20`20`20`20`20`20there's`20`20an`20`20old`20`20image`20`20in`20the`20ro
  311. Vot`20window`20and`20`20automatically
  312. X`20`20`20`20`20`20`20`20clear`20it`20out`20(and`20free`20the`20associated`20co
  313. Vlors).
  314. X
  315. X3`20Window_Options
  316. X`20`20`20`20`20`20`20`20XV`20currently`20`20consists`20`20of`20three`20main
  317. V`20windows,`20plus`20one`20window
  318. X`20`20`20`20for`20the`20actual`20`20image.`20`20`20`20These`20`20three`20`20wi
  319. Vndows`20`20(the`20`20xv`20controls
  320. X`20`20`20`20window,`20the`20xv`20info`20window,`20and`20the`20xv`20color`20edi
  321. Vtor`20window)`20may`20be
  322. X`20`20`20`20automatically`20mapped`20and`20positioned`20when`20the`20program
  323. V`20starts.
  324. X
  325. X`20`20`20`20`20`20`20`20-cmap`20`20(Resource`20name:`20ctrlMap`20`20boolean)
  326. X`20`20`20`20`20`20`20`20Maps`20the`20xv`20controls`20window.
  327. X
  328. X`20`20`20`20`20`20`20`20-cgeom`20`20geom`20`20(Resource`20name:`20ctrlGeometry
  329. V`20`20string)
  330. X`20`20`20`20`20`20`20`20Sets`20`20the`20`20initial`20geometry`20of`20the`20xv
  331. V`20controls`20window.`20`20`20Note:
  332. X`20`20`20`20`20`20`20`20only`20the`20position`20information`20is`20used.`20
  333. V`20The`20window`20is`20of`20fixed
  334. X`20`20`20`20`20`20`20`20size.
  335. X
  336. X`20`20`20`20`20`20`20`20-imap`20`20(Resource`20name:`20infoMap`20`20boolean)
  337. X`20`20`20`20`20`20`20`20Maps`20the`20xv`20info`20window.
  338. X
  339. X`20`20`20`20`20`20`20`20-igeom`20`20geom`20`20(Resource`20name:`20infoGeomet
  340. V`20`20string)
  341. X`20`20`20`20`20`20`20`20Sets`20`20the`20initial`20geometry`20of`20the`20xv`20i
  342. Vnfo`20window.`20`20Note:`20`20only
  343. X`20`20`20`20`20`20`20`20the`20position`20`20information`20`20is`20`20used.`20
  344. V`20`20`20The`20window`20is`20of`20fixed
  345. X`20`20`20`20`20`20`20`20size.
  346. X
  347. X`20`20`20`20`20`20`20`20-cemap`20`20(Resource`20name:`20ceditMap`20`20boolean)
  348. V
  349. X`20`20`20`20`20`20`20`20Maps`20the`20xv`20color`20editor`20window.
  350. X
  351. X`20`20`20`20`20`20`20`20-cegeom`20`20geom`20`20(Resource`20name:`20ceditGeomet
  352. Vry`20`20string)
  353. X`20`20`20`20`20`20`20`20Sets`20the`20initial`20`20geometry`20`20of`20`20the
  354. V`20`20xv`20`20color`20`20editor`20window.
  355. X`20`20`20`20`20`20`20`20Note:`20`20only`20the`20`20position`20`20information
  356. V`20is`20used.`20`20The`20window`20is
  357. X`20`20`20`20`20`20`20`20of`20fixed`20size.
  358. X
  359. X`20`20`20`20`20`20`20`20-nopos`20`20(Resource`20name:`20nopos`20`20boolean)
  360. X`20`20`20`20`20`20`20`20Turns`20off`20the`20'default'`20positioning`20of`20the
  361. V`20various`20XV`20windows.
  362. X`20`20`20`20`20`20`20`20Every`20time`20you`20open`20a`20window,`20`20you`20
  363. V`20will`20`20be`20asked`20to`20position
  364. X`20`20`20`20`20`20`20`20it.`20`20(Assuming`20your`20window`20manager`20asks
  365. V`20you`20such`20things.`20`20mwm,
  366. X`20`20`20`20`20`20`20`20for`20instance`20doesn't`20seem`20to`20ask.)
  367. X
  368. X3`20Miscellaneous_Options
  369. X`20`20`20`20`20`20`20`20-mono`20`20(Resource`20name:`20mono`20`20boolean)
  370. X`20`20`20`20`20`20`20`20Forces`20the`20image`20to`20be`20displayed`20as`20a
  371. V`20greyscale.`20`20This`20is`20most
  372. X`20`20`20`20`20`20`20`20useful`20when`20you`20are`20using`20certain`20greyscal
  373. Ve`20X`20displays.`20`20While
  374. X`20`20`20`20`20`20`20`20XV`20`20attempts`20`20to`20`20determine`20`20if`20`20i
  375. Vt's`20`20running`20`20on`20a`20greyscale
  376. X`20`20`20`20`20`20`20`20display,`20`20many`20`20X`20`20displays`20`20lie,`20
  377. V`20and`20claim`20to`20be`20able`20to`20`20do
  378. X`20`20`20`20`20`20`20`20color.`20`20(This`20is`20often`20because`20they`20have
  379. V`20color`20graphics`20boards
  380. X`20`20`20`20`20`20`20`20hooked`20up`20to`20`20b/w`20`20monitors.`20`20`20The
  381. V`20computer,`20of`20course,`20has`20no
  382. X`20`20`20`20`20`20`20`20way`20of`20knowing`20what`20`20type`20`20of`20`20monit
  383. Vor`20`20is`20attached.)`20On`20these
  384. X`20`20`20`20`20`20`20`20displays,`20if`20you`20don't`20specify`20`20-mono,`20
  385. V`20what`20you`20will`20see`20is`20a
  386. X`20`20`20`20`20`20`20`20greyscale`20`20representation`20of`20one`20of`20the
  387. V`20`20RGB`20`20outputs`20`20of`20`20the
  388. X`20`20`20`20`20`20`20`20system.`20`20`20(For`20example,`20you'll`20see`20the
  389. V`20`20'red'`20`20output`20`20on`20`20our
  390. X`20`20`20`20`20`20`20`20greyscale`20Sun`203/60s.)`20The`20-mono`20option`20cor
  391. Vrects`20this`20behavior.
  392. X
  393. X`20`20`20`20`20`20`20`20-white`20`20color`20`20(Resource`20name:`20white`20
  394. V`20string)
  395. X`20`20`20`20`20`20`20`20Specifies`20`20the`20`20'white'`20`20color`20`20used
  396. V`20when`20the`20picture`20`20is`20`20b/w
  397. X`20`20`20`20`20`20`20`20stippled.`20`20(When`20'-ncols`200'`20has`20been`20spe
  398. Vcified.)
  399. X
  400. X`20`20`20`20`20`20`20`20-black`20`20color`20`20(Resource`20name:`20black`20
  401. V`20string)
  402. X`20`20`20`20`20`20`20`20Specifies`20`20the`20`20'black'`20`20color`20`20used
  403. V`20`20when`20the`20picture`20is`20`20b/w
  404. X`20`20`20`20`20`20`20`20stippled.`20`20(When`20'-ncols`200'`20has`20been`20spe
  405. Vcified.)
  406. X
  407. X`20`20`20`20`20`20`20`20Try`20`20something`20`20like:`20`20`20`20'xv`20`20-nco
  408. Vls`20`200`20`20-bl`20`20red`20`20-wh`20`20yellow
  409. X`20`20`20`20`20`20`20`20<filename>'`20for`20`20some`20interesting,`20late-'60s
  410. V-style`20psychodelia
  411. X`20`20`20`20`20`20`20`20effects.
  412. X
  413. X`20`20`20`20`20`20`20`20-wait`20`20secs`20`20(Resource`20name:`20<none>)
  414. X`20`20`20`20`20`20`20`20Turns`20on`20a`20`20'slide-show'`20`20feature.`20`20
  415. V`20`20Normally,`20if`20you`20specify
  416. X`20`20`20`20`20`20`20`20multiple`20input`20files,`20XV`20`20will`20display`20t
  417. Vhe`20first`20one,`20and`20wait
  418. X`20`20`20`20`20`20`20`20for`20you`20to`20give`20the`20`20Next`20`20command`20
  419. V`20(or`20`20whatever).`20`20The`20-wait
  420. X`20`20`20`20`20`20`20`20option`20makes`20XV`20wait`20the`20specified`20number
  421. V`20of`20seconds,`20and`20then
  422. X`20`20`20`20`20`20`20`20go`20on`20to`20the`20next`20picture,`20without`20any
  423. V`20user`20intervention.`20`20The
  424. X`20`20`20`20`20`20`20`20program`20`20still`20`20accepts`20commands,`20so`20it'
  425. Vs`20possible`20to`20`20'abort'
  426. X`20`20`20`20`20`20`20`20the`20current`20picture`20without`20waiting`20the`20fu
  427. Vll`20specified`20time`20by
  428. X`20`20`20`20`20`20`20`20using`20the`20Next`20command.
  429. X
  430. X`20`20`20`20`20`20`20`20-wloop`20`20(Resource`20name:`20<none>)
  431. X`20`20`20`20`20`20`20`20Normally,`20`20when`20running`20a`20slide-show`20with
  432. V`20the`20-wait`20option,`20XV
  433. X`20`20`20`20`20`20`20`20will`20`20terminate`20`20after`20displaying`20the`20la
  434. Vst`20image.`20`20If`20you`20also
  435. X`20`20`20`20`20`20`20`20specify`20the`20`20-wloop`20`20option,`20the`20program
  436. V`20will`20loop`20back`20to`20the
  437. X`20`20`20`20`20`20`20`20first`20image`20and`20`20continue`20the`20slide-show
  438. V`20until`20the`20user`20issues
  439. X`20`20`20`20`20`20`20`20the`20Quit`20command.
  440. X
  441. X`20`20`20`20`20`20`20`20-rgb`20`20(Resource`20name:`20hsvMode`20boolean)
  442. X`20`20`20`20`20`20`20`20Specifies`20that,`20by`20default,`20`20the`20colormap
  443. V`20editing`20dials`20in`20the
  444. X`20`20`20`20`20`20`20`20xv`20color`20editor`20window`20should`20`20be`20`20in
  445. V`20`20RGB`20`20mode.`20`20This`20is`20the
  446. X`20`20`20`20`20`20`20`20normal`20default`20behavior.
  447. X
  448. X`20`20`20`20`20`20`20`20-hsv`20`20(Resource`20name:`20hsvMode`20`20boolean)
  449. X`20`20`20`20`20`20`20`20Specifies`20that,`20by`20default,`20the`20colormap`20
  450. V`20editing`20dials`20in`20the
  451. X`20`20`20`20`20`20`20`20xv`20color`20editor`20window`20should`20be`20in`20HSV
  452. V`20mode.
  453. X
  454. X`20`20`20`20`20`20`20`20-dither`20`20(Resouce`20name:`20autoDither`20`20boolea
  455. Vn)
  456. X`20`20`20`20`20`20`20`20When`20`20specified,`20`20tells`20`20XV`20`20to`20auto
  457. Vmatically`20issue`20`20a`20`20Dither
  458. X`20`20`20`20`20`20`20`20command`20`20whenever`20`20an`20`20image`20`20is`20fir
  459. Vst`20displayed.`20`20`20Useful`20`20on
  460. X`20`20`20`20`20`20`20`20displays`20`20with`20`20limited`20`20color`20`20capabi
  461. Vlities`20`20(4-bit`20and`206-bit
  462. X`20`20`20`20`20`20`20`20displays.)
  463. X
  464. X`20`20`20`20`20`20`20`20-smooth`20`20(Resource`20name:`20`20autoSmooth`20`20bo
  465. Volean)
  466. X`20`20`20`20`20`20`20`20When`20specified,`20`20tells`20`20XV`20`20to`20`20auto
  467. Vmatically`20`20issue`20`20a`20Smooth
  468. X`20`20`20`20`20`20`20`20command`20whenever`20an`20`20image`20is`20first`20disp
  469. Vlayed.`20`20This`20is`20useful
  470. X`20`20`20`20`20`20`20`20when`20you`20are`20using`20`20one`20`20of`20`20the`20i
  471. Vmage`20sizing`20options`20(such`20as
  472. X`20`20`20`20`20`20`20`20'-expand'`20or`20'-max').
  473. X
  474. X`20`20`20`20`20`20`20`20-crop`20`20(Resource`20name:`20autoCrop`20boolean)
  475. X`20`20`20`20`20`20`20`20When`20specified,`20tells`20`20xv`20`20to`20`20automat
  476. Vically`20issue`20an`20AutoCrop
  477. X`20`20`20`20`20`20`20`20command`20whenever`20an`20image`20is`20first`20display
  478. Ved.
  479. X`20`20`20`20
  480. X`20`20`20`20`20`20`20`20-visual`20`20vistype`20`20(Resource`20name:`20visual
  481. V`20`20string)
  482. X`20`20`20`20`20`20`20`20Normally,`20XV`20uses`20the`20default`20`20visual`20mo
  483. Vdel`20provided`20by`20your`20X
  484. X`20`20`20`20`20`20`20`20server.`20`20`20`20You`20can`20override`20this`20`20by
  485. V`20`20explicitly`20`20selecting`20`20a
  486. X`20`20`20`20`20`20`20`20visual`20`20to`20`20use.`20`20`20`20Valid`20types`20ar
  487. Ve`20`20StaticGray,`20`20StaticColor,
  488. X`20`20`20`20`20`20`20`20TrueColor,`20`20GrayScale,`20`20PseudoColor,`20and`20D
  489. VirectColor.`20`20Not`20all
  490. X`20`20`20`20`20`20`20`20of`20these`20are`20necessarily`20provided`20on`20any
  491. V`20given`20X`20display.`20`20Run
  492. X`20`20`20`20`20`20`20`20xdpyinfo`20on`20your`20`20display`20`20to`20`20find
  493. V`20`20out`20what`20visual`20types`20are
  494. X`20`20`20`20`20`20`20`20supported.
  495. X
  496. X`20`20`20`20`20`20`20`20-cursor`20`20curs`20`20(Resource`20name:`20cursor`20
  497. V`20integer)
  498. X`20`20`20`20`20`20`20`20Specifies`20an`20alternate`20cursor`20`20to`20`20use
  499. V`20`20in`20`20the`20`20image`20`20window
  500. X`20`20`20`20`20`20`20`20(instead`20`20of`20the`20normal`20'cross'`20`20cursor)
  501. V.`20`20`20`20curs`20`20values`20`20are
  502. X`20`20`20`20`20`20`20`20obtained`20by`20finding`20the`20character`20number`20
  503. V`20of`20a`20cursor`20you`20like
  504. X`20`20`20`20`20`20`20`20in`20the`20'cursor'`20font.`20`20(Run`20'xfd`20`20-fn
  505. V`20`20cursor'`20`20to`20display`20the
  506. X`20`20`20`20`20`20`20`20cursor`20font.)`20For`20example,`20a`20curs`20value
  507. V`20of`20'56'`20corresponds`20to
  508. X`20`20`20`20`20`20`20`20the`20(singularly`20useless)`20'Gumby'`20cursor.
  509. X
  510. X`20`20`20`20`20`20`20`20-keeparound`20`20(Resource`20name:`20keepAround`20`20b
  511. Voolean)
  512. X`20`20`20`20`20`20`20`20By`20`20default`20`20if`20you`20Delete`20the`20last
  513. V`20file`20in`20`20the`20`20XV`20`20controls
  514. X`20`20`20`20`20`20`20`20list,`20`20the`20`20program`20will`20automatically`20e
  515. Vxit,`20as`20a`20convenience.
  516. X`20`20`20`20`20`20`20`20If`20you`20find`20this`20an`20inconvenience.
  517. X
  518. X`20`20`20`20`20`20`20`20-2xlimit`20`20(Resource`20name:`202xlimit`20`20boolean
  519. V)
  520. X`20`20`20`20`20`20`20`20By`20default,`20`20XV`20`20prevents`20`20the`20`20imag
  521. Ve`20window`20from`20ever`20getting
  522. X`20`20`20`20`20`20`20`20larger`20than`20the`20`20screen.`20`20`20`20Unfortunat
  523. Vely,`20because`20of`20this,`20if
  524. X`20`20`20`20`20`20`20`20you`20load`20an`20image`20`20that`20`20is`20larger`20t
  525. Vhan`20your`20screen,`20the`20image
  526. X`20`20`20`20`20`20`20`20will`20be`20shrunk`20until`20it`20`20fits`20on`20your
  527. V`20screen.`20`20Some`20folks`20find
  528. X`20`20`20`20`20`20`20`20this`20`20undesirable`20`20behavior.`20`20Specifying
  529. V`20the`20`20-2xlimit`20`20option
  530. X`20`20`20`20`20`20`20`20doubles`20the`20size`20limitations.`20`20The`20image
  531. V`20`20window`20`20will`20be`20kept
  532. X`20`20`20`20`20`20`20`20from`20`20getting`20`20larger`20`20than`202x`20the`20w
  533. Vidth`20and`20`20height`20`20of`20`20your
  534. X`20`20`20`20`20`20`20`20screen.
  535. X
  536. X`20`20`20`20`20`20`20`20Just`20`20`20`20in`20`20`20`20case`20`20you're`20`20wo
  537. Vndering`20`20why`20`20there's`20`20any`20`20size
  538. X`20`20`20`20`20`20`20`20limitations:`20`20it's`20fairly`20easy`20to`20accident
  539. Vally`20ask`20for`20a`20`20huge
  540. X`20`20`20`20`20`20`20`20image`20`20to`20`20be`20generated.`20`20Simply`20crop
  541. V`20a`20section`20of`20the`20`20image,
  542. X`20`20`20`20`20`20`20`20zoom`20`20so`20`20you`20`20can`20`20see`20the`20indivi
  543. Vdual`20pixels,`20and`20uncrop.`20`20If
  544. X`20`20`20`20`20`20`20`20there`20were`20`20no`20`20size`20`20limitations,`20
  545. V`20the`20`20(expanded`20many`20times)
  546. X`20`20`20`20`20`20`20`20image`20could`20be`20`20huge,`20`20and`20`20might`20cr
  547. Vash`20your`20X`20server.`20`20At`20the
  548. X`20`20`20`20`20`20`20`20very`20least,`20it`20would`20`20take`20`20a`20`20long
  549. V`20period`20of`20time,`20and`20freeze
  550. X`20`20`20`20`20`20`20`20your`20`20X`20`20server`20during`20part`20`20of`20`20i
  551. Vt.`20`20`20`20Generally`20`20undesirable
  552. X`20`20`20`20`20`20`20`20behavior.
  553. X
  554. X`20`20`20`20`20`20`20`20-nolimits`20(Resource`20name:`20nolimites`20boolean)
  555. X`20`20`20`20`20`20`20`20For`20`20the`20`20truly`20`20daring,`20this`20turns
  556. V`20off`20all`20limitations`20on`20the
  557. X`20`20`20`20`20`20`20`20maximum`20size`20`20of`20`20an`20`20image`20`20window.
  558. V`20`20`20(Well,`20there's`20still`20an
  559. X`20`20`20`20`20`20`20`20X-imposed`20`20maximum`20`20size`20`20of`20`2064k`20
  560. V`20by`20`2064k,`20`20but`20`20that`20`20really
  561. X`20`20`20`20`20`20`20`20shouldn't`20be`20a`20problem.)`20`20Warning:`20`20`20a
  562. Vs`20mentioned`20above,`20it`20is
  563. X`20`20`20`20`20`20`20`20fairly`20easy`20to`20accidentally`20generate`20`20a
  564. V`20huge`20image`20when`20you`20do
  565. X`20`20`20`20`20`20`20`20an`20UnCrop`20command,`20and`20you`20may`20`20well`20
  566. V`20crash`20xv,`20your`20X`20server,
  567. X`20`20`20`20`20`20`20`20the`20host`20machine,`20or`20all`20three.`20`20Use`20A
  568. Vt`20Your`20Own`20Risk!!!
  569. X
  570. X`20`20`20`20`20`20`20`20-rv`20`20(Resource`20name:`20reverse)
  571. X`20`20`20`20`20`20`20`20Makes`20`20xv`20display`20a`20'negative'`20of`20the
  572. V`20`20loaded`20`20image.`20`20`20`20White
  573. X`20`20`20`20`20`20`20`20becomes`20`20black,`20`20and`20black`20becomes`20white
  574. V.`20`20Color`20`20images`20`20will
  575. X`20`20`20`20`20`20`20`20have`20`20`20`20'interesting'`20`20effects,`20`20as
  576. V`20`20the`20`20RGB`20`20components`20`20are
  577. X`20`20`20`20`20`20`20`20individually`20reversed.`20`20For`20example,`20red`20(
  578. V255,0,0)`20will`20become
  579. X`20`20`20`20`20`20`20`20cyan`20(0,255,255),`20yellow`20will`20become`20blue,
  580. V`20and`20so`20on.
  581. X
  582. X`20`20`20`20`20`20`20`20-DEBUG`20`20level`20`20`20(Resource`20name:`20<none>)
  583. X`20`20`20`20`20`20`20`20Turns`20on`20some`20debugging`20information.`20`20You
  584. V`20shouldn't`20need`20this.
  585. X`20`20`20`20`20`20`20`20If`20everything`20worked`20perfectly,`20I`20wouldn't
  586. V`20need`20`20this`20`20either.
  587. X`20`20`20`20`20`20`20`20Specifying`20'-'`20all`20by`20itself`20tells`20XV`20to
  588. V`20`20take`20`20its`20input`20from
  589. X`20`20`20`20`20`20`20`20stdin,`20rather`20then`20from`20a`20file.`20`20This
  590. V`20lets`20`20you`20`20put`20XV`20on`20the
  591. X`20`20`20`20`20`20`20`20end`20of`20a`20Un*x`20pipe.
  592. X
  593. X2`20Limitations
  594. X`20`20`20`20`20`20`20`20XV`20will`20NOT`20work`20on`20displays`20that`20aren't
  595. V`201-,`204-,`206-,`20`208-,`20`2016-
  596. X`20`20`20`2024-,`20or`20`2032-bits`20`20deep.`20`20`20`20Luckily,`20that`20sho
  597. Vuld`20still`20cover`20nearly
  598. X`20`20`20`20every`20display`20out`20`20there.`20`20It`20may`20not`20work`20on
  599. V`20certain`206-`20or`2024-bit
  600. X`20`20`20`20displays.
  601. X
  602. X`20`20`20`20`20`20`20`20It`20also`20only`20displays`20`20the`20`20first`20imag
  603. Ve`20in`20GIF`20files`20that`20have
  604. X`20`20`20`20multiple`20images`20in`20them.
  605. X
  606. X`20`20`20`20`20`20`20`20As`20for`20PM`20pictures,`20this`20`20program`20`20onl
  607. Vy`20displays`201-plane`20PM_I
  608. X`20`20`20`20pictures,`20or`201-,`203-,`20or`204-plane`20PM_C`20pictures.
  609. X
  610. X2`20Authors
  611. X`20`20`20`20`20`20`20`20John`20Bradley`20`20-`20`20bradley@cis.upenn.edu
  612. X
  613. X`20`20`20`20`20`20`20`20GIF`20reading`20code`20`20based`20`20on`20gif2ras.c,
  614. V`20by`20Patrick`20J.`20`20Naughton
  615. X`20`20`20`20(naughton@wind.sun.com)
  616. X
  617. X`20`20`20`20`20`20`20`20GIF`20writing`20code`20essentially`20`20unchanged`20
  618. V`20from`20`20code`20written`20by
  619. X`20`20`20`20Michael`20Maudlin`20(mlm@cs.cmu.edu).
  620. X
  621. X`20`20`20`20`20`20`20`20SUN`20Rasterfile`20i/o`20code`20written`20by`20Dave
  622. V`20Heath`20(heath@cs.jhu.edu)
  623. X
  624. X`20`20`20`20`20`20`20`20JPEG`20interface`20code`20written`20by`20Markus`20Baur
  625. V
  626. X`20`20`20`20`20`20`20`20(s_baur@iravcl.ira.uka.de)
  627. X
  628. X`20`20`20`20`20`20`20`20JPEG`20i/o`20code`20provided`20by`20the`20Independent
  629. V`20JPEG`20Group.
  630. X
  631. X`20`20`20`20`20`20`20`20VMS`20port`20by`20David`20Jones`20(jonesd@kcgl1.eng.oh
  632. Vio-state.edu),
  633. X`20`20`20`20`20`20`20`20and`20Rick`20Dyson`20(Dyson@IowaSP.Physics.UIowa.EDU).
  634. V
  635. X
  636. X1`20BGGEN
  637. X`20`20`20`20`20`20`20`20Generates`20colored`20backgrounds`20on`20X11`20display
  638. Vs.`20`20`20`20BGGEN`20`20is`20`20a
  639. X`20`20`20`20program`20`20that`20`20generates`20`20a`20width-pixel`20wide`20by
  640. V`20`20size-pixels`20`20high
  641. X`20`20`20`20vertical`20stripe.`20`20The`20top`20of`20the`20stripe`20`20is`20
  642. V`20in`20`20color`20(r1,g1,b1),
  643. X`20`20`20`20and`20the`20bottom`20of`20the`20stripe`20is`20in`20color`20(rn,gn,
  644. Vbn).`20`20Intermediate
  645. X`20`20`20`20colors`20are`20interpolated`20between`20these`20colors.`20`20If
  646. V`20you`20specify`20more
  647. X`20`20`20`20than`202`20colors,`20the`20stripe`20passes`20through`20all`20the
  648. V`20specified`20colors,
  649. X`20`20`20`20in`20the`20order`20specified.
  650. X
  651. X`20`20`20`20`20`20`20`20The`20'-b'`20`20option`20`20specifies`20`20the`20numbe
  652. Vr`20of`20significant`20bits`20in
  653. X`20`20`20`20the`20(output)`20color`20specifications.`20`20It`20must`20range
  654. V`20between`201`20and`208,
  655. X`20`20`20`20inclusive.`20`20Use`20values`20`20less`20`20than`20`208`20(the`20d
  656. Vefault)`20to`20limit`20color
  657. X`20`20`20`20use`20by`20increasing`20the`20color`20granularity.
  658. X
  659. X`20`20`20`20`20`20`20`20Values`20for`20'r',`20'g',`20and`20`20'b'`20`20should
  660. V`20range`20between`200`20and`20255,
  661. X`20`20`20`20inclusive.`20`200`20means`20'off',`20and`20255`20means`20'fully
  662. V`20on'.
  663. X
  664. X`20`20`20`20`20`20`20`20BGGEN`20doesn't`20actually`20affect`20your`20backgroun
  665. Vd`20directly.`20`20BGGEN
  666. X`20`20`20`20merely`20`20generates`20`20a`20small`20PPM`20(Portable`20Pixmap
  667. V`20`20Format)`20`20datafile
  668. X`20`20`20`20that`20XV`20can`20read`20and`20display.
  669. X
  670. X`20`20`20`20`20`20`20`20To`20use`20BGGEN`20,`20you`20should`20pipe`20its`20
  671. V`20output`20into`20an`20XV`20command,
  672. X`20`20`20`20such`20as:`20`20"xv`20-root`20-quit`20-slow24"
  673. X
  674. X`20`20`20`20`20`20`20`20The`20default`20'size'`20is`201024`20pixels,`20which
  675. V`20should`20be`20`20as`20tall`20as
  676. X`20`20`20`20your`20`20display.`20`20`20If`20your`20display`20is`20taller`20tha
  677. Vn`20that,`20`20you`20`20should
  678. X`20`20`20`20specify`20`20its`20`20actual`20`20height,`20`20otherwise`20`20you
  679. V`20`20will`20`20get`20a`20bizarre
  680. X`20`20`20`20repeating`20effect,`20`20that`20`20you`20`20probably`20didn't`20wa
  681. Vnt.`20`20Note:`20`20If`20you
  682. X`20`20`20`20specify`20small`20values`20of`20'-s',`20you`20can`20get`20some`20n
  683. Veat`20effects.
  684. X
  685. X`20`20`20`20`20`20`20`20The`20'-w'`20argument`20has`20been`20added`20to`20impr
  686. Vove`20the`20performance`20of
  687. X`20`20`20`20various`20stippling`20algorithms`20(as`20in`20XV).`20`20More`20inf
  688. Vormation`20to`20work
  689. X`20`20`20`20with,`20and`20such.`20`20Try`20`20using`20`20'-w`2016'`20on`20thes
  690. Ve`20command`20lines`20to`20see
  691. X`20`20`20`20what`20is`20meant.
  692. X
  693. X`20`20`20`20Execution`20format:
  694. X`20`20`20`20`20`20`20`20BGGEN`20`5B-w`20width`5D`20`5B-s`20size`5D`20`5B-b`20b
  695. Vits`5D
  696. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20r1`20g1`20b1`20`5Br2`20g2`20b2`20...
  697. V`20rn`20gn`20bn`5D
  698. X
  699. X2`20Examples
  700. X
  701. X`20`20`20`20Light`20Blue`20to`20Dark`20Blue:
  702. X`20`20`20`20`20`20`20`20BGGEN`20100`20100`20255`20`2050`2050`20150`20`20`7C
  703. V`20xv`20-ro`20-q`20-sl`20"-"
  704. X`20`20`20`20RGB`20Rainbow:
  705. X`20`20`20`20`20`20`20`20BGGEN`200`200`20255`20`200`20255`200`20`20255`200`200
  706. V`20`7C`20xv`20-ro`20-q`20-sl`20"-"
  707. X`20`20`20`20Green`20Cylinders:
  708. X`20`20`20`20`20`20`20`20BGGEN`200`200`200`20`200`20255`200`20`200`200`200`20-s
  709. V`20128`20`7C`20xv`20-ro`20-q`20-sl`20"-"
  710. X`20`20`20`20Blue`20to`20Magenta:
  711. X`20`20`20`20`20`20`20`20BGGEN`200`200`20255`20`20200`200`20100`20`7C`20xv`20-r
  712. Vo`20-q`20-sl`20"-"
  713. X`20`20`20`20Full`20Rainbow:
  714. X`20`20`20`20`20`20`20`20BGGEN`200`200`20255`20`200`20255`20255`20`200`20255
  715. V`200`20`20255`20255`200`20`20255`200`200`20
  716. X`20`20`20`20`20`20`20`20`20`20`20`20`7C`20xv`20-ro`20-q`20-sl`20"-"
  717. X`20`20`20`20Repeating`20Rainbow:
  718. X`20`20`20`20`20`20`20`20BGGEN`200`200`20255`200`20255`20255`200`20255`200`2025
  719. V5`20255`200`20255`200`200`20
  720. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20255`200`20255`200`200`20255`20-s`202
  721. V56`20`7C`20xv`20-ro`20-q`20-sl`20"-"
  722. X
  723. X2`20Bugs
  724. X`20`20`20`20`20`20`20`20It'd`20probably`20be`20nice`20if`20the`20`20program
  725. V`20`20used`20`20some`20`20X`20`20calls`20to
  726. X`20`20`20`20determine`20screen`20size.`20`20It'd`20also`20probably`20`20be`20n
  727. Vice`20if`20the`20program
  728. X`20`20`20`20could`20take`20colors`20by`20'name',`20and`20also`20by`20hexadecim
  729. Val`20value.
  730. X
  731. X2`20Author
  732. X`20`20`20`20`20`20`20`20John`20Bradley`20`20-`20`20bradley@cis.upenn.edu
  733. $ call unpack XV.HLP;222 893987139 ""
  734. $!
  735. $ create 'f'
  736. X-`20`20533
  737. X#ifdef`20VMS
  738. X</*`20For`20VMS`20we`20will`20default`20all`20files`20EXCEPT`20directories`20t
  739. Vo`20avoid
  740. X`20`20`20the`20high`20cost`20of`20the`20VAXC`20implementation`20of`20the`20sta
  741. Vt`20function.
  742. X`20`20`20`20`20`20`20`20`20`20`20`20Suggested`20by`20Kevin`20Oberman`20(OBERMA
  743. VN@icdc.llnl.gov)`20*/
  744. X
  745. X`20`20`20`20`20`20if`20(strstr`20(fnames`5Bi`5D+1,`20".DIR")`20!=`20NULL)`20fn
  746. Vames`5Bi`5D`5B0`5D`20=`20C_DIR;
  747. X#else
  748. X-`20`20555
  749. X#endif`20/*`20VMS`20*/
  750. X/
  751. $ call unpack XVDIR.DIF;222 927290042 ""
  752. $!
  753. $ create 'f'
  754. X-`201114,`201114
  755. X</*`20Added`20by`20RLD`20to`20activate`20sizing`20buttons`20for`20VMS`201-MAY-
  756. V1992
  757. X`20`20`20Though`20it`20still`20has`20the`20'creeping'`20window`20problem`20*/
  758. X#if`20defined(DXWM)`20`7C`7C`20defined(VMS)`20/*`20dxwm`20seems`20to`20*only*
  759. V`20pay`20attention`20to`20the`20hints`20*/
  760. X-`201126,`201126
  761. X#ifndef`20MWM`20/*`20don't`20do`20this`20for`20DEC's`20Motif`20Window`20Manage
  762. Vr`20*/
  763. X`20`20`20`20xwc.x`20-=`205;`20`20`20xwc.y`20-=`2025;`20`20`20`20/*`20EVIL`20KL
  764. VUDGE`20*/
  765. X#endif`20/*`20MWM`20*/
  766. X/
  767. $ call unpack XVEVENT.DIF;222 2020418545 ""
  768. $!
  769. $ create 'f'
  770. X-`20`20132
  771. X`20`20unsigned`20char`20*final_out=NULL;`09/*`20final`20output`20pointer`20*/
  772. X-`20`20408,`20`20408
  773. X`20`20`20`20`20`20status`20=`20GIF_DECOMPRESS
  774. X`09(`20gif_fget_counted,`20map,`20maxpixels,`20picptr,`20`26final_out`20);
  775. X-`20`20435,`20`20435
  776. X`20`20`20`20`20`20/*`20Zero`20rest`20of`20array`20*/
  777. X`20`20`20`20`20`20if`20(`20final_out`20!=`20NULL`20)
  778. X`09`09while`20(`20final_out`20<`20`26picptr`5BHeight*Width`5D`20)`20*final_out
  779. V++`20=`200;
  780. X`20`20`20`20`20return(`20GifError(msg)*0`20);
  781. X/
  782. $ call unpack XVGIF.DIF;222 1679885970 ""
  783. $!
  784. $ create 'f'
  785. X-`20`20559,`20`20559
  786. X#ifdef`20VMS
  787. X`20`20if`20((cinfo.input_file`20=`20fopen(fname,`20"r",`20"ctx=stm"))`20==`20N
  788. VULL)`20return`201;
  789. X#else
  790. X`20`20if`20((cinfo.input_file`20=`20fopen(fname,`20"r"))`20==`20NULL)`20return
  791. V`201;
  792. X#endif
  793. X/
  794. $ call unpack XVJPEG.DIF;222 1632064038 ""
  795. $!
  796. $ create 'f'
  797. X-`20`20228
  798. Xvoid`20DimRect(win,`20x,`20y,`20w,`20h,`20bg)
  799. XWindow`20win;
  800. Xint`20x,y,w,h;
  801. Xu_long`20bg;
  802. X`7B
  803. X`20`20/*`20stipple`20a`20rectangular`20region`20by`20drawing`20'bg'`20where
  804. V`20there's`201's`20
  805. X`20`20`20`20`20in`20the`20stipple`20pattern`20*/
  806. X
  807. X`20`20XSetFillStyle(theDisp,`20theGC,`20FillStippled);
  808. X`20`20XSetStipple(theDisp,`20theGC,`20grayStip);
  809. X`20`20XSetForeground(theDisp,`20theGC,`20bg);
  810. X`20`20XFillRectangle(theDisp,win,theGC,x,y,w,h);
  811. X`20`20XSetFillStyle(theDisp,`20theGC,`20FillSolid);
  812. X`7D
  813. X</***********************************/
  814. X-`20`20235,`20`20235
  815. X-`20`20245,`20`20259
  816. X-`20`20263,`20`20264
  817. X/
  818. $ call unpack XVMISC.DIF;222 108744206 ""
  819. $!
  820. $ create 'f'
  821. X$!
  822. X$!`20apply`20fixes`20to`20XV`20source`20files`20based`20upon`20contents`20of
  823. V`20.DIF`20files
  824. X$!
  825. X$`20Write`20Sys$Output`20"`20"
  826. X$`20Write`20Sys$Output`20"Working`20on`20the`20XV`20files`20now..."
  827. X$`20Write`20Sys$Output`20"`20"
  828. X$`20Call`20dclslp`20vdcomp.c
  829. X$`20Call`20dclslp`20xv.c
  830. X$`20Call`20dclslp`20xvdir.c
  831. X$`20Call`20dclslp`20xvevent.c
  832. X$`20Call`20dclslp`20xvgif.c
  833. X$`20Call`20dclslp`20xvjpeg.c
  834. X$!
  835. X$`20Write`20Sys$Output`20"`20"
  836. X$`20Write`20Sys$Output`20"Working`20on`20the`20TIFF`20files`20now..."
  837. X$`20Write`20Sys$Output`20"`20"
  838. X$!
  839. X$`20Set`20Default`20`5B.tiff`5D
  840. X$`20Call`20dclslp`20mkg3states.c
  841. X$`20Call`20dclslp`20tiffcompat.h
  842. X$`20Call`20dclslp`20tiffio.h
  843. X$`20Call`20dclslp`20tif_machdep.c
  844. X$`20Call`20dclslp`20tif_swab.c
  845. X$`20Set`20Default`20`5B-`5D
  846. X$!
  847. X$`20Exit
  848. X$!
  849. X$`20DCLSLP:`20SUBROUTINE
  850. X$!
  851. X$!`20edit`20file`20based`20upon`20DIFF/SLP`20output.
  852. X$!
  853. X$!`20parameters:
  854. X$!`20`20`20`20`20P1`09Name`20of`20original`20source`20file.
  855. X$!`20`20`20`20`20P2`09Name`20of`20differences`20file`20(default`20'P1'.dif)
  856. X$!`20`20`20`20`20P3`09Name`20of`20output`20file.
  857. X$!
  858. X$`20say`20=`20"write`20sys$output"
  859. X$`20if`20p1`20.eqs.`20""`20then`20inquire`20p1`20"File`20to`20edit"
  860. X$`20if`20p1`20.eqs.`20""`20then`20exit
  861. X$`20ifile_name`20=`20f$search(p1)
  862. X$`20if`20ifile_name`20.eqs.`20""
  863. X$`20then
  864. X$`20`20say`20"Input`20file`20not`20found"
  865. X$`20`20exit
  866. X$`20endif
  867. X$`20ifile_type`20=`20f$parse(p1,,,"TYPE")`20+`20"-orig;"
  868. X$`20ifile_orig`20=`20f$search(f$parse(ifile_type,ifile_name))
  869. X$`20if`20ifile_orig`20.nes.`20""
  870. X$`20then
  871. X$`20`20`20say`20"Found`20existing`20original`20file..."
  872. X$`20else
  873. X$`20`20`20`20copy/log`20'ifile_name'`20'f$parse(ifile_type,ifile_name)'
  874. X$`20`20`20`20ifile_orig`20=`20ifile_name
  875. X$`20endif
  876. X$`20obj_file`20=`20f$parse(".obj;",ifile_name)
  877. X$`20if`20f$search(obj_file)`20.nes.`20""`20then`20delete/log`20'obj_file'*
  878. X$!
  879. X$`20on`20control_y`20then`20goto`20cleanup
  880. X$`20open/read`20ifile`20'ifile_orig'/err=no_input_file
  881. X$`20say`20"Processing`20file`20",`20ifile_orig
  882. X$`20open/read`20dfile`20'f$search(f$parse(P2,".dif;",ifile_name))'/error=no_di
  883. Vf_file
  884. X$`20on`20error`20then`20goto`20cleanup
  885. X$`20ofile_name`20=`20f$parse(p3,"",ifile_name)
  886. X$`20create`20'ofile_name'
  887. X$`20open/append`20ofile`20'ofile_name'
  888. X$`20cur_line`20=`200
  889. X$`20read`20dfile`20dif_line/end=dif_eof
  890. X$!
  891. X$`20get_range:
  892. X$`20`20`20dif_line`20=`20f$edit(dif_line,"collapse")`20-`20"-"
  893. X$`20`20`20dif_start_line`20=`20f$integer(f$element(0,",",dif_line))
  894. X$`20`20`20dif_end_line`20=`20f$element(1,",",dif_line)
  895. X$`20`20`20if`20dif_end_line`20.eqs.`20","`20.or.`20dif_end_line`20.eqs.`20""
  896. X$`20`20`20`20then`20dif_end_line`20=`20dif_start_line`20-`201
  897. X$`20`20`20`20else
  898. X$`09dif_start_line`20=`20dif_start_line`20-`201
  899. X$`09dif_end_line`20=`20f$integer(dif_end_line)
  900. X$`20`20`20endif
  901. X$!
  902. X$`20find_position:
  903. X$`20`20`20if`20cur_line`20.ge.`20dif_start_line`20then`20goto`20skip_changed
  904. X$`20`20`20read`20ifile`20line/end=cleanup
  905. X$`20`20`20write`20ofile`20line
  906. X$`20`20`20cur_line`20=`20cur_line`20+`201
  907. X$`20`20`20goto`20find_position
  908. X$!
  909. X$`20skip_changed:
  910. X$`20`20`20if`20cur_line`20.ge.`20dif_end_line`20then`20goto`20insert_new
  911. X$`20`20`20read`20ifile`20line`20/end=cleanup
  912. X$`20`20`20cur_line`20=`20cur_line`20+`201
  913. X$`20`20`20goto`20skip_changed
  914. X$!
  915. X$`20insert_new:
  916. X$`20`20`20read`20dfile`20dif_line/end=dif_eof
  917. X$`20`20`20col1`20=`20f$extract(0,1,dif_line)
  918. X$`20`20`20if`20col1`20.eqs.`20"-"`20then`20goto`20get_range
  919. X$`20`20`20if`20dif_line`20.eqs.`20"/"`20then`20goto`20dif_eof
  920. X$`20`20`20if`20col1`20.eqs.`20"<"`20then`20dif_line`20=`20dif_line`20-`20col1
  921. X$`20`20`20write`20ofile`20dif_line
  922. X$`20`20`20goto`20insert_new
  923. X$!
  924. X$`20dif_eof:
  925. X$`20`20`20`20read`20ifile`20line/end=cleanup
  926. X$`20`20`20`20write`20ofile`20line
  927. X$`20`20`20`20goto`20dif_eof
  928. X$!
  929. X$`20cleanup:
  930. X$`20`20`20close`20ifile
  931. X$`20`20`20close`20dfile
  932. X$`20`20`20close`20ofile
  933. X$`20`20`20exit
  934. X$!
  935. X$!`20`20error`20exits
  936. X$!
  937. X$`20no_input_file:
  938. X$`20`20`20say`20"Error`20opening`20input`20file"
  939. X$`20`20`20exit
  940. X$!
  941. X$`20no_dif_file:
  942. X$`20EXIT
  943. X$ENDSUBROUTINE
  944. $ call unpack XV_FIXUP_VMS.COM;222 1561868399 ""
  945. $!
  946. $ create 'f'
  947. X%`20-*-LaTeX-*-
  948. X%`20Converted`20automatically`20from`20troff`20to`20LaTeX
  949. X%`20by`20tr2latex`20($Revision:`202.2`20$$Date:`201992/04/27`2015:13:26`20$
  950. V`20by`20C.`20Engel)
  951. X%`20on`20Wed`20Apr`2029`2013:59:18`201992
  952. X%`20tr2latex`20was`20written`20by`20Kamal`20Al-Yahya`20at`20Stanford`20Univers
  953. Vity
  954. X%`20(Kamal%Hanauma@SU-SCORE.ARPA)
  955. X%`20and`20substantially`20enhanced`20by`20Christian`20Engel`20at`20RWTH`20Aach
  956. Ven
  957. X%`20(krischan@informatik.rwth-aachen.de).
  958. X%
  959. X%`20troff`20input`20file:`20xv.man
  960. X
  961. X\documentstyle`5Btroffman,twoside`5D`7Barticle`7D
  962. X\begin`7Bdocument`7D
  963. X%--------------------------------------------------
  964. X%`20start`20of`20input`20file:`20xv.man
  965. X%
  966. X\phead`7Bxv`7D`7Bl`7D`7BFeb`2026,`201992`7D`7BRev:`202.21`7D`7B`7D
  967. X
  968. X\shead`7BNAME`7D
  969. X%
  970. X\bf`20xv`20\rm%
  971. X--`20interactive`20image`20display`20for`20the`20X`20Window`20System
  972. X
  973. X\shead`7BSYNTAX`7D
  974. X%
  975. X\bf`20xv`20\rm%
  976. X%
  977. X\it`20`5Boptions`5D`20`5Bfilename`20`5Bfilename$\ldots$`5D`5D`20\rm%
  978. X
  979. X\shead`7BNOTE`7D
  980. XThis`20man`20page`20is`20merely`20the`20text`20portion`20of`20the`20(PostScrip
  981. Vt)`20%
  982. X`7B\it`20xv`7D
  983. Xdocs,`20
  984. Xwithout
  985. Xthe`20figures,`20and`20without`20the`20appendicies.`20`20As`20such,`20it`20is
  986. V`20highly`20recommended
  987. Xthat`20you`20get`20your`20hands`20on`20the`20*real*`20documentation.
  988. X
  989. X\shead`7BDESCRIPTION`7D
  990. X
  991. X`7B\it`20xv`7D`20is`20an`20X11`20program`20that`20displays`20images`20in`20the
  992. V`20GIF,`20JPEG,`20TIFF,
  993. XPBM,`20PGM,`20PPM,`20X11`20bitmap,`20Utah`20Raster`20Toolkit`20RLE,`20PDS/VICA
  994. VR,`20Sun
  995. XRasterfile,`20and`20PM`20formats`20on`201--,`202--,`204--,`206--,`208--,`2016-
  996. V-,`2024--,`20and
  997. X32--bit`20X`20displays.`20`20`7B\it`20xv`7D`20will`20also`20read`20`7B\it`20co
  998. Vmpress`7D-ed`20versions
  999. Xof`20these`20files.
  1000. X
  1001. X\shead`7BSECTION`201:`20`20OVERVIEW`7D
  1002. X
  1003. X%
  1004. X`7B\it`20xv`7D
  1005. Xversion`202.21`20lets`20you`20do`20a`20large`20number`20of`20things`20(many
  1006. V`20of
  1007. Xthem`20actually`20useful),`20including,`20but`20not`20limited`20to,`20the`20fo
  1008. Vllowing:
  1009. X\begin`7BTPlist`7D`7B$\bullet$`7D
  1010. X\item`5B`7B$\bullet$`7D`5D
  1011. Xdisplay`20an`20image`20in`20a`20window`20on`20the`20screen
  1012. X\item`5B`7B$\bullet$`7D`5D
  1013. Xdisplay`20an`20image`20on`20the`20root`20window,`20in`20a`20variety`20of`20sty
  1014. Vles
  1015. X\item`5B`7B$\bullet$`7D`5D
  1016. Xgrab`20any`20rectangular`20portion`20of`20the`20screen`20and`20turn`20it`20int
  1017. Vo`20an`20image
  1018. X\item`5B`7B$\bullet$`7D`5D
  1019. Xarbitrarily`20stretch`20or`20compress`20the`20image
  1020. X\item`5B`7B$\bullet$`7D`5D
  1021. Xrotate`20the`20image`20in`2090--degree`20steps
  1022. X\item`5B`7B$\bullet$`7D`5D
  1023. Xflip`20the`20image`20around`20the`20horizontal`20or`20vertical`20axes
  1024. X\item`5B`7B$\bullet$`7D`5D
  1025. Xcrop`20a`20rectangular`20portion`20of`20the`20image
  1026. X\item`5B`7B$\bullet$`7D`5D
  1027. Xmagnify`20any`20portion`20of`20the`20image`20by`20any`20amount,`20up`20to`20th
  1028. Ve`20size`20of`20the`20screen
  1029. X\item`5B`7B$\bullet$`7D`5D
  1030. Xdetermine`20pixel`20values`20and`20x,y`20coordinates`20in`20the`20image
  1031. X\item`5B`7B$\bullet$`7D`5D
  1032. Xadjust`20image`20brightness`20and`20contrast`20with`20a`20gamma`20correction
  1033. V`20function
  1034. X\item`5B`7B$\bullet$`7D`5D
  1035. Xapply`20different`20gamma`20functions`20to`20the`20Red,`20Green,`20and`20Blue
  1036. V`20color`20
  1037. Xcomponents,`20to`20correct`20for`20non-linear`20color`20response
  1038. X\item`5B`7B$\bullet$`7D`5D
  1039. Xadjust`20global`20image`20saturation
  1040. X\item`5B`7B$\bullet$`7D`5D
  1041. Xperform`20global`20hue`20remapping
  1042. X\item`5B`7B$\bullet$`7D`5D
  1043. Xperform`20histogram`20equalization
  1044. X\item`5B`7B$\bullet$`7D`5D
  1045. Xedit`20an`20image's`20colormap
  1046. X\item`5B`7B$\bullet$`7D`5D
  1047. Xreduce`20the`20number`20of`20colors`20in`20an`20image
  1048. X\item`5B`7B$\bullet$`7D`5D
  1049. Xdither`20in`20color`20and`20b\`26w
  1050. X\item`5B`7B$\bullet$`7D`5D
  1051. Xsmooth`20an`20image
  1052. X\item`5B`7B$\bullet$`7D`5D
  1053. Xcrop`20off`20solid`20borders`20automatically
  1054. X\item`5B`7B$\bullet$`7D`5D
  1055. Xconvert`20image`20formats
  1056. X\item`5B`7B$\bullet$`7D`5D
  1057. Xgenerate`20Encapsulated`20PostScript
  1058. X\end`7BTPlist`7D
  1059. X
  1060. X\noindent
  1061. XUnfortunately`20the`20%
  1062. X\it`20Automatic`20Checkbook`20Balancing`20Module`20\rm%
  1063. Xstill`20isn't`20
  1064. Xcompletely`20debugged,`20and`20is`20not`20included`20in`20this`20distribution.
  1065. V`20
  1066. X
  1067. X\shead`7BSECTION`202:`20STARTING`20XV`20`7D
  1068. X
  1069. XNote:`20unless`20explicitly`20stated`20otherwise,`20the`20term`20%
  1070. X\it`20click`20\rm%
  1071. Xmeans`20`60`60click
  1072. Xwith`20the`20%
  1073. X\it`20Left`20\rm%
  1074. Xmouse`20button.''
  1075. X
  1076. XStart`20the`20program`20up`20by`20typing`20'xv'.`20`20After`20a`20short`20dela
  1077. Vy,`20a`20window`20will
  1078. Xappear`20with`20the`20default`20image`20(the`20%
  1079. X`7B\it`20xv`7D
  1080. Xlogo,`20credits`20and`20revision`20date)
  1081. Xdisplayed`20in`20it.`20`20If`20you`20change`20the`20size`20of`20the`20window
  1082. V`20(using`20whatever`20method
  1083. Xyour`20window`20manager`20provides),`20the`20image`20will`20be`20automatically
  1084. V`20stretched`20to
  1085. Xfit`20the`20window.
  1086. X
  1087. X\shead`7BSection`202.1:`20`20Displaying`20Pixel`20Values`7D
  1088. X
  1089. XClicking`20(and`20optionally`20dragging)`20the`20%
  1090. X\it`20Left`20\rm%
  1091. Xmouse`20button`20inside`20this`20
  1092. Xwindow`20will`20display`20pixel`20information`20in`20the`20following`20format:
  1093. V
  1094. X\begin`7BIPlist`7D
  1095. X\IPitem`7B`7B`7D`7D
  1096. X196,`20137`20=`20191,121,209`20(287`2042`2081`20HSV)
  1097. X\end`7BIPlist`7D
  1098. X
  1099. X\noindent
  1100. XThe`20first`20pair`20of`20numbers`20(196,137)`20are`20the`20x`20and`20y`20posi
  1101. Vtions`20of`20the`20cursor,
  1102. Xin`20image`20coordinates.`20`20These`20numbers`20remain`20the`20same`20regardl
  1103. Vess`20of`20any`20image
  1104. Xresizing,`20or`20cropping.`20`20For`20example,`20if`20you`20click`20on`20the
  1105. V`20eye`20of`20the`20fish`20on
  1106. Xthe`20right`20side`20of`20the`20default`20image,`20you'll`20get`20(approximate
  1107. Vly)`20251,129
  1108. Xregardless`20of`20the`20size`20of`20the`20displayed`20image.`20`20This`20allow
  1109. Vs`20you`20to`20zoom`20in
  1110. Xfor`20precise`20measurements.
  1111. X
  1112. XThe`20first`20triplet`20of`20numbers`20(191,121,209)`20are`20the`20RGB`20value
  1113. Vs`20of`20the`20selected
  1114. Xpixel.`20`20The`20components`20will`20have`20integer`20values`20in`20the`20ran
  1115. Vge`200--255.`20`20The
  1116. Xvalues`20displayed`20are`20prior`20to`20any`20HSV/RGB`20modification,`20but
  1117. V`20after`20any
  1118. Xcolormap`20changes.`20`20See`20`60`60Section`205:`20The`20Color`20Editor''`20f
  1119. Vor`20details.
  1120. X
  1121. XThe`20second`20triplet`20of`20numbers`20(287`2042`2081)`20are`20the`20HSV`20va
  1122. Vlues`20of`20the`20selected
  1123. Xpixel.`20`20The`20first`20component`20will`20have`20integer`20values`20in`20th
  1124. +-+-+-+-+-+-+-+-  END  OF PART 4 +-+-+-+-+-+-+-+-
  1125.