Sākums Izpētīt Palīdzība
Pierakstīties
py
/
gaussian-splatting-my
1
0
Atdalīts 0
Faili Problēmas 0 Izmaiņu pieprasījumi 0 Vikivietne
Atzars: main
Atzari Tagi
gaussian-spl...
/
external
/
ImageMagick-7.1.1-Q16-HDRI
/
www
/
Magick++
/
STL.html

STL.html 84 KB
Patstāvīgā saite Vēsture Neapstrādāts

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909 
  1. <?xml version="1.0" encoding="utf-8" ?>
    2. 

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    4. 

  4. <head>
    5. 

  5. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    6. 

  6. <title>Magick++ API: STL Templates</title>
    7. 

  7. <link rel="stylesheet" href="magick.css" type="text/css" />
    8. 

  8. </head>
    9. 

  9. <body>
    10. 

  10. <div class="doc-section">
    11. 

  11. <h1> Magick++ STL Support</h1>
    12. 

  12. Magick++ provides a set of <a href="http://www.sgi.com/tech/stl/">Standard
    13. 

  13. Template Libary</a> (<a href="http://www.sgi.com/tech/stl/">STL</a> )
    14. 

  14. algorithms for operating across ranges of image frames in a container.
    15. 

  15. It also provides a set of STL unary function objects to apply an
    16. 

  16. operation on image frames in a container via an algorithm which uses
    17. 

  17. unary function objects. A good example of a standard algorithm which is
    18. 

  18. useful for processing containers of image frames is the STL <i><a
    19. 

  19.  href="http://www.sgi.com/tech/stl/for_each.html"> for_each</a> </i>
    20. 

  20. algorithm which invokes a unary function object on a range of container
    21. 

  21. elements.
    22. 

  22. <p>Magick++ uses a limited set of template argument types. The current
    23. 

  23. template argument types are: </p>
    24. 

  24. <a href="http://www.sgi.com/tech/stl/Container.html">Container</a>
    25. 

  25. <blockquote>A container having the properties of a <a
    26. 

  26.  href="http://www.sgi.com/tech/stl/BackInsertionSequence.html"> Back
    27. 

  27. Insertion Sequence</a> . Sequences support forward iterators and Back
    28. 

  28. Insertion Sequences support the additional abilty to append an element
    29. 

  29. via push_back(). Common compatable container types are the STL &lt;<a
    30. 

  30.  href="http://www.sgi.com/tech/stl/Vector.html"> vector</a> &gt; and &lt;<a
    31. 

  31.  href="http://www.sgi.com/tech/stl/List.html">list</a> &gt; template
    32. 

  32. containers. This template argument is usually used to represent an
    33. 

  33. output container in which one or more image frames may be appended.
    34. 

  34. Containers like STL &lt;<a href="http://www.sgi.com/tech/stl/Vector.html">vector</a>
    35. 

  35. &gt; which have a given default <i>capacity</i> may need to have their <i>
    36. 

  36. capacity</i> adjusted via r<i>eserve() </i>to a larger <i>capacity</i>
    37. 

  37. in order to support the expected final <i>size</i> . Since Magick++
    38. 

  38. images are very small, it is likely that the default capacity of STL &lt;<a
    39. 

  39.  href="http://www.sgi.com/tech/stl/Vector.html"> vector</a> &gt; is
    40. 

  40. sufficient for most situations.</blockquote>
    41. 

  41.   <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    42. 

  42.   <blockquote>An input iterator used to express a position in a
    43. 

  43. container. These template arguments are typically used to represent a
    44. 

  44. range of elements  with f<i>irst_</i> representing the first element to
    45. 

  45. be processed and <i> last_</i> representing the element to stop at. When
    46. 

  46. processing the entire contents of a container, it is handy to know that
    47. 

  47. STL containers usually provide the begin() and end() methods to return
    48. 

  48. input interators which correspond  with the first and last elements,
    49. 

  49. respectively.</blockquote>
    50. 

  50. <p>The following is an example of how frames from a GIF animation <font
    51. 

  51.  color="#000000"> "test_image_anim.gif" may be appended horizontally
    52. 

  52. with the resulting image written to the file <kbd>appended_image.miff</kbd>:</font></p>
    53. 

  53. <pre class="code">
    54. 

  54. #include &lt;list> 
    55. 

  55. #include &lt;Magick++.h> 
    56. 

  56. using namespace std; 
    57. 

  57. using namespace Magick;
    58. 

  58. 

  59. int main(int argc,char **argv) 
    60. 

  60. { 
    61. 

  61.    InitializeMagick(*argv);
    62. 

  62.    list&lt;Image> imageList; 
    63. 

  63.    readImages( &amp;imageList, "test_image_anim.gif" );
    64. 

  64. 

  65.    Image appended; 
    66. 

  66.    appendImages( &amp;appended, imageList.begin(), imageList.end() ); 
    67. 

  67.    appended.write( "appended_image.miff" ); 
    68. 

  68.    return 0; 
    69. 

  69. }
    70. 

  70. </pre>
    71. 

  71. <p>The available Magick++ specific STL algorithms for operating on
    72. 

  72. sequences of image frames are shown in the following table: <br />
    73. 

  73. &#160;
    74. 

  74. <ul><table border="1" width="100%">
    75. 

  75.   <caption><b>Magick++ STL Algorithms For Image Sequences</b></caption> <tbody>
    76. 

  76.     <tr>
    77. 

  77.       <td>
    78. 

  78.       <center><b>Algorithm</b></center>
    79. 

  79.       </td>
    80. 

  80.       <td>
    81. 

  81.       <center><b>Signature</b></center>
    82. 

  82.       </td>
    83. 

  83.       <td>
    84. 

  84.       <center><b>Description</b></center>
    85. 

  85.       </td>
    86. 

  86.     </tr>
    87. 

  87.     <tr>
    88. 

  88.       <td>
    89. 

  89.       <center><a name="animateImages"></a> <font size="-1">animateImages</font></center>
    90. 

  90.       </td>
    91. 

  91.       <td><font size="-1"><a
    92. 

  92.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    93. 

  93. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    94. 

  94. last_</font></td>
    95. 

  95.       <td><font size="-1">Animate a sequence of image frames. Image
    96. 

  96. frames are  displayed in succession, creating an animated effect. The
    97. 

  97. animation options  are taken from the first image frame. This feature is
    98. 

  98. only supported under  X11 at the moment.</font></td>
    99. 

  99.     </tr>
    100. 

  100.     <tr>
    101. 

  101.       <td>
    102. 

  102.       <center><a name="appendImages"></a> <font size="-1">appendImages</font></center>
    103. 

  103.       </td>
    104. 

  104.       <td><font size="-1"><a href="Image++.html">Image</a>
    105. 

  105. *appendedImage_, <a
    106. 

  106.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    107. 

  107. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    108. 

  108. last_, bool stack_ = false</font></td>
    109. 

  109.       <td><font size="-1">Append a sequence of image frames, writing
    110. 

  110. the result  to <i>appendedImage_.</i> All the input image frames must
    111. 

  111. have the same width or height. Image frames of the same width are
    112. 

  112. stacked top-to-bottom. Image frames of the same height are stacked
    113. 

  113. left-to-right. If the <i>stack_</i> parameter is false, rectangular
    114. 

  114. image frames are stacked left-to-right otherwise top-to-bottom.</font></td>
    115. 

  115.     </tr>
    116. 

  116.     <tr>
    117. 

  117.       <td>
    118. 

  118.       <center><a name="averageImages"></a> <font size="-1">averageImages</font></center>
    119. 

  119.       </td>
    120. 

  120.       <td><font size="-1"><a href="Image++.html">Image</a>
    121. 

  121. *averagedImage_, <a
    122. 

  122.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    123. 

  123. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    124. 

  124. last_</font></td>
    125. 

  125.       <td><font size="-1">Average a sequence of image frames, writing
    126. 

  126. the result  to <i>averagedImage_</i>. All the input image frames must
    127. 

  127. be the same size  in pixels.</font></td>
    128. 

  128.     </tr>
    129. 

  129.     <tr>
    130. 

  130.       <td>
    131. 

  131.       <center><a name="coalesceImages"></a> <font size="-1">coalesceImages</font></center>
    132. 

  132.       </td>
    133. 

  133.       <td><font size="-1"><a
    134. 

  134.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    135. 

  135. *coalescedImages_, <a
    136. 

  136.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    137. 

  137. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    138. 

  138. last_</font><br />
    139. 

  139.       </td>
    140. 

  140.       <td><font size="-1">Create a coalesced image sequence obtained by
    141. 

  141. "playing" the image sequence (observing page offsets and disposal
    142. 

  142. methods) to create a new image sequence in which all frames are full
    143. 

  143. size and completely rendered. Note that if the original image sequence
    144. 

  144. relied on page offsets and disposal methods that the resulting sequence
    145. 

  145. will be larger (perhaps much larger) then the original. This is useful
    146. 

  146. for GIF animation sequences that have page offsets and disposal methods.
    147. 

  147. The resuting image sequence is returned via <i>coalescedImages_.</i></font></td>
    148. 

  148.     </tr>
    149. 

  149.     <tr>
    150. 

  150.       <td>
    151. 

  151.       <center><a name="deconstructImages"></a> <font size="-1">deconstructImages</font></center>
    152. 

  152.       </td>
    153. 

  153.       <td><font size="-1"><a
    154. 

  154.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    155. 

  155. *deconstructedImages_, <a
    156. 

  156.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    157. 

  157. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    158. 

  158. last_</font></td>
    159. 

  159.       <td><font size="-1">Break down an image sequence into constituent
    160. 

  160. parts.&#160; This is useful for creating GIF or MNG animation sequences.
    161. 

  161. The input sequence  is specified by <i>first_</i> and <i>last_</i>, and
    162. 

  162. the deconstructed images  are returned via <i>deconstructedImages_</i>.</font></td>
    163. 

  163.     </tr>
    164. 

  164.     <tr>
    165. 

  165.       <td>
    166. 

  166.       <center><a name="displayImages"></a> <font size="-1">displayImages</font></center>
    167. 

  167.       </td>
    168. 

  168.       <td><font size="-1"><a
    169. 

  169.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    170. 

  170. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    171. 

  171. last_</font></td>
    172. 

  172.       <td><font size="-1">Display a sequence of image frames. Through
    173. 

  173. use of a pop-up menu, image frames may be selected in succession. This
    174. 

  174. feature is  fully supported under X11 but may have only limited support
    175. 

  175. in other environments.</font> <br />
    176. 

  176.       <font size="-1"><b><font color="#ff0000">Caution: </font></b> if
    177. 

  177. an image format is not compatable with the display visual (e.g. JPEG
    178. 

  178. on a colormapped display) then the original image will be altered. Use a
    179. 

  179. copy of the original if this is a problem.</font></td>
    180. 

  180.     </tr>
    181. 

  181.     <tr>
    182. 

  182.       <td>
    183. 

  183.       <center><a name="flattenImages"></a> <font size="-1">flattenImages</font></center>
    184. 

  184.       </td>
    185. 

  185.       <td><font size="-1"><a href="Image++.html">Image</a>
    186. 

  186. *flattendImage_, <a
    187. 

  187.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    188. 

  188. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    189. 

  189. last_</font></td>
    190. 

  190.       <td><font size="-1">Merge a sequence of image frames which
    191. 

  191. represent image  layers into a single composited representation. The <i>flattendImage_</i>
    192. 

  192. parameter points to an existing Image to update with the flattened
    193. 

  193. image. This function is useful for combining Photoshop layers into a
    194. 

  194. single image.</font></td>
    195. 

  195.     </tr>
    196. 

  196.     <tr>
    197. 

  197.       <td>
    198. 

  198.       <center><a name="forwardFourierTransformImage"></a> <font size="-1">forwardFourierTransformImage</font></center>
    199. 

  199.       </td>
    200. 

  200.       <td><font size="-1"><a
    201. 

  201.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    202. 

  202. *fourierImages_, const Image &amp;image_ </font></td>
    203. 

  203.       <td><font size="-1"> Implements the discrete Fourier transform (DFT) of the image as a magnitude / phase image pair via <i>fourierImages_</i>.</font></td>
    204. 

  204.     </tr>
    205. 

  205.     <tr>
    206. 

  206.       <td>
    207. 

  207.       <center><a name="forwardFourierTransformImage"></a> <font size="-1">forwardFourierTransformImage</font></center>
    208. 

  208.       </td>
    209. 

  209.       <td><font size="-1"><a
    210. 

  210.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    211. 

  211. *fourierImages_, const Image &amp;image_, const bool magnitude_ </font></td>
    212. 

  212.       <td><font size="-1"> Implements the discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair via <i>fourierImages_</i>.</font></td>
    213. 

  213.     </tr>
    214. 

  214.     <tr>
    215. 

  215.       <td>
    216. 

  216.       <center><a name="mapImages"></a> <font size="-1">mapImages</font></center>
    217. 

  217.       </td>
    218. 

  218.       <td><font size="-1"><a
    219. 

  219.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    220. 

  220. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    221. 

  221. last_, const <a href="Image++.html">Image</a> &amp; mapImage_, bool
    222. 

  222. dither_,&#160; bool measureError_ = false</font></td>
    223. 

  223.       <td><font size="-1">Replace the colors of a sequence of images
    224. 

  224. with the closest color from a reference image. Set <i>dither_</i> to <i>true</i>
    225. 

  225. to enable dithering.&#160; Set <i>measureError_</i> to <i>true</i> in
    226. 

  226. order to evaluate quantization error.</font></td>
    227. 

  227.     </tr>
    228. 

  228.     <tr>
    229. 

  229.       <td>
    230. 

  230.       <center><a name="montageImages"></a> <font size="-1">montageImages</font></center>
    231. 

  231.       </td>
    232. 

  232.       <td><font size="-1"><a
    233. 

  233.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    234. 

  234. *montageImages_, <a
    235. 

  235.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    236. 

  236. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    237. 

  237. last_, const <a href="Montage.html">Montage</a> &amp;montageOpts_</font></td>
    238. 

  238.       <td><font size="-1">Create a composite image by combining several
    239. 

  239. separate image frames. Multiple frames may be generated in the output
    240. 

  240. container <i> montageImages_ </i>depending on the tile setting and the
    241. 

  241. number of image frames montaged. Montage options are provided via the
    242. 

  242. parameter <i>montageOpts_</i> . Options set in the first image frame (<a
    243. 

  243.  href="Image++.html#backgroundColor"> backgroundColor,</a> <a
    244. 

  244.  href="Image++.html#borderColor">borderColor</a> , <a
    245. 

  245.  href="Image++.html#matteColor">matteColor</a> , <a
    246. 

  246.  href="Image++.html#penColor">penColor,</a> <a href="Image++.html#font">font,</a>
    247. 

  247. and <a href="Image++.html#fontPointsize">fontPointsize</a> ) are also used
    248. 

  248. as options by <i>montageImages().</i></font></td>
    249. 

  249.     </tr>
    250. 

  250.     <tr>
    251. 

  251.       <td>
    252. 

  252.       <center><a name="morphImages"></a> <font size="-1">morphImages</font></center>
    253. 

  253.       </td>
    254. 

  254.       <td><font size="-1"><a
    255. 

  255.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    256. 

  256. *morphedImages_, <a
    257. 

  257.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    258. 

  258. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    259. 

  259. last_, size_t frames_</font></td>
    260. 

  260.       <td><font size="-1">Morph a seqence of image frames. This
    261. 

  261. algorithm&#160; expands the number of image frames (output to the
    262. 

  262. container <i>morphedImages_)</i> by adding the number of intervening
    263. 

  263. frames specified by <i>frames_</i> such that the original frames morph
    264. 

  264. (blend) into each other when played as an animation.</font></td>
    265. 

  265.     </tr>
    266. 

  266.     <tr>
    267. 

  267.       <td>
    268. 

  268.       <center><a name="mosaicImages"></a> <font size="-1">mosaicImages</font></center>
    269. 

  269.       </td>
    270. 

  270.       <td><font size="-1"><a href="Image++.html">Image</a> *mosaicImage_, <a
    271. 

  271.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    272. 

  272. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    273. 

  273. last_</font></td>
    274. 

  274.       <td><font size="-1">Inlay a number of images to form a single
    275. 

  275. coherent picture. The <i>mosicImage_</i> argument is updated with a
    276. 

  276. mosaic constructed from the image sequence represented by <i>first_</i>
    277. 

  277. through <i>last_</i> .</font></td>
    278. 

  278.     </tr>
    279. 

  279.     <tr>
    280. 

  280.       <td><center><a name="quantizeImages"></a> <font size="-1">quantizeImages</font></center></td>
    281. 

  281.       <td><font size="-1"><a
    282. 

  282.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    283. 

  283. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    284. 

  284. last_, bool measureError_ = false</font></td>
    285. 

  285.       <td><font size="-1">Quantize colors in images using current
    286. 

  286. quantization settings. Set <i>measureError_</i> to <i>true</i> in order
    287. 

  287. to measure quantization  error.</font></td>
    288. 

  288.     </tr>
    289. 

  289.     <tr>
    290. 

  290.       <td rowspan="2">
    291. 

  291.       <center><a name="readImages"></a> <font size="-1">readImages</font></center>
    292. 

  292.       </td>
    293. 

  293.       <td><font size="-1"><a
    294. 

  294.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    295. 

  295. *sequence_, const std::string &amp;imageSpec_</font></td>
    296. 

  296.       <td><font size="-1">Read a sequence of image frames into existing
    297. 

  297. container (appending to container <i>sequence_</i>) with image names
    298. 

  298. specified in the UTF-8 string <i>imageSpec_</i>.</font></td>
    299. 

  299.     </tr>
    300. 

  300.     <tr>
    301. 

  301.       <td><font size="-1"><a
    302. 

  302.  href="http://www.sgi.com/tech/stl/Container.html"> Container</a>
    303. 

  303. *sequence_, const <a href="Blob.html">Blob</a> &amp;blob_</font></td>
    304. 

  304.       <td><font size="-1">Read a sequence of image frames into existing
    305. 

  305. container (appending to container sequence_) from <a href="Blob.html">Blob</a>
    306. 

  306. blob_.</font></td>
    307. 

  307.     </tr>
    308. 

  308.     <tr>
    309. 

  309.       <td rowspan="2">
    310. 

  310.       <center><a name="writeImages"></a> <font size="-1">writeImages</font></center>
    311. 

  311.       </td>
    312. 

  312.       <td><font size="-1"><a
    313. 

  313.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    314. 

  314. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    315. 

  315. last_, const std::string &amp;imageSpec_, bool adjoin_ = true</font></td>
    316. 

  316.       <td><font size="-1">Write images in container to file specified
    317. 

  317. by string <i>imageSpec_</i>. Set <i>adjoin_ </i>to false to write a
    318. 

  318. set of image frames via a wildcard <i>imageSpec_ </i>(e.g.
    319. 

  319. image%02d.miff).</font> <br />
    320. 

  320. The wildcard must be one of <tt>%0Nd, %0No, or %0Nx</tt>. <br />
    321. 

  321.       <font size="-1"><b><font color="#ff0000">Caution: </font></b> if
    322. 

  322. an image format is selected which is capable of supporting fewer colors
    323. 

  323. than the original image or quantization has been requested, the original
    324. 

  324. image will be quantized to fewer colors. Use a copy of the original if
    325. 

  325. this is a problem.</font></td>
    326. 

  326.     </tr>
    327. 

  327.     <tr>
    328. 

  328.       <td><font size="-1"><a
    329. 

  329.  href="http://www.sgi.com/tech/stl/InputIterator.html"> InputIterator</a>
    330. 

  330. first_, <a href="http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
    331. 

  331. last_, <a href="Blob.html">Blob</a> *blob_, bool adjoin_ = true</font></td>
    332. 

  332.       <td><font size="-1">Write images in container to in-memory BLOB
    333. 

  333. specified by <a href="Blob.html">Blob</a> blob_. Set adjoin_ to false to
    334. 

  334. write a set of image frames via a wildcard imageSpec_ (e.g.
    335. 

  335. image%02d.miff).</font> <br />
    336. 

  336.       <font size="-1"><b><font color="#ff0000">Caution:</font></b> if an
    337. 

  337. image format is selected which is capable of supporting fewer colors
    338. 

  338. than the original image or quantization has been requested, the original
    339. 

  339. image will be quantized to fewer colors. Use a copy of the original if
    340. 

  340. this is a problem.</font></td>
    341. 

  341.     </tr>
    342. 

  342.   </tbody>
    343. 

  343. </table></ul>
    344. 

  344. <p>In addition, we support these yet to be documented methods: <code>combineImages()</code>, <code>evaluateImages()</code>, <code>mergeImageLayers()</code>, <code>optimizeImageLayers()</code>, <code>optimizePlusImageLayers()</code>, and <code>separateImages()</code>.</p>
    345. 

  345. <br />
    346. 

  346. &#160; </p>
    347. 

  347. <center>
    348. 

  348. <h3> Magick++ Unary Function Objects</h3>
    349. 

  349. </center>
    350. 

  350. Magick++ unary function objects inherit from the STL unary_function
    351. 

  351. template class . The STL unary_function template class is of the form
    352. 

  352. <pre class="text"><tt><font color="#000099">unary_function&lt;Arg, Result&gt;</font></tt></pre>
    353. 

  353. and expects that derived classes implement a method of the form:
    354. 

  354. <pre class="text"><tt><font color="#000099">Result operator()( Arg argument_);</font></tt></pre>
    355. 

  355. which is invoked by algorithms using the function object. In the case
    356. 

  356. of unary function objects defined by Magick++, the invoked function
    357. 

  357. looks like:
    358. 

  358. <pre class="text"><tt><font color="#000099">void operator()( Image &amp;image_);</font></tt></pre>
    359. 

  359. with a typical implementation looking similar to:
    360. 

  360. <pre class="text"><tt><font color="#000099">void operator()( Image &amp;image_ )</font></tt> <br />
    361. 

  361.   <tt><font color="#000099">&#160; {</font></tt> <br />
    362. 

  362.   <tt><font color="#000099">&#160;&#160;&#160; image_.contrast(
    363. 

  363. _sharpen );</font></tt> <br />
    364. 

  364.   <tt><font color="#000099">&#160; }</font></tt></pre>
    365. 

  365. where <i>contrast</i> is an Image method and <i>_sharpen </i>is an
    366. 

  366. argument stored within the function object by its contructor. Since
    367. 

  367. constructors may be polymorphic, a given function object may have
    368. 

  368. several constructors and selects the appropriate Image method based on
    369. 

  369. the arguments supplied.
    370. 

  370. <p>In essence, unary function objects (as provided by Magick++) simply
    371. 

  371. provide the means to construct an object which caches arguments for
    372. 

  372. later use by an algorithm designed for use with unary function objects.
    373. 

  373. There is a unary function object corresponding each algorithm provided
    374. 

  374. by the <a href="Image++.html"> Image</a> class and there is a contructor
    375. 

  375. available compatable with each synonymous  method in the Image class. </p>
    376. 

  376. <p>The unary function objects that Magick++ provides to support
    377. 

  377. manipulating images are shown in the following table: <br />
    378. 

  378. &#160;
    379. 

  379. <ul><table border="1">
    380. 

  380.   <caption><b>Magick++ Unary Function Objects For Image Manipulation</b></caption> <tbody>
    381. 

  381.     <tr align="center">
    382. 

  382.       <td><b>Function Object</b></td>
    383. 

  383.       <td><b>Constructor Signatures(s)</b></td>
    384. 

  384.       <td><b>Description</b></td>
    385. 

  385.     </tr>
    386. 

  386.     <tr>
    387. 

  387.       <td valign="middle">
    388. 

  388.       <div align="center"><a name="adaptiveThresholdImage"></a> <font
    389. 

  389.  size="-1">adaptiveThresholdImage</font><br />
    390. 

  390.       </div>
    391. 

  391.       </td>
    392. 

  392.       <td valign="middle"><font size="-1">size_t width, size_t
    393. 

  393. height, unsigned offset = 0</font><br />
    394. 

  394.       </td>
    395. 

  395.       <td valign="top"><font size="-1">Apply adaptive thresholding to
    396. 

  396. the image. Adaptive thresholding is useful if the ideal threshold level
    397. 

  397. is not known in advance, or if the illumination gradient is not constant
    398. 

  398. across the image. Adaptive thresholding works by evaulating the mean
    399. 

  399. (average) of a pixel region (size specified by <i>width</i> and <i>height</i>)
    400. 

  400. and using the mean as the thresholding value. In order to remove
    401. 

  401. residual noise from the background, the threshold may be adjusted by
    402. 

  402. subtracting a constant <i>offset</i> (default zero) from the mean to
    403. 

  403. compute the threshold.</font><br />
    404. 

  404.       </td>
    405. 

  405.     </tr>
    406. 

  406.     <tr>
    407. 

  407.       <td>
    408. 

  408.       <center><a name="addNoiseImage"></a> <font size="-1">addNoiseImage</font></center>
    409. 

  409.       </td>
    410. 

  410.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#NoiseType">NoiseType</a>
    411. 

  411. noiseType_</font></td>
    412. 

  412.       <td><font size="-1">Add noise to image with specified noise type.</font></td>
    413. 

  413.     </tr>
    414. 

  414.     <tr>
    415. 

  415.       <td style="vertical-align: middle;"><small><a
    416. 

  416.  name="affineTransformImage"></a>affineTransformImage<br />
    417. 

  417.       </small></td>
    418. 

  418.       <td style="vertical-align: middle;"><small>const DrawableAffine
    419. 

  419. &amp;affine_<br />
    420. 

  420.       </small></td>
    421. 

  421.       <td style="vertical-align: middle;"><small>Transform image by
    422. 

  422. specified affine (or free transform) matrix.<br />
    423. 

  423.       </small></td>
    424. 

  424.     </tr>
    425. 

  425.     <tr>
    426. 

  426.       <td rowspan="4">
    427. 

  427.       <center><a name="annotateImage"></a> <font size="-1">annotateImage</font></center>
    428. 

  428.       </td>
    429. 

  429.       <td><font size="-1">const std::string &amp;text_, const <a
    430. 

  430.  href="Geometry.html"> Geometry</a> &amp;location_</font></td>
    431. 

  431.       <td><font size="-1">Annotate with text using specified text,
    432. 

  432. bounding area,  placement gravity, and rotation. If <i>boundingArea_</i>
    433. 

  433. is invalid, then  bounding area is entire image.</font></td>
    434. 

  434.     </tr>
    435. 

  435.     <tr>
    436. 

  436.       <td><font size="-1">std::string text_, const <a
    437. 

  437.  href="Geometry.html">Geometry</a> &amp;boundingArea_, <a
    438. 

  438.  href="https://imagemagick.org/Magick++/Enumerations.html#GravityType">GravityType</a> gravity_</font></td>
    439. 

  439.       <td><font size="-1">Annotate using specified text, bounding area,
    440. 

  440. and placement  gravity. If <i>boundingArea_</i> is invalid, then
    441. 

  441. bounding area is entire  image.</font></td>
    442. 

  442.     </tr>
    443. 

  443.     <tr>
    444. 

  444.       <td><font size="-1">const std::string &amp;text_, const <a
    445. 

  445.  href="Geometry.html"> Geometry</a> &amp;boundingArea_, <a
    446. 

  446.  href="https://imagemagick.org/Magick++/Enumerations.html#GravityType">GravityType</a> gravity_, double
    447. 

  447. degrees_,&#160;</font></td>
    448. 

  448.       <td><font size="-1">Annotate with text using specified text,
    449. 

  449. bounding area,  placement gravity, and rotation. If <i>boundingArea_</i>
    450. 

  450. is invalid, then  bounding area is entire image.</font></td>
    451. 

  451.     </tr>
    452. 

  452.     <tr>
    453. 

  453.       <td><font size="-1">const std::string &amp;text_, <a
    454. 

  454.  href="https://imagemagick.org/Magick++/Enumerations.html#GravityType"> GravityType</a> gravity_</font></td>
    455. 

  455.       <td><font size="-1">Annotate with text (bounding area is entire
    456. 

  456. image) and placement gravity.</font></td>
    457. 

  457.     </tr>
    458. 

  458.     <tr>
    459. 

  459.       <td>
    460. 

  460.       <center><a name="blurImage"></a> <font size="-1">blurImage</font></center>
    461. 

  461.       </td>
    462. 

  462.       <td><font size="-1">const double radius_ = 1, const double sigma_
    463. 

  463. = 0.5</font></td>
    464. 

  464.       <td><font size="-1">Blur image. The radius_ parameter specifies
    465. 

  465. the radius  of the Gaussian, in pixels, not counting the center
    466. 

  466. pixel.&#160; The sigma_  parameter specifies the standard deviation of
    467. 

  467. the Laplacian, in pixels.</font></td>
    468. 

  468.     </tr>
    469. 

  469.     <tr>
    470. 

  470.       <td>
    471. 

  471.       <center><a name="borderImage"></a> <font size="-1">borderImage</font></center>
    472. 

  472.       </td>
    473. 

  473.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    474. 

  474. &amp;geometry_ = "6x6+0+0"</font></td>
    475. 

  475.       <td><font size="-1">Border image (add border to image).&#160; The
    476. 

  476. color of the border is specified by the <i>borderColor</i> attribute.</font></td>
    477. 

  477.     </tr>
    478. 

  478.     <tr>
    479. 

  479.       <td>
    480. 

  480.       <center><a name="charcoalImage"></a> <font size="-1">charcoalImage</font></center>
    481. 

  481.       </td>
    482. 

  482.       <td><font size="-1">const double radius_ = 1, const double sigma_
    483. 

  483. = 0.5</font></td>
    484. 

  484.       <td><font size="-1">Charcoal effect image (looks like charcoal
    485. 

  485. sketch). The radius_ parameter specifies the radius of the Gaussian, in
    486. 

  486. pixels, not  counting the center pixel.&#160; The sigma_ parameter
    487. 

  487. specifies the standard  deviation of the Laplacian, in pixels.</font></td>
    488. 

  488.     </tr>
    489. 

  489.     <tr>
    490. 

  490.       <td>
    491. 

  491.       <center><a name="chopImage"></a> <font size="-1">chopImage</font></center>
    492. 

  492.       </td>
    493. 

  493.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    494. 

  494. &amp;geometry_</font></td>
    495. 

  495.       <td><font size="-1">Chop image (remove vertical or horizontal
    496. 

  496. subregion of image)</font></td>
    497. 

  497.     </tr>
    498. 

  498.     <tr>
    499. 

  499.       <td rowspan="2">
    500. 

  500.       <center><a name="colorizeImage"></a> <font size="-1">colorizeImage</font></center>
    501. 

  501.       </td>
    502. 

  502.       <td><font size="-1">const size_t opacityRed_, const
    503. 

  503. size_t opacityGreen_, const size_t opacityBlue_, const Color
    504. 

  504. &amp;penColor_</font></td>
    505. 

  505.       <td><font size="-1">Colorize image with pen color, using
    506. 

  506. specified percent  opacity for red, green, and blue quantums.</font></td>
    507. 

  507.     </tr>
    508. 

  508.     <tr>
    509. 

  509.       <td><font size="-1">const size_t opacity_, const <a
    510. 

  510.  href="Color.html"> Color</a> &amp;penColor_</font></td>
    511. 

  511.       <td><font size="-1">Colorize image with pen color, using
    512. 

  512. specified percent  opacity.</font></td>
    513. 

  513.     </tr>
    514. 

  514.     <tr>
    515. 

  515.       <td>
    516. 

  516.       <center><a name="commentImage"></a> <font size="-1">commentImage</font></center>
    517. 

  517.       </td>
    518. 

  518.       <td><font size="-1">const std::string &amp;comment_</font></td>
    519. 

  519.       <td><font size="-1">Comment image (add comment string to
    520. 

  520. image).&#160; By default, each image is commented with its file name.
    521. 

  521. Use&#160; this&#160;  method to&#160; assign a specific comment to the
    522. 

  522. image.&#160; Optionally you can include the image filename, type, width,
    523. 

  523. height, or other&#160; image&#160; attributes by embedding <a
    524. 

  524.  href="https://imagemagick.org/Magick++/FormatCharacters.html">special format characters.</a> </font></td>
    525. 

  525.     </tr>
    526. 

  526.     <tr>
    527. 

  527.       <td rowspan="2">
    528. 

  528.       <center><a name="compositeImage"></a> <font size="-1">compositeImage</font></center>
    529. 

  529.       </td>
    530. 

  530.       <td><font size="-1">const <a href="Image++.html">Image</a>
    531. 

  531. &amp;compositeImage_, ssize_t xOffset_, ssize_t yOffset_, <a
    532. 

  532.  href="https://imagemagick.org/Magick++/Enumerations.html#CompositeOperator"> CompositeOperator</a>
    533. 

  533. compose_ = <i>InCompositeOp</i></font></td>
    534. 

  534.       <td rowspan="2"><font size="-1">Compose an image onto another at
    535. 

  535. specified offset and using specified algorithm</font></td>
    536. 

  536.     </tr>
    537. 

  537.     <tr>
    538. 

  538.       <td><font size="-1">const <a href="Image++.html">Image</a>
    539. 

  539. &amp;compositeImage_, const Geometry &amp;offset_, <a
    540. 

  540.  href="https://imagemagick.org/Magick++/Enumerations.html#CompositeOperator"> CompositeOperator</a>
    541. 

  541. compose_ = <i>InCompositeOp</i></font></td>
    542. 

  542.     </tr>
    543. 

  543.     <tr>
    544. 

  544.       <td>
    545. 

  545.       <center><a name="condenseImage"></a> <font size="-1">condenseImage</font></center>
    546. 

  546.       </td>
    547. 

  547.       <td><font size="-1">void</font></td>
    548. 

  548.       <td><font size="-1">Condense image (Re-run-length encode image in
    549. 

  549. memory).</font></td>
    550. 

  550.     </tr>
    551. 

  551.     <tr>
    552. 

  552.       <td>
    553. 

  553.       <center><a name="contrastImage"></a> <font size="-1">contrastImage</font></center>
    554. 

  554.       </td>
    555. 

  555.       <td><font size="-1">size_t sharpen_</font></td>
    556. 

  556.       <td><font size="-1">Contrast image (enhance intensity differences
    557. 

  557. in image)</font></td>
    558. 

  558.     </tr>
    559. 

  559.     <tr>
    560. 

  560.       <td>
    561. 

  561.       <center><a name="cropImage"></a> <font size="-1">cropImage</font></center>
    562. 

  562.       </td>
    563. 

  563.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    564. 

  564. &amp;geometry_</font></td>
    565. 

  565.       <td><font size="-1">Crop image (subregion of original image)</font></td>
    566. 

  566.     </tr>
    567. 

  567.     <tr>
    568. 

  568.       <td>
    569. 

  569.       <center><a name="cycleColormapImage"></a> <font size="-1">cycleColormap-</font> <br />
    570. 

  570.       <font size="-1">Image</font></center>
    571. 

  571.       </td>
    572. 

  572.       <td><font size="-1">int amount_</font></td>
    573. 

  573.       <td><font size="-1">Cycle image colormap</font></td>
    574. 

  574.     </tr>
    575. 

  575.     <tr>
    576. 

  576.       <td>
    577. 

  577.       <center><a name="despeckleImage"></a> <font size="-1">despeckleImage</font></center>
    578. 

  578.       </td>
    579. 

  579.       <td><font size="-1">void</font></td>
    580. 

  580.       <td><font size="-1">Despeckle image (reduce speckle noise)</font></td>
    581. 

  581.     </tr>
    582. 

  582.     <tr>
    583. 

  583.       <td rowspan="2">
    584. 

  584.       <center><a name="drawImage"></a> <font size="-1">drawImage</font></center>
    585. 

  585.       </td>
    586. 

  586.       <td><font size="-1">const <a href="Drawable.html">Drawable</a>
    587. 

  587. &amp;drawable_</font></td>
    588. 

  588.       <td><font size="-1">Draw shape or text on image.</font></td>
    589. 

  589.     </tr>
    590. 

  590.     <tr>
    591. 

  591.       <td><font size="-1">const std::list&lt;<a href="Drawable.html">Drawable</a>
    592. 

  592. &gt; &amp;drawable_</font></td>
    593. 

  593.       <td><font size="-1">Draw shapes or text on image using a set of
    594. 

  594. Drawable objects contained in an STL list. Use of this method improves
    595. 

  595. drawing performance  and allows batching draw objects together in a list
    596. 

  596. for repeated use.</font></td>
    597. 

  597.     </tr>
    598. 

  598.     <tr>
    599. 

  599.       <td>
    600. 

  600.       <center><a name="edgeImage"></a> <font size="-1">edgeImage</font></center>
    601. 

  601.       </td>
    602. 

  602.       <td><font size="-1">size_t radius_ = 0.0</font></td>
    603. 

  603.       <td><font size="-1">Edge image (hilight edges in image).&#160;
    604. 

  604. The radius  is the radius of the pixel neighborhood.. Specify a radius
    605. 

  605. of zero for automatic radius selection.</font></td>
    606. 

  606.     </tr>
    607. 

  607.     <tr>
    608. 

  608.       <td>
    609. 

  609.       <center><a name="embossImage"></a> <font size="-1">embossImage</font></center>
    610. 

  610.       </td>
    611. 

  611.       <td><font size="-1">const double radius_ = 1, const double sigma_
    612. 

  612. = 0.5</font></td>
    613. 

  613.       <td><font size="-1">Emboss image (hilight edges with 3D effect).
    614. 

  614. The radius_  parameter specifies the radius of the Gaussian, in pixels,
    615. 

  615. not counting the center pixel.&#160; The sigma_ parameter specifies the
    616. 

  616. standard deviation  of the Laplacian, in pixels.</font></td>
    617. 

  617.     </tr>
    618. 

  618.     <tr>
    619. 

  619.       <td>
    620. 

  620.       <center><a name="enhanceImage"></a> <font size="-1">enhanceImage</font></center>
    621. 

  621.       </td>
    622. 

  622.       <td><font size="-1">void</font></td>
    623. 

  623.       <td><font size="-1">Enhance image (minimize noise)</font></td>
    624. 

  624.     </tr>
    625. 

  625.     <tr>
    626. 

  626.       <td>
    627. 

  627.       <center><a name="equalizeImage"></a> <font size="-1">equalizeImage</font></center>
    628. 

  628.       </td>
    629. 

  629.       <td><font size="-1">void</font></td>
    630. 

  630.       <td><font size="-1">Equalize image (histogram equalization)</font></td>
    631. 

  631.     </tr>
    632. 

  632.     <tr>
    633. 

  633.       <td>
    634. 

  634.       <center><a name="flipImage"></a> <font size="-1">flipImage</font></center>
    635. 

  635.       </td>
    636. 

  636.       <td><font size="-1">void</font></td>
    637. 

  637.       <td><font size="-1">Flip image (reflect each scanline in the
    638. 

  638. vertical direction)</font></td>
    639. 

  639.     </tr>
    640. 

  640.     <tr>
    641. 

  641.       <td rowspan="4">
    642. 

  642.       <center><a name="floodFillColorImage"></a> <font size="-1">floodFill-</font> <br />
    643. 

  643.       <font size="-1">ColorImage</font></center>
    644. 

  644.       </td>
    645. 

  645.       <td><font size="-1">ssize_t x_, ssize_t y_, const <a
    646. 

  646.  href="Color.html"> Color</a> &amp;fillColor_</font></td>
    647. 

  647.       <td rowspan="2"><font size="-1">Flood-fill color across pixels
    648. 

  648. that match  the color of the target pixel and are neighbors of the
    649. 

  649. target pixel. Uses  current fuzz setting when determining color match.</font></td>
    650. 

  650.     </tr>
    651. 

  651.     <tr>
    652. 

  652.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    653. 

  653. &amp;point_, const <a href="Color.html">Color</a> &amp;fillColor_</font></td>
    654. 

  654.     </tr>
    655. 

  655.     <tr>
    656. 

  656.       <td><font size="-1">ssize_t x_, ssize_t y_, const <a
    657. 

  657.  href="Color.html"> Color</a> &amp;fillColor_, const <a href="Color.html">Color</a>
    658. 

  658. &amp;borderColor_</font></td>
    659. 

  659.       <td rowspan="2"><font size="-1">Flood-fill color across pixels
    660. 

  660. starting at target-pixel and stopping at pixels matching specified
    661. 

  661. border color. Uses  current fuzz setting when determining color match.</font></td>
    662. 

  662.     </tr>
    663. 

  663.     <tr>
    664. 

  664.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    665. 

  665. &amp;point_, const <a href="Color.html">Color</a> &amp;fillColor_, const <a
    666. 

  666.  href="Color.html">Color</a> &amp;borderColor_</font></td>
    667. 

  667.     </tr>
    668. 

  668.     <tr>
    669. 

  669.       <td rowspan="4">
    670. 

  670.       <center><a name="floodFillTextureImage"></a> <font size="-1">floodFill-</font> <br />
    671. 

  671.       <font size="-1">TextureImage</font></center>
    672. 

  672.       </td>
    673. 

  673.       <td><font size="-1">ssize_t x_, ssize_t y_,&#160; const <a
    674. 

  674.  href="Image++.html"> Image</a> &amp;texture_</font></td>
    675. 

  675.       <td rowspan="2"><font size="-1">Flood-fill texture across pixels
    676. 

  676. that match  the color of the target pixel and are neighbors of the
    677. 

  677. target pixel. Uses  current fuzz setting when determining color match.</font></td>
    678. 

  678.     </tr>
    679. 

  679.     <tr>
    680. 

  680.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    681. 

  681. &amp;point_, const Image &amp;texture_</font></td>
    682. 

  682.     </tr>
    683. 

  683.     <tr>
    684. 

  684.       <td><font size="-1">ssize_t x_, ssize_t y_, const Image
    685. 

  685. &amp;texture_, const <a href="Color.html">Color</a> &amp;borderColor_</font></td>
    686. 

  686.       <td rowspan="2"><font size="-1">Flood-fill texture across pixels
    687. 

  687. starting at target-pixel and stopping at pixels matching specified
    688. 

  688. border color. Uses current fuzz setting when determining color match.</font></td>
    689. 

  689.     </tr>
    690. 

  690.     <tr>
    691. 

  691.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    692. 

  692. &amp;point_, const Image &amp;texture_, const <a href="Color.html">Color</a>
    693. 

  693. &amp;borderColor_</font></td>
    694. 

  694.     </tr>
    695. 

  695.     <tr>
    696. 

  696.       <td>
    697. 

  697.       <center><a name="flopImage"></a> <font size="-1">flopImage</font></center>
    698. 

  698.       </td>
    699. 

  699.       <td><font size="-1">void&#160;</font></td>
    700. 

  700.       <td><font size="-1">Flop image (reflect each scanline in the
    701. 

  701. horizontal direction)</font></td>
    702. 

  702.     </tr>
    703. 

  703.     <tr>
    704. 

  704.       <td rowspan="2">
    705. 

  705.       <center><a name="frameImage"></a> <font size="-1">frameImage</font></center>
    706. 

  706.       </td>
    707. 

  707.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    708. 

  708. &amp;geometry_ = "25x25+6+6"</font></td>
    709. 

  709.       <td rowspan="2"><font size="-1">Add decorative frame around image</font></td>
    710. 

  710.     </tr>
    711. 

  711.     <tr>
    712. 

  712.       <td><font size="-1">size_t width_, size_t height_,
    713. 

  713. ssize_t x_, ssize_t  y_, ssize_t innerBevel_ = 0, ssize_t outerBevel_ = 0</font></td>
    714. 

  714.     </tr>
    715. 

  715.     <tr>
    716. 

  716.       <td rowspan="2">
    717. 

  717.       <center><a name="gammaImage"></a> <font size="-1">gammaImage</font></center>
    718. 

  718.       </td>
    719. 

  719.       <td><font size="-1">double gamma_</font></td>
    720. 

  720.       <td><font size="-1">Gamma correct image (uniform red, green, and
    721. 

  721. blue correction).</font></td>
    722. 

  722.     </tr>
    723. 

  723.     <tr>
    724. 

  724.       <td><font size="-1">double gammaRed_, double gammaGreen_, double
    725. 

  725. gammaBlue_</font></td>
    726. 

  726.       <td><font size="-1">Gamma correct red, green, and blue channels
    727. 

  727. of image.</font></td>
    728. 

  728.     </tr>
    729. 

  729.     <tr>
    730. 

  730.       <td>
    731. 

  731.       <center><a name="gaussianBlur"></a> <font size="-1">gaussianBlurImage</font></center>
    732. 

  732.       </td>
    733. 

  733.       <td><font size="-1">double width_, double sigma_</font></td>
    734. 

  734.       <td><font size="-1">Gaussian blur image. The number of neighbor
    735. 

  735. pixels to be included in the convolution mask is specified by
    736. 

  736. 'width_'.&#160; For  example, a width of one gives a (standard) 3x3
    737. 

  737. convolution mask. The standard  deviation of the gaussian bell curve is
    738. 

  738. specified by 'sigma_'.</font></td>
    739. 

  739.     </tr>
    740. 

  740.     <tr>
    741. 

  741.       <td>
    742. 

  742.       <center><a name="implodeImage"></a> <font size="-1">implodeImage</font></center>
    743. 

  743.       </td>
    744. 

  744.       <td><font size="-1">double factor_</font></td>
    745. 

  745.       <td><font size="-1">Implode image (special effect)</font></td>
    746. 

  746.     </tr>
    747. 

  747.     <tr>
    748. 

  748.       <td>
    749. 

  749.       <center><a name="inverseFourierTransformImage"></a> <font size="-1">inverseFourierTransformImage</font></center>
    750. 

  750.       </td>
    751. 

  751.       <td><font size="-1">const <a href="Image++.html">Image</a>
    752. 

  752. &amp;phaseImage_, const bool magnitude_</font></td>
    753. 

  753.       <td><font size="-1">implements the inverse discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair.</font></td>
    754. 

  754.     </tr>
    755. 

  755.     <tr>
    756. 

  756.       <td>
    757. 

  757.       <center><a name="labelImage"></a> <font size="-1">labelImage</font></center>
    758. 

  758.       </td>
    759. 

  759.       <td><font size="-1">const string &amp;label_</font></td>
    760. 

  760.       <td><font size="-1">Assign a label to an image. Use this option
    761. 

  761. to&#160; assign&#160; a&#160; specific label to the image. Optionally
    762. 

  762. you can include  the image filename, type, width, height, or scene
    763. 

  763. number in the label by embedding&#160; <a href="https://imagemagick.org/Magick++/FormatCharacters.html">special
    764. 

  764. format characters.</a> If the first character of string is @, the image
    765. 

  765. label is read from a file titled by the remaining characters in the
    766. 

  766. string. When converting to Postscript,  use this&#160; option to specify
    767. 

  767. a header string to print above the image.</font></td>
    768. 

  768.     </tr>
    769. 

  769.     <tr>
    770. 

  770.       <td style="text-align: center; vertical-align: middle;"><small><a
    771. 

  771.  name="levelImage"></a>levelImage<br />
    772. 

  772.       </small></td>
    773. 

  773.       <td style="vertical-align: top;"><small>const double black_point,
    774. 

  774. const double white_point, const double mid_point=1.0<br />
    775. 

  775.       </small></td>
    776. 

  776.       <td style="vertical-align: top;"><small>Level image. Adjust the
    777. 

  777. levels of the image by scaling the colors falling between specified
    778. 

  778. white and black points to the full available quantum range. The
    779. 

  779. parameters provided represent the black, mid (gamma), and white
    780. 

  780. points.&#160; The black point specifies the darkest color in the image.
    781. 

  781. Colors darker than the black point are set to zero. Mid point (gamma)
    782. 

  782. specifies a gamma correction to apply to the image. White point
    783. 

  783. specifies the lightest color in the image.&#160; Colors brighter than
    784. 

  784. the white point are set to the maximum quantum value. The black and
    785. 

  785. white point have the valid range 0 to QuantumRange while mid (gamma) has a
    786. 

  786. useful range of 0 to ten.</small></td>
    787. 

  787.     </tr>
    788. 

  788.     <tr>
    789. 

  789.       <td style="text-align: center; vertical-align: middle;"><small><a
    790. 

  790.  name="levelChannelImage"></a>levelChannelImage<br />
    791. 

  791.       </small></td>
    792. 

  792.       <td style="vertical-align: top;"><small>const Magick::ChannelType
    793. 

  793. channel, const double black_point, const double white_point, const
    794. 

  794. double mid_point=1.0<br />
    795. 

  795.       </small></td>
    796. 

  796.       <td style="vertical-align: top;"><small>Level image channel.
    797. 

  797. Adjust the levels of the image channel by scaling the values falling
    798. 

  798. between specified white and black points to the full available quantum
    799. 

  799. range. The parameters provided represent the black, mid (gamma), and
    800. 

  800. white points. The black point specifies the darkest color in the image.
    801. 

  801. Colors darker than the black point are set to zero. Mid point (gamma)
    802. 

  802. specifies a gamma correction to apply to the image. White point
    803. 

  803. specifies the lightest color in the image. Colors brighter than the
    804. 

  804. white point are set to the maximum quantum value. The black and white
    805. 

  805. point have the valid range 0 to QuantumRange while mid (gamma) has a useful
    806. 

  806. range of 0 to ten.</small></td>
    807. 

  807.     </tr>
    808. 

  808.     <tr>
    809. 

  809.       <td>
    810. 

  810.       <center><a name="layerImage"></a> <font size="-1">layerImage</font></center>
    811. 

  811.       </td>
    812. 

  812.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ChannelType">ChannelType</a>
    813. 

  813. layer_</font></td>
    814. 

  814.       <td><font size="-1">Extract layer from image. Use this option to
    815. 

  815. extract a particular layer from&#160; the image.&#160; <i>MatteLayer</i>,&#160;
    816. 

  816. for&#160; example, is useful for extracting the opacity values from an
    817. 

  817. image.</font></td>
    818. 

  818.     </tr>
    819. 

  819.     <tr>
    820. 

  820.       <td>
    821. 

  821.       <center><a name="magnifyImage"></a> <font size="-1">magnifyImage</font></center>
    822. 

  822.       </td>
    823. 

  823.       <td><font size="-1">void</font></td>
    824. 

  824.       <td><font size="-1">Magnify image by integral size</font></td>
    825. 

  825.     </tr>
    826. 

  826.     <tr>
    827. 

  827.       <td>
    828. 

  828.       <center><a name="mapImage"></a> <font size="-1">mapImage</font></center>
    829. 

  829.       </td>
    830. 

  830.       <td><font size="-1">const <a href="Image++.html">Image</a>
    831. 

  831. &amp;mapImage_ , bool dither_ = false</font></td>
    832. 

  832.       <td><font size="-1">Remap image colors with closest color from
    833. 

  833. reference image. Set dither_ to <i>true</i> in to apply Floyd/Steinberg
    834. 

  834. error diffusion  to the image. By default, color reduction chooses an
    835. 

  835. optimal&#160; set&#160;  of colors that best represent the original
    836. 

  836. image. Alternatively, you can&#160; choose&#160; a&#160;
    837. 

  837. particular&#160; set&#160; of colors&#160; from&#160;  an image file
    838. 

  838. with this option.</font></td>
    839. 

  839.     </tr>
    840. 

  840.     <tr>
    841. 

  841.       <td>
    842. 

  842.       <center><a name="matteFloodfillImage"></a> <font size="-1">matteFloodfill-</font> <br />
    843. 

  843.       <font size="-1">Image</font></center>
    844. 

  844.       </td>
    845. 

  845.       <td><font size="-1">const <a href="Color.html">Color</a>
    846. 

  846. &amp;target_, unsigned int matte_, ssize_t x_, ssize_t y_, <a
    847. 

  847.  href="https://imagemagick.org/Magick++/Enumerations.html#PaintMethod"> PaintMethod</a> method_</font></td>
    848. 

  848.       <td><font size="-1">Floodfill designated area with a matte value</font></td>
    849. 

  849.     </tr>
    850. 

  850.     <tr>
    851. 

  851.       <td><a name="medianFilterImage"></a> <font size="-1">medianFilterImage</font></td>
    852. 

  852.       <td><font size="-1">const double radius_ = 0.0</font></td>
    853. 

  853.       <td><font size="-1">Filter image by replacing each pixel
    854. 

  854. component with the median color in a circular neighborhood</font></td>
    855. 

  855.     </tr>
    856. 

  856.     <tr>
    857. 

  857.       <td>
    858. 

  858.       <center><a name="minifyImage"></a> <font size="-1">minifyImage</font></center>
    859. 

  859.       </td>
    860. 

  860.       <td><font size="-1">void</font></td>
    861. 

  861.       <td><font size="-1">Reduce image by integral size</font></td>
    862. 

  862.     </tr>
    863. 

  863.     <tr>
    864. 

  864.       <td>
    865. 

  865.       <center><a name="modulateImage"></a> <font size="-1">modulateImage</font></center>
    866. 

  866.       </td>
    867. 

  867.       <td><font size="-1">double brightness_, double saturation_,
    868. 

  868. double hue_</font></td>
    869. 

  869.       <td><font size="-1">Modulate percent hue, saturation, and
    870. 

  870. brightness of an image.&#160;</font><font size="-1">Modulation of
    871. 

  871. saturation and brightness is as a ratio of the current value (1.0 for no
    872. 

  872. change). Modulation of hue is an absolute rotation of -180 degrees to
    873. 

  873. +180 degrees from the current position corresponding to an argument
    874. 

  874. range of 0 to 2.0 (1.0 for no change).</font></td>
    875. 

  875.     </tr>
    876. 

  876.     <tr>
    877. 

  877.       <td>
    878. 

  878.       <center><a name="negateImage"></a> <font size="-1">negateImage</font></center>
    879. 

  879.       </td>
    880. 

  880.       <td><font size="-1">bool grayscale_ = false</font></td>
    881. 

  881.       <td><font size="-1">Negate colors in image.&#160; Replace every
    882. 

  882. pixel with  its complementary color (white becomes black, yellow becomes
    883. 

  883. blue, etc.).&#160;  Set grayscale to only negate grayscale values in
    884. 

  884. image.</font></td>
    885. 

  885.     </tr>
    886. 

  886.     <tr>
    887. 

  887.       <td>
    888. 

  888.       <center><a name="normalizeImage"></a> <font size="-1">normalizeImage</font></center>
    889. 

  889.       </td>
    890. 

  890.       <td><font size="-1">void</font></td>
    891. 

  891.       <td><font size="-1">Normalize image (increase contrast by
    892. 

  892. normalizing the  pixel values to span the full range of color values).</font></td>
    893. 

  893.     </tr>
    894. 

  894.     <tr>
    895. 

  895.       <td>
    896. 

  896.       <center><a name="oilPaintImage"></a> <font size="-1">oilPaintImage</font></center>
    897. 

  897.       </td>
    898. 

  898.       <td><font size="-1">size_t radius_ = 3</font></td>
    899. 

  899.       <td><font size="-1">Oilpaint image (image looks like oil painting)</font></td>
    900. 

  900.     </tr>
    901. 

  901.     <tr>
    902. 

  902.       <td>
    903. 

  903.       <center><a name="opacityImage"></a> <font size="-1">opacityImage</font></center>
    904. 

  904.       </td>
    905. 

  905.       <td><font size="-1">size_t opacity_</font></td>
    906. 

  906.       <td><font size="-1">Set or attenuate the opacity channel in the
    907. 

  907. image. If the image pixels are opaque then they are set to the specified
    908. 

  908. opacity value, otherwise they are blended with the supplied opacity
    909. 

  909. value.&#160; The value of opacity_ ranges from 0 (completely opaque) to <i>QuantumRange</i>.
    910. 

  910. The defines <i>OpaqueOpacity</i> and <i>TransparentOpacity</i> are
    911. 

  911. available to specify completely opaque or completely transparent,
    912. 

  912. respectively.</font></td>
    913. 

  913.     </tr>
    914. 

  914.     <tr>
    915. 

  915.       <td>
    916. 

  916.       <center><a name="opaqueImage"></a> <font size="-1">opaqueImage</font></center>
    917. 

  917.       </td>
    918. 

  918.       <td><font size="-1">const <a href="Color.html">Color</a>
    919. 

  919. &amp;opaqueColor_, const <a href="Color.html">Color</a> &amp;penColor_</font></td>
    920. 

  920.       <td><font size="-1">Change color of pixels matching opaqueColor_
    921. 

  921. to specified  penColor_.</font></td>
    922. 

  922.     </tr>
    923. 

  923.     <tr>
    924. 

  924.       <td>
    925. 

  925.       <center><a name="quantizeImage"></a> <font size="-1">quantizeImage</font></center>
    926. 

  926.       </td>
    927. 

  927.       <td><font size="-1">bool measureError_ = false</font></td>
    928. 

  928.       <td><font size="-1">Quantize image (reduce number of colors). Set
    929. 

  929. measureError_ to true in order to calculate error attributes.</font></td>
    930. 

  930.     </tr>
    931. 

  931.     <tr>
    932. 

  932.       <td>
    933. 

  933.       <center><a name="raiseImage"></a> <font size="-1">raiseImage</font></center>
    934. 

  934.       </td>
    935. 

  935.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    936. 

  936. &amp;geometry_ = "6x6+0+0",&#160; bool raisedFlag_ =&#160; false</font></td>
    937. 

  937.       <td><font size="-1">Raise image (lighten or darken the edges of
    938. 

  938. an image  to give a 3-D raised or lowered effect)</font></td>
    939. 

  939.     </tr>
    940. 

  940.     <tr>
    941. 

  941.       <td rowspan="2">
    942. 

  942.       <center><a name="reduceNoiseImage"></a> <font size="-1">reduceNoise-</font> <br />
    943. 

  943.       <font size="-1">Image</font></center>
    944. 

  944.       </td>
    945. 

  945.       <td><font size="-1">void</font></td>
    946. 

  946.       <td rowspan="2"><font size="-1">Reduce noise in image using a
    947. 

  947. noise peak  elimination filter.</font></td>
    948. 

  948.     </tr>
    949. 

  949.     <tr>
    950. 

  950.       <td><font size="-1">size_t order_</font></td>
    951. 

  951.     </tr>
    952. 

  952.     <tr>
    953. 

  953.       <td>
    954. 

  954.       <center><a name="rollImage"></a> <font size="-1">rollImage</font></center>
    955. 

  955.       </td>
    956. 

  956.       <td><font size="-1">int columns_, ssize_t rows_</font></td>
    957. 

  957.       <td><font size="-1">Roll image (rolls image vertically and
    958. 

  958. horizontally) by specified number of columnms and rows)</font></td>
    959. 

  959.     </tr>
    960. 

  960.     <tr>
    961. 

  961.       <td>
    962. 

  962.       <center><a name="rotateImage"></a> <font size="-1">rotateImage</font></center>
    963. 

  963.       </td>
    964. 

  964.       <td><font size="-1">double degrees_</font></td>
    965. 

  965.       <td><font size="-1">Rotate image counter-clockwise by specified
    966. 

  966. number of degrees</font></td>
    967. 

  967.     </tr>
    968. 

  968.     <tr>
    969. 

  969.       <td>
    970. 

  970.       <center><a name="sampleImage"></a> <font size="-1">sampleImage</font></center>
    971. 

  971.       </td>
    972. 

  972.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    973. 

  973. &amp;geometry_&#160;</font></td>
    974. 

  974.       <td><font size="-1">Resize image by using pixel sampling algorithm</font></td>
    975. 

  975.     </tr>
    976. 

  976.     <tr>
    977. 

  977.       <td>
    978. 

  978.       <center><a name="scaleImage"></a> <font size="-1">scaleImage</font></center>
    979. 

  979.       </td>
    980. 

  980.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    981. 

  981. &amp;geometry_</font></td>
    982. 

  982.       <td><font size="-1">Resize image by using simple ratio algorithm</font></td>
    983. 

  983.     </tr>
    984. 

  984.     <tr>
    985. 

  985.       <td>
    986. 

  986.       <center><a name="segmentImage"></a> <font size="-1">segmentImage</font></center>
    987. 

  987.       </td>
    988. 

  988.       <td><font size="-1">double clusterThreshold_ = 1.0,</font> <br />
    989. 

  989.       <font size="-1">double smoothingThreshold_ = 1.5</font></td>
    990. 

  990.       <td><font size="-1">Segment (coalesce similar image components)
    991. 

  991. by analyzing  the histograms of the color components and identifying
    992. 

  992. units that are homogeneous  with the fuzzy c-means technique. Also uses <i>quantizeColorSpace</i>
    993. 

  993. and <i>verbose</i> image attributes. Specify <i>clusterThreshold_</i> ,
    994. 

  994. as the number&#160; of&#160; pixels&#160; each cluster&#160; must exceed
    995. 

  995. the cluster threshold to be considered valid. <i>SmoothingThreshold_</i>
    996. 

  996. eliminates noise in the&#160; second derivative of the histogram. As the
    997. 

  997. value is&#160; increased, you can&#160; expect&#160; a&#160; smoother
    998. 

  998. second derivative.&#160; The default is 1.5.</font></td>
    999. 

  999.     </tr>
    1000. 

  1000.     <tr>
    1001. 

  1001.       <td>
    1002. 

  1002.       <center><a name="shadeImage"></a> <font size="-1">shadeImage</font></center>
    1003. 

  1003.       </td>
    1004. 

  1004.       <td><font size="-1">double azimuth_ = 30, double elevation_ = 30,</font> <br />
    1005. 

  1005.       <font size="-1">bool colorShading_ = false</font></td>
    1006. 

  1006.       <td><font size="-1">Shade image using distant light source.
    1007. 

  1007. Specify <i> azimuth_</i> and <i>elevation_</i> as the&#160;
    1008. 

  1008. position&#160; of&#160; the light source. By default, the shading
    1009. 

  1009. results as a grayscale image.. Set c<i>olorShading_</i> to <i>true</i> to
    1010. 

  1010. shade the red, green, and blue components of the image.</font></td>
    1011. 

  1011.     </tr>
    1012. 

  1012.     <tr>
    1013. 

  1013.       <td>
    1014. 

  1014.       <center><a name="sharpenImage"></a> <font size="-1">sharpenImage</font></center>
    1015. 

  1015.       </td>
    1016. 

  1016.       <td><font size="-1">const double radius_ = 1, const double sigma_
    1017. 

  1017. = 0.5</font></td>
    1018. 

  1018.       <td><font size="-1">Sharpen pixels in image. The radius_
    1019. 

  1019. parameter specifies  the radius of the Gaussian, in pixels, not counting
    1020. 

  1020. the center pixel.&#160;  The sigma_ parameter specifies the standard
    1021. 

  1021. deviation of the Laplacian, in pixels.</font></td>
    1022. 

  1022.     </tr>
    1023. 

  1023.     <tr>
    1024. 

  1024.       <td>
    1025. 

  1025.       <center><a name="shaveImage"></a> <font size="-1">shaveImage</font></center>
    1026. 

  1026.       </td>
    1027. 

  1027.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    1028. 

  1028. &amp;geometry_</font></td>
    1029. 

  1029.       <td><font size="-1">Shave pixels from image edges.</font></td>
    1030. 

  1030.     </tr>
    1031. 

  1031.     <tr>
    1032. 

  1032.       <td>
    1033. 

  1033.       <center><a name="shearImage"></a> <font size="-1">shearImage</font></center>
    1034. 

  1034.       </td>
    1035. 

  1035.       <td><font size="-1">double xShearAngle_, double yShearAngle_</font></td>
    1036. 

  1036.       <td><font size="-1">Shear image (create parallelogram by sliding
    1037. 

  1037. image by X or Y axis).&#160; Shearing slides one edge of an image along
    1038. 

  1038. the X&#160;  or&#160; Y axis,&#160; creating&#160; a
    1039. 

  1039. parallelogram.&#160; An X direction  shear slides an edge along the X
    1040. 

  1040. axis, while&#160; a&#160; Y&#160; direction  shear&#160; slides&#160; an
    1041. 

  1041. edge along the Y axis.&#160; The amount of the shear is controlled by a
    1042. 

  1042. shear angle.&#160; For X direction&#160; shears,&#160;  x&#160; degrees
    1043. 

  1043. is measured relative to the Y axis, and similarly, for Y direction
    1044. 

  1044. shears&#160; y&#160; degrees is measured relative to the X axis. Empty
    1045. 

  1045. triangles left over from shearing the&#160; image&#160; are filled&#160;
    1046. 

  1046. with&#160; the&#160; color&#160; defined as <i>borderColor</i>.&#160;</font></td>
    1047. 

  1047.     </tr>
    1048. 

  1048.     <tr>
    1049. 

  1049.       <td>
    1050. 

  1050.       <center><a name="solarizeImage"></a> <font size="-1">solarizeImage</font></center>
    1051. 

  1051.       </td>
    1052. 

  1052.       <td><font size="-1">double factor_</font></td>
    1053. 

  1053.       <td><font size="-1">Solarize image (similar to effect seen when
    1054. 

  1054. exposing a photographic film to light during the development process)</font></td>
    1055. 

  1055.     </tr>
    1056. 

  1056.     <tr>
    1057. 

  1057.       <td>
    1058. 

  1058.       <center><a name="spreadImage"></a> <font size="-1">spreadImage</font></center>
    1059. 

  1059.       </td>
    1060. 

  1060.       <td><font size="-1">size_t amount_ = 3</font></td>
    1061. 

  1061.       <td><font size="-1">Spread pixels randomly within image by
    1062. 

  1062. specified amount</font></td>
    1063. 

  1063.     </tr>
    1064. 

  1064.     <tr>
    1065. 

  1065.       <td>
    1066. 

  1066.       <center><a name="steganoImage"></a> <font size="-1">steganoImage</font></center>
    1067. 

  1067.       </td>
    1068. 

  1068.       <td><font size="-1">const <a href="Image++.html">Image</a>
    1069. 

  1069. &amp;watermark_</font></td>
    1070. 

  1070.       <td><font size="-1">Add a digital watermark to the image (based
    1071. 

  1071. on second  image)</font></td>
    1072. 

  1072.     </tr>
    1073. 

  1073.     <tr>
    1074. 

  1074.       <td>
    1075. 

  1075.       <center><a name="stereoImage"></a> <font size="-1">stereoImage</font></center>
    1076. 

  1076.       </td>
    1077. 

  1077.       <td><font size="-1">const <a href="Image++.html">Image</a>
    1078. 

  1078. &amp;rightImage_</font></td>
    1079. 

  1079.       <td><font size="-1">Create an image which appears in stereo when
    1080. 

  1080. viewed with red-blue glasses (Red image on left, blue on right)</font></td>
    1081. 

  1081.     </tr>
    1082. 

  1082.     <tr>
    1083. 

  1083.       <td>
    1084. 

  1084.       <center><a name="swirlImage"></a> <font size="-1">swirlImage</font></center>
    1085. 

  1085.       </td>
    1086. 

  1086.       <td><font size="-1">double degrees_</font></td>
    1087. 

  1087.       <td><font size="-1">Swirl image (image pixels are rotated by
    1088. 

  1088. degrees)</font></td>
    1089. 

  1089.     </tr>
    1090. 

  1090.     <tr>
    1091. 

  1091.       <td>
    1092. 

  1092.       <center><a name="textureImage"></a> <font size="-1">textureImage</font></center>
    1093. 

  1093.       </td>
    1094. 

  1094.       <td><font size="-1">const <a href="Image++.html">Image</a>
    1095. 

  1095. &amp;texture_</font></td>
    1096. 

  1096.       <td><font size="-1">Layer a texture on image background</font></td>
    1097. 

  1097.     </tr>
    1098. 

  1098.     <tr>
    1099. 

  1099.       <td>
    1100. 

  1100.       <center><a name="thresholdImage"></a> <font size="-1">thresholdImage</font></center>
    1101. 

  1101.       </td>
    1102. 

  1102.       <td><font size="-1">double threshold_</font></td>
    1103. 

  1103.       <td><font size="-1">Threshold image</font></td>
    1104. 

  1104.     </tr>
    1105. 

  1105.     <tr>
    1106. 

  1106.       <td rowspan="2">
    1107. 

  1107.       <center><a name="transformImage"></a> <font size="-1">transformImage</font></center>
    1108. 

  1108.       </td>
    1109. 

  1109.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    1110. 

  1110. &amp;imageGeometry_</font></td>
    1111. 

  1111.       <td rowspan="2"><font size="-1">Transform image based on image
    1112. 

  1112. and crop geometries. Crop geometry is optional.</font></td>
    1113. 

  1113.     </tr>
    1114. 

  1114.     <tr>
    1115. 

  1115.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    1116. 

  1116. &amp;imageGeometry_, const <a href="Geometry.html">Geometry</a>
    1117. 

  1117. &amp;cropGeometry_&#160;</font></td>
    1118. 

  1118.     </tr>
    1119. 

  1119.     <tr>
    1120. 

  1120.       <td>
    1121. 

  1121.       <center><a name="transparentImage"></a> <font size="-1">transparentImage</font></center>
    1122. 

  1122.       </td>
    1123. 

  1123.       <td><font size="-1">const <a href="Color.html">Color</a>
    1124. 

  1124. &amp;color_</font></td>
    1125. 

  1125.       <td><font size="-1">Add matte image to image, setting pixels
    1126. 

  1126. matching color  to transparent.</font></td>
    1127. 

  1127.     </tr>
    1128. 

  1128.     <tr>
    1129. 

  1129.       <td>
    1130. 

  1130.       <center><a name="trimImage"></a> <font size="-1">trimImage</font></center>
    1131. 

  1131.       </td>
    1132. 

  1132.       <td><font size="-1">void</font></td>
    1133. 

  1133.       <td><font size="-1">Trim edges that are the background color from
    1134. 

  1134. the image.</font></td>
    1135. 

  1135.     </tr>
    1136. 

  1136.     <tr>
    1137. 

  1137.       <td>
    1138. 

  1138.       <center><a name="waveImage"></a> <font size="-1">waveImage</font></center>
    1139. 

  1139.       </td>
    1140. 

  1140.       <td><font size="-1">double amplitude_ = 25.0, double wavelength_
    1141. 

  1141. = 150.0</font></td>
    1142. 

  1142.       <td><font size="-1">Alter an image along a sine wave.</font></td>
    1143. 

  1143.     </tr>
    1144. 

  1144.     <tr>
    1145. 

  1145.       <td>
    1146. 

  1146.       <center><a name="zoomImage"></a> <font size="-1">zoomImage</font></center>
    1147. 

  1147.       </td>
    1148. 

  1148.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    1149. 

  1149. &amp;geometry_</font></td>
    1150. 

  1150.       <td><font size="-1">Zoom image to specified size.</font></td>
    1151. 

  1151.     </tr>
    1152. 

  1152.   </tbody>
    1153. 

  1153. </table></ul>
    1154. 

  1154. </p>
    1155. 

  1155. <p>Function objects are available to set attributes on image frames
    1156. 

  1156. which are equivalent to methods in the Image object. These function
    1157. 

  1157. objects allow setting an option across a range of image frames using f<tt>
    1158. 

  1158. or_each()</tt>. </p>
    1159. 

  1159. <p>The following code is an example of how the color 'red' may be set
    1160. 

  1160. to transparent in a GIF animation: </p>
    1161. 

  1161. <pre class="code">
    1162. 

  1162. list&lt;image> images; 
    1163. 

  1163. readImages( &amp;images, "animation.gif" ); 
    1164. 

  1164. for_each ( images.begin(), images.end(), transparentImage( "red" )  ); 
    1165. 

  1165. writeImages( images.begin(), images.end(), "animation.gif" );
    1166. 

  1166. </pre>
    1167. 

  1167. <p>The available function objects for setting image attributes are <br />
    1168. 

  1168. &#160;
    1169. 

  1169. <ul><table border="1">
    1170. 

  1170.   <caption style="font-weight: bold;">Image Attributes</caption> <tbody>
    1171. 

  1171.     <tr>
    1172. 

  1172.       <td>
    1173. 

  1173.       <center><b>Attribute</b></center>
    1174. 

  1174.       </td>
    1175. 

  1175.       <td>
    1176. 

  1176.       <center><b>Type</b></center>
    1177. 

  1177.       </td>
    1178. 

  1178.       <td>
    1179. 

  1179.       <center><b>Constructor Signature(s)</b></center>
    1180. 

  1180.       </td>
    1181. 

  1181.       <td>
    1182. 

  1182.       <center><b>Description</b></center>
    1183. 

  1183.       </td>
    1184. 

  1184.     </tr>
    1185. 

  1185.     <tr>
    1186. 

  1186.       <td>
    1187. 

  1187.       <center><a name="adjoinImage"></a> <font size="-1">adjoinImage</font></center>
    1188. 

  1188.       </td>
    1189. 

  1189.       <td><font size="-1">bool</font></td>
    1190. 

  1190.       <td><font size="-1">bool flag_</font></td>
    1191. 

  1191.       <td><font size="-1">Join images into a single multi-image file.</font></td>
    1192. 

  1192.     </tr>
    1193. 

  1193.     <tr>
    1194. 

  1194.       <td>
    1195. 

  1195.       <center><a name="antiAlias"></a> <font size="-1">antiAliasImage</font></center>
    1196. 

  1196.       </td>
    1197. 

  1197.       <td><font size="-1">bool</font></td>
    1198. 

  1198.       <td><font size="-1">bool flag_</font></td>
    1199. 

  1199.       <td><font size="-1">Control antialiasing of rendered Postscript
    1200. 

  1200. and Postscript  or TrueType fonts. Enabled by default.</font></td>
    1201. 

  1201.     </tr>
    1202. 

  1202.     <tr>
    1203. 

  1203.       <td>
    1204. 

  1204.       <center><a name="animationDelay"></a> <font size="-1">animation-</font> <br />
    1205. 

  1205.       <font size="-1">DelayImage</font></center>
    1206. 

  1206.       </td>
    1207. 

  1207.       <td><font size="-1">size_t (0 to 65535)</font></td>
    1208. 

  1208.       <td><font size="-1">size_t delay_</font></td>
    1209. 

  1209.       <td><font size="-1">Time in 1/100ths of a second (0 to 65535)
    1210. 

  1210. which must  expire before displaying the next image in an animated
    1211. 

  1211. sequence. This option  is useful for regulating the animation of a
    1212. 

  1212. sequence&#160; of GIF images within Netscape.</font></td>
    1213. 

  1213.     </tr>
    1214. 

  1214.     <tr>
    1215. 

  1215.       <td>
    1216. 

  1216.       <center><a name="animationIterations"></a> <font size="-1">animation-</font> <br />
    1217. 

  1217.       <font size="-1">IterationsImage</font></center>
    1218. 

  1218.       </td>
    1219. 

  1219.       <td><font size="-1">size_t</font></td>
    1220. 

  1220.       <td><font size="-1">size_t iterations_</font></td>
    1221. 

  1221.       <td><font size="-1">Number of iterations to loop an animation
    1222. 

  1222. (e.g. Netscape  loop extension) for.</font></td>
    1223. 

  1223.     </tr>
    1224. 

  1224.     <tr>
    1225. 

  1225.       <td>
    1226. 

  1226.       <center><a name="backgroundColor"></a> <font size="-1">background-</font> <br />
    1227. 

  1227.       <font size="-1">ColorImage</font></center>
    1228. 

  1228.       </td>
    1229. 

  1229.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1230. 

  1230.       <td><font size="-1">const <a href="Color.html">Color</a>
    1231. 

  1231. &amp;color_</font></td>
    1232. 

  1232.       <td><font size="-1">Image background color</font></td>
    1233. 

  1233.     </tr>
    1234. 

  1234.     <tr>
    1235. 

  1235.       <td>
    1236. 

  1236.       <center><a name="backgroundTexture"></a> <font size="-1">background-</font> <br />
    1237. 

  1237.       <font size="-1">TextureImage</font></center>
    1238. 

  1238.       </td>
    1239. 

  1239.       <td><font size="-1">std::string</font></td>
    1240. 

  1240.       <td><font size="-1">const string &amp;texture_</font></td>
    1241. 

  1241.       <td><font size="-1">Image to use as background texture.</font></td>
    1242. 

  1242.     </tr>
    1243. 

  1243.     <tr>
    1244. 

  1244.       <td>
    1245. 

  1245.       <center><a name="borderColor"></a> <font size="-1">borderColor-</font> <br />
    1246. 

  1246.       <font size="-1">Image</font></center>
    1247. 

  1247.       </td>
    1248. 

  1248.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1249. 

  1249.       <td><font size="-1">&#160;const <a href="Color.html">Color</a>
    1250. 

  1250. &amp;color_</font></td>
    1251. 

  1251.       <td><font size="-1">Image border color</font></td>
    1252. 

  1252.     </tr>
    1253. 

  1253.     <tr>
    1254. 

  1254.       <td>
    1255. 

  1255.       <center><a name="boxColor"></a> <font size="-1">boxColorImage</font></center>
    1256. 

  1256.       </td>
    1257. 

  1257.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1258. 

  1258.       <td><font size="-1">const <a href="Color.html">Color</a>
    1259. 

  1259. &amp;boxColor_</font></td>
    1260. 

  1260.       <td><font size="-1">Base color that annotation text is rendered
    1261. 

  1261. on.</font></td>
    1262. 

  1262.     </tr>
    1263. 

  1263.     <tr>
    1264. 

  1264.       <td>
    1265. 

  1265.       <center><a name="chromaBluePrimary"></a> <font size="-1">chroma-</font> <br />
    1266. 

  1266.       <font size="-1">BluePrimaryImage</font></center>
    1267. 

  1267.       </td>
    1268. 

  1268.       <td><font size="-1">double x &amp; y</font></td>
    1269. 

  1269.       <td><font size="-1">double x_, double y_</font></td>
    1270. 

  1270.       <td><font size="-1">Chromaticity blue primary point (e.g. x=0.15,
    1271. 

  1271. y=0.06)</font></td>
    1272. 

  1272.     </tr>
    1273. 

  1273.     <tr>
    1274. 

  1274.       <td>
    1275. 

  1275.       <center><a name="chromaGreenPrimary"></a> <font size="-1">chroma-</font> <br />
    1276. 

  1276.       <font size="-1">GreenPrimaryImage</font></center>
    1277. 

  1277.       </td>
    1278. 

  1278.       <td><font size="-1">double x &amp; y</font></td>
    1279. 

  1279.       <td><font size="-1">double x_, double y_</font></td>
    1280. 

  1280.       <td><font size="-1">Chromaticity green primary point (e.g. x=0.3,
    1281. 

  1281. y=0.6)</font></td>
    1282. 

  1282.     </tr>
    1283. 

  1283.     <tr>
    1284. 

  1284.       <td>
    1285. 

  1285.       <center><a name="chromaRedPrimary"></a> <font size="-1">chroma-</font> <br />
    1286. 

  1286.       <font size="-1">RedPrimaryImage</font></center>
    1287. 

  1287.       </td>
    1288. 

  1288.       <td><font size="-1">double x &amp; y</font></td>
    1289. 

  1289.       <td><font size="-1">double x_, double y_</font></td>
    1290. 

  1290.       <td><font size="-1">Chromaticity red primary point (e.g. x=0.64,
    1291. 

  1291. y=0.33)</font></td>
    1292. 

  1292.     </tr>
    1293. 

  1293.     <tr>
    1294. 

  1294.       <td>
    1295. 

  1295.       <center><a name="chromaWhitePoint"></a> <font size="-1">chroma-</font> <br />
    1296. 

  1296.       <font size="-1">WhitePointImage</font></center>
    1297. 

  1297.       </td>
    1298. 

  1298.       <td><font size="-1">double x &amp; y</font></td>
    1299. 

  1299.       <td><font size="-1">double x_, double y_</font></td>
    1300. 

  1300.       <td><font size="-1">Chromaticity white point (e.g. x=0.3127,
    1301. 

  1301. y=0.329)</font></td>
    1302. 

  1302.     </tr>
    1303. 

  1303.     <tr>
    1304. 

  1304.       <td>
    1305. 

  1305.       <center><a name="colorFuzz"></a> <font size="-1">colorFuzzImage</font></center>
    1306. 

  1306.       </td>
    1307. 

  1307.       <td><font size="-1">double</font></td>
    1308. 

  1308.       <td><font size="-1">double fuzz_</font></td>
    1309. 

  1309.       <td><font size="-1">Colors within this distance are considered
    1310. 

  1310. equal. A number of algorithms search for a target&#160; color. By
    1311. 

  1311. default the color must be exact. Use this option to match colors that
    1312. 

  1312. are close to the target  color in RGB space.</font></td>
    1313. 

  1313.     </tr>
    1314. 

  1314.     <tr>
    1315. 

  1315.       <td>
    1316. 

  1316.       <center><a name="colorMap"></a> <font size="-1">colorMapImage</font></center>
    1317. 

  1317.       </td>
    1318. 

  1318.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1319. 

  1319.       <td><font size="-1">size_t index_, const <a
    1320. 

  1320.  href="Color.html">Color</a> &amp;color_</font></td>
    1321. 

  1321.       <td><font size="-1">Color at color-pallet index.</font></td>
    1322. 

  1322.     </tr>
    1323. 

  1323.     <tr>
    1324. 

  1324.       <td><a name="colorSpaceImage"></a> <font size="-1">colorSpaceImage</font></td>
    1325. 

  1325.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a> </font></td>
    1326. 

  1326.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a>
    1327. 

  1327. colorSpace_</font></td>
    1328. 

  1328.       <td><font size="-1">The colorspace (e.g. CMYK) used to represent
    1329. 

  1329. the image  pixel colors. Image pixels are always stored as RGB(A) except
    1330. 

  1330. for the case  of CMY(K).</font></td>
    1331. 

  1331.     </tr>
    1332. 

  1332.     <tr>
    1333. 

  1333.       <td>
    1334. 

  1334.       <center><a name="composeImage"></a> <font size="-1">composeImage</font></center>
    1335. 

  1335.       </td>
    1336. 

  1336.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#CompositeOperator">CompositeOperator</a> </font></td>
    1337. 

  1337.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#CompositeOperator">CompositeOperator</a>
    1338. 

  1338. compose_</font></td>
    1339. 

  1339.       <td><font size="-1">Composition operator to be used when
    1340. 

  1340. composition is implicitly used (such as for image flattening).</font></td>
    1341. 

  1341.     </tr>
    1342. 

  1342.     <tr>
    1343. 

  1343.       <td>
    1344. 

  1344.       <center><a name="compressType"></a> <font size="-1">compressType-</font> <br />
    1345. 

  1345.       <font size="-1">Image</font></center>
    1346. 

  1346.       </td>
    1347. 

  1347.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#CompressionType">CompressionType</a> </font></td>
    1348. 

  1348.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#CompressionType">CompressionType</a>
    1349. 

  1349. compressType_</font></td>
    1350. 

  1350.       <td><font size="-1">Image compresion type. The default is the
    1351. 

  1351. compression type of the specified image file.</font></td>
    1352. 

  1352.     </tr>
    1353. 

  1353.     <tr>
    1354. 

  1354.       <td>
    1355. 

  1355.       <center><a name="density"></a> <font size="-1">densityImage</font></center>
    1356. 

  1356.       </td>
    1357. 

  1357.       <td><font size="-1"><a href="Geometry.html">Geometry</a> &#160;
    1358. 

  1358. (default 72x72)</font></td>
    1359. 

  1359.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    1360. 

  1360. &amp;density_</font></td>
    1361. 

  1361.       <td><font size="-1">Vertical and horizontal resolution in pixels
    1362. 

  1362. of the image. This option specifies an image density when decoding a
    1363. 

  1363. Postscript or Portable Document page. Often used with <i>psPageSize</i>.</font></td>
    1364. 

  1364.     </tr>
    1365. 

  1365.     <tr>
    1366. 

  1366.       <td>
    1367. 

  1367.       <center><a name="depth"></a> <font size="-1">depthImage</font></center>
    1368. 

  1368.       </td>
    1369. 

  1369.       <td><font size="-1">size_t (8 or 16)</font></td>
    1370. 

  1370.       <td><font size="-1">size_t depth_</font></td>
    1371. 

  1371.       <td><font size="-1">Image depth. Used to specify the bit depth
    1372. 

  1372. when reading  or writing&#160; raw images or thwn the output format
    1373. 

  1373. supports multiple depths. Defaults to the quantum depth that
    1374. 

  1374. ImageMagick is compiled with.</font></td>
    1375. 

  1375.     </tr>
    1376. 

  1376.     <tr>
    1377. 

  1377.       <td>
    1378. 

  1378.       <center><a name="endianImage"></a> <font size="-1">endianImage</font></center>
    1379. 

  1379.       </td>
    1380. 

  1380.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#EndianType">EndianType</a> </font></td>
    1381. 

  1381.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#EndianType">EndianType</a>
    1382. 

  1382. endian_</font></td>
    1383. 

  1383.       <td><font size="-1">Specify (or obtain) endian option for formats
    1384. 

  1384. which support it.</font></td>
    1385. 

  1385.     </tr>
    1386. 

  1386.     <tr>
    1387. 

  1387.       <td>
    1388. 

  1388.       <center><a name="fileName"></a> <font size="-1">fileNameImage</font></center>
    1389. 

  1389.       </td>
    1390. 

  1390.       <td><font size="-1">std::string</font></td>
    1391. 

  1391.       <td><font size="-1">const std::string &amp;fileName_</font></td>
    1392. 

  1392.       <td><font size="-1">Image file name.</font></td>
    1393. 

  1393.     </tr>
    1394. 

  1394.     <tr>
    1395. 

  1395.       <td>
    1396. 

  1396.       <center><a name="fillColorImage"></a> <font size="-1">fillColorImage</font></center>
    1397. 

  1397.       </td>
    1398. 

  1398.       <td><font size="-1">Color</font></td>
    1399. 

  1399.       <td><font size="-1">const Color &amp;fillColor_</font></td>
    1400. 

  1400.       <td><font size="-1">Color to use when filling drawn objects</font></td>
    1401. 

  1401.     </tr>
    1402. 

  1402.     <tr>
    1403. 

  1403.       <td>
    1404. 

  1404.       <center><a name="filterType"></a> <font size="-1">filterTypeImage</font></center>
    1405. 

  1405.       </td>
    1406. 

  1406.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#FilterTypes">FilterTypes</a> </font></td>
    1407. 

  1407.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#FilterTypes">FilterTypes</a>
    1408. 

  1408. filterType_</font></td>
    1409. 

  1409.       <td><font size="-1">Filter to use when resizing image. The
    1410. 

  1410. reduction filter  employed has a sigificant effect on the time required
    1411. 

  1411. to resize an image and the resulting quality. The default filter is <i>Lanczos</i>
    1412. 

  1412. which has been shown to produce good results when reducing images.</font></td>
    1413. 

  1413.     </tr>
    1414. 

  1414.     <tr>
    1415. 

  1415.       <td>
    1416. 

  1416.       <center><a name="font"></a> <font size="-1">fontImage</font></center>
    1417. 

  1417.       </td>
    1418. 

  1418.       <td><font size="-1">std::string</font></td>
    1419. 

  1419.       <td><font size="-1">const std::string &amp;font_</font></td>
    1420. 

  1420.       <td><font size="-1">Text rendering font. If the font is a fully
    1421. 

  1421. qualified X server font name, the font is obtained from an X&#160;
    1422. 

  1422. server. To use a TrueType font, precede the TrueType filename with an @.
    1423. 

  1423. Otherwise, specify&#160;  a&#160; Postscript font name (e.g.
    1424. 

  1424. "helvetica").</font></td>
    1425. 

  1425.     </tr>
    1426. 

  1426.     <tr>
    1427. 

  1427.       <td>
    1428. 

  1428.       <center><a name="fontPointsize"></a> <font size="-1">fontPointsize-</font> <br />
    1429. 

  1429.       <font size="-1">Image</font></center>
    1430. 

  1430.       </td>
    1431. 

  1431.       <td><font size="-1">size_t</font></td>
    1432. 

  1432.       <td><font size="-1">size_t pointSize_</font></td>
    1433. 

  1433.       <td><font size="-1">Text rendering font point size</font></td>
    1434. 

  1434.     </tr>
    1435. 

  1435.     <tr>
    1436. 

  1436.       <td>
    1437. 

  1437.       <center><a name="gifDisposeMethod"></a> <font size="-1">gifDispose-</font> <br />
    1438. 

  1438.       <font size="-1">MethodImage</font></center>
    1439. 

  1439.       </td>
    1440. 

  1440.       <td><font size="-1">size_t</font> <br />
    1441. 

  1441.       <font size="-1">{ 0 = Disposal not specified,</font> <br />
    1442. 

  1442.       <font size="-1">1 = Do not dispose of graphic,</font> <br />
    1443. 

  1443.       <font size="-1">3 = Overwrite graphic with background color,</font> <br />
    1444. 

  1444.       <font size="-1">4 = Overwrite graphic with previous graphic. }</font></td>
    1445. 

  1445.       <td><font size="-1">size_t disposeMethod_</font></td>
    1446. 

  1446.       <td><font size="-1">layer disposal method. This option is used to
    1447. 

  1447. control how successive frames are rendered (how the preceding frame is
    1448. 

  1448. disposed of)  when creating a GIF animation.</font></td>
    1449. 

  1449.     </tr>
    1450. 

  1450.     <tr>
    1451. 

  1451.       <td>
    1452. 

  1452.       <center><a name="interlaceType"></a> <font size="-1">interlace-</font> <br />
    1453. 

  1453.       <font size="-1">TypeImage</font></center>
    1454. 

  1454.       </td>
    1455. 

  1455.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#InterlaceType">InterlaceType</a> </font></td>
    1456. 

  1456.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#InterlaceType">InterlaceType</a>
    1457. 

  1457. interlace_</font></td>
    1458. 

  1458.       <td><font size="-1">The type of interlacing scheme (default <i>NoInterlace</i>
    1459. 

  1459. ). This option is used to specify the type of&#160; interlacing
    1460. 

  1460. scheme&#160; for&#160; raw&#160; image formats such as RGB or YUV. <i>NoInterlace</i>
    1461. 

  1461. means do not&#160; interlace, <i>LineInterlace</i> uses scanline
    1462. 

  1462. interlacing, and <i>PlaneInterlace</i> uses plane interlacing. <i>
    1463. 

  1463. PartitionInterlace</i> is like <i>PlaneInterlace</i> except the&#160;
    1464. 

  1464. different planes&#160; are  saved&#160; to individual files (e.g.&#160;
    1465. 

  1465. image.R, image.G, and image.B).  Use <i>LineInterlace</i> or <i>PlaneInterlace</i>
    1466. 

  1466. to create an interlaced  GIF or progressive JPEG image.</font></td>
    1467. 

  1467.     </tr>
    1468. 

  1468.     <tr>
    1469. 

  1469.       <td>
    1470. 

  1470.       <center><a name="isValidImage"></a> <font size="-1">isValidImage</font></center>
    1471. 

  1471.       </td>
    1472. 

  1472.       <td><font size="-1">bool</font></td>
    1473. 

  1473.       <td><font size="-1">bool isValid_</font></td>
    1474. 

  1474.       <td><font size="-1">Set image validity. Valid images become empty
    1475. 

  1475. (inValid) if argument is false.</font></td>
    1476. 

  1476.     </tr>
    1477. 

  1477.     <tr>
    1478. 

  1478.       <td>
    1479. 

  1479.       <center><a name="label"></a> <font size="-1">labelImage</font></center>
    1480. 

  1480.       </td>
    1481. 

  1481.       <td><font size="-1">std::string</font></td>
    1482. 

  1482.       <td><font size="-1">const std::string &amp;label_</font></td>
    1483. 

  1483.       <td><font size="-1">Image label</font></td>
    1484. 

  1484.     </tr>
    1485. 

  1485.     <tr>
    1486. 

  1486.       <td>
    1487. 

  1487.       <center><a name="lineWidth"></a> <font size="-1">lineWidthImage</font></center>
    1488. 

  1488.       </td>
    1489. 

  1489.       <td><font size="-1">double</font></td>
    1490. 

  1490.       <td><font size="-1">double lineWidth_</font></td>
    1491. 

  1491.       <td><font size="-1">Line width for drawing lines, circles,
    1492. 

  1492. ellipses, etc.  See <a href="Drawable.html">Drawable</a> .</font></td>
    1493. 

  1493.     </tr>
    1494. 

  1494.     <tr>
    1495. 

  1495.       <td>
    1496. 

  1496.       <center><a name="magick"></a> <font size="-1">magickImage</font></center>
    1497. 

  1497.       </td>
    1498. 

  1498.       <td><font size="-1">std::string</font></td>
    1499. 

  1499.       <td><font size="-1">&#160;const std::string &amp;magick_</font></td>
    1500. 

  1500.       <td><font size="-1">Get image format (e.g. "GIF")</font></td>
    1501. 

  1501.     </tr>
    1502. 

  1502.     <tr>
    1503. 

  1503.       <td>
    1504. 

  1504.       <center><a name="matte"></a> <font size="-1">matteImage</font></center>
    1505. 

  1505.       </td>
    1506. 

  1506.       <td><font size="-1">bool</font></td>
    1507. 

  1507.       <td><font size="-1">bool matteFlag_</font></td>
    1508. 

  1508.       <td><font size="-1">True if the image has transparency. If set
    1509. 

  1509. True, store  matte channel if&#160; the image has one otherwise create
    1510. 

  1510. an opaque one.</font></td>
    1511. 

  1511.     </tr>
    1512. 

  1512.     <tr>
    1513. 

  1513.       <td>
    1514. 

  1514.       <center><a name="matteColor"></a> <font size="-1">matteColorImage</font></center>
    1515. 

  1515.       </td>
    1516. 

  1516.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1517. 

  1517.       <td><font size="-1">const <a href="Color.html">Color</a>
    1518. 

  1518. &amp;matteColor_</font></td>
    1519. 

  1519.       <td><font size="-1">Image matte (frame) color</font></td>
    1520. 

  1520.     </tr>
    1521. 

  1521.     <tr>
    1522. 

  1522.       <td>
    1523. 

  1523.       <center><a name="monochrome"></a> <font size="-1">monochrome-</font> <br />
    1524. 

  1524.       <font size="-1">Image</font></center>
    1525. 

  1525.       </td>
    1526. 

  1526.       <td><font size="-1">bool</font></td>
    1527. 

  1527.       <td><font size="-1">bool flag_</font></td>
    1528. 

  1528.       <td><font size="-1">Transform the image to black and white</font></td>
    1529. 

  1529.     </tr>
    1530. 

  1530.     <tr>
    1531. 

  1531.       <td>
    1532. 

  1532.       <center><a name="pageImage"></a> <font size="-1">pageImage</font></center>
    1533. 

  1533.       </td>
    1534. 

  1534.       <td><font size="-1"><a href="Geometry.html#PostscriptPageSize">Geometry</a> </font></td>
    1535. 

  1535.       <td><font size="-1">const <a
    1536. 

  1536.  href="Geometry.html#PostscriptPageSize">Geometry</a> &amp;pageSize_</font></td>
    1537. 

  1537.       <td><font size="-1">Preferred size and location of an image
    1538. 

  1538. canvas.</font>
    1539. 

  1539.       <p><font size="-1">Use this option to specify the dimensions and
    1540. 

  1540. position of the Postscript page in dots per inch or a TEXT page in
    1541. 

  1541. pixels. This option is typically used in concert with <i><a
    1542. 

  1542.  href="STL.html#density">density</a> </i>.</font> </p>
    1543. 

  1543.       <p><font size="-1">Page may also be used to position a GIF image
    1544. 

  1544. (such as for a scene in an animation)</font></p>
    1545. 

  1545.       </td>
    1546. 

  1546.     </tr>
    1547. 

  1547.     <tr>
    1548. 

  1548.       <td>
    1549. 

  1549.       <center><a name="penColor"></a> <font size="-1">penColorImage</font></center>
    1550. 

  1550.       </td>
    1551. 

  1551.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1552. 

  1552.       <td><font size="-1">const <a href="Color.html">Color</a>
    1553. 

  1553. &amp;penColor_</font></td>
    1554. 

  1554.       <td><font size="-1">Pen color to use when annotating on or
    1555. 

  1555. drawing on image.</font></td>
    1556. 

  1556.     </tr>
    1557. 

  1557.     <tr>
    1558. 

  1558.       <td>
    1559. 

  1559.       <center><a name="penTexture"></a> <font size="-1">penTextureImage</font></center>
    1560. 

  1560.       </td>
    1561. 

  1561.       <td><font size="-1"><a href="Image++.html">Image</a> </font></td>
    1562. 

  1562.       <td><font size="-1">const Image &amp; penTexture_</font></td>
    1563. 

  1563.       <td><font size="-1">Texture image to paint with (similar to
    1564. 

  1564. penColor).</font></td>
    1565. 

  1565.     </tr>
    1566. 

  1566.     <tr>
    1567. 

  1567.       <td>
    1568. 

  1568.       <center><a name="pixelColor"></a> <font size="-1">pixelColorImage</font></center>
    1569. 

  1569.       </td>
    1570. 

  1570.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1571. 

  1571.       <td><font size="-1">size_t x_, size_t y_, const <a
    1572. 

  1572.  href="Color.html"> Color</a> &amp;color_</font></td>
    1573. 

  1573.       <td><font size="-1">Get/set pixel color at location x &amp; y.</font></td>
    1574. 

  1574.     </tr>
    1575. 

  1575.     <tr>
    1576. 

  1576.       <td>
    1577. 

  1577.       <center><a name="psPageSize"></a> <font size="-1">psPageSizeImage</font></center>
    1578. 

  1578.       </td>
    1579. 

  1579.       <td><font size="-1"><a href="Geometry.html#PostscriptPageSize">Geometry</a> </font></td>
    1580. 

  1580.       <td><font size="-1">const <a
    1581. 

  1581.  href="Geometry.html#PostscriptPageSize">Geometry</a> &amp;pageSize_</font></td>
    1582. 

  1582.       <td><font size="-1">Postscript page size. Use this&#160; option
    1583. 

  1583. to specify  the dimensions&#160; of the Postscript page in dots per inch
    1584. 

  1584. or a TEXT page in pixels. This option is typically used in concert with <i>density</i>.</font></td>
    1585. 

  1585.     </tr>
    1586. 

  1586.     <tr>
    1587. 

  1587.       <td>
    1588. 

  1588.       <center><a name="quality"></a> <font size="-1">qualityImage</font></center>
    1589. 

  1589.       </td>
    1590. 

  1590.       <td><font size="-1">size_t (0 to 100)</font></td>
    1591. 

  1591.       <td><font size="-1">size_t quality_</font></td>
    1592. 

  1592.       <td><font size="-1">JPEG/MIFF/PNG compression level (default 75).</font></td>
    1593. 

  1593.     </tr>
    1594. 

  1594.     <tr>
    1595. 

  1595.       <td>
    1596. 

  1596.       <center><a name="quantizeColors"></a> <font size="-1">quantize-</font> <br />
    1597. 

  1597.       <font size="-1">ColorsImage</font></center>
    1598. 

  1598.       </td>
    1599. 

  1599.       <td><font size="-1">size_t</font></td>
    1600. 

  1600.       <td><font size="-1">size_t colors_</font></td>
    1601. 

  1601.       <td><font size="-1">Preferred number of colors in the image. The
    1602. 

  1602. actual number of colors in the image may be less than your request, but
    1603. 

  1603. never more. Images with less unique colors than specified with this
    1604. 

  1604. option will have any duplicate or unused colors removed.</font></td>
    1605. 

  1605.     </tr>
    1606. 

  1606.     <tr>
    1607. 

  1607.       <td>
    1608. 

  1608.       <center><a name="quantizeColorSpace"></a> <font size="-1">quantize-</font> <br />
    1609. 

  1609.       <font size="-1">ColorSpaceImage</font></center>
    1610. 

  1610.       </td>
    1611. 

  1611.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a> </font></td>
    1612. 

  1612.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a>
    1613. 

  1613. colorSpace_</font></td>
    1614. 

  1614.       <td><font size="-1">Colorspace to quantize colors in (default
    1615. 

  1615. RGB). Empirical  evidence suggests that distances in color spaces such
    1616. 

  1616. as YUV or YIQ correspond  to perceptual color differences more closely
    1617. 

  1617. than do distances in RGB space.  These color spaces may give better
    1618. 

  1618. results when color reducing an image.</font></td>
    1619. 

  1619.     </tr>
    1620. 

  1620.     <tr>
    1621. 

  1621.       <td>
    1622. 

  1622.       <center><a name="quantizeDither"></a> <font size="-1">quantize-</font> <br />
    1623. 

  1623.       <font size="-1">DitherImage</font></center>
    1624. 

  1624.       </td>
    1625. 

  1625.       <td><font size="-1">bool</font></td>
    1626. 

  1626.       <td><font size="-1">bool flag_</font></td>
    1627. 

  1627.       <td><font size="-1">Apply Floyd/Steinberg error diffusion to the
    1628. 

  1628. image. The basic strategy of dithering is to&#160; trade&#160; intensity
    1629. 

  1629. resolution&#160; for&#160; spatial&#160; resolution&#160; by&#160;
    1630. 

  1630. averaging the intensities&#160;  of&#160; several&#160;
    1631. 

  1631. neighboring&#160; pixels. Images which&#160; suffer&#160;  from&#160;
    1632. 

  1632. severe&#160; contouring&#160; when&#160; reducing colors can be improved
    1633. 

  1633. with this option. The quantizeColors or monochrome option must be set
    1634. 

  1634. for this option to take effect.</font></td>
    1635. 

  1635.     </tr>
    1636. 

  1636.     <tr>
    1637. 

  1637.       <td>
    1638. 

  1638.       <center><a name="quantizeTreeDepth"></a> <font size="-1">quantize-</font> <br />
    1639. 

  1639.       <font size="-1">TreeDepthImage</font></center>
    1640. 

  1640.       </td>
    1641. 

  1641.       <td><font size="-1">size_t (0 to 8)</font></td>
    1642. 

  1642.       <td><font size="-1">size_t treeDepth_</font></td>
    1643. 

  1643.       <td><font size="-1">Depth of the quantization color
    1644. 

  1644. classification tree.  Values of 0 or 1 allow selection of the optimal
    1645. 

  1645. tree depth for the color reduction algorithm. Values between 2 and 8 may
    1646. 

  1646. be used to manually adjust the tree depth.</font></td>
    1647. 

  1647.     </tr>
    1648. 

  1648.     <tr>
    1649. 

  1649.       <td>
    1650. 

  1650.       <center><a name="renderingIntent"></a> <font size="-1">rendering-</font> <br />
    1651. 

  1651.       <font size="-1">IntentImage</font></center>
    1652. 

  1652.       </td>
    1653. 

  1653.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#RenderingIntent">RenderingIntent</a> </font></td>
    1654. 

  1654.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#RenderingIntent">RenderingIntent</a>
    1655. 

  1655. render_</font></td>
    1656. 

  1656.       <td><font size="-1">The type of rendering intent</font></td>
    1657. 

  1657.     </tr>
    1658. 

  1658.     <tr>
    1659. 

  1659.       <td>
    1660. 

  1660.       <center><a name="resolutionUnits"></a> <font size="-1">resolution-</font> <br />
    1661. 

  1661.       <font size="-1">UnitsImage</font></center>
    1662. 

  1662.       </td>
    1663. 

  1663.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ResolutionType">ResolutionType</a> </font></td>
    1664. 

  1664.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ResolutionType">ResolutionType</a>
    1665. 

  1665. units_</font></td>
    1666. 

  1666.       <td><font size="-1">Units of image resolution</font></td>
    1667. 

  1667.     </tr>
    1668. 

  1668.     <tr>
    1669. 

  1669.       <td>
    1670. 

  1670.       <center><a name="scene"></a> <font size="-1">sceneImage</font></center>
    1671. 

  1671.       </td>
    1672. 

  1672.       <td><font size="-1">size_t</font></td>
    1673. 

  1673.       <td><font size="-1">size_t scene_</font></td>
    1674. 

  1674.       <td><font size="-1">Image scene number</font></td>
    1675. 

  1675.     </tr>
    1676. 

  1676.     <tr>
    1677. 

  1677.       <td>
    1678. 

  1678.       <center><a name="size"></a> <font size="-1">sizeImage</font></center>
    1679. 

  1679.       </td>
    1680. 

  1680.       <td><font size="-1"><a href="Geometry.html">Geometry</a> </font></td>
    1681. 

  1681.       <td><font size="-1">const <a href="Geometry.html">Geometry</a>
    1682. 

  1682. &amp;geometry_</font></td>
    1683. 

  1683.       <td><font size="-1">Width and height of a raw image (an image
    1684. 

  1684. which does  not support width and height information).&#160; Size may
    1685. 

  1685. also be used to affect the image size read from a multi-resolution
    1686. 

  1686. format (e.g. Photo CD, JBIG, or JPEG.</font></td>
    1687. 

  1687.     </tr>
    1688. 

  1688.     <tr>
    1689. 

  1689.       <td>
    1690. 

  1690.       <center><a name="stripImage"></a> <font size="-1">stripImage</font></center>
    1691. 

  1691.       </td>
    1692. 

  1692.       <td><font size="-1">void</font></td>
    1693. 

  1693.       <td><font size="-1">strips an image of all profiles and comments.</font></td>
    1694. 

  1694.     </tr>
    1695. 

  1695.     <tr>
    1696. 

  1696.       <td>
    1697. 

  1697.       <center><a name="strokeColorImage"></a> <font size="-1">strokeColorImage</font></center>
    1698. 

  1698.       </td>
    1699. 

  1699.       <td><font size="-1"><a href="Color.html">Color</a> </font></td>
    1700. 

  1700.       <td><font size="-1">const <a href="Color.html">Color</a>
    1701. 

  1701. &amp;strokeColor_</font></td>
    1702. 

  1702.       <td><font size="-1">Color to use when drawing object outlines</font></td>
    1703. 

  1703.     </tr>
    1704. 

  1704.     <tr>
    1705. 

  1705.       <td>
    1706. 

  1706.       <center><a name="subImage"></a> <font size="-1">subImageImage</font></center>
    1707. 

  1707.       </td>
    1708. 

  1708.       <td><font size="-1">size_t</font></td>
    1709. 

  1709.       <td><font size="-1">size_t subImage_</font></td>
    1710. 

  1710.       <td><font size="-1">Subimage of an image sequence</font></td>
    1711. 

  1711.     </tr>
    1712. 

  1712.     <tr>
    1713. 

  1713.       <td>
    1714. 

  1714.       <center><a name="subRange"></a> <font size="-1">subRangeImage</font></center>
    1715. 

  1715.       </td>
    1716. 

  1716.       <td><font size="-1">size_t</font></td>
    1717. 

  1717.       <td><font size="-1">size_t subRange_</font></td>
    1718. 

  1718.       <td><font size="-1">Number of images relative to the base image</font></td>
    1719. 

  1719.     </tr>
    1720. 

  1720.     <tr>
    1721. 

  1721.       <td>
    1722. 

  1722.       <center><a name="tileName"></a> <font size="-1">tileNameImage</font></center>
    1723. 

  1723.       </td>
    1724. 

  1724.       <td><font size="-1">std::string</font></td>
    1725. 

  1725.       <td><font size="-1">const std::string &amp;tileName_</font></td>
    1726. 

  1726.       <td><font size="-1">Tile name</font></td>
    1727. 

  1727.     </tr>
    1728. 

  1728.     <tr>
    1729. 

  1729.       <td>
    1730. 

  1730.       <center><a name="typeImage"></a> <font size="-1">typeImage</font></center>
    1731. 

  1731.       </td>
    1732. 

  1732.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ImageType">ImageType</a> </font></td>
    1733. 

  1733.       <td><font size="-1"><a href="https://imagemagick.org/Magick++/Enumerations.html#ImageType">ImageType</a>
    1734. 

  1734. type_</font></td>
    1735. 

  1735.       <td><font size="-1">Image storage type.</font></td>
    1736. 

  1736.     </tr>
    1737. 

  1737.     <tr>
    1738. 

  1738.       <td>
    1739. 

  1739.       <center><a name="verbose"></a> <font size="-1">verboseImage</font></center>
    1740. 

  1740.       </td>
    1741. 

  1741.       <td><font size="-1">bool</font></td>
    1742. 

  1742.       <td><font size="-1">bool verboseFlag_</font></td>
    1743. 

  1743.       <td><font size="-1">Print detailed information about the image</font></td>
    1744. 

  1744.     </tr>
    1745. 

  1745.     <tr>
    1746. 

  1746.       <td>
    1747. 

  1747.       <center><a name="view"></a> <font size="-1">viewImage</font></center>
    1748. 

  1748.       </td>
    1749. 

  1749.       <td><font size="-1">std::string</font></td>
    1750. 

  1750.       <td><font size="-1">const std::string &amp;view_</font></td>
    1751. 

  1751.       <td><font size="-1">FlashPix viewing parameters.</font></td>
    1752. 

  1752.     </tr>
    1753. 

  1753.     <tr>
    1754. 

  1754.       <td>
    1755. 

  1755.       <center><a name="x11Display"></a> <font size="-1">x11DisplayImage</font></center>
    1756. 

  1756.       </td>
    1757. 

  1757.       <td><font size="-1">std::string (e.g. "hostname:0.0")</font></td>
    1758. 

  1758.       <td><font size="-1">const std::string &amp;display_</font></td>
    1759. 

  1759.       <td><font size="-1">X11 display to display to, obtain fonts from,
    1760. 

  1760. or to capture image from</font></td>
    1761. 

  1761.     </tr>
    1762. 

  1762.   </tbody>
    1763. 

  1763. </table></ul>
    1764. 

  1764. <br />
    1765. 

  1765. &#160; </p>
    1766. 

  1766. <center>
    1767. 

  1767. <h3> Query Image Format Support</h3>
    1768. 

  1768. </center>
    1769. 

  1769. <p>Magick++ provides the&#160;<a name="coderInfoList"></a> <i>coderInfoList()</i>
    1770. 

  1770. function to support obtaining information about the image formats
    1771. 

  1771. supported by ImageMagick. Support for image formats in ImageMagick
    1772. 

  1772. is provided by modules known as "coders". A user-provided container is
    1773. 

  1773. updated based on a boolean truth-table match. The truth-table supports
    1774. 

  1774. matching based on whether ImageMagick can read the format, write the
    1775. 

  1775. format, or supports multiple frames for the format. A wildcard specifier
    1776. 

  1776. is supported for any "don't care" field. The data obtained via
    1777. 

  1777. coderInfoList() may be useful for preparing GUI dialog boxes or for
    1778. 

  1778. deciding which output format to write based on support within the
    1779. 

  1779. ImageMagick build.</p>
    1780. 

  1780. <p>The definition of coderInfoList is: </p>
    1781. 

  1781. <pre class="code">
    1782. 

  1782. class CoderInfo 
    1783. 

  1783.   { 
    1784. 

  1784.   public:
    1785. 

  1785. 

  1786.     enum MatchType { 
    1787. 

  1787.       AnyMatch,  // match any coder 
    1788. 

  1788.       TrueMatch, // match coder if true 
    1789. 

  1789.       FalseMatch // match coder if false 
    1790. 

  1790.     };
    1791. 

  1791. 

  1792.     [ remaining CoderInfo methods ]
    1793. 

  1793. 

  1794.    }
    1795. 

  1795. 

  1796.   template &lt;class Container > 
    1797. 

  1797.   void coderInfoList( Container *container_, 
    1798. 

  1798.                       CoderInfo::MatchType isReadable_   = CoderInfo::AnyMatch, 
    1799. 

  1799.                       CoderInfo::MatchType isWritable_   = CoderInfo::AnyMatch, 
    1800. 

  1800.                       CoderInfo::MatchType isMultiFrame_ = CoderInfo::AnyMatch 
    1801. 

  1801.                       );
    1802. 

  1802. </pre>
    1803. 

  1803. <p>The following example shows how to retrieve a list of all of the
    1804. 

  1804. coders which support reading images and print the coder attributes (all
    1805. 

  1805. listed formats will be readable): </p>
    1806. 

  1806. <pre class="code">
    1807. 

  1807.   list&lt;CoderInfo> coderList; 
    1808. 

  1808.   coderInfoList( &amp;coderList,           // Reference to output list 
    1809. 

  1809.                  CoderInfo::TrueMatch, // Match readable formats 
    1810. 

  1810.                  CoderInfo::AnyMatch,  // Don't care about writable formats 
    1811. 

  1811.                  CoderInfo::AnyMatch); // Don't care about multi-frame support 
    1812. 

  1812.   list&lt;CoderInfo>::iterator entry = coderList.begin(); 
    1813. 

  1813.   while( entry != coderList.end() ) 
    1814. 

  1814.   { 
    1815. 

  1815.     cout &lt;&lt; entry->name() &lt;&lt; ": (" &lt;&lt; entry->description() &lt;&lt; ") : "; 
    1816. 

  1816.     cout &lt;&lt; "Readable = "; 
    1817. 

  1817.     if ( entry->isReadable() ) 
    1818. 

  1818.       cout &lt;&lt; "true"; 
    1819. 

  1819.     else 
    1820. 

  1820.       cout &lt;&lt; "false"; 
    1821. 

  1821.     cout &lt;&lt; ", "; 
    1822. 

  1822.     cout &lt;&lt; "Writable = "; 
    1823. 

  1823.     if ( entry->isWritable() ) 
    1824. 

  1824.       cout &lt;&lt; "true"; 
    1825. 

  1825.     else 
    1826. 

  1826.       cout &lt;&lt; "false"; 
    1827. 

  1827.     cout &lt;&lt; ", "; 
    1828. 

  1828.     cout &lt;&lt; "Multiframe = "; 
    1829. 

  1829.     if ( entry->isMultiframe() ) 
    1830. 

  1830.       cout &lt;&lt; "true"; 
    1831. 

  1831.     else 
    1832. 

  1832.       cout &lt;&lt; "false"; 
    1833. 

  1833.     cout &lt;&lt; endl;
    1834. 

  1834.     entry ++;
    1835. 

  1835.    } 
    1836. 

  1836. </pre>
    1837. 

  1837. <tt><font color="#000066">&#160;&#160; }</font></tt>&#160;<!-- p -->
    1838. 

  1838. <h3 style="text-align: center;">Obtaining A Color Histogram&#160; </h3>
    1839. 

  1839. <p>Magick++ provides the <a name="colorHistogram"></a><span
    1840. 

  1840.  style="font-weight: bold;">colorHistogram</span> template function to
    1841. 

  1841. retrieve a color histogram from an image. A color histogram provides a
    1842. 

  1842. count of how many times each color occurs in the image. The histogram is
    1843. 

  1843. written into a user-provided container, which (for example) could be a <span
    1844. 

  1844.  style="font-style: italic;">&lt;vector&gt;</span> or a <span
    1845. 

  1845.  style="font-style: italic;">&lt;map&gt;</span>. &#160;When a
    1846. 

  1846. &lt;map&gt; is used, the <span style="font-style: italic;">Color</span>
    1847. 

  1847. is used as the key so that quick lookups of usage counts for colors may
    1848. 

  1848. be performed. Writing into a <span style="font-style: italic;">&lt;map&gt;</span>
    1849. 

  1849. may be slower than writing into a <span style="font-style: italic;">&lt;vector&gt;</span>
    1850. 

  1850. since the <span style="font-style: italic;">&lt;map&gt;</span> sorts the
    1851. 

  1851. entries (by color intensity) and checks for uniqueness. Each histogram
    1852. 

  1852. entry is contained in type&#160;<span style="font-style: italic;">std::pair&lt;Magick::Color,unsigned
    1853. 

  1853. long&gt;</span><span style="font-style: italic;"> </span>with the first
    1854. 

  1854. member of the pair being a <span style="font-style: italic;">Color,</span>
    1855. 

  1855. and the second member of the pair being an '<span
    1856. 

  1856.  style="font-style: italic;">unsigned long</span>'. Use the <span
    1857. 

  1857.  style="font-style: italic;">&lt;pair&gt;</span> "<span
    1858. 

  1858.  style="font-style: italic;">first</span>" member to access the Color
    1859. 

  1859. and the "<span style="font-style: italic;">second</span>" member to
    1860. 

  1860. access&#160;the number of times the color occurs in the image.</p>
    1861. 

  1861. <p>The template function declaration is as follows:<br />
    1862. 

  1862. </p>
    1863. 

  1863. <pre class="code">
    1864. 

  1864. template &lt;class Container >
    1865. 

  1865. void colorHistogram( Container *histogram_, const Image image)
    1866. 

  1866. </pre>
    1867. 

  1867. <p>The following examples illustrate using both a &lt;map&gt; and a
    1868. 

  1868. &lt;vector&gt; to retrieve the color histogram, and print out a
    1869. 

  1869. formatted summary.<br />
    1870. 

  1870. <br />
    1871. 

  1871. Using &lt;map&gt;:<br />
    1872. 

  1872. &#160; &#160; <br />
    1873. 

  1873. <pre class="code">
    1874. 

  1874.   Image image("image.miff");
    1875. 

  1875.   map&lt;Color,unsigned long> histogram;
    1876. 

  1876.   colorHistogram( &amp;histogram, image );
    1877. 

  1877.   std::map&lt;Color,unsigned long>::const_iterator p=histogram.begin();
    1878. 

  1878.   while (p != histogram.end())
    1879. 

  1879.     {
    1880. 

  1880.       cout &lt;&lt; setw(10) &lt;&lt; (int)p->second &lt;&lt; ": ("
    1881. 

  1881.            &lt;&lt; setw(quantum_width) &lt;&lt; (int)p->first.redQuantum() &lt;&lt; ","
    1882. 

  1882.            &lt;&lt; setw(quantum_width) &lt;&lt; (int)p->first.greenQuantum() &lt;&lt; ","
    1883. 

  1883.            &lt;&lt; setw(quantum_width) &lt;&lt; (int)p->first.blueQuantum() &lt;&lt; ")"
    1884. 

  1884.            &lt;&lt; endl;
    1885. 

  1885.        p++;
    1886. 

  1886.     }
    1887. 

  1887. </pre>
    1888. 

  1888. <br />
    1889. 

  1889. Using &lt;vector&gt;:<br />
    1890. 

  1890. &#160; &#160; <br />
    1891. 

  1891. <pre class="code">
    1892. 

  1892.   Image image("image.miff");
    1893. 

  1893.   std::vector&lt;std::pair&lt;Color,unsigned long> > histogram;
    1894. 

  1894.   colorHistogram( &amp;histogram, image );
    1895. 

  1895.   std::vector&lt;std::pair&lt;Color,unsigned long> >::const_iterator p=histogram.begin();
    1896. 

  1896.   while (p != histogram.end())
    1897. 

  1897.     {
    1898. 

  1898.       cout &lt;&lt; setw(10) &lt;&lt; (int)p->second &lt;&lt; ": ("
    1899. 

  1899.            &lt;&lt; setw(quantum_width) &lt;&lt; (int)p->first.redQuantum() &lt;&lt; ","
    1900. 

  1900.            &lt;&lt; setw(quantum_width) &lt;&lt; (int)p->first.greenQuantum() &lt;&lt; ","
    1901. 

  1901.            &lt;&lt; setw(quantum_width) &lt;&lt; (int)p->first.blueQuantum() &lt;&lt; ")"
    1902. 

  1902.            &lt;&lt; endl;
    1903. 

  1903.       p++;
    1904. 

  1904.     }
    1905. 

  1905. </pre>
    1906. 

  1906. </p>
    1907. 

  1907. </div>
    1908. 

  1908. </body>
    1909. 

  1909. </html>
    1910.