IImageInfo

Description

interface Tinman.Terrain.Imaging.IImageInfo

Derived from

IPathInfo
IGeorefInfo
IConfigurable

Extended by

IImageReader
ImageInfo sealed

Provides information about an image.

Public / Attributes

Coverage


public attribute Coverage → (get)

value : PixelCoverage

The pixel coverage.

The pixel coverage of the image.

Usually, images have a pixel coverage of PixelCoverage.PixelIsArea.

Gamma


public attribute Gamma → (get)

value : float64

The gamma correction value (see remarks).

The gamma correction that must be applied to normalized image pixels in order to obtain linear pixel values.

Depending on the value V of this property, the following gamma correction is applied:

  • V > 0
    Given a normalized image pixel value N, the resulting linear pixel value L is computed as L = pow(N, V).

  • V = -2.2 (see ImagingUtil.GammaFromSrgb)
    The normalized image pixel value is fed into the ColorF.FromSrgbF method and its return value is used as the linear pixel value.

  • V = -0.45455 (see ImagingUtil.GammaToSrgb)
    The normalized image pixel value is fed into the ColorF.ToSrgbF method and its return value is used as the linear pixel value (which is not correct in a mathematical sense, but might be necessary in rare cases).

  • For all other values of V, the normalized and linear pixel values are treated as being equivalent.

See also

IImageReader

Height


public attribute Height → (get)

value : int32

[>0]
Height of the image, in pixels.

Height of the image, in pixels.

This is the number of image pixels along the Y-axis, which may be different from the raster height (see MapInfo), depending on the pixel coverage.

Image​Format


public attribute ImageFormat → (get)

value : ImageFormat

[not-null]
The image file format.

The file format of the image file.

The default file format is ImageFormat.Any, which will try to load image data using any of the available image formats.

Layer


public attribute Layer → (get)

value : HeightmapLayer

The target heightmap layer.

The heightmap layer which shall receive the data of this image.

This is not an actual property of the image, but included here for convenience when images are imported into heightmap datasets.

No​Data


public attribute NoData → (get)

value : float64

The nodata value.

The raw pixel value that represents missing data (i.e. void pixels).

The default value is Maths.NanD (i.e. all raw pixel values are valid).

See also

IImageReader

Pixel​Format


public attribute PixelFormat → (get)

value : PixelFormat

The pixel format of the image.

The pixel format of the image.

Image processing is always performed with with four 24-bit integer channels (see Scanline). The pixel format provides additional information about the stored pixel data.

Range


public attribute Range → (get)

value : PixelRange

The pixel range.

The mapping between raw pixels values and normalized image pixels.

See also

IImageReader

Values


public attribute Values → (get)

value : RangeD

The range of raw pixel values that are present in the image data (excluding the no-data value) or RangeD.Inv if not available.

The range of raw pixel values that are actually present in the image data, excluding the no-data value.

The header information of an image may include the range of raw pixel values. In such a case, that range will always be returned here, even if ReadImageFlags.Range has not been specified. Otherwise, RangeD.Inv will be returned, to indicate that the raw pixel value range is not available up-front. Specifying ReadImageFlags.Range in the latter case will trigger an additional pass over the image data, in order to determine the value range.

See also

IImageInfo.Range

Width


public attribute Width → (get)

value : int32

[>0]
Width of the image, in pixels.

Width of the image, in pixels.

This is the number of image pixels along the X-axis, which may be different from the raster width (see MapInfo), depending on the pixel coverage.