granicus.if.org Git - imagemagick/blob - MagickWand/pixel-iterator.c

   1 /*
   2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   3 %                                                                             %
   4 %                                                                             %
   5 %                                                                             %
   6 %                      PPPP   IIIII  X   X  EEEEE  L                          %
   7 %                      P   P    I     X X   E      L                          %
   8 %                      PPPP     I      X    EEE    L                          %
   9 %                      P        I     X X   E      L                          %
  10 %                      P      IIIII  X   X  EEEEE  LLLLL                      %
  11 %                                                                             %
  12 %            IIIII  TTTTT EEEEE  RRRR    AAA   TTTTT   OOO   RRRR             %
  13 %              I      T   E      R   R  A   A    T    O   O  R   R            %
  14 %              I      T   EEE    RRRR   AAAAA    T    O   O  RRRR             %
  15 %              I      T   E      R R    A   A    T    O   O  R R              %
  16 %            IIIII    T   EEEEE  R  R   A   A    T     OOO   R  R             %
  17 %                                                                             %
  18 %                                                                             %
  19 %                   ImageMagick Image Pixel Iterator Methods                  %
  20 %                                                                             %
  21 %                              Software Design                                %
  22 %                                John Cristy                                  %
  23 %                                March 2003                                   %
  24 %                                                                             %
  25 %                                                                             %
  26 %  Copyright 1999-2011 ImageMagick Studio LLC, a non-profit organization      %
  27 %  dedicated to making software imaging solutions freely available.           %
  28 %                                                                             %
  29 %  You may not use this file except in compliance with the License.  You may  %
  30 %  obtain a copy of the License at                                            %
  31 %                                                                             %
  32 %    http://www.imagemagick.org/script/license.php                            %
  33 %                                                                             %
  34 %  Unless required by applicable law or agreed to in writing, software        %
  35 %  distributed under the License is distributed on an "AS IS" BASIS,          %
  36 %  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   %
  37 %  See the License for the specific language governing permissions and        %
  38 %  limitations under the License.                                             %
  39 %                                                                             %
  40 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  41 %
  42 %
  43 %
  44 */
  45 \f
  46 /*
  47   Include declarations.
  48 */
  49 #include "MagickWand/studio.h"
  50 #include "MagickWand/MagickWand.h"
  51 #include "MagickWand/magick-wand-private.h"
  52 #include "MagickWand/pixel-iterator.h"
  53 #include "MagickWand/pixel-wand.h"
  54 #include "MagickWand/wand.h"
  55 \f
  56 /*
  57   Define declarations.
  58 */
  59 #define PixelIteratorId  "PixelIterator"
  60 \f
  61 /*
  62   Typedef declarations.
  63 */
  64 struct _PixelIterator
  65 {
  66   size_t
  67     id;
  68
  69   char
  70     name[MaxTextExtent];
  71
  72   ExceptionInfo
  73     *exception;
  74
  75   Image
  76     *image;
  77
  78   CacheView
  79     *view;
  80
  81   RectangleInfo
  82     region;
  83
  84   MagickBooleanType
  85     active;           /* user has been given pixel data */
  86
  87   ssize_t
  88     y;
  89
  90   PixelWand
  91     **pixel_wands;
  92
  93   MagickBooleanType
  94     debug;
  95
  96   size_t
  97     signature;
  98 };
  99 \f
 100 /*
 101 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 102 %                                                                             %
 103 %                                                                             %
 104 %                                                                             %
 105 %   C l e a r P i x e l I t e r a t o r                                       %
 106 %                                                                             %
 107 %                                                                             %
 108 %                                                                             %
 109 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 110 %
 111 %  ClearPixelIterator() clear resources associated with a PixelIterator.
 112 %
 113 %  The format of the ClearPixelIterator method is:
 114 %
 115 %      PixelIterator *ClearPixelIterator(PixelIterator *iterator)
 116 %
 117 %  A description of each parameter follows:
 118 %
 119 %    o iterator: the pixel iterator.
 120 %
 121 */
 122 WandExport void ClearPixelIterator(PixelIterator *iterator)
 123 {
 124   assert(iterator != (const PixelIterator *) NULL);
 125   assert(iterator->signature == WandSignature);
 126   if (iterator->debug != MagickFalse)
 127     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 128   iterator->pixel_wands=DestroyPixelWands(iterator->pixel_wands,
 129     iterator->region.width);
 130   ClearMagickException(iterator->exception);
 131   iterator->pixel_wands=NewPixelWands(iterator->region.width);
 132   iterator->active=MagickFalse;
 133   iterator->y=0;
 134   iterator->debug=IsEventLogging();
 135 }
 136 \f
 137 /*
 138 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 139 %                                                                             %
 140 %                                                                             %
 141 %                                                                             %
 142 %   C l o n e P i x e l I t e r a t o r                                       %
 143 %                                                                             %
 144 %                                                                             %
 145 %                                                                             %
 146 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 147 %
 148 %  ClonePixelIterator() makes an exact copy of the specified iterator.
 149 %
 150 %  The format of the ClonePixelIterator method is:
 151 %
 152 %      PixelIterator *ClonePixelIterator(const PixelIterator *iterator)
 153 %
 154 %  A description of each parameter follows:
 155 %
 156 %    o iterator: the magick iterator.
 157 %
 158 */
 159 WandExport PixelIterator *ClonePixelIterator(const PixelIterator *iterator)
 160 {
 161   PixelIterator
 162     *clone_iterator;
 163
 164   assert(iterator != (PixelIterator *) NULL);
 165   assert(iterator->signature == WandSignature);
 166   if (iterator->debug != MagickFalse)
 167     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 168   clone_iterator=(PixelIterator *) AcquireMagickMemory(
 169     sizeof(*clone_iterator));
 170   if (clone_iterator == (PixelIterator *) NULL)
 171     ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
 172       iterator->name);
 173   (void) ResetMagickMemory(clone_iterator,0,sizeof(*clone_iterator));
 174   clone_iterator->id=AcquireWandId();
 175   (void) FormatLocaleString(clone_iterator->name,MaxTextExtent,"%s-%.20g",
 176     PixelIteratorId,(double) clone_iterator->id);
 177   clone_iterator->exception=AcquireExceptionInfo();
 178   InheritException(clone_iterator->exception,iterator->exception);
 179   clone_iterator->image=CloneImage(iterator->image,0,0,MagickTrue,
 180     iterator->exception);
 181   clone_iterator->view=CloneCacheView(iterator->view);
 182   clone_iterator->region=iterator->region;
 183   clone_iterator->active=iterator->active;
 184   clone_iterator->y=iterator->y;
 185   clone_iterator->pixel_wands=ClonePixelWands((const PixelWand **)
 186     iterator->pixel_wands,iterator->region.width);
 187   clone_iterator->debug=iterator->debug;
 188   if (clone_iterator->debug != MagickFalse)
 189     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",
 190       clone_iterator->name);
 191   clone_iterator->signature=WandSignature;
 192   return(clone_iterator);
 193 }
 194 \f
 195 /*
 196 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 197 %                                                                             %
 198 %                                                                             %
 199 %                                                                             %
 200 %   D e s t r o y P i x e l I t e r a t o r                                   %
 201 %                                                                             %
 202 %                                                                             %
 203 %                                                                             %
 204 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 205 %
 206 %  DestroyPixelIterator() deallocates resources associated with a PixelIterator.
 207 %
 208 %  The format of the DestroyPixelIterator method is:
 209 %
 210 %      PixelIterator *DestroyPixelIterator(PixelIterator *iterator)
 211 %
 212 %  A description of each parameter follows:
 213 %
 214 %    o iterator: the pixel iterator.
 215 %
 216 */
 217 WandExport PixelIterator *DestroyPixelIterator(PixelIterator *iterator)
 218 {
 219   assert(iterator != (const PixelIterator *) NULL);
 220   assert(iterator->signature == WandSignature);
 221   if (iterator->debug != MagickFalse)
 222     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 223   iterator->image=DestroyImage(iterator->image);
 224   iterator->view=DestroyCacheView(iterator->view);
 225   iterator->pixel_wands=DestroyPixelWands(iterator->pixel_wands,
 226     iterator->region.width);
 227   iterator->exception=DestroyExceptionInfo(iterator->exception);
 228   iterator->signature=(~WandSignature);
 229   RelinquishWandId(iterator->id);
 230   iterator=(PixelIterator *) RelinquishMagickMemory(iterator);
 231   return(iterator);
 232 }
 233 \f
 234 /*
 235 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 236 %                                                                             %
 237 %                                                                             %
 238 %                                                                             %
 239 %   I s P i x e l I t e r a t o r                                             %
 240 %                                                                             %
 241 %                                                                             %
 242 %                                                                             %
 243 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 244 %
 245 %  IsPixelIterator() returns MagickTrue if the iterator is verified as a pixel
 246 %  iterator.
 247 %
 248 %  The format of the IsPixelIterator method is:
 249 %
 250 %      MagickBooleanType IsPixelIterator(const PixelIterator *iterator)
 251 %
 252 %  A description of each parameter follows:
 253 %
 254 %    o iterator: the magick iterator.
 255 %
 256 */
 257 WandExport MagickBooleanType IsPixelIterator(const PixelIterator *iterator)
 258 {
 259   size_t
 260     length;
 261
 262   if (iterator == (const PixelIterator *) NULL)
 263     return(MagickFalse);
 264   if (iterator->signature != WandSignature)
 265     return(MagickFalse);
 266   length=strlen(PixelIteratorId);
 267   if (LocaleNCompare(iterator->name,PixelIteratorId,length) != 0)
 268     return(MagickFalse);
 269   return(MagickTrue);
 270 }
 271 \f
 272 /*
 273 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 274 %                                                                             %
 275 %                                                                             %
 276 %                                                                             %
 277 %   N e w P i x e l I t e r a t o r                                           %
 278 %                                                                             %
 279 %                                                                             %
 280 %                                                                             %
 281 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 282 %
 283 %  NewPixelIterator() returns a new pixel iterator.
 284 %
 285 %  The format of the NewPixelIterator method is:
 286 %
 287 %      PixelIterator *NewPixelIterator(MagickWand *wand)
 288 %
 289 %  A description of each parameter follows:
 290 %
 291 %    o wand: the magick wand.
 292 %
 293 */
 294 WandExport PixelIterator *NewPixelIterator(MagickWand *wand)
 295 {
 296   const char
 297     *quantum;
 298
 299   Image
 300     *image;
 301
 302   PixelIterator
 303     *iterator;
 304
 305   size_t
 306     depth;
 307
 308   CacheView
 309     *view;
 310
 311   depth=MAGICKCORE_QUANTUM_DEPTH;
 312   quantum=GetMagickQuantumDepth(&depth);
 313   if (depth != MAGICKCORE_QUANTUM_DEPTH)
 314     ThrowWandFatalException(WandError,"QuantumDepthMismatch",quantum);
 315   assert(wand != (MagickWand *) NULL);
 316   image=GetImageFromMagickWand(wand);
 317   if (image == (Image *) NULL)
 318     return((PixelIterator *) NULL);
 319   view=AcquireCacheView(image);
 320   if (view == (CacheView *) NULL)
 321     return((PixelIterator *) NULL);
 322   iterator=(PixelIterator *) AcquireMagickMemory(sizeof(*iterator));
 323   if (iterator == (PixelIterator *) NULL)
 324     ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
 325       GetExceptionMessage(errno));
 326   (void) ResetMagickMemory(iterator,0,sizeof(*iterator));
 327   iterator->id=AcquireWandId();
 328   (void) FormatLocaleString(iterator->name,MaxTextExtent,"%s-%.20g",
 329     PixelIteratorId,(double) iterator->id);
 330   iterator->exception=AcquireExceptionInfo();
 331   iterator->image=CloneImage(image,0,0,MagickTrue,iterator->exception);
 332   iterator->view=view;
 333   SetGeometry(image,&iterator->region);
 334   iterator->region.width=image->columns;
 335   iterator->region.height=image->rows;
 336   iterator->region.x=0;
 337   iterator->region.y=0;
 338   iterator->pixel_wands=NewPixelWands(iterator->region.width);
 339   iterator->y=0;
 340   iterator->debug=IsEventLogging();
 341   if (iterator->debug != MagickFalse)
 342     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 343   iterator->signature=WandSignature;
 344   return(iterator);
 345 }
 346 \f
 347 /*
 348 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 349 %                                                                             %
 350 %                                                                             %
 351 %                                                                             %
 352 %   P i x e l C l e a r I t e r a t o r E x c e p t i o n                     %
 353 %                                                                             %
 354 %                                                                             %
 355 %                                                                             %
 356 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 357 %
 358 %  PixelClearIteratorException() clear any exceptions associated with the
 359 %  iterator.
 360 %
 361 %  The format of the PixelClearIteratorException method is:
 362 %
 363 %      MagickBooleanType PixelClearIteratorException(PixelIterator *wand)
 364 %
 365 %  A description of each parameter follows:
 366 %
 367 %    o wand: the pixel wand.
 368 %
 369 */
 370 WandExport MagickBooleanType PixelClearIteratorException(
 371   PixelIterator *iterator)
 372 {
 373   assert(iterator != (PixelIterator *) NULL);
 374   assert(iterator->signature == WandSignature);
 375   if (iterator->debug != MagickFalse)
 376     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 377   ClearMagickException(iterator->exception);
 378   return(MagickTrue);
 379 }
 380 \f
 381 /*
 382 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 383 %                                                                             %
 384 %                                                                             %
 385 %                                                                             %
 386 %   N e w P i x e l R e g i o n I t e r a t o r                               %
 387 %                                                                             %
 388 %                                                                             %
 389 %                                                                             %
 390 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 391 %
 392 %  NewPixelRegionIterator() returns a new pixel iterator.
 393 %
 394 %  The format of the NewPixelRegionIterator method is:
 395 %
 396 %      PixelIterator NewPixelRegionIterator(MagickWand *wand,const ssize_t x,
 397 %        const ssize_t y,const size_t width,const size_t height)
 398 %
 399 %  A description of each parameter follows:
 400 %
 401 %    o wand: the magick wand.
 402 %
 403 %    o x,y,columns,rows:  These values define the perimeter of a region of
 404 %      pixels.
 405 %
 406 */
 407 WandExport PixelIterator *NewPixelRegionIterator(MagickWand *wand,
 408   const ssize_t x,const ssize_t y,const size_t width,const size_t height)
 409 {
 410   CacheView
 411     *view;
 412
 413   const char
 414     *quantum;
 415
 416   Image
 417     *image;
 418
 419   PixelIterator
 420     *iterator;
 421
 422   size_t
 423     depth;
 424
 425   assert(wand != (MagickWand *) NULL);
 426   depth=MAGICKCORE_QUANTUM_DEPTH;
 427   quantum=GetMagickQuantumDepth(&depth);
 428   if (depth != MAGICKCORE_QUANTUM_DEPTH)
 429     ThrowWandFatalException(WandError,"QuantumDepthMismatch",quantum);
 430   if ((width == 0) || (width == 0))
 431     ThrowWandFatalException(WandError,"ZeroRegionSize",quantum);
 432   image=GetImageFromMagickWand(wand);
 433   if (image == (Image *) NULL)
 434     return((PixelIterator *) NULL);
 435   view=AcquireCacheView(image);
 436   if (view == (CacheView *) NULL)
 437     return((PixelIterator *) NULL);
 438   iterator=(PixelIterator *) AcquireMagickMemory(sizeof(*iterator));
 439   if (iterator == (PixelIterator *) NULL)
 440     ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
 441       wand->name);
 442   (void) ResetMagickMemory(iterator,0,sizeof(*iterator));
 443   iterator->id=AcquireWandId();
 444   (void) FormatLocaleString(iterator->name,MaxTextExtent,"%s-%.20g",
 445     PixelIteratorId,(double) iterator->id);
 446   iterator->exception=AcquireExceptionInfo();
 447   iterator->view=view;
 448   SetGeometry(image,&iterator->region);
 449   iterator->region.width=width;
 450   iterator->region.height=height;
 451   iterator->region.x=x;
 452   iterator->region.y=y;
 453   iterator->pixel_wands=NewPixelWands(iterator->region.width);
 454   iterator->y=0;
 455   iterator->debug=IsEventLogging();
 456   if (iterator->debug != MagickFalse)
 457     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 458   iterator->signature=WandSignature;
 459   return(iterator);
 460 }
 461 \f
 462 /*
 463 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 464 %                                                                             %
 465 %                                                                             %
 466 %                                                                             %
 467 %   P i x e l G e t C u r r e n t I t e r a t o r R o w                       %
 468 %                                                                             %
 469 %                                                                             %
 470 %                                                                             %
 471 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 472 %
 473 %  PixelGetCurrentIteratorRow() returns the current row as an array of pixel
 474 %  wands from the pixel iterator.
 475 %
 476 %  The format of the PixelGetCurrentIteratorRow method is:
 477 %
 478 %      PixelWand **PixelGetCurrentIteratorRow(PixelIterator *iterator,
 479 %        size_t *number_wands)
 480 %
 481 %  A description of each parameter follows:
 482 %
 483 %    o iterator: the pixel iterator.
 484 %
 485 %    o number_wands: the number of pixel wands.
 486 %
 487 */
 488 WandExport PixelWand **PixelGetCurrentIteratorRow(PixelIterator *iterator,
 489   size_t *number_wands)
 490 {
 491   register const Quantum
 492     *pixels;
 493
 494   register ssize_t
 495     x;
 496
 497   assert(iterator != (PixelIterator *) NULL);
 498   assert(iterator->signature == WandSignature);
 499   if (iterator->debug != MagickFalse)
 500     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 501   *number_wands=0;
 502   iterator->active=MagickTrue;
 503   pixels=GetCacheViewVirtualPixels(iterator->view,iterator->region.x,
 504     iterator->region.y+iterator->y,iterator->region.width,1,
 505     iterator->exception);
 506   if (pixels == (const Quantum *) NULL)
 507     {
 508       InheritException(iterator->exception,GetCacheViewException(
 509         iterator->view));
 510       return((PixelWand **) NULL);
 511     }
 512   for (x=0; x < (ssize_t) iterator->region.width; x++)
 513   {
 514     PixelSetQuantumPixel(iterator->image,pixels,iterator->pixel_wands[x]);
 515     pixels+=GetPixelChannels(iterator->image);
 516   }
 517   *number_wands=iterator->region.width;
 518   return(iterator->pixel_wands);
 519 }
 520 \f
 521 /*
 522 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 523 %                                                                             %
 524 %                                                                             %
 525 %                                                                             %
 526 %   P i x e l G e t I t e r a t o r E x c e p t i o n                         %
 527 %                                                                             %
 528 %                                                                             %
 529 %                                                                             %
 530 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 531 %
 532 %  PixelGetIteratorException() returns the severity, reason, and description of
 533 %  any error that occurs when using other methods in this API.
 534 %
 535 %  The format of the PixelGetIteratorException method is:
 536 %
 537 %      char *PixelGetIteratorException(const Pixeliterator *iterator,
 538 %        ExceptionType *severity)
 539 %
 540 %  A description of each parameter follows:
 541 %
 542 %    o iterator: the pixel iterator.
 543 %
 544 %    o severity: the severity of the error is returned here.
 545 %
 546 */
 547 WandExport char *PixelGetIteratorException(const PixelIterator *iterator,
 548   ExceptionType *severity)
 549 {
 550   char
 551     *description;
 552
 553   assert(iterator != (const PixelIterator *) NULL);
 554   assert(iterator->signature == WandSignature);
 555   if (iterator->debug != MagickFalse)
 556     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 557   assert(severity != (ExceptionType *) NULL);
 558   *severity=iterator->exception->severity;
 559   description=(char *) AcquireQuantumMemory(2UL*MaxTextExtent,
 560     sizeof(*description));
 561   if (description == (char *) NULL)
 562     ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
 563       iterator->name);
 564   *description='\0';
 565   if (iterator->exception->reason != (char *) NULL)
 566     (void) CopyMagickString(description,GetLocaleExceptionMessage(
 567       iterator->exception->severity,iterator->exception->reason),MaxTextExtent);
 568   if (iterator->exception->description != (char *) NULL)
 569     {
 570       (void) ConcatenateMagickString(description," (",MaxTextExtent);
 571       (void) ConcatenateMagickString(description,GetLocaleExceptionMessage(
 572         iterator->exception->severity,iterator->exception->description),
 573         MaxTextExtent);
 574       (void) ConcatenateMagickString(description,")",MaxTextExtent);
 575     }
 576   return(description);
 577 }
 578 \f
 579 /*
 580 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 581 %                                                                             %
 582 %                                                                             %
 583 %                                                                             %
 584 %   P i x e l G e t E x c e p t i o n T y p e                                 %
 585 %                                                                             %
 586 %                                                                             %
 587 %                                                                             %
 588 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 589 %
 590 %  PixelGetIteratorExceptionType() the exception type associated with the wand.
 591 %  If no exception has occurred, UndefinedExceptionType is returned.
 592 %
 593 %  The format of the PixelGetIteratorExceptionType method is:
 594 %
 595 %      ExceptionType PixelGetIteratorExceptionType(const PixelWand *wand)
 596 %
 597 %  A description of each parameter follows:
 598 %
 599 %    o wand: the magick wand.
 600 %
 601 */
 602 WandExport ExceptionType PixelGetIteratorExceptionType(
 603   const PixelIterator *wand)
 604 {
 605   assert(wand != (const PixelIterator *) NULL);
 606   assert(wand->signature == WandSignature);
 607   if (wand->debug != MagickFalse)
 608     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
 609   return(wand->exception->severity);
 610 }
 611 \f
 612 /*
 613 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 614 %                                                                             %
 615 %                                                                             %
 616 %                                                                             %
 617 %   P i x e l G e t I t e r a t o r R o w                                     %
 618 %                                                                             %
 619 %                                                                             %
 620 %                                                                             %
 621 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 622 %
 623 %  PixelGetIteratorRow() returns the current pixel iterator row.
 624 %
 625 %  The format of the PixelGetIteratorRow method is:
 626 %
 627 %      MagickBooleanType PixelGetIteratorRow(PixelIterator *iterator)
 628 %
 629 %  A description of each parameter follows:
 630 %
 631 %    o iterator: the pixel iterator.
 632 %
 633 */
 634 WandExport ssize_t PixelGetIteratorRow(PixelIterator *iterator)
 635 {
 636   assert(iterator != (const PixelIterator *) NULL);
 637   assert(iterator->signature == WandSignature);
 638   if (iterator->debug != MagickFalse)
 639     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 640   return(iterator->y);
 641 }
 642 \f
 643 /*
 644 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 645 %                                                                             %
 646 %                                                                             %
 647 %                                                                             %
 648 %   P i x e l G e t N e x t I t e r a t o r R o w                             %
 649 %                                                                             %
 650 %                                                                             %
 651 %                                                                             %
 652 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 653 %
 654 %  PixelGetNextIteratorRow() returns the next row as an array of pixel wands
 655 %  from the pixel iterator.
 656 %
 657 %  The format of the PixelGetNextIteratorRow method is:
 658 %
 659 %      PixelWand **PixelGetNextIteratorRow(PixelIterator *iterator,
 660 %        size_t *number_wands)
 661 %
 662 %  A description of each parameter follows:
 663 %
 664 %    o iterator: the pixel iterator.
 665 %
 666 %    o number_wands: the number of pixel wands.
 667 %
 668 */
 669 WandExport PixelWand **PixelGetNextIteratorRow(PixelIterator *iterator,
 670   size_t *number_wands)
 671 {
 672   register const Quantum
 673     *pixels;
 674
 675   register ssize_t
 676     x;
 677
 678   assert(iterator != (PixelIterator *) NULL);
 679   assert(iterator->signature == WandSignature);
 680   if (iterator->debug != MagickFalse)
 681     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 682   *number_wands=0;
 683   if (iterator->active != MagickFalse)
 684     iterator->y++;
 685   if (PixelSetIteratorRow(iterator,iterator->y) == MagickFalse)
 686     return((PixelWand **) NULL);
 687   pixels=GetCacheViewVirtualPixels(iterator->view,iterator->region.x,
 688     iterator->region.y+iterator->y,iterator->region.width,1,
 689     iterator->exception);
 690   if (pixels == (const Quantum *) NULL)
 691     {
 692       InheritException(iterator->exception,GetCacheViewException(
 693         iterator->view));
 694       return((PixelWand **) NULL);
 695     }
 696   for (x=0; x < (ssize_t) iterator->region.width; x++)
 697   {
 698     PixelSetQuantumPixel(iterator->image,pixels,iterator->pixel_wands[x]);
 699     pixels+=GetPixelChannels(iterator->image);
 700   }
 701   *number_wands=iterator->region.width;
 702   return(iterator->pixel_wands);
 703 }
 704 \f
 705 /*
 706 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 707 %                                                                             %
 708 %                                                                             %
 709 %                                                                             %
 710 %   P i x e l G e t P r e v i o u s I t e r a t o r R o w                     %
 711 %                                                                             %
 712 %                                                                             %
 713 %                                                                             %
 714 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 715 %
 716 %  PixelGetPreviousIteratorRow() returns the previous row as an array of pixel
 717 %  wands from the pixel iterator.
 718 %
 719 %  The format of the PixelGetPreviousIteratorRow method is:
 720 %
 721 %      PixelWand **PixelGetPreviousIteratorRow(PixelIterator *iterator,
 722 %        size_t *number_wands)
 723 %
 724 %  A description of each parameter follows:
 725 %
 726 %    o iterator: the pixel iterator.
 727 %
 728 %    o number_wands: the number of pixel wands.
 729 %
 730 */
 731 WandExport PixelWand **PixelGetPreviousIteratorRow(PixelIterator *iterator,
 732   size_t *number_wands)
 733 {
 734   register const Quantum
 735     *pixels;
 736
 737   register ssize_t
 738     x;
 739
 740   assert(iterator != (PixelIterator *) NULL);
 741   assert(iterator->signature == WandSignature);
 742   if (iterator->debug != MagickFalse)
 743     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 744   *number_wands=0;
 745   if (iterator->active != MagickFalse)
 746     iterator->y--;
 747   if (PixelSetIteratorRow(iterator,iterator->y) == MagickFalse)
 748     return((PixelWand **) NULL);
 749   pixels=GetCacheViewVirtualPixels(iterator->view,iterator->region.x,
 750     iterator->region.y+iterator->y,iterator->region.width,1,
 751     iterator->exception);
 752   if (pixels == (const Quantum *) NULL)
 753     {
 754       InheritException(iterator->exception,GetCacheViewException(
 755         iterator->view));
 756       return((PixelWand **) NULL);
 757     }
 758   for (x=0; x < (ssize_t) iterator->region.width; x++)
 759   {
 760     PixelSetQuantumPixel(iterator->image,pixels,iterator->pixel_wands[x]);
 761     pixels+=GetPixelChannels(iterator->image);
 762   }
 763   *number_wands=iterator->region.width;
 764   return(iterator->pixel_wands);
 765 }
 766 \f
 767 /*
 768 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 769 %                                                                             %
 770 %                                                                             %
 771 %                                                                             %
 772 %   P i x e l R e s e t I t e r a t o r                                       %
 773 %                                                                             %
 774 %                                                                             %
 775 %                                                                             %
 776 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 777 %
 778 %  PixelResetIterator() resets the pixel iterator.  Use it in conjunction
 779 %  with PixelGetNextIteratorRow() to iterate over all the pixels in a pixel
 780 %  container.
 781 %
 782 %  The format of the PixelResetIterator method is:
 783 %
 784 %      void PixelResetIterator(PixelIterator *iterator)
 785 %
 786 %  A description of each parameter follows:
 787 %
 788 %    o iterator: the pixel iterator.
 789 %
 790 */
 791 WandExport void PixelResetIterator(PixelIterator *iterator)
 792 {
 793   assert(iterator != (PixelIterator *) NULL);
 794   assert(iterator->signature == WandSignature);
 795   if (iterator->debug != MagickFalse)
 796     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 797   iterator->active=MagickFalse;
 798   iterator->y=0;
 799 }
 800 \f
 801 /*
 802 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 803 %                                                                             %
 804 %                                                                             %
 805 %                                                                             %
 806 %   P i x e l S e t F i r s t I t e r a t o r R o w                           %
 807 %                                                                             %
 808 %                                                                             %
 809 %                                                                             %
 810 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 811 %
 812 %  PixelSetFirstIteratorRow() sets the pixel iterator to the first pixel row.
 813 %
 814 %  The format of the PixelSetFirstIteratorRow method is:
 815 %
 816 %      void PixelSetFirstIteratorRow(PixelIterator *iterator)
 817 %
 818 %  A description of each parameter follows:
 819 %
 820 %    o iterator: the magick iterator.
 821 %
 822 */
 823 WandExport void PixelSetFirstIteratorRow(PixelIterator *iterator)
 824 {
 825   assert(iterator != (PixelIterator *) NULL);
 826   assert(iterator->signature == WandSignature);
 827   if (iterator->debug != MagickFalse)
 828     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 829   iterator->active=MagickFalse;
 830   iterator->y=iterator->region.y;
 831 }
 832 \f
 833 /*
 834 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 835 %                                                                             %
 836 %                                                                             %
 837 %                                                                             %
 838 %   P i x e l S e t I t e r a t o r R o w                                     %
 839 %                                                                             %
 840 %                                                                             %
 841 %                                                                             %
 842 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 843 %
 844 %  PixelSetIteratorRow() set the pixel iterator row.
 845 %
 846 %  The format of the PixelSetIteratorRow method is:
 847 %
 848 %      MagickBooleanType PixelSetIteratorRow(PixelIterator *iterator,
 849 %        const ssize_t row)
 850 %
 851 %  A description of each parameter follows:
 852 %
 853 %    o iterator: the pixel iterator.
 854 %
 855 */
 856 WandExport MagickBooleanType PixelSetIteratorRow(PixelIterator *iterator,
 857   const ssize_t row)
 858 {
 859   assert(iterator != (const PixelIterator *) NULL);
 860   assert(iterator->signature == WandSignature);
 861   if (iterator->debug != MagickFalse)
 862     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 863   if ((row < 0) || (row >= (ssize_t) iterator->region.height))
 864     return(MagickFalse);
 865   iterator->active=MagickTrue;
 866   iterator->y=row;
 867   return(MagickTrue);
 868 }
 869 \f
 870 /*
 871 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 872 %                                                                             %
 873 %                                                                             %
 874 %                                                                             %
 875 %   P i x e l S e t L a s t I t e r a t o r R o w                             %
 876 %                                                                             %
 877 %                                                                             %
 878 %                                                                             %
 879 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 880 %
 881 %  PixelSetLastIteratorRow() sets the pixel iterator to the last pixel row.
 882 %
 883 %  The format of the PixelSetLastIteratorRow method is:
 884 %
 885 %      void PixelSetLastIteratorRow(PixelIterator *iterator)
 886 %
 887 %  A description of each parameter follows:
 888 %
 889 %    o iterator: the magick iterator.
 890 %
 891 */
 892 WandExport void PixelSetLastIteratorRow(PixelIterator *iterator)
 893 {
 894   assert(iterator != (PixelIterator *) NULL);
 895   assert(iterator->signature == WandSignature);
 896   if (iterator->debug != MagickFalse)
 897     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 898   iterator->active=MagickFalse;
 899   iterator->y=(ssize_t) iterator->region.height-1;
 900 }
 901 \f
 902 /*
 903 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 904 %                                                                             %
 905 %                                                                             %
 906 %                                                                             %
 907 %   P i x e l S y n c I t e r a t o r                                         %
 908 %                                                                             %
 909 %                                                                             %
 910 %                                                                             %
 911 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 912 %
 913 %  PixelSyncIterator() syncs the pixel iterator.
 914 %
 915 %  The format of the PixelSyncIterator method is:
 916 %
 917 %      MagickBooleanType PixelSyncIterator(PixelIterator *iterator)
 918 %
 919 %  A description of each parameter follows:
 920 %
 921 %    o iterator: the pixel iterator.
 922 %
 923 */
 924 WandExport MagickBooleanType PixelSyncIterator(PixelIterator *iterator)
 925 {
 926   ExceptionInfo
 927     *exception;
 928
 929   register ssize_t
 930     x;
 931
 932   register Quantum
 933     *restrict pixels;
 934
 935   assert(iterator != (const PixelIterator *) NULL);
 936   assert(iterator->signature == WandSignature);
 937   if (iterator->debug != MagickFalse)
 938     (void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
 939   if (SetCacheViewStorageClass(iterator->view,DirectClass) == MagickFalse)
 940     return(MagickFalse);
 941   exception=iterator->exception;
 942   pixels=GetCacheViewAuthenticPixels(iterator->view,iterator->region.x,
 943     iterator->region.y+iterator->y,iterator->region.width,1,exception);
 944   if (pixels == (Quantum *) NULL)
 945     {
 946       InheritException(iterator->exception,GetCacheViewException(
 947         iterator->view));
 948       return(MagickFalse);
 949     }
 950   for (x=0; x < (ssize_t) iterator->region.width; x++)
 951   {
 952     PixelGetQuantumPixel(iterator->image,iterator->pixel_wands[x],pixels);
 953     pixels+=GetPixelChannels(iterator->image);
 954   }
 955   if (SyncCacheViewAuthenticPixels(iterator->view,exception) == MagickFalse)
 956     {
 957       InheritException(iterator->exception,GetCacheViewException(
 958         iterator->view));
 959       return(MagickFalse);
 960     }
 961   return(MagickTrue);
 962 }