2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % V V IIIII FFFFF FFFFF %
13 % Read/Write Khoros Visualization Image Format %
20 % Copyright 1999-2014 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/colorspace-private.h"
52 #include "MagickCore/exception.h"
53 #include "MagickCore/exception-private.h"
54 #include "MagickCore/image.h"
55 #include "MagickCore/image-private.h"
56 #include "MagickCore/list.h"
57 #include "MagickCore/magick.h"
58 #include "MagickCore/memory_.h"
59 #include "MagickCore/monitor.h"
60 #include "MagickCore/monitor-private.h"
61 #include "MagickCore/pixel-accessor.h"
62 #include "MagickCore/property.h"
63 #include "MagickCore/quantum-private.h"
64 #include "MagickCore/static.h"
65 #include "MagickCore/string_.h"
66 #include "MagickCore/module.h"
71 static MagickBooleanType
72 WriteVIFFImage(const ImageInfo *,Image *,ExceptionInfo *);
75 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
83 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
85 % IsVIFF() returns MagickTrue if the image format type, identified by the
86 % magick string, is VIFF.
88 % The format of the IsVIFF method is:
90 % MagickBooleanType IsVIFF(const unsigned char *magick,const size_t length)
92 % A description of each parameter follows:
94 % o magick: compare image format pattern against these bytes.
96 % o length: Specifies the length of the magick string.
99 static MagickBooleanType IsVIFF(const unsigned char *magick,const size_t length)
103 if (memcmp(magick,"\253\001",2) == 0)
109 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
113 % R e a d V I F F I m a g e %
117 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
119 % ReadVIFFImage() reads a Khoros Visualization image file and returns
120 % it. It allocates the memory necessary for the new Image structure and
121 % returns a pointer to the new image.
123 % The format of the ReadVIFFImage method is:
125 % Image *ReadVIFFImage(const ImageInfo *image_info,
126 % ExceptionInfo *exception)
128 % A description of each parameter follows:
130 % o image: Method ReadVIFFImage returns a pointer to the image after
131 % reading. A null image is returned if there is a memory shortage or if
132 % the image cannot be read.
134 % o image_info: the image info.
136 % o exception: return any errors or warnings in this structure.
139 static Image *ReadVIFFImage(const ImageInfo *image_info,
140 ExceptionInfo *exception)
142 #define VFF_CM_genericRGB 15
143 #define VFF_CM_ntscRGB 1
144 #define VFF_CM_NONE 0
145 #define VFF_DEP_DECORDER 0x4
146 #define VFF_DEP_NSORDER 0x8
147 #define VFF_DES_RAW 0
148 #define VFF_LOC_IMPLICIT 1
149 #define VFF_MAPTYP_NONE 0
150 #define VFF_MAPTYP_1_BYTE 1
151 #define VFF_MAPTYP_2_BYTE 2
152 #define VFF_MAPTYP_4_BYTE 4
153 #define VFF_MAPTYP_FLOAT 5
154 #define VFF_MAPTYP_DOUBLE 7
155 #define VFF_MS_NONE 0
156 #define VFF_MS_ONEPERBAND 1
157 #define VFF_MS_SHARED 3
158 #define VFF_TYP_BIT 0
159 #define VFF_TYP_1_BYTE 1
160 #define VFF_TYP_2_BYTE 2
161 #define VFF_TYP_4_BYTE 4
162 #define VFF_TYP_FLOAT 5
163 #define VFF_TYP_DOUBLE 9
165 typedef struct _ViffInfo
234 register unsigned char
257 assert(image_info != (const ImageInfo *) NULL);
258 assert(image_info->signature == MagickSignature);
259 if (image_info->debug != MagickFalse)
260 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
261 image_info->filename);
262 assert(exception != (ExceptionInfo *) NULL);
263 assert(exception->signature == MagickSignature);
264 image=AcquireImage(image_info,exception);
265 status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
266 if (status == MagickFalse)
268 image=DestroyImageList(image);
269 return((Image *) NULL);
272 Read VIFF header (1024 bytes).
274 count=ReadBlob(image,1,&viff_info.identifier);
278 Verify VIFF identifier.
280 if ((count == 0) || ((unsigned char) viff_info.identifier != 0xab))
281 ThrowReaderException(CorruptImageError,"NotAVIFFImage");
283 Initialize VIFF image.
285 count=ReadBlob(image,7,buffer);
286 viff_info.file_type=buffer[0];
287 viff_info.release=buffer[1];
288 viff_info.version=buffer[2];
289 viff_info.machine_dependency=buffer[3];
290 count=ReadBlob(image,512,(unsigned char *) viff_info.comment);
291 viff_info.comment[511]='\0';
292 if (strlen(viff_info.comment) > 4)
293 (void) SetImageProperty(image,"comment",viff_info.comment,exception);
294 if ((viff_info.machine_dependency == VFF_DEP_DECORDER) ||
295 (viff_info.machine_dependency == VFF_DEP_NSORDER))
297 viff_info.rows=ReadBlobLSBLong(image);
298 viff_info.columns=ReadBlobLSBLong(image);
299 viff_info.subrows=ReadBlobLSBLong(image);
300 viff_info.x_offset=(int) ReadBlobLSBLong(image);
301 viff_info.y_offset=(int) ReadBlobLSBLong(image);
302 viff_info.x_bits_per_pixel=(float) ReadBlobLSBLong(image);
303 viff_info.y_bits_per_pixel=(float) ReadBlobLSBLong(image);
304 viff_info.location_type=ReadBlobLSBLong(image);
305 viff_info.location_dimension=ReadBlobLSBLong(image);
306 viff_info.number_of_images=ReadBlobLSBLong(image);
307 viff_info.number_data_bands=ReadBlobLSBLong(image);
308 viff_info.data_storage_type=ReadBlobLSBLong(image);
309 viff_info.data_encode_scheme=ReadBlobLSBLong(image);
310 viff_info.map_scheme=ReadBlobLSBLong(image);
311 viff_info.map_storage_type=ReadBlobLSBLong(image);
312 viff_info.map_rows=ReadBlobLSBLong(image);
313 viff_info.map_columns=ReadBlobLSBLong(image);
314 viff_info.map_subrows=ReadBlobLSBLong(image);
315 viff_info.map_enable=ReadBlobLSBLong(image);
316 viff_info.maps_per_cycle=ReadBlobLSBLong(image);
317 viff_info.color_space_model=ReadBlobLSBLong(image);
321 viff_info.rows=ReadBlobMSBLong(image);
322 viff_info.columns=ReadBlobMSBLong(image);
323 viff_info.subrows=ReadBlobMSBLong(image);
324 viff_info.x_offset=(int) ReadBlobMSBLong(image);
325 viff_info.y_offset=(int) ReadBlobMSBLong(image);
326 viff_info.x_bits_per_pixel=(float) ReadBlobMSBLong(image);
327 viff_info.y_bits_per_pixel=(float) ReadBlobMSBLong(image);
328 viff_info.location_type=ReadBlobMSBLong(image);
329 viff_info.location_dimension=ReadBlobMSBLong(image);
330 viff_info.number_of_images=ReadBlobMSBLong(image);
331 viff_info.number_data_bands=ReadBlobMSBLong(image);
332 viff_info.data_storage_type=ReadBlobMSBLong(image);
333 viff_info.data_encode_scheme=ReadBlobMSBLong(image);
334 viff_info.map_scheme=ReadBlobMSBLong(image);
335 viff_info.map_storage_type=ReadBlobMSBLong(image);
336 viff_info.map_rows=ReadBlobMSBLong(image);
337 viff_info.map_columns=ReadBlobMSBLong(image);
338 viff_info.map_subrows=ReadBlobMSBLong(image);
339 viff_info.map_enable=ReadBlobMSBLong(image);
340 viff_info.maps_per_cycle=ReadBlobMSBLong(image);
341 viff_info.color_space_model=ReadBlobMSBLong(image);
343 for (i=0; i < 420; i++)
344 (void) ReadBlobByte(image);
345 image->columns=viff_info.rows;
346 image->rows=viff_info.columns;
347 image->depth=viff_info.x_bits_per_pixel <= 8 ? 8UL :
348 MAGICKCORE_QUANTUM_DEPTH;
350 Verify that we can read this VIFF image.
352 number_pixels=(MagickSizeType) viff_info.columns*viff_info.rows;
353 if (number_pixels != (size_t) number_pixels)
354 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
355 if (number_pixels == 0)
356 ThrowReaderException(CoderError,"ImageColumnOrRowSizeIsNotSupported");
357 if ((viff_info.number_data_bands < 1) || (viff_info.number_data_bands > 4))
358 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
359 if ((viff_info.data_storage_type != VFF_TYP_BIT) &&
360 (viff_info.data_storage_type != VFF_TYP_1_BYTE) &&
361 (viff_info.data_storage_type != VFF_TYP_2_BYTE) &&
362 (viff_info.data_storage_type != VFF_TYP_4_BYTE) &&
363 (viff_info.data_storage_type != VFF_TYP_FLOAT) &&
364 (viff_info.data_storage_type != VFF_TYP_DOUBLE))
365 ThrowReaderException(CoderError,"DataStorageTypeIsNotSupported");
366 if (viff_info.data_encode_scheme != VFF_DES_RAW)
367 ThrowReaderException(CoderError,"DataEncodingSchemeIsNotSupported");
368 if ((viff_info.map_storage_type != VFF_MAPTYP_NONE) &&
369 (viff_info.map_storage_type != VFF_MAPTYP_1_BYTE) &&
370 (viff_info.map_storage_type != VFF_MAPTYP_2_BYTE) &&
371 (viff_info.map_storage_type != VFF_MAPTYP_4_BYTE) &&
372 (viff_info.map_storage_type != VFF_MAPTYP_FLOAT) &&
373 (viff_info.map_storage_type != VFF_MAPTYP_DOUBLE))
374 ThrowReaderException(CoderError,"MapStorageTypeIsNotSupported");
375 if ((viff_info.color_space_model != VFF_CM_NONE) &&
376 (viff_info.color_space_model != VFF_CM_ntscRGB) &&
377 (viff_info.color_space_model != VFF_CM_genericRGB))
378 ThrowReaderException(CoderError,"ColorspaceModelIsNotSupported");
379 if (viff_info.location_type != VFF_LOC_IMPLICIT)
380 ThrowReaderException(CoderError,"LocationTypeIsNotSupported");
381 if (viff_info.number_of_images != 1)
382 ThrowReaderException(CoderError,"NumberOfImagesIsNotSupported");
383 if (viff_info.map_rows == 0)
384 viff_info.map_scheme=VFF_MS_NONE;
385 switch ((int) viff_info.map_scheme)
389 if (viff_info.number_data_bands < 3)
392 Create linear color ramp.
394 if (viff_info.data_storage_type == VFF_TYP_BIT)
396 else if (viff_info.data_storage_type == VFF_MAPTYP_1_BYTE)
399 image->colors=image->depth <= 8 ? 256UL : 65536UL;
400 if (AcquireImageColormap(image,image->colors,exception) == MagickFalse)
401 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
405 case VFF_MS_ONEPERBAND:
412 Allocate VIFF colormap.
414 switch ((int) viff_info.map_storage_type)
416 case VFF_MAPTYP_1_BYTE: bytes_per_pixel=1; break;
417 case VFF_MAPTYP_2_BYTE: bytes_per_pixel=2; break;
418 case VFF_MAPTYP_4_BYTE: bytes_per_pixel=4; break;
419 case VFF_MAPTYP_FLOAT: bytes_per_pixel=4; break;
420 case VFF_MAPTYP_DOUBLE: bytes_per_pixel=8; break;
421 default: bytes_per_pixel=1; break;
423 image->colors=viff_info.map_columns;
424 if (AcquireImageColormap(image,image->colors,exception) == MagickFalse)
425 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
426 viff_colormap=(unsigned char *) AcquireQuantumMemory(image->colors,
427 viff_info.map_rows*bytes_per_pixel*sizeof(*viff_colormap));
428 if (viff_colormap == (unsigned char *) NULL)
429 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
431 Read VIFF raster colormap.
433 count=ReadBlob(image,bytes_per_pixel*image->colors*viff_info.map_rows,
436 if (*(char *) &lsb_first &&
437 ((viff_info.machine_dependency != VFF_DEP_DECORDER) &&
438 (viff_info.machine_dependency != VFF_DEP_NSORDER)))
439 switch ((int) viff_info.map_storage_type)
441 case VFF_MAPTYP_2_BYTE:
443 MSBOrderShort(viff_colormap,(bytes_per_pixel*image->colors*
444 viff_info.map_rows));
447 case VFF_MAPTYP_4_BYTE:
448 case VFF_MAPTYP_FLOAT:
450 MSBOrderLong(viff_colormap,(bytes_per_pixel*image->colors*
451 viff_info.map_rows));
456 for (i=0; i < (ssize_t) (viff_info.map_rows*image->colors); i++)
458 switch ((int) viff_info.map_storage_type)
460 case VFF_MAPTYP_2_BYTE: value=1.0*((short *) viff_colormap)[i]; break;
461 case VFF_MAPTYP_4_BYTE: value=1.0*((int *) viff_colormap)[i]; break;
462 case VFF_MAPTYP_FLOAT: value=((float *) viff_colormap)[i]; break;
463 case VFF_MAPTYP_DOUBLE: value=((double *) viff_colormap)[i]; break;
464 default: value=1.0*viff_colormap[i]; break;
466 if (i < (ssize_t) image->colors)
468 image->colormap[i].red=ScaleCharToQuantum((unsigned char) value);
469 image->colormap[i].green=
470 ScaleCharToQuantum((unsigned char) value);
471 image->colormap[i].blue=ScaleCharToQuantum((unsigned char) value);
474 if (i < (ssize_t) (2*image->colors))
475 image->colormap[i % image->colors].green=
476 ScaleCharToQuantum((unsigned char) value);
478 if (i < (ssize_t) (3*image->colors))
479 image->colormap[i % image->colors].blue=
480 ScaleCharToQuantum((unsigned char) value);
482 viff_colormap=(unsigned char *) RelinquishMagickMemory(viff_colormap);
486 ThrowReaderException(CoderError,"ColormapTypeNotSupported");
489 Initialize image structure.
491 image->alpha_trait=viff_info.number_data_bands == 4 ? BlendPixelTrait :
493 image->storage_class=(viff_info.number_data_bands < 3 ? PseudoClass :
495 image->columns=viff_info.rows;
496 image->rows=viff_info.columns;
497 if ((image_info->ping != MagickFalse) && (image_info->number_scenes != 0))
498 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
501 Allocate VIFF pixels.
503 switch ((int) viff_info.data_storage_type)
505 case VFF_TYP_2_BYTE: bytes_per_pixel=2; break;
506 case VFF_TYP_4_BYTE: bytes_per_pixel=4; break;
507 case VFF_TYP_FLOAT: bytes_per_pixel=4; break;
508 case VFF_TYP_DOUBLE: bytes_per_pixel=8; break;
509 default: bytes_per_pixel=1; break;
511 if (viff_info.data_storage_type == VFF_TYP_BIT)
512 max_packets=((image->columns+7UL) >> 3UL)*image->rows;
514 max_packets=(size_t) (number_pixels*viff_info.number_data_bands);
515 pixels=(unsigned char *) AcquireQuantumMemory(max_packets,
516 bytes_per_pixel*sizeof(*pixels));
517 if (pixels == (unsigned char *) NULL)
518 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
519 count=ReadBlob(image,bytes_per_pixel*max_packets,pixels);
521 if (*(char *) &lsb_first &&
522 ((viff_info.machine_dependency != VFF_DEP_DECORDER) &&
523 (viff_info.machine_dependency != VFF_DEP_NSORDER)))
524 switch ((int) viff_info.data_storage_type)
528 MSBOrderShort(pixels,bytes_per_pixel*max_packets);
534 MSBOrderLong(pixels,bytes_per_pixel*max_packets);
541 if ((viff_info.data_storage_type != VFF_TYP_1_BYTE) &&
542 (viff_info.map_scheme == VFF_MS_NONE))
548 Determine scale factor.
550 switch ((int) viff_info.data_storage_type)
552 case VFF_TYP_2_BYTE: value=1.0*((short *) pixels)[0]; break;
553 case VFF_TYP_4_BYTE: value=1.0*((int *) pixels)[0]; break;
554 case VFF_TYP_FLOAT: value=((float *) pixels)[0]; break;
555 case VFF_TYP_DOUBLE: value=((double *) pixels)[0]; break;
556 default: value=1.0*pixels[0]; break;
560 for (i=0; i < (ssize_t) max_packets; i++)
562 switch ((int) viff_info.data_storage_type)
564 case VFF_TYP_2_BYTE: value=1.0*((short *) pixels)[i]; break;
565 case VFF_TYP_4_BYTE: value=1.0*((int *) pixels)[i]; break;
566 case VFF_TYP_FLOAT: value=((float *) pixels)[i]; break;
567 case VFF_TYP_DOUBLE: value=((double *) pixels)[i]; break;
568 default: value=1.0*pixels[i]; break;
570 if (value > max_value)
573 if (value < min_value)
576 if ((min_value == 0) && (max_value == 0))
579 if (min_value == max_value)
581 scale_factor=(double) QuantumRange/min_value;
585 scale_factor=(double) QuantumRange/(max_value-min_value);
588 Convert pixels to Quantum size.
590 p=(unsigned char *) pixels;
591 for (i=0; i < (ssize_t) max_packets; i++)
593 switch ((int) viff_info.data_storage_type)
595 case VFF_TYP_2_BYTE: value=1.0*((short *) pixels)[i]; break;
596 case VFF_TYP_4_BYTE: value=1.0*((int *) pixels)[i]; break;
597 case VFF_TYP_FLOAT: value=((float *) pixels)[i]; break;
598 case VFF_TYP_DOUBLE: value=((double *) pixels)[i]; break;
599 default: value=1.0*pixels[i]; break;
601 if (viff_info.map_scheme == VFF_MS_NONE)
603 value=(value-min_value)*scale_factor;
604 if (value > QuantumRange)
610 *p=(unsigned char) value;
614 Convert VIFF raster image to pixel packets.
616 p=(unsigned char *) pixels;
617 if (viff_info.data_storage_type == VFF_TYP_BIT)
620 Convert bitmap scanline.
622 (void) SetImageType(image,BilevelType,exception);
623 (void) SetImageType(image,PaletteType,exception);
624 for (y=0; y < (ssize_t) image->rows; y++)
626 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
627 if (q == (Quantum *) NULL)
629 for (x=0; x < (ssize_t) (image->columns-7); x+=8)
631 for (bit=0; bit < 8; bit++)
633 if (GetPixelLuma(image,q) < (QuantumRange/2.0))
635 quantum=(size_t) GetPixelIndex(image,q);
637 SetPixelIndex(image,quantum,q);
639 q+=GetPixelChannels(image);
643 if ((image->columns % 8) != 0)
645 for (bit=0; bit < (ssize_t) (image->columns % 8); bit++)
646 if (GetPixelLuma(image,q) < (QuantumRange/2.0))
648 quantum=(size_t) GetPixelIndex(image,q);
650 SetPixelIndex(image,quantum,q);
651 q+=GetPixelChannels(image);
655 if (SyncAuthenticPixels(image,exception) == MagickFalse)
657 if (image->previous == (Image *) NULL)
659 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
661 if (status == MagickFalse)
667 if (image->storage_class == PseudoClass)
668 for (y=0; y < (ssize_t) image->rows; y++)
670 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
671 if (q == (Quantum *) NULL)
673 for (x=0; x < (ssize_t) image->columns; x++)
675 SetPixelIndex(image,*p++,q);
676 q+=GetPixelChannels(image);
678 if (SyncAuthenticPixels(image,exception) == MagickFalse)
680 if (image->previous == (Image *) NULL)
682 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
684 if (status == MagickFalse)
691 Convert DirectColor scanline.
693 number_pixels=(MagickSizeType) image->columns*image->rows;
694 for (y=0; y < (ssize_t) image->rows; y++)
696 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
697 if (q == (Quantum *) NULL)
699 for (x=0; x < (ssize_t) image->columns; x++)
701 SetPixelRed(image,ScaleCharToQuantum(*p),q);
702 SetPixelGreen(image,ScaleCharToQuantum(*(p+number_pixels)),q);
703 SetPixelBlue(image,ScaleCharToQuantum(*(p+2*number_pixels)),q);
704 if (image->colors != 0)
706 SetPixelRed(image,image->colormap[(ssize_t)
707 GetPixelRed(image,q)].red,q);
708 SetPixelGreen(image,image->colormap[(ssize_t)
709 GetPixelGreen(image,q)].green,q);
710 SetPixelBlue(image,image->colormap[(ssize_t)
711 GetPixelBlue(image,q)].blue,q);
713 SetPixelAlpha(image,image->alpha_trait == BlendPixelTrait ?
714 ScaleCharToQuantum(*(p+number_pixels*3)) : OpaqueAlpha,q);
716 q+=GetPixelChannels(image);
718 if (SyncAuthenticPixels(image,exception) == MagickFalse)
720 if (image->previous == (Image *) NULL)
722 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
724 if (status == MagickFalse)
729 pixels=(unsigned char *) RelinquishMagickMemory(pixels);
730 if (image->storage_class == PseudoClass)
731 (void) SyncImage(image,exception);
732 if (EOFBlob(image) != MagickFalse)
734 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
739 Proceed to next image.
741 if (image_info->number_scenes != 0)
742 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
744 count=ReadBlob(image,1,&viff_info.identifier);
745 if ((count != 0) && (viff_info.identifier == 0xab))
748 Allocate next image structure.
750 AcquireNextImage(image_info,image,exception);
751 if (GetNextImageInList(image) == (Image *) NULL)
753 image=DestroyImageList(image);
754 return((Image *) NULL);
756 image=SyncNextImageInList(image);
757 status=SetImageProgress(image,LoadImagesTag,TellBlob(image),
759 if (status == MagickFalse)
762 } while ((count != 0) && (viff_info.identifier == 0xab));
763 (void) CloseBlob(image);
764 return(GetFirstImageInList(image));
768 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
772 % R e g i s t e r V I F F I m a g e %
776 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
778 % RegisterVIFFImage() adds properties for the VIFF image format to
779 % the list of supported formats. The properties include the image format
780 % tag, a method to read and/or write the format, whether the format
781 % supports the saving of more than one frame to the same file or blob,
782 % whether the format supports native in-memory I/O, and a brief
783 % description of the format.
785 % The format of the RegisterVIFFImage method is:
787 % size_t RegisterVIFFImage(void)
790 ModuleExport size_t RegisterVIFFImage(void)
795 entry=SetMagickInfo("VIFF");
796 entry->decoder=(DecodeImageHandler *) ReadVIFFImage;
797 entry->encoder=(EncodeImageHandler *) WriteVIFFImage;
798 entry->magick=(IsImageFormatHandler *) IsVIFF;
799 entry->description=ConstantString("Khoros Visualization image");
800 entry->module=ConstantString("VIFF");
801 (void) RegisterMagickInfo(entry);
802 entry=SetMagickInfo("XV");
803 entry->decoder=(DecodeImageHandler *) ReadVIFFImage;
804 entry->encoder=(EncodeImageHandler *) WriteVIFFImage;
805 entry->description=ConstantString("Khoros Visualization image");
806 entry->module=ConstantString("VIFF");
807 (void) RegisterMagickInfo(entry);
808 return(MagickImageCoderSignature);
812 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
816 % U n r e g i s t e r V I F F I m a g e %
820 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
822 % UnregisterVIFFImage() removes format registrations made by the
823 % VIFF module from the list of supported formats.
825 % The format of the UnregisterVIFFImage method is:
827 % UnregisterVIFFImage(void)
830 ModuleExport void UnregisterVIFFImage(void)
832 (void) UnregisterMagickInfo("VIFF");
833 (void) UnregisterMagickInfo("XV");
837 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
841 % W r i t e V I F F I m a g e %
845 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
847 % WriteVIFFImage() writes an image to a file in the VIFF image format.
849 % The format of the WriteVIFFImage method is:
851 % MagickBooleanType WriteVIFFImage(const ImageInfo *image_info,
852 % Image *image,ExceptionInfo *exception)
854 % A description of each parameter follows.
856 % o image_info: the image info.
858 % o image: The image.
860 % o exception: return any errors or warnings in this structure.
864 static inline size_t MagickMin(const size_t x,const size_t y)
871 static MagickBooleanType WriteVIFFImage(const ImageInfo *image_info,
872 Image *image,ExceptionInfo *exception)
874 #define VFF_CM_genericRGB 15
875 #define VFF_CM_NONE 0
876 #define VFF_DEP_IEEEORDER 0x2
877 #define VFF_DES_RAW 0
878 #define VFF_LOC_IMPLICIT 1
879 #define VFF_MAPTYP_NONE 0
880 #define VFF_MAPTYP_1_BYTE 1
881 #define VFF_MS_NONE 0
882 #define VFF_MS_ONEPERBAND 1
883 #define VFF_TYP_BIT 0
884 #define VFF_TYP_1_BYTE 1
886 typedef struct _ViffInfo
941 register const Quantum
950 register unsigned char
964 Open output image file.
966 assert(image_info != (const ImageInfo *) NULL);
967 assert(image_info->signature == MagickSignature);
968 assert(image != (Image *) NULL);
969 assert(image->signature == MagickSignature);
970 if (image->debug != MagickFalse)
971 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
972 assert(exception != (ExceptionInfo *) NULL);
973 assert(exception->signature == MagickSignature);
974 status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
975 if (status == MagickFalse)
977 (void) ResetMagickMemory(&viff_info,0,sizeof(ViffInfo));
982 Initialize VIFF image structure.
984 (void) TransformImageColorspace(image,sRGBColorspace,exception);
985 DisableMSCWarning(4310)
986 viff_info.identifier=(char) 0xab;
988 viff_info.file_type=1;
991 viff_info.machine_dependency=VFF_DEP_IEEEORDER; /* IEEE byte ordering */
992 *viff_info.comment='\0';
993 value=GetImageProperty(image,"comment",exception);
994 if (value != (const char *) NULL)
995 (void) CopyMagickString(viff_info.comment,value,MagickMin(strlen(value),
997 viff_info.rows=image->columns;
998 viff_info.columns=image->rows;
1000 viff_info.x_offset=(~0);
1001 viff_info.y_offset=(~0);
1002 viff_info.x_bits_per_pixel=0;
1003 viff_info.y_bits_per_pixel=0;
1004 viff_info.location_type=VFF_LOC_IMPLICIT;
1005 viff_info.location_dimension=0;
1006 viff_info.number_of_images=1;
1007 viff_info.data_encode_scheme=VFF_DES_RAW;
1008 viff_info.map_scheme=VFF_MS_NONE;
1009 viff_info.map_storage_type=VFF_MAPTYP_NONE;
1010 viff_info.map_rows=0;
1011 viff_info.map_columns=0;
1012 viff_info.map_subrows=0;
1013 viff_info.map_enable=1; /* no colormap */
1014 viff_info.maps_per_cycle=0;
1015 number_pixels=(MagickSizeType) image->columns*image->rows;
1016 if (image->storage_class == DirectClass)
1019 Full color VIFF raster.
1021 viff_info.number_data_bands=image->alpha_trait ? 4UL : 3UL;
1022 viff_info.color_space_model=VFF_CM_genericRGB;
1023 viff_info.data_storage_type=VFF_TYP_1_BYTE;
1024 packets=viff_info.number_data_bands*number_pixels;
1028 viff_info.number_data_bands=1;
1029 viff_info.color_space_model=VFF_CM_NONE;
1030 viff_info.data_storage_type=VFF_TYP_1_BYTE;
1031 packets=number_pixels;
1032 if (IsImageGray(image,exception) == MagickFalse)
1035 Colormapped VIFF raster.
1037 viff_info.map_scheme=VFF_MS_ONEPERBAND;
1038 viff_info.map_storage_type=VFF_MAPTYP_1_BYTE;
1039 viff_info.map_rows=3;
1040 viff_info.map_columns=(unsigned int) image->colors;
1043 if (image->colors <= 2)
1046 Monochrome VIFF raster.
1048 viff_info.data_storage_type=VFF_TYP_BIT;
1049 packets=((image->columns+7) >> 3)*image->rows;
1053 Write VIFF image header (pad to 1024 bytes).
1055 buffer[0]=(unsigned char) viff_info.identifier;
1056 buffer[1]=(unsigned char) viff_info.file_type;
1057 buffer[2]=(unsigned char) viff_info.release;
1058 buffer[3]=(unsigned char) viff_info.version;
1059 buffer[4]=(unsigned char) viff_info.machine_dependency;
1060 buffer[5]=(unsigned char) viff_info.reserve[0];
1061 buffer[6]=(unsigned char) viff_info.reserve[1];
1062 buffer[7]=(unsigned char) viff_info.reserve[2];
1063 (void) WriteBlob(image,8,buffer);
1064 (void) WriteBlob(image,512,(unsigned char *) viff_info.comment);
1065 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.rows);
1066 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.columns);
1067 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.subrows);
1068 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.x_offset);
1069 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.y_offset);
1070 viff_info.x_bits_per_pixel=1U*(63 << 24) | (128 << 16);
1071 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.x_bits_per_pixel);
1072 viff_info.y_bits_per_pixel=1U*(63 << 24) | (128 << 16);
1073 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.y_bits_per_pixel);
1074 (void) WriteBlobMSBLong(image,viff_info.location_type);
1075 (void) WriteBlobMSBLong(image,viff_info.location_dimension);
1076 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.number_of_images);
1077 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.number_data_bands);
1078 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.data_storage_type);
1079 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.data_encode_scheme);
1080 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_scheme);
1081 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_storage_type);
1082 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_rows);
1083 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_columns);
1084 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_subrows);
1085 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.map_enable);
1086 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.maps_per_cycle);
1087 (void) WriteBlobMSBLong(image,(unsigned int) viff_info.color_space_model);
1088 for (i=0; i < 420; i++)
1089 (void) WriteBlobByte(image,'\0');
1091 Convert MIFF to VIFF raster pixels.
1093 pixel_info=AcquireVirtualMemory((size_t) packets,sizeof(*pixels));
1094 if (pixel_info == (MemoryInfo *) NULL)
1095 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1096 pixels=(unsigned char *) GetVirtualMemoryBlob(pixel_info);
1098 if (image->storage_class == DirectClass)
1101 Convert DirectClass packet to VIFF RGB pixel.
1103 number_pixels=(MagickSizeType) image->columns*image->rows;
1104 for (y=0; y < (ssize_t) image->rows; y++)
1106 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1107 if (p == (const Quantum *) NULL)
1109 for (x=0; x < (ssize_t) image->columns; x++)
1111 *q=ScaleQuantumToChar(GetPixelRed(image,p));
1112 *(q+number_pixels)=ScaleQuantumToChar(GetPixelGreen(image,p));
1113 *(q+number_pixels*2)=ScaleQuantumToChar(GetPixelBlue(image,p));
1114 if (image->alpha_trait == BlendPixelTrait)
1115 *(q+number_pixels*3)=ScaleQuantumToChar((Quantum)
1116 (GetPixelAlpha(image,p)));
1117 p+=GetPixelChannels(image);
1120 if (image->previous == (Image *) NULL)
1122 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1124 if (status == MagickFalse)
1130 if (IsImageGray(image,exception) == MagickFalse)
1136 Dump colormap to file.
1138 viff_colormap=(unsigned char *) AcquireQuantumMemory(image->colors,
1139 3*sizeof(*viff_colormap));
1140 if (viff_colormap == (unsigned char *) NULL)
1141 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1143 for (i=0; i < (ssize_t) image->colors; i++)
1144 *q++=ScaleQuantumToChar(image->colormap[i].red);
1145 for (i=0; i < (ssize_t) image->colors; i++)
1146 *q++=ScaleQuantumToChar(image->colormap[i].green);
1147 for (i=0; i < (ssize_t) image->colors; i++)
1148 *q++=ScaleQuantumToChar(image->colormap[i].blue);
1149 (void) WriteBlob(image,3*image->colors,viff_colormap);
1150 viff_colormap=(unsigned char *) RelinquishMagickMemory(viff_colormap);
1152 Convert PseudoClass packet to VIFF colormapped pixels.
1155 for (y=0; y < (ssize_t) image->rows; y++)
1157 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1158 if (p == (const Quantum *) NULL)
1160 for (x=0; x < (ssize_t) image->columns; x++)
1162 *q++=(unsigned char) GetPixelIndex(image,p);
1163 p+=GetPixelChannels(image);
1165 if (image->previous == (Image *) NULL)
1167 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1169 if (status == MagickFalse)
1175 if (image->colors <= 2)
1181 register unsigned char
1186 Convert PseudoClass image to a VIFF monochrome image.
1188 (void) SetImageType(image,BilevelType,exception);
1189 for (y=0; y < (ssize_t) image->rows; y++)
1191 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1192 if (p == (const Quantum *) NULL)
1196 for (x=0; x < (ssize_t) image->columns; x++)
1199 if (GetPixelLuma(image,p) < (QuantumRange/2.0))
1208 p+=GetPixelChannels(image);
1211 *q++=byte >> (8-bit);
1212 if (image->previous == (Image *) NULL)
1214 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType)
1216 if (status == MagickFalse)
1224 Convert PseudoClass packet to VIFF grayscale pixel.
1226 for (y=0; y < (ssize_t) image->rows; y++)
1228 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1229 if (p == (const Quantum *) NULL)
1231 for (x=0; x < (ssize_t) image->columns; x++)
1233 *q++=(unsigned char) ClampToQuantum(GetPixelLuma(image,p));
1234 p+=GetPixelChannels(image);
1236 if (image->previous == (Image *) NULL)
1238 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType)
1240 if (status == MagickFalse)
1245 (void) WriteBlob(image,(size_t) packets,pixels);
1246 pixel_info=RelinquishVirtualMemory(pixel_info);
1247 if (GetNextImageInList(image) == (Image *) NULL)
1249 image=SyncNextImageInList(image);
1250 status=SetImageProgress(image,SaveImagesTag,scene++,
1251 GetImageListLength(image));
1252 if (status == MagickFalse)
1254 } while (image_info->adjoin != MagickFalse);
1255 (void) CloseBlob(image);