2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % M M PPPP EEEEE GGGG %
8 % M M M PPPP EEE G GG %
13 % Read/Write MPEG Image Format %
20 % Copyright 1999-2016 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
28 % Unless required by applicable law or agreed to in writing, software %
29 % distributed under the License is distributed on an "AS IS" BASIS, %
30 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
31 % See the License for the specific language governing permissions and %
32 % limitations under the License. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
41 #include "MagickCore/studio.h"
42 #include "MagickCore/blob.h"
43 #include "MagickCore/blob-private.h"
44 #include "MagickCore/constitute.h"
45 #include "MagickCore/delegate.h"
46 #include "MagickCore/exception.h"
47 #include "MagickCore/exception-private.h"
48 #include "MagickCore/geometry.h"
49 #include "MagickCore/image.h"
50 #include "MagickCore/image-private.h"
51 #include "MagickCore/layer.h"
52 #include "MagickCore/list.h"
53 #include "MagickCore/log.h"
54 #include "MagickCore/magick.h"
55 #include "MagickCore/memory_.h"
56 #include "MagickCore/resource_.h"
57 #include "MagickCore/quantum-private.h"
58 #include "MagickCore/static.h"
59 #include "MagickCore/string_.h"
60 #include "MagickCore/module.h"
61 #include "MagickCore/transform.h"
62 #include "MagickCore/utility.h"
63 #include "MagickCore/utility-private.h"
68 static MagickBooleanType
69 WriteMPEGImage(const ImageInfo *,Image *,ExceptionInfo *);
72 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
80 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
82 % IsAVI() returns MagickTrue if the image format type, identified by the
83 % magick string, is Audio/Video Interleaved file format.
85 % The format of the IsAVI method is:
87 % size_t IsAVI(const unsigned char *magick,const size_t length)
89 % A description of each parameter follows:
91 % o magick: compare image format pattern against these bytes.
93 % o length: Specifies the length of the magick string.
96 static MagickBooleanType IsAVI(const unsigned char *magick,const size_t length)
100 if (memcmp(magick,"RIFF",4) == 0)
106 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
114 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
116 % IsMPEG() returns MagickTrue if the image format type, identified by the
117 % magick string, is MPEG.
119 % The format of the IsMPEG method is:
121 % MagickBooleanType IsMPEG(const unsigned char *magick,const size_t length)
123 % A description of each parameter follows:
125 % o magick: compare image format pattern against these bytes.
127 % o length: Specifies the length of the magick string.
130 static MagickBooleanType IsMPEG(const unsigned char *magick,const size_t length)
134 if (memcmp(magick,"\000\000\001\263",4) == 0)
140 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
144 % R e a d M P E G I m a g e %
148 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
150 % ReadMPEGImage() reads an binary file in the MPEG video stream format
151 % and returns it. It allocates the memory necessary for the new Image
152 % structure and returns a pointer to the new image.
154 % The format of the ReadMPEGImage method is:
156 % Image *ReadMPEGImage(const ImageInfo *image_info,
157 % ExceptionInfo *exception)
159 % A description of each parameter follows:
161 % o image_info: the image info.
163 % o exception: return any errors or warnings in this structure.
166 static Image *ReadMPEGImage(const ImageInfo *image_info,
167 ExceptionInfo *exception)
169 #define ReadMPEGIntermediateFormat "pam"
184 assert(image_info != (const ImageInfo *) NULL);
185 assert(image_info->signature == MagickCoreSignature);
186 if (image_info->debug != MagickFalse)
187 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
188 image_info->filename);
189 assert(exception != (ExceptionInfo *) NULL);
190 assert(exception->signature == MagickCoreSignature);
191 image=AcquireImage(image_info,exception);
192 status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
193 if (status == MagickFalse)
195 image=DestroyImageList(image);
196 return((Image *) NULL);
198 (void) CloseBlob(image);
199 (void) DestroyImageList(image);
201 Convert MPEG to PAM with delegate.
203 read_info=CloneImageInfo(image_info);
204 image=AcquireImage(image_info,exception);
205 (void) InvokeDelegate(read_info,image,"mpeg:decode",(char *) NULL,exception);
206 image=DestroyImage(image);
207 (void) FormatLocaleString(read_info->filename,MagickPathExtent,"%s.%s",
208 read_info->unique,ReadMPEGIntermediateFormat);
209 images=ReadImage(read_info,exception);
210 (void) RelinquishUniqueFileResource(read_info->filename);
211 read_info=DestroyImageInfo(read_info);
216 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
220 % R e g i s t e r M P E G I m a g e %
224 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
226 % RegisterMPEGImage() adds attributes for the MPEG image format to
227 % the list of supported formats. The attributes include the image format
228 % tag, a method to read and/or write the format, whether the format
229 % supports the saving of more than one frame to the same file or blob,
230 % whether the format supports native in-memory I/O, and a brief
231 % description of the format.
233 % The format of the RegisterMPEGImage method is:
235 % size_t RegisterMPEGImage(void)
238 ModuleExport size_t RegisterMPEGImage(void)
243 entry=AcquireMagickInfo("MPEG","AVI","Microsoft Audio/Visual Interleaved");
244 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
245 entry->magick=(IsImageFormatHandler *) IsAVI;
246 entry->flags^=CoderBlobSupportFlag;
247 (void) RegisterMagickInfo(entry);
248 entry=AcquireMagickInfo("MPEG","MKV","Multimedia Container");
249 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
250 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
251 entry->magick=(IsImageFormatHandler *) IsMPEG;
252 entry->flags^=CoderBlobSupportFlag;
253 (void) RegisterMagickInfo(entry);
254 entry=AcquireMagickInfo("MPEG","MOV","MPEG Video Stream");
255 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
256 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
257 entry->magick=(IsImageFormatHandler *) IsMPEG;
258 entry->flags^=CoderBlobSupportFlag;
259 (void) RegisterMagickInfo(entry);
260 entry=AcquireMagickInfo("MPEG","MPEG","MPEG Video Stream");
261 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
262 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
263 entry->magick=(IsImageFormatHandler *) IsMPEG;
264 entry->flags^=CoderBlobSupportFlag;
265 (void) RegisterMagickInfo(entry);
266 entry=AcquireMagickInfo("MPEG","MPG","MPEG Video Stream");
267 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
268 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
269 entry->magick=(IsImageFormatHandler *) IsMPEG;
270 entry->flags^=CoderBlobSupportFlag;
271 (void) RegisterMagickInfo(entry);
272 entry=AcquireMagickInfo("MPEG","MP4","MPEG-4 Video Stream");
273 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
274 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
275 entry->magick=(IsImageFormatHandler *) IsMPEG;
276 entry->flags^=CoderBlobSupportFlag;
277 (void) RegisterMagickInfo(entry);
278 entry=AcquireMagickInfo("MPEG","M2V","MPEG Video Stream");
279 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
280 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
281 entry->magick=(IsImageFormatHandler *) IsMPEG;
282 entry->flags^=CoderBlobSupportFlag;
283 (void) RegisterMagickInfo(entry);
284 entry=AcquireMagickInfo("MPEG","M4V","Raw MPEG-4 Video");
285 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
286 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
287 entry->magick=(IsImageFormatHandler *) IsMPEG;
288 entry->flags^=CoderBlobSupportFlag;
289 (void) RegisterMagickInfo(entry);
290 entry=AcquireMagickInfo("MPEG","WMV","Windows Media Video");
291 entry->decoder=(DecodeImageHandler *) ReadMPEGImage;
292 entry->encoder=(EncodeImageHandler *) WriteMPEGImage;
293 entry->magick=(IsImageFormatHandler *) IsMPEG;
294 entry->flags^=CoderBlobSupportFlag;
295 (void) RegisterMagickInfo(entry);
296 return(MagickImageCoderSignature);
300 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
304 % U n r e g i s t e r M P E G I m a g e %
308 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
310 % UnregisterMPEGImage() removes format registrations made by the
311 % BIM module from the list of supported formats.
313 % The format of the UnregisterBIMImage method is:
315 % UnregisterMPEGImage(void)
318 ModuleExport void UnregisterMPEGImage(void)
320 (void) UnregisterMagickInfo("WMV");
321 (void) UnregisterMagickInfo("MOV");
322 (void) UnregisterMagickInfo("M4V");
323 (void) UnregisterMagickInfo("M2V");
324 (void) UnregisterMagickInfo("MP4");
325 (void) UnregisterMagickInfo("MPG");
326 (void) UnregisterMagickInfo("MPEG");
327 (void) UnregisterMagickInfo("MKV");
328 (void) UnregisterMagickInfo("AVI");
332 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
336 % W r i t e M P E G I m a g e %
340 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
342 % WriteMPEGImage() writes an image to a file in MPEG video stream format.
343 % Lawrence Livermore National Laboratory (LLNL) contributed code to adjust
344 % the MPEG parameters to correspond to the compression quality setting.
346 % The format of the WriteMPEGImage method is:
348 % MagickBooleanType WriteMPEGImage(const ImageInfo *image_info,
349 % Image *image,ExceptionInfo *exception)
351 % A description of each parameter follows.
353 % o image_info: the image info.
355 % o image: The image.
357 % o exception: return any errors or warnings in this structure.
360 static MagickBooleanType CopyDelegateFile(const char *source,
361 const char *destination)
387 Return if destination file already exists and is not empty.
389 assert(source != (const char *) NULL);
390 assert(destination != (char *) NULL);
391 status=GetPathAttributes(destination,&attributes);
392 if ((status != MagickFalse) && (attributes.st_size > 0))
395 Copy source file to destination.
397 destination_file=open_utf8(destination,O_WRONLY | O_BINARY | O_CREAT,S_MODE);
398 if (destination_file == -1)
400 source_file=open_utf8(source,O_RDONLY | O_BINARY,0);
401 if (source_file == -1)
403 (void) close(destination_file);
406 quantum=(size_t) MagickMaxBufferExtent;
407 if ((fstat(source_file,&attributes) == 0) && (attributes.st_size > 0))
408 quantum=(size_t) MagickMin((double) attributes.st_size,
409 MagickMaxBufferExtent);
410 buffer=(unsigned char *) AcquireQuantumMemory(quantum,sizeof(*buffer));
411 if (buffer == (unsigned char *) NULL)
413 (void) close(source_file);
414 (void) close(destination_file);
418 for (i=0; ; i+=count)
420 count=(ssize_t) read(source_file,buffer,quantum);
423 length=(size_t) count;
424 count=(ssize_t) write(destination_file,buffer,length);
425 if ((size_t) count != length)
428 (void) close(destination_file);
429 (void) close(source_file);
430 buffer=(unsigned char *) RelinquishMagickMemory(buffer);
431 return(i != 0 ? MagickTrue : MagickFalse);
434 static MagickBooleanType WriteMPEGImage(const ImageInfo *image_info,
435 Image *image,ExceptionInfo *exception)
437 #define WriteMPEGIntermediateFormat "jpg"
440 basename[MagickPathExtent],
441 filename[MagickPathExtent];
473 Open output image file.
475 assert(image_info != (const ImageInfo *) NULL);
476 assert(image_info->signature == MagickCoreSignature);
477 assert(image != (Image *) NULL);
478 assert(image->signature == MagickCoreSignature);
479 if (image->debug != MagickFalse)
480 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
481 assert(exception != (ExceptionInfo *) NULL);
482 assert(exception->signature == MagickCoreSignature);
483 status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
484 if (status == MagickFalse)
486 (void) CloseBlob(image);
488 Write intermediate files.
490 coalesce_image=CoalesceImages(image,exception);
491 if (coalesce_image == (Image *) NULL)
493 file=AcquireUniqueFileResource(basename);
496 (void) FormatLocaleString(coalesce_image->filename,MagickPathExtent,"%s",
499 write_info=CloneImageInfo(image_info);
500 *write_info->magick='\0';
501 for (p=coalesce_image; p != (Image *) NULL; p=GetNextImageInList(p))
504 previous_image[MagickPathExtent];
506 blob=(unsigned char *) NULL;
509 delay=100.0*p->delay/MagickMax(1.0*p->ticks_per_second,1.0);
510 for (i=0; i < (ssize_t) MagickMax((1.0*delay+1.0)/3.0,1.0); i++)
522 (void) FormatLocaleString(p->filename,MagickPathExtent,"%s%.20g.%s",
523 basename,(double) p->scene,WriteMPEGIntermediateFormat);
524 (void) FormatLocaleString(filename,MagickPathExtent,"%s%.20g.%s",
525 basename,(double) p->scene,WriteMPEGIntermediateFormat);
526 (void) FormatLocaleString(previous_image,MagickPathExtent,
527 "%s%.20g.%s",basename,(double) p->scene,
528 WriteMPEGIntermediateFormat);
529 frame=CloneImage(p,0,0,MagickTrue,exception);
530 if (frame == (Image *) NULL)
532 status=WriteImage(write_info,frame,exception);
533 frame=DestroyImage(frame);
538 blob=(unsigned char *) FileToBlob(previous_image,~0UL,&length,
543 (void) FormatLocaleString(filename,MagickPathExtent,"%s%.20g.%s",
544 basename,(double) p->scene,WriteMPEGIntermediateFormat);
546 status=BlobToFile(filename,blob,length,exception);
550 if (image->debug != MagickFalse)
552 if (status != MagickFalse)
553 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
554 "%.20g. Wrote %s file for scene %.20g:",(double) i,
555 WriteMPEGIntermediateFormat,(double) p->scene);
557 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
558 "%.20g. Failed to write %s file for scene %.20g:",(double) i,
559 WriteMPEGIntermediateFormat,(double) p->scene);
560 (void) LogMagickEvent(CoderEvent,GetMagickModule(),"%s",filename);
564 if (blob != (unsigned char *) NULL)
565 blob=(unsigned char *) RelinquishMagickMemory(blob);
566 if (status == MagickFalse)
570 Convert JPEG to MPEG.
572 (void) CopyMagickString(coalesce_image->magick_filename,basename,
574 (void) CopyMagickString(coalesce_image->filename,basename,MagickPathExtent);
575 GetPathComponent(image_info->filename,ExtensionPath,coalesce_image->magick);
576 if (*coalesce_image->magick == '\0')
577 (void) CopyMagickString(coalesce_image->magick,image->magick,MagickPathExtent);
578 status=InvokeDelegate(write_info,coalesce_image,(char *) NULL,"mpeg:encode",
580 (void) FormatLocaleString(write_info->filename,MagickPathExtent,"%s.%s",
581 write_info->unique,coalesce_image->magick);
582 status=CopyDelegateFile(write_info->filename,image->filename);
583 (void) RelinquishUniqueFileResource(write_info->filename);
584 write_info=DestroyImageInfo(write_info);
586 Relinquish resources.
589 for (p=coalesce_image; p != (Image *) NULL; p=GetNextImageInList(p))
591 delay=100.0*p->delay/MagickMax(1.0*p->ticks_per_second,1.0);
592 for (i=0; i < (ssize_t) MagickMax((1.0*delay+1.0)/3.0,1.0); i++)
594 (void) FormatLocaleString(p->filename,MagickPathExtent,"%s%.20g.%s",
595 basename,(double) count++,WriteMPEGIntermediateFormat);
596 (void) RelinquishUniqueFileResource(p->filename);
598 (void) CopyMagickString(p->filename,image_info->filename,MagickPathExtent);
600 (void) RelinquishUniqueFileResource(basename);
601 coalesce_image=DestroyImageList(coalesce_image);
602 if (image->debug != MagickFalse)
603 (void) LogMagickEvent(CoderEvent,GetMagickModule(),"exit");