| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % M M GGGG K K % |
| % MM MM G K K % |
| % M M M G GG KKK % |
| % M M G G K K % |
| % M M GGG K K % |
| % % |
| % % |
| % Read/Write MGK Image Format. % |
| % % |
| % Software Design % |
| % John Cristy % |
| % July 1992 % |
| % % |
| % % |
| % 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 <MagickCore/studio.h> |
| #include <MagickCore/blob.h> |
| #include <MagickCore/cache.h> |
| #include <MagickCore/colorspace.h> |
| #include <MagickCore/exception.h> |
| #include <MagickCore/image.h> |
| #include <MagickCore/list.h> |
| #include <MagickCore/magick.h> |
| #include <MagickCore/memory_.h> |
| #include <MagickCore/monitor.h> |
| #include <MagickCore/pixel-accessor.h> |
| #include <MagickCore/string_.h> |
| #include <MagickCore/module.h> |
| |
| /* |
| Forward declarations. |
| */ |
| static MagickBooleanType |
| WriteMGKImage(const ImageInfo *,Image *,ExceptionInfo *); |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % I s M G K % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % IsMGK() returns MagickTrue if the image format type, identified by the |
| % magick string, is MGK. |
| % |
| % The format of the IsMGK method is: |
| % |
| % MagickBooleanType IsMGK(const unsigned char *magick,const size_t length) |
| % |
| % A description of each parameter follows: |
| % |
| % o magick: This string is generally the first few bytes of an image file |
| % or blob. |
| % |
| % o length: Specifies the length of the magick string. |
| % |
| */ |
| static MagickBooleanType IsMGK(const unsigned char *magick,const size_t length) |
| { |
| if (length < 7) |
| return(MagickFalse); |
| if (LocaleNCompare((char *) magick,"id=mgk",7) == 0) |
| return(MagickTrue); |
| return(MagickFalse); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e a d M G K I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % ReadMGKImage() reads a MGK image file and returns it. It allocates the |
| % memory necessary for the new Image structure and returns a pointer to the |
| % new image. |
| % |
| % The format of the ReadMGKImage method is: |
| % |
| % Image *ReadMGKImage(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 *ReadMGKImage(const ImageInfo *image_info,ExceptionInfo *exception) |
| { |
| char |
| buffer[MaxTextExtent]; |
| |
| Image |
| *image; |
| |
| long |
| y; |
| |
| MagickBooleanType |
| status; |
| |
| register long |
| x; |
| |
| register Quantum |
| *q; |
| |
| register unsigned char |
| *p; |
| |
| ssize_t |
| count; |
| |
| unsigned char |
| *pixels; |
| |
| unsigned long |
| columns, |
| rows; |
| |
| /* |
| Open image file. |
| */ |
| assert(image_info != (const ImageInfo *) NULL); |
| assert(image_info->signature == MagickCoreSignature); |
| if (image_info->debug != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s", |
| image_info->filename); |
| assert(exception != (ExceptionInfo *) NULL); |
| assert(exception->signature == MagickCoreSignature); |
| image=AcquireImage(image_info,exception); |
| status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception); |
| if (status == MagickFalse) |
| { |
| image=DestroyImageList(image); |
| return((Image *) NULL); |
| } |
| /* |
| Read MGK image. |
| */ |
| (void) ReadBlobString(image,buffer); /* read magic number */ |
| if (IsMGK(buffer,7) == MagickFalse) |
| ThrowReaderException(CorruptImageError,"ImproperImageHeader"); |
| (void) ReadBlobString(image,buffer); |
| count=(ssize_t) sscanf(buffer,"%lu %lu\n",&columns,&rows); |
| if (count <= 0) |
| ThrowReaderException(CorruptImageError,"ImproperImageHeader"); |
| do |
| { |
| /* |
| Initialize image structure. |
| */ |
| image->columns=columns; |
| image->rows=rows; |
| image->depth=8; |
| if ((image_info->ping != MagickFalse) && (image_info->number_scenes != 0)) |
| if (image->scene >= (image_info->scene+image_info->number_scenes-1)) |
| break; |
| /* |
| Convert MGK raster image to pixel packets. |
| */ |
| if (SetImageExtent(image,image->columns,image->rows,exception) == MagickFalse) |
| return(DestroyImageList(image)); |
| pixels=(unsigned char *) AcquireQuantumMemory((size_t) image->columns, |
| 3UL*sizeof(*pixels)); |
| if (pixels == (unsigned char *) NULL) |
| ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed"); |
| for (y=0; y < (ssize_t) image->rows; y++) |
| { |
| count=(ssize_t) ReadBlob(image,(size_t) (3*image->columns),pixels); |
| if (count != (ssize_t) (3*image->columns)) |
| ThrowReaderException(CorruptImageError,"UnableToReadImageData"); |
| p=pixels; |
| q=QueueAuthenticPixels(image,0,y,image->columns,1,exception); |
| if (q == (Quantum *) NULL) |
| break; |
| for (x=0; x < (ssize_t) image->columns; x++) |
| { |
| SetPixelRed(image,ScaleCharToQuantum(*p++),q); |
| SetPixelGreen(image,ScaleCharToQuantum(*p++),q); |
| SetPixelBlue(image,ScaleCharToQuantum(*p++),q); |
| q+=GetPixelChannels(image); |
| } |
| if (SyncAuthenticPixels(image,exception) == MagickFalse) |
| break; |
| if (image->previous == (Image *) NULL) |
| if ((image->progress_monitor != (MagickProgressMonitor) NULL) && |
| (QuantumTick(y,image->rows) != MagickFalse)) |
| { |
| status=image->progress_monitor(LoadImageTag,y,image->rows, |
| image->client_data); |
| if (status == MagickFalse) |
| break; |
| } |
| } |
| pixels=(unsigned char *) RelinquishMagickMemory(pixels); |
| if (EOFBlob(image) != MagickFalse) |
| { |
| ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile", |
| image->filename); |
| break; |
| } |
| /* |
| Proceed to next image. |
| */ |
| if (image_info->number_scenes != 0) |
| if (image->scene >= (image_info->scene+image_info->number_scenes-1)) |
| break; |
| *buffer='\0'; |
| (void) ReadBlobString(image,buffer); |
| count=(ssize_t) sscanf(buffer,"%lu %lu\n",&columns,&rows); |
| if (count > 0) |
| { |
| /* |
| Allocate next image structure. |
| */ |
| AcquireNextImage(image_info,image,exception); |
| if (GetNextImageInList(image) == (Image *) NULL) |
| { |
| status=MagickFalse; |
| break; |
| } |
| image=SyncNextImageInList(image); |
| if (image->progress_monitor != (MagickProgressMonitor) NULL) |
| { |
| status=SetImageProgress(image,LoadImageTag,TellBlob(image), |
| GetBlobSize(image)); |
| if (status == MagickFalse) |
| break; |
| } |
| } |
| } while (count > 0); |
| (void) CloseBlob(image); |
| if (status == MagickFalse) |
| return(DestroyImageList(image)); |
| return(GetFirstImageInList(image)); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e g i s t e r M G K I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % RegisterMGKImage() adds attributes for the MGK 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 RegisterMGKImage method is: |
| % |
| % unsigned long RegisterMGKImage(void) |
| % |
| */ |
| ModuleExport unsigned long RegisterMGKImage(void) |
| { |
| MagickInfo |
| *entry; |
| |
| entry=AcquireMagickInfo("MGK","MGK","MGK image"); |
| entry->decoder=(DecodeImageHandler *) ReadMGKImage; |
| entry->encoder=(EncodeImageHandler *) WriteMGKImage; |
| entry->magick=(IsImageFormatHandler *) IsMGK; |
| (void) RegisterMagickInfo(entry); |
| return(MagickImageCoderSignature); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % U n r e g i s t e r M G K I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % UnregisterMGKImage() removes format registrations made by the |
| % MGK module from the list of supported formats. |
| % |
| % The format of the UnregisterMGKImage method is: |
| % |
| % UnregisterMGKImage(void) |
| % |
| */ |
| ModuleExport void UnregisterMGKImage(void) |
| { |
| (void) UnregisterMagickInfo("MGK"); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % W r i t e M G K I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % WriteMGKImage() writes an image to a file in red, green, and blue MGK |
| % rasterfile format. |
| % |
| % The format of the WriteMGKImage method is: |
| % |
| % MagickBooleanType WriteMGKImage(const ImageInfo *image_info, |
| % Image *image) |
| % |
| % 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 WriteMGKImage(const ImageInfo *image_info,Image *image, |
| ExceptionInfo *exception) |
| { |
| char |
| buffer[MaxTextExtent]; |
| |
| long |
| y; |
| |
| MagickBooleanType |
| status; |
| |
| MagickOffsetType |
| scene; |
| |
| register const Quantum |
| *p; |
| |
| register long |
| x; |
| |
| register unsigned char |
| *q; |
| |
| unsigned char |
| *pixels; |
| |
| /* |
| Open output image file. |
| */ |
| assert(image_info != (const ImageInfo *) NULL); |
| assert(image_info->signature == MagickCoreSignature); |
| assert(image != (Image *) NULL); |
| assert(image->signature == MagickCoreSignature); |
| if (image->debug != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename); |
| status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception); |
| if (status == MagickFalse) |
| return(status); |
| scene=0; |
| do |
| { |
| /* |
| Allocate memory for pixels. |
| */ |
| if (image->colorspace != RGBColorspace) |
| (void) SetImageColorspace(image,RGBColorspace,exception); |
| pixels=(unsigned char *) AcquireQuantumMemory((size_t) image->columns, |
| 3UL*sizeof(*pixels)); |
| if (pixels == (unsigned char *) NULL) |
| ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed"); |
| /* |
| Initialize raster file header. |
| */ |
| (void) WriteBlobString(image,"id=mgk\n"); |
| (void) FormatLocaleString(buffer,MaxTextExtent,"%lu %lu\n",image->columns, |
| image->rows); |
| (void) WriteBlobString(image,buffer); |
| for (y=0; y < (ssize_t) image->rows; y++) |
| { |
| p=GetVirtualPixels(image,0,y,image->columns,1,exception); |
| if (p == (const Quantum *) NULL) |
| break; |
| q=pixels; |
| for (x=0; x < (ssize_t) image->columns; x++) |
| { |
| *q++=ScaleQuantumToChar(GetPixelRed(image,p)); |
| *q++=ScaleQuantumToChar(GetPixelGreen(image,p)); |
| *q++=ScaleQuantumToChar(GetPixelBlue(image,p)); |
| p+=GetPixelChannels(image); |
| } |
| (void) WriteBlob(image,(size_t) (q-pixels),pixels); |
| if (image->previous == (Image *) NULL) |
| if ((image->progress_monitor != (MagickProgressMonitor) NULL) && |
| (QuantumTick(y,image->rows) != MagickFalse)) |
| { |
| status=image->progress_monitor(SaveImageTag,y,image->rows, |
| image->client_data); |
| if (status == MagickFalse) |
| break; |
| } |
| } |
| pixels=(unsigned char *) RelinquishMagickMemory(pixels); |
| if (GetNextImageInList(image) == (Image *) NULL) |
| break; |
| image=SyncNextImageInList(image); |
| status=SetImageProgress(image,SaveImagesTag,scene, |
| GetImageListLength(image)); |
| if (status == MagickFalse) |
| break; |
| scene++; |
| } while (image_info->adjoin != MagickFalse); |
| (void) CloseBlob(image); |
| return(MagickTrue); |
| } |
