/* %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % % % % % % CCCC L IIIII PPPP % % C L I P P % % C L I PPPP % % C L I P % % CCCC LLLLL IIIII P % % % % % % Write Clip Mask To MIFF File. % % % % Software Design % % Cristy % % July 1992 % % % % % % Copyright 1999-2015 ImageMagick Studio LLC, a non-profit organization % % dedicated to making software imaging solutions freely available. % % % % You may not use this file except in compliance with the License. You may % % obtain a copy of the License at % % % % http://www.imagemagick.org/script/license.php % % % % Unless required by applicable law or agreed to in writing, software % % distributed under the License is distributed on an "AS IS" BASIS, % % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. % % See the License for the specific language governing permissions and % % limitations under the License. % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % */ /* Include declarations. */ #include "MagickCore/studio.h" #include "MagickCore/attribute.h" #include "MagickCore/blob.h" #include "MagickCore/blob-private.h" #include "MagickCore/constitute.h" #include "MagickCore/exception.h" #include "MagickCore/exception-private.h" #include "MagickCore/list.h" #include "MagickCore/magick.h" #include "MagickCore/memory_.h" #include "MagickCore/monitor.h" #include "MagickCore/monitor-private.h" #include "MagickCore/quantum-private.h" #include "MagickCore/static.h" #include "MagickCore/string_.h" #include "MagickCore/module.h" /* Forward declarations. */ static MagickBooleanType WriteCLIPImage(const ImageInfo *,Image *,ExceptionInfo *); /* %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % % % % % % R e a d C L I P I m a g e % % % % % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % ReadCLIPImage returns the rendered clip path associated with the image. % % The format of the ReadCLIPImage method is: % % Image *ReadCLIPImage(const ImageInfo *image_info, % ExceptionInfo *exception) % % A description of each parameter follows: % % o image_info: the image info. % % o exception: return any errors or warnings in this structure. % */ static Image *ReadCLIPImage(const ImageInfo *image_info, ExceptionInfo *exception) { Image *clip_image, *image; ImageInfo *read_info; /* Initialize Image structure. */ assert(image_info != (const ImageInfo *) NULL); assert(image_info->signature == MagickSignature); if (image_info->debug != MagickFalse) (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s", image_info->filename); assert(exception != (ExceptionInfo *) NULL); assert(exception->signature == MagickSignature); read_info=CloneImageInfo(image_info); SetImageInfoBlob(read_info,(void *) NULL,0); *read_info->magick='\0'; clip_image=ReadImage(read_info,exception); read_info=DestroyImageInfo(read_info); if (clip_image == (Image *) NULL) return((Image *) NULL); (void) ClipImage(clip_image,exception); image=GetImageMask(clip_image,exception); clip_image=DestroyImage(clip_image); if (image == (Image *) NULL) ThrowReaderException(CoderError,"ImageDoesNotHaveAClipMask"); return(GetFirstImageInList(image)); } /* %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % % % % % % R e g i s t e r C L I P I m a g e % % % % % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % RegisterCLIPImage() adds attributes for the CLIP image format to % the list of supported formats. The attributes include the image format % tag, a method to read and/or write the format, whether the format % supports the saving of more than one frame to the same file or blob, % whether the format supports native in-memory I/O, and a brief % description of the format. % % The format of the RegisterCLIPImage method is: % % size_t RegisterCLIPImage(void) % */ ModuleExport size_t RegisterCLIPImage(void) { MagickInfo *entry; entry=SetMagickInfo("CLIP"); entry->decoder=(DecodeImageHandler *) ReadCLIPImage; entry->encoder=(EncodeImageHandler *) WriteCLIPImage; entry->description=ConstantString("Image Clip Mask"); entry->module=ConstantString("CLIP"); (void) RegisterMagickInfo(entry); return(MagickImageCoderSignature); } /* %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % % % % % % U n r e g i s t e r C L I P I m a g e % % % % % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % UnregisterCLIPImage() removes format registrations made by the % CLIP module from the list of supported formats. % % The format of the UnregisterCLIPImage method is: % % UnregisterCLIPImage(void) % */ ModuleExport void UnregisterCLIPImage(void) { (void) UnregisterMagickInfo("CLIP"); } /* %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % % % % % % W r i t e C L I P I m a g e % % % % % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % WriteCLIPImage() writes an image of clip bytes to a file. It consists of % data from the clip mask of the image. % % The format of the WriteCLIPImage method is: % % MagickBooleanType WriteCLIPImage(const ImageInfo *image_info, % Image *image,ExceptionInfo *exception) % % A description of each parameter follows. % % o image_info: the image info. % % o image: The image. % % o exception: return any errors or warnings in this structure. % */ static MagickBooleanType WriteCLIPImage(const ImageInfo *image_info, Image *image,ExceptionInfo *exception) { Image *clip_image; ImageInfo *write_info; MagickBooleanType status; if (image->read_mask == MagickFalse) (void) ClipImage(image,exception); if (image->read_mask == MagickFalse) ThrowWriterException(CoderError,"ImageDoesNotHaveAClipMask"); clip_image=GetImageMask(image,exception); if (clip_image == (Image *) NULL) return(MagickFalse); (void) CopyMagickString(clip_image->filename,image->filename,MaxTextExtent); write_info=CloneImageInfo(image_info); *write_info->magick='\0'; (void) SetImageInfo(write_info,1,exception); if (LocaleCompare(write_info->magick,"CLIP") == 0) (void) FormatLocaleString(clip_image->filename,MaxTextExtent,"miff:%s", write_info->filename); status=WriteImage(write_info,clip_image,exception); clip_image=DestroyImage(clip_image); write_info=DestroyImageInfo(write_info); return(status); }