Package com.logicaldoc.core.imaging
Class ImageUtil
java.lang.Object
com.logicaldoc.core.imaging.ImageUtil
Utility methods for handling images
- Since:
- 8.5.3
- Author:
- Marco Meschieri - LogicalDOC
-
Method Summary
Modifier and TypeMethodDescriptionstatic BufferedImage
clone
(BufferedImage bi) Clones an image.static BufferedImage
convertToBinary
(BufferedImage image) A simple method to convert an image to binary or B/W image.static BufferedImage
convertToGrayscale
(BufferedImage image) A simple method to convert an image to gray scale.static BufferedImage
crop
(BufferedImage originalImage, ImageZone zone) Crops an area from given imagestatic BufferedImage
cropCenterSquare
(BufferedImage originalImage, int squareSize) Crops a square at the center of the given imagestatic void
cropToFile
(String content, ImageZone zone, File file) Crops an area and stores it in a given filestatic int[]
cropVisibleContent
(File src, File dst) Crops an image leaving the smallest square containing something visiblestatic BufferedImage
Creates an image frfom the given Base64 encoded textstatic String
Encodes in Base64 the given image filestatic BufferedImage
Generates a PNG with a single transparent pixelstatic byte[]
getBytes
(BufferedImage image) Write an image into an array of bytesstatic BufferedImage
getSubImage
(BufferedImage image, int x, int y, int width, int height) A replacement for the standardBufferedImage.getSubimage
method.static BufferedImage
invertColors
(BufferedImage image) Inverts image color.static boolean
isBlack
(BufferedImage image, int x, int y) Whether the pixel is black.static boolean
isBlack
(BufferedImage image, int x, int y, int luminanceCutOff) Whether the pixel is black.static void
paste
(BufferedImage container, BufferedImage imageIn, float opaque, int x, int y) Prints the contents of imageIn on container the given opaque valuestatic void
printFirstPage
(File originalFile, String originalFileName, File out) Prints the first page of the given file into the output as .jpg imagestatic BufferedImage
rotate
(BufferedImage image, double angle) Rotates an image.static BufferedImage
rotate
(BufferedImage image, double angle, int cx, int cy) Rotates image.static void
Saves an image into a given file in an image formatstatic BufferedImage
scale
(BufferedImage image, int targetWidth, int targetHeight) Convenience method that returns a scaled instance of the providedBufferedImage
.
-
Method Details
-
save
Saves an image into a given file in an image format- Parameters:
content
- the content of the image Base64 encodedfile
- the output file- Throws:
IOException
- in case of I/O error
-
cropToFile
Crops an area and stores it in a given file- Parameters:
content
- the content of the source image Base64 encodedzone
- the zone definitionfile
- the output file- Throws:
IOException
- an I/O error
-
crop
Crops an area from given image- Parameters:
originalImage
- the original imagezone
- the zone definition- Returns:
- the cropped image
-
cropCenterSquare
Crops a square at the center of the given image- Parameters:
originalImage
- the original imagesquareSize
- size of the square- Returns:
- the cropped square
-
cropVisibleContent
Crops an image leaving the smallest square containing something visible- Parameters:
src
- the source image filedst
- the cropped image file (png format)- Returns:
- width and height of the cropped image
- Throws:
IOException
- In case of elaboration error
-
paste
public static void paste(BufferedImage container, BufferedImage imageIn, float opaque, int x, int y) Prints the contents of imageIn on container the given opaque value- Parameters:
container
- the bigger imageimageIn
- the image to print inopaque
- and indication of how opaque must be the printx
- left coordinatey
- top coordinate
-
encode
Encodes in Base64 the given image file- Parameters:
image
- the image to encode- Returns:
- the encoded image
- Throws:
IOException
- error in the elaboration of the image
-
printFirstPage
public static void printFirstPage(File originalFile, String originalFileName, File out) throws IOException Prints the first page of the given file into the output as .jpg image- Parameters:
originalFile
- the original fileoriginalFileName
- the original filenameout
- the output file- Throws:
IOException
- a generic I/O error
-
isBlack
Whether the pixel is black.- Parameters:
image
- source imagex
- x coordinatey
- y coordinate- Returns:
- true only if the image is black
-
isBlack
Whether the pixel is black.- Parameters:
image
- source imagex
- x coordinatey
- y coordinateluminanceCutOff
- cut off luminance- Returns:
- true only if the image is black
-
rotate
Rotates image.- Parameters:
image
- source imageangle
- expressed degreescx
- x-coordinate of pivot pointcy
- y-coordinate of pivot point- Returns:
- rotated image
-
scale
Convenience method that returns a scaled instance of the providedBufferedImage
.- Parameters:
image
- the original image to be scaledtargetWidth
- the desired width of the scaled instance, in pixelstargetHeight
- the desired height of the scaled instance, in pixels- Returns:
- a scaled version of the original
BufferedImage
-
getSubImage
A replacement for the standardBufferedImage.getSubimage
method.- Parameters:
image
- the image to take the sub area fromx
- the X coordinate of the upper-left corner of the specified rectangular regiony
- the Y coordinate of the upper-left corner of the specified rectangular regionwidth
- the width of the specified rectangular regionheight
- the height of the specified rectangular region- Returns:
- a BufferedImage that is the subimage of
image
.
-
convertToBinary
A simple method to convert an image to binary or B/W image.- Parameters:
image
- input image- Returns:
- a monochrome image
-
convertToGrayscale
A simple method to convert an image to gray scale.- Parameters:
image
- input image- Returns:
- a monochrome image
-
invertColors
Inverts image color.- Parameters:
image
- input image- Returns:
- an inverted-color image
-
rotate
Rotates an image.- Parameters:
image
- the original imageangle
- the degree of rotation- Returns:
- a rotated image
-
clone
Clones an image.- Parameters:
bi
- the image to clone- Returns:
- the cloned image
-
decode
Creates an image frfom the given Base64 encoded text- Parameters:
text
- the text to print in the image- Returns:
- The generated image
-
generateTransparentSinglePixelPng
Generates a PNG with a single transparent pixel- Returns:
- the generated image
-
getBytes
Write an image into an array of bytes- Parameters:
image
- the image to read- Returns:
- the image's bytes
- Throws:
IOException
- I/O error
-