Module: FreeImage::AbstractSource::Encoder

Defined in:
lib/free-image/sources/abstract_source.rb

Overview

The Encoder module defines various constants that control how various image formats are saved.

Note, some image formats, such as JPEG, reserve an optional integer range for setting the quality level. For example, to save a progressive JPEG with a quality of 90 (out of 100), you’d use the following flag 90 | JPEG_PROGRESSIVE. For more information, refer to the FreeImage documentation: freeimage.sourceforge.net/documentation.html.

Constant Summary collapse

BMP_DEFAULT =
0x0
BMP_SAVE_RLE =
0x1
EXR_DEFAULT =

Save data as half with piz-based wavelet compression

0x0
EXR_FLOAT =

Save data as float instead of as half (not recommended)

0x0001
EXR_NONE =

Save with no compression

0x0002
EXR_ZIP =

Save with zlib compression, in blocks of 16 scan lines

0x0004
EXR_PIZ =

Save with piz-based wavelet compression

0x0008
EXR_PXR24 =

Save with lossy 24-bit float compression

0x0010
EXR_B44 =

Save with lossy 44% float compression - goes to 22% when combined with EXR_LC

0x0020
EXR_LC =

Save images with one luminance and two chroma channels, rather than as RGB (lossy compression)

0x0040
J2K_DEFAULT =

Save with a 16:1 rate

0x0
JP2_DEFAULT =

Save with a 16:1 rate

0x0
JPEG_DEFAULT =

Loading (see JPEG_FAST); saving (see JPEG_QUALITYGOOD|JPEG_SUBSAMPLING_420)

0x0
JPEG_QUALITYSUPERB =

Save with superb quality (100:1)

0x80
JPEG_QUALITYGOOD =

Save with good quality (75:1)

0x0100
JPEG_QUALITYNORMAL =

Save with normal quality (50:1)

0x0200
JPEG_QUALITYAVERAGE =

Save with average quality (25:1)

0x0400
JPEG_QUALITYBAD =

Save with bad quality (10:1)

0x0800
JPEG_PROGRESSIVE =

Save as a progressive-JPEG (use | to combine with other save flags)

0x2000
JPEG_SUBSAMPLING_411 =

Save with high 4x1 chroma subsampling (4:1:1)

0x1000
JPEG_SUBSAMPLING_420 =

Save with medium 2x2 medium chroma subsampling (4:2:0) - default value

0x4000
JPEG_SUBSAMPLING_422 =

Save with low 2x1 chroma subsampling (4:2:2)

0x8000
JPEG_SUBSAMPLING_444 =

Save with no chroma subsampling (4:4:4)

0x10000
JPEG_OPTIMIZE =

On saving, compute optimal Huffman coding tables (can reduce a few percent of file size)

0x20000
JPEG_BASELINE =

Save basic JPEG, without metadata or any markers

0x40000
PNG_DEFAULT =
0x0
PNG_Z_BEST_SPEED =

Save using ZLib level 1 compression flag (default value is 6)

0x0001
PNG_Z_DEFAULT_COMPRESSION =

Save using ZLib level 6 compression flag (default recommended value)

0x0006
PNG_Z_BEST_COMPRESSION =

Save using ZLib level 9 compression flag (default value is 6)

0x0009
PNG_Z_NO_COMPRESSION =

Save without ZLib compression

0x0100
PNG_INTERLACED =

Save using Adam7 interlacing (use | to combine with other save flags)

0x0200
PNM_DEFAULT =
0x0
PNM_SAVE_RAW =

If set the writer saves in RAW format (i.e. P4, P5 or P6)

0x0
PNM_SAVE_ASCII =

If set the writer saves in ASCII format (i.e. P1, P2 or P3)

0x1
TARGA_DEFAULT =
0x0
TARGA_SAVE_RLE =

If set, the writer saves with RLE compression

0x2
TIFF_DEFAULT =
0x0
TIFF_CMYK =

Reads/stores tags for separated CMYK (use | to combine with compression flags)

0x0001
TIFF_PACKBITS =

Save using PACKBITS compression

0x0100
TIFF_DEFLATE =

Save using DEFLATE compression (a.k.a. ZLIB compression)

0x0200
TIFF_ADOBE_DEFLATE =

Save using ADOBE DEFLATE compression

0x0400
TIFF_NONE =

Save without any compression

0x0800
TIFF_CCITTFAX3 =

Save using CCITT Group 3 fax encoding

0x1000
TIFF_CCITTFAX4 =

Save using CCITT Group 4 fax encoding

0x2000
TIFF_LZW =

Save using LZW compression

0x4000
TIFF_JPEG =

Save using JPEG compression

0x8000
TIFF_LOGLUV =

Save using LogLuv compression

0x10000