Package org.apache.fop.util.bitmap
Class BitmapImageUtil
java.lang.Object
org.apache.fop.util.bitmap.BitmapImageUtil
Utility method for dealing with bitmap images.
-
Method Summary
Modifier and TypeMethodDescriptionstatic int
convertToGray
(int rgb) Convert an RGB color value to a grayscale from 0 to 100.static int
convertToGray
(int r, int g, int b) Convert an RGB color value to a grayscale from 0 to 100.static BufferedImage
convertToGrayscale
(RenderedImage img, Dimension targetDimension) Converts an image to a grayscale (8 bits) image.static BufferedImage
convertToMonochrome
(RenderedImage img, Dimension targetDimension) Converts an image to a monochrome 1-bit image.static RenderedImage
convertToMonochrome
(RenderedImage img, Dimension targetDimension, float quality) Converts an image to a monochrome 1-bit image.static BufferedImage
convertTosRGB
(RenderedImage img, Dimension targetDimension) Converts an image to sRGB.static MonochromeBitmapConverter
static int
Returns the size of the color index if the given image has one.static boolean
Indicates whether an image is a grayscale image.static boolean
Indicates whether an image is a monochrome (1 bit black and white) image.static boolean
isZeroBlack
(RenderedImage img) Indicates whether a zero bit indicates a black/dark pixel for a monochrome image.static BufferedImage
Returns a BufferedImage based on the given RenderedImage.
-
Method Details
-
isMonochromeImage
Indicates whether an image is a monochrome (1 bit black and white) image.- Parameters:
img
- the image- Returns:
- true if it's a monochrome image
-
isZeroBlack
Indicates whether a zero bit indicates a black/dark pixel for a monochrome image.- Parameters:
img
- the image (must be 1 bit monochrome)- Returns:
- true if a zero bit indicates a black/dark pixel, false for a white/bright pixel
-
convertToGray
public static int convertToGray(int r, int g, int b) Convert an RGB color value to a grayscale from 0 to 100.- Parameters:
r
- the red componentg
- the green componentb
- the blue component- Returns:
- the gray value
-
convertToGray
public static int convertToGray(int rgb) Convert an RGB color value to a grayscale from 0 to 100.- Parameters:
rgb
- the RGB value- Returns:
- the gray value
-
getColorIndexSize
Returns the size of the color index if the given image has one.- Parameters:
img
- the image- Returns:
- the size of the color index or 0 if there's no color index
-
isGrayscaleImage
Indicates whether an image is a grayscale image.- Parameters:
img
- the image- Returns:
- true if it's a grayscale image
-
convertTosRGB
Converts an image to sRGB. Optionally, the image can be scaled.- Parameters:
img
- the image to be convertedtargetDimension
- the new target dimensions or null if no scaling is necessary- Returns:
- the sRGB image
-
convertToGrayscale
Converts an image to a grayscale (8 bits) image. Optionally, the image can be scaled.- Parameters:
img
- the image to be convertedtargetDimension
- the new target dimensions or null if no scaling is necessary- Returns:
- the grayscale image
-
convertToMonochrome
Converts an image to a monochrome 1-bit image. Optionally, the image can be scaled.- Parameters:
img
- the image to be convertedtargetDimension
- the new target dimensions or null if no scaling is necessary- Returns:
- the monochrome image
-
convertToMonochrome
public static RenderedImage convertToMonochrome(RenderedImage img, Dimension targetDimension, float quality) Converts an image to a monochrome 1-bit image. Optionally, the image can be scaled.- Parameters:
img
- the image to be convertedtargetDimension
- the new target dimensions or null if no scaling is necessaryquality
- Defines the desired quality level for the conversion. Valid values: a value between 0.0f (fastest) and 1.0f (best)- Returns:
- the monochrome image
-
toBufferedImage
Returns a BufferedImage based on the given RenderedImage. In the easiest case, this is a simple typecast. Otherwise, the image is converted to a BufferedImage.- Parameters:
img
- the original image- Returns:
- the buffered image
-
createDefaultMonochromeBitmapConverter
- Returns:
- the bitmap converter
-