jpg.1 (4846B)
1 .TH JPG 1 2 .SH NAME 3 jpg, gif, png, ppm, bmp, yuv, ico, togif, toppm, topng, toico \- view and convert pictures 4 .SH SYNOPSIS 5 .B jpg 6 [ 7 .B -39cdefFkJrtv 8 ] [ 9 .I file ... 10 ] 11 .br 12 .B gif 13 [ 14 .B -39cdektv 15 ] [ 16 .I file ... 17 ] 18 .br 19 .B png 20 [ 21 .B -39cdektv 22 ] [ 23 .I file ... 24 ] 25 .br 26 .B ppm 27 [ 28 .B -39cdektv 29 ] [ 30 .I file ... 31 ] 32 .br 33 .B bmp 34 [ 35 .I file 36 ] 37 .br 38 .B yuv 39 [ 40 .I file 41 ] 42 .PP 43 .B togif 44 [ 45 .B -c 46 .I comment 47 ] [ 48 .B -l 49 .I loopcount 50 ] [ 51 .B -d 52 .I msec 53 ] [ 54 .B -t 55 .I transindex 56 ] [ 57 .I file ... 58 [ 59 .B -d 60 .I msec 61 ] 62 .I file ... 63 ] 64 .br 65 .B toppm 66 [ 67 .B -c 68 .I comment 69 ] [ 70 .I file 71 ] 72 .br 73 .B topng 74 [ 75 .B -c 76 .I comment 77 ] [ 78 [ 79 .B -g 80 .I gamma 81 ] [ 82 .I file 83 ] 84 .PP 85 .B ico 86 [ 87 .I file 88 ] 89 .br 90 .B toico 91 [ 92 .I file ... 93 ] 94 .SH DESCRIPTION 95 These programs read, display, and write image files in public formats. 96 .IR Jpg , 97 .IR gif , 98 .IR png , 99 .IR ppm , 100 .IR bmp , 101 and 102 .IR yuv . 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. 106 .IR Togif , 107 .IR Toppm , 108 and 109 .I topng 110 read Plan 9 images files, convert them to GIF, PPM, or PNG, and write them to standard output. 111 .PP 112 The default behavior of 113 .IR jpg , 114 .IR gif , 115 and 116 .IR ppm 117 is to display the 118 .IR file , 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. 121 Typing a 122 .BR q , 123 DEL, or control-D exits the program. 124 For a more user-friendly interface, use 125 .MR page (1) , 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. 128 .PP 129 These programs share many options: 130 .TP 131 .B -e 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. 136 .TP 137 .B -k 138 Convert and display the image as a black and white (really grey-scale) image. 139 .TP 140 .B -v 141 Convert the image to an RGBV color-mapped image, even if the 142 display has true RGB color. 143 .TP 144 .B -d 145 Suppress display of the image; this is set automatically by 146 any of the following options: 147 .TP 148 .B -c 149 Convert the image to a Plan 9 representation, as defined by 150 .MR image (7) , 151 and write it to standard output. 152 .TP 153 .B -9 154 Like 155 .BR -c , 156 but produce an uncompressed image. 157 This saves processing time, particularly when the output is 158 being piped to another program such as 159 .MR page (1) , 160 since it avoids compression and decompression. 161 .TP 162 .B -t 163 Convert the image, if it is in color, to a true color RGB image. 164 .TP 165 .B -3 166 Like 167 .BR -t , 168 but force the image to RGB even if it is originally grey-scale. 169 .PD 170 .PP 171 .I Jpg 172 has two extra options used to process the output of the LML 173 video card: 174 .TP 175 .B -f 176 Merge two adjacent images, which represent the two fields of a video picture, 177 into a single image. 178 .TP 179 .B -F 180 The input is a motion JPEG file, with multiple images representing frames of the movie. Sets 181 .BR -f . 182 .PD 183 .PP 184 The 185 .IR togif 186 and 187 .IR toppm 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 191 .B -c 192 to set the comment field of the resulting file. 193 If there is only one input picture, 194 .I togif 195 converts the image to GIF format. 196 If there are many 197 .IR files , 198 though, it will assemble them into an animated GIF file. 199 The options control this process: 200 .TP 201 .BI -l loopcount 202 By default, the animation will loop forever; 203 .I loopcount 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. 207 .TP 208 .BI -d msec 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 212 .IR file . 213 .PP 214 .I Gif 215 translates files that contain a `transparency' index by attaching 216 an alpha channel to the converted image. 217 .PP 218 .I Ico 219 displays a Windows icon (.ico) file. If no file is 220 specified, 221 .I ico 222 reads from standard input. 223 Icon files 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. 230 .PP 231 .I Toico 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. 235 .SH SOURCE 236 .B \*9/src/cmd/jpg 237 .SH "SEE ALSO" 238 .MR page (1) , 239 .MR image (7) . 240 .SH BUGS 241 Writing an animated GIF using 242 .I togif 243 is a clumsy undertaking.