3 058b0118 2005-01-03 devnull jpg, gif, png, ppm, bmp, yuv, ico, togif, toppm, topng, toico \- view and convert pictures
4 058b0118 2005-01-03 devnull .SH SYNOPSIS
7 058b0118 2005-01-03 devnull .B -39cdefFkJrtv
9 058b0118 2005-01-03 devnull .I file ...
14 058b0118 2005-01-03 devnull .B -39cdektv
16 058b0118 2005-01-03 devnull .I file ...
21 058b0118 2005-01-03 devnull .B -39cdektv
23 058b0118 2005-01-03 devnull .I file ...
28 058b0118 2005-01-03 devnull .B -39cdektv
30 058b0118 2005-01-03 devnull .I file ...
46 058b0118 2005-01-03 devnull .I comment
49 058b0118 2005-01-03 devnull .I loopcount
55 058b0118 2005-01-03 devnull .I transindex
57 058b0118 2005-01-03 devnull .I file ...
62 058b0118 2005-01-03 devnull .I file ...
68 058b0118 2005-01-03 devnull .I comment
76 058b0118 2005-01-03 devnull .I comment
92 058b0118 2005-01-03 devnull .I file ...
94 058b0118 2005-01-03 devnull .SH DESCRIPTION
95 058b0118 2005-01-03 devnull These programs read, display, and write image files in public formats.
96 058b0118 2005-01-03 devnull .IR Jpg ,
97 058b0118 2005-01-03 devnull .IR gif ,
98 058b0118 2005-01-03 devnull .IR png ,
99 058b0118 2005-01-03 devnull .IR ppm ,
100 058b0118 2005-01-03 devnull .IR bmp ,
102 058b0118 2005-01-03 devnull .IR yuv .
103 058b0118 2005-01-03 devnull read files in the corresponding formats and, by default, display
104 058b0118 2005-01-03 devnull them in the current window; options cause them instead to convert the images
105 058b0118 2005-01-03 devnull to Plan 9 image format and write them to standard output.
106 058b0118 2005-01-03 devnull .IR Togif ,
107 058b0118 2005-01-03 devnull .IR Toppm ,
109 058b0118 2005-01-03 devnull .I topng
110 058b0118 2005-01-03 devnull read Plan 9 images files, convert them to GIF, PPM, or PNG, and write them to standard output.
112 058b0118 2005-01-03 devnull The default behavior of
113 058b0118 2005-01-03 devnull .IR jpg ,
114 058b0118 2005-01-03 devnull .IR gif ,
117 058b0118 2005-01-03 devnull is to display the
118 058b0118 2005-01-03 devnull .IR file ,
119 058b0118 2005-01-03 devnull or standard input if no file is named.
120 058b0118 2005-01-03 devnull Once a file is displayed, typing a character causes the program to display the next image.
121 058b0118 2005-01-03 devnull Typing a
123 058b0118 2005-01-03 devnull DEL, or control-D exits the program.
124 058b0118 2005-01-03 devnull For a more user-friendly interface, use
125 058b0118 2005-01-03 devnull .IR page (1),
126 058b0118 2005-01-03 devnull which invokes these programs to convert the images to standard format,
127 058b0118 2005-01-03 devnull displays them, and offers scrolling, panning, and menu-driven navigation among the files.
129 058b0118 2005-01-03 devnull These programs share many options:
132 058b0118 2005-01-03 devnull Disable Floyd-Steinberg error diffusion, which is used to improve the appearance
133 058b0118 2005-01-03 devnull of images on color-mapped displays, typically with 8 bits per pixel.
134 058b0118 2005-01-03 devnull Primarily useful for debugging; if the display has true RGB color, the image
135 058b0118 2005-01-03 devnull will be displayed in full glory.
138 058b0118 2005-01-03 devnull Convert and display the image as a black and white (really grey-scale) image.
141 058b0118 2005-01-03 devnull Convert the image to an RGBV color-mapped image, even if the
142 058b0118 2005-01-03 devnull display has true RGB color.
145 058b0118 2005-01-03 devnull Suppress display of the image; this is set automatically by
146 058b0118 2005-01-03 devnull any of the following options:
149 058b0118 2005-01-03 devnull Convert the image to a Plan 9 representation, as defined by
150 058b0118 2005-01-03 devnull .IR image (7),
151 058b0118 2005-01-03 devnull and write it to standard output.
155 058b0118 2005-01-03 devnull .BR -c ,
156 058b0118 2005-01-03 devnull but produce an uncompressed image.
157 058b0118 2005-01-03 devnull This saves processing time, particularly when the output is
158 058b0118 2005-01-03 devnull being piped to another program such as
159 058b0118 2005-01-03 devnull .IR page (1),
160 058b0118 2005-01-03 devnull since it avoids compression and decompression.
163 058b0118 2005-01-03 devnull Convert the image, if it is in color, to a true color RGB image.
167 058b0118 2005-01-03 devnull .BR -t ,
168 058b0118 2005-01-03 devnull but force the image to RGB even if it is originally grey-scale.
172 058b0118 2005-01-03 devnull has two extra options used to process the output of the LML
173 058b0118 2005-01-03 devnull video card:
176 058b0118 2005-01-03 devnull Merge two adjacent images, which represent the two fields of a video picture,
177 058b0118 2005-01-03 devnull into a single image.
180 058b0118 2005-01-03 devnull The input is a motion JPEG file, with multiple images representing frames of the movie. Sets
181 058b0118 2005-01-03 devnull .BR -f .
185 058b0118 2005-01-03 devnull .IR togif
187 058b0118 2005-01-03 devnull .IR toppm
188 058b0118 2005-01-03 devnull programs go the other way: they convert from Plan 9 images to GIF and PPM,
189 058b0118 2005-01-03 devnull and have no display capability.
190 058b0118 2005-01-03 devnull Both accept an option
192 058b0118 2005-01-03 devnull to set the comment field of the resulting file.
193 058b0118 2005-01-03 devnull If there is only one input picture,
194 058b0118 2005-01-03 devnull .I togif
195 058b0118 2005-01-03 devnull converts the image to GIF format.
196 058b0118 2005-01-03 devnull If there are many
197 058b0118 2005-01-03 devnull .IR files ,
198 058b0118 2005-01-03 devnull though, it will assemble them into an animated GIF file.
199 058b0118 2005-01-03 devnull The options control this process:
201 058b0118 2005-01-03 devnull .BI -l loopcount
202 058b0118 2005-01-03 devnull By default, the animation will loop forever;
203 058b0118 2005-01-03 devnull .I loopcount
204 058b0118 2005-01-03 devnull specifies how many times to loop.
205 058b0118 2005-01-03 devnull A value of zero means loop forever and a negative value means
206 058b0118 2005-01-03 devnull to stop after playing the sequence once.
208 058b0118 2005-01-03 devnull .BI -d msec
209 058b0118 2005-01-03 devnull By default, the images are displayed as fast as they can be rendered.
210 058b0118 2005-01-03 devnull This option specifies the time, in milliseconds, to pause while
211 058b0118 2005-01-03 devnull displaying the next named
212 058b0118 2005-01-03 devnull .IR file .
215 058b0118 2005-01-03 devnull translates files that contain a `transparency' index by attaching
216 058b0118 2005-01-03 devnull an alpha channel to the converted image.
219 058b0118 2005-01-03 devnull displays a Windows icon (.ico) file. If no file is
220 058b0118 2005-01-03 devnull specified,
222 058b0118 2005-01-03 devnull reads from standard input.
223 058b0118 2005-01-03 devnull Icon files
224 058b0118 2005-01-03 devnull contain sets of icons represeted by an image and a mask.
225 058b0118 2005-01-03 devnull Clicking the right button pops up a menu that lets you
226 058b0118 2005-01-03 devnull write any icon's image as a Plan 9 image (\fIwidth\fBx\fIheight\fB.image),
227 058b0118 2005-01-03 devnull write any icon's mask as a Plan 9 image (\fIwidth\fBx\fIheight\fB.mask),
228 058b0118 2005-01-03 devnull or exit. Selecting one of the write menu items yields a sight cursor.
229 058b0118 2005-01-03 devnull Move the sight over the icon and right click again to write.
231 058b0118 2005-01-03 devnull .I Toico
232 058b0118 2005-01-03 devnull takes a list of Plan 9 image files (or standard input) and creates
233 058b0118 2005-01-03 devnull a single icon file. The masks in the icon file will be the white
234 058b0118 2005-01-03 devnull space in the image. The icon file is written to standard output.
235 058b0118 2005-01-03 devnull .SH SOURCE
236 c3674de4 2005-01-11 devnull .B \*9/src/cmd/jpg
237 058b0118 2005-01-03 devnull .SH "SEE ALSO"
238 058b0118 2005-01-03 devnull .IR page (1),
239 058b0118 2005-01-03 devnull .IR image (7).
240 058b0118 2005-01-03 devnull .SH BUGS
241 058b0118 2005-01-03 devnull Writing an animated GIF using
242 058b0118 2005-01-03 devnull .I togif
243 058b0118 2005-01-03 devnull is a clumsy undertaking.