610 lines
20 KiB
C
Executable File
610 lines
20 KiB
C
Executable File
/** \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 kept the copyright until Aldus was acquired 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 4.1.0 \n
|
|
* http://www.simplesystems.org/libtiff/ \n
|
|
* https://libtiff.gitlab.io/libtiff/ \n
|
|
* http://libtiff.maptools.org/ \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_DOUBLE (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, GeoTransformationMatrix, "Intergraph TransformationMatrix", GeoPixelScale, GeoDoubleParams IM_DOUBLE (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" and downsampled_input = TRUE.
|
|
"tiff_fax3.c" - removed "inline"
|
|
"tif_strip.c" - fixed scanline_size
|
|
New files "tif_config.h" and "tifconf.h" to match our needs.
|
|
New file "tiff_binfile.c" that implement I/O rotines using imBinFile.
|
|
Search for "IMLIB" to see the changes.
|
|
These changes can be ignored when using an external libTIFF distribution,
|
|
but in this case the handling of upsampled YCbCr raw data will be compromissed.
|
|
\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 9d. \n
|
|
* http://www.ijg.org \n
|
|
* Copyright (C) 1994-2020, Thomas G. Lane, Guido Vollbeding \n
|
|
* from the Independent JPEG Group.
|
|
* \par
|
|
* Access to the EXIF attributes uses libEXIF version 0.6.21. \n
|
|
* http://sourceforge.net/projects/libexif \n
|
|
* Copyright (C) 2001-2009, Lutz Müller et. al.
|
|
*
|
|
* \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:
|
|
new file created: jconfig.h from jconfig.txt
|
|
These changes can be ignored when using an external libJPEG distribution
|
|
|
|
Changes to libEXIF:
|
|
new files config.h and _stdint.h
|
|
small fixes to improve compilation.
|
|
These changes can be ignored when using an external libEXIF distribution
|
|
|
|
Comments:
|
|
Other APPx markers are ignored.
|
|
No thumbnail support.
|
|
RGB images are automatically converted to YCbCr when saved.
|
|
Also YcbCr are automatically 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.6.23. \n
|
|
* http://www.libpng.org \n
|
|
* Copyright (c) 2000-2002, 2004, 2006-2015 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 set after the image are ignored.
|
|
\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
|
|
Data Types: Byte
|
|
Color Spaces: Gray, RGB and MAP (Binary saved as Gray)
|
|
Compressions:
|
|
NONE - no compression [default]
|
|
RLE - Run Lenght Encoding
|
|
Only one image.
|
|
Can have an alpha channel (only for RGB)
|
|
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 pfm PFM - Portable FloatMap Image Format
|
|
* \section Description
|
|
*
|
|
* \par
|
|
* Internal Implementation.
|
|
*
|
|
* \section Features
|
|
*
|
|
\verbatim
|
|
Data Types: Float
|
|
Color Spaces: Gray and RGB
|
|
Compressions:
|
|
NONE - no compression [default]
|
|
|
|
No alpha channel.
|
|
Internally the components are always packed.
|
|
Internally the lines are arranged from bottom to top.
|
|
|
|
\endverbatim
|
|
* \ingroup format */
|
|
void imFormatRegisterPFM(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 reading and writing is limited to 10 images max,
|
|
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: Int, Float
|
|
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
|