Image.BandFormat (image v0.59.3)

View Source

Functions to define and validate the band formats of an image.

Summary

Types

t()

Functions

image_format_from_nx(tensor)

Returns the Image format type for an Nx format type.

known_band_formats()

Returns a list of the known band formats.

nx_format(image)

Returns the Nx format type for an Image or image format type.

nx_format!(image_or_format)

Returns the Nx format type for an Image or image format type or raises an exception.

validate(format)

Validates a band format returning the band format value required in the underlying Vix code.

Types

t()

@type t() ::
  {:u, 8}
  | {:s, 8}
  | {:u, 16}
  | {:s, 16}
  | {:u, 32}
  | {:s, 32}
  | {:u, 64}
  | {:s, 64}
  | {:f, 32}
  | {:f, 64}

Functions

image_format_from_nx(tensor)

Returns the Image format type for an Nx format type.

Image uses the same type formats as Nx so this function is more a validation than a conversion.

Arguments

  • Any Nx type like {:u, 8}.

Returns

  • {:ok, band_format} or

  • {:error, reason}

known_band_formats()

Returns a list of the known band formats.

nx_format(image)

Returns the Nx format type for an Image or image format type.

Image uses the same type formats as Nx so this function is more a validation than a conversion.

Arguments

Returns

  • {:ok, band_format} or

  • {:error, reason}

nx_format!(image_or_format)

Returns the Nx format type for an Image or image format type or raises an exception.

Image uses the same type formats as Nx so this function is more a validation than a conversion.

Arguments

Returns

  • band_format or

  • raises an exception.

validate(format)

Validates a band format returning the band format value required in the underlying Vix code.

Arguments

Returns

  • {:ok, validated_foramt} or

  • {:error, reason}

Examples 

  iex> Image.BandFormat.validate({:u, 8})
  {:ok, :VIPS_FORMAT_UCHAR}

  iex> Image.BandFormat.validate(:u8)
  {:ok, :VIPS_FORMAT_UCHAR}

  iex> Image.BandFormat.validate(:VIPS_FORMAT_UCHAR)
  {:ok, :VIPS_FORMAT_UCHAR}