TIFF Writer Feature Type Parameters

To access feature type parameters, click the gear icon on a feature type in the workspace. This opens the Feature Type Parameter Editor.

Tip  To always display the editor in FME Workbench, you can select View > Windows > Parameter Editor.

General

All feature types share similar General parameters, which may include Feature Type Name, Reader or Writer information, and Geometry.

In most Writer Feature Type parameter dialogs, you can also control Dynamic Schema Definitions. Some database formats accept Table or Index Qualifier prefixes on the output table feature type.

Raster

Metadata Files

Enables or disables the generation of an Esri world file along with the output image.

The value can be can be Yes (default) or No.

Enables or disables the generation of a TAB file along with the output image.

The value can be Yes or No (default).

Compression

This option sets the compression to use:

  • JPEG
  • DEFLATE
  • LZW
  • ZSTD
  • Pack Bits
  • CCITT RLE (CCITT modified Huffman run-length encoding)
  • CCITT FAX3 (CCITT Group 3 fax encoding)
  • CCITT FAX4 (CCITT Group 4 fax encoding)

Additional options can be set for JPEG, DEFLATE, and ZSTD compression levels.

JPEG Compression Level

This option sets the desired compression level of the output image. This is expressed as a percentage of the original file size. For example, setting a compression level of 75 means that the output image will be approximately 75% smaller (one-quarter of the size) than an uncompressed image.

Note that this value only represents the targeted compression level, and this may not actually be achieved. JPEG supports both lossy and lossless compression. With lossy compression, the compressed image is an approximation of the original. With lossless compression, the compressed image is identical to the original.

Note: Repeatedly reading and saving files may decrease the quality for this format. In addition, FME Workbench may not know which format data comes from, and whether it used lossy compression. If you know that source data comes from files with lossy compression, you should also set the compression level to 0. Although this compression still does not guarantee the exact copy of the source file, the output will be very close to the original.

DEFLATE Compression Level

DEFLATE Compression Level

DEFLATE is a lossless data compression algorithm that uses a combination of LZ77 algorithm and Huffman coding on each block of data.

Value: 1-9. The default is 6.

ZSTD Compression Level

This option provides a good compression ratio across diverse datasets. ZSTD works well with CHAR and VARCHAR columns that store a wide range of long and short strings, including JSON strings.

Value: 1-22. The default is 9.

Tile

Enables or disables the creation of tiled TIFF images.

By default, this parameter is set to No, and stripped TIFF images are created.

Note: Tiled TIFFs are not as widely supported by other applications as stripped TIFFs.

Specifies the number of columns in a tile. This option only applies when creating a tiled file; strips are required to be the full width of the raster.

This value is required to be a multiple of 16.

If no value is specified, this parameter will be determined from the tile size of the input raster.

Specifies the number of rows in a tile or strip. If no value is specified, this parameter will be determined from the tile size of the input raster.

Note that other parameter options may impact this value:

  • If creating a tiled file, this value must be a multiple of 16.
  • If applying JPEG compression, this value must be a multiple of 8.
  • If applying JPEG compression with a photometric interpretation of YCbCr, this value must be a multiple of 16.

Generate Pyramids

The number of pyramid levels to generate. This setting does not include the original resolution image. Each pyramid level has half the number of rows and columns of the previous level.

The interpolation method used to reduce the image size.

  • Nearest Neighbor is the fastest but produces the poorest image quality.
  • Bilinear provides a reasonable intermediate option.
  • Bicubic is the slowest but produces the best image quality.

The tile size used in the reduced-resolution images.

Advanced

The byte order of the file.

Valid values:

  • MSB
  • LSB
  • machine (This is the default, and it means the native byte order of the machine running FME.)

Specifies whether the writer should calculate the MinSampleValue and MaxSampleValue TIFF tags values from the input raster.

Note: Calculating the min/max values may increase translation time.

Note: If this parameter is set to Yes, the calculated values will override any explicit values specified for tiff_minsamplevalue and tiff_maxsamplevalue.

This parameter allows the writer to produce a file larger than 4GB when the value is set to Yes.

The value can be set to yes or no, or left empty. When the value is set to no or left empty, the writer functions as if this option does not exist. When the value is set to yes, the writer will produce a file with the BigTIFF file structure. Other applications are required to support BigTIFF in order to open the BigTIFF file, even if the file is less than 4GB.

If the value is set to No, BigTIFF support is not enabled.

The organization of the bands in the file.

Acceptable values are BIP, which is band interleaved by pixel, and BSQ, which is band sequential.

BIP may be less efficient for reading and writing by FME, but is more widely supported by other applications. If not specified, the default interleaving is BIP.

Note: This option corresponds to the PlanarConfiguration TIFF tag. BIP corresponds to a value of 1 (Chunky), and BSQ corresponds to a value of 2 (Planar).

The number of bits per cell in the file, if it is not a power of 2 (i.e. 8, 16, or 32). Valid values are 1 - 32. If the bit depth is a power of 2, this value does not need to be specified. Note that previously the string "8-or-above" was equivalent to leaving this value blank.

When this value is specified, the interpretation of the input raster bands must be the minimum power of 2 above the requested bit depth. For example, to write 7-bit data, the interpretation must be one of UINT8, GRAY8, RED8, GREEN8, BLUE8, or ALPHA8.

When a value is specified, the writer will behave as follows:

  1. The writer checks the interpretation of the input raster bands. The interpretation of the input raster bands must be the minimum power of 2 above the requested bit depth. For example, to write 7-bit data, the interpretation must be one of UINT8, GRAY8, RED8, GREEN8, BLUE8, or ALPHA8.
  2. The data values on the bands will be reduced to the number of bits specified in the option. Note that values outside the bounds of the bit depth will be capped to the minimum or maximum. For example, if the number of bits is set to 4, a value of 201 (1100 1001 in base 2) will become 15 (1111 in base 2) in the output file.
  3. The Nodata value on the bands will not change. For example, a Nodata value 201 will still be 201 in the output file whatever the number of bits is set to. The user can change the Nodata value before writing it to the format using the RasterBandNodataSetter transformer.
  4. The values of the palettes on the input raster will not change, but the number of palette entries does change. The maximum number of palette entries depends on the number of bits in the option. For instance, if the original palette has 256 entries with keys 0 to 255 and the number of bits is set to 4, keys 16 to 255 will be removed and the output palette will only have keys 0 to 15.

The color space of the image data.

The available options are:

  • Auto: The photometric interpretation will be implicitly determined from the FME interpretation.
  • MinIsBlack: The minimum value of the raster should be displayed as black.
  • MinIsWhite: The minimum value of the raster should be displayed as white.
  • YCbCr: The values should be stored using the YCbCr color space. This option is only valid when using JPEG compression.