|
|
/* |
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
|
|
% % |
|
|
% % |
|
|
% % |
|
|
% 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-2016 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 % |
|
|
% % |
|
|
% http://www.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 *) AcquireMagickMemory(sizeof(*clone_iterator)); |
|
|
if (clone_iterator == (PixelIterator *) NULL) |
|
|
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed", |
|
|
iterator->name); |
|
|
(void) ResetMagickMemory(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 *) AcquireMagickMemory(sizeof(*iterator)); |
|
|
if (iterator == (PixelIterator *) NULL) |
|
|
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed", |
|
|
GetExceptionMessage(errno)); |
|
|
(void) ResetMagickMemory(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 *) AcquireMagickMemory(sizeof(*iterator)); |
|
|
if (iterator == (PixelIterator *) NULL) |
|
|
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed", |
|
|
wand->name); |
|
|
(void) ResetMagickMemory(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) |
|
|
{ |
|
|
register const Quantum |
|
|
*pixels; |
|
|
|
|
|
register 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) |
|
|
{ |
|
|
register const Quantum |
|
|
*pixels; |
|
|
|
|
|
register 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) |
|
|
{ |
|
|
register const Quantum |
|
|
*pixels; |
|
|
|
|
|
register 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; |
|
|
|
|
|
register ssize_t |
|
|
x; |
|
|
|
|
|
register Quantum |
|
|
*_magickcore_restrict pixels; |
|
|
|
|
|
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); |
|
|
}
|
|
|
|
