MyWebUniversity.com Home Page
 



OpenSolaris man pages main menu


User Commands                                          convert(1)



NAME
     convert - convert between image formats as well as resize an
     image,  blur,  crop, despeckle, dither, draw on, flip, join,
     re-sample, and much more.

SYNOPSIS
     convert input-file [options] output-file

OVERVIEW
     The convert program is a member of the ImageMagick(1)  suite
     of  tools.   Use it to convert between image formats as well
     as resize an image, blur, crop, despeckle, dither, draw  on,
     flip, join, re-sample, and much more.

     For more information about the convert command,  point  your
     browser         to        file:/usr/share/doc/ImageMagick-
     6.3.4/www/convert.html                                    or
     http:/www.imagemagick.org/script/convert.php.

DESCRIPTION
     Image Settings:
       -adjoin              join images into a single multi-image
     file
       -affine matrix       affine transform matrix
       -antialias           remove pixel-aliasing
       -authenticate value  decrypt image with this password
       -background color    background color
       -bias value          add bias when convolving an image
       -black-point-compensation
                            use black point compensation
       -blue-primary point  chromaticity blue primary point
       -bordercolor color   border color
       -caption string      assign a caption to an image
       -channel type        apply option to select image channels
       -colors value        preferred number  of  colors  in  the
     image
       -colorspace type     alternate image colorspace
       -comment string      annotate image with comment
       -compose operator    set image composite operator
       -compress type       type of pixel compression when  writ-
     ing the image
       -debug events        display copious debugging information
       -define format:option
                            define  one  or  more  image   format
     options
       -delay value         display the next image after pausing
       -density geometry    horizontal and  vertical  density  of
     the image
       -depth value         image depth
       -display server      get image or font from this X server
       -dispose method      GIF disposal method
       -dither              apply Floyd/Steinberg error diffusion



ImageMagick  Last change: Date: 2005/03/01 01:00:00             1






User Commands                                          convert(1)



     to image
       -encoding type       text encoding type
       -endian type         endianness (MSB or LSB) of the image
       -family name         render text with this font family
       -fill color          color to use when filling  a  graphic
     primitive
       -filter type         use  this  filter  when  resizing  an
     image
       -font name           render text with this font
       -format "string"     output formatted  image  characteris-
     tics
       -fuzz distance       colors within this distance are  con-
     sidered equal
       -gravity type        horizontal and vertical  text  place-
     ment
       -green-primary point chromaticity green primary point
       -intent type         type of rendering intent when  manag-
     ing the image color
       -interlace type      type of image interlacing scheme
       -interpolate method  pixel color interpolation method
       -label string        assign a label to an image
       -limit type value    pixel cache resource limit
       -log format          format of debugging information
       -loop iterations     add Netscape loop extension  to  your
     GIF animation
       -mask filename       associate a mask with the image
       -matte               store matte channel if the image  has
     one
       -mattecolor color    frame color
       -monitor             monitor progress
       -orient type         image orientation
       -origin geometry     image origin
       -page geometry       size and location of an image  canvas
     (setting)
       -ping                efficiently  determine  image  attri-
     butes
       -pointsize value     font point size
       -preview type        image preview type
       -quality value       JPEG/MIF/PNG compression level
       -quiet               suppress all warning messages
       -red-primary point   chromaticity red primary point
       -regard-warnings     pay attention to warning messages
       -sampling-factor geometry
                            horizontal and vertical sampling fac-
     tor
       -scene value         image scene number
       -seed value          pseudo-random number  generator  seed
     value
       -size geometry       width and height of image
       -stretch type        render text with this font stretch
       -stroke color        graphic primitive stroke color
       -strokewidth value   graphic primitive stroke width



ImageMagick  Last change: Date: 2005/03/01 01:00:00             2






User Commands                                          convert(1)



       -style type          render text with this font style
       -support factor      resize support: > 1.0  is  blurry,  <
     1.0 is sharp
       -texture filename    name of  texture  to  tile  onto  the
     image background
       -treedepth value     color tree depth
       -transparent-color color
                            transparent color
       -undercolor color    annotation bounding box color
       -units type          the units of image resolution
       -verbose             print detailed information about  the
     image
       -view                FlashPix viewing transforms
       -virtual-pixel method
                            virtual pixel access method
       -weight type         render text with this font weight
       -white-point point   chromaticity white point

     Image Operators:
       -adaptive-blur geometry
                            adaptively  blur   pixels;   decrease
     effect near edges
       -adaptive-resize geometry
                            adaptively  resize  image  with  data
     dependent triangulation
       -adaptive-sharpen geometry
                            adaptively sharpen  pixels;  increase
     effect near edges
       -annotate geometry text
                            annotate the image with text
       -auto-orient         automatically orient image
       -black-threshold value
                            force all pixels below the  threshold
     into black
       -blur geometry       reduce image noise and reduce  detail
     levels
       -border geometry     surround image with a border of color
       -charcoal radius     simulate a charcoal drawing
       -chop geometry       remove pixels from the image interior
       -clip                clip along the first  path  from  the
     8BIM profile
       -clip-mask filename  associate a clip mask with the image
       -clip-path id        clip along a named path from the 8BIM
     profile
       -colorize value      colorize  the  image  with  the  fill
     color
       -contrast            enhance or reduce the image contrast
       -contrast-stretch geometry
                            improve contrast by `stretching'  the
     intensity range
       -convolve coefficients
                            apply a  convolution  kernel  to  the



ImageMagick  Last change: Date: 2005/03/01 01:00:00             3






User Commands                                          convert(1)



     image
       -cycle amount        cycle the image colormap
       -despeckle           reduce the speckles within an image
       -draw string         annotate the  image  with  a  graphic
     primitive
       -edge radius         apply a filter to detect edges in the
     image
       -emboss radius       emboss an image
       -enhance             apply a digital filter to  enhance  a
     noisy image
       -equalize            perform histogram equalization to  an
     image
       -evaluate operator value
                            evaluate an  arithmetic,  relational,
     or logical expression
       -extent geometry     set the image size
       -extract geometry    extract area from image
       -flip                flip image vertically
       -floodfill geometry color
                            floodfill the image with color
       -flop                flop image horizontally
       -frame geometry      surround  image  with  an  ornamental
     border
       -gamma value         level of gamma correction
       -gaussian-blur geometry
                            reduce image noise and reduce  detail
     levels
       -geometry geometry   perferred size  or  location  of  the
     image
       -help                print program options
       -identify            identify the format and  characteris-
     tics of the image
       -implode amount      implode image pixels about the center
       -lat geometry        local adaptive thresholding
       -layers method       optimize or compare image layers
       -level value         adjust the level of image contrast
       -linear-stretch geometry
                            improve contrast by `stretching  with
     saturation' the intensity range
       -median radius       apply a median filter to the image
       -modulate value      vary the brightness, saturation,  and
     hue
       -monochrome          transform image to black and white
       -motion-blur geometry
                            simulate motion blur
       -negate              replace every pixel with its  comple-
     mentary color
       -noise radius        add or reduce noise in an image
       -normalize           transform  image  to  span  the  full
     range of colors
       -opaque color        change this color to the fill color
       -ordered-dither NxN



ImageMagick  Last change: Date: 2005/03/01 01:00:00             4






User Commands                                          convert(1)



                            add a noise pattern to the image with
     specific amplitudes
       -paint radius        simulate an oil painting
       -polaroid angle      simulate a Polaroid picture
       -posterize levels    reduce the image to a limited  number
     of color levels
       -print string        interpret string and print to console
       -profile filename    add, delete, or apply an  image  pro-
     file
       -quantize colorspace reduce colors in this colorspace
       -radial-blur angle   radial blur the image
       -raise value         lighten/darken image edges to  create
     a 3-D effect
       -random-threshold low,high
                            random threshold the image
       -recolor matrix      translate, scale,  shear,  or  rotate
     image colors
       -region geometry     apply options to  a  portion  of  the
     image
       -render              render vector graphics
       -repage geometry     size and location of an image canvas
       -resample geometry   change the resolution of an image
       -resize geometry     resize the image
       -roll geometry       roll an image vertically or  horizon-
     tally
       -rotate degrees      apply Paeth rotation to the image
       -sample geometry     scale image with pixel sampling
       -scale geometry      scale the image
       -segment values      segment an image
       -sepia-tone threshold
                            simulate a sepia-toned photo
       -set property value  set an image property
       -shade degrees       shade the image using a distant light
     source
       -shadow geometry     simulate an image shadow
       -sharpen geometry    sharpen the image
       -shave geometry      shave pixels from the image edges
       -shear geometry      slide one edge of the image along the
     X or Y axis
       -sigmoidal-contrast geometry
                            lightness rescaling  using  sigmoidal
     contrast enhancement
       -sketch geometry     simulate a pencil sketch
       -solarize threshold  negate all pixels above the threshold
     level
       -splice geometry     splice the background color into  the
     image
       -spread amount       displace image  pixels  by  a  random
     amount
       -strip               strip image of all profiles and  com-
     ments
       -swirl degrees       swirl image pixels about the center



ImageMagick  Last change: Date: 2005/03/01 01:00:00             5






User Commands                                          convert(1)



       -threshold value     threshold the image
       -thumbnail geometry  create a thumbnail of the image
       -tile filename       tile image  when  filling  a  graphic
     primitive
       -tint value          tint the image with the fill color
       -transform           affine transform image
       -transparent color   make this  color  transparent  within
     the image
       -transpose           flip image vertically and  rotate  90
     degrees
       -transverse          flop image  horizontally  and  rotate
     270 degrees
       -trim                trim image edges
       -type type           image type
       -unique-colors       discard all  but  one  of  any  pixel
     color
       -unsharp geometry    sharpen the image
       -version             print version information
       -vignette geometry   soften the edges of the image in vig-
     nette style
       -wave geometry       alter an image along a sine wave
       -white-threshold value
                            force all pixels above the  threshold
     into white

     Image Sequence Operators:
       -append              append an image sequence
       -average             average an image sequence
       -coalesce            merge a sequence of images
       -combine             combine a sequence of images
       -composite           composite image
       -crop geometry       cut out a rectangular region  of  the
     image
       -deconstruct         break down  an  image  sequence  into
     constituent parts
       -flatten             flatten a sequence of images
       -fx expression       apply mathematical expression  to  an
     image channel(s)
       -map filename        transform image colors to match  this
     set of colors
       -morph value         morph an image sequence
       -mosaic               create  a  mosaic  from   an   image
     sequence
       -process arguments   process the image with a custom image
     filter
       -separate            separate  an  image  channel  into  a
     grayscale image
       -write filename      write images to this file

     Image Stack Operators:
       -clone index         clone an image
       -delete index         delete  the  image  from  the  image



ImageMagick  Last change: Date: 2005/03/01 01:00:00             6






User Commands                                          convert(1)



     sequence
       -insert index        insert  last  image  into  the  image
     sequence
       -swap indexes        swap two images in the image sequence

     By default, the image format of `file' is determined by  its
     magic number.  To specify a particular image format, precede
     the filename with an image format name  and  a  colon  (i.e.
     ps:image)  or  specify the image type as the filename suffix
     (i.e. image.ps).  Specify 'file' as '-' for  standard  input
     or output.

SE-ALSO
     ImageMagick(1)


COPYRIGHT
     Copyright (C) 1999-2007 ImageMagick Studio  LC.  Additional
     copyrights   and   licenses  apply  to  this  software,  see
     file:/usr/share/doc/ImageMagick-6.3.4/www/license.php   or
     http:/www.imagemagick.org/script/license.php

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWimagick    
    
     Interface Stability  External       
    

NOTES
     Source     for     ImageMagick     is      available      on
     http:/opensolaris.org.


















ImageMagick  Last change: Date: 2005/03/01 01:00:00             7



OpenSolaris man pages main menu

Contact us      |       About us      |       Term of use      |       Copyright © 2000-2010 MyWebUniversity.com ™