{
    "content": [
        {
            "type": "text",
            "text": "# convert(1) (man)\n\n**Summary:** convert  -  convert  between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.\n\n**Synopsis:** convert-im6.q16 [input-option] input-file [output-option] output-file\n\n## See Also\n\n- ImageMagick-im6.q16(1)\n\n## Section Outline\n\n- **NAME** (3 lines)\n- **SYNOPSIS** (2 lines)\n- **OVERVIEW** (8 lines)\n- **DESCRIPTION** (315 lines)\n- **SEE ALSO** (3 lines)\n- **COPYRIGHT** (1 lines) — 2 subsections\n  - Copyright  (C)  1999-2020 ImageMagick Studio LLC. Additional (2 lines)\n  - magick.org/script/license.php (1 lines)\n\n## Full Content\n\n### NAME\n\nconvert  -  convert  between image formats as well as resize an image, blur, crop, despeckle,\ndither, draw on, flip, join, re-sample, and much more.\n\n### SYNOPSIS\n\nconvert-im6.q16 [input-option] input-file [output-option] output-file\n\n### OVERVIEW\n\nThe convert-im6.q16 program is a member of the ImageMagick-ims6.q16(1) suite of  tools.   Use\nit  to  convert  between  image  formats  as  well as resize an image, blur, crop, despeckle,\ndither, draw on, flip, join, re-sample, and much more.\n\nFor   more   information   about   the   convert   command,    point    your    browser    to\nfile:///usr/share/doc/imagemagick-6-common/html/www/convert.html  (on  debian  system you may\ninstall the imagemagick-6 package) or https://www.imagemagick.org/script/convert.php.\n\n### DESCRIPTION\n\nImage Settings:\n-adjoin              join images into a single multi-image file\n-affine matrix       affine transform matrix\n-alpha option        activate, deactivate, reset, or set the alpha channel\n-antialias           remove pixel-aliasing\n-authenticate value  decrypt image with this password\n-attenuate value     lessen (or intensify) when adding noise to an image\n-background color    background color\n-bias value          add bias when convolving an image\n-black-point-compensation\nuse black point compensation\n-blue-primary point  chromaticity blue primary point\n-bordercolor color   border color\n-caption string      assign a caption to an image\n-cdl filename        color correct with a color decision list\n-channel type        apply option to select image channels\n-clip                clip along the first path from the 8BIM profile\n-clip-mask filename  associate a clip mask with the image\n-clip-path id        clip along a named path from the 8BIM profile\n-colors value        preferred number of colors in the image\n-colorspace type     alternate image colorspace\n-comment string      annotate image with comment\n-compose operator    set image composite operator\n-compress type       type of pixel compression when writing the image\n-decipher filename   convert cipher pixels to plain pixels\n-define format:option\ndefine one or more image format options\n-delay centiseconds  display the next image after pausing\n-density geometry    horizontal and vertical density of the image\n-depth value         image depth\n-direction type      render text right-to-left or left-to-right\n-display server      get image or font from this X server\n-dispose method      layer disposal method\n-dither method       apply error diffusion to image\n-encipher filename   convert plain pixels to cipher pixels\n-encoding type       text encoding type\n-endian type         endianness (MSB or LSB) of the image\n-family name         render text with this font family\n-features distance   analyze image features (e.g. contrast, correlation)\n-fill color          color to use when filling a graphic primitive\n-filter type         use this filter when resizing an image\n-flatten             flatten a sequence of images\n-font name           render text with this font\n-format \"string\"     output formatted image characteristics\n-fuzz distance       colors within this distance are considered equal\n-gravity type        horizontal and vertical text placement\n-green-primary point chromaticity green primary point\n-intensity method    method to generate intensity value from pixel\n-intent type         type of rendering intent when managing the image color\n-interlace type      type of image interlacing scheme\n-interline-spacing value\nset the space between two text lines\n-interpolate method  pixel color interpolation method\n-interword-spacing value\nset the space between two words\n-kerning value       set the space between two letters\n-label string        assign a label to an image\n-limit type value    pixel cache resource limit\n-loop iterations     add Netscape loop extension to your GIF animation\n-mask filename       associate a mask with the image\n-matte               store matte channel if the image has one\n-mattecolor color    frame color\n-metric type         measure differences between images with this metric\n-moments             report image moments\n-monitor             monitor progress\n-orient type         image orientation\n-page geometry       size and location of an image canvas (setting)\n-ping                efficiently determine image attributes\n-pointsize value     font point size\n-precision value     maximum number of significant digits to print\n-preview type        image preview type\n-quality value       JPEG/MIFF/PNG compression level\n-quiet               suppress all warning messages\n-red-primary point   chromaticity red primary point\n-regard-warnings     pay attention to warning messages\n-remap filename      transform image colors to match this set of colors\n-repage geometry     size and location of an image canvas\n-respect-parentheses settings remain in effect until parenthesis boundary\n-sampling-factor geometry\nhorizontal and vertical sampling factor\n-scene value         image scene number\n-seed value          seed a new sequence of pseudo-random numbers\n-size geometry       width and height of image\n-statistic type geometry\nreplace each pixel with corresponding statistic from the neighborhood\n-stretch type        render text with this font stretch\n-stroke color        graphic primitive stroke color\n-strokewidth value   graphic primitive stroke width\n-style type          render text with this font style\n-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp\n-synchronize         synchronize image to storage device\n-taint               declare the image as modified\n-texture filename    name of texture to tile onto the image background\n-tile-offset geometry\ntile offset\n-treedepth value     color tree depth\n-transparent-color color\ntransparent color\n-undercolor color    annotation bounding box color\n-units type          the units of image resolution\n-verbose             print detailed information about the image\n-view                FlashPix viewing transforms\n-virtual-pixel method\nvirtual pixel access method\n-weight type         render text with this font weight\n-white-point point   chromaticity white point\n\nImage Operators:\n-adaptive-blur geometry\nadaptively blur pixels; decrease effect near edges\n-adaptive-resize geometry\nadaptively resize image with data dependent triangulation\n-adaptive-sharpen geometry\nadaptively sharpen pixels; increase effect near edges\n-annotate geometry text\nannotate the image with text\n-auto-gamma          automagically adjust gamma level of image\n-auto-level          automagically adjust color levels of image\n-auto-orient         automatically orient image\n-bench iterations    measure performance\n-black-threshold value\nforce all pixels below the threshold into black\n-blue-shift factor   simulate a scene at nighttime in the moonlight\n-blur geometry       reduce image noise and reduce detail levels\n-border geometry     surround image with a border of color\n-brightness-contrast geometry\nimprove brightness / contrast of the image\n-canny geometry      detect edges in the image\n-charcoal radius     simulate a charcoal drawing\n-chop geometry       remove pixels from the image interior\n-clamp               keep pixel values in range (0-QuantumRange)\n-clip                clip along the first path from the 8BIM profile\n-clip-mask filename  associate a clip mask with the image\n-clip-path id        clip along a named path from the 8BIM profile\n-colorize value      colorize the image with the fill color\n-color-matrix matrix apply color correction to the image\n-connected-component connectivity\nconnected-components uniquely labeled\n-contrast            enhance or reduce the image contrast\n-contrast-stretch geometry\nimprove contrast by `stretching' the intensity range\n-convolve coefficients\napply a convolution kernel to the image\n-cycle amount        cycle the image colormap\n-deskew threshold    straighten an image\n-despeckle           reduce the speckles within an image\n-distort method args\ndistort images according to given method and args\n-draw string         annotate the image with a graphic primitive\n-edge radius         apply a filter to detect edges in the image\n-emboss radius       emboss an image\n-enhance             apply a digital filter to enhance a noisy image\n-equalize            perform histogram equalization to an image\n-evaluate operator value\nevaluate an arithmetic, relational, or logical expression\n-extent geometry     set the image size\n-extract geometry    extract area from image\n-fft                 implements the discrete Fourier transform (DFT)\n-flip                flip image vertically\n-floodfill geometry color\nfloodfill the image with color\n-flop                flop image horizontally\n-frame geometry      surround image with an ornamental border\n-function name       apply a function to the image\n-gamma value         level of gamma correction\n-gaussian-blur geometry\nreduce image noise and reduce detail levels\n-geometry geometry   preferred size or location of the image\n-grayscale method    convert image to grayscale\n-hough-lines geometry\nidentify lines in the image\n-identify            identify the format and characteristics of the image\n-ift                 implements the inverse discrete Fourier transform (DFT)\n-implode amount      implode image pixels about the center\n-interpolative-resize geometry\nresize image using 'point sampled' interpolation\n-lat geometry        local adaptive thresholding\n-layers method       optimize or compare image layers\n-level value         adjust the level of image contrast\n-level-colors color,color\nlevel image with the given colors\n-linear-stretch geometry\nimprove contrast by `stretching with saturation' the intensity range\n-liquid-rescale geometry\nrescale image with seam-carving\n-magnify             double the size of the image with pixel art scaling\n-mean-shift geometry delineate arbitrarily shaped clusters in the image\n-median geometry     apply a median filter to the image\n-mode geometry       make each pixel the 'predominant color' of the neighborhood\n-modulate value      vary the brightness, saturation, and hue\n-monochrome          transform image to black and white\n-morphology method kernel\napply a morphology method to the image\n-motion-blur geometry\nsimulate motion blur\n-negate              replace each pixel with its complementary color\n-noise geometry      add or reduce noise in an image\n-normalize           transform image to span the full range of colors\n-opaque color        change this color to the fill color\n-ordered-dither NxN\nadd a noise pattern to the image with specific amplitudes\n-paint radius        simulate an oil painting\n-perceptible epsilon\npixel value less than |epsilon| become epsilon or -epsilon\n-polaroid angle      simulate a Polaroid picture\n-posterize levels    reduce the image to a limited number of color levels\n-print string        interpret string and print to console\n-profile filename    add, delete, or apply an image profile\n-quantize colorspace reduce colors in this colorspace\n-radial-blur angle   radial blur the image\n-raise value         lighten/darken image edges to create a 3-D effect\n-random-threshold low,high\nrandom threshold the image\n-region geometry     apply options to a portion of the image\n-render              render vector graphics\n-resample geometry   change the resolution of an image\n-resize geometry     resize the image\n-roll geometry       roll an image vertically or horizontally\n-rotate degrees      apply Paeth rotation to the image\n-sample geometry     scale image with pixel sampling\n-scale geometry      scale the image\n-segment values      segment an image\n-selective-blur geometry\nselectively blur pixels within a contrast threshold\n-sepia-tone threshold\nsimulate a sepia-toned photo\n-set property value  set an image property\n-shade degrees       shade the image using a distant light source\n-shadow geometry     simulate an image shadow\n-sharpen geometry    sharpen the image\n-shave geometry      shave pixels from the image edges\n-shear geometry      slide one edge of the image along the X or Y axis\n-sigmoidal-contrast geometry\nlightness rescaling using sigmoidal contrast enhancement\n-sketch geometry     simulate a pencil sketch\n-solarize threshold  negate all pixels above the threshold level\n-sparse-color method args\nfill in a image based on a few color points\n-splice geometry     splice the background color into the image\n-spread amount       displace image pixels by a random amount\n-strip               strip image of all profiles and comments\n-swirl degrees       swirl image pixels about the center\n-threshold value     threshold the image\n-thumbnail geometry  create a thumbnail of the image\n-tile filename       tile image when filling a graphic primitive\n-tint value          tint the image with the fill color\n-transform           affine transform image\n-transparent color   make this color transparent within the image\n-transpose           flip image vertically and rotate 90 degrees\n-transverse          flop image horizontally and rotate 270 degrees\n-trim                trim image edges\n-type type           image type\n-unique-colors       discard all but one of any pixel color\n-unsharp geometry    sharpen the image\n-vignette geometry   soften the edges of the image in vignette style\n-wave geometry       alter an image along a sine wave\n-wavelet-denoise threshold\nremoves noise from the image using a wavelet transform\n-white-threshold value\nforce all pixels above the threshold into white\n\nImage Sequence Operators:\n-append              append an image sequence top to bottom (use +append for left to right)\n-clut                apply a color lookup table to the image\n-coalesce            merge a sequence of images\n-combine             combine a sequence of images\n-compare             mathematically and visually annotate the difference between  an  image\nand its reconstruction\n-complex operator    perform complex mathematics on an image sequence\n-composite           composite image\n-copy geometry offset,\ncopy pixels from one area of an image to another\n-crop geometry       cut out a rectangular region of the image\n-deconstruct         break down an image sequence into constituent parts\n-evaluate-sequence operator\nevaluate an arithmetic, relational, or logical expression\n-flatten             flatten a sequence of images\n-fx expression       apply mathematical expression to an image channel(s)\n-hald-clut           apply a Hald color lookup table to the image\n-morph value         morph an image sequence\n-mosaic              create a mosaic from an image sequence\n-poly terms          build a polynomial from the image sequence and the corresponding terms\n(coefficients and degree pairs)\n-process arguments   process the image with a custom image filter\n-separate            separate an image channel into a grayscale image\n-smush geometry      smush an image sequence together\n-write filename      write images to this file\n\nImage Stack Operators:\n-clone indexes       clone an image\n-delete indexes      delete the image from the image sequence\n-duplicate count,indexes\nduplicate an image one or more times\n-insert index        insert last image into the image sequence\n-reverse             reverse image sequence\n-swap indexes        swap two images in the image sequence\n\nMiscellaneous Options:\n-debug events        display copious debugging information\n-distribute-cache port\ndistributed pixel cache spanning one or more servers\n-help                print program options\n-log format          format of debugging information\n-list type           print a list of supported option arguments\n-version             print version information\n\nUse any setting or operator as an output-option.  Only a limited number of setting  are   in‐\nput-option.  They include: -antialias, -caption, -density, -define, -encoding, -font, -point‐\nsize, -size, and -texture as well as any of the miscellaneous options.\n\nBy default, the image format of `file' is determined by its magic number.  To specify a  par‐\nticular image format, precede the filename with an image format name and a colon (i.e. ps:im‐\nage) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-'\nfor standard input or output.\n\n### SEE ALSO\n\nImageMagick-im6.q16(1)\n\n### COPYRIGHT\n\n#### Copyright  (C)  1999-2020 ImageMagick Studio LLC. Additional copyrights and licenses apply to\n\nthis software, see file:///usr/share/doc/imagemagick-6-common/html/www/license.html  (on  de‐‐\nbian   system   you   may   install   the   imagemagick-6   package)   or  https://www.image‐‐\n\n#### magick.org/script/license.php\n\nImageMagick                           Date: 2009/01/10 01:00:00                   convert-im6.q16(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "convert",
        "section": "1",
        "mode": "man",
        "summary": "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-im6.q16 [input-option] input-file [output-option] output-file",
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "ImageMagick-im6.q16",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/ImageMagick-im6.q16/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "OVERVIEW",
                "lines": 8,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 315,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 1,
                "subsections": [
                    {
                        "name": "Copyright  (C)  1999-2020 ImageMagick Studio LLC. Additional copyrights and licenses apply to",
                        "lines": 2
                    },
                    {
                        "name": "magick.org/script/license.php",
                        "lines": 1
                    }
                ]
            }
        ]
    }
}