Class GConvertImage

java.lang.Object
boofcv.core.image.GConvertImage

public class GConvertImage
extends Object

Generalized functions for converting between different image types. Numerical values do not change or are closely approximated in these functions. If an output image is not specified then a new instance is declared and returned.

  • Constructor Details

    • GConvertImage

      public GConvertImage()
  • Method Details

    • convert

      public static void convert​(ImageBase input, ImageBase output)

      Converts one type of between two types of images using a default method. Both are the same image type then a simple type cast if performed at the pixel level. If the input is multi-band and the output is single band then it will average the bands. If input is single band and output is multi-band then the single band is copied into each of the other bands.

      In some cases a temporary image will be created to store intermediate results. If this is an issue you will need to create a specialized conversion algorithm.

      Parameters:
      input - Input image which is being converted. Not modified.
      output - (Optional) The output image. If null a new image is created. Modified.
    • average

      public static <T extends ImageGray<T>> T average​(ImageMultiBand input, T output)
      Converts a ImageMultiBand into a ImageGray by computing the average value of each pixel across all the bands.
      Parameters:
      input - ImageMultiBand that is being converted. Not modified.
      output - (Optional) The single band output image. If null a new image is created. Modified.
      Returns:
      Converted image.
    • average

      public static <T extends ImageGray<T>> T average​(Planar<T> input, T output)
      Converts a Planar into a ImageGray by computing the average value of each pixel across all the bands.
      Parameters:
      input - Input Planar image that is being converted. Not modified.
      output - (Optional) The single band output image. If null a new image is created. Modified.
      Returns:
      Converted image.
    • average

      public static <T extends ImageGray<T>> T average​(ImageInterleaved input, T output)
      Converts a Planar into a ImageGray by computing the average value of each pixel across all the bands.
      Parameters:
      input - Input Planar image that is being converted. Not modified.
      output - (Optional) The single band output image. If null a new image is created. Modified.
      Returns:
      Converted image.
    • convert

      public static GrayU8 convert​(ImageGray input, double min, double max, int numValues, GrayU8 output)
      Converts pixel values in the input image into an integer values from 0 to numValues.
      Parameters:
      input - Input image
      min - minimum input pixel value, inclusive
      max - maximum input pixel value, inclusive
      numValues - Number of possible pixel values in output image
      output - (Optional) Storage for the output image. Can be null.
      Returns:
      The converted output image.
    • convert

      public static <T extends ImageGray<T>> T convert​(ImageGray<?> src, T dst, Class<T> typeDst)
      Converts an image from one type to another type. Creates a new image instance if an output is not provided.
      Parameters:
      src - Input image. Not modified.
      dst - Converted output image. If null a new one will be declared. Modified.
      typeDst - The type of output image.
      Returns:
      Converted image.