Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 178edafa2ddbc40465115383b13685f7bc913b1f / . / www / api / profile.html
blob: 626376e225ab9cbeb6a6a1d9dd47fe202a2160eb [file] [log] [blame]
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]4<head>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]7 <title>ImageMagick: MagickCore, C API for ImageMagick: Dealing with Image Profiles</title>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]8 <meta http-equiv="Content-Language" content="en-US"/>
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
10 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]11 <meta name="Application-name" content="ImageMagick"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]12 <meta name="Description" content="ImageMagick is a software suite to create, edit, compose, or convert bitmap images in a variety of formats. Use ImageMagick to scale, rotate, shear, distort and transform images."/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]13 <meta name="Application-url" content="http://www.imagemagick.org"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]14 <meta name="Generator" content="PHP"/>
15 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, dealing, with, image, profiles, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]16 <meta name="Rating" content="GENERAL"/>
17 <meta name="Robots" content="INDEX, FOLLOW"/>
18 <meta name="Generator" content="ImageMagick Studio LLC"/>
19 <meta name="Author" content="ImageMagick Studio LLC"/>
20 <meta name="Revisit-after" content="2 DAYS"/>
21 <meta name="Resource-type" content="document"/>
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]22 <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]23 <meta name="Distribution" content="Global"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]24 <link rel="icon" href="../../images/wand.png"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]25 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
26 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]27 <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]28 <style type="text/css" media="all">
29 @import url("../../www/magick.css");
30 </style>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]31 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
cristy361f4662010-12-31 23:02:52 +0000[diff] [blame]32 <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>
33 <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />
34 <script type="text/javascript">
35 $(document).ready(function() {
36 $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
37 'transitionIn' : 'elastic',
38 'transitionOut' : 'elastic',
39 'overlayShow' : false,
40 'opacity' : true
41 });
42 });
43 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]44</head>
45
46<body id="www-imagemagick-org">
47<div class="titlebar">
48<a href="../../index.html">
49 <img src="../../images/script.png" alt="[ImageMagick]"
50 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
51<a href="http://www.networkredux.com">
52 <img src="../../images/networkredux.png" alt="[sponsor]"
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]53 style="margin-top: 42px; border: 0px; float: left;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]54<a href="http://www.imagemagick.org/discourse-server/">
55 <img src="../../images/logo.jpg" alt=""
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame^]56 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]57<a href="../../index.html">
58 <img src="../../images/sprite.jpg" alt=""
59 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
60</div>
61
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]62<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]63
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]64<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]65 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]66</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]67<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]68<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]69 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
70</div>
71<div class="sub">
72 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
73</div>
74<div class="sub">
75 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
76</div>
77<div class="sub">
78 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
79</div>
80<div class="sep"></div>
81<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]82 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]83</div>
84<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]85 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]86</div>
87<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]88 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]89</div>
90<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]91 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]92</div>
93<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]94 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]95</div>
96<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]97 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]98</div>
99<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]100 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]101</div>
102<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]103 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]104</div>
105<div class="sub">
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]106 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]107</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]108<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]110 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111</div>
112<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]113 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]114</div>
115<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]116 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]117 </div>
118<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]119 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]120</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]121<div class="menu">
122 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
123</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]124<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]125 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]126</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]127<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]128<div class="menu">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]129 <a title="Search" href="../../www/search.html">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]130</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]131<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]132<div class="menu">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]133 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]134</div>
135<div class="sub">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]136 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]137</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]138<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]139<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]140 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]141
142<div class="sponsbox">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame^]143<div class="sponsor">
144 <a title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201106010240 -->
145</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]146<div class="sponsor">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]147 <a title="Sponsor: Web Hosting" href="http://www.bodhost.com/hosting.shtml">Web Hosting</a><!-- 201104010090 -->
cristy7d52cd62010-10-01 17:26:59 +0000[diff] [blame]148</div>
149<div class="sponsor">
cristyc5baf4f2010-08-31 15:05:33 +0000[diff] [blame]150 <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
151</div>
152<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]153 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
154</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]155<div class="sponsor">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame^]156 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
157</div>
158<div class="sponsor">
159 <a title="Sponsor: Notebook Reparatur Berlin" href="http://www.notebook-reparaturen-berlin.de">Notebook Reparatur Berlin</a><!-- 2011050100025 gabi.schulze-->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]160</div>
cristybac7a162010-06-15 19:57:29 +0000[diff] [blame]161</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]162</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]163</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]164
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]165<div class="eastbar">
166 <script type="text/javascript">
167 <!--
168 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]169 google_ad_slot = "0574824969";
170 google_ad_width = 160;
171 google_ad_height = 600;
172 //-->
173 </script>
174 <script type="text/javascript"
175 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
176 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]177</div>
178
179<div class="main">
180
cristy307ba182010-12-25 01:00:34 +0000[diff] [blame]181<h1>Module profile
182 Methods</h1>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]183<p class="navigation-index">[<a href="#CloneImageProfiles">CloneImageProfiles</a> &bull; <a href="#DeleteImageProfile">DeleteImageProfile</a> &bull; <a href="#DestroyImageProfiles">DestroyImageProfiles</a> &bull; <a href="#GetImageProfile">GetImageProfile</a> &bull; <a href="#GetNextImageProfile">GetNextImageProfile</a> &bull; <a href="#ProfileImage">ProfileImage</a> &bull; <a href="#RemoveImageProfile">RemoveImageProfile</a> &bull; <a href="#ResetImageProfileIterator">ResetImageProfileIterator</a> &bull; <a href="#SetImageProfile">SetImageProfile</a> &bull; <a href="#SyncImageProfiles">SyncImageProfiles</a>]</p>
184
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]185<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
186_8c.html" id="CloneImageProfiles">CloneImageProfiles</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]187<div class="doc-section">
188
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]189<p>CloneImageProfiles() clones one or more image profiles.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]190
191<p>The format of the CloneImageProfiles method is:</p>
192
193<pre class="code">
194 MagickBooleanType CloneImageProfiles(Image *image,
195 const Image *clone_image)
196</pre>
197
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]198<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]199
200<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]201<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]202
203<h5>clone_image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]204<p>the clone image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]205
206 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]207<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
208_8c.html" id="DeleteImageProfile">DeleteImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]209<div class="doc-section">
210
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]211<p>DeleteImageProfile() deletes a profile from the image by its name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]212
213<p>The format of the DeleteImageProfile method is:</p>
214
215<pre class="code">
216 MagickBooleanTyupe DeleteImageProfile(Image *image,const char *name)
217</pre>
218
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]219<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]220
221<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]222<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]223
224<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]225<p>the profile name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]226
227 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]228<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
229_8c.html" id="DestroyImageProfiles">DestroyImageProfiles</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]230<div class="doc-section">
231
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]232<p>DestroyImageProfiles() releases memory associated with an image profile map.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]233
234<p>The format of the DestroyProfiles method is:</p>
235
236<pre class="code">
237 void DestroyImageProfiles(Image *image)
238</pre>
239
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]240<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]241
242<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]243<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]244
245 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]246<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
247_8c.html" id="GetImageProfile">GetImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]248<div class="doc-section">
249
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]250<p>GetImageProfile() gets a profile associated with an image by name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]251
252<p>The format of the GetImageProfile method is:</p>
253
254<pre class="code">
255 const StringInfo *GetImageProfile(const Image *image,const char *name)
256</pre>
257
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]258<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]259
260<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]261<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]262
263<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]264<p>the profile name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]265
266 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]267<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
268_8c.html" id="GetNextImageProfile">GetNextImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]269<div class="doc-section">
270
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]271<p>GetNextImageProfile() gets the next profile name for an image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]272
273<p>The format of the GetNextImageProfile method is:</p>
274
275<pre class="code">
276 char *GetNextImageProfile(const Image *image)
277</pre>
278
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]279<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]280
281<h5>hash_info</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]282<p>the hash info.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]283
284 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]285<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
286_8c.html" id="ProfileImage">ProfileImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]287<div class="doc-section">
288
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]289<p>ProfileImage() associates, applies, or removes an ICM, IPTC, or generic profile with / to / from an image. If the profile is NULL, it is removed from the image otherwise added or applied. Use a name of '*' and a profile of NULL to remove all profiles from the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]290
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]291<p>ICC and ICM profiles are handled as follows: If the image does not have an associated color profile, the one you provide is associated with the image and the image pixels are not transformed. Otherwise, the colorspace transform defined by the existing and new profile are applied to the image pixels and the new profile is associated with the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]292
293<p>The format of the ProfileImage method is:</p>
294
295<pre class="code">
296 MagickBooleanType ProfileImage(Image *image,const char *name,
297 const void *datum,const size_t length,const MagickBooleanType clone)
298</pre>
299
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]300<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]301
302<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]303<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]304
305<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]306<p>Name of profile to add or remove: ICC, IPTC, or generic profile.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]307
308<h5>datum</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]309<p>the profile data.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]310
311<h5>length</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]312<p>the length of the profile.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]313
314<h5>clone</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]315<p>should be MagickFalse.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]316
317 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]318<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
319_8c.html" id="RemoveImageProfile">RemoveImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]320<div class="doc-section">
321
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]322<p>RemoveImageProfile() removes a named profile from the image and returns its value.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]323
324<p>The format of the RemoveImageProfile method is:</p>
325
326<pre class="code">
327 void *RemoveImageProfile(Image *image,const char *name)
328</pre>
329
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]330<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]331
332<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]333<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]334
335<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]336<p>the profile name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]337
338 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]339<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
340_8c.html" id="ResetImageProfileIterator">ResetImageProfileIterator</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]341<div class="doc-section">
342
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]343<p>ResetImageProfileIterator() resets the image profile iterator. Use it in conjunction with GetNextImageProfile() to iterate over all the profiles associated with an image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]344
345<p>The format of the ResetImageProfileIterator method is:</p>
346
347<pre class="code">
348 ResetImageProfileIterator(Image *image)
349</pre>
350
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]351<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]352
353<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]354<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]355
356 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]357<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
358_8c.html" id="SetImageProfile">SetImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]359<div class="doc-section">
360
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]361<p>SetImageProfile() adds a named profile to the image. If a profile with the same name already exists, it is replaced. This method differs from the ProfileImage() method in that it does not apply CMS color profiles.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]362
363<p>The format of the SetImageProfile method is:</p>
364
365<pre class="code">
366 MagickBooleanType SetImageProfile(Image *image,const char *name,
367 const StringInfo *profile)
368</pre>
369
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]370<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]371
372<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]373<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]374
375<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]376<p>the profile name, for example icc, exif, and 8bim (8bim is the Photoshop wrapper for iptc profiles).</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]377
378<h5>profile</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]379<p>A StringInfo structure that contains the named profile.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]380
381 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]382<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
383_8c.html" id="SyncImageProfiles">SyncImageProfiles</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]384<div class="doc-section">
385
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]386<p>SyncImageProfiles() synchronizes image properties with the image profiles. Currently we only support updating the EXIF resolution and orientation.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]387
388<p>The format of the SyncImageProfiles method is:</p>
389
390<pre class="code">
391 MagickBooleanType SyncImageProfiles(Image *image)
392</pre>
393
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]394<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]395
396<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]397<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]398
399 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]400
401</div>
402
403<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]404 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]405 <span id="linkbar-center">
406 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]407 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]408 </span>
409 <span id="linkbar-east">&nbsp;</span>
410 </div>
411 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]412 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]413 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
414 </div>
415 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]416 <script type="text/javascript">
417 var _gaq = _gaq || [];
418 _gaq.push(['_setAccount', 'UA-17690367-1']);
419 _gaq.push(['_trackPageview']);
420
421 (function() {
422 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
423 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
424 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
425 })();
426 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]427</body>
428</html>