1.. -*- mode: rst -*- 2.. This text is in reStucturedText format, so it may look a bit odd. 3.. See http://docutils.sourceforge.net/rst.html for details. 4 5================================ 6GraphicsMagick Supported Formats 7================================ 8 9.. _animate : animate.html 10.. _composite : composite.html 11.. _compare : compare.html 12.. _conjure : conjure.html 13.. _convert : convert.html 14.. _display : display.html 15.. _identify : identify.html 16.. _import : import.html 17.. _mogrify : mogrify.html 18.. _montage : montage.html 19 20.. _AVI : http://www.jmcgowan.com/avi.html 21.. _BMP : http://www.fileformat.info/format/bmp/egff.htm 22.. _color : color.html 23.. _CALS : http://www.fileformat.info/format/cals/egff.htm 24.. _CGM : http://www.fileformat.info/format/cgm/egff.htm 25.. _CIN : motion-picture.html 26.. _DICOM : http://dicom.nema.org/ 27.. _DICONDE : http://www.geinspectiontechnologies.com/en/products/software/diconde.html 28.. _DPX : motion-picture.html 29.. _FIG : foo.bar 30.. _FITS : http://www.cv.nrao.edu/fits/ 31.. _Ghostscript : http://pages.cs.wisc.edu/~ghost/ 32.. _GIF : http://www.fileformat.info/format/gif/egff.htm 33.. _`Hald CLUT` : http://www.quelsolaar.com/technology/clut.html 34.. _JBIG : http://www.jpeg.org/ 35.. _JNG : http://www.libmng.com/ 36.. _JPEG : http://www.jpeg.org/ 37.. _M2V : http://www.mpeg.org/ 38.. _MIFF : miff.html 39.. _MNG : http://www.libmng.com/ 40.. _MPEG : http://www.mpeg.org/ 41.. _MTV : http://www.fileformat.info/format/mtv/egff.htm 42.. _MathWorks : http://www.mathworks.com/ 43.. _PAM : http://netpbm.sourceforge.net/doc/pam.html 44.. _PBM : http://www.fileformat.info/format/pbm/egff.htm 45.. _PCX : http://www.fileformat.info/format/pcx/egff.htm 46.. _PWP : http://www.photoworks.com/ 47.. _README : README.html 48.. _Radiance : http://radsite.lbl.gov/radiance/HOME.html 49.. _SANE : http://www.mostang.com/sane/ 50.. _SCT : http://oreilly.com/www/centers/gff/formats/scitex/ 51.. _SFW : http://www.algonet.se/~cyren/sfw/ 52.. _SMPTE : http://www.smpte.org/ 53.. _SVG : http://www.w3.org/Graphics/SVG/ 54.. _TIFF : http://www.simplesystems.org/libtiff/ 55.. _TopoL : http://www.topol.cz/english/share/index.php3 56.. _VIFF: http://www.fileformat.info/format/viff/egff.htm 57.. _WBMP : http://www.openmobilealliance.org/Technical/wapindex.aspx 58.. _WMF : http://www.fileformat.info/format/wmf/egff.htm 59.. _WPG : http://www.fileformat.info/format/wpg/egff.htm 60.. _XBM : http://www.fileformat.info/format/xbm/egff.htm 61.. _XPM : http://www.fileformat.info/format/xpm/egff.htm 62.. _XWD : http://www.fileformat.info/format/xwd/egff.htm 63.. _freetype2 : http://www.freetype.org/ 64.. _hp2xx : http://www.gnu.org/software/hp2xx/hp2xx.html 65.. _html2ps : http://user.it.uu.se/~jan/ 66.. _jasper : http://www.ece.uvic.ca/~mdadams/jasper/ 67.. _jbigkit : http://www.cl.cam.ac.uk/~mgk25/jbigkit/ 68.. _libxml2 : http://xmlsoft.org/ 69.. _mpeg2vidcodec : foo.bar 70.. _ralcgm : http://www.agocg.ac.uk/train/cgm/ralcgm.htm 71 72GraphicsMagick uses an ASCII string known as "magick" (e.g. "GIF") to 73identify file formats, algorithms acting as formats, built-in images, and 74embedded profile types. After a file has been read or "pinged", the 75associated magick string is stored in the "magick" member of the Image 76structure, and is reported in the default output of 'gm identify'. 77 78 79GraphicsMagick supports reading over 88 major file formats (not including 80sub-formats). The following table provides a summary of the supported 81image formats. 82 83.. table:: Supported Image Formats 84 85 +--------------+------+---------------------------+--------------------------------------------------+ 86 | Format | Mode | Description | Notes | 87 +--------------+------+---------------------------+--------------------------------------------------+ 88 | | | | Format originally used on the Macintosh | 89 | ART | RW | PFS: 1st Publisher | (MacPaint?) and later used for PFS: 1st | 90 | | | | Publisher clip art. | 91 +--------------+------+---------------------------+--------------------------------------------------+ 92 | AVS | RW | AVS X image | | 93 +--------------+------+---------------------------+--------------------------------------------------+ 94 | BMP_ | RW | Microsoft Windows bitmap | | 95 +--------------+------+---------------------------+--------------------------------------------------+ 96 | CALS_ | R | Continuous Acquisition | Specified in MIL-R-28002 and MIL-PRF-28002. | 97 | | | and Life-cycle Support | Standard blueprint archive format as used by the | 98 | | | Type 1 image | US military to replace microfiche. | 99 +--------------+------+---------------------------+--------------------------------------------------+ 100 | CIN_ | R | Kodak Cineon | Kodak Cineon Log format (4.5 draft). | 101 | | | | Precursor to SMPTE DPX_ | 102 +--------------+------+---------------------------+--------------------------------------------------+ 103 | CGM_ | R | Computer Graphics | Requires ralcgm_ to render CGM files. | 104 | | | Metafile | | 105 +--------------+------+---------------------------+--------------------------------------------------+ 106 | CMYK | RW | Raw cyan, magenta, | Use -size, -depth, -endian, and -interlace to | 107 | | | yellow, and black samples | specify the image width, height, depth, byte | 108 | | | | order, and interlace. | 109 +--------------+------+---------------------------+--------------------------------------------------+ 110 | CUR | R | Microsoft Cursor Icon | | 111 +--------------+------+---------------------------+--------------------------------------------------+ 112 | CUT | R | DR Halo | | 113 +--------------+------+---------------------------+--------------------------------------------------+ 114 | | | Digital Imaging and | Used by the medical community for images like | 115 | DCM | R | Communications in | X-rays. See the NEMA DICOM_ web site for more | 116 | | | Medicine (DICOM_) image | information. DICOM_ is the basis for the | 117 | | | | DICONDE_ format. | 118 +--------------+------+---------------------------+--------------------------------------------------+ 119 | DCX | RW | ZSoft IBM PC multi-page | | 120 | | | Paintbrush image | | 121 +--------------+------+---------------------------+--------------------------------------------------+ 122 | | | Microsoft Windows Device | DIB is a BMP file without the BMP header. Used | 123 | DIB | RW | Independent Bitmap | to support embedded images in compound formats | 124 | | | | like WMF. | 125 +--------------+------+---------------------------+--------------------------------------------------+ 126 | | | | RGB and grayscale are fully supported at 1, 8, | 127 | | | | 10, 12, and 16 bits as per the SMPTE_ 268M-2003 | 128 | | | | (V2.0) specification. This includes support for | 129 | DPX_ | RW | Digital Moving Picture | images stored in a planar (multi-element) | 130 | | | Exchange | configuration and Cineon Log RGB. Rec. 601 and | 131 | | | | 709 YCbCr are fully supported with 4:4:4 and | 132 | | | | 4:2:2 subsampling. DPX_ is commonly used to | 133 | | | | store image frames in film and HDTV production. | 134 +--------------+------+---------------------------+--------------------------------------------------+ 135 | EMF | R | Microsoft Enhanced | Only available under Microsoft Windows. | 136 | | | Metafile (32-bit) | | 137 +--------------+------+---------------------------+--------------------------------------------------+ 138 | EPDF | RW | Encapsulated Portable | | 139 | | | Document Format | | 140 +--------------+------+---------------------------+--------------------------------------------------+ 141 | | | Adobe Encapsulated | | 142 | EPI | RW | PostScript Interchange | Requires Ghostscript_ to read. | 143 | | | format | | 144 +--------------+------+---------------------------+--------------------------------------------------+ 145 | EPS | RW | Adobe Encapsulated | Requires Ghostscript_ to read. | 146 | | | PostScript | | 147 +--------------+------+---------------------------+--------------------------------------------------+ 148 | EPS2 | W | Adobe Level II | Requires Ghostscript_ to read. | 149 | | | Encapsulated PostScript | | 150 +--------------+------+---------------------------+--------------------------------------------------+ 151 | EPS3 | W | Adobe Level III | Requires Ghostscript_ to read. | 152 | | | Encapsulated PostScript | | 153 +--------------+------+---------------------------+--------------------------------------------------+ 154 | EPSF | RW | Adobe Encapsulated | Requires Ghostscript_ to read. | 155 | | | PostScript | | 156 +--------------+------+---------------------------+--------------------------------------------------+ 157 | | | Adobe Encapsulated | | 158 | EPSI | RW | PostScript Interchange | Requires Ghostscript_ to read. | 159 | | | format | | 160 +--------------+------+---------------------------+--------------------------------------------------+ 161 | | | Adobe Encapsulated | | 162 | EPT | RW | PostScript Interchange | Requires Ghostscript_ to read. | 163 | | | format with TIFF_ preview | | 164 +--------------+------+---------------------------+--------------------------------------------------+ 165 | | | | Note that FAX machines use non-square pixels | 166 | | | | which are 1.5 times wider than they are tall but | 167 | | | | computer displays use square pixels, so FAX | 168 | FAX | RW | Group 3 FAX | images may appear to be narrow unless they are | 169 | | | | explicitly resized using a resize specification | 170 | | | | of "150x100%". Please note that this is *not* a | 171 | | | | TIFF_ format. | 172 +--------------+------+---------------------------+--------------------------------------------------+ 173 | FIG | R | FIG graphics format | Requires TransFig. | 174 +--------------+------+---------------------------+--------------------------------------------------+ 175 | FITS_ | RW | Flexible Image Transport | | 176 | | | System | | 177 +--------------+------+---------------------------+--------------------------------------------------+ 178 | FPX | RW | FlashPix Format | Requires FlashPix SDK. | 179 +--------------+------+---------------------------+--------------------------------------------------+ 180 | | | | 8-bit RGB PseudoColor with up to 256 palette | 181 | | | | entires. Specify the format "GIF87" to write the | 182 | | | CompuServe Graphics | older version 87a of the format. | 183 | GIF_ | RW | Interchange Format | | 184 | | | | The PNG format provides a superior set of | 185 | | | | features to GIF. Consider using PNG format | 186 | | | | rather than GIF if clients are able to read PNG. | 187 +--------------+------+---------------------------+--------------------------------------------------+ 188 | GRAY | RW | Raw gray samples | Use -size, -depth, and -endian to specify the | 189 | | | | image width, height, depth, and byte order. | 190 +--------------+------+---------------------------+--------------------------------------------------+ 191 | GRAYA | RW | Raw gray samples + alpha | Use -size, -depth, and -endian to specify the | 192 | | | | image width, height, depth, and byte order. | 193 +--------------+------+---------------------------+--------------------------------------------------+ 194 | HPGL | R | HP-GL plotter language | Requires hp2xx_ 3.2.0 or later | 195 +--------------+------+---------------------------+--------------------------------------------------+ 196 | | | Hypertext Markup Language | | 197 | HTML | RW | with a client-side image | Also known as "HTM". Requires html2ps to read. | 198 | | | map | | 199 +--------------+------+---------------------------+--------------------------------------------------+ 200 | ICO | R | Microsoft icon | Also known as "ICON". | 201 +--------------+------+---------------------------+--------------------------------------------------+ 202 | | | Joint Bi-level Image | Also known as "BIE" and "JBG". Requires | 203 | JBIG_ | RW | experts Group file | jbigkit_ 1.0 or later | 204 | | | interchange format | | 205 +--------------+------+---------------------------+--------------------------------------------------+ 206 | | | | JPEG_ in a PNG-style wrapper with transparency. | 207 | JNG_ | RW | JPEG_ Network Graphics | Requires libjpeg and libpng-1.0.2 or later, | 208 | | | | libpng-1.2.5 or later recommended. | 209 +--------------+------+---------------------------+--------------------------------------------------+ 210 | JP2 | RW | JPEG-2000 JP2 File Format | Requires jasper_ 1.600.0 or later | 211 | | | Syntax | | 212 +--------------+------+---------------------------+--------------------------------------------------+ 213 | JPC | RW | JPEG-2000 Code Stream | Requires jasper_ 1.600.0 or later | 214 | | | Syntax | | 215 +--------------+------+---------------------------+--------------------------------------------------+ 216 | JPEG_ | RW | Joint Photographic | Requires jpegsrc.v6b.tar.gz | 217 | | | Experts Group JFIF format | | 218 +--------------+------+---------------------------+--------------------------------------------------+ 219 | MAN | R | Unix reference manual | Requires that GNU groff and Ghostcript are | 220 | | | pages | installed. | 221 +--------------+------+---------------------------+--------------------------------------------------+ 222 | | | | Coming from MathWorks_ for storing matrices. | 223 | | | | Currently supported types are 2D matrices: byte, | 224 | MAT | RW | MATLAB image format | word, double, complex and 3D matrices containing | 225 | | | | RGB [x*y*3] byte, word. | 226 +--------------+------+---------------------------+--------------------------------------------------+ 227 | | | | ImageMagick's lossless image format (with | 228 | MIFF_ | RW | Magick image file format | ASCII header) which ensures that no image | 229 | | | | attributes understood by ImageMagick or | 230 | | | | GraphicsMagick are lost. | 231 +--------------+------+---------------------------+--------------------------------------------------+ 232 | | | Bi-level bitmap in | | 233 | MONO | RW | least-significant-byte | | 234 | | | first order | | 235 +--------------+------+---------------------------+--------------------------------------------------+ 236 | MNG_ | RW | Multiple-image Network | Requires libpng-1.0.2 or later, libpng-1.2.5 or | 237 | | | Graphics | later recommended. | 238 +--------------+------+---------------------------+--------------------------------------------------+ 239 | | | Motion Picture Experts | | 240 | MPEG_ | RW | Group file interchange | Requires mpeg2vidcodec_v12.tar.gz. | 241 | | | format (version 1) | | 242 +--------------+------+---------------------------+--------------------------------------------------+ 243 | | | Motion Picture Experts | | 244 | M2V_ | RW | Group file interchange | Requires mpeg2vidcodec_v12.tar.gz. | 245 | | | format (version 2) | | 246 +--------------+------+---------------------------+--------------------------------------------------+ 247 | | | | The native "in-memory" GraphicsMagick | 248 | | | | uncompressed file format. This file format is | 249 | | | | identical to that used by Open ImageMagick to | 250 | | | | represent images in memory and is read in "zero | 251 | | | | time" via memory mapping. The MPC format is not | 252 | | | | portable and is not suitable as an archive | 253 | | | | format. It is suitable as an intermediate format | 254 | | | Magick Persistent Cache | for high-performance image processing. | 255 | MPC | RW | image file format | | 256 | | | | The MPC format requires two files to support one | 257 | | | | image. When writing the MPC format, a file with | 258 | | | | extension ".mpc" is used to store information | 259 | | | | about the image, while a file with extension | 260 | | | | ``.cache`` stores the image pixels. The storage | 261 | | | | space required by a MPC image (or an image in | 262 | | | | memory) may be calculated by the equation | 263 | | | | (QuantumDepth*Rows*Columns*5)/8. | 264 +--------------+------+---------------------------+--------------------------------------------------+ 265 | MSL | RW | Magick Scripting Language | MSL is the XML-based scripting language | 266 | | | | supported by the conjure utility. | 267 +--------------+------+---------------------------+--------------------------------------------------+ 268 | MTV_ | RW | MTV Raytracing image | | 269 | | | format | | 270 +--------------+------+---------------------------+--------------------------------------------------+ 271 | | | | The native GraphicsMagick vector metafile | 272 | MVG | RW | Magick Vector Graphics. | format. A text file containing vector drawing | 273 | | | | commands accepted by convert_'s -draw option. | 274 +--------------+------+---------------------------+--------------------------------------------------+ 275 | OTB | RW | On-the-air Bitmap | | 276 +--------------+------+---------------------------+--------------------------------------------------+ 277 | P7 | RW | Xv's Visual Schnauzer | | 278 | | | thumbnail format | | 279 +--------------+------+---------------------------+--------------------------------------------------+ 280 | PALM | RW | Palm pixmap | | 281 +--------------+------+---------------------------+--------------------------------------------------+ 282 | PAM_ | RW | Portable Arbitrary Map | Superset of PNM (PPM, PGM, PPM) raw type formats.| 283 | | | format | Supports bilevel, gray, RGB, CMYK, alpha channel.| 284 +--------------+------+---------------------------+--------------------------------------------------+ 285 | PBM_ | RW | Portable bitmap format | | 286 | | | (black and white) | | 287 +--------------+------+---------------------------+--------------------------------------------------+ 288 | | | | The maximum resolution written is 768x512 pixels | 289 | PCD | RW | Photo CD | since larger images require huffman compression | 290 | | | | (which is not supported). | 291 +--------------+------+---------------------------+--------------------------------------------------+ 292 | PCDS | RW | Photo CD | Decode with the sRGB color tables. | 293 +--------------+------+---------------------------+--------------------------------------------------+ 294 | PCL | W | HP Page Control Language | For output to HP laser printers. | 295 +--------------+------+---------------------------+--------------------------------------------------+ 296 | PCX_ | RW | ZSoft IBM PC Paintbrush | | 297 | | | file | | 298 +--------------+------+---------------------------+--------------------------------------------------+ 299 | PDB | RW | Palm Database ImageViewer | | 300 | | | Format | | 301 +--------------+------+---------------------------+--------------------------------------------------+ 302 | PDF | RW | Portable Document Format | Requires Ghostscript_ to read. | 303 +--------------+------+---------------------------+--------------------------------------------------+ 304 | PFA | R | Postscript Type 1 font | Opening as file returns a preview image. | 305 | | | (ASCII) | | 306 +--------------+------+---------------------------+--------------------------------------------------+ 307 | PFB | R | Postscript Type 1 font | Opening as file returns a preview image. | 308 | | | (binary) | | 309 +--------------+------+---------------------------+--------------------------------------------------+ 310 | PGM | RW | Portable graymap format | | 311 | | | (gray scale) | | 312 +--------------+------+---------------------------+--------------------------------------------------+ 313 | PICON | RW | Personal Icon | | 314 +--------------+------+---------------------------+--------------------------------------------------+ 315 | PICT | RW | Apple Macintosh QuickDraw | | 316 | | | /PICT file | | 317 +--------------+------+---------------------------+--------------------------------------------------+ 318 | PIX | R | Alias/Wavefront RLE image | | 319 | | | format | | 320 +--------------+------+---------------------------+--------------------------------------------------+ 321 | PNG | RW | Portable Network Graphics | Requires libpng-1.0.2 or later, libpng-1.2.5 or | 322 | | | | later recommended. | 323 +--------------+------+---------------------------+--------------------------------------------------+ 324 | | | | PNM is a family of formats supporting portable | 325 | | | | bitmaps (PBM) , graymaps (PGM), and pixmaps | 326 | | | | (PPM). There is no file format associated with | 327 | | | | pnm itself. If PNM is used as the output format | 328 | | | | specifier, then GraphicsMagick automatically | 329 | PNM | RW | Portable anymap | selects the most appropriate format to represent | 330 | | | | the image. | 331 | | | | | 332 | | | | The default is to write the binary version of | 333 | | | | the formats. Use '-quality 0' to write the | 334 | | | | ASCII version of the formats. | 335 +--------------+------+---------------------------+--------------------------------------------------+ 336 | PPM | RW | Portable pixmap format | | 337 | | | (color) | | 338 +--------------+------+---------------------------+--------------------------------------------------+ 339 | PS | RW | Adobe PostScript file | Requires Ghostscript_ to read. | 340 +--------------+------+---------------------------+--------------------------------------------------+ 341 | PS2 | RW | Adobe Level II PostScript | Requires Ghostscript_ to read. | 342 | | | file | | 343 +--------------+------+---------------------------+--------------------------------------------------+ 344 | PS3 | RW | Adobe Level III | Requires Ghostscript_ to read. | 345 | | | PostScript file | | 346 +--------------+------+---------------------------+--------------------------------------------------+ 347 | PSD | RW | Adobe Photoshop bitmap | PSD format is no longer supported since the | 348 | | | file | 1.3.24 release. | 349 +--------------+------+---------------------------+--------------------------------------------------+ 350 | | | | Multi-resolution TIFF_ containing successively | 351 | PTIF | RW | Pyramid encoded TIFF_ | smaller versions of the image down to the size | 352 | | | | of an icon. The desired sub-image size may be | 353 | | | | specified when reading via the -size option. | 354 +--------------+------+---------------------------+--------------------------------------------------+ 355 | PWP_ | R | Seattle File Works | | 356 | | | multi-image file | | 357 +--------------+------+---------------------------+--------------------------------------------------+ 358 | RAS | R | TopoL_ (GIS) | | 359 | | | | | 360 +--------------+------+---------------------------+--------------------------------------------------+ 361 | RAD | R | Radiance_ image file | Requires that ra_ppm from the Radiance_ software | 362 | | | | package be installed. | 363 +--------------+------+---------------------------+--------------------------------------------------+ 364 | RGB | RW | Raw red, green, and blue | Use -size, -depth, -endian, and -interlace to | 365 | | | samples | specify the image width, height, depth, byte | 366 | | | | order, and interlace. | 367 +--------------+------+---------------------------+--------------------------------------------------+ 368 | RGBA | RW | Raw red, green, and blue | Use -size, -depth, -endian, and -interlace to | 369 | | | and matte samples | specify the image width, height, depth, byte | 370 | | | | order, and interlace. | 371 +--------------+------+---------------------------+--------------------------------------------------+ 372 | RLA | R | Alias/Wavefront image | | 373 | | | file | | 374 +--------------+------+---------------------------+--------------------------------------------------+ 375 | RLE | R | Utah Run length encoded | | 376 | | | image file | | 377 +--------------+------+---------------------------+--------------------------------------------------+ 378 | SCT_ | R | Scitex Continuous Tone | | 379 | | | Picture | | 380 +--------------+------+---------------------------+--------------------------------------------------+ 381 | SFW_ | R | Seattle File Works image | | 382 +--------------+------+---------------------------+--------------------------------------------------+ 383 | SGI | RW | Irix RGB image | | 384 +--------------+------+---------------------------+--------------------------------------------------+ 385 | | | Hypertext Markup Language | Used to write HTML clickable image maps based on | 386 | SHTML | W | client-side image map | a the output of montage or a format which | 387 | | | | supports tiled images such as MIFF_. | 388 +--------------+------+---------------------------+--------------------------------------------------+ 389 | SUN | RW | SUN Rasterfile | | 390 +--------------+------+---------------------------+--------------------------------------------------+ 391 | | | | Requires libxml2_ and freetype2_. Note that SVG_ | 392 | SVG_ | RW | Scalable Vector Graphics | is a very complex specification so support is | 393 | | | | still not complete. | 394 +--------------+------+---------------------------+--------------------------------------------------+ 395 | TGA | RW | Truevision Targa image | Also known as formats "ICB", "VDA", and "VST". | 396 +--------------+------+---------------------------+--------------------------------------------------+ 397 | | | | Also known as "TIF". Requires tiff-v3.5.4.tar.gz | 398 | | | | or later. Note that since the Unisys LZW patent | 399 | TIFF_ | RW | Tagged Image File Format | recently expired, libtiff may still require a | 400 | | | | separate LZW patch in order to support LZW. LZW | 401 | | | | is included in libtiff by default since v3.7.0. | 402 +--------------+------+---------------------------+--------------------------------------------------+ 403 | TIM | R | PSX TIM file | | 404 +--------------+------+---------------------------+--------------------------------------------------+ 405 | TTF | R | TrueType font file | Requires freetype2_. Opening as file returns a | 406 | | | | preview image. | 407 +--------------+------+---------------------------+--------------------------------------------------+ 408 | TXT | RW | Raw text file | | 409 +--------------+------+---------------------------+--------------------------------------------------+ 410 | UIL | W | X-Motif UIL table | | 411 +--------------+------+---------------------------+--------------------------------------------------+ 412 | UYVY | RW | Interleaved YUV raw image | Use -size command line option to specify width | 413 | | | | and height. | 414 +--------------+------+---------------------------+--------------------------------------------------+ 415 | VICAR | RW | VICAR rasterfile format | | 416 +--------------+------+---------------------------+--------------------------------------------------+ 417 | VIFF_ | RW | Khoros Visualization | | 418 | | | Image File Format | | 419 +--------------+------+---------------------------+--------------------------------------------------+ 420 | WBMP_ | RW | Wireless bitmap | Support for uncompressed monochrome only. | 421 +--------------+------+---------------------------+--------------------------------------------------+ 422 | | | | Requires libwmf. By default, renders WMF files | 423 | | | | using the dimensions specified by the metafile | 424 | | | | header. Use the -density option to adjust the | 425 | | | | output resolution, and thereby adjust the ouput | 426 | WMF_ | | Windows Metafile | size. The default output resolution is 72DPI so | 427 | | | | "-density 144" results in an image twice as | 428 | | | | large as the default. Use -background color_ to | 429 | | | | specify the WMF background color (default white) | 430 | | | | or -texture filename to specify a background | 431 | | | | texture image. | 432 +--------------+------+---------------------------+--------------------------------------------------+ 433 | WPG_ | R | Word Perfect Graphics | | 434 | | | File | | 435 +--------------+------+---------------------------+--------------------------------------------------+ 436 | XBM_ | RW | X Windows system bitmap, | Used by the X Windows System to store monochrome | 437 | | | black and white only | icons. | 438 +--------------+------+---------------------------+--------------------------------------------------+ 439 | XCF | R | GIMP image | | 440 +--------------+------+---------------------------+--------------------------------------------------+ 441 | XPM_ | RW | X Windows system pixmap | Also known as "PM". Used by the X Windows System | 442 | | | | to store color icons. | 443 +--------------+------+---------------------------+--------------------------------------------------+ 444 | XWD_ | RW | X Windows system window | Used by the X Windows System to save/display | 445 | | | dump | screen dumps. | 446 +--------------+------+---------------------------+--------------------------------------------------+ 447 | YUV | RW | CCIR 601 4:1:1 | Use -size command line option to specify width | 448 | | | | and height. | 449 +--------------+------+---------------------------+--------------------------------------------------+ 450 451 452GraphicsMagick supports a number of image format specifications which 453refer to images prepared via an algorithm, or input/output targets. The 454following table lists these pseudo image formats: 455 456.. table:: Pseudo Image Formats 457 458 +--------------+------+---------------------------+-------------------------------------------------------------+ 459 | Tag | Mode | Description | Notes | 460 +--------------+------+---------------------------+-------------------------------------------------------------+ 461 | CAPTION | R | Image caption | Draws text on a canvas image with size specified by `-size` | 462 | | | | canvas color as specified by `-background' (default white), | 463 | | | | and text stroke and fill colors as specified by `-stroke` | 464 | | | | and `-fill`. Capable of supporting multi-line text. | 465 +--------------+------+---------------------------+-------------------------------------------------------------+ 466 | CLIPBOARD | RW | Windows Clipboard | Only available under Microsoft Windows. | 467 +--------------+------+---------------------------+-------------------------------------------------------------+ 468 | FRACTAL | R | Plasma fractal image | | 469 +--------------+------+---------------------------+-------------------------------------------------------------+ 470 | | | | Returns a rendered gradient image using the | 471 | GRADIENT | R | Gradual passing from | specified image size. Specify the desired | 472 | | | one shade to another | shading as part of the filename. For example: | 473 | | | | | 474 | | | | ``gradient:red-blue`` or ``gradient:#F00-#00F`` | 475 +--------------+------+---------------------------+-------------------------------------------------------------+ 476 | | | | Generate an RGB histogram of the input image. | 477 | | | | The output format is always ImageMagick MIFF_ | 478 | HISTOGRAM | W | Histogram of the image | (regardless of file extension). For example: | 479 | | | | | 480 | | | | ``gm convert file.tiff histogram:file.miff`` | 481 +--------------+------+---------------------------+-------------------------------------------------------------+ 482 | IDENTITY | R | `Hald CLUT`_ identity | Generate a Hald CLUT identity image of a specified order. | 483 | | | image | The order is specified as an argument like "IDENTITY:8". | 484 | | | | The default order is eight, producing a 512x512 image. | 485 +--------------+------+---------------------------+-------------------------------------------------------------+ 486 | INFO | W | Image descriptive | Writes descriptive information similar to 'identify' | 487 | | | information and | | 488 | | | statistics | | 489 +--------------+------+---------------------------+-------------------------------------------------------------+ 490 | LABEL | R | Text image format | Specify the desired text as the filename (e.g. | 491 | | | | "label:This is a label"). | 492 +--------------+------+---------------------------+-------------------------------------------------------------+ 493 | | | Colormap intensities | Set -depth to set the sample size of the | 494 | MAP | RW | and indices | intensities; indices are 16-bit if colors > | 495 | | | | 256. | 496 +--------------+------+---------------------------+-------------------------------------------------------------+ 497 | MATTE | W | MATTE format | Write only. | 498 +--------------+------+---------------------------+-------------------------------------------------------------+ 499 | | | | Useful for creating blank tiles with montage | 500 | NULL | RW | NULL image | (use "NULL:"). Also useful as an output format | 501 | | | | when evaluating image read performance. | 502 +--------------+------+---------------------------+-------------------------------------------------------------+ 503 | | | | Creates an image using the plasma fractal. For | 504 | PLASMA | R | Plasma fractal image | example: | 505 | | | | | 506 | | | | ``gm convert -size 640x480 plasma: file.miff`` | 507 +--------------+------+---------------------------+-------------------------------------------------------------+ 508 | | | | Creates a preview montage of images prepared | 509 | | | | over a parameteric range in order to assist | 510 | | | | with parameter selection. Specify the desired | 511 | | | | preview type via the -preview option). The | 512 | | | Show a preview an image | output file is always written in the | 513 | PREVIEW | W | enhancement, effect, or | ImageMagick MIFF_ format. | 514 | | | f/x | | 515 | | | | For example: | 516 | | | | | 517 | | | | ``gm convert file.tiff -preview gamma preview:file.miff`` | 518 +--------------+------+---------------------------+-------------------------------------------------------------+ 519 | | | Send image to your | Unix users may set the PRINTER (for 'lp') or | 520 | PRINT | W | computer printer | LPDEST (for 'lpr') environment variables to | 521 | | | | select the desired printer. | 522 +--------------+------+---------------------------+-------------------------------------------------------------+ 523 | | | Import image from a | Requires SANE_ Specify the device name and path | 524 | SCAN | R | scanner device | as the filename (e.g. "scan:mustek:/dev/scanner"). | 525 | | | | | 526 +--------------+------+---------------------------+-------------------------------------------------------------+ 527 | STEGANO | R | Steganographic image | Use -size command line option to specify width, | 528 | | | | height, and offset of the steganographic image | 529 +--------------+------+---------------------------+-------------------------------------------------------------+ 530 | | | | Create a tiled version of an image at by tiling | 531 | TILE | R | Tiled image | a image. Use -size to specify the tiled image | 532 | | | | size. The image is specified similar to | 533 | | | | "TILE:image.miff". | 534 | | | | For example: | 535 | | | | | 536 | | | | ``gm convert -size 800x600 tile:image.jpg out.jpg`` | 537 +--------------+------+---------------------------+-------------------------------------------------------------+ 538 | | | | Used to create a thumbnailed directory (tiled | 539 | VID | RW | Visual Image Directory | thumbnails) of a set of images which may be | 540 | | | | used to select images to view via the display | 541 | | | | program, or saved to a MIFF_ or SHTML file. | 542 | | | | For example: | 543 | | | | | 544 | | | | ``gm convert vid:"*.jpg" index.miff`` | 545 +--------------+------+---------------------------+-------------------------------------------------------------+ 546 | | | Select image from or | | 547 | WIN | RW | display image to your | Only supported under Microsoft Windows. For example: | 548 | | | computer screen | | 549 | | | | ``gm convert file.jpg -rotate 90 win:`` | 550 +--------------+------+---------------------------+-------------------------------------------------------------+ 551 | | | Select image from or | | 552 | X | RW | display image to your X | Also see the import and display programs. For example: | 553 | | | server screen | | 554 | | | | ``gm convert file.jpg -rotate 90 x:`` | 555 +--------------+------+---------------------------+-------------------------------------------------------------+ 556 | | | | Useful to create solid color "canvas" images. | 557 | | | Canvas image of | Use -size and -depth to specify the image | 558 | XC | R | specified color | width, height, and depth. Example XC color | 559 | | | | specifications include "XC:red" and "XC:# | 560 | | | | FF0000". See the color_ reference for the | 561 | | | | numeric values used for named colors. For example: | 562 | | | | | 563 | | | | ``gm convert -size 640x480 xc:red red.jpg`` | 564 +--------------+------+---------------------------+-------------------------------------------------------------+ 565 566 567GraphicsMagick includes a number of built-in (embedded) images which may 568be referenced as if they were an image file. The ``IMAGE:`` format tag may 569be used via the syntax "IMAGE:name" to request an embedded image (e.g. 570``IMAGE:LOGO``). For backwards compatibility, the image specifications 571``GRANITE:``, ``LOGO:``, ``NETSCAPE:``, and ``ROSE:`` may also be used to request 572images with those names. 573 574A new canvas image of a specified size may be created using one of these pattern 575images using a command similar to:: 576 577 gm convert -size 640x480 PATTERN:BRICKS bricks.miff 578 579The TILE: virtual image type may also be used similar to:: 580 581 gm convert -size 640x480 TILE:IMAGE:BRICKS bricks.miff 582 583.. |bricks| image:: images/patterns/bricks.png 584.. |circles| image:: images/patterns/circles.png 585.. |checkerboard| image:: images/patterns/checkerboard.png 586.. |crosshatch30| image:: images/patterns/crosshatch30.png 587.. |crosshatch45| image:: images/patterns/crosshatch45.png 588.. |crosshatch| image:: images/patterns/crosshatch.png 589.. |fishscales| image:: images/patterns/fishscales.png 590.. |granite| image:: images/patterns/granite.png 591.. |gray0| image:: images/patterns/gray0.png 592.. |gray100| image:: images/patterns/gray100.png 593.. |gray10| image:: images/patterns/gray10.png 594.. |gray15| image:: images/patterns/gray15.png 595.. |gray20| image:: images/patterns/gray20.png 596.. |gray25| image:: images/patterns/gray25.png 597.. |gray30| image:: images/patterns/gray30.png 598.. |gray35| image:: images/patterns/gray35.png 599.. |gray40| image:: images/patterns/gray40.png 600.. |gray45| image:: images/patterns/gray45.png 601.. |gray50| image:: images/patterns/gray50.png 602.. |gray55| image:: images/patterns/gray55.png 603.. |gray5| image:: images/patterns/gray5.png 604.. |gray60| image:: images/patterns/gray60.png 605.. |gray65| image:: images/patterns/gray65.png 606.. |gray70| image:: images/patterns/gray70.png 607.. |gray75| image:: images/patterns/gray75.png 608.. |gray80| image:: images/patterns/gray80.png 609.. |gray85| image:: images/patterns/gray85.png 610.. |gray90| image:: images/patterns/gray90.png 611.. |gray95| image:: images/patterns/gray95.png 612.. |hexagons| image:: images/patterns/hexagons.png 613.. |horizontalsaw| image:: images/patterns/horizontalsaw.png 614.. |horizontal| image:: images/patterns/horizontal.png 615.. |hs_bdiagonal| image:: images/patterns/hs_bdiagonal.png 616.. |hs_cross| image:: images/patterns/hs_cross.png 617.. |hs_diagcross| image:: images/patterns/hs_diagcross.png 618.. |hs_fdiagonal| image:: images/patterns/hs_fdiagonal.png 619.. |hs_horizontal| image:: images/patterns/hs_horizontal.png 620.. |hs_vertical| image:: images/patterns/hs_vertical.png 621.. |left30| image:: images/patterns/left30.png 622.. |left45| image:: images/patterns/left45.png 623.. |leftshingle| image:: images/patterns/leftshingle.png 624.. |logo| image:: images/gm-125x80t.png 625.. |octagons| image:: images/patterns/octagons.png 626.. |right30| image:: images/patterns/right30.png 627.. |right45| image:: images/patterns/right45.png 628.. |rightshingle| image:: images/patterns/rightshingle.png 629.. |rose| image:: images/patterns/rose.png 630.. |smallfishscales| image:: images/patterns/smallfishscales.png 631.. |verticalbricks| image:: images/patterns/verticalbricks.png 632.. |verticalleftshingle| image:: images/patterns/verticalleftshingle.png 633.. |verticalrightshingle| image:: images/patterns/verticalrightshingle.png 634.. |verticalsaw| image:: images/patterns/verticalsaw.png 635.. |vertical| image:: images/patterns/vertical.png 636 637.. table:: Built-In Images And Patterns 638 639 +----------------------+------------------------------------+----------------------------------------+ 640 | Name | Description | Notes/Sample | 641 +----------------------+------------------------------------+----------------------------------------+ 642 | BRICKS | 16x16 brick pattern | |bricks| | 643 +----------------------+------------------------------------+----------------------------------------+ 644 | CHECKERBOARD | 30x30 checkerboard pattern | |checkerboard| | 645 +----------------------+------------------------------------+----------------------------------------+ 646 | CIRCLES | 16x16 circles pattern | |circles| | 647 +----------------------+------------------------------------+----------------------------------------+ 648 | CROSSHATCH | 8x4 crosshatch pattern | |crosshatch| | 649 +----------------------+------------------------------------+----------------------------------------+ 650 | CROSSHATCH30 | 8x4 crosshatch pattern with lines | |crosshatch30| | 651 | | at 30 degrees. | | 652 +----------------------+------------------------------------+----------------------------------------+ 653 | CROSSHATCH45 | 8x4 crosshatch pattern with lines | |crosshatch45| | 654 | | at 45 degrees. | | 655 +----------------------+------------------------------------+----------------------------------------+ 656 | FISHSCALES | 16x8 fish scales pattern | |fishscales| | 657 +----------------------+------------------------------------+----------------------------------------+ 658 | GRANITE | 128x128 granite texture pattern | |granite| | 659 +----------------------+------------------------------------+----------------------------------------+ 660 | GRAY0 | 32x32 0% intensity gray | |gray0| | 661 +----------------------+------------------------------------+----------------------------------------+ 662 | GRAY5 | 32x32 5% intensity gray | |gray5| | 663 +----------------------+------------------------------------+----------------------------------------+ 664 | GRAY10 | 32x32 10% intensity gray | |gray10| | 665 +----------------------+------------------------------------+----------------------------------------+ 666 | GRAY15 | 32x32 15% intensity gray | |gray15| | 667 +----------------------+------------------------------------+----------------------------------------+ 668 | GRAY20 | 32x32 20% intensity gray | |gray20| | 669 +----------------------+------------------------------------+----------------------------------------+ 670 | GRAY25 | 32x32 25% intensity gray | |gray25| | 671 +----------------------+------------------------------------+----------------------------------------+ 672 | GRAY30 | 32x32 30% intensity gray | |gray30| | 673 +----------------------+------------------------------------+----------------------------------------+ 674 | GRAY35 | 32x32 35% intensity gray | |gray35| | 675 +----------------------+------------------------------------+----------------------------------------+ 676 | GRAY40 | 32x32 40% intensity gray | |gray40| | 677 +----------------------+------------------------------------+----------------------------------------+ 678 | GRAY45 | 32x32 45% intensity gray | |gray45| | 679 +----------------------+------------------------------------+----------------------------------------+ 680 | GRAY50 | 32x32 50% intensity gray | |gray50| | 681 +----------------------+------------------------------------+----------------------------------------+ 682 | GRAY55 | 32x32 55% intensity gray | |gray55| | 683 +----------------------+------------------------------------+----------------------------------------+ 684 | GRAY60 | 32x32 60% intensity gray | |gray60| | 685 +----------------------+------------------------------------+----------------------------------------+ 686 | GRAY65 | 32x32 65% intensity gray | |gray65| | 687 +----------------------+------------------------------------+----------------------------------------+ 688 | GRAY70 | 32x32 70% intensity gray | |gray70| | 689 +----------------------+------------------------------------+----------------------------------------+ 690 | GRAY75 | 32x32 75% intensity gray | |gray75| | 691 +----------------------+------------------------------------+----------------------------------------+ 692 | GRAY80 | 32x32 80% intensity gray | |gray80| | 693 +----------------------+------------------------------------+----------------------------------------+ 694 | GRAY85 | 32x32 85% intensity gray | |gray85| | 695 +----------------------+------------------------------------+----------------------------------------+ 696 | GRAY90 | 32x32 90% intensity gray | |gray90| | 697 +----------------------+------------------------------------+----------------------------------------+ 698 | GRAY95 | 32x32 95% intensity gray | |gray95| | 699 +----------------------+------------------------------------+----------------------------------------+ 700 | GRAY100 | 32x32 100% intensity gray | |gray100| | 701 +----------------------+------------------------------------+----------------------------------------+ 702 | HEXAGONS | 30x18 hexagon pattern | |hexagons| | 703 +----------------------+------------------------------------+----------------------------------------+ 704 | HORIZONTAL | 8x4 horizontal line pattern | |horizontal| | 705 +----------------------+------------------------------------+----------------------------------------+ 706 | HORIZONTALSAW | 16x8 horizontal saw-tooth pattern | |horizontalsaw| | 707 +----------------------+------------------------------------+----------------------------------------+ 708 | HS_BDIAGONAL | 8x8 backward diagonal line pattern | |hs_bdiagonal| | 709 | | (45 degrees slope) | | 710 +----------------------+------------------------------------+----------------------------------------+ 711 | HS_CROSS | 8x8 cross line pattern | |hs_cross| | 712 +----------------------+------------------------------------+----------------------------------------+ 713 | HS_DIAGCROSS | 8x8 diagonal line cross pattern | |hs_diagcross| | 714 | | (45 degrees slope) | | 715 +----------------------+------------------------------------+----------------------------------------+ 716 | HS_FDIAGONAL | 8x8 forward diagonal line pattern | |hs_fdiagonal| | 717 | | (45 degrees slope) | | 718 +----------------------+------------------------------------+----------------------------------------+ 719 | HS_HORIZONTAL | 8x8 horizontal line pattern | |hs_horizontal| | 720 +----------------------+------------------------------------+----------------------------------------+ 721 | HS_VERTICAL | 8x8 vertical line pattern | |hs_vertical| | 722 +----------------------+------------------------------------+----------------------------------------+ 723 | LEFT30 | 8x4 forward diagonal pattern (30 | |left30| | 724 | | degrees slope) | | 725 +----------------------+------------------------------------+----------------------------------------+ 726 | LEFT45 | 8x8 forward diagonal line pattern | |left45| | 727 | | (45 degrees slope) | | 728 +----------------------+------------------------------------+----------------------------------------+ 729 | LEFTSHINGLE | 24x24 left shingle pattern | |leftshingle| | 730 +----------------------+------------------------------------+----------------------------------------+ 731 | LOGO | 640x480, GraphicsMagick Logo | |logo| | 732 +----------------------+------------------------------------+----------------------------------------+ 733 | | 216x144 image using colors in | Most commonly used with the | 734 | NETSCAPE | Netscape 216 (6x6x6 ) color cube. | convert_/mogrify_ -map option to | 735 | | | create *web safe* images. | 736 +----------------------+------------------------------------+----------------------------------------+ 737 | OCTAGONS | 16x16 octagons pattern | |octagons| | 738 +----------------------+------------------------------------+----------------------------------------+ 739 | RIGHT30 | 8x4 backward diagonal line pattern | |right30| | 740 | | (30 degrees) | | 741 +----------------------+------------------------------------+----------------------------------------+ 742 | RIGHT45 | 8x8 backward diagonal line pattern | |right45| | 743 | | (30 degrees) | | 744 +----------------------+------------------------------------+----------------------------------------+ 745 | RIGHTSHINGLE | 24x24 right shingle pattern | |rightshingle| | 746 +----------------------+------------------------------------+----------------------------------------+ 747 | ROSE | 70x46, Picture of a rose. | |rose| | 748 +----------------------+------------------------------------+----------------------------------------+ 749 | SMALLFISHSCALES | 8x8 small fish scales pattern | |smallfishscales| | 750 +----------------------+------------------------------------+----------------------------------------+ 751 | VERTICAL | 8x8 vertical line pattern | |vertical| | 752 +----------------------+------------------------------------+----------------------------------------+ 753 | VERTICALBRICKS | 16x16 vertical brick pattern | |verticalbricks| | 754 +----------------------+------------------------------------+----------------------------------------+ 755 | VERTICALLEFTSHINGLE | 24x24 vertical left shingle | |verticalleftshingle| | 756 | | pattern | | 757 +----------------------+------------------------------------+----------------------------------------+ 758 | VERTICALRIGHTSHINGLE | 24x24 vertical right shingle | |verticalrightshingle| | 759 | | pattern | | 760 +----------------------+------------------------------------+----------------------------------------+ 761 | VERTICALSAW | 8x16 vertical saw-tooth pattern | |verticalsaw| | 762 +----------------------+------------------------------------+----------------------------------------+ 763 764GraphicsMagick provides a number of format identifiers which are used 765to add, remove, and save embedded profiles for images which can 766support embedded profiles. Image types which may contain embedded 767profiles are TIFF_, JPEG_, PDF, and PNG. 768 769 770.. table:: Supported Embedded Profile Formats 771 772 +-------------------+------+----------------------------+-------------------------------------------------+ 773 | Format | Mode | Description | Notes | 774 +-------------------+------+----------------------------+-------------------------------------------------+ 775 | 8BIM | RW | Photoshop resource format | | 776 | | | (binary) | | 777 +-------------------+------+----------------------------+-------------------------------------------------+ 778 | 8BIMTEXT | RW | Photoshop resource format | An ASCII representation of the 8BIM format. | 779 | | | (ASCII) | | 780 +-------------------+------+----------------------------+-------------------------------------------------+ 781 | APP1 | RW | Raw application | | 782 | | | information | | 783 +-------------------+------+----------------------------+-------------------------------------------------+ 784 | APP1JPEG | RW | Raw JPEG_ binary data | Profile in JPEG_ wrapper. | 785 +-------------------+------+----------------------------+-------------------------------------------------+ 786 | ICC | RW | International Color | Also known as "ICM". To read, use -profile with | 787 | | | Consortium color profile | convert. | 788 +-------------------+------+----------------------------+-------------------------------------------------+ 789 | IPTC | RW | IPTC Newsphoto (binary) | To read, use -profile with convert | 790 +-------------------+------+----------------------------+-------------------------------------------------+ 791 | IPTCTEXT | RW | IPTC Newsphoto (ASCII) | An ASCII representation of the IPTC format. | 792 +-------------------+------+----------------------------+-------------------------------------------------+ 793 794 795Support for some of the formats are delegated to libraries or external 796programs. The README describes where to find these distributions and 797any special configuration options required. 798 799To get a complete listing of the image formats which are supported on 800your system, type 801 802:: 803 804 gm convert -list format 805 806On some platforms, GraphicsMagick automatically processes these 807extensions: .gz for Zip compression, .Z for Unix compression, and .bz2 808for block compression. For example, a PNM image called image.pnm.gz is 809automatically uncompressed while the image is read. 810
