|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% PPPP IIIII X X EEEEE L %
|
|
|
% P P I X X E L %
|
|
|
% PPPP I X EEE L %
|
|
|
% P I X X E L %
|
|
|
% P IIIII X X EEEEE LLLLL %
|
|
|
% %
|
|
|
% IIIII TTTTT EEEEE RRRR AAA TTTTT OOO RRRR %
|
|
|
% I T E R R A A T O O R R %
|
|
|
% I T EEE RRRR AAAAA T O O RRRR %
|
|
|
% I T E R R A A T O O R R %
|
|
|
% IIIII T EEEEE R R A A T OOO R R %
|
|
|
% %
|
|
|
% %
|
|
|
% ImageMagick Image Pixel Iterator Methods %
|
|
|
% %
|
|
|
% Software Design %
|
|
|
% Cristy %
|
|
|
% March 2003 %
|
|
|
% %
|
|
|
% %
|
|
|
% Copyright 1999-2021 ImageMagick Studio LLC, a non-profit organization %
|
|
|
% dedicated to making software imaging solutions freely available. %
|
|
|
% %
|
|
|
% You may not use this file except in compliance with the License. You may %
|
|
|
% obtain a copy of the License at %
|
|
|
% %
|
|
|
% https://imagemagick.org/script/license.php %
|
|
|
% %
|
|
|
% Unless required by applicable law or agreed to in writing, software %
|
|
|
% distributed under the License is distributed on an "AS IS" BASIS, %
|
|
|
% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
|
|
|
% See the License for the specific language governing permissions and %
|
|
|
% limitations under the License. %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
%
|
|
|
%
|
|
|
*/
|
|
|
|
|
|
/*
|
|
|
Include declarations.
|
|
|
*/
|
|
|
#include "MagickWand/studio.h"
|
|
|
#include "MagickWand/MagickWand.h"
|
|
|
#include "MagickWand/magick-wand-private.h"
|
|
|
#include "MagickWand/pixel-iterator.h"
|
|
|
#include "MagickWand/pixel-wand.h"
|
|
|
#include "MagickWand/wand.h"
|
|
|
|
|
|
/*
|
|
|
Define declarations.
|
|
|
*/
|
|
|
#define PixelIteratorId "PixelIterator"
|
|
|
|
|
|
/*
|
|
|
Typedef declarations.
|
|
|
*/
|
|
|
struct _PixelIterator
|
|
|
{
|
|
|
size_t
|
|
|
id;
|
|
|
|
|
|
char
|
|
|
name[MagickPathExtent];
|
|
|
|
|
|
ExceptionInfo
|
|
|
*exception;
|
|
|
|
|
|
CacheView
|
|
|
*view;
|
|
|
|
|
|
RectangleInfo
|
|
|
region;
|
|
|
|
|
|
MagickBooleanType
|
|
|
active; /* user has been given pixel data */
|
|
|
|
|
|
ssize_t
|
|
|
y;
|
|
|
|
|
|
PixelWand
|
|
|
**pixel_wands;
|
|
|
|
|
|
MagickBooleanType
|
|
|
debug;
|
|
|
|
|
|
size_t
|
|
|
signature;
|
|
|
};
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% C l e a r P i x e l I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% ClearPixelIterator() clear resources associated with a PixelIterator.
|
|
|
%
|
|
|
% The format of the ClearPixelIterator method is:
|
|
|
%
|
|
|
% void ClearPixelIterator(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport void ClearPixelIterator(PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (const PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
iterator->pixel_wands=DestroyPixelWands(iterator->pixel_wands,
|
|
|
iterator->region.width);
|
|
|
ClearMagickException(iterator->exception);
|
|
|
iterator->pixel_wands=NewPixelWands(iterator->region.width);
|
|
|
iterator->active=MagickFalse;
|
|
|
iterator->y=0;
|
|
|
iterator->debug=IsEventLogging();
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% C l o n e P i x e l I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% ClonePixelIterator() makes an exact copy of the specified iterator.
|
|
|
%
|
|
|
% The format of the ClonePixelIterator method is:
|
|
|
%
|
|
|
% PixelIterator *ClonePixelIterator(const PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the magick iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelIterator *ClonePixelIterator(const PixelIterator *iterator)
|
|
|
{
|
|
|
PixelIterator
|
|
|
*clone_iterator;
|
|
|
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
clone_iterator=(PixelIterator *) AcquireCriticalMemory(
|
|
|
sizeof(*clone_iterator));
|
|
|
(void) memset(clone_iterator,0,sizeof(*clone_iterator));
|
|
|
clone_iterator->id=AcquireWandId();
|
|
|
(void) FormatLocaleString(clone_iterator->name,MagickPathExtent,"%s-%.20g",
|
|
|
PixelIteratorId,(double) clone_iterator->id);
|
|
|
clone_iterator->exception=AcquireExceptionInfo();
|
|
|
InheritException(clone_iterator->exception,iterator->exception);
|
|
|
clone_iterator->view=CloneCacheView(iterator->view);
|
|
|
clone_iterator->region=iterator->region;
|
|
|
clone_iterator->active=iterator->active;
|
|
|
clone_iterator->y=iterator->y;
|
|
|
clone_iterator->pixel_wands=ClonePixelWands((const PixelWand **)
|
|
|
iterator->pixel_wands,iterator->region.width);
|
|
|
clone_iterator->debug=iterator->debug;
|
|
|
if (clone_iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",
|
|
|
clone_iterator->name);
|
|
|
clone_iterator->signature=MagickWandSignature;
|
|
|
return(clone_iterator);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% D e s t r o y P i x e l I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% DestroyPixelIterator() deallocates resources associated with a PixelIterator.
|
|
|
%
|
|
|
% The format of the DestroyPixelIterator method is:
|
|
|
%
|
|
|
% PixelIterator *DestroyPixelIterator(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelIterator *DestroyPixelIterator(PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (const PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
iterator->view=DestroyCacheView(iterator->view);
|
|
|
iterator->pixel_wands=DestroyPixelWands(iterator->pixel_wands,
|
|
|
iterator->region.width);
|
|
|
iterator->exception=DestroyExceptionInfo(iterator->exception);
|
|
|
iterator->signature=(~MagickWandSignature);
|
|
|
RelinquishWandId(iterator->id);
|
|
|
iterator=(PixelIterator *) RelinquishMagickMemory(iterator);
|
|
|
return(iterator);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% I s P i x e l I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% IsPixelIterator() returns MagickTrue if the iterator is verified as a pixel
|
|
|
% iterator.
|
|
|
%
|
|
|
% The format of the IsPixelIterator method is:
|
|
|
%
|
|
|
% MagickBooleanType IsPixelIterator(const PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the magick iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType IsPixelIterator(const PixelIterator *iterator)
|
|
|
{
|
|
|
size_t
|
|
|
length;
|
|
|
|
|
|
if (iterator == (const PixelIterator *) NULL)
|
|
|
return(MagickFalse);
|
|
|
if (iterator->signature != MagickWandSignature)
|
|
|
return(MagickFalse);
|
|
|
length=strlen(PixelIteratorId);
|
|
|
if (LocaleNCompare(iterator->name,PixelIteratorId,length) != 0)
|
|
|
return(MagickFalse);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% N e w P i x e l I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% NewPixelIterator() returns a new pixel iterator.
|
|
|
%
|
|
|
% The format of the NewPixelIterator method is:
|
|
|
%
|
|
|
% PixelIterator *NewPixelIterator(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelIterator *NewPixelIterator(MagickWand *wand)
|
|
|
{
|
|
|
const char
|
|
|
*quantum;
|
|
|
|
|
|
ExceptionInfo
|
|
|
*exception;
|
|
|
|
|
|
Image
|
|
|
*image;
|
|
|
|
|
|
PixelIterator
|
|
|
*iterator;
|
|
|
|
|
|
size_t
|
|
|
depth;
|
|
|
|
|
|
CacheView
|
|
|
*view;
|
|
|
|
|
|
depth=MAGICKCORE_QUANTUM_DEPTH;
|
|
|
quantum=GetMagickQuantumDepth(&depth);
|
|
|
if (depth != MAGICKCORE_QUANTUM_DEPTH)
|
|
|
ThrowWandFatalException(WandError,"QuantumDepthMismatch",quantum);
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
image=GetImageFromMagickWand(wand);
|
|
|
if (image == (Image *) NULL)
|
|
|
return((PixelIterator *) NULL);
|
|
|
exception=AcquireExceptionInfo();
|
|
|
view=AcquireVirtualCacheView(image,exception);
|
|
|
if (view == (CacheView *) NULL)
|
|
|
return((PixelIterator *) NULL);
|
|
|
iterator=(PixelIterator *) AcquireCriticalMemory(sizeof(*iterator));
|
|
|
(void) memset(iterator,0,sizeof(*iterator));
|
|
|
iterator->id=AcquireWandId();
|
|
|
(void) FormatLocaleString(iterator->name,MagickPathExtent,"%s-%.20g",
|
|
|
PixelIteratorId,(double) iterator->id);
|
|
|
iterator->exception=exception;
|
|
|
iterator->view=view;
|
|
|
SetGeometry(image,&iterator->region);
|
|
|
iterator->region.width=image->columns;
|
|
|
iterator->region.height=image->rows;
|
|
|
iterator->region.x=0;
|
|
|
iterator->region.y=0;
|
|
|
iterator->pixel_wands=NewPixelWands(iterator->region.width);
|
|
|
iterator->y=0;
|
|
|
iterator->debug=IsEventLogging();
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
iterator->signature=MagickWandSignature;
|
|
|
return(iterator);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% 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 %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelClearIteratorException() clear any exceptions associated with the
|
|
|
% iterator.
|
|
|
%
|
|
|
% The format of the PixelClearIteratorException method is:
|
|
|
%
|
|
|
% MagickBooleanType PixelClearIteratorException(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType PixelClearIteratorException(
|
|
|
PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
ClearMagickException(iterator->exception);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% N e w P i x e l R e g i o n I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% NewPixelRegionIterator() returns a new pixel iterator.
|
|
|
%
|
|
|
% The format of the NewPixelRegionIterator method is:
|
|
|
%
|
|
|
% PixelIterator *NewPixelRegionIterator(MagickWand *wand,const ssize_t x,
|
|
|
% const ssize_t y,const size_t width,const size_t height)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o x,y,columns,rows: These values define the perimeter of a region of
|
|
|
% pixels.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelIterator *NewPixelRegionIterator(MagickWand *wand,
|
|
|
const ssize_t x,const ssize_t y,const size_t width,const size_t height)
|
|
|
{
|
|
|
CacheView
|
|
|
*view;
|
|
|
|
|
|
const char
|
|
|
*quantum;
|
|
|
|
|
|
ExceptionInfo
|
|
|
*exception;
|
|
|
|
|
|
Image
|
|
|
*image;
|
|
|
|
|
|
PixelIterator
|
|
|
*iterator;
|
|
|
|
|
|
size_t
|
|
|
depth;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
depth=MAGICKCORE_QUANTUM_DEPTH;
|
|
|
quantum=GetMagickQuantumDepth(&depth);
|
|
|
if (depth != MAGICKCORE_QUANTUM_DEPTH)
|
|
|
ThrowWandFatalException(WandError,"QuantumDepthMismatch",quantum);
|
|
|
if ((width == 0) || (height == 0))
|
|
|
ThrowWandFatalException(WandError,"ZeroRegionSize",quantum);
|
|
|
image=GetImageFromMagickWand(wand);
|
|
|
if (image == (Image *) NULL)
|
|
|
return((PixelIterator *) NULL);
|
|
|
exception=AcquireExceptionInfo();
|
|
|
view=AcquireVirtualCacheView(image,exception);
|
|
|
if (view == (CacheView *) NULL)
|
|
|
return((PixelIterator *) NULL);
|
|
|
iterator=(PixelIterator *) AcquireCriticalMemory(sizeof(*iterator));
|
|
|
(void) memset(iterator,0,sizeof(*iterator));
|
|
|
iterator->id=AcquireWandId();
|
|
|
(void) FormatLocaleString(iterator->name,MagickPathExtent,"%s-%.20g",
|
|
|
PixelIteratorId,(double) iterator->id);
|
|
|
iterator->exception=exception;
|
|
|
iterator->view=view;
|
|
|
SetGeometry(image,&iterator->region);
|
|
|
iterator->region.width=width;
|
|
|
iterator->region.height=height;
|
|
|
iterator->region.x=x;
|
|
|
iterator->region.y=y;
|
|
|
iterator->pixel_wands=NewPixelWands(iterator->region.width);
|
|
|
iterator->y=0;
|
|
|
iterator->debug=IsEventLogging();
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
iterator->signature=MagickWandSignature;
|
|
|
return(iterator);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% 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 %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelGetCurrentIteratorRow() returns the current row as an array of pixel
|
|
|
% wands from the pixel iterator.
|
|
|
%
|
|
|
% The format of the PixelGetCurrentIteratorRow method is:
|
|
|
%
|
|
|
% PixelWand **PixelGetCurrentIteratorRow(PixelIterator *iterator,
|
|
|
% size_t *number_wands)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
% o number_wands: the number of pixel wands.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelWand **PixelGetCurrentIteratorRow(PixelIterator *iterator,
|
|
|
size_t *number_wands)
|
|
|
{
|
|
|
const Quantum
|
|
|
*pixels;
|
|
|
|
|
|
ssize_t
|
|
|
x;
|
|
|
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
*number_wands=0;
|
|
|
iterator->active=MagickTrue;
|
|
|
pixels=GetCacheViewVirtualPixels(iterator->view,iterator->region.x,
|
|
|
iterator->region.y+iterator->y,iterator->region.width,1,
|
|
|
iterator->exception);
|
|
|
if (pixels == (const Quantum *) NULL)
|
|
|
return((PixelWand **) NULL);
|
|
|
for (x=0; x < (ssize_t) iterator->region.width; x++)
|
|
|
{
|
|
|
PixelSetQuantumPixel(GetCacheViewImage(iterator->view),pixels,
|
|
|
iterator->pixel_wands[x]);
|
|
|
pixels+=GetPixelChannels(GetCacheViewImage(iterator->view));
|
|
|
}
|
|
|
*number_wands=iterator->region.width;
|
|
|
return(iterator->pixel_wands);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% 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 %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelGetIteratorException() returns the severity, reason, and description of
|
|
|
% any error that occurs when using other methods in this API.
|
|
|
%
|
|
|
% The format of the PixelGetIteratorException method is:
|
|
|
%
|
|
|
% char *PixelGetIteratorException(const PixelIterator *iterator,
|
|
|
% ExceptionType *severity)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
% o severity: the severity of the error is returned here.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *PixelGetIteratorException(const PixelIterator *iterator,
|
|
|
ExceptionType *severity)
|
|
|
{
|
|
|
char
|
|
|
*description;
|
|
|
|
|
|
assert(iterator != (const PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
assert(severity != (ExceptionType *) NULL);
|
|
|
*severity=iterator->exception->severity;
|
|
|
description=(char *) AcquireQuantumMemory(2UL*MagickPathExtent,
|
|
|
sizeof(*description));
|
|
|
if (description == (char *) NULL)
|
|
|
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
|
|
|
iterator->name);
|
|
|
*description='\0';
|
|
|
if (iterator->exception->reason != (char *) NULL)
|
|
|
(void) CopyMagickString(description,GetLocaleExceptionMessage(
|
|
|
iterator->exception->severity,iterator->exception->reason),
|
|
|
MagickPathExtent);
|
|
|
if (iterator->exception->description != (char *) NULL)
|
|
|
{
|
|
|
(void) ConcatenateMagickString(description," (",MagickPathExtent);
|
|
|
(void) ConcatenateMagickString(description,GetLocaleExceptionMessage(
|
|
|
iterator->exception->severity,iterator->exception->description),
|
|
|
MagickPathExtent);
|
|
|
(void) ConcatenateMagickString(description,")",MagickPathExtent);
|
|
|
}
|
|
|
return(description);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l G e t E x c e p t i o n T y p e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelGetIteratorExceptionType() the exception type associated with the
|
|
|
% iterator. If no exception has occurred, UndefinedExceptionType is returned.
|
|
|
%
|
|
|
% The format of the PixelGetIteratorExceptionType method is:
|
|
|
%
|
|
|
% ExceptionType PixelGetIteratorExceptionType(
|
|
|
% const PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport ExceptionType PixelGetIteratorExceptionType(
|
|
|
const PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (const PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
return(iterator->exception->severity);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l G e t I t e r a t o r R o w %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelGetIteratorRow() returns the current pixel iterator row.
|
|
|
%
|
|
|
% The format of the PixelGetIteratorRow method is:
|
|
|
%
|
|
|
% MagickBooleanType PixelGetIteratorRow(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport ssize_t PixelGetIteratorRow(PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (const PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
return(iterator->y);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l G e t N e x t I t e r a t o r R o w %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelGetNextIteratorRow() returns the next row as an array of pixel wands
|
|
|
% from the pixel iterator.
|
|
|
%
|
|
|
% The format of the PixelGetNextIteratorRow method is:
|
|
|
%
|
|
|
% PixelWand **PixelGetNextIteratorRow(PixelIterator *iterator,
|
|
|
% size_t *number_wands)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
% o number_wands: the number of pixel wands.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelWand **PixelGetNextIteratorRow(PixelIterator *iterator,
|
|
|
size_t *number_wands)
|
|
|
{
|
|
|
const Quantum
|
|
|
*pixels;
|
|
|
|
|
|
ssize_t
|
|
|
x;
|
|
|
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
*number_wands=0;
|
|
|
if (iterator->active != MagickFalse)
|
|
|
iterator->y++;
|
|
|
if (PixelSetIteratorRow(iterator,iterator->y) == MagickFalse)
|
|
|
return((PixelWand **) NULL);
|
|
|
pixels=GetCacheViewVirtualPixels(iterator->view,iterator->region.x,
|
|
|
iterator->region.y+iterator->y,iterator->region.width,1,
|
|
|
iterator->exception);
|
|
|
if (pixels == (const Quantum *) NULL)
|
|
|
return((PixelWand **) NULL);
|
|
|
for (x=0; x < (ssize_t) iterator->region.width; x++)
|
|
|
{
|
|
|
PixelSetQuantumPixel(GetCacheViewImage(iterator->view),pixels,
|
|
|
iterator->pixel_wands[x]);
|
|
|
pixels+=GetPixelChannels(GetCacheViewImage(iterator->view));
|
|
|
}
|
|
|
*number_wands=iterator->region.width;
|
|
|
return(iterator->pixel_wands);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% 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 %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelGetPreviousIteratorRow() returns the previous row as an array of pixel
|
|
|
% wands from the pixel iterator.
|
|
|
%
|
|
|
% The format of the PixelGetPreviousIteratorRow method is:
|
|
|
%
|
|
|
% PixelWand **PixelGetPreviousIteratorRow(PixelIterator *iterator,
|
|
|
% size_t *number_wands)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
% o number_wands: the number of pixel wands.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelWand **PixelGetPreviousIteratorRow(PixelIterator *iterator,
|
|
|
size_t *number_wands)
|
|
|
{
|
|
|
const Quantum
|
|
|
*pixels;
|
|
|
|
|
|
ssize_t
|
|
|
x;
|
|
|
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
*number_wands=0;
|
|
|
if (iterator->active != MagickFalse)
|
|
|
iterator->y--;
|
|
|
if (PixelSetIteratorRow(iterator,iterator->y) == MagickFalse)
|
|
|
return((PixelWand **) NULL);
|
|
|
pixels=GetCacheViewVirtualPixels(iterator->view,iterator->region.x,
|
|
|
iterator->region.y+iterator->y,iterator->region.width,1,
|
|
|
iterator->exception);
|
|
|
if (pixels == (const Quantum *) NULL)
|
|
|
return((PixelWand **) NULL);
|
|
|
for (x=0; x < (ssize_t) iterator->region.width; x++)
|
|
|
{
|
|
|
PixelSetQuantumPixel(GetCacheViewImage(iterator->view),pixels,
|
|
|
iterator->pixel_wands[x]);
|
|
|
pixels+=GetPixelChannels(GetCacheViewImage(iterator->view));
|
|
|
}
|
|
|
*number_wands=iterator->region.width;
|
|
|
return(iterator->pixel_wands);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l R e s e t I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelResetIterator() resets the pixel iterator. Use it in conjunction
|
|
|
% with PixelGetNextIteratorRow() to iterate over all the pixels in a pixel
|
|
|
% container.
|
|
|
%
|
|
|
% The format of the PixelResetIterator method is:
|
|
|
%
|
|
|
% void PixelResetIterator(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport void PixelResetIterator(PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
iterator->active=MagickFalse;
|
|
|
iterator->y=0;
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l S e t F i r s t I t e r a t o r R o w %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelSetFirstIteratorRow() sets the pixel iterator to the first pixel row.
|
|
|
%
|
|
|
% The format of the PixelSetFirstIteratorRow method is:
|
|
|
%
|
|
|
% void PixelSetFirstIteratorRow(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the magick iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport void PixelSetFirstIteratorRow(PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
iterator->active=MagickFalse;
|
|
|
iterator->y=iterator->region.y;
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l S e t I t e r a t o r R o w %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelSetIteratorRow() set the pixel iterator row.
|
|
|
%
|
|
|
% The format of the PixelSetIteratorRow method is:
|
|
|
%
|
|
|
% MagickBooleanType PixelSetIteratorRow(PixelIterator *iterator,
|
|
|
% const ssize_t row)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType PixelSetIteratorRow(PixelIterator *iterator,
|
|
|
const ssize_t row)
|
|
|
{
|
|
|
assert(iterator != (const PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
if ((row < 0) || (row >= (ssize_t) iterator->region.height))
|
|
|
return(MagickFalse);
|
|
|
iterator->active=MagickTrue;
|
|
|
iterator->y=row;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l S e t L a s t I t e r a t o r R o w %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelSetLastIteratorRow() sets the pixel iterator to the last pixel row.
|
|
|
%
|
|
|
% The format of the PixelSetLastIteratorRow method is:
|
|
|
%
|
|
|
% void PixelSetLastIteratorRow(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the magick iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport void PixelSetLastIteratorRow(PixelIterator *iterator)
|
|
|
{
|
|
|
assert(iterator != (PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
iterator->active=MagickFalse;
|
|
|
iterator->y=(ssize_t) iterator->region.height-1;
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% P i x e l S y n c I t e r a t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% PixelSyncIterator() syncs the pixel iterator.
|
|
|
%
|
|
|
% The format of the PixelSyncIterator method is:
|
|
|
%
|
|
|
% MagickBooleanType PixelSyncIterator(PixelIterator *iterator)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o iterator: the pixel iterator.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType PixelSyncIterator(PixelIterator *iterator)
|
|
|
{
|
|
|
MagickBooleanType
|
|
|
status;
|
|
|
|
|
|
Quantum
|
|
|
*magick_restrict pixels;
|
|
|
|
|
|
ssize_t
|
|
|
x;
|
|
|
|
|
|
assert(iterator != (const PixelIterator *) NULL);
|
|
|
assert(iterator->signature == MagickWandSignature);
|
|
|
if (iterator->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",iterator->name);
|
|
|
status=SetCacheViewStorageClass(iterator->view,DirectClass,
|
|
|
iterator->exception);
|
|
|
if (status == MagickFalse)
|
|
|
return(MagickFalse);
|
|
|
pixels=GetCacheViewAuthenticPixels(iterator->view,iterator->region.x,
|
|
|
iterator->region.y+iterator->y,iterator->region.width,1,
|
|
|
iterator->exception);
|
|
|
if (pixels == (Quantum *) NULL)
|
|
|
return(MagickFalse);
|
|
|
for (x=0; x < (ssize_t) iterator->region.width; x++)
|
|
|
{
|
|
|
PixelGetQuantumPixel(GetCacheViewImage(iterator->view),
|
|
|
iterator->pixel_wands[x],pixels);
|
|
|
pixels+=GetPixelChannels(GetCacheViewImage(iterator->view));
|
|
|
}
|
|
|
if (SyncCacheViewAuthenticPixels(iterator->view,iterator->exception) == MagickFalse)
|
|
|
return(MagickFalse);
|
|
|
return(MagickTrue);
|
|
|
}
|
