|
|
|
|
|
convert -clip -negate cockatoo.tif negated.tif
-comment "%m:%f |
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
8BIM
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only applies when the default X server visual is PseudoColor or GRAYScale. Refer to -visual for more details. By default, a shared colormap is allocated. The image shares colors with other X clients. Some image colors could be approximated, therefore your image may look very different than intended. Choose Private and the image colors appear exactly as they are defined. However, other clients may go technicolor when the image colormap is installed. |
|
-colors
<value> |
| preferred number of colors in the image |
| The actual number of colors in the image may be less than your request, but never more. Note, this is a color reduction option. Images with less unique colors than specified with this option will have any duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, convert the image to the gray colorspace before reducing the number of colors since doing so is most efficient. Refer to <a href="quantize.html">quantize for more details. |
| Note, options -dither, -colorspace, and -treedepth affect the color reduction algorithm. |
|
-colorspace
<value> |
| the type of colorspace |
| Choices are: CMYK, GRAY, HSL, HWB, OHTA, RGB, Transparent, XYZ, YCbCr, YIQ, YPbPr, or YUV. |
| Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Refer to quantize for more details. |
| The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists. |
| The -colors or -monochrome option, or saving to a file format which requires color reduction, is required for this option to take effect. |
|
-combine |
| combine one or more images into a single image |
| The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc. |
|
-comment
<string> |
| annotate an image with a comment |
| Use this option to assign a specific comment to the image, when writing to an image format that supports comments. You can include the image filename, type, width, height, or other image attribute by embedding special format characters listed under the -format option. The comment is not drawn on the image, but is embedded in the image datastream via a "Comment" tag or similar mechanism. If you want the comment to be visible on the image itself, use the -draw option. |
| For example, |
-comment "%m:%f
-box
<color>
| set the color of the annotation bounding box |
| The color is specified using the format described under the -fill option. |
| See -draw for further details. |
|
-cache
<threshold> |
| (This option has been replaced by the -limit option) |
|
-channel
<type> |
| the type of channel |
| Choose from: Red, Green, Blue, Alpha, Cyan, Magenta, Yellow, Black, RGB, RGBA, CMYK, or CMYKA. |
| By default, ImageMagick applies operations all channels, except the opacity channel, in an image. Use this option to apply an operation to only select channels of an image. For example to only negate the alpha channel of an image, use -channel Alpha -negate. |
|
-charcoal
<factor> |
| simulate a charcoal drawing |
|
-chop
<width>x<height>{+-}<x>{+-}
<y>{%} |
| remove pixels from the interior of an image |
| Width and height give the number of columns and rows to remove, and x and y are offsets that give the location of the leftmost column and topmost row to remove. |
| The x offset normally specifies the leftmost column to remove. If the -gravity option is present with NorthEast, East, or SouthEast gravity, it gives the distance leftward from the right edge of the image to the rightmost column to remove. Similarly, the y offset normally specifies the topmost row to remove, but if the -gravity option is present with SouthWest, South, or SouthEast gravity, it specifies the distance upward from the bottom edge of the image to the bottom row to remove. |
| The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps. |
|
-clip |
| apply the clipping path, if one is present |
| If a clipping path is present, it will be applied to subsequent operations. |
| For example, if you type the following command: |
convert -clip -negate cockatoo.tif negated.tif
| only the pixels within the clipping path are negated. |
| The -clip feature requires the XML library. If the XML library is not present, the option is ignored. |
|
-coalesce |
| merge a sequence of images |
| Each image N in the sequence after Image 0 is replaced with the image created by flattening images 0 through N. |
| The set of images is terminated by the appearance of any option. If the -coalesce option appears after all of the input images, all images are coalesced. |
|
-colorize
<value> |
| colorize the image with the fill color |
| Specify the amount of colorization as a percentage. You can apply separate colorization values to the red, green, and blue channels of the image with a colorization value list delimited with slashes (e.g. 0/0/50). |
|
-colormap
<type> |
| define the colormap type |
| Choose between shared or private. |
| This option only a |