granicus.if.org Git - imagemagick/blob - coders/fax.c

   1 /*
   2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   3 %                                                                             %
   4 %                                                                             %
   5 %                                                                             %
   6 %                            FFFFF   AAA   X   X                              %
   7 %                            F      A   A   X X                               %
   8 %                            FFF    AAAAA    X                                %
   9 %                            F      A   A   X X                               %
  10 %                            F      A   A  X   X                              %
  11 %                                                                             %
  12 %                                                                             %
  13 %                   Read/Write Group 3 Fax Image Format                       %
  14 %                                                                             %
  15 %                              Software Design                                %
  16 %                                   Cristy                                    %
  17 %                                 July 1992                                   %
  18 %                                                                             %
  19 %                                                                             %
  20 %  Copyright 1999-2015 ImageMagick Studio LLC, a non-profit organization      %
  21 %  dedicated to making software imaging solutions freely available.           %
  22 %                                                                             %
  23 %  You may not use this file except in compliance with the License.  You may  %
  24 %  obtain a copy of the License at                                            %
  25 %                                                                             %
  26 %    http://www.imagemagick.org/script/license.php                            %
  27 %                                                                             %
  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.                                             %
  33 %                                                                             %
  34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  35 %
  36 %
  37 */
  38 \f
  39 /*
  40   Include declarations.
  41 */
  42 #include "MagickCore/studio.h"
  43 #include "MagickCore/attribute.h"
  44 #include "MagickCore/blob.h"
  45 #include "MagickCore/blob-private.h"
  46 #include "MagickCore/colormap.h"
  47 #include "MagickCore/colorspace.h"
  48 #include "MagickCore/colorspace-private.h"
  49 #include "MagickCore/exception.h"
  50 #include "MagickCore/exception-private.h"
  51 #include "MagickCore/compress.h"
  52 #include "MagickCore/image.h"
  53 #include "MagickCore/image-private.h"
  54 #include "MagickCore/list.h"
  55 #include "MagickCore/magick.h"
  56 #include "MagickCore/memory_.h"
  57 #include "MagickCore/monitor.h"
  58 #include "MagickCore/monitor-private.h"
  59 #include "MagickCore/quantum-private.h"
  60 #include "MagickCore/static.h"
  61 #include "MagickCore/string_.h"
  62 #include "MagickCore/module.h"
  63 \f
  64 /*
  65   Forward declarations.
  66 */
  67 static MagickBooleanType
  68   WriteFAXImage(const ImageInfo *,Image *,ExceptionInfo *);
  69 \f
  70 /*
  71 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  72 %                                                                             %
  73 %                                                                             %
  74 %                                                                             %
  75 %   I s F A X                                                                 %
  76 %                                                                             %
  77 %                                                                             %
  78 %                                                                             %
  79 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  80 %
  81 %  IsFAX() returns MagickTrue if the image format type, identified by the
  82 %  magick string, is FAX.
  83 %
  84 %  The format of the IsFAX method is:
  85 %
  86 %      MagickBooleanType IsFAX(const unsigned char *magick,const size_t length)
  87 %
  88 %  A description of each parameter follows:
  89 %
  90 %    o magick: compare image format pattern against these bytes.
  91 %
  92 %    o length: Specifies the length of the magick string.
  93 %
  94 %
  95 */
  96 static MagickBooleanType IsFAX(const unsigned char *magick,const size_t length)
  97 {
  98   if (length < 4)
  99     return(MagickFalse);
 100   if (LocaleNCompare((char *) magick,"DFAX",4) == 0)
 101     return(MagickTrue);
 102   return(MagickFalse);
 103 }
 104 \f
 105 /*
 106 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 107 %                                                                             %
 108 %                                                                             %
 109 %                                                                             %
 110 %   R e a d F A X I m a g e                                                   %
 111 %                                                                             %
 112 %                                                                             %
 113 %                                                                             %
 114 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 115 %
 116 %  ReadFAXImage() reads a Group 3 FAX image file and returns it.  It
 117 %  allocates the memory necessary for the new Image structure and returns a
 118 %  pointer to the new image.
 119 %
 120 %  The format of the ReadFAXImage method is:
 121 %
 122 %      Image *ReadFAXImage(const ImageInfo *image_info,ExceptionInfo *exception)
 123 %
 124 %  A description of each parameter follows:
 125 %
 126 %    o image_info: the image info.
 127 %
 128 %    o exception: return any errors or warnings in this structure.
 129 %
 130 */
 131 static Image *ReadFAXImage(const ImageInfo *image_info,ExceptionInfo *exception)
 132 {
 133   Image
 134     *image;
 135
 136   MagickBooleanType
 137     status;
 138
 139   /*
 140     Open image file.
 141   */
 142   assert(image_info != (const ImageInfo *) NULL);
 143   assert(image_info->signature == MagickSignature);
 144   if (image_info->debug != MagickFalse)
 145     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
 146       image_info->filename);
 147   assert(exception != (ExceptionInfo *) NULL);
 148   assert(exception->signature == MagickSignature);
 149   image=AcquireImage(image_info,exception);
 150   status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
 151   if (status == MagickFalse)
 152     {
 153       image=DestroyImageList(image);
 154       return((Image *) NULL);
 155     }
 156   /*
 157     Initialize image structure.
 158   */
 159   image->storage_class=PseudoClass;
 160   if (image->columns == 0)
 161     image->columns=2592;
 162   if (image->rows == 0)
 163     image->rows=3508;
 164   image->depth=8;
 165   if (AcquireImageColormap(image,2,exception) == MagickFalse)
 166     ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
 167   /*
 168     Monochrome colormap.
 169   */
 170   image->colormap[0].red=QuantumRange;
 171   image->colormap[0].green=QuantumRange;
 172   image->colormap[0].blue=QuantumRange;
 173   image->colormap[1].red=(Quantum) 0;
 174   image->colormap[1].green=(Quantum) 0;
 175   image->colormap[1].blue=(Quantum) 0;
 176   if (image_info->ping != MagickFalse)
 177     {
 178       (void) CloseBlob(image);
 179       return(GetFirstImageInList(image));
 180     }
 181   status=SetImageExtent(image,image->columns,image->rows,exception);
 182   if (status == MagickFalse)
 183     return(DestroyImageList(image));
 184   status=HuffmanDecodeImage(image,exception);
 185   if (status == MagickFalse)
 186     ThrowReaderException(CorruptImageError,"UnableToReadImageData");
 187   if (EOFBlob(image) != MagickFalse)
 188     ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
 189       image->filename);
 190   (void) CloseBlob(image);
 191   return(GetFirstImageInList(image));
 192 }
 193 \f
 194 /*
 195 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 196 %                                                                             %
 197 %                                                                             %
 198 %                                                                             %
 199 %   R e g i s t e r F A X I m a g e                                           %
 200 %                                                                             %
 201 %                                                                             %
 202 %                                                                             %
 203 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 204 %
 205 %  RegisterFAXImage() adds attributes for the FAX image format to
 206 %  the list of supported formats.  The attributes include the image format
 207 %  tag, a method to read and/or write the format, whether the format
 208 %  supports the saving of more than one frame to the same file or blob,
 209 %  whether the format supports native in-memory I/O, and a brief
 210 %  description of the format.
 211 %
 212 %  The format of the RegisterFAXImage method is:
 213 %
 214 %      size_t RegisterFAXImage(void)
 215 %
 216 */
 217 ModuleExport size_t RegisterFAXImage(void)
 218 {
 219   MagickInfo
 220     *entry;
 221
 222   static const char
 223     *Note=
 224     {
 225       "FAX machines use non-square pixels which are 1.5 times wider than\n"
 226       "they are tall but computer displays use square pixels, therefore\n"
 227       "FAX images may appear to be narrow unless they are explicitly\n"
 228       "resized using a geometry of \"150x100%\".\n"
 229     };
 230
 231   entry=SetMagickInfo("FAX");
 232   entry->decoder=(DecodeImageHandler *) ReadFAXImage;
 233   entry->encoder=(EncodeImageHandler *) WriteFAXImage;
 234   entry->magick=(IsImageFormatHandler *) IsFAX;
 235   entry->description=ConstantString("Group 3 FAX");
 236   entry->note=ConstantString(Note);
 237   entry->module=ConstantString("FAX");
 238   (void) RegisterMagickInfo(entry);
 239   entry=SetMagickInfo("G3");
 240   entry->decoder=(DecodeImageHandler *) ReadFAXImage;
 241   entry->encoder=(EncodeImageHandler *) WriteFAXImage;
 242   entry->magick=(IsImageFormatHandler *) IsFAX;
 243   entry->flags^=Adjoin;
 244   entry->description=ConstantString("Group 3 FAX");
 245   entry->module=ConstantString("FAX");
 246   (void) RegisterMagickInfo(entry);
 247   return(MagickImageCoderSignature);
 248 }
 249 \f
 250 /*
 251 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 252 %                                                                             %
 253 %                                                                             %
 254 %                                                                             %
 255 %   U n r e g i s t e r F A X I m a g e                                       %
 256 %                                                                             %
 257 %                                                                             %
 258 %                                                                             %
 259 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 260 %
 261 %  UnregisterFAXImage() removes format registrations made by the
 262 %  FAX module from the list of supported formats.
 263 %
 264 %  The format of the UnregisterFAXImage method is:
 265 %
 266 %      UnregisterFAXImage(void)
 267 %
 268 */
 269 ModuleExport void UnregisterFAXImage(void)
 270 {
 271   (void) UnregisterMagickInfo("FAX");
 272   (void) UnregisterMagickInfo("G3");
 273 }
 274 \f
 275 /*
 276 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 277 %                                                                             %
 278 %                                                                             %
 279 %                                                                             %
 280 %   W r i t e F A X I m a g e                                                 %
 281 %                                                                             %
 282 %                                                                             %
 283 %                                                                             %
 284 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 285 %
 286 %  WriteFAXImage() writes an image to a file in 1 dimensional Huffman encoded
 287 %  format.
 288 %
 289 %  The format of the WriteFAXImage method is:
 290 %
 291 %      MagickBooleanType WriteFAXImage(const ImageInfo *image_info,
 292 %        Image *image,ExceptionInfo *exception)
 293 %
 294 %  A description of each parameter follows.
 295 %
 296 %    o image_info: the image info.
 297 %
 298 %    o image:  The image.
 299 %
 300 %    o exception: return any errors or warnings in this structure.
 301 %
 302 */
 303 static MagickBooleanType WriteFAXImage(const ImageInfo *image_info,Image *image,
 304   ExceptionInfo *exception)
 305 {
 306   ImageInfo
 307     *write_info;
 308
 309   MagickBooleanType
 310     status;
 311
 312   MagickOffsetType
 313     scene;
 314
 315   /*
 316     Open output image file.
 317   */
 318   assert(image_info != (const ImageInfo *) NULL);
 319   assert(image_info->signature == MagickSignature);
 320   assert(image != (Image *) NULL);
 321   assert(image->signature == MagickSignature);
 322   if (image->debug != MagickFalse)
 323     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
 324   assert(exception != (ExceptionInfo *) NULL);
 325   assert(exception->signature == MagickSignature);
 326   status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
 327   if (status == MagickFalse)
 328     return(status);
 329   write_info=CloneImageInfo(image_info);
 330   (void) CopyMagickString(write_info->magick,"FAX",MaxTextExtent);
 331   scene=0;
 332   do
 333   {
 334     /*
 335       Convert MIFF to monochrome.
 336     */
 337     (void) TransformImageColorspace(image,sRGBColorspace,exception);
 338     status=HuffmanEncodeImage(write_info,image,image,exception);
 339     if (GetNextImageInList(image) == (Image *) NULL)
 340       break;
 341     image=SyncNextImageInList(image);
 342     status=SetImageProgress(image,SaveImagesTag,scene++,
 343       GetImageListLength(image));
 344     if (status == MagickFalse)
 345       break;
 346   } while (write_info->adjoin != MagickFalse);
 347   write_info=DestroyImageInfo(write_info);
 348   (void) CloseBlob(image);
 349   return(status);
 350 }