Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 851dbceb0a51cbcd3ed512f074e9f2d797b7cbc1 / . / www / api / memory.html
blob: e8a14fd5f22cc14c675a9dd6bfdd35d4ddee7acb [file] [log] [blame]
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
cristy2c839602010-04-03 02:32:08 +0000[diff] [blame]3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]4<head>
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]5 <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
7 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]8 <style type="text/css" media="all">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]9 @import url("../../www/magick.css");
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]10 </style>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]11 <link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
12 <title>ImageMagick: MagickCore, C API for ImageMagick: Memory Allocation</title>
13 <meta http-equiv="Content-Language" content="en-US"/>
14 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
15 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
16 <meta name="Generator" content="PHP"/>
17 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, memory, allocation, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
18 <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves. ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems. The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
19 <meta name="Rating" content="GENERAL"/>
20 <meta name="Robots" content="INDEX, FOLLOW"/>
21 <meta name="Generator" content="ImageMagick Studio LLC"/>
22 <meta name="Author" content="ImageMagick Studio LLC"/>
23 <meta name="Revisit-after" content="2 DAYS"/>
24 <meta name="Resource-type" content="document"/>
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]25 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]26 <meta name="Distribution" content="Global"/>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]27</head>
28
29<body id="www-imagemagick-org">
30<div class="titlebar">
31<a href="../../index.html">
32 <img src="../../images/script.png" alt="[ImageMagick]"
33 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
34<a href="http://www.networkredux.com">
35 <img src="../../images/networkredux.png" alt="[sponsor]"
36 style="margin: 45px auto; border: 0px; float: left;" /></a>
37<a href="http://www.imagemagick.org/discourse-server/">
38 <img src="../../images/logo.jpg" alt=""
39 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
40<a href="../../index.html">
41 <img src="../../images/sprite.jpg" alt=""
42 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
43</div>
44
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]45<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]46
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]47<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]48 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]49</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]50<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]51<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]52 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
53</div>
54<div class="sub">
55 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
56</div>
57<div class="sub">
58 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
59</div>
60<div class="sub">
61 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
62</div>
63<div class="sep"></div>
64<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]65 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]66</div>
67<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]68 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]69</div>
70<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]71 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]72</div>
73<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]74 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]75</div>
76<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]77 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]78</div>
79<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]80 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]81</div>
82<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]83 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]84</div>
85<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]86 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]87</div>
88<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]89 <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]90</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]91<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]92<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]93 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]94</div>
95<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]96 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]97</div>
98<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]99 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]100 </div>
101<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]102 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]104<div class="menu">
105 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
106</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]107<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]108 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]110<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]112 <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]113</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]114<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]115<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]116 <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]117</div>
118<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]119 <a title="Site Map: Links"href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]120</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]121<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]122<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]123 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]124
125<div class="sponsbox">
126<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame^]127 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
128</div>
129<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]130 <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]131</div>
132<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]133 <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
cristy8f900122010-03-05 15:26:31 +0000[diff] [blame]134</div>
135<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]136 <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]137</div>
138<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]139 <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
cristyc1c61662009-09-30 14:04:37 +0000[diff] [blame]140</div>
141<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]142 <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]143</div>
144<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame^]145 <a title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]146</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
148</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]149</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]150
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]151<div class="eastbar">
152 <script type="text/javascript">
153 <!--
154 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]155 google_ad_slot = "0574824969";
156 google_ad_width = 160;
157 google_ad_height = 600;
158 //-->
159 </script>
160 <script type="text/javascript"
161 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
162 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]163</div>
164
165<div class="main">
166
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]167<p class="navigation-index">[<a href="#AcquireAlignedMemory">AcquireAlignedMemory</a> &bull; <a href="#AcquireMagickMemory">AcquireMagickMemory</a> &bull; <a href="#AcquireQuantumMemory">AcquireQuantumMemory</a> &bull; <a href="#CopyMagickMemory">CopyMagickMemory</a> &bull; <a href="#GetMagickMemoryMethods">GetMagickMemoryMethods</a> &bull; <a href="#RelinquishAlignedMemory">RelinquishAlignedMemory</a> &bull; <a href="#RelinquishMagickMemory">RelinquishMagickMemory</a> &bull; <a href="#ResetMagickMemory">ResetMagickMemory</a> &bull; <a href="#ResizeMagickMemory">ResizeMagickMemory</a> &bull; <a href="#ResizeQuantumMemory">ResizeQuantumMemory</a> &bull; <a href="#SetMagickMemoryMethods">SetMagickMemoryMethods</a>]</p>
168
169<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
170_8c.html" target="source" name="AcquireAlignedMemory">AcquireAlignedMemory</a></h2>
171<div class="doc-section">
172
173<p>AcquireAlignedMemory() returns a pointer to a block of memory at least size bytes whose address is a multiple of 16*sizeof(void *).</p></ol>
174
175<p>The format of the AcquireAlignedMemory method is:</p>
176
177<pre class="code">
178 void *AcquireAlignedMemory(const size_t count,const size_t quantum)
179</pre>
180
181<p>A description of each parameter follows:</p></ol>
182
183<h5>count</h5>
184<ol><p>the number of quantum elements to allocate.</p></ol>
185
186<h5>quantum</h5>
187<ol><p>the number of bytes in each quantum.</p></ol>
188
189 </div>
190<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
191_8c.html" target="source" name="AcquireMagickMemory">AcquireMagickMemory</a></h2>
192<div class="doc-section">
193
194<p>AcquireMagickMemory() returns a pointer to a block of memory at least size bytes suitably aligned for any use.</p></ol>
195
196<p>The format of the AcquireMagickMemory method is:</p>
197
198<pre class="code">
199 void *AcquireMagickMemory(const size_t size)
200</pre>
201
202<p>A description of each parameter follows:</p></ol>
203
204<h5>size</h5>
205<ol><p>the size of the memory in bytes to allocate.</p></ol>
206
207 </div>
208<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
209_8c.html" target="source" name="AcquireQuantumMemory">AcquireQuantumMemory</a></h2>
210<div class="doc-section">
211
212<p>AcquireQuantumMemory() returns a pointer to a block of memory at least count * quantum bytes suitably aligned for any use.</p></ol>
213
214<p>The format of the AcquireQuantumMemory method is:</p>
215
216<pre class="code">
217 void *AcquireQuantumMemory(const size_t count,const size_t quantum)
218</pre>
219
220<p>A description of each parameter follows:</p></ol>
221
222<h5>count</h5>
223<ol><p>the number of quantum elements to allocate.</p></ol>
224
225<h5>quantum</h5>
226<ol><p>the number of bytes in each quantum.</p></ol>
227
228 </div>
229<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
230_8c.html" target="source" name="CopyMagickMemory">CopyMagickMemory</a></h2>
231<div class="doc-section">
232
233<p>CopyMagickMemory() copies size bytes from memory area source to the destination. Copying between objects that overlap will take place correctly. It returns destination.</p></ol>
234
235<p>The format of the CopyMagickMemory method is:</p>
236
237<pre class="code">
238 void *CopyMagickMemory(void *destination,const void *source,
239 const size_t size)
240</pre>
241
242<p>A description of each parameter follows:</p></ol>
243
244<h5>destination</h5>
245<ol><p>the destination.</p></ol>
246
247<h5>source</h5>
248<ol><p>the source.</p></ol>
249
250<h5>size</h5>
251<ol><p>the size of the memory in bytes to allocate.</p></ol>
252
253 </div>
254<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
255_8c.html" target="source" name="GetMagickMemoryMethods">GetMagickMemoryMethods</a></h2>
256<div class="doc-section">
257
258<p>GetMagickMemoryMethods() gets the methods to acquire, resize, and destroy memory.</p></ol>
259
260<p>The format of the GetMagickMemoryMethods() method is:</p>
261
262<pre class="code">
263 void GetMagickMemoryMethods(AcquireMemoryHandler *acquire_memory_handler,
264 ResizeMemoryHandler *resize_memory_handler,
265 DestroyMemoryHandler *destroy_memory_handler)
266</pre>
267
268<p>A description of each parameter follows:</p></ol>
269
270<h5>acquire_memory_handler</h5>
271<ol><p>method to acquire memory (e.g. malloc).</p></ol>
272
273<h5>resize_memory_handler</h5>
274<ol><p>method to resize memory (e.g. realloc).</p></ol>
275
276<h5>destroy_memory_handler</h5>
277<ol><p>method to destroy memory (e.g. free).</p></ol>
278
279 </div>
280<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
281_8c.html" target="source" name="RelinquishAlignedMemory">RelinquishAlignedMemory</a></h2>
282<div class="doc-section">
283
284<p>RelinquishAlignedMemory() frees memory acquired with AcquireAlignedMemory() or reuse.</p></ol>
285
286<p>The format of the RelinquishAlignedMemory method is:</p>
287
288<pre class="code">
289 void *RelinquishAlignedMemory(void *memory)
290</pre>
291
292<p>A description of each parameter follows:</p></ol>
293
294<h5>memory</h5>
295<ol><p>A pointer to a block of memory to free for reuse.</p></ol>
296
297 </div>
298<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
299_8c.html" target="source" name="RelinquishMagickMemory">RelinquishMagickMemory</a></h2>
300<div class="doc-section">
301
302<p>RelinquishMagickMemory() frees memory acquired with AcquireMagickMemory() or AcquireQuantumMemory() for reuse.</p></ol>
303
304<p>The format of the RelinquishMagickMemory method is:</p>
305
306<pre class="code">
307 void *RelinquishMagickMemory(void *memory)
308</pre>
309
310<p>A description of each parameter follows:</p></ol>
311
312<h5>memory</h5>
313<ol><p>A pointer to a block of memory to free for reuse.</p></ol>
314
315 </div>
316<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
317_8c.html" target="source" name="ResetMagickMemory">ResetMagickMemory</a></h2>
318<div class="doc-section">
319
320<p>ResetMagickMemory() fills the first size bytes of the memory area pointed to by memory with the constant byte c.</p></ol>
321
322<p>The format of the ResetMagickMemory method is:</p>
323
324<pre class="code">
325 void *ResetMagickMemory(void *memory,int byte,const size_t size)
326</pre>
327
328<p>A description of each parameter follows:</p></ol>
329
330<h5>memory</h5>
331<ol><p>A pointer to a memory allocation.</p></ol>
332
333<h5>byte</h5>
334<ol><p>Set the memory to this value.</p></ol>
335
336<h5>size</h5>
337<ol><p>Size of the memory to reset.</p></ol>
338
339 </div>
340<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
341_8c.html" target="source" name="ResizeMagickMemory">ResizeMagickMemory</a></h2>
342<div class="doc-section">
343
344<p>ResizeMagickMemory() changes the size of the memory and returns a pointer to the (possibly moved) block. The contents will be unchanged up to the lesser of the new and old sizes.</p></ol>
345
346<p>The format of the ResizeMagickMemory method is:</p>
347
348<pre class="code">
349 void *ResizeMagickMemory(void *memory,const size_t size)
350</pre>
351
352<p>A description of each parameter follows:</p></ol>
353
354<h5>memory</h5>
355<ol><p>A pointer to a memory allocation.</p></ol>
356
357<h5>size</h5>
358<ol><p>the new size of the allocated memory.</p></ol>
359
360 </div>
361<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
362_8c.html" target="source" name="ResizeQuantumMemory">ResizeQuantumMemory</a></h2>
363<div class="doc-section">
364
365<p>ResizeQuantumMemory() changes the size of the memory and returns a pointer to the (possibly moved) block. The contents will be unchanged up to the lesser of the new and old sizes.</p></ol>
366
367<p>The format of the ResizeQuantumMemory method is:</p>
368
369<pre class="code">
370 void *ResizeQuantumMemory(void *memory,const size_t count,
371 const size_t quantum)
372</pre>
373
374<p>A description of each parameter follows:</p></ol>
375
376<h5>memory</h5>
377<ol><p>A pointer to a memory allocation.</p></ol>
378
379<h5>count</h5>
380<ol><p>the number of quantum elements to allocate.</p></ol>
381
382<h5>quantum</h5>
383<ol><p>the number of bytes in each quantum.</p></ol>
384
385 </div>
386<h2><a href="http://www.imagemagick.org/api/MagickCore/memory
387_8c.html" target="source" name="SetMagickMemoryMethods">SetMagickMemoryMethods</a></h2>
388<div class="doc-section">
389
390<p>SetMagickMemoryMethods() sets the methods to acquire, resize, and destroy memory.</p></ol>
391
392<p>The format of the SetMagickMemoryMethods() method is:</p>
393
394<pre class="code">
395 SetMagickMemoryMethods(AcquireMemoryHandler acquire_memory_handler,
396 ResizeMemoryHandler resize_memory_handler,
397 DestroyMemoryHandler destroy_memory_handler)
398</pre>
399
400<p>A description of each parameter follows:</p></ol>
401
402<h5>acquire_memory_handler</h5>
403<ol><p>method to acquire memory (e.g. malloc).</p></ol>
404
405<h5>resize_memory_handler</h5>
406<ol><p>method to resize memory (e.g. realloc).</p></ol>
407
408<h5>destroy_memory_handler</h5>
409<ol><p>method to destroy memory (e.g. free).</p></ol>
410
411 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]412
413</div>
414
415<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]416 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]417 <span id="linkbar-center">
418 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]419 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]420 </span>
421 <span id="linkbar-east">&nbsp;</span>
422 </div>
423 <div class="footer">
424 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
425 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
426 </div>
427 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]428 <script type="text/javascript">
429 var _gaq = _gaq || [];
430 _gaq.push(['_setAccount', 'UA-17690367-1']);
431 _gaq.push(['_trackPageview']);
432
433 (function() {
434 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
435 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
436 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
437 })();
438 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]439</body>
440</html>