ruby-iup 0.0.2 → 0.1.0

data/ext/iup-mswin32/include/im_dib.h

@@ -0,0 +1,195 @@
+/** \file
+ * \brief Windows DIB (Device Independent Bitmap)
+ *
+ * See Copyright Notice in im_lib.h
+ */
+
+#ifndef __IM_DIB_H
+#define __IM_DIB_H
+
+#if	defined(__cplusplus)
+extern "C" {
+#endif
+
+
+/** \defgroup dib Windows DIB
+ *
+ * \par
+ * Windows DIBs in memory are handled just like a BMP file without the file header. \n
+ * These functions will work only in Windows. They are usefull for interchanging data 
+ * with the clipboard, with capture drivers, with the AVI and WMF file formats and others.
+ * \par
+ * Supported DIB aspects:
+ * \li bpp must be 1, 4, 8, 16, 24, or 32.
+ * \li BITMAPV4HEADER or BITMAPV5HEADER are handled but ignored. \n
+ * \li BITMAPCOREHEADER is not handled .
+ * \li BI_JPEG and BI_PNG compressions are not handled. 
+ * \li biHeight can be negative, compression can be RLE only if created
+ *   from imDibCreateReference, imDibPasteClipboard, imDibLoadFile. 
+ * \li can not encode/decode Images to/from RLE compressed Dibs. 
+ * \li if working with RLE Dibs bits_size is greatter than used. 
+ * \li the resolution of a new Dib is taken from the screen. 
+ * \li SetDIBitsToDevice(start_scan is 0, scan_lines is dib->bmih->biHeight).  
+ * \li StretchDIBits(use always DIB_RGB_COLORS). 
+ * \li CreateDIBPatternBrushPt(packed_dib is dib->dib). 
+ * \par
+ * Must include <windows.h> before using these functions. \n 
+ * Check <wingdi.h> for structures and definitions. 
+ * \par
+ * See \ref im_dib.h
+ * \ingroup util */
+
+
+/** \brief Windows DIB Structure
+ *
+ * \par
+ * Handles a DIB in memory. \n
+ * The DIB is stored in only one buffer.
+ * The secondary members are pointers to the main buffer.
+ * \ingroup dib */
+typedef struct _imDib 
+{
+  HGLOBAL           handle;        /**< The windows memory handle */
+  BYTE*             dib;           /**< The DIB as it is defined in memory */
+  int               size;          /**< Full size in memory */
+                                  
+  BITMAPINFO*       bmi;           /**< Bitmap Info = Bitmap Info Header + Palette */
+  BITMAPINFOHEADER* bmih;          /**< Bitmap Info Header */
+  RGBQUAD*          bmic;          /**< Bitmap Info Colors = Palette */
+  BYTE*             bits;	         /**< Bitmap Bits */
+                                  
+  int               palette_count; /**< number of colors in the palette */
+  int               bits_size;     /**< size in bytes of the Bitmap Bits */
+  int               line_size;     /**< size in bytes of one line, includes padding */
+  int               pad_size;      /**< number of bytes remaining in the line, lines are in a word boundary */
+                                  
+  int               is_reference;  /**< only a reference, do not free pointer */
+} imDib; 
+
+/** Creates a new DIB. \n
+ * use bpp=-16/-32 to allocate space for BITFLIEDS.
+ * \ingroup dib */
+imDib* imDibCreate(int width, int height, int bpp);     
+
+/** Duplicates the DIB contents in a new DIB.
+ * \ingroup dib */
+imDib* imDibCreateCopy(const imDib* dib);
+
+/** Creates a DIB using an already allocated memory. \n
+ * "bmi" must be a pointer to BITMAPINFOHEADER. \n
+ * "bits" can be NULL if it is inside "bmi" after the palette.
+ * \ingroup dib */
+imDib* imDibCreateReference(BYTE* bmi, BYTE* bits);     
+
+/** Creates a DIB section for drawing porposes. \n
+ * Returns the image handle also created.
+ * \ingroup dib */
+imDib* imDibCreateSection(HDC hDC, HBITMAP *image, int width, int height, int bpp);
+
+/** Destroy the DIB
+ * \ingroup dib */
+void imDibDestroy(imDib* dib);                                 
+
+/** DIB GetPixel function definition. \n 
+ * the DWORD is a raw copy of the bits, use (unsigned char*)&pixel
+ * \ingroup dib */
+typedef unsigned int (*imDibLineGetPixel)(unsigned char* line, int col);
+
+/** Returns a function to read pixels from a DIB line.
+ * \ingroup dib */
+imDibLineGetPixel imDibLineGetPixelFunc(int bpp);  
+
+/** DIB SetPixel function definition
+ * \ingroup dib */
+typedef void (*imDibLineSetPixel)(unsigned char* line, int col, unsigned int pixel);
+
+/** Returns a function to write pixels into a DIB line.
+ * \ingroup dib */
+imDibLineSetPixel imDibLineSetPixelFunc(int bpp);  
+
+/** Creates a DIB from a image handle and a palette handle.
+ * \ingroup dib */
+imDib* imDibFromHBitmap(const HBITMAP image, const HPALETTE hPalette); 
+
+/** Creates a image handle from a DIB.
+ * \ingroup dib */
+HBITMAP imDibToHBitmap(const imDib* dib);
+
+/** Returns a Logical palette from the DIB palette. \n
+ * DIB bpp must be <=8.
+ * \ingroup dib */
+HPALETTE imDibLogicalPalette(const imDib* dib);
+
+/** Captures the screen into a DIB.
+ * \ingroup dib */
+imDib* imDibCaptureScreen(int x, int y, int width, int height);
+
+/** Transfer the DIB to the clipboard. \n 
+ * "dib" pointer can not be used after, or use imDibCopyClipboard(imDibCreateCopy(dib)).
+ * Warning: Clipboard functions in C++ can fail with Visual C++ /EHsc (Enable C++ Exceptions)
+* \ingroup dib */
+void imDibCopyClipboard(imDib* dib); 
+
+/** Creates a reference for the DIB in the clipboard if any. Returns NULL otherwise.
+ * Warning: Clipboard functions in C++ can fail with Visual C++ /EHsc (Enable C++ Exceptions)
+ * \ingroup dib */
+imDib* imDibPasteClipboard(void);           
+
+/** Checks if there is a dib at the clipboard.
+ * \ingroup dib */
+int imDibIsClipboardAvailable(void);
+
+/** Saves the DIB into a file ".bmp".
+ * \ingroup dib */
+int imDibSaveFile(const imDib* dib, const char* filename);
+
+/** Creates a DIB from a file ".bmp".
+ * \ingroup dib */
+imDib* imDibLoadFile(const char* filename);
+
+/** Converts a DIB into an RGBA image. alpha is optional. bpp must be >8. \n 
+ * alpha is used only when bpp=32.
+ * \ingroup dib */
+void imDibDecodeToRGBA(const imDib* dib, unsigned char* red, unsigned char* green, unsigned char* blue, unsigned char* alpha);
+
+/** Converts a DIB into an indexed image. bpp must be <=8. colors must have room for at least 256 colors. 
+ * colors is rgb packed (RGBRGBRGB...)
+ * \ingroup dib */
+void imDibDecodeToMap(const imDib* dib, unsigned char* map, long* palette);
+
+/** Converts an RGBA image into a DIB. alpha is optional. bpp must be >8. \n
+ * alpha is used only when bpp=32.
+ * \ingroup dib */
+void imDibEncodeFromRGBA(imDib* dib, const unsigned char* red, const unsigned char* green, const unsigned char* blue, const unsigned char* alpha);
+
+/** Converts an indexed image into a DIB. bpp must be <=8. \n
+ * colors is rgb packed (RGBRGBRGB...)
+ * \ingroup dib */
+void imDibEncodeFromMap(imDib* dib, const unsigned char* map, const long* palette, int palette_count);
+
+/** Converts a IM_RGB packed image, with or without alpha, into a DIB.
+ * \ingroup dib */
+void imDibEncodeFromBitmap(imDib* dib, const unsigned char* data);
+
+/** Converts a DIB into IM_RGB packed image, with or without alpha.
+ * \ingroup dib */
+void imDibDecodeToBitmap(const imDib* dib, unsigned char* data);
+
+#ifdef __IM_IMAGE_H
+/* You must include "im_image.h" before this header to enable these declarations. */
+
+/** Creates a imImage from the dib data.
+ * \ingroup dib */
+imImage* imDibToImage(const imDib* dib);
+
+/** Creates a Dib from the image. It must be a bitmap image.
+ * \ingroup dib */
+imDib* imDibFromImage(const imImage* image);
+
+#endif
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif

data/ext/iup-mswin32/include/im_file.h

@@ -0,0 +1,115 @@
+/** \file
+ * \brief File Access
+ *
+ * See Copyright Notice in im_lib.h
+ */
+
+#ifndef __IM_FILE_H
+#define __IM_FILE_H
+
+#include "im.h"
+
+#if	defined(__cplusplus)
+extern "C" {
+#endif
+
+
+/** \defgroup filesdk File Format SDK
+ * \par
+ * All the file formats are based on theses structures. Use them to create new file formats. \n
+ * The LineBuffer functions will help transfer image from format buffer to application buffer and vice-versa.
+ * \par
+ * See \ref im_file.h
+ * \ingroup file */
+
+
+/** \brief Image File Format Base Class (SDK Use Only)
+ *
+ * \par
+ * Base container to hold format independent state variables.
+ * \ingroup filesdk */
+struct _imFile
+{
+  int is_new;
+  void* attrib_table;    /**< in fact is a imAttribTable, but we hide this here */
+
+  void* line_buffer;     /**< used for line convertion, contains all components if packed, or only one if not */
+  int line_buffer_size;
+  int line_buffer_extra; /**< extra bytes to be allocated */
+  int line_buffer_alloc; /**< total allocated so far */
+  int counter;
+
+  int convert_bpp;       /**< number of bpp to unpack/pack to/from 1 byte. 
+                              When reading converts n packed bits to 1 byte (unpack). If n>1 will also expand to 0-255. 
+                              When writing converts 1 byte to 1 bit (pack). 
+                              If negative will only expand to 0-255 (no unpack or pack). */
+  int switch_type;       /**< flag to switch the original data type: char-byte, short-ushort, uint-int, double-float */
+
+  long palette[256];
+  int palette_count;
+
+  int user_color_mode,
+      user_data_type,
+      file_color_mode,   /* these two must be filled by te driver always. */
+      file_data_type;
+
+  /* these must be filled by the driver when reading,
+     and given by the user when writing. */
+
+  char compression[10];
+  int image_count,
+      image_index,
+      width,           
+      height;
+};
+
+
+/* Internal Use only */
+
+/* Initializes the imFile structure.
+ * Used by the special format RAW. */
+void imFileClear(imFile* ifile);
+
+/* Initializes the line buffer.
+ * Used by "im_file.cpp" only. */
+void imFileLineBufferInit(imFile* ifile);
+
+/* Check if the conversion is valid.
+ * Used by "im_file.cpp" only. */
+int imFileCheckConversion(imFile* ifile);
+
+
+/* File Format SDK */
+
+/** Number of lines to be accessed.
+ * \ingroup filesdk */
+int imFileLineBufferCount(imFile* ifile);
+
+/** Increments the row and plane counters.
+ * \ingroup filesdk */
+void imFileLineBufferInc(imFile* ifile, int *row, int *plane);
+
+/** Converts from FILE color mode to USER color mode.
+ * \ingroup filesdk */
+void imFileLineBufferRead(imFile* ifile, void* data, int line, int plane);
+
+/** Converts from USER color mode to FILE color mode.
+ * \ingroup filesdk */
+void imFileLineBufferWrite(imFile* ifile, const void* data, int line, int plane);
+
+/** Utility to calculate the line size in byte with a specified alignment. \n
+ * "align" can be 1, 2 or 4.
+ * \ingroup filesdk */
+int imFileLineSizeAligned(int width, int bpp, int align);
+
+/** Set the attributes FileFormat, FileCompression and FileImageCount. \n
+ * Used in imFileOpen and imFileOpenAs, and after the attribute list cleared with RemoveAll.
+ * \ingroup filesdk */
+void imFileSetBaseAttributes(imFile* ifile);
+
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif

data/ext/iup-mswin32/include/im_format.h

@@ -0,0 +1,97 @@
+/** \file
+ * \brief File Format Access
+ *
+ * See Copyright Notice in im_lib.h
+ */
+
+#include "im_file.h"
+#include "im_attrib.h"
+
+#ifndef __IM_FORMAT_H
+#define __IM_FORMAT_H
+
+
+class imFormat;
+
+/** \brief Image File Format Virtual Class (SDK Use Only) 
+ * 
+ * \par
+ * Virtual Base class for file formats. All file formats inherit from this class.
+ * \ingroup filesdk */
+class imFileFormatBase: public _imFile
+{
+public:
+  const imFormat* iformat;
+
+  imFileFormatBase(const imFormat* _iformat): iformat(_iformat) {}
+  virtual ~imFileFormatBase() {}
+
+  imAttribTable* AttribTable() {return (imAttribTable*)this->attrib_table;}
+
+  /* Pure Virtual Methods. Every driver must implement all the following methods. */
+
+  virtual int Open(const char* file_name) = 0; // Must initialize compression and image_count
+  virtual int New(const char* file_name) = 0;
+  virtual void Close() = 0;
+  virtual void* Handle(int index) = 0;
+  virtual int ReadImageInfo(int index) = 0;    // Should update compression
+  virtual int ReadImageData(void* data) = 0;
+  virtual int WriteImageInfo() = 0;            // Should update compression
+  virtual int WriteImageData(void* data) = 0;  // Must update image_count
+};
+
+/** \brief Image File Format Descriptor (SDK Use Only) 
+ * 
+ * \par
+ * All file formats must define these informations. They are stored by \ref imFormatRegister.
+ * \ingroup filesdk */
+class imFormat
+{
+public:
+  const char* format; 
+  const char* desc;
+  const char* ext;
+  const char** comp;
+  int comp_count, 
+      can_sequence;
+
+  virtual imFileFormatBase* Create() const = 0;
+  virtual int CanWrite(const char* compression, int color_mode, int data_type) const = 0;
+
+  imFormat(const char* _format, const char* _desc, const char* _ext, 
+           const char** _comp, int _comp_count, int _can_sequence)
+    :format(_format), desc(_desc), ext(_ext), comp(_comp), 
+     comp_count(_comp_count), can_sequence(_can_sequence)
+    {} 
+  virtual ~imFormat() {}
+};
+
+extern "C"
+{
+
+/* Internal Use only */
+
+/* Opens a file with the respective format driver 
+ * Uses the file extension to speed up the search for the format driver.
+ * Used by "im_file.cpp" only. */
+imFileFormatBase* imFileFormatBaseOpen(const char* file_name, int *error);
+
+/* Opens a file with the given format
+ * Used by "im_file.cpp" only. */
+imFileFormatBase* imFileFormatBaseOpenAs(const char* file_name, const char* format, int *error);
+
+/* Creates a file using the given format driver.
+ * Used by "im_file.cpp" only. */
+imFileFormatBase* imFileFormatBaseNew(const char* file_name, const char* format, int *error);
+
+
+/* File Format SDK */
+
+/** Register a format driver.
+ * \ingroup filesdk */
+void imFormatRegister(imFormat* iformat);
+
+
+}
+
+#endif

data/ext/iup-mswin32/include/im_format_all.h

@@ -0,0 +1,575 @@
+/** \file
+ * \brief All the Internal File Formats.
+ * They are all automatically registered by the library.
+ * The signatures are in C, but the functions are C++.
+ * Header for internal use only.
+ *
+ * See Copyright Notice in im_lib.h
+ */
+
+#ifndef __IM_FORMAT_ALL_H
+#define __IM_FORMAT_ALL_H
+
+#if	defined(__cplusplus)
+extern "C" {
+#endif
+
+/** \defgroup tiff TIFF - Tagged Image File Format
+ * \section Description
+ *
+ * \par
+ * Copyright (c) 1986-1988, 1992 by Adobe Systems Incorporated. \n
+ * Originally created by a group of companies,
+ * the Aldus Corporation keeped the copyright until Aldus was aquired by Adobe. \n
+ * TIFF Revision 6.0 Final � June 3, 1992 \n
+ * http://www.adobe.com/Support/TechNotes.html
+ * \par
+ * Access to the TIFF file format uses libTIFF version 3.9.2 \n
+ * http://www.remotesensing.org/libtiff/                     \n
+ * Copyright (c) 1988-1997 Sam Leffler                      \n
+ * Copyright (c) 1991-1997 Silicon Graphics, Inc.           \n
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: <all>
+    Color Spaces: Gray, RGB, CMYK, YCbCr, Lab, XYZ, Map and Binary.
+    Compressions:
+      NONE - no compression  [default for IEEE Floating Point Data]
+      CCITTRLE - CCITT modified Huffman RLE (binary only) [default for Binary]
+      CCITTFAX3 - CCITT Group 3 fax         (binary only)
+      CCITTFAX4 - CCITT Group 4 fax         (binary only)
+      LZW - Lempel-Ziv & Welch  [default]
+      JPEG - ISO JPEG    [default for YCBCR]
+      NEXT - NeXT 2-bit RLE (2 bpp only)
+      CCITTRLEW - CCITT modified Huffman RLE with word alignment (binary only)
+      RLE - Packbits (Macintosh RLE) [default for MAP]
+      THUNDERSCAN - ThunderScan 4-bit RLE (only for 2 or 4 bpp)
+      PIXARLOG - Pixar companded 11-bit ZIP (only byte, ushort and float)
+      DEFLATE - LZ77 variation (ZIP)
+      ADOBE_DEFLATE - Adobe LZ77 variation
+      SGILOG - SGI Log Luminance RLE for L and Luv (only byte, ushort and float) [default for XYZ]
+      SGILOG24 - SGI Log 24-bit packed for Luv (only byte, ushort and float)
+    Can have more than one image.
+    Can have an alpha channel.
+    Components can be packed or not.
+    Lines arranged from top down to bottom or bottom up to top.
+    Handle(1) returns a TIFF* libTIFF structure.
+
+    Attributes:
+      Photometric IM_USHORT (1) (when writing this will complement the color_mode information, for Mask, MinIsWhite, ITULab and ICCLab)
+      ExtraSampleInfo IM_USHORT (1) (description of alpha channel: 0- uknown, 1- pre-multiplied, 2-normal)
+      JPEGQuality IM_INT (1) [0-100, default 75] (write only)
+      ZIPQuality IM_INT (1) [1-9, default 6] (write only)
+      ResolutionUnit (string) ["DPC", "DPI"]
+      XResolution, YResolution IM_FLOAT (1)
+      Description, Author, Copyright, DateTime, DocumentName,
+      PageName, TargetPrinter, Make, Model, Software, HostComputer (string)
+      InkNames (strings separated by '0's)
+      InkSet IM_USHORT (1)
+      NumberOfInks IM_USHORT (1)
+      DotRange IM_USHORT (2)
+      TransferFunction0, TransferFunction1, TransferFunction3 IM_USHORT [gray=0, rgb=012]
+      ReferenceBlackWhite IMFLOAT (6)
+      WhitePoint IMFLOAT (2)
+      PrimaryChromaticities  IMFLOAT (6)
+      YCbCrCoefficients IM_FLOAT (3)
+      YCbCrSubSampling IM_USHORT (2)
+      YCbCrPositioning IM_USHORT (1)
+      PageNumber IM_USHORT (2)
+      StoNits IM_FLOAT (1)
+      XPosition, YPosition IM_FLOAT (1)
+      SMinSampleValue, SMaxSampleValue IM_FLOAT (1)
+      HalftoneHints IM_USHORT (2)
+      SubfileType IM_INT (1)
+      ICCProfile IM_BYTE (N)
+      MultiBandCount IM_USHORT (1)    [Number of bands in a multiband gray image.]
+      MultiBandSelect IM_USHORT (1)   [Band number to read one band of a multiband gray image. Must be set before reading image info.]
+      and other TIFF tags as they are described in the TIFF documentation.
+      GeoTIFF tags:
+        GeoTiePoints, GeoTransMatrix, IntergraphMatrix, GeoPixelScale, GeoDoubleParams IM_FLOAT (N)
+        GeoASCIIParams (string)
+      Read-only support for EXIF tags as they are described in the EXIF 2.2 documentation. See http://www.exif.org/
+      DNG tags as they are described in the DNG documentation. See http://www.adobe.com/br/products/dng/
+        Tags BlackLevel, DefaultCropOrigin and DefaultCropSize are incorrectly interpreted by libTIFF so they are ignored.
+        Raw image is loaded in place of the thumbnail image in the main IFD.
+        SubIFDCount IM_USHORT (1)    [Number of subifds of the current image.]
+        SubIFDSelect IM_USHORT (1)   [Subifd number to be read. Must be set before reading image info.]
+      (other attributes can be obtained by using libTIFF directly using the Handle(1) function)
+
+    Comments:
+      LogLuv is in fact Y'+CIE(u,v), so we choose to always convert it to XYZ.
+      SubIFD is handled only for DNG.
+      Since LZW patent expired, LZW compression is enabled. LZW Copyright Unisys.
+      libGeoTIFF can be used without XTIFF initialization. Use Handle(1) to obtain a TIFF*.
+
+    Changes:
+      "tiff_jpeg.c" - commented "downsampled_output = TRUE" in 2 places.
+      A few fixes in some files, search for "IMLIB" to see the changes.
+      New file "tif_config.h" to match our needs.
+      New file "tiff_binfile.c" that implement I/O rotines using imBinFile.
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterTIFF(void);
+
+/** \defgroup jpeg JPEG - JPEG File Interchange Format
+ * \section Description
+ *
+ * \par
+ * ISO/IEC 10918 (1994, 1995, 1997, 1999)\n
+ * http://www.jpeg.org/
+ * \par
+ * Access to the JPEG file format uses libJPEG version 7. \n
+ * http://www.ijg.org                                      \n
+ * Copyright (C) 1994-2009, Thomas G. Lane, Guido Vollbeding  \n
+ *   from the Independent JPEG Group.
+ * \par
+ * Access to the EXIF attributes uses libEXIF version 0.6.17. \n
+ * http://sourceforge.net/projects/libexif                    \n
+ * Copyright (C) 2001-2003, Lutz M�ller
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte
+    Color Spaces: Gray, RGB, CMYK and YCbCr (Binary Saved as Gray)
+    Compressions:
+      JPEG - ISO JPEG  [default]
+    Only one image.
+    No alpha channel.
+    Internally the components are always packed.
+    Internally the lines are arranged from top down to bottom.
+    Handle(1) returns jpeg_decompress_struct* when reading, and
+                      jpeg_compress_struct* when writing (libJPEG structures).
+
+    Attributes:
+      AutoYCbCr IM_INT (1) (controls YCbCr auto conversion) default 1
+      JPEGQuality IM_INT (1) [0-100, default 75] (write only)
+      ResolutionUnit (string) ["DPC", "DPI"]
+      XResolution, YResolution IM_FLOAT (1)
+      Interlaced (same as Progressive) IM_INT (1 | 0) default 0
+      Description (string)
+      (lots of Exif tags)
+
+    Changes to libJPEG:
+      jdatadst.c - fflush and ferror replaced by macros JFFLUSH and JFERROR.
+      jinclude.h - standard JFFLUSH and JFERROR definitions, and new macro HAVE_JFIO.
+      jdhuf.c - added support for OJPEG_SUPPORT in libTIFF.
+      new file created: jconfig.h
+
+    Changes to libEXIF:
+      new files config.h and _stdint.h
+      changed "exif-tag.c" to add new function
+      changed "exif-entry.c" to improve exif_entry_initialize
+
+    Comments:
+      Other APPx markers are ignored.
+      No thumbnail support.
+      RGB images are automatically converted to YCbCr when saved.
+      Also YcbCr are converted to RGB when loaded. Use AutoYCbCr=0 to disable this behavior.
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterJPEG(void);
+
+/** \defgroup png PNG - Portable Network Graphic Format
+ * \section Description
+ *
+ * \par
+ * Access to the PNG file format uses libPNG version 1.2.39. \n
+ * http://www.libpng.org                                    \n
+ * Copyright (C) 1998-2009 Glenn Randers-Pehrson
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte and UShort
+    Color Spaces: Gray, RGB, MAP and Binary
+    Compressions:
+      DEFLATE - LZ77 variation (ZIP) [default]
+    Only one image.
+    Can have an alpha channel.
+    Internally the components are always packed.
+    Internally the lines are arranged from top down to bottom.
+    Handle(1) returns png_structp libPNG structure.
+
+    Attributes:
+      ZIPQuality IM_INT (1) [1-9, default 6] (write only)
+      ResolutionUnit (string) ["DPC", "DPI"]
+      XResolution, YResolution IM_FLOAT (1)
+      Interlaced (same as Progressive) IM_INT (1 | 0) default 0
+      Gamma IM_FLOAT (1)
+      WhitePoint IMFLOAT (2)
+      PrimaryChromaticities  IMFLOAT (6)
+      XPosition, YPosition IM_FLOAT (1)
+      sRGBIntent IM_INT (1) [0: Perceptual, 1: Relative colorimetric, 2: Saturation, 3: Absolute colorimetric]
+      TransparencyMap IM_BYTE (N) (for MAP images is the alpha value of the corresponding palette index)
+      TransparencyIndex IM_BYTE (1) (for MAP images is the first index that has minimum alpha in TransparencyMap, for GRAY images is the index that it is fully transparent)
+      TransparencyColor IM_BYTE (3) (for RGB images is the color that is full transparent)
+      CalibrationName, CalibrationUnits (string)
+      CalibrationLimits IM_INT (2)
+      CalibrationEquation IM_BYTE (1) [0-Linear,1-Exponential,2-Arbitrary,3-HyperbolicSine)]
+      CalibrationParam (string) [params separated by '\\n']
+      Title, Author, Description, Copyright, DateTime (string)
+      Software, Disclaimer, Warning, Source, Comment, ...       (string)
+      DateTimeModified (string) [when writing uses the current system time]
+      ICCProfile IM_BYTE (N)
+      ScaleUnit (string) ["meters", "radians"]
+      XScale, YScale IM_FLOAT (1)
+
+    Comments:
+      When saving PNG image with TransparencyIndex or TransparencyMap, TransparencyMap has precedence, so set it to NULL if you changed TransparencyIndex.
+      Attributes after the image are ignored.
+      Define PNG_NO_CONSOLE_IO to avoid printfs. We also define PNG_TIME_RFC1123_SUPPORTED.
+      Added the following files to the makefile to optimize the library:
+      pngvcrd.c  - PNG_USE_PNGVCRD
+                   For Intel x86 CPU and Microsoft Visual C++ compiler
+      pnggccrd.c - PNG_USE_PNGGCCRD
+                   For Intel x86 CPU (Pentium-MMX or later) and GNU C compiler.
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterPNG(void);
+
+/** \defgroup gif GIF - Graphics Interchange Format
+ * \section Description
+ *
+ * \par
+ * Copyright (c) 1987,1988,1989,1990 CompuServe Incorporated. \n
+ * GIF is a Service Mark property of CompuServe Incorporated. \n
+ * Graphics Interchange Format Programming Reference, 1990. \n
+ * LZW Copyright Unisys.
+ * \par
+ * Patial Internal Implementation. \n
+ * Decoding and encoding code were extracted from GIFLib 1.0. \n
+ * Copyright (c) 1989 Gershon Elber.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte
+    Color Spaces: MAP only, (Gray and Binary saved as MAP)
+    Compressions:
+      LZW - Lempel-Ziv & Welch      [default]
+    Can have more than one image.
+    No alpha channel.
+    Internally the lines are arranged from top down to bottom.
+
+    Attributes:
+      ScreenHeight, ScreenWidth IM_USHORT (1) screen size [default to the first image size]
+      Interlaced IM_INT (1 | 0) default 0
+      Description (string)
+      TransparencyIndex IM_BYTE (1)
+      XScreen, YScreen IM_USHORT (1) screen position
+      UserInput IM_BYTE (1) [1, 0]
+      Disposal (string) [UNDEF, LEAVE, RBACK, RPREV]
+      Delay IM_USHORT (1) [time to wait betweed frames in 1/100 of a second]
+      Iterations IM_USHORT (1) (NETSCAPE2.0 Application Extension) [The number of times to repeat the animation. 0 means to repeat forever. ]
+
+    Comments:
+      Attributes after the last image are ignored.
+      Reads GIF87 and GIF89, but writes GIF89 always.
+      Ignored attributes: Background Color Index, Pixel Aspect Ratio,
+                          Plain Text Extensions, Application Extensions...
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterGIF(void);
+
+/** \defgroup bmp BMP - Windows Device Independent Bitmap
+ * \section Description
+ *
+ * \par
+ * Windows Copyright Microsoft Corporation.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte
+    Color Spaces: RGB, MAP and Binary (Gray saved as MAP)
+    Compressions:
+      NONE - no compression [default]
+      RLE  - Run Lenght Encoding (only for MAP and Gray)
+    Only one image.
+    Can have an alpha channel (only for RGB)
+    Internally the components are always packed.
+    Lines arranged from top down to bottom or bottom up to top. But are saved always as bottom up.
+
+    Attributes:
+      ResolutionUnit (string) ["DPC", "DPI"]
+      XResolution, YResolution IM_FLOAT (1)
+
+    Comments:
+      Reads OS2 1.x and Windows 3, but writes Windows 3 always.
+      Version 4 and 5 BMPs are not supported.
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterBMP(void);
+
+/** \defgroup ras RAS - Sun Raster File
+ * \section Description
+ *
+ * \par
+ * Copyright Sun Corporation.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte
+    Color Spaces: Gray, RGB, MAP and Binary
+    Compressions:
+      NONE - no compression   [default]
+      RLE  - Run Lenght Encoding
+    Only one image.
+    Can have an alpha channel (only for IM_RGB)
+    Internally the components are always packed.
+    Internally the lines are arranged from top down to bottom.
+
+    Attributes:
+      none
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterRAS(void);
+
+/** \defgroup led LED - IUP image in LED
+ * \section Description
+ *
+ * \par
+ * Copyright Tecgraf/PUC-Rio and PETROBRAS/CENPES.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte
+    Color Spaces: MAP only (Gray and Binary saved as MAP)
+    Compressions:
+      NONE - no compression  [default]
+    Only one image.
+    No alpha channel.
+    Internally the lines are arranged from top down to bottom.
+
+    Attributes:
+      none
+
+    Comments:
+      LED file must start with "LEDImage = IMAGE[".
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterLED(void);
+
+/** \defgroup sgi SGI - Silicon Graphics Image File Format
+ * \section Description
+ *
+ * \par
+ * SGI is a trademark of Silicon Graphics, Inc.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte and UShort
+    Color Spaces: Gray and RGB (Binary saved as Gray, MAP with fixed palette when reading only)
+    Compressions:
+      NONE - no compression  [default]
+      RLE  - Run Lenght Encoding
+    Only one image.
+    Can have an alpha channel (only for IM_RGB)
+    Internally the components are always packed.
+    Internally the lines are arranged from bottom up to top.
+
+    Attributes:
+      Description (string)
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterSGI(void);
+
+/** \defgroup pcx PCX - ZSoft Picture
+ * \section Description
+ *
+ * \par
+ * Copyright ZSoft Corporation. \n
+ * ZSoft (1988) PCX Technical Reference Manual.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte
+    Color Spaces: RGB, MAP and Binary (Gray saved as MAP)
+    Compressions:
+      NONE - no compression
+      RLE  - Run Lenght Encoding [default - since uncompressed PCX is not well supported]
+    Only one image.
+    No alpha channel.
+    Internally the components are always packed.
+    Internally the lines are arranged from top down to bottom.
+
+    Attributes:
+      ResolutionUnit (string) ["DPC", "DPI"]
+      XResolution, YResolution IM_FLOAT (1)
+      XScreen, YScreen IM_USHORT (1) screen position
+
+    Comments:
+      Reads Versions 0-5, but writes Version 5 always.
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterPCX(void);
+
+/** \defgroup tga TGA - Truevision Graphics Adapter File
+ * \section Description
+ *
+ * \par
+ * Truevision TGA File Format Specification Version 2.0 \n
+ * Technical Manual Version 2.2 January, 1991           \n
+ * Copyright 1989, 1990, 1991 Truevision, Inc.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Supports 8 bits per component only. Data type is always Byte.
+    Color Spaces: Gray, RGB and MAP (Binary saved as Gray)
+    Compressions:
+      NONE - no compression [default]
+      RLE  - Run Lenght Encoding
+    Only one image.
+    No alpha channel.
+    Internally the components are always packed.
+    Internally the lines are arranged from bottom up to top or from top down to bottom.
+
+    Attributes:
+      XScreen, YScreen IM_USHORT (1) screen position
+      Title, Author, Description, JobName, Software (string)
+      SoftwareVersion (read only) (string)
+      DateTimeModified (string) [when writing uses the current system time]
+      Gamma IM_FLOAT (1)
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterTGA(void);
+
+/** \defgroup pnm PNM - Netpbm Portable Image Map
+ * \section Description
+ *
+ * \par
+ * PNM formats Copyright Jef Poskanzer
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte and UShort
+    Color Spaces: Gray, RGB and Binary
+    Compressions:
+      NONE - no compression [default]
+      ASCII (textual data)
+    Can have more than one image, but sequencial access only.
+    No alpha channel.
+    Internally the components are always packed.
+    Internally the lines are arranged from top down to bottom.
+
+    Attributes:
+      Description (string)
+
+    Comments:
+      In fact ASCII is an expansion, not a compression, because the file will be larger than binary data.
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterPNM(void);
+
+/** \defgroup ico ICO - Windows Icon
+ * \section Description
+ *
+ * \par
+ * Windows Copyright Microsoft Corporation.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte
+    Color Spaces: RGB, MAP and Binary (Gray saved as MAP)
+    Compressions:
+      NONE - no compression [default]
+    Can have more than one image. But writing is limited to 5 images,
+      and all images must have different sizes and bpp.
+    Can have an alpha channel (only for RGB)
+    Internally the components are always packed.
+    Internally the lines are arranged from bottom up to top.
+
+    Attributes:
+      TransparencyIndex IM_BYTE (1)
+
+    Comments:
+      If the user specifies an alpha channel, the AND mask is loaded as alpha if
+        the file color mode does not contain the IM_ALPHA flag.
+      For MAP imagens, if the user does not specifies an alpha channel
+        the TransparencyIndex is used to initialize the AND mask when writing,
+        and if the user does specifies an alpha channel
+        the most repeated index with transparency will be the transparent index.
+      Although any size and common bpp can be used is recomended to use the typical configurations:
+        16x16, 32x32, 48x48, 64x64 or 96x96
+        2 colors, 16 colors, 256 colors, 24bpp or 32bpp
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterICO(void);
+
+/** \defgroup krn KRN - IM Kernel File Format
+ * \section Description
+ *
+ * \par
+ * Textual format to provied a simple way to create kernel convolution images.
+ * \par
+ * Internal Implementation.
+ *
+ * \section Features
+ *
+\verbatim
+    Data Types: Byte, Int
+    Color Spaces: Gray
+    Compressions:
+      NONE - no compression [default]
+    Only one image.
+    No alpha channel.
+    Internally the lines are arranged from top down to bottom.
+
+    Attributes:
+      Description (string)
+
+    Comments:
+      The format is very simple, inspired by PNM.
+      It was developed because PNM does not have support for INT and FLOAT.
+      Remeber that usually convolution operations use kernel size an odd number.
+
+    Format Model:
+      IMKERNEL
+      Description up to 512 characters
+      width height
+      type (0 - IM_INT, 1 - IM_FLOAT)
+      data...
+
+    Example:
+      IMKERNEL
+      Gradian
+      3 3
+      0
+      0 -1 0
+      0  1 0
+      0  0 0
+\endverbatim
+ * \ingroup format */
+void imFormatRegisterKRN(void);
+
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif