3 jpg, gif, png, ppm, bmp, yuv, ico, togif, toppm, topng, toico \- view and convert pictures
95 These programs read, display, and write image files in public formats.
103 read files in the corresponding formats and, by default, display
104 them in the current window; options cause them instead to convert the images
105 to Plan 9 image format and write them to standard output.
110 read Plan 9 images files, convert them to GIF, PPM, or PNG, and write them to standard output.
112 The default behavior of
119 or standard input if no file is named.
120 Once a file is displayed, typing a character causes the program to display the next image.
123 DEL, or control-D exits the program.
124 For a more user-friendly interface, use
126 which invokes these programs to convert the images to standard format,
127 displays them, and offers scrolling, panning, and menu-driven navigation among the files.
129 These programs share many options:
132 Disable Floyd-Steinberg error diffusion, which is used to improve the appearance
133 of images on color-mapped displays, typically with 8 bits per pixel.
134 Primarily useful for debugging; if the display has true RGB color, the image
135 will be displayed in full glory.
138 Convert and display the image as a black and white (really grey-scale) image.
141 Convert the image to an RGBV color-mapped image, even if the
142 display has true RGB color.
145 Suppress display of the image; this is set automatically by
146 any of the following options:
149 Convert the image to a Plan 9 representation, as defined by
151 and write it to standard output.
156 but produce an uncompressed image.
157 This saves processing time, particularly when the output is
158 being piped to another program such as
160 since it avoids compression and decompression.
163 Convert the image, if it is in color, to a true color RGB image.
168 but force the image to RGB even if it is originally grey-scale.
172 has two extra options used to process the output of the LML
176 Merge two adjacent images, which represent the two fields of a video picture,
180 The input is a motion JPEG file, with multiple images representing frames of the movie. Sets
188 programs go the other way: they convert from Plan 9 images to GIF and PPM,
189 and have no display capability.
190 Both accept an option
192 to set the comment field of the resulting file.
193 If there is only one input picture,
195 converts the image to GIF format.
198 though, it will assemble them into an animated GIF file.
199 The options control this process:
202 By default, the animation will loop forever;
204 specifies how many times to loop.
205 A value of zero means loop forever and a negative value means
206 to stop after playing the sequence once.
209 By default, the images are displayed as fast as they can be rendered.
210 This option specifies the time, in milliseconds, to pause while
211 displaying the next named
215 translates files that contain a `transparency' index by attaching
216 an alpha channel to the converted image.
219 displays a Windows icon (.ico) file. If no file is
222 reads from standard input.
224 contain sets of icons represeted by an image and a mask.
225 Clicking the right button pops up a menu that lets you
226 write any icon's image as a Plan 9 image (\fIwidth\fBx\fIheight\fB.image),
227 write any icon's mask as a Plan 9 image (\fIwidth\fBx\fIheight\fB.mask),
228 or exit. Selecting one of the write menu items yields a sight cursor.
229 Move the sight over the icon and right click again to write.
232 takes a list of Plan 9 image files (or standard input) and creates
233 a single icon file. The masks in the icon file will be the white
234 space in the image. The icon file is written to standard output.
241 Writing an animated GIF using
243 is a clumsy undertaking.