Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 7a40ba8d8dae1086103297305d7cd8825ea59fa9 / . / www / api / profile.html
blob: f5ce904381190ab1ba1a77f3aa4d07c4ec6e5903 [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]"
53 style="margin: 45px auto; border: 0px; float: left;" /></a>
54<a href="http://www.imagemagick.org/discourse-server/">
55 <img src="../../images/logo.jpg" alt=""
56 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
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">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]129 <a title="Search" href="../http://www.imagemagick.org/script/search.php">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">
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]143<div class="sponsor">
144 <a title="Sponsor: Web Hosting" href="http://www.bodhost.com/hosting.html">Web Hosting</a><!-- 201104010090 -->
cristy7d52cd62010-10-01 17:26:59 +0000[diff] [blame]145</div>
146<div class="sponsor">
147 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
cristy73fd1cd2010-09-12 19:14:25 +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">
156 <a title="Sponsor: Notebook Reparatur Berlin" href="http://www.notebook-reparaturen-berlin.de">Notebook Reparatur Berlin</a><!-- 2011050100025 gabi.schulze-->
157</div>
cristybac7a162010-06-15 19:57:29 +0000[diff] [blame]158</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]159</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]160</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]161
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]162<div class="eastbar">
163 <script type="text/javascript">
164 <!--
165 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]166 google_ad_slot = "0574824969";
167 google_ad_width = 160;
168 google_ad_height = 600;
169 //-->
170 </script>
171 <script type="text/javascript"
172 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
173 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]174</div>
175
176<div class="main">
177
cristy307ba182010-12-25 01:00:34 +0000[diff] [blame]178<h1>Module profile
179 Methods</h1>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]180<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>
181
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]182<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
183_8c.html" id="CloneImageProfiles">CloneImageProfiles</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]184<div class="doc-section">
185
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]186<p>CloneImageProfiles() clones one or more image profiles.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]187
188<p>The format of the CloneImageProfiles method is:</p>
189
190<pre class="code">
191 MagickBooleanType CloneImageProfiles(Image *image,
192 const Image *clone_image)
193</pre>
194
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]195<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]196
197<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]198<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]199
200<h5>clone_image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]201<p>the clone image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]202
203 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]204<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
205_8c.html" id="DeleteImageProfile">DeleteImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]206<div class="doc-section">
207
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]208<p>DeleteImageProfile() deletes a profile from the image by its name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]209
210<p>The format of the DeleteImageProfile method is:</p>
211
212<pre class="code">
213 MagickBooleanTyupe DeleteImageProfile(Image *image,const char *name)
214</pre>
215
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]216<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]217
218<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]219<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]220
221<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]222<p>the profile name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]223
224 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]225<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
226_8c.html" id="DestroyImageProfiles">DestroyImageProfiles</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]227<div class="doc-section">
228
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]229<p>DestroyImageProfiles() releases memory associated with an image profile map.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]230
231<p>The format of the DestroyProfiles method is:</p>
232
233<pre class="code">
234 void DestroyImageProfiles(Image *image)
235</pre>
236
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]237<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]238
239<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]240<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]241
242 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]243<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
244_8c.html" id="GetImageProfile">GetImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]245<div class="doc-section">
246
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]247<p>GetImageProfile() gets a profile associated with an image by name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]248
249<p>The format of the GetImageProfile method is:</p>
250
251<pre class="code">
252 const StringInfo *GetImageProfile(const Image *image,const char *name)
253</pre>
254
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]255<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]256
257<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]258<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]259
260<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]261<p>the profile name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]262
263 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]264<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
265_8c.html" id="GetNextImageProfile">GetNextImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]266<div class="doc-section">
267
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]268<p>GetNextImageProfile() gets the next profile name for an image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]269
270<p>The format of the GetNextImageProfile method is:</p>
271
272<pre class="code">
273 char *GetNextImageProfile(const Image *image)
274</pre>
275
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]276<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]277
278<h5>hash_info</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]279<p>the hash info.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]280
281 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]282<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
283_8c.html" id="ProfileImage">ProfileImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]284<div class="doc-section">
285
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]286<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]287
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]288<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]289
290<p>The format of the ProfileImage method is:</p>
291
292<pre class="code">
293 MagickBooleanType ProfileImage(Image *image,const char *name,
294 const void *datum,const size_t length,const MagickBooleanType clone)
295</pre>
296
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]297<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]298
299<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]300<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]301
302<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]303<p>Name of profile to add or remove: ICC, IPTC, or generic profile.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]304
305<h5>datum</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]306<p>the profile data.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]307
308<h5>length</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]309<p>the length of the profile.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]310
311<h5>clone</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]312<p>should be MagickFalse.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]313
314 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]315<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
316_8c.html" id="RemoveImageProfile">RemoveImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]317<div class="doc-section">
318
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]319<p>RemoveImageProfile() removes a named profile from the image and returns its value.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]320
321<p>The format of the RemoveImageProfile method is:</p>
322
323<pre class="code">
324 void *RemoveImageProfile(Image *image,const char *name)
325</pre>
326
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]327<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]328
329<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]330<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]331
332<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]333<p>the profile name.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]334
335 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]336<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
337_8c.html" id="ResetImageProfileIterator">ResetImageProfileIterator</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]338<div class="doc-section">
339
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]340<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]341
342<p>The format of the ResetImageProfileIterator method is:</p>
343
344<pre class="code">
345 ResetImageProfileIterator(Image *image)
346</pre>
347
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]348<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]349
350<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]351<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]352
353 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]354<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
355_8c.html" id="SetImageProfile">SetImageProfile</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]356<div class="doc-section">
357
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]358<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]359
360<p>The format of the SetImageProfile method is:</p>
361
362<pre class="code">
363 MagickBooleanType SetImageProfile(Image *image,const char *name,
364 const StringInfo *profile)
365</pre>
366
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]367<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]368
369<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]370<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]371
372<h5>name</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]373<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]374
375<h5>profile</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]376<p>A StringInfo structure that contains the named profile.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]377
378 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]379<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/profile
380_8c.html" id="SyncImageProfiles">SyncImageProfiles</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]381<div class="doc-section">
382
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]383<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]384
385<p>The format of the SyncImageProfiles method is:</p>
386
387<pre class="code">
388 MagickBooleanType SyncImageProfiles(Image *image)
389</pre>
390
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]391<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]392
393<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame^]394<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]395
396 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]397
398</div>
399
400<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]401 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]402 <span id="linkbar-center">
403 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]404 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]405 </span>
406 <span id="linkbar-east">&nbsp;</span>
407 </div>
408 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]409 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]410 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
411 </div>
412 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]413 <script type="text/javascript">
414 var _gaq = _gaq || [];
415 _gaq.push(['_setAccount', 'UA-17690367-1']);
416 _gaq.push(['_trackPageview']);
417
418 (function() {
419 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
420 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
421 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
422 })();
423 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]424</body>
425</html>