summaryrefslogtreecommitdiff
path: root/utilities/composite.1
blob: df6a7ce3bfea016ff14c848f93b97403fe8aaabe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
.TH composite 1 "Date: 2009/01/10 01:00:00" "ImageMagick"
.SH NAME
composite \-  overlaps one image over another.
.SH SYNOPSIS
.TP
\fBcomposite\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIchange-file base-file\fP \fB[\fP \fImask-file\fP \fB]\fP \fIoutput-image\fP
.SH OVERVIEW
The \fBcomposite\fP program is a member of the ImageMagick(1) suite of tools.  Use it to overlap one image over another.

For more information about the composite command, point your browser to file:///usr/local/share/doc/ImageMagick-7/www/composite.html or http://imagemagick.org/script/composite.php.
.SH DESCRIPTION
Image Settings:
  \-affine matrix       affine transform matrix
  \-alpha option        on, activate, off, deactivate, set, opaque, copy
                        transparent, extract, background, or shape
  \-authenticate value  decrypt image with this password
  \-blue-primary point  chromaticity blue primary point
  \-colorspace type     alternate image colorspace
  \-comment string      annotate image with comment
  \-compose operator    composite operator
  \-compress type       type of pixel compression when writing the image
  \-decipher filename   convert cipher pixels to plain pixels
  \-define format:option
                       define one or more image format options
  \-depth value         image depth
  \-density geometry    horizontal and vertical density of the image
  \-display server      get image or font from this X server
  \-dispose method      layer disposal method
  \-dither method       apply error diffusion to image
  \-encipher filename   convert plain pixels to cipher pixels
  \-encoding type       text encoding type
  \-endian type         endianness (MSB or LSB) of the image
  \-filter type         use this filter when resizing an image
  \-font name           render text with this font
  \-format "string"     output formatted image characteristics
  \-gravity type        which direction to gravitate towards
  \-green-primary point chromaticity green primary point
  \-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
  \-matte               store matte channel if the image has one
  \-monitor             monitor progress
  \-page geometry       size and location of an image canvas (setting)
  \-pointsize value     font point size
  \-quality value       JPEG/MIFF/PNG compression level
  \-quiet               suppress all warning messages
  \-red-primary point   chromaticity red primary point
  \-regard-warnings     pay attention to warning messages
  \-repage geometry     size and location of an image canvas (operator)
  \-respect-parentheses settings remain in effect until parenthesis boundary
  \-sampling-factor geometry
                       horizontal and vertical sampling factor
  \-scene value         image scene number
  \-seed value          seed a new sequence of pseudo-random numbers
  \-size geometry       width and height of image
  \-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
  \-synchronize         synchronize image to storage device
  \-taint               declare the image as modified
  \-transparent-color color
                       transparent color
  \-treedepth value     color tree depth
  \-tile                repeat composite operation across and down image
  \-units type          the units of image resolution
  \-verbose             print detailed information about the image
  \-virtual-pixel method
                       virtual pixel access method
  \-white-point point   chromaticity white point

Image Operators:
  \-blend geometry      blend images
  \-border geometry     surround image with a border of color
  \-bordercolor color   border color
  \-channel mask        set the image channel mask
  \-colors value        preferred number of colors in the image
  \-displace geometry   shift image pixels defined by a displacement map
  \-dissolve value      dissolve the two images a given percent
  \-distort geometry    shift lookup according to a absolute distortion map
  \-extract geometry    extract area from image
  \-geometry geometry   location of the composite image
  \-identify            identify the format and characteristics of the image
  \-monochrome          transform image to black and white
  \-negate              replace each pixel with its complementary color 
  \-profile filename    add ICM or IPTC information profile to image
  \-quantize colorspace reduce colors in this colorspace
  \-rotate degrees      apply Paeth rotation to the image
  \-resize geometry     resize the image
  \-sharpen geometry    sharpen the image
  \-shave geometry      shave pixels from the image edges
  \-stegano offset      hide watermark within an image
  \-stereo              combine two image to create a stereo anaglyph
  \-strip               strip image of all profiles and comments
  \-thumbnail geometry  create a thumbnail of the image
  \-transform           affine transform image
  \-type type           image type
  \-unsharp geometry    sharpen the image
  \-watermark geometry  percent brightness and saturation of a watermark
  \-write filename      write images to this file

Image Stack Operators:
  \-swap indexes        swap two images in the image sequence

Miscellaneous Options:
  \-debug events        display copious debugging information
  \-help                print program options
  \-log format          format of debugging information
  \-list type           print a list of supported option arguments
  \-version             print version information

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.
.SH SEE ALSO
ImageMagick(1)

.SH COPYRIGHT

\fBCopyright (C) 1999-2018 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/local/share/doc/ImageMagick-7/www/license.html or http://imagemagick.org/script/license.php\fP