|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M M AAA GGGG IIIII CCCC K K %
|
|
|
% MM MM A A G I C K K %
|
|
|
% M M M AAAAA G GGG I C KKK %
|
|
|
% M M A A G G I C K K %
|
|
|
% M M A A GGGG IIIII CCCC K K %
|
|
|
% %
|
|
|
% PPPP RRRR OOO PPPP EEEEE RRRR TTTTT Y Y %
|
|
|
% P P R R O O P P E R R T Y Y %
|
|
|
% PPPP RRRR O O PPPP EEE RRRR T Y %
|
|
|
% P R R O O P E R R T Y %
|
|
|
% P R R OOO P EEEEE R R T Y %
|
|
|
% %
|
|
|
% %
|
|
|
% Set or Get MagickWand Properties, Options, or Profiles %
|
|
|
% %
|
|
|
% Software Design %
|
|
|
% Cristy %
|
|
|
% August 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/wand.h"
|
|
|
#include "MagickCore/image-private.h"
|
|
|
#include "MagickCore/string-private.h"
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k D e l e t e I m a g e A r t i f a c t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickDeleteImageArtifact() deletes a wand artifact.
|
|
|
%
|
|
|
% The format of the MagickDeleteImageArtifact method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickDeleteImageArtifact(MagickWand *wand,
|
|
|
% const char *artifact)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o image: the image.
|
|
|
%
|
|
|
% o artifact: the image artifact.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickDeleteImageArtifact(MagickWand *wand,
|
|
|
const char *artifact)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return(MagickFalse);
|
|
|
}
|
|
|
return(DeleteImageArtifact(wand->images,artifact));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k D e l e t e I m a g e P r o p e r t y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickDeleteImageProperty() deletes a wand property.
|
|
|
%
|
|
|
% The format of the MagickDeleteImageProperty method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickDeleteImageProperty(MagickWand *wand,
|
|
|
% const char *property)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o image: the image.
|
|
|
%
|
|
|
% o property: the image property.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickDeleteImageProperty(MagickWand *wand,
|
|
|
const char *property)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return(MagickFalse);
|
|
|
}
|
|
|
return(DeleteImageProperty(wand->images,property));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k D e l e t e O p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickDeleteOption() deletes a wand option.
|
|
|
%
|
|
|
% The format of the MagickDeleteOption method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickDeleteOption(MagickWand *wand,
|
|
|
% const char *option)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o image: the image.
|
|
|
%
|
|
|
% o option: the image option.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickDeleteOption(MagickWand *wand,
|
|
|
const char *option)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(DeleteImageOption(wand->image_info,option));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t A n t i a l i a s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetAntialias() returns the antialias property associated with the
|
|
|
% wand.
|
|
|
%
|
|
|
% The format of the MagickGetAntialias method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickGetAntialias(const MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickGetAntialias(const MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (const MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->antialias);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t B a c k g r o u n d C o l o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetBackgroundColor() returns the wand background color.
|
|
|
%
|
|
|
% The format of the MagickGetBackgroundColor method is:
|
|
|
%
|
|
|
% PixelWand *MagickGetBackgroundColor(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelWand *MagickGetBackgroundColor(MagickWand *wand)
|
|
|
{
|
|
|
PixelWand
|
|
|
*background_color;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
background_color=NewPixelWand();
|
|
|
PixelSetPixelColor(background_color,&wand->image_info->background_color);
|
|
|
return(background_color);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t C o l o r s p a c e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetColorspace() gets the wand colorspace type.
|
|
|
%
|
|
|
% The format of the MagickGetColorspace method is:
|
|
|
%
|
|
|
% ColorspaceType MagickGetColorspace(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport ColorspaceType MagickGetColorspace(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->colorspace);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t C o m p r e s s i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetCompression() gets the wand compression type.
|
|
|
%
|
|
|
% The format of the MagickGetCompression method is:
|
|
|
%
|
|
|
% CompressionType MagickGetCompression(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport CompressionType MagickGetCompression(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->compression);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t C o m p r e s s i o n Q u a l i t y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetCompressionQuality() gets the wand compression quality.
|
|
|
%
|
|
|
% The format of the MagickGetCompressionQuality method is:
|
|
|
%
|
|
|
% size_t MagickGetCompressionQuality(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport size_t MagickGetCompressionQuality(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->quality);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t C o p y r i g h t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetCopyright() returns the ImageMagick API copyright as a string
|
|
|
% constant.
|
|
|
%
|
|
|
% The format of the MagickGetCopyright method is:
|
|
|
%
|
|
|
% const char *MagickGetCopyright(void)
|
|
|
%
|
|
|
*/
|
|
|
WandExport const char *MagickGetCopyright(void)
|
|
|
{
|
|
|
return(GetMagickCopyright());
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t F i l e n a m e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetFilename() returns the filename associated with an image sequence.
|
|
|
%
|
|
|
% The format of the MagickGetFilename method is:
|
|
|
%
|
|
|
% const char *MagickGetFilename(const MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *MagickGetFilename(const MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (const MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(AcquireString(wand->image_info->filename));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t F o n t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetFont() returns the font associated with the MagickWand.
|
|
|
%
|
|
|
% The format of the MagickGetFont method is:
|
|
|
%
|
|
|
% char *MagickGetFont(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *MagickGetFont(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->image_info->font == (char *) NULL)
|
|
|
return((char *) NULL);
|
|
|
return(AcquireString(wand->image_info->font));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t F o r m a t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetFormat() returns the format of the magick wand.
|
|
|
%
|
|
|
% The format of the MagickGetFormat method is:
|
|
|
%
|
|
|
% const char MagickGetFormat(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *MagickGetFormat(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(AcquireString(wand->image_info->magick));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t G r a v i t y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetGravity() gets the wand gravity.
|
|
|
%
|
|
|
% The format of the MagickGetGravity method is:
|
|
|
%
|
|
|
% GravityType MagickGetGravity(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport GravityType MagickGetGravity(MagickWand *wand)
|
|
|
{
|
|
|
const char
|
|
|
*option;
|
|
|
|
|
|
GravityType
|
|
|
type;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
option=GetImageOption(wand->image_info,"gravity");
|
|
|
if (option == (const char *) NULL)
|
|
|
return(UndefinedGravity);
|
|
|
type=(GravityType) ParseCommandOption(MagickGravityOptions,MagickFalse,
|
|
|
option);
|
|
|
return(type);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t H o m e U R L %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetHomeURL() returns the ImageMagick home URL.
|
|
|
%
|
|
|
% The format of the MagickGetHomeURL method is:
|
|
|
%
|
|
|
% char *MagickGetHomeURL(void)
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *MagickGetHomeURL(void)
|
|
|
{
|
|
|
return(GetMagickHomeURL());
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I m a g e A r t i f a c t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetImageArtifact() returns a value associated with the specified
|
|
|
% artifact. Use MagickRelinquishMemory() to free the value when you are
|
|
|
% finished with it.
|
|
|
%
|
|
|
% The format of the MagickGetImageArtifact method is:
|
|
|
%
|
|
|
% char *MagickGetImageArtifact(MagickWand *wand,const char *artifact)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o artifact: the artifact.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *MagickGetImageArtifact(MagickWand *wand,const char *artifact)
|
|
|
{
|
|
|
const char
|
|
|
*value;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((char *) NULL);
|
|
|
}
|
|
|
value=GetImageArtifact(wand->images,artifact);
|
|
|
if (value == (const char *) NULL)
|
|
|
return((char *) NULL);
|
|
|
return(ConstantString(value));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I m a g e P r o p e r t i e s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetImageArtifacts() returns all the artifact names that match the
|
|
|
% specified pattern associated with a wand. Use MagickGetImageProperty() to
|
|
|
% return the value of a particular artifact. Use MagickRelinquishMemory() to
|
|
|
% free the value when you are finished with it.
|
|
|
%
|
|
|
% The format of the MagickGetImageArtifacts method is:
|
|
|
%
|
|
|
% char *MagickGetImageArtifacts(MagickWand *wand,
|
|
|
% const char *pattern,size_t *number_artifacts)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o pattern: Specifies a pointer to a text string containing a pattern.
|
|
|
%
|
|
|
% o number_artifacts: the number artifacts associated with this wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char **MagickGetImageArtifacts(MagickWand *wand,
|
|
|
const char *pattern,size_t *number_artifacts)
|
|
|
{
|
|
|
char
|
|
|
**artifacts;
|
|
|
|
|
|
const char
|
|
|
*artifact;
|
|
|
|
|
|
ssize_t
|
|
|
i;
|
|
|
|
|
|
size_t
|
|
|
length;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
(void) GetImageProperty(wand->images,"exif:*",wand->exception);
|
|
|
length=1024;
|
|
|
artifacts=(char **) AcquireQuantumMemory(length,sizeof(*artifacts));
|
|
|
if (artifacts == (char **) NULL)
|
|
|
return((char **) NULL);
|
|
|
ResetImagePropertyIterator(wand->images);
|
|
|
artifact=GetNextImageProperty(wand->images);
|
|
|
for (i=0; artifact != (const char *) NULL; )
|
|
|
{
|
|
|
if ((*artifact != '[') &&
|
|
|
(GlobExpression(artifact,pattern,MagickFalse) != MagickFalse))
|
|
|
{
|
|
|
if ((i+1) >= (ssize_t) length)
|
|
|
{
|
|
|
length<<=1;
|
|
|
artifacts=(char **) ResizeQuantumMemory(artifacts,length,
|
|
|
sizeof(*artifacts));
|
|
|
if (artifacts == (char **) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),
|
|
|
ResourceLimitError,"MemoryAllocationFailed","`%s'",
|
|
|
wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
}
|
|
|
artifacts[i]=ConstantString(artifact);
|
|
|
i++;
|
|
|
}
|
|
|
artifact=GetNextImageProperty(wand->images);
|
|
|
}
|
|
|
artifacts[i]=(char *) NULL;
|
|
|
*number_artifacts=(size_t) i;
|
|
|
return(artifacts);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I m a g e P r o f i l e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetImageProfile() returns the named image profile.
|
|
|
%
|
|
|
% The format of the MagickGetImageProfile method is:
|
|
|
%
|
|
|
% unsigned char *MagickGetImageProfile(MagickWand *wand,const char *name,
|
|
|
% size_t *length)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o name: Name of profile to return: ICC, IPTC, or generic profile.
|
|
|
%
|
|
|
% o length: the length of the profile.
|
|
|
%
|
|
|
*/
|
|
|
WandExport unsigned char *MagickGetImageProfile(MagickWand *wand,
|
|
|
const char *name,size_t *length)
|
|
|
{
|
|
|
const StringInfo
|
|
|
*profile;
|
|
|
|
|
|
unsigned char
|
|
|
*datum;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((unsigned char *) NULL);
|
|
|
}
|
|
|
*length=0;
|
|
|
if (wand->images->profiles == (SplayTreeInfo *) NULL)
|
|
|
return((unsigned char *) NULL);
|
|
|
profile=GetImageProfile(wand->images,name);
|
|
|
if (profile == (StringInfo *) NULL)
|
|
|
return((unsigned char *) NULL);
|
|
|
datum=(unsigned char *) AcquireQuantumMemory(GetStringInfoLength(profile),
|
|
|
sizeof(*datum));
|
|
|
if (datum == (unsigned char *) NULL)
|
|
|
return((unsigned char *) NULL);
|
|
|
(void) memcpy(datum,GetStringInfoDatum(profile),GetStringInfoLength(profile));
|
|
|
*length=(size_t) GetStringInfoLength(profile);
|
|
|
return(datum);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I m a g e P r o f i l e s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetImageProfiles() returns all the profile names that match the
|
|
|
% specified pattern associated with a wand. Use MagickGetImageProfile() to
|
|
|
% return the value of a particular property. Use MagickRelinquishMemory() to
|
|
|
% free the value when you are finished with it.
|
|
|
%
|
|
|
% The format of the MagickGetImageProfiles method is:
|
|
|
%
|
|
|
% char *MagickGetImageProfiles(MagickWand *wand,const char *pattern,
|
|
|
% size_t *number_profiles)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o pattern: Specifies a pointer to a text string containing a pattern.
|
|
|
%
|
|
|
% o number_profiles: the number profiles associated with this wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char **MagickGetImageProfiles(MagickWand *wand,const char *pattern,
|
|
|
size_t *number_profiles)
|
|
|
{
|
|
|
char
|
|
|
**profiles;
|
|
|
|
|
|
const char
|
|
|
*property;
|
|
|
|
|
|
ssize_t
|
|
|
i;
|
|
|
|
|
|
size_t
|
|
|
length;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
(void) GetImageProfile(wand->images,"exif:*");
|
|
|
length=1024;
|
|
|
profiles=(char **) AcquireQuantumMemory(length,sizeof(*profiles));
|
|
|
if (profiles == (char **) NULL)
|
|
|
return((char **) NULL);
|
|
|
ResetImageProfileIterator(wand->images);
|
|
|
property=GetNextImageProfile(wand->images);
|
|
|
for (i=0; property != (const char *) NULL; )
|
|
|
{
|
|
|
if ((*property != '[') &&
|
|
|
(GlobExpression(property,pattern,MagickFalse) != MagickFalse))
|
|
|
{
|
|
|
if ((i+1) >= (ssize_t) length)
|
|
|
{
|
|
|
length<<=1;
|
|
|
profiles=(char **) ResizeQuantumMemory(profiles,length,
|
|
|
sizeof(*profiles));
|
|
|
if (profiles == (char **) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),
|
|
|
ResourceLimitError,"MemoryAllocationFailed","`%s'",
|
|
|
wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
}
|
|
|
profiles[i]=ConstantString(property);
|
|
|
i++;
|
|
|
}
|
|
|
property=GetNextImageProfile(wand->images);
|
|
|
}
|
|
|
profiles[i]=(char *) NULL;
|
|
|
*number_profiles=(size_t) i;
|
|
|
return(profiles);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I m a g e P r o p e r t y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetImageProperty() returns a value associated with the specified
|
|
|
% property. Use MagickRelinquishMemory() to free the value when you are
|
|
|
% finished with it.
|
|
|
%
|
|
|
% The format of the MagickGetImageProperty method is:
|
|
|
%
|
|
|
% char *MagickGetImageProperty(MagickWand *wand,const char *property)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o property: the property.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *MagickGetImageProperty(MagickWand *wand,const char *property)
|
|
|
{
|
|
|
const char
|
|
|
*value;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((char *) NULL);
|
|
|
}
|
|
|
value=GetImageProperty(wand->images,property,wand->exception);
|
|
|
if (value == (const char *) NULL)
|
|
|
return((char *) NULL);
|
|
|
return(ConstantString(value));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I m a g e P r o p e r t i e s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetImageProperties() returns all the property names that match the
|
|
|
% specified pattern associated with a wand. Use MagickGetImageProperty() to
|
|
|
% return the value of a particular property. Use MagickRelinquishMemory() to
|
|
|
% free the value when you are finished with it.
|
|
|
%
|
|
|
% The format of the MagickGetImageProperties method is:
|
|
|
%
|
|
|
% char *MagickGetImageProperties(MagickWand *wand,
|
|
|
% const char *pattern,size_t *number_properties)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o pattern: Specifies a pointer to a text string containing a pattern.
|
|
|
%
|
|
|
% o number_properties: the number properties associated with this wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char **MagickGetImageProperties(MagickWand *wand,
|
|
|
const char *pattern,size_t *number_properties)
|
|
|
{
|
|
|
char
|
|
|
**properties;
|
|
|
|
|
|
const char
|
|
|
*property;
|
|
|
|
|
|
ssize_t
|
|
|
i;
|
|
|
|
|
|
size_t
|
|
|
length;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
(void) GetImageProperty(wand->images,"exif:*",wand->exception);
|
|
|
length=1024;
|
|
|
properties=(char **) AcquireQuantumMemory(length,sizeof(*properties));
|
|
|
if (properties == (char **) NULL)
|
|
|
return((char **) NULL);
|
|
|
ResetImagePropertyIterator(wand->images);
|
|
|
property=GetNextImageProperty(wand->images);
|
|
|
for (i=0; property != (const char *) NULL; )
|
|
|
{
|
|
|
if ((*property != '[') &&
|
|
|
(GlobExpression(property,pattern,MagickFalse) != MagickFalse))
|
|
|
{
|
|
|
if ((i+1) >= (ssize_t) length)
|
|
|
{
|
|
|
length<<=1;
|
|
|
properties=(char **) ResizeQuantumMemory(properties,length,
|
|
|
sizeof(*properties));
|
|
|
if (properties == (char **) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),
|
|
|
ResourceLimitError,"MemoryAllocationFailed","`%s'",
|
|
|
wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
}
|
|
|
properties[i]=ConstantString(property);
|
|
|
i++;
|
|
|
}
|
|
|
property=GetNextImageProperty(wand->images);
|
|
|
}
|
|
|
properties[i]=(char *) NULL;
|
|
|
*number_properties=(size_t) i;
|
|
|
return(properties);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I n t e r l a c e S c h e m e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetInterlaceScheme() gets the wand interlace scheme.
|
|
|
%
|
|
|
% The format of the MagickGetInterlaceScheme method is:
|
|
|
%
|
|
|
% InterlaceType MagickGetInterlaceScheme(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport InterlaceType MagickGetInterlaceScheme(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->interlace);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t I n t e r p o l a t e M e t h o d %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetInterpolateMethod() gets the wand compression.
|
|
|
%
|
|
|
% The format of the MagickGetInterpolateMethod method is:
|
|
|
%
|
|
|
% PixelInterpolateMethod MagickGetInterpolateMethod(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport PixelInterpolateMethod MagickGetInterpolateMethod(MagickWand *wand)
|
|
|
{
|
|
|
const char
|
|
|
*option;
|
|
|
|
|
|
PixelInterpolateMethod
|
|
|
method;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
option=GetImageOption(wand->image_info,"interpolate");
|
|
|
if (option == (const char *) NULL)
|
|
|
return(UndefinedInterpolatePixel);
|
|
|
method=(PixelInterpolateMethod) ParseCommandOption(MagickInterpolateOptions,
|
|
|
MagickFalse,option);
|
|
|
return(method);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t O p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetOption() returns a value associated with a wand and the specified
|
|
|
% key. Use MagickRelinquishMemory() to free the value when you are finished
|
|
|
% with it.
|
|
|
%
|
|
|
% The format of the MagickGetOption method is:
|
|
|
%
|
|
|
% char *MagickGetOption(MagickWand *wand,const char *key)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o key: the key.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char *MagickGetOption(MagickWand *wand,const char *key)
|
|
|
{
|
|
|
const char
|
|
|
*option;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
option=GetImageOption(wand->image_info,key);
|
|
|
return(ConstantString(option));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t O p t i o n s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetOptions() returns all the option names that match the specified
|
|
|
% pattern associated with a wand. Use MagickGetOption() to return the value
|
|
|
% of a particular option. Use MagickRelinquishMemory() to free the value
|
|
|
% when you are finished with it.
|
|
|
%
|
|
|
% The format of the MagickGetOptions method is:
|
|
|
%
|
|
|
% char *MagickGetOptions(MagickWand *wand,const char *pattern,
|
|
|
% size_t *number_options)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o pattern: Specifies a pointer to a text string containing a pattern.
|
|
|
%
|
|
|
% o number_options: the number options associated with this wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport char **MagickGetOptions(MagickWand *wand,const char *pattern,
|
|
|
size_t *number_options)
|
|
|
{
|
|
|
char
|
|
|
**options;
|
|
|
|
|
|
const char
|
|
|
*option;
|
|
|
|
|
|
ssize_t
|
|
|
i;
|
|
|
|
|
|
size_t
|
|
|
length;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
length=1024;
|
|
|
options=(char **) AcquireQuantumMemory(length,sizeof(*options));
|
|
|
if (options == (char **) NULL)
|
|
|
return((char **) NULL);
|
|
|
ResetImageOptionIterator(wand->image_info);
|
|
|
option=GetNextImageOption(wand->image_info);
|
|
|
for (i=0; option != (const char *) NULL; )
|
|
|
{
|
|
|
if ((*option != '[') &&
|
|
|
(GlobExpression(option,pattern,MagickFalse) != MagickFalse))
|
|
|
{
|
|
|
if ((i+1) >= (ssize_t) length)
|
|
|
{
|
|
|
length<<=1;
|
|
|
options=(char **) ResizeQuantumMemory(options,length,
|
|
|
sizeof(*options));
|
|
|
if (options == (char **) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),
|
|
|
ResourceLimitError,"MemoryAllocationFailed","`%s'",
|
|
|
wand->name);
|
|
|
return((char **) NULL);
|
|
|
}
|
|
|
}
|
|
|
options[i]=ConstantString(option);
|
|
|
i++;
|
|
|
}
|
|
|
option=GetNextImageOption(wand->image_info);
|
|
|
}
|
|
|
options[i]=(char *) NULL;
|
|
|
*number_options=(size_t) i;
|
|
|
return(options);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t O r i e n t a t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetOrientation() gets the wand orientation type.
|
|
|
%
|
|
|
% The format of the MagickGetOrientation method is:
|
|
|
%
|
|
|
% OrientationType MagickGetOrientation(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport OrientationType MagickGetOrientation(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->orientation);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t P a c k a g e N a m e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetPackageName() returns the ImageMagick package name as a string
|
|
|
% constant.
|
|
|
%
|
|
|
% The format of the MagickGetPackageName method is:
|
|
|
%
|
|
|
% const char *MagickGetPackageName(void)
|
|
|
%
|
|
|
%
|
|
|
*/
|
|
|
WandExport const char *MagickGetPackageName(void)
|
|
|
{
|
|
|
return(GetMagickPackageName());
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t P a g e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetPage() returns the page geometry associated with the magick wand.
|
|
|
%
|
|
|
% The format of the MagickGetPage method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickGetPage(const MagickWand *wand,
|
|
|
% size_t *width,size_t *height,ssize_t *x,ssize_t *y)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o width: the page width.
|
|
|
%
|
|
|
% o height: page height.
|
|
|
%
|
|
|
% o x: the page x-offset.
|
|
|
%
|
|
|
% o y: the page y-offset.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickGetPage(const MagickWand *wand,
|
|
|
size_t *width,size_t *height,ssize_t *x,ssize_t *y)
|
|
|
{
|
|
|
RectangleInfo
|
|
|
geometry;
|
|
|
|
|
|
assert(wand != (const MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) memset(&geometry,0,sizeof(geometry));
|
|
|
(void) ParseAbsoluteGeometry(wand->image_info->page,&geometry);
|
|
|
*width=geometry.width;
|
|
|
*height=geometry.height;
|
|
|
*x=geometry.x;
|
|
|
*y=geometry.y;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t P o i n t s i z e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetPointsize() returns the font pointsize associated with the
|
|
|
% MagickWand.
|
|
|
%
|
|
|
% The format of the MagickGetPointsize method is:
|
|
|
%
|
|
|
% double MagickGetPointsize(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport double MagickGetPointsize(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->pointsize);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t Q u a n t u m D e p t h %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetQuantumDepth() returns the ImageMagick quantum depth as a string
|
|
|
% constant.
|
|
|
%
|
|
|
% The format of the MagickGetQuantumDepth method is:
|
|
|
%
|
|
|
% const char *MagickGetQuantumDepth(size_t *depth)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o depth: the quantum depth is returned as a number.
|
|
|
%
|
|
|
*/
|
|
|
WandExport const char *MagickGetQuantumDepth(size_t *depth)
|
|
|
{
|
|
|
return(GetMagickQuantumDepth(depth));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t Q u a n t u m R a n g e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetQuantumRange() returns the ImageMagick quantum range as a string
|
|
|
% constant.
|
|
|
%
|
|
|
% The format of the MagickGetQuantumRange method is:
|
|
|
%
|
|
|
% const char *MagickGetQuantumRange(size_t *range)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o range: the quantum range is returned as a number.
|
|
|
%
|
|
|
*/
|
|
|
WandExport const char *MagickGetQuantumRange(size_t *range)
|
|
|
{
|
|
|
return(GetMagickQuantumRange(range));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t R e l e a s e D a t e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetReleaseDate() returns the ImageMagick release date as a string
|
|
|
% constant.
|
|
|
%
|
|
|
% The format of the MagickGetReleaseDate method is:
|
|
|
%
|
|
|
% const char *MagickGetReleaseDate(void)
|
|
|
%
|
|
|
*/
|
|
|
WandExport const char *MagickGetReleaseDate(void)
|
|
|
{
|
|
|
return(GetMagickReleaseDate());
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t R e s o l u t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetResolution() gets the image X and Y resolution.
|
|
|
%
|
|
|
% The format of the MagickGetResolution method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickGetResolution(const MagickWand *wand,double *x,
|
|
|
% double *y)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o x: the x-resolution.
|
|
|
%
|
|
|
% o y: the y-resolution.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickGetResolution(const MagickWand *wand,
|
|
|
double *x,double *y)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
*x=DefaultResolution;
|
|
|
*y=DefaultResolution;
|
|
|
if (wand->image_info->density != (char *) NULL)
|
|
|
{
|
|
|
GeometryInfo
|
|
|
geometry_info;
|
|
|
|
|
|
MagickStatusType
|
|
|
flags;
|
|
|
|
|
|
flags=ParseGeometry(wand->image_info->density,&geometry_info);
|
|
|
*x=geometry_info.rho;
|
|
|
*y=geometry_info.sigma;
|
|
|
if ((flags & SigmaValue) == 0)
|
|
|
*y=(*x);
|
|
|
}
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t R e s o u r c e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetResource() returns the specified resource in megabytes.
|
|
|
%
|
|
|
% The format of the MagickGetResource method is:
|
|
|
%
|
|
|
% MagickSizeType MagickGetResource(const ResourceType type)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickSizeType MagickGetResource(const ResourceType type)
|
|
|
{
|
|
|
return(GetMagickResource(type));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t R e s o u r c e L i m i t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetResourceLimit() returns the specified resource limit in megabytes.
|
|
|
%
|
|
|
% The format of the MagickGetResourceLimit method is:
|
|
|
%
|
|
|
% MagickSizeType MagickGetResourceLimit(const ResourceType type)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickSizeType MagickGetResourceLimit(const ResourceType type)
|
|
|
{
|
|
|
return(GetMagickResourceLimit(type));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t S a m p l i n g F a c t o r s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetSamplingFactors() gets the horizontal and vertical sampling factor.
|
|
|
%
|
|
|
% The format of the MagickGetSamplingFactors method is:
|
|
|
%
|
|
|
% double *MagickGetSamplingFactor(MagickWand *wand,
|
|
|
% size_t *number_factors)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o number_factors: the number of factors in the returned array.
|
|
|
%
|
|
|
*/
|
|
|
WandExport double *MagickGetSamplingFactors(MagickWand *wand,
|
|
|
size_t *number_factors)
|
|
|
{
|
|
|
double
|
|
|
*sampling_factors;
|
|
|
|
|
|
const char
|
|
|
*p;
|
|
|
|
|
|
ssize_t
|
|
|
i;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
*number_factors=0;
|
|
|
sampling_factors=(double *) NULL;
|
|
|
if (wand->image_info->sampling_factor == (char *) NULL)
|
|
|
return(sampling_factors);
|
|
|
i=0;
|
|
|
for (p=wand->image_info->sampling_factor; p != (char *) NULL; p=strchr(p,','))
|
|
|
{
|
|
|
while (((int) *p != 0) && ((isspace((int) ((unsigned char) *p)) != 0) ||
|
|
|
(*p == ',')))
|
|
|
p++;
|
|
|
i++;
|
|
|
}
|
|
|
sampling_factors=(double *) AcquireQuantumMemory((size_t) i+1,
|
|
|
sizeof(*sampling_factors));
|
|
|
if (sampling_factors == (double *) NULL)
|
|
|
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
|
|
|
wand->image_info->filename);
|
|
|
i=0;
|
|
|
for (p=wand->image_info->sampling_factor; p != (char *) NULL; p=strchr(p,','))
|
|
|
{
|
|
|
while (((int) *p != 0) && ((isspace((int) ((unsigned char) *p)) != 0) ||
|
|
|
(*p == ',')))
|
|
|
p++;
|
|
|
sampling_factors[i]=StringToDouble(p,(char **) NULL);
|
|
|
i++;
|
|
|
}
|
|
|
*number_factors=(size_t) i;
|
|
|
return(sampling_factors);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t S i z e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetSize() returns the size associated with the magick wand.
|
|
|
%
|
|
|
% The format of the MagickGetSize method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickGetSize(const MagickWand *wand,
|
|
|
% size_t *columns,size_t *rows)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o columns: the width in pixels.
|
|
|
%
|
|
|
% o height: the height in pixels.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickGetSize(const MagickWand *wand,
|
|
|
size_t *columns,size_t *rows)
|
|
|
{
|
|
|
RectangleInfo
|
|
|
geometry;
|
|
|
|
|
|
assert(wand != (const MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) memset(&geometry,0,sizeof(geometry));
|
|
|
(void) ParseAbsoluteGeometry(wand->image_info->size,&geometry);
|
|
|
*columns=geometry.width;
|
|
|
*rows=geometry.height;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t S i z e O f f s e t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetSizeOffset() returns the size offset associated with the magick
|
|
|
% wand.
|
|
|
%
|
|
|
% The format of the MagickGetSizeOffset method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickGetSizeOffset(const MagickWand *wand,
|
|
|
% ssize_t *offset)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o offset: the image offset.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickGetSizeOffset(const MagickWand *wand,
|
|
|
ssize_t *offset)
|
|
|
{
|
|
|
RectangleInfo
|
|
|
geometry;
|
|
|
|
|
|
assert(wand != (const MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) memset(&geometry,0,sizeof(geometry));
|
|
|
(void) ParseAbsoluteGeometry(wand->image_info->size,&geometry);
|
|
|
*offset=geometry.x;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t T y p e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetType() returns the wand type.
|
|
|
%
|
|
|
% The format of the MagickGetType method is:
|
|
|
%
|
|
|
% ImageType MagickGetType(MagickWand *wand)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport ImageType MagickGetType(MagickWand *wand)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(wand->image_info->type);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k G e t V e r s i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickGetVersion() returns the ImageMagick API version as a string constant
|
|
|
% and as a number.
|
|
|
%
|
|
|
% The format of the MagickGetVersion method is:
|
|
|
%
|
|
|
% const char *MagickGetVersion(size_t *version)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o version: the ImageMagick version is returned as a number.
|
|
|
%
|
|
|
*/
|
|
|
WandExport const char *MagickGetVersion(size_t *version)
|
|
|
{
|
|
|
return(GetMagickVersion(version));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k P r o f i l e I m a g e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickProfileImage() adds or removes a ICC, IPTC, or generic profile
|
|
|
% from an image. If the profile is NULL, it is removed from the image
|
|
|
% otherwise added. Use a name of '*' and a profile of NULL to remove all
|
|
|
% profiles from the image.
|
|
|
%
|
|
|
% The format of the MagickProfileImage method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickProfileImage(MagickWand *wand,const char *name,
|
|
|
% const void *profile,const size_t length)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o name: Name of profile to add or remove: ICC, IPTC, or generic profile.
|
|
|
%
|
|
|
% o profile: the profile.
|
|
|
%
|
|
|
% o length: the length of the profile.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickProfileImage(MagickWand *wand,
|
|
|
const char *name,const void *profile,const size_t length)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
ThrowWandException(WandError,"ContainsNoImages",wand->name);
|
|
|
return(ProfileImage(wand->images,name,profile,length,wand->exception));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k R e m o v e I m a g e P r o f i l e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickRemoveImageProfile() removes the named image profile and returns it.
|
|
|
%
|
|
|
% The format of the MagickRemoveImageProfile method is:
|
|
|
%
|
|
|
% unsigned char *MagickRemoveImageProfile(MagickWand *wand,
|
|
|
% const char *name,size_t *length)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o name: Name of profile to return: ICC, IPTC, or generic profile.
|
|
|
%
|
|
|
% o length: the length of the profile.
|
|
|
%
|
|
|
*/
|
|
|
WandExport unsigned char *MagickRemoveImageProfile(MagickWand *wand,
|
|
|
const char *name,size_t *length)
|
|
|
{
|
|
|
StringInfo
|
|
|
*profile;
|
|
|
|
|
|
unsigned char
|
|
|
*datum;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
{
|
|
|
(void) ThrowMagickException(wand->exception,GetMagickModule(),WandError,
|
|
|
"ContainsNoImages","`%s'",wand->name);
|
|
|
return((unsigned char *) NULL);
|
|
|
}
|
|
|
*length=0;
|
|
|
profile=RemoveImageProfile(wand->images,name);
|
|
|
if (profile == (StringInfo *) NULL)
|
|
|
return((unsigned char *) NULL);
|
|
|
datum=(unsigned char *) AcquireQuantumMemory(GetStringInfoLength(profile),
|
|
|
sizeof(*datum));
|
|
|
if (datum == (unsigned char *) NULL)
|
|
|
return((unsigned char *) NULL);
|
|
|
(void) memcpy(datum,GetStringInfoDatum(profile),
|
|
|
GetStringInfoLength(profile));
|
|
|
*length=GetStringInfoLength(profile);
|
|
|
profile=DestroyStringInfo(profile);
|
|
|
return(datum);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t A n t i a l i a s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetAntialias() sets the antialias propery of the wand.
|
|
|
%
|
|
|
% The format of the MagickSetAntialias method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetAntialias(MagickWand *wand,
|
|
|
% const MagickBooleanType antialias)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o antialias: the antialias property.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetAntialias(MagickWand *wand,
|
|
|
const MagickBooleanType antialias)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->antialias=antialias;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t B a c k g r o u n d C o l o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetBackgroundColor() sets the wand background color.
|
|
|
%
|
|
|
% The format of the MagickSetBackgroundColor method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetBackgroundColor(MagickWand *wand,
|
|
|
% const PixelWand *background)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o background: the background pixel wand.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetBackgroundColor(MagickWand *wand,
|
|
|
const PixelWand *background)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
PixelGetQuantumPacket(background,&wand->image_info->background_color);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t C o l o r s p a c e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetColorspace() sets the wand colorspace type.
|
|
|
%
|
|
|
% The format of the MagickSetColorspace method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetColorspace(MagickWand *wand,
|
|
|
% const ColorspaceType colorspace)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o colorspace: the wand colorspace.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetColorspace(MagickWand *wand,
|
|
|
const ColorspaceType colorspace)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->colorspace=colorspace;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t C o m p r e s s i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetCompression() sets the wand compression type.
|
|
|
%
|
|
|
% The format of the MagickSetCompression method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetCompression(MagickWand *wand,
|
|
|
% const CompressionType compression)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o compression: the wand compression.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetCompression(MagickWand *wand,
|
|
|
const CompressionType compression)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->compression=compression;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t C o m p r e s s i o n Q u a l i t y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetCompressionQuality() sets the wand compression quality.
|
|
|
%
|
|
|
% The format of the MagickSetCompressionQuality method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetCompressionQuality(MagickWand *wand,
|
|
|
% const size_t quality)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o quality: the wand compression quality.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetCompressionQuality(MagickWand *wand,
|
|
|
const size_t quality)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->quality=quality;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t D e p t h %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetDepth() sets the wand pixel depth.
|
|
|
%
|
|
|
% The format of the MagickSetDepth method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetDepth(MagickWand *wand,
|
|
|
% const size_t depth)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o depth: the wand pixel depth.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetDepth(MagickWand *wand,const size_t depth)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->depth=depth;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t E x t r a c t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetExtract() sets the extract geometry before you read or write an
|
|
|
% image file. Use it for inline cropping (e.g. 200x200+0+0) or resizing
|
|
|
% (e.g.200x200).
|
|
|
%
|
|
|
% The format of the MagickSetExtract method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetExtract(MagickWand *wand,
|
|
|
% const char *geometry)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o geometry: the extract geometry.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetExtract(MagickWand *wand,
|
|
|
const char *geometry)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->image_info->extract != (char *) NULL)
|
|
|
wand->image_info->extract=DestroyString(wand->image_info->extract);
|
|
|
if (geometry != (const char *) NULL)
|
|
|
(void) CloneString(&wand->image_info->extract,geometry);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t F i l e n a m e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetFilename() sets the filename before you read or write an image file.
|
|
|
%
|
|
|
% The format of the MagickSetFilename method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetFilename(MagickWand *wand,
|
|
|
% const char *filename)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o filename: the image filename.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetFilename(MagickWand *wand,
|
|
|
const char *filename)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (filename != (const char *) NULL)
|
|
|
(void) CopyMagickString(wand->image_info->filename,filename,
|
|
|
MagickPathExtent);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t F o n t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetFont() sets the font associated with the MagickWand.
|
|
|
%
|
|
|
% The format of the MagickSetFont method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetFont(MagickWand *wand, const char *font)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o font: the font
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetFont(MagickWand *wand,const char *font)
|
|
|
{
|
|
|
if ((font == (const char *) NULL) || (*font == '\0'))
|
|
|
return(MagickFalse);
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) CloneString(&wand->image_info->font,font);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t F o r m a t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetFormat() sets the format of the magick wand.
|
|
|
%
|
|
|
% The format of the MagickSetFormat method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetFormat(MagickWand *wand,const char *format)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o format: the image format.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetFormat(MagickWand *wand,
|
|
|
const char *format)
|
|
|
{
|
|
|
const MagickInfo
|
|
|
*magick_info;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
|
|
|
if ((format == (char *) NULL) || (*format == '\0'))
|
|
|
{
|
|
|
*wand->image_info->magick='\0';
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
magick_info=GetMagickInfo(format,wand->exception);
|
|
|
if (magick_info == (const MagickInfo *) NULL)
|
|
|
return(MagickFalse);
|
|
|
ClearMagickException(wand->exception);
|
|
|
(void) CopyMagickString(wand->image_info->magick,format,MagickPathExtent);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t G r a v i t y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetGravity() sets the gravity type.
|
|
|
%
|
|
|
% The format of the MagickSetGravity type is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetGravity(MagickWand *wand,
|
|
|
% const GravityType type)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o type: the gravity type.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetGravity(MagickWand *wand,
|
|
|
const GravityType type)
|
|
|
{
|
|
|
MagickBooleanType
|
|
|
status;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
status=SetImageOption(wand->image_info,"gravity",CommandOptionToMnemonic(
|
|
|
MagickGravityOptions,(ssize_t) type));
|
|
|
return(status);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t I m a g e A r t i f a c t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetImageArtifact() sets a key-value pair in the image artifact
|
|
|
% namespace. Artifacts differ from properties. Properties are public and are
|
|
|
% generally exported to an external image format if the format supports it.
|
|
|
% Artifacts are private and are utilized by the internal ImageMagick API to
|
|
|
% modify the behavior of certain algorithms.
|
|
|
%
|
|
|
% The format of the MagickSetImageArtifact method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetImageArtifact(MagickWand *wand,
|
|
|
% const char *artifact,const char *value)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o artifact: the artifact.
|
|
|
%
|
|
|
% o value: the value.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetImageArtifact(MagickWand *wand,
|
|
|
const char *artifact,const char *value)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
ThrowWandException(WandError,"ContainsNoImages",wand->name);
|
|
|
return(SetImageArtifact(wand->images,artifact,value));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t P r o f i l e I m a g e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetImageProfile() adds a named profile to the magick wand. If a
|
|
|
% profile with the same name already exists, it is replaced. This method
|
|
|
% differs from the MagickProfileImage() method in that it does not apply any
|
|
|
% CMS color profiles.
|
|
|
%
|
|
|
% The format of the MagickSetImageProfile method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetImageProfile(MagickWand *wand,
|
|
|
% const char *name,const void *profile,const size_t length)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o name: Name of profile to add or remove: ICC, IPTC, or generic profile.
|
|
|
%
|
|
|
% o profile: the profile.
|
|
|
%
|
|
|
% o length: the length of the profile.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetImageProfile(MagickWand *wand,
|
|
|
const char *name,const void *profile,const size_t length)
|
|
|
{
|
|
|
MagickBooleanType
|
|
|
status;
|
|
|
|
|
|
StringInfo
|
|
|
*profile_info;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
ThrowWandException(WandError,"ContainsNoImages",wand->name);
|
|
|
profile_info=AcquireStringInfo((size_t) length);
|
|
|
SetStringInfoDatum(profile_info,(unsigned char *) profile);
|
|
|
status=SetImageProfile(wand->images,name,profile_info,wand->exception);
|
|
|
profile_info=DestroyStringInfo(profile_info);
|
|
|
return(status);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t I m a g e P r o p e r t y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetImageProperty() associates a property with an image.
|
|
|
%
|
|
|
% The format of the MagickSetImageProperty method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetImageProperty(MagickWand *wand,
|
|
|
% const char *property,const char *value)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o property: the property.
|
|
|
%
|
|
|
% o value: the value.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetImageProperty(MagickWand *wand,
|
|
|
const char *property,const char *value)
|
|
|
{
|
|
|
MagickBooleanType
|
|
|
status;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->images == (Image *) NULL)
|
|
|
ThrowWandException(WandError,"ContainsNoImages",wand->name);
|
|
|
status=SetImageProperty(wand->images,property,value,wand->exception);
|
|
|
return(status);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t I n t e r l a c e S c h e m e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetInterlaceScheme() sets the image compression.
|
|
|
%
|
|
|
% The format of the MagickSetInterlaceScheme method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetInterlaceScheme(MagickWand *wand,
|
|
|
% const InterlaceType interlace_scheme)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o interlace_scheme: the image interlace scheme: NoInterlace, LineInterlace,
|
|
|
% PlaneInterlace, PartitionInterlace.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetInterlaceScheme(MagickWand *wand,
|
|
|
const InterlaceType interlace_scheme)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->interlace=interlace_scheme;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t I n t e r p o l a t e M e t h o d %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetInterpolateMethod() sets the interpolate pixel method.
|
|
|
%
|
|
|
% The format of the MagickSetInterpolateMethod method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetInterpolateMethod(MagickWand *wand,
|
|
|
% const InterpolateMethodPixel method)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o method: the interpolate pixel method.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetInterpolateMethod(MagickWand *wand,
|
|
|
const PixelInterpolateMethod method)
|
|
|
{
|
|
|
MagickBooleanType
|
|
|
status;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
status=SetImageOption(wand->image_info,"interpolate",
|
|
|
CommandOptionToMnemonic(MagickInterpolateOptions,(ssize_t) method));
|
|
|
return(status);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t O p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetOption() associates one or options with the wand (.e.g
|
|
|
% MagickSetOption(wand,"jpeg:perserve","yes")).
|
|
|
%
|
|
|
% The format of the MagickSetOption method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetOption(MagickWand *wand,const char *key,
|
|
|
% const char *value)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o key: The key.
|
|
|
%
|
|
|
% o value: The value.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetOption(MagickWand *wand,const char *key,
|
|
|
const char *value)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(SetImageOption(wand->image_info,key,value));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t O r i e n t a t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetOrientation() sets the wand orientation type.
|
|
|
%
|
|
|
% The format of the MagickSetOrientation method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetOrientation(MagickWand *wand,
|
|
|
% const OrientationType orientation)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o orientation: the wand orientation.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetOrientation(MagickWand *wand,
|
|
|
const OrientationType orientation)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->orientation=orientation;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t P a g e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetPage() sets the page geometry of the magick wand.
|
|
|
%
|
|
|
% The format of the MagickSetPage method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetPage(MagickWand *wand,
|
|
|
% const size_t width,const size_t height,const ssize_t x,
|
|
|
% const ssize_t y)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o width: the page width.
|
|
|
%
|
|
|
% o height: the page height.
|
|
|
%
|
|
|
% o x: the page x-offset.
|
|
|
%
|
|
|
% o y: the page y-offset.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetPage(MagickWand *wand,
|
|
|
const size_t width,const size_t height,const ssize_t x,
|
|
|
const ssize_t y)
|
|
|
{
|
|
|
char
|
|
|
geometry[MagickPathExtent];
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) FormatLocaleString(geometry,MagickPathExtent,"%.20gx%.20g%+.20g%+.20g",
|
|
|
(double) width,(double) height,(double) x,(double) y);
|
|
|
(void) CloneString(&wand->image_info->page,geometry);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t P a s s p h r a s e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetPassphrase() sets the passphrase.
|
|
|
%
|
|
|
% The format of the MagickSetPassphrase method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetPassphrase(MagickWand *wand,
|
|
|
% const char *passphrase)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o passphrase: the passphrase.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetPassphrase(MagickWand *wand,
|
|
|
const char *passphrase)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) SetImageOption(wand->image_info,"authenticate",passphrase);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t P o i n t s i z e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetPointsize() sets the font pointsize associated with the MagickWand.
|
|
|
%
|
|
|
% The format of the MagickSetPointsize method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetPointsize(MagickWand *wand,
|
|
|
% const double pointsize)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o pointsize: the size of the font
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetPointsize(MagickWand *wand,
|
|
|
const double pointsize)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->pointsize=pointsize;
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t P r o g r e s s M o n i t o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetProgressMonitor() sets the wand progress monitor to the specified
|
|
|
% method and returns the previous progress monitor if any. The progress
|
|
|
% monitor method looks like this:
|
|
|
%
|
|
|
% MagickBooleanType MagickProgressMonitor(const char *text,
|
|
|
% const MagickOffsetType offset,const MagickSizeType span,
|
|
|
% void *client_data)
|
|
|
%
|
|
|
% If the progress monitor returns MagickFalse, the current operation is
|
|
|
% interrupted.
|
|
|
%
|
|
|
% The format of the MagickSetProgressMonitor method is:
|
|
|
%
|
|
|
% MagickProgressMonitor MagickSetProgressMonitor(MagickWand *wand
|
|
|
% const MagickProgressMonitor progress_monitor,void *client_data)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o progress_monitor: Specifies a pointer to a method to monitor progress
|
|
|
% of an image operation.
|
|
|
%
|
|
|
% o client_data: Specifies a pointer to any client data.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickProgressMonitor MagickSetProgressMonitor(MagickWand *wand,
|
|
|
const MagickProgressMonitor progress_monitor,void *client_data)
|
|
|
{
|
|
|
MagickProgressMonitor
|
|
|
previous_monitor;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
previous_monitor=SetImageInfoProgressMonitor(wand->image_info,
|
|
|
progress_monitor,client_data);
|
|
|
return(previous_monitor);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t R e s o u r c e L i m i t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetResourceLimit() sets the limit for a particular resource in
|
|
|
% megabytes.
|
|
|
%
|
|
|
% The format of the MagickSetResourceLimit method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetResourceLimit(const ResourceType type,
|
|
|
% const MagickSizeType limit)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o type: the type of resource: AreaResource, MemoryResource, MapResource,
|
|
|
% DiskResource, FileResource.
|
|
|
%
|
|
|
% o The maximum limit for the resource.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetResourceLimit(const ResourceType type,
|
|
|
const MagickSizeType limit)
|
|
|
{
|
|
|
return(SetMagickResourceLimit(type,limit));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t R e s o l u t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetResolution() sets the image resolution.
|
|
|
%
|
|
|
% The format of the MagickSetResolution method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetResolution(MagickWand *wand,
|
|
|
% const double x_resolution,const double y_resolution)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o x_resolution: the image x resolution.
|
|
|
%
|
|
|
% o y_resolution: the image y resolution.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetResolution(MagickWand *wand,
|
|
|
const double x_resolution,const double y_resolution)
|
|
|
{
|
|
|
char
|
|
|
density[MagickPathExtent];
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) FormatLocaleString(density,MagickPathExtent,"%gx%g",x_resolution,
|
|
|
y_resolution);
|
|
|
(void) CloneString(&wand->image_info->density,density);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t S a m p l i n g F a c t o r s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetSamplingFactors() sets the image sampling factors.
|
|
|
%
|
|
|
% The format of the MagickSetSamplingFactors method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetSamplingFactors(MagickWand *wand,
|
|
|
% const size_t number_factors,const double *sampling_factors)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o number_factoes: the number of factors.
|
|
|
%
|
|
|
% o sampling_factors: An array of doubles representing the sampling factor
|
|
|
% for each color component (in RGB order).
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetSamplingFactors(MagickWand *wand,
|
|
|
const size_t number_factors,const double *sampling_factors)
|
|
|
{
|
|
|
char
|
|
|
sampling_factor[MagickPathExtent];
|
|
|
|
|
|
ssize_t
|
|
|
i;
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
if (wand->image_info->sampling_factor != (char *) NULL)
|
|
|
wand->image_info->sampling_factor=(char *)
|
|
|
RelinquishMagickMemory(wand->image_info->sampling_factor);
|
|
|
if (number_factors == 0)
|
|
|
return(MagickTrue);
|
|
|
for (i=0; i < (ssize_t) (number_factors-1); i++)
|
|
|
{
|
|
|
(void) FormatLocaleString(sampling_factor,MagickPathExtent,"%g,",
|
|
|
sampling_factors[i]);
|
|
|
(void) ConcatenateString(&wand->image_info->sampling_factor,
|
|
|
sampling_factor);
|
|
|
}
|
|
|
(void) FormatLocaleString(sampling_factor,MagickPathExtent,"%g",
|
|
|
sampling_factors[i]);
|
|
|
(void) ConcatenateString(&wand->image_info->sampling_factor,sampling_factor);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t S e e d %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetSeed() sets the pseudo-random number generator seed. Use it to
|
|
|
% generate a pedictable sequence of random numbers.
|
|
|
%
|
|
|
% The format of the MagickSetSeed method is:
|
|
|
%
|
|
|
% void MagickSetSeed(const unsigned long seed)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o seed: the seed.
|
|
|
%
|
|
|
*/
|
|
|
WandExport void MagickSetSeed(const unsigned long seed)
|
|
|
{
|
|
|
SetRandomSecretKey(seed);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t S e c u r i t y P o l i c y %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetSecurityPolicy() sets the ImageMagick security policy. It returns
|
|
|
% MagickFalse if the policy is already set or if the policy does not parse.
|
|
|
%
|
|
|
% The format of the MagickSetAntialias method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetAntialias(MagickWand *wand,
|
|
|
% const char *policy)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o policy: the security policy in the XML format.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetSecurityPolicy(MagickWand *wand,
|
|
|
const char *policy)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
return(SetMagickSecurityPolicy(policy,wand->exception));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t S i z e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetSize() sets the size of the magick wand. Set it before you
|
|
|
% read a raw image format such as RGB, GRAY, or CMYK.
|
|
|
%
|
|
|
% The format of the MagickSetSize method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetSize(MagickWand *wand,
|
|
|
% const size_t columns,const size_t rows)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o columns: the width in pixels.
|
|
|
%
|
|
|
% o rows: the rows in pixels.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetSize(MagickWand *wand,
|
|
|
const size_t columns,const size_t rows)
|
|
|
{
|
|
|
char
|
|
|
geometry[MagickPathExtent];
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) FormatLocaleString(geometry,MagickPathExtent,"%.20gx%.20g",(double)
|
|
|
columns,(double) rows);
|
|
|
(void) CloneString(&wand->image_info->size,geometry);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t S i z e O f f s e t %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetSizeOffset() sets the size and offset of the magick wand. Set it
|
|
|
% before you read a raw image format such as RGB, GRAY, or CMYK.
|
|
|
%
|
|
|
% The format of the MagickSetSizeOffset method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetSizeOffset(MagickWand *wand,
|
|
|
% const size_t columns,const size_t rows,
|
|
|
% const ssize_t offset)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o columns: the image width in pixels.
|
|
|
%
|
|
|
% o rows: the image rows in pixels.
|
|
|
%
|
|
|
% o offset: the image offset.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetSizeOffset(MagickWand *wand,
|
|
|
const size_t columns,const size_t rows,const ssize_t offset)
|
|
|
{
|
|
|
char
|
|
|
geometry[MagickPathExtent];
|
|
|
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
(void) FormatLocaleString(geometry,MagickPathExtent,"%.20gx%.20g%+.20g",
|
|
|
(double) columns,(double) rows,(double) offset);
|
|
|
(void) CloneString(&wand->image_info->size,geometry);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k S e t T y p e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickSetType() sets the image type attribute.
|
|
|
%
|
|
|
% The format of the MagickSetType method is:
|
|
|
%
|
|
|
% MagickBooleanType MagickSetType(MagickWand *wand,
|
|
|
% const ImageType image_type)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o wand: the magick wand.
|
|
|
%
|
|
|
% o image_type: the image type: UndefinedType, BilevelType, GrayscaleType,
|
|
|
% GrayscaleAlphaType, PaletteType, PaletteAlphaType, TrueColorType,
|
|
|
% TrueColorAlphaType, ColorSeparationType, ColorSeparationAlphaType,
|
|
|
% or OptimizeType.
|
|
|
%
|
|
|
*/
|
|
|
WandExport MagickBooleanType MagickSetType(MagickWand *wand,
|
|
|
const ImageType image_type)
|
|
|
{
|
|
|
assert(wand != (MagickWand *) NULL);
|
|
|
assert(wand->signature == MagickWandSignature);
|
|
|
if (wand->debug != MagickFalse)
|
|
|
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
|
|
|
wand->image_info->type=image_type;
|
|
|
return(MagickTrue);
|
|
|
}
|
