granicus.if.org Git - imagemagick/blob - www/api/wand-view.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">\r
   4 <head>\r
   5   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>\r
   6   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   7   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   8   <style type="text/css" media="all">\r
   9     @import url("../../www/magick.css");\r
  10   </style>\r
  11   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  12   <title>ImageMagick: MagickWand, C API for ImageMagick: Wand View Methods</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="magickwc, api, for, imagemagick:, wview, methods, 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"/>
  25   <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
  26   <meta name="Distribution" content="Global"/>
  27 </head>\r
  28 \r
  29 <body id="www-imagemagick-org">\r
  30 <div class="titlebar">\r
  31 <a href="../../index.html">\r
  32   <img src="../../images/script.png" alt="[ImageMagick]"\r
  33   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  34 <a href="http://www.networkredux.com">\r
  35   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  36   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  37 <a href="http://www.imagemagick.org/discourse-server/">\r
  38   <img src="../../images/logo.jpg" alt=""\r
  39   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  40 <a href="../../index.html">\r
  41   <img src="../../images/sprite.jpg" alt=""\r
  42   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  43 </div>\r
  44 \r
  45 <div class="westbar">\r
  46 \r
  47 <div class="menu">
  48   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  49 </div>
  50 <div class="sep"></div>\r
  51 <div class="menu">
  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>\r
  64 <div class="menu">
  65   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  66 </div>
  67 <div class="sub">
  68     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
  69 </div>
  70 <div class="sub">
  71     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
  72 </div>
  73 <div class="sub">
  74     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
  75 </div>
  76 <div class="menu">
  77   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
  78 </div>
  79 <div class="sub">
  80     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
  81 </div>
  82 <div class="sub">
  83     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
  84 </div>
  85 <div class="sub">
  86     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
  87 </div>
  88 <div class="sub">
  89     <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
  90 </div>
  91 <div class="sep"></div>\r
  92 <div  class="menu">
  93    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
  94 </div>
  95 <div class="sub">
  96     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
  97 </div>
  98 <div class="sub">
  99     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
 100  </div>
 101 <div class="menu">
 102   <a title="Resources" href="../../www/resources.html">Resources</a>
 103 </div>
 104 <div class="menu">
 105   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
 106 </div>
 107 <div class="menu">
 108   <a title="Download" href="../../www/download.html">Download</a>
 109 </div>
 110 <div class="sep"></div>\r
 111 <div class="menu">
 112   <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
 113 </div>
 114 <div class="sep"></div>\r
 115 <div class="menu">
 116   <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
 117 </div>
 118 <div  class="sub">
 119     <a title="Site Map: Links"href="../../www/links.html">Links</a>
 120 </div>
 121 <div class="sep"></div>\r
 122 <div  class="menu">
 123   <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 124
 125 <div class="sponsbox">
 126 <div  class="sponsor">
 127   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 128 </div>
 129 <div  class="sponsor">
 130   <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
 131 </div>
 132 <div  class="sponsor">
 133   <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
 134 </div>
 135 <div  class="sponsor">
 136   <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 137 </div>
 138 <div  class="sponsor">
 139   <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 140 </div>
 141 <div  class="sponsor">
 142    <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 143 </div>
 144 <div  class="sponsor">
 145    <a title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
 146 </div>
 147 </div>
 148 </div>
 149 </div>\r
 150 \r
 151 <div class="eastbar">\r
 152   <script type="text/javascript">\r
 153   <!--\r
 154     google_ad_client = "pub-3129977114552745";\r
 155     google_ad_slot = "0574824969";\r
 156     google_ad_width = 160;\r
 157     google_ad_height = 600;\r
 158   //-->\r
 159   </script>\r
 160   <script type="text/javascript"\r
 161     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
 162   </script>\r
 163 </div>\r
 164 \r
 165 <div class="main">\r
 166 \r
 167 <p class="navigation-index">[<a href="#CloneWandView">CloneWandView</a> &bull; <a href="#DestroyWandView">DestroyWandView</a> &bull; <a href="#DuplexTransferWandViewIterator">DuplexTransferWandViewIterator</a> &bull; <a href="#GetWandViewException">GetWandViewException</a> &bull; <a href="#GetWandViewExtent">GetWandViewExtent</a> &bull; <a href="#GetWandViewIterator">GetWandViewIterator</a> &bull; <a href="#GetWandViewPixels">GetWandViewPixels</a> &bull; <a href="#GetWandViewWand">GetWandViewWand</a> &bull; <a href="#IsWandView">IsWandView</a> &bull; <a href="#NewWandView">NewWandView</a> &bull; <a href="#NewWandViewExtent">NewWandViewExtent</a> &bull; <a href="#SetWandViewDescription">SetWandViewDescription</a> &bull; <a href="#SetWandViewIterator">SetWandViewIterator</a> &bull; <a href="#TransferWandViewIterator">TransferWandViewIterator</a> &bull; <a href="#UpdateWandViewIterator">UpdateWandViewIterator</a>]</p>
 168
 169 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 170 _8c.html" target="source" name="CloneWandView">CloneWandView</a></h2>
 171 <div class="doc-section">
 172
 173 <p>CloneWandView() makes a copy of the specified wand view.</p></ol>
 174
 175 <p>The format of the CloneWandView method is:</p>
 176
 177 <pre class="code">
 178   WandView *CloneWandView(const WandView *wand_view)
 179 </pre>
 180
 181 <p>A description of each parameter follows:</p></ol>
 182
 183 <h5>wand_view</h5>
 184 <ol><p>the wand view.</p></ol>
 185
 186  </div>
 187 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 188 _8c.html" target="source" name="DestroyWandView">DestroyWandView</a></h2>
 189 <div class="doc-section">
 190
 191 <p>DestroyWandView() deallocates memory associated with a wand view.</p></ol>
 192
 193 <p>The format of the DestroyWandView method is:</p>
 194
 195 <pre class="code">
 196   WandView *DestroyWandView(WandView *wand_view)
 197 </pre>
 198
 199 <p>A description of each parameter follows:</p></ol>
 200
 201 <h5>wand_view</h5>
 202 <ol><p>the wand view.</p></ol>
 203
 204  </div>
 205 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 206 _8c.html" target="source" name="DuplexTransferWandViewIterator">DuplexTransferWandViewIterator</a></h2>
 207 <div class="doc-section">
 208
 209 <p>DuplexTransferWandViewIterator() iterates over three wand views in parallel and calls your transfer method for each scanline of the view.  The source and duplex pixel extent is not confined to the image canvas-- that is you can include negative offsets or widths or heights that exceed the image dimension.  However, the destination wand view is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension are permitted.</p></ol>
 210
 211 <p>The callback signature is:</p>
 212
 213 <pre class="text">
 214   MagickBooleanType DuplexTransferImageViewMethod(const WandView *source,
 215     const WandView *duplex,WandView *destination,const ssize_t y,
 216     const int thread_id,void *context)
 217 </pre>
 218
 219 <p>Use this pragma if the view is not single threaded:</p>
 220
 221 <pre class="text">
 222       #pragma omp critical
 223 </pre>
 224
 225 <p>to define a section of code in your callback transfer method that must be executed by a single thread at a time.</p></ol>
 226
 227 <p>The format of the DuplexTransferWandViewIterator method is:</p>
 228
 229 <pre class="code">
 230   MagickBooleanType DuplexTransferWandViewIterator(WandView *source,
 231     WandView *duplex,WandView *destination,
 232     DuplexTransferWandViewMethod transfer,void *context)
 233 </pre>
 234
 235 <p>A description of each parameter follows:</p></ol>
 236
 237 <h5>source</h5>
 238 <ol><p>the source wand view.</p></ol>
 239
 240 <h5>duplex</h5>
 241 <ol><p>the duplex wand view.</p></ol>
 242
 243 <h5>destination</h5>
 244 <ol><p>the destination wand view.</p></ol>
 245
 246 <h5>transfer</h5>
 247 <ol><p>the transfer callback method.</p></ol>
 248
 249 <h5>context</h5>
 250 <ol><p>the user defined context.</p></ol>
 251
 252  </div>
 253 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 254 _8c.html" target="source" name="GetWandViewException">GetWandViewException</a></h2>
 255 <div class="doc-section">
 256
 257 <p>GetWandViewException() returns the severity, reason, and description of any error that occurs when utilizing a wand view.</p></ol>
 258
 259 <p>The format of the GetWandViewException method is:</p>
 260
 261 <pre class="code">
 262   char *GetWandViewException(const PixelWand *wand_view,
 263     ExceptionType *severity)
 264 </pre>
 265
 266 <p>A description of each parameter follows:</p></ol>
 267
 268 <h5>wand_view</h5>
 269 <ol><p>the pixel wand_view.</p></ol>
 270
 271 <h5>severity</h5>
 272 <ol><p>the severity of the error is returned here.</p></ol>
 273
 274  </div>
 275 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 276 _8c.html" target="source" name="GetWandViewExtent">GetWandViewExtent</a></h2>
 277 <div class="doc-section">
 278
 279 <p>GetWandViewExtent() returns the wand view extent.</p></ol>
 280
 281 <p>The format of the GetWandViewExtent method is:</p>
 282
 283 <pre class="code">
 284   RectangleInfo GetWandViewExtent(const WandView *wand_view)
 285 </pre>
 286
 287 <p>A description of each parameter follows:</p></ol>
 288
 289 <h5>wand_view</h5>
 290 <ol><p>the wand view.</p></ol>
 291
 292  </div>
 293 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 294 _8c.html" target="source" name="GetWandViewIterator">GetWandViewIterator</a></h2>
 295 <div class="doc-section">
 296
 297 <p>GetWandViewIterator() iterates over the wand view in parallel and calls your get method for each scanline of the view.  The pixel extent is not confined to the image canvas-- that is you can include negative offsets or widths or heights that exceed the image dimension.  Any updates to the pixels in your callback are ignored.</p></ol>
 298
 299 <p>The callback signature is:</p>
 300
 301 <pre class="text">
 302   MagickBooleanType GetImageViewMethod(const WandView *source,
 303     const ssize_t y,const int thread_id,void *context)
 304 </pre>
 305
 306 <p>Use this pragma if the view is not single threaded:</p>
 307
 308 <pre class="text">
 309       #pragma omp critical
 310 </pre>
 311
 312 <p>to define a section of code in your callback get method that must be executed by a single thread at a time.</p></ol>
 313
 314 <p>The format of the GetWandViewIterator method is:</p>
 315
 316 <pre class="code">
 317   MagickBooleanType GetWandViewIterator(WandView *source,
 318     GetWandViewMethod get,void *context)
 319 </pre>
 320
 321 <p>A description of each parameter follows:</p></ol>
 322
 323 <h5>source</h5>
 324 <ol><p>the source wand view.</p></ol>
 325
 326 <h5>get</h5>
 327 <ol><p>the get callback method.</p></ol>
 328
 329 <h5>context</h5>
 330 <ol><p>the user defined context.</p></ol>
 331
 332  </div>
 333 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 334 _8c.html" target="source" name="GetWandViewPixels">GetWandViewPixels</a></h2>
 335 <div class="doc-section">
 336
 337 <p>GetWandViewPixels() returns the wand view pixel_wands.</p></ol>
 338
 339 <p>The format of the GetWandViewPixels method is:</p>
 340
 341 <pre class="code">
 342   PixelWand *GetWandViewPixels(const WandView *wand_view)
 343 </pre>
 344
 345 <p>A description of each parameter follows:</p></ol>
 346
 347 <h5>wand_view</h5>
 348 <ol><p>the wand view.</p></ol>
 349
 350  </div>
 351 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 352 _8c.html" target="source" name="GetWandViewWand">GetWandViewWand</a></h2>
 353 <div class="doc-section">
 354
 355 <p>GetWandViewWand() returns the magick wand associated with the wand view.</p></ol>
 356
 357 <p>The format of the GetWandViewWand method is:</p>
 358
 359 <pre class="code">
 360   MagickWand *GetWandViewWand(const WandView *wand_view)
 361 </pre>
 362
 363 <p>A description of each parameter follows:</p></ol>
 364
 365 <h5>wand_view</h5>
 366 <ol><p>the wand view.</p></ol>
 367
 368  </div>
 369 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 370 _8c.html" target="source" name="IsWandView">IsWandView</a></h2>
 371 <div class="doc-section">
 372
 373 <p>IsWandView() returns MagickTrue if the the parameter is verified as a wand view object.</p></ol>
 374
 375 <p>The format of the IsWandView method is:</p>
 376
 377 <pre class="code">
 378   MagickBooleanType IsWandView(const WandView *wand_view)
 379 </pre>
 380
 381 <p>A description of each parameter follows:</p></ol>
 382
 383 <h5>wand_view</h5>
 384 <ol><p>the wand view.</p></ol>
 385
 386  </div>
 387 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 388 _8c.html" target="source" name="NewWandView">NewWandView</a></h2>
 389 <div class="doc-section">
 390
 391 <p>NewWandView() returns a wand view required for all other methods in the Wand View API.</p></ol>
 392
 393 <p>The format of the NewWandView method is:</p>
 394
 395 <pre class="code">
 396   WandView *NewWandView(MagickWand *wand)
 397 </pre>
 398
 399 <p>A description of each parameter follows:</p></ol>
 400
 401 <h5>wand</h5>
 402 <ol><p>the wand.</p></ol>
 403
 404  </div>
 405 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 406 _8c.html" target="source" name="NewWandViewExtent">NewWandViewExtent</a></h2>
 407 <div class="doc-section">
 408
 409 <p>NewWandViewExtent() returns a wand view required for all other methods in the Wand View API.</p></ol>
 410
 411 <p>The format of the NewWandViewExtent method is:</p>
 412
 413 <pre class="code">
 414   WandView *NewWandViewExtent(MagickWand *wand,const ssize_t x,
 415     const ssize_t y,const size_t width,const size_t height)
 416 </pre>
 417
 418 <p>A description of each parameter follows:</p></ol>
 419
 420 <h5>wand</h5>
 421 <ol><p>the magick wand.</p></ol>
 422
 423 <h5>x,y,columns,rows</h5>
 424 <ol><p>These values define the perimeter of a extent of pixel_wands view.</p></ol>
 425
 426  </div>
 427 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 428 _8c.html" target="source" name="SetWandViewDescription">SetWandViewDescription</a></h2>
 429 <div class="doc-section">
 430
 431 <p>SetWandViewDescription() associates a description with an image view.</p></ol>
 432
 433 <p>The format of the SetWandViewDescription method is:</p>
 434
 435 <pre class="code">
 436   void SetWandViewDescription(WandView *image_view,const char *description)
 437 </pre>
 438
 439 <p>A description of each parameter follows:</p></ol>
 440
 441 <h5>wand_view</h5>
 442 <ol><p>the wand view.</p></ol>
 443
 444 <h5>description</h5>
 445 <ol><p>the wand view description.</p></ol>
 446
 447  </div>
 448 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 449 _8c.html" target="source" name="SetWandViewIterator">SetWandViewIterator</a></h2>
 450 <div class="doc-section">
 451
 452 <p>SetWandViewIterator() iterates over the wand view in parallel and calls your set method for each scanline of the view.  The pixel extent is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension.  The pixels are initiallly undefined and any settings you make in the callback method are automagically synced back to your image.</p></ol>
 453
 454 <p>The callback signature is:</p>
 455
 456 <pre class="text">
 457   MagickBooleanType SetImageViewMethod(ImageView *destination,
 458     const ssize_t y,const int thread_id,void *context)
 459 </pre>
 460
 461 <p>Use this pragma if the view is not single threaded:</p>
 462
 463 <pre class="text">
 464       #pragma omp critical
 465 </pre>
 466
 467 <p>to define a section of code in your callback set method that must be executed by a single thread at a time.</p></ol>
 468
 469 <p>The format of the SetWandViewIterator method is:</p>
 470
 471 <pre class="code">
 472   MagickBooleanType SetWandViewIterator(WandView *destination,
 473     SetWandViewMethod set,void *context)
 474 </pre>
 475
 476 <p>A description of each parameter follows:</p></ol>
 477
 478 <h5>destination</h5>
 479 <ol><p>the wand view.</p></ol>
 480
 481 <h5>set</h5>
 482 <ol><p>the set callback method.</p></ol>
 483
 484 <h5>context</h5>
 485 <ol><p>the user defined context.</p></ol>
 486
 487  </div>
 488 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 489 _8c.html" target="source" name="TransferWandViewIterator">TransferWandViewIterator</a></h2>
 490 <div class="doc-section">
 491
 492 <p>TransferWandViewIterator() iterates over two wand views in parallel and calls your transfer method for each scanline of the view.  The source pixel extent is not confined to the image canvas-- that is you can include negative offsets or widths or heights that exceed the image dimension. However, the destination wand view is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension are permitted.</p></ol>
 493
 494 <p>The callback signature is:</p>
 495
 496 <pre class="text">
 497   MagickBooleanType TransferImageViewMethod(const WandView *source,
 498     WandView *destination,const ssize_t y,const int thread_id,
 499     void *context)
 500 </pre>
 501
 502 <p>Use this pragma if the view is not single threaded:</p>
 503
 504 <pre class="text">
 505       #pragma omp critical
 506 </pre>
 507
 508 <p>to define a section of code in your callback transfer method that must be executed by a single thread at a time.</p></ol>
 509
 510 <p>The format of the TransferWandViewIterator method is:</p>
 511
 512 <pre class="code">
 513   MagickBooleanType TransferWandViewIterator(WandView *source,
 514     WandView *destination,TransferWandViewMethod transfer,void *context)
 515 </pre>
 516
 517 <p>A description of each parameter follows:</p></ol>
 518
 519 <h5>source</h5>
 520 <ol><p>the source wand view.</p></ol>
 521
 522 <h5>destination</h5>
 523 <ol><p>the destination wand view.</p></ol>
 524
 525 <h5>transfer</h5>
 526 <ol><p>the transfer callback method.</p></ol>
 527
 528 <h5>context</h5>
 529 <ol><p>the user defined context.</p></ol>
 530
 531  </div>
 532 <h2><a href="http://www.imagemagick.org/api/MagickWand/wand-view
 533 _8c.html" target="source" name="UpdateWandViewIterator">UpdateWandViewIterator</a></h2>
 534 <div class="doc-section">
 535
 536 <p>UpdateWandViewIterator() iterates over the wand view in parallel and calls your update method for each scanline of the view.  The pixel extent is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension are permitted.  Updates to pixels in your callback are automagically synced back to the image.</p></ol>
 537
 538 <p>The callback signature is:</p>
 539
 540 <pre class="text">
 541   MagickBooleanType UpdateImageViewMethod(WandView *source,const ssize_t y,
 542     const int thread_id,void *context)
 543 </pre>
 544
 545 <p>Use this pragma if the view is not single threaded:</p>
 546
 547 <pre class="text">
 548       #pragma omp critical
 549 </pre>
 550
 551 <p>to define a section of code in your callback update method that must be executed by a single thread at a time.</p></ol>
 552
 553 <p>The format of the UpdateWandViewIterator method is:</p>
 554
 555 <pre class="code">
 556   MagickBooleanType UpdateWandViewIterator(WandView *source,
 557     UpdateWandViewMethod update,void *context)
 558 </pre>
 559
 560 <p>A description of each parameter follows:</p></ol>
 561
 562 <h5>source</h5>
 563 <ol><p>the source wand view.</p></ol>
 564
 565 <h5>update</h5>
 566 <ol><p>the update callback method.</p></ol>
 567
 568 <h5>context</h5>
 569 <ol><p>the user defined context.</p></ol>
 570
 571  </div>
 572 \r
 573 </div>\r
 574 \r
 575 <div id="linkbar">\r
 576     <span id="linkbar-west">&nbsp;</span>\r
 577     <span id="linkbar-center">\r
 578       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 579       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 580     </span>\r
 581     <span id="linkbar-east">&nbsp;</span>\r
 582   </div>\r
 583   <div class="footer">\r
 584     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 585     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 586   </div>\r
 587   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 588   <script type="text/javascript">\r
 589     var _gaq = _gaq || [];\r
 590     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 591     _gaq.push(['_trackPageview']);\r
 592 \r
 593     (function() {\r
 594       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 595       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 596       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 597     })();\r
 598   </script>\r
 599 </body>\r
 600 </html>\r