Class ImageCreator


  • public class ImageCreator
    extends Object
    A class to create Image objects from various JIU image data types and vice versa. java.awt.Image objects can be used with the AWT and Swing GUI environments.
    Author:
    Marco Schmidt
    • Field Detail

      • DEFAULT_ALPHA

        public static final int DEFAULT_ALPHA
        The default transparency value to be used: full opacity.
        See Also:
        Constant Field Values
      • frame

        private static Frame frame
    • Constructor Detail

      • ImageCreator

        private ImageCreator()
    • Method Detail

      • createImage

        public static Image createImage​(int[] pixels,
                                        int width,
                                        int height)
        Creates a Image object from a pixel array. Internally, a Frame object is used to call its Component.createImage(java.awt.image.ImageProducer) method with a MemoryImageSource object.
        Parameters:
        pixels - the image pixel data in the typical RGBA 32-bit format, one int per pixel
        width - the horizontal resolution in pixels of the image to be created
        height - the vertical resolution in pixels of the image to be created
      • convertToAwtImage

        public static Image convertToAwtImage​(PixelImage image,
                                              int alpha)
        Creates an instance of Image from an instance of RGB24Image. This will require image.getWidth() * image.getHeight() * 4 bytes of free memory. This method checks the type of the argument image via instanceof and the calls the right convertToAwtImage method of this class.
        Parameters:
        image - the RGB24Image to be converted
        alpha - alpha value to be used with each pixel
        Returns:
        newly-created AWT image instance
      • convertToAwtImage

        public static Image convertToAwtImage​(BilevelImage image,
                                              int alpha)
        Convert a BilevelImage object to an AWT image object.
        Parameters:
        image - the image to be converted
        alpha - the transparency value to be written to each pixel in the resulting image
        Returns:
        newly-created AWT image
      • convertToAwtImage

        public static Image convertToAwtImage​(Gray16Image image,
                                              int alpha)
        Creates an AWT Image object from a Gray16Image object and an alpha value. This is done by allocating a new int array with image.getWidth() times image.getHeight() elements, copying the data to those ints (using transparency information from the top eight bits of the alpha argument) and calling Toolkit.createImage with a MemoryImageSource of those int[] pixels.
        Parameters:
        image - the grayscale image to be converted
        alpha - the alpha value, bits must only be set in the top eight bits
        Returns:
        AWT image created from the argument input image
      • convertToAwtImage

        public static Image convertToAwtImage​(Gray8Image image,
                                              int alpha)
        Creates an AWT Image object from a Gray8Image object and an alpha value. This is done by allocating a new int array with image.getWidth() times image.getHeight() elements, copying the data to those ints (using transparency information from the top eight bits of the alpha argument) and calling Toolkit.createImage with a MemoryImageSource of those int[] pixels.
        Parameters:
        image - the grayscale image to be converted
        alpha - the alpha value, bits must only be set in the top eight bits
        Returns:
        AWT image created from the argument input image
      • convertToAwtImage

        public static Image convertToAwtImage​(Paletted8Image image,
                                              int alpha)
      • convertToAwtImage

        public static Image convertToAwtImage​(RGB24Image image,
                                              int alpha)
      • convertToAwtImage

        public static Image convertToAwtImage​(RGB48Image image,
                                              int alpha)
      • convertImageToRGB24Image

        public static RGB24Image convertImageToRGB24Image​(Image image)
        Creates an RGB24Image from the argument AWT image instance.
        Parameters:
        image - AWT image object to be converted to a RGB24Image
        Returns:
        a RGB24Image object holding the image data from the argument image