2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % V V IIIII FFFFF FFFFF %
13 % Read/Write Khoros Visualization Image Format %
20 % Copyright 1999-2011 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 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
42 #include "MagickCore/studio.h"
43 #include "MagickCore/attribute.h"
44 #include "MagickCore/blob.h"
45 #include "MagickCore/blob-private.h"
46 #include "MagickCore/cache.h"
47 #include "MagickCore/color.h"
48 #include "MagickCore/color-private.h"
49 #include "MagickCore/colormap.h"
50 #include "MagickCore/colorspace.h"
51 #include "MagickCore/exception.h"
52 #include "MagickCore/exception-private.h"
53 #include "MagickCore/image.h"
54 #include "MagickCore/image-private.h"
55 #include "MagickCore/list.h"
56 #include "MagickCore/magick.h"
57 #include "MagickCore/memory_.h"
58 #include "MagickCore/monitor.h"
59 #include "MagickCore/monitor-private.h"
60 #include "MagickCore/pixel-accessor.h"
61 #include "MagickCore/property.h"
62 #include "MagickCore/quantum-private.h"
63 #include "MagickCore/static.h"
64 #include "MagickCore/string_.h"
65 #include "MagickCore/module.h"
70 static MagickBooleanType
71 WriteVIFFImage(const ImageInfo *,Image *);
74 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
82 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
84 % IsVIFF() returns MagickTrue if the image format type, identified by the
85 % magick string, is VIFF.
87 % The format of the IsVIFF method is:
89 % MagickBooleanType IsVIFF(const unsigned char *magick,const size_t length)
91 % A description of each parameter follows:
93 % o magick: compare image format pattern against these bytes.
95 % o length: Specifies the length of the magick string.
98 static MagickBooleanType IsVIFF(const unsigned char *magick,const size_t length)
102 if (memcmp(magick,"\253\001",2) == 0)
108 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
112 % R e a d V I F F I m a g e %
116 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
118 % ReadVIFFImage() reads a Khoros Visualization image file and returns
119 % it. It allocates the memory necessary for the new Image structure and
120 % returns a pointer to the new image.
122 % The format of the ReadVIFFImage method is:
124 % Image *ReadVIFFImage(const ImageInfo *image_info,
125 % ExceptionInfo *exception)
127 % A description of each parameter follows:
129 % o image: Method ReadVIFFImage returns a pointer to the image after
130 % reading. A null image is returned if there is a memory shortage or if
131 % the image cannot be read.
133 % o image_info: the image info.
135 % o exception: return any errors or warnings in this structure.
138 static Image *ReadVIFFImage(const ImageInfo *image_info,
139 ExceptionInfo *exception)
141 #define VFF_CM_genericRGB 15
142 #define VFF_CM_ntscRGB 1
143 #define VFF_CM_NONE 0
144 #define VFF_DEP_DECORDER 0x4
145 #define VFF_DEP_NSORDER 0x8
146 #define VFF_DES_RAW 0
147 #define VFF_LOC_IMPLICIT 1
148 #define VFF_MAPTYP_NONE 0
149 #define VFF_MAPTYP_1_BYTE 1
150 #define VFF_MAPTYP_2_BYTE 2
151 #define VFF_MAPTYP_4_BYTE 4
152 #define VFF_MAPTYP_FLOAT 5
153 #define VFF_MAPTYP_DOUBLE 7
154 #define VFF_MS_NONE 0
155 #define VFF_MS_ONEPERBAND 1
156 #define VFF_MS_SHARED 3
157 #define VFF_TYP_BIT 0
158 #define VFF_TYP_1_BYTE 1
159 #define VFF_TYP_2_BYTE 2
160 #define VFF_TYP_4_BYTE 4
161 #define VFF_TYP_FLOAT 5
162 #define VFF_TYP_DOUBLE 9
164 typedef struct _ViffInfo
233 register unsigned char
256 assert(image_info != (const ImageInfo *) NULL);
257 assert(image_info->signature == MagickSignature);
258 if (image_info->debug != MagickFalse)
259 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
260 image_info->filename);
261 assert(exception != (ExceptionInfo *) NULL);
262 assert(exception->signature == MagickSignature);
263 image=AcquireImage(image_info);
264 status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
265 if (status == MagickFalse)
267 image=DestroyImageList(image);
268 return((Image *) NULL);
271 Read VIFF header (1024 bytes).
273 count=ReadBlob(image,1,&viff_info.identifier);
277 Verify VIFF identifier.
279 if ((count == 0) || ((unsigned char) viff_info.identifier != 0xab))
280 ThrowReaderException(CorruptImageError,"NotAVIFFImage");
282 Initialize VIFF image.
284 count=ReadBlob(image,7,buffer);
285 viff_info.file_type=buffer[0];
286 viff_info.release=buffer[1];
287 viff_info.version=buffer[2];
288 viff_info.machine_dependency=buffer[3];
289 count=ReadBlob(image,512,(unsigned char *) viff_info.comment);
290 viff_info.comment[511]='\0';
291 if (strlen(viff_info.comment) > 4)
292 (void) SetImageProperty(image,"comment",viff_info.comment);
293 if ((viff_info.machine_dependency == VFF_DEP_DECORDER) ||
294 (viff_info.machine_dependency == VFF_DEP_NSORDER))
296 viff_info.rows=ReadBlobLSBLong(image);
297 viff_info.columns=ReadBlobLSBLong(image);
298 viff_info.subrows=ReadBlobLSBLong(image);
299 viff_info.x_offset=(int) ReadBlobLSBLong(image);
300 viff_info.y_offset=(int) ReadBlobLSBLong(image);
301 viff_info.x_bits_per_pixel=(float) ReadBlobLSBLong(image);
302 viff_info.y_bits_per_pixel=(float) ReadBlobLSBLong(image);
303 viff_info.location_type=ReadBlobLSBLong(image);
304 viff_info.location_dimension=ReadBlobLSBLong(image);
305 viff_info.number_of_images=ReadBlobLSBLong(image);
306 viff_info.number_data_bands=ReadBlobLSBLong(image);
307 viff_info.data_storage_type=ReadBlobLSBLong(image);
308 viff_info.data_encode_scheme=ReadBlobLSBLong(image);
309 viff_info.map_scheme=ReadBlobLSBLong(image);
310 viff_info.map_storage_type=ReadBlobLSBLong(image);
311 viff_info.map_rows=ReadBlobLSBLong(image);
312 viff_info.map_columns=ReadBlobLSBLong(image);
313 viff_info.map_subrows=ReadBlobLSBLong(image);
314 viff_info.map_enable=ReadBlobLSBLong(image);
315 viff_info.maps_per_cycle=ReadBlobLSBLong(image);
316 viff_info.color_space_model=ReadBlobLSBLong(image);
320 viff_info.rows=ReadBlobMSBLong(image);
321 viff_info.columns=ReadBlobMSBLong(image);
322 viff_info.subrows=ReadBlobMSBLong(image);
323 viff_info.x_offset=(int) ReadBlobMSBLong(image);
324 viff_info.y_offset=(int) ReadBlobMSBLong(image);
325 viff_info.x_bits_per_pixel=(float) ReadBlobMSBLong(image);
326 viff_info.y_bits_per_pixel=(float) ReadBlobMSBLong(image);
327 viff_info.location_type=ReadBlobMSBLong(image);
328 viff_info.location_dimension=ReadBlobMSBLong(image);
329 viff_info.number_of_images=ReadBlobMSBLong(image);
330 viff_info.number_data_bands=ReadBlobMSBLong(image);
331 viff_info.data_storage_type=ReadBlobMSBLong(image);
332 viff_info.data_encode_scheme=ReadBlobMSBLong(image);
333 viff_info.map_scheme=ReadBlobMSBLong(image);
334 viff_info.map_storage_type=ReadBlobMSBLong(image);
335 viff_info.map_rows=ReadBlobMSBLong(image);
336 viff_info.map_columns=ReadBlobMSBLong(image);
337 viff_info.map_subrows=ReadBlobMSBLong(image);
338 viff_info.map_enable=ReadBlobMSBLong(image);
339 viff_info.maps_per_cycle=ReadBlobMSBLong(image);
340 viff_info.color_space_model=ReadBlobMSBLong(image);
342 for (i=0; i < 420; i++)
343 (void) ReadBlobByte(image);
344 image->columns=viff_info.rows;
345 image->rows=viff_info.columns;
346 image->depth=viff_info.x_bits_per_pixel <= 8 ? 8UL :
347 MAGICKCORE_QUANTUM_DEPTH;
349 Verify that we can read this VIFF image.
351 number_pixels=(MagickSizeType) viff_info.columns*viff_info.rows;
352 if (number_pixels != (size_t) number_pixels)
353 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
354 if (number_pixels == 0)
355 ThrowReaderException(CoderError,"ImageColumnOrRowSizeIsNotSupported");
356 if ((viff_info.number_data_bands < 1) || (viff_info.number_data_bands > 4))
357 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
358 if ((viff_info.data_storage_type != VFF_TYP_BIT) &&
359 (viff_info.data_storage_type != VFF_TYP_1_BYTE) &&
360 (viff_info.data_storage_type != VFF_TYP_2_BYTE) &&
361 (viff_info.data_storage_type != VFF_TYP_4_BYTE) &&
362 (viff_info.data_storage_type != VFF_TYP_FLOAT) &&
363 (viff_info.data_storage_type != VFF_TYP_DOUBLE))
364 ThrowReaderException(CoderError,"DataStorageTypeIsNotSupported");
365 if (viff_info.data_encode_scheme != VFF_DES_RAW)
366 ThrowReaderException(CoderError,"DataEncodingSchemeIsNotSupported");
367 if ((viff_info.map_storage_type != VFF_MAPTYP_NONE) &&
368 (viff_info.map_storage_type != VFF_MAPTYP_1_BYTE) &&
369 (viff_info.map_storage_type != VFF_MAPTYP_2_BYTE) &&
370 (viff_info.map_storage_type != VFF_MAPTYP_4_BYTE) &&
371 (viff_info.map_storage_type != VFF_MAPTYP_FLOAT) &&
372 (viff_info.map_storage_type != VFF_MAPTYP_DOUBLE))
373 ThrowReaderException(CoderError,"MapStorageTypeIsNotSupported");
374 if ((viff_info.color_space_model != VFF_CM_NONE) &&
375 (viff_info.color_space_model != VFF_CM_ntscRGB) &&
376 (viff_info.color_space_model != VFF_CM_genericRGB))
377 ThrowReaderException(CoderError,"ColorspaceModelIsNotSupported");
378 if (viff_info.location_type != VFF_LOC_IMPLICIT)
379 ThrowReaderException(CoderError,"LocationTypeIsNotSupported");
380 if (viff_info.number_of_images != 1)
381 ThrowReaderException(CoderError,"NumberOfImagesIsNotSupported");
382 if (viff_info.map_rows == 0)
383 viff_info.map_scheme=VFF_MS_NONE;
384 switch ((int) viff_info.map_scheme)
388 if (viff_info.number_data_bands < 3)
391 Create linear color ramp.
393 image->colors=image->depth <= 8 ? 256UL : 65536UL;
394 if (viff_info.data_storage_type == VFF_TYP_BIT)
396 if (AcquireImageColormap(image,image->colors) == MagickFalse)
397 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
401 case VFF_MS_ONEPERBAND:
408 Allocate VIFF colormap.
410 switch ((int) viff_info.map_storage_type)
412 case VFF_MAPTYP_1_BYTE: bytes_per_pixel=1; break;
413 case VFF_MAPTYP_2_BYTE: bytes_per_pixel=2; break;
414 case VFF_MAPTYP_4_BYTE: bytes_per_pixel=4; break;
415 case VFF_MAPTYP_FLOAT: bytes_per_pixel=4; break;
416 case VFF_MAPTYP_DOUBLE: bytes_per_pixel=8; break;
417 default: bytes_per_pixel=1; break;
419 image->colors=viff_info.map_columns;
420 if (AcquireImageColormap(image,image->colors) == MagickFalse)
421 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
422 viff_colormap=(unsigned char *) AcquireQuantumMemory(image->colors,
423 viff_info.map_rows*bytes_per_pixel*sizeof(*viff_colormap));
424 if (viff_colormap == (unsigned char *) NULL)
425 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
427 Read VIFF raster colormap.
429 count=ReadBlob(image,bytes_per_pixel*image->colors*viff_info.map_rows,
432 if (*(char *) &lsb_first &&
433 ((viff_info.machine_dependency != VFF_DEP_DECORDER) &&
434 (viff_info.machine_dependency != VFF_DEP_NSORDER)))
435 switch ((int) viff_info.map_storage_type)
437 case VFF_MAPTYP_2_BYTE:
439 MSBOrderShort(viff_colormap,(bytes_per_pixel*image->colors*
440 viff_info.map_rows));
443 case VFF_MAPTYP_4_BYTE:
444 case VFF_MAPTYP_FLOAT:
446 MSBOrderLong(viff_colormap,(bytes_per_pixel*image->colors*
447 viff_info.map_rows));
452 for (i=0; i < (ssize_t) (viff_info.map_rows*image->colors); i++)
454 switch ((int) viff_info.map_storage_type)
456 case VFF_MAPTYP_2_BYTE: value=1.0*((short *) viff_colormap)[i]; break;
457 case VFF_MAPTYP_4_BYTE: value=1.0*((int *) viff_colormap)[i]; break;
458 case VFF_MAPTYP_FLOAT: value=((float *) viff_colormap)[i]; break;
459 case VFF_MAPTYP_DOUBLE: value=((double *) viff_colormap)[i]; break;
460 default: value=1.0*viff_colormap[i]; break;
462 if (i < (ssize_t) image->colors)
464 image->colormap[i].red=ScaleCharToQuantum((unsigned char) value);
465 image->colormap[i].green=
466 ScaleCharToQuantum((unsigned char) value);
467 image->colormap[i].blue=ScaleCharToQuantum((unsigned char) value);
470 if (i < (ssize_t) (2*image->colors))
471 image->colormap[i % image->colors].green=
472 ScaleCharToQuantum((unsigned char) value);
474 if (i < (ssize_t) (3*image->colors))
475 image->colormap[i % image->colors].blue=
476 ScaleCharToQuantum((unsigned char) value);
478 viff_colormap=(unsigned char *) RelinquishMagickMemory(viff_colormap);
482 ThrowReaderException(CoderError,"ColormapTypeNotSupported");
485 Initialize image structure.
487 image->matte=viff_info.number_data_bands == 4 ? MagickTrue : MagickFalse;
488 image->storage_class=
489 (viff_info.number_data_bands < 3 ? PseudoClass : DirectClass);
490 image->columns=viff_info.rows;
491 image->rows=viff_info.columns;
492 if ((image_info->ping != MagickFalse) && (image_info->number_scenes != 0))
493 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
496 Allocate VIFF pixels.
498 switch ((int) viff_info.data_storage_type)
500 case VFF_TYP_2_BYTE: bytes_per_pixel=2; break;
501 case VFF_TYP_4_BYTE: bytes_per_pixel=4; break;
502 case VFF_TYP_FLOAT: bytes_per_pixel=4; break;
503 case VFF_TYP_DOUBLE: bytes_per_pixel=8; break;
504 default: bytes_per_pixel=1; break;
506 if (viff_info.data_storage_type == VFF_TYP_BIT)
507 max_packets=((image->columns+7UL) >> 3UL)*image->rows;
509 max_packets=(size_t) (number_pixels*viff_info.number_data_bands);
510 viff_pixels=(unsigned char *) AcquireQuantumMemory(max_packets,
511 bytes_per_pixel*sizeof(*viff_pixels));
512 if (viff_pixels == (unsigned char *) NULL)
513 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
514 count=ReadBlob(image,bytes_per_pixel*max_packets,viff_pixels);
516 if (*(char *) &lsb_first &&
517 ((viff_info.machine_dependency != VFF_DEP_DECORDER) &&
518 (viff_info.machine_dependency != VFF_DEP_NSORDER)))
519 switch ((int) viff_info.data_storage_type)
523 MSBOrderShort(viff_pixels,bytes_per_pixel*max_packets);
529 MSBOrderLong(viff_pixels,bytes_per_pixel*max_packets);
536 if ((viff_info.data_storage_type != VFF_TYP_1_BYTE) &&
537 (viff_info.map_scheme == VFF_MS_NONE))
543 Determine scale factor.
545 switch ((int) viff_info.data_storage_type)
547 case VFF_TYP_2_BYTE: value=1.0*((short *) viff_pixels)[0]; break;
548 case VFF_TYP_4_BYTE: value=1.0*((int *) viff_pixels)[0]; break;
549 case VFF_TYP_FLOAT: value=((float *) viff_pixels)[0]; break;
550 case VFF_TYP_DOUBLE: value=((double *) viff_pixels)[0]; break;
551 default: value=1.0*viff_pixels[0]; break;
555 for (i=0; i < (ssize_t) max_packets; i++)
557 switch ((int) viff_info.data_storage_type)
559 case VFF_TYP_2_BYTE: value=1.0*((short *) viff_pixels)[i]; break;
560 case VFF_TYP_4_BYTE: value=1.0*((int *) viff_pixels)[i]; break;
561 case VFF_TYP_FLOAT: value=((float *) viff_pixels)[i]; break;
562 case VFF_TYP_DOUBLE: value=((double *) viff_pixels)[i]; break;
563 default: value=1.0*viff_pixels[i]; break;
565 if (value > max_value)
568 if (value < min_value)
571 if ((min_value == 0) && (max_value == 0))
574 if (min_value == max_value)
576 scale_factor=(MagickRealType) QuantumRange/min_value;
580 scale_factor=(MagickRealType) QuantumRange/(max_value-min_value);
583 Convert pixels to Quantum size.
585 p=(unsigned char *) viff_pixels;
586 for (i=0; i < (ssize_t) max_packets; i++)
588 switch ((int) viff_info.data_storage_type)
590 case VFF_TYP_2_BYTE: value=1.0*((short *) viff_pixels)[i]; break;
591 case VFF_TYP_4_BYTE: value=1.0*((int *) viff_pixels)[i]; break;
592 case VFF_TYP_FLOAT: value=((float *) viff_pixels)[i]; break;
593 case VFF_TYP_DOUBLE: value=((double *) viff_pixels)[i]; break;
594 default: value=1.0*viff_pixels[i]; break;
596 if (viff_info.map_scheme == VFF_MS_NONE)
598 value=(value-min_value)*scale_factor;
599 if (value > QuantumRange)
605 *p=(unsigned char) value;
609 Convert VIFF raster image to pixel packets.
611 p=(unsigned char *) viff_pixels;
612 if (viff_info.data_storage_type == VFF_TYP_BIT)
615 Convert bitmap scanline.
617 (void) SetImageType(image,BilevelType);
618 (void) SetImageType(image,PaletteType);
619 for (y=0; y < (ssize_t) image->rows; y++)
621 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
622 if (q == (const Quantum *) NULL)
624 for (x=0; x < (ssize_t) (image->columns-7); x+=8)
626 for (bit=0; bit < 8; bit++)
628 if (GetPixelIntensity(image,q) < ((MagickRealType) QuantumRange/2.0))
630 quantum=(size_t) GetPixelIndex(image,q);
632 SetPixelIndex(image,quantum,q);
634 q+=GetPixelChannels(image);
638 if ((image->columns % 8) != 0)
640 for (bit=0; bit < (ssize_t) (image->columns % 8); bit++)
641 if (GetPixelIntensity(image,q) < ((MagickRealType) QuantumRange/2.0))
643 quantum=(size_t) GetPixelIndex(image,q);
645 SetPixelIndex(image,quantum,q);
646 q+=GetPixelChannels(image);
650 if (SyncAuthenticPixels(image,exception) == MagickFalse)
652 if (image->previous == (Image *) NULL)
654 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
656 if (status == MagickFalse)
662 if (image->storage_class == PseudoClass)
663 for (y=0; y < (ssize_t) image->rows; y++)
665 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
666 if (q == (const Quantum *) NULL)
668 for (x=0; x < (ssize_t) image->columns; x++)
670 SetPixelIndex(image,*p++,q);
671 q+=GetPixelChannels(image);
673 if (SyncAuthenticPixels(image,exception) == MagickFalse)
675 if (image->previous == (Image *) NULL)
677 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
679 if (status == MagickFalse)
686 Convert DirectColor scanline.
688 number_pixels=(MagickSizeType) image->columns*image->rows;
689 for (y=0; y < (ssize_t) image->rows; y++)
691 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
692 if (q == (const Quantum *) NULL)
694 for (x=0; x < (ssize_t) image->columns; x++)
696 SetPixelRed(image,ScaleCharToQuantum(*p),q);
697 SetPixelGreen(image,ScaleCharToQuantum(*(p+number_pixels)),q);
698 SetPixelBlue(image,ScaleCharToQuantum(*(p+2*number_pixels)),q);
699 if (image->colors != 0)
701 SetPixelRed(image,image->colormap[(ssize_t)
702 GetPixelRed(image,q)].red,q);
703 SetPixelGreen(image,image->colormap[(ssize_t)
704 GetPixelGreen(image,q)].green,q);
705 SetPixelBlue(image,image->colormap[(ssize_t)
706 GetPixelBlue(image,q)].blue,q);
708 SetPixelAlpha(image,image->matte != MagickFalse ?
709 ScaleCharToQuantum(*(p+number_pixels*3)) : OpaqueAlpha,q);
711 q+=GetPixelChannels(image);
713 if (SyncAuthenticPixels(image,exception) == MagickFalse)
715 if (image->previous == (Image *) NULL)
717 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
719 if (status == MagickFalse)
724 viff_pixels=(unsigned char *) RelinquishMagickMemory(viff_pixels);
725 if (image->storage_class == PseudoClass)
726 (void) SyncImage(image);
727 if (EOFBlob(image) != MagickFalse)
729 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
734 Proceed to next image.
736 if (image_info->number_scenes != 0)
737 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
739 count=ReadBlob(image,1,&viff_info.identifier);
740 if ((count != 0) && (viff_info.identifier == 0xab))
743 Allocate next image structure.
745 AcquireNextImage(image_info,image);
746 if (GetNextImageInList(image) == (Image *) NULL)
748 image=DestroyImageList(image);
749 return((Image *) NULL);
751 image=SyncNextImageInList(image);
752 status=SetImageProgress(image,LoadImagesTag,TellBlob(image),
754 if (status == MagickFalse)
757 } while ((count != 0) && (viff_info.identifier == 0xab));
758 (void) CloseBlob(image);
759 return(GetFirstImageInList(image));
763 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
767 % R e g i s t e r V I F F I m a g e %
771 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
773 % RegisterVIFFImage() adds properties for the VIFF image format to
774 % the list of supported formats. The properties include the image format
775 % tag, a method to read and/or write the format, whether the format
776 % supports the saving of more than one frame to the same file or blob,
777 % whether the format supports native in-memory I/O, and a brief
778 % description of the format.
780 % The format of the RegisterVIFFImage method is:
782 % size_t RegisterVIFFImage(void)
785 ModuleExport size_t RegisterVIFFImage(void)
790 entry=SetMagickInfo("VIFF");
791 entry->decoder=(DecodeImageHandler *) ReadVIFFImage;
792 entry->encoder=(EncodeImageHandler *) WriteVIFFImage;
793 entry->magick=(IsImageFormatHandler *) IsVIFF;
794 entry->description=ConstantString("Khoros Visualization image");
795 entry->module=ConstantString("VIFF");
796 (void) RegisterMagickInfo(entry);
797 entry=SetMagickInfo("XV");
798 entry->decoder=(DecodeImageHandler *) ReadVIFFImage;
799 entry->encoder=(EncodeImageHandler *) WriteVIFFImage;
800 entry->description=ConstantString("Khoros Visualization image");
801 entry->module=ConstantString("VIFF");
802 (void) RegisterMagickInfo(entry);
803 return(MagickImageCoderSignature);
807 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
811 % U n r e g i s t e r V I F F I m a g e %
815 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
817 % UnregisterVIFFImage() removes format registrations made by the
818 % VIFF module from the list of supported formats.
820 % The format of the UnregisterVIFFImage method is:
822 % UnregisterVIFFImage(void)
825 ModuleExport void UnregisterVIFFImage(void)
827 (void) UnregisterMagickInfo("VIFF");
828 (void) UnregisterMagickInfo("XV");
832 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
836 % W r i t e V I F F I m a g e %
840 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
842 % WriteVIFFImage() writes an image to a file in the VIFF image format.
844 % The format of the WriteVIFFImage method is:
846 % MagickBooleanType WriteVIFFImage(const ImageInfo *image_info,
849 % A description of each parameter follows.
851 % o image_info: the image info.
853 % o image: The image.
857 static inline size_t MagickMin(const size_t x,const size_t y)
864 static MagickBooleanType WriteVIFFImage(const ImageInfo *image_info,
867 #define VFF_CM_genericRGB 15
868 #define VFF_CM_NONE 0
869 #define VFF_DEP_IEEEORDER 0x2
870 #define VFF_DES_RAW 0
871 #define VFF_LOC_IMPLICIT 1
872 #define VFF_MAPTYP_NONE 0
873 #define VFF_MAPTYP_1_BYTE 1
874 #define VFF_MS_NONE 0
875 #define VFF_MS_ONEPERBAND 1
876 #define VFF_TYP_BIT 0
877 #define VFF_TYP_1_BYTE 1
879 typedef struct _ViffInfo
931 register const Quantum
940 register unsigned char
954 Open output image file.
956 assert(image_info != (const ImageInfo *) NULL);
957 assert(image_info->signature == MagickSignature);
958 assert(image != (Image *) NULL);
959 assert(image->signature == MagickSignature);
960 if (image->debug != MagickFalse)
961 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
962 status=OpenBlob(image_info,image,WriteBinaryBlobMode,&image->exception);
963 if (status == MagickFalse)
965 (void) ResetMagickMemory(&viff_info,0,sizeof(ViffInfo));
970 Initialize VIFF image structure.
972 if (image->colorspace != RGBColorspace)
973 (void) TransformImageColorspace(image,RGBColorspace);
974 if (IsImageGray(image,&image->exception) != MagickFalse)
975 (void) SetImageStorageClass(image,DirectClass);
976 viff_info.identifier=(char) 0xab;
977 viff_info.file_type=1;
980 viff_info.machine_dependency=VFF_DEP_IEEEORDER; /* IEEE byte ordering */
981 *viff_info.comment='\0';
982 value=GetImageProperty(image,"comment");
983 if (value != (const char *) NULL)
984 (void) CopyMagickString(viff_info.comment,value,MagickMin(strlen(value),
986 viff_info.rows=image->columns;
987 viff_info.columns=image->rows;
989 viff_info.x_offset=(~0);
990 viff_info.y_offset=(~0);
991 viff_info.x_bits_per_pixel=0;
992 viff_info.y_bits_per_pixel=0;
993 viff_info.location_type=VFF_LOC_IMPLICIT;
994 viff_info.location_dimension=0;
995 viff_info.number_of_images=1;
996 viff_info.data_encode_scheme=VFF_DES_RAW;
997 viff_info.map_scheme=VFF_MS_NONE;
998 viff_info.map_storage_type=VFF_MAPTYP_NONE;
999 viff_info.map_rows=0;
1000 viff_info.map_columns=0;
1001 viff_info.map_subrows=0;
1002 viff_info.map_enable=1; /* no colormap */
1003 viff_info.maps_per_cycle=0;
1004 number_pixels=(MagickSizeType) image->columns*image->rows;
1005 if (image->storage_class == DirectClass)
1008 Full color VIFF raster.
1010 viff_info.number_data_bands=image->matte ? 4UL : 3UL;
1011 viff_info.color_space_model=VFF_CM_genericRGB;
1012 viff_info.data_storage_type=VFF_TYP_1_BYTE;
1013 packets=viff_info.number_data_bands*number_pixels;
1017 viff_info.number_data_bands=1;
1018 viff_info.color_space_model=VFF_CM_NONE;
1019 viff_info.data_storage_type=VFF_TYP_1_BYTE;
1020 packets=number_pixels;
1021 if (IsImageGray(image,&image->exception) == MagickFalse)
1024 Colormapped VIFF raster.
1026 viff_info.map_scheme=VFF_MS_ONEPERBAND;
1027 viff_info.map_storage_type=VFF_MAPTYP_1_BYTE;
1028 viff_info.map_rows=3;
1029 viff_info.map_columns=(unsigned int) image->colors;
1032 if (image->colors <= 2)
1035 Monochrome VIFF raster.
1037 viff_info.data_storage_type=VFF_TYP_BIT;
1038 packets=((image->columns+7) >> 3)*image->rows;
1042 Write VIFF image header (pad to 1024 bytes).
1044 buffer[0]=(unsigned char) viff_info.identifier;
1045 buffer[1]=(unsigned char) viff_info.file_type;
1046 buffer[2]=(unsigned char) viff_info.release;
1047 buffer[3]=(unsigned char) viff_info.version;
1048 buffer[4]=(unsigned char) viff_info.machine_dependency;
1049 buffer[5]=(unsigned char) viff_info.reserve[0];
1050 buffer[6]=(unsigned char) viff_info.reserve[1];
1051 buffer[7]=(unsigned char) viff_info.reserve[2];
1052 (void) WriteBlob(image,8,buffer);
1053 (void) WriteBlob(image,512,(unsigned char *) viff_info.comment);
1054 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.rows);
1055 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.columns);
1056 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.subrows);
1057 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.x_offset);
1058 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.y_offset);
1059 viff_info.x_bits_per_pixel=1U*(63 << 24) | (128 << 16);
1060 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.x_bits_per_pixel);
1061 viff_info.y_bits_per_pixel=1U*(63 << 24) | (128 << 16);
1062 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.y_bits_per_pixel);
1063 (void) WriteBlobMSBLong(image,viff_info.location_type);
1064 (void) WriteBlobMSBLong(image,viff_info.location_dimension);
1065 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.number_of_images);
1066 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.number_data_bands);
1067 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.data_storage_type);
1068 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.data_encode_scheme);
1069 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_scheme);
1070 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_storage_type);
1071 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_rows);
1072 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_columns);
1073 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_subrows);
1074 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_enable);
1075 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.maps_per_cycle);
1076 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.color_space_model);
1077 for (i=0; i < 420; i++)
1078 (void) WriteBlobByte(image,'\0');
1080 Convert MIFF to VIFF raster pixels.
1082 viff_pixels=(unsigned char *) AcquireQuantumMemory((size_t) packets,
1083 sizeof(*viff_pixels));
1084 if (viff_pixels == (unsigned char *) NULL)
1085 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1087 if (image->storage_class == DirectClass)
1090 Convert DirectClass packet to VIFF RGB pixel.
1092 number_pixels=(MagickSizeType) image->columns*image->rows;
1093 for (y=0; y < (ssize_t) image->rows; y++)
1095 p=GetVirtualPixels(image,0,y,image->columns,1,&image->exception);
1096 if (p == (const Quantum *) NULL)
1098 for (x=0; x < (ssize_t) image->columns; x++)
1100 *q=ScaleQuantumToChar(GetPixelRed(image,p));
1101 *(q+number_pixels)=ScaleQuantumToChar(GetPixelGreen(image,p));
1102 *(q+number_pixels*2)=ScaleQuantumToChar(GetPixelBlue(image,p));
1103 if (image->matte != MagickFalse)
1104 *(q+number_pixels*3)=ScaleQuantumToChar((Quantum)
1105 (GetPixelAlpha(image,p)));
1106 p+=GetPixelChannels(image);
1109 if (image->previous == (Image *) NULL)
1111 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1113 if (status == MagickFalse)
1119 if (IsImageGray(image,&image->exception) == MagickFalse)
1125 Dump colormap to file.
1127 viff_colormap=(unsigned char *) AcquireQuantumMemory(image->colors,
1128 3*sizeof(*viff_colormap));
1129 if (viff_colormap == (unsigned char *) NULL)
1130 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1132 for (i=0; i < (ssize_t) image->colors; i++)
1133 *q++=ScaleQuantumToChar(image->colormap[i].red);
1134 for (i=0; i < (ssize_t) image->colors; i++)
1135 *q++=ScaleQuantumToChar(image->colormap[i].green);
1136 for (i=0; i < (ssize_t) image->colors; i++)
1137 *q++=ScaleQuantumToChar(image->colormap[i].blue);
1138 (void) WriteBlob(image,3*image->colors,viff_colormap);
1139 viff_colormap=(unsigned char *) RelinquishMagickMemory(viff_colormap);
1141 Convert PseudoClass packet to VIFF colormapped pixels.
1144 for (y=0; y < (ssize_t) image->rows; y++)
1146 p=GetVirtualPixels(image,0,y,image->columns,1,&image->exception);
1147 if (p == (const Quantum *) NULL)
1149 for (x=0; x < (ssize_t) image->columns; x++)
1151 *q++=(unsigned char) GetPixelIndex(image,p);
1152 p+=GetPixelChannels(image);
1154 if (image->previous == (Image *) NULL)
1156 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1158 if (status == MagickFalse)
1164 if (image->colors <= 2)
1170 register unsigned char
1175 Convert PseudoClass image to a VIFF monochrome image.
1177 (void) SetImageType(image,BilevelType);
1178 for (y=0; y < (ssize_t) image->rows; y++)
1180 p=GetVirtualPixels(image,0,y,image->columns,1,
1182 if (p == (const Quantum *) NULL)
1186 for (x=0; x < (ssize_t) image->columns; x++)
1189 if (GetPixelIntensity(image,p) < ((MagickRealType) QuantumRange/2.0))
1198 p+=GetPixelChannels(image);
1201 *q++=byte >> (8-bit);
1202 if (image->previous == (Image *) NULL)
1204 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType)
1206 if (status == MagickFalse)
1214 Convert PseudoClass packet to VIFF grayscale pixel.
1216 for (y=0; y < (ssize_t) image->rows; y++)
1218 p=GetVirtualPixels(image,0,y,image->columns,1,
1220 if (p == (const Quantum *) NULL)
1222 for (x=0; x < (ssize_t) image->columns; x++)
1224 *q++=(unsigned char) GetPixelIntensity(image,p);
1225 p+=GetPixelChannels(image);
1227 if (image->previous == (Image *) NULL)
1229 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType)
1231 if (status == MagickFalse)
1236 (void) WriteBlob(image,(size_t) packets,viff_pixels);
1237 viff_pixels=(unsigned char *) RelinquishMagickMemory(viff_pixels);
1238 if (GetNextImageInList(image) == (Image *) NULL)
1240 image=SyncNextImageInList(image);
1241 status=SetImageProgress(image,SaveImagesTag,scene++,
1242 GetImageListLength(image));
1243 if (status == MagickFalse)
1245 } while (image_info->adjoin != MagickFalse);
1246 (void) CloseBlob(image);