A hint: This file contains one or more very long lines, so maybe it is better readable using the pure text view mode that shows the contents as wrapped lines within the browser window.
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3 <html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <title>Composite Image</title> 6 <link rel="StyleSheet" href="style/magick.css" type="text/css" /> 7 </head> 8 <body bgcolor="#FFFFFF" text="#000000" link="#0085C0" 9 vlink="#800080" alink="#0085C0"> 10 <center><img src="images/magick.png" align="bottom" width="114" 11 height="113" /></center> 12 <hr /> 13 <p>A composite operation combines pixels from a different image 14 with your target image. You can control composition by choosing 15 which image to combine, where the combining occurs (the offset from 16 the target image), and how the pixels are combined (composite 17 operation).</p> 18 <p>Select your composite image, press <b>Browse</b> to browse and 19 select your image file or enter the <a href="URL.html">URL</a> of 20 your image. Use <tt>clipboard:</tt> as the filename to import a 21 previously saved image from the ImageMagick Studio clipboard.</p> 22 <p>The offset geometry specifies the (x,y) offset from your target 23 image to combine the composite image. The x and y offset are 24 conveniently specified as one value. For example, to offset the 25 target image by 30 pixels in the horizontal direction and 40 pixels 26 in the vertical use:</p> 27 <pre class="text"> 28 +30+40 29 </pre> 30 <p>For convenience, you can select a gravity instead of an offset 31 geometry. For example, <b>Center</b> centers the image. The 32 location geometry has precedence over any gravity.</p> 33 <p>Finally, you need to specify how the pixels are combined. By 34 default, each of the composite image pixels are replaced by the 35 corresponding image tile pixel. You can choose an alternate 36 composite operation. How each operator behaves is described 37 below.</p> 38 <dl> 39 <dd> 40 <dl> 41 <dt> 42 Clear</dt> 43 <dd> 44 Both the color and the alpha of the destination are cleared. Neither 45 the source nor the destination are used as input. 46 </dd><br /> 47 <dt> 48 Src </dt> 49 <dd> 50 The source is copied to the destination. The destination is not used 51 as input. 52 </dd><br /> 53 <dt> 54 dst </dt> 55 <dd> 56 The destination is left untouched. 57 </dd><br /> 58 <dt> 59 Over </dt> 60 <dd> 61 The source is composited over the destination. 62 </p> 63 64 65 </dd><br /> 66 <dt> 67 DstOver </dt> 68 <dd> 69 The destination is composited over the source and the 70 result replaces the destination. 71 </dd><br /> 72 <dt> 73 In </dt> 74 <dd> 75 The part of the source lying inside of the destination 76 replaces the destination. 77 </p> 78 79 </dd><br /> 80 </dl> 81 <dl> 82 <dt> 83 DstIn </dt> 84 <dd> 85 The part of the destination lying inside of the source 86 replaces the destination. 87 <dt> 88 Out </dt> 89 <dd> 90 The part of the source lying outside of the destination 91 replaces the destination. 92 93 </dd><br /> 94 <dt> 95 DstOut </dt> 96 <dd> 97 The part of the destination lying outside of the source replaces the destination. 98 </dd><br /> 99 <dt> 100 Atop </dt> 101 <dd> 102 The part of the source lying inside of the destination is 103 composited onto the destination. 104 </dd><br /> 105 <dt> 106 DstAtop </dt> 107 <dd> 108 The part of the destination lying inside of the source is composited over the source and replaces the destination. 109 110 </dd><br /> 111 <dt> 112 Xor </dt> 113 <dd> 114 The part of the source that lies outside of the destination is 115 combined with the part of the destination that lies outside of the 116 source. 117 </dd><br /> 118 </dl> 119 <p> 120 The following compositing operators add blending of source and destination colors beyond the base 12 Porter-Duff operations. The behavior of these operators necessitates clamping of the output values after compositing. 121 </p> 122 123 <dl> 124 <dt> 125 Plus </dt> 126 <dd> 127 The source is added to the destination and replaces the destination. This operator is useful for animating a dissolve between two images. 128 129 </dd><br /> 130 <dt> 131 Multiply </dt> 132 <dd> 133 The source is multiplied by the destination and replaces the destination. The resultant color is always at least as dark as either of the two constituent colors. Multiplying any color with black produces black. Multiplying any color with white leaves the original color unchanged. 134 135 <p> 136 </p> 137 138 </dd><br /> 139 <dt> 140 Screen </dt> 141 <dd> 142 The source and destination are complemented and then multiplied and then replace the destination. The resultant color is always at least as light as either of the two constituent colors. Screening any color with white produces white. Screening any color with black leaves the original color unchanged. 143 144 <p> 145 </p> 146 147 </dd><br /> 148 <dt> 149 Overlay </dt> 150 <dd> 151 Multiplies or screens the colors, dependent on the destination color. Source colors overlay the destination whilst preserving its highlights and shadows. The destination color is not replaced, but is mixed with the source color to reflect the lightness or darkness of the destination. 152 153 </dd><br /> 154 <dt> 155 Darken </dt> 156 <dd> 157 Selects the darker of the destination and source colors. The destination is replaced with the source when the source is darker, otherwise it is left unchanged. 158 </dd><br /> 159 <dt> 160 Lighten </dt> 161 <dd> 162 Selects the lighter of the destination and source colors. The destination is replaced with the source when the source is lighter, otherwise it is left unchanged. 163 164 </dd><br /> 165 </dl> 166 <dl> 167 <dt> 168 ColorDodge </dt> 169 <dd> 170 Brightens the destination color to reflect the source color. Painting with black produces no change. 171 172 </dd><br /> 173 <dt> 174 ColorBurn </dt> 175 <dd> 176 Darkens the destination color to reflect the source color. Painting with white produces no change. 177 178 </dd><br /> 179 <dt> 180 HardLight </dt> 181 <dd> 182 Multiplies or screens the colors, dependent on the source color value. If the source color is lighter than 0.5, the destination is lightened as if it were screened. If the source color is darker than 0.5, the destination is darkened, as if it were multiplied. The degree of lightening or darkening is proportional to the difference between the source color and 0.5. If it is equal to 0.5 the destination is unchanged. Painting with pure black or white produces black or white. 183 184 </dd><br /> 185 <dt> 186 SoftLight </dt> 187 <dd> 188 Darkens or lightens the colors, dependent on the source color value. If the source color is lighter than 0.5, the destination is lightened. If the source color is darker than 0.5, the destination is darkened, as if it were burned in. The degree of darkening or lightening is proportional to the difference between the source color and 0.5. If it is equal to 0.5, the destination is unchanged. Painting with pure black or white produces a distinctly darker or lighter area, but does not result in pure black or white. 189 190 </dd><br /> 191 <dt> 192 Difference </dt> 193 <dd> 194 Subtracts the darker of the two constituent colors from the lighter. Painting with white inverts the destination color. Painting with black produces no change. 195 196 </dd><br /> 197 <dt> 198 Exclusion </dt> 199 <dd> 200 Produces an effect similar to that of 'difference', but appears as lower contrast. Painting with white inverts the destination color. Painting with black produces no change. 201 202 </dd> 203 </dl> 204 </dd> 205 </dl></dd></dl> 206 <p>The image compositor requires a matte, or alpha channel in the 207 image for some operations. This extra channel usually defines a 208 mask which represents a sort of a cookie-cutter for the image. This 209 is the case when matte is 255 (full coverage) for pixels inside the 210 shape, zero outside, and between zero and 255 on the boundary. For 211 certain operations, if <em>image</em> does not have an matte 212 channel, it is initialized with 0 for any pixel matching in color 213 to pixel location (0,0), otherwise 255. properly <b>borderwidth</b> 214 must be 0). </p> 215 <hr /> 216 <p> 217 <a href="scripts/MagickStudio.cgi/?Action=mogrify&ToolType=Comment&SessionID=null&Path=null" 218 target="Comment"><img alt="[comment]" src="images/mail.png" 219 border="0" /></a></p> 220 </body> 221 </html>