com.aspose.imaging.fileformats.gif

Class GifImage

java.lang.Object

com.aspose.imaging.DisposableObject

com.aspose.imaging.DataStreamSupporter

com.aspose.imaging.Image

com.aspose.imaging.RasterImage

com.aspose.imaging.RasterCachedImage

com.aspose.imaging.RasterCachedMultipageImage

com.aspose.imaging.fileformats.gif.GifImage

All Implemented Interfaces:

com.aspose.fileformats.core.interfaces.IInterlaced, IMultipageImage, IMultipageImageExt, IObjectWithBounds, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, com.aspose.internal.IPixelsSaver, com.aspose.internal.progressmanagement.IProgressEventHandler, com.aspose.internal.progressmanagement.IProgressInformer, com.aspose.ms.System.IDisposable, Closeable, AutoCloseable

public final class GifImage
extends RasterCachedMultipageImage
implements IMultipageImageExt, com.aspose.fileformats.core.interfaces.IInterlaced

A gif image.

Code example:

This example shows how to create a GIF image and save it to a file.

String dir = "c:\\temp\\";

// Create a GIF Frame block of 100x100 px.
com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
try {
    // Fill the entire block in red.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(firstBlock);
    com.aspose.imaging.brushes.SolidBrush brush = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed());
    gr.fillRectangle(brush, firstBlock.getBounds());

    com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
    try {
        gifImage.save(dir + "output.gif");
    } finally {
        gifImage.dispose();
    }
} finally {
    firstBlock.dispose();
}

Constructor Summary

Constructors

Constructor and Description
GifImage(GifFrameBlock firstFrame) Initializes a new instance of the GifImage class.
GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette) Initializes a new instance of the GifImage class.
GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette, boolean isPaletteSorted, byte paletteColorResolution, byte paletteBackgroundColorIndex, byte aspectRatio, boolean hasTrailer) Initializes a new instance of the GifImage class.

Method Summary

Modifier and Type	Method and Description
void	addBlock(IGifBlock block) Adds a new GIF block.
void	addPage(RasterImage page) Adds page to the image.
void	adjustBrightness(int brightness) Adjust of a brightness for image.
void	adjustContrast(float contrast) Adjusts the contrast.
void	adjustGamma(float gamma) Gamma-correction of an image.
void	adjustGamma(float gammaRed, float gammaGreen, float gammaBlue) Gamma-correction of an image.
void	binarizeBradley(double brightnessDifference) Binarization of an image using Bradley's adaptive thresholding algorithm using the integral image thresholding
void	binarizeFixed(byte threshold) Binarization of an image with predefined threshold
void	binarizeOtsu() Binarization of an image with Otsu thresholding
void	clearBlocks() Clears all the GIF blocks.
void	crop(Rectangle rectangle) Cropping the image.
void	dither(int ditheringMethod, int bitsCount, IColorPalette customPalette) Performs dithering on the current image.
void	filter(Rectangle rectangle, FilterOptionsBase options) Filters the specified rectangle.
GifFrameBlock	getActiveFrame() Gets the active frame.
Color	getBackgroundColor() Gets the background color.
byte	getBackgroundColorIndex() Gets the background color index.
IGifBlock[]	getBlocks() Gets the GIF blocks.
Image	getDefaultPage() Deprecated. Please use getPages()[index]
long	getFileFormat() Gets a value of file format
float	getImageOpacity() Gets opacity of this image (active frame).
int	getLoopsCount() Gets the loops count (If gif image contains information about loops)
ImageOptionsBase	getOriginalOptions() Gets the options based on the original file settings.
int	getPageCount() Gets the page count.
PageExportingAction	getPageExportingAction() Gets the page exporting action.
Image[]	getPages() Gets the pages.
byte	getPaletteColorResolutionBits() Gets or sets the palette color resolution bits.
byte	getPixelAspectRatio() Gets the pixel aspect ratio.
Color	getTransparentColor() Gets active frame transparent color.
XmpPacketWrapper	getXmpData() Gets the XMP metadata.
void	grayscale() Transformation of an image to its grayscale representation
boolean	hasBackgroundColor() Gets a value indicating whether image has background color.
boolean	hasTrailer() Gets or sets a value indicating whether GIF has trailer.
boolean	hasTransparentColor() Gets a value indicating whether active frame has transparent color.
void	insertBlock(int index, IGifBlock block) Adds a new GIF block.
boolean	isInterlaced() Gets a value indicating whether this image instance is interlaced.
boolean	isPaletteSorted() Gets or sets a value indicating whether palette is sorted.
void	orderBlocks() Orders the GIF blocks according to the GIF specification.
void	removeBlock(IGifBlock block) Removes the GIF block.
void	resize(int newWidth, int newHeight, ImageResizeSettings settings) Resizes the image.
void	resize(int newWidth, int newHeight, int resizeType) Resizes the image.
void	resizeFullFrame(int newWidth, int newHeight, int resizeType) Resizes the image using full frames for each GIF page.
void	resizeProportional(int newWidth, int newHeight, int resizeType) Performs proportional resize on the image.
void	rotate(float angle, boolean resizeProportionally, Color backgroundColor) RasterCachedMultipageImage.rotate(float, boolean, Color) image around the center.
void	rotateFlip(int rotateFlipType) Rotates, flips, or rotates and flips the Active frame only.
void	setActiveFrame(GifFrameBlock value) Sets the active frame.
void	setBackgroundColor(Color value) Sets the background color.
void	setBackgroundColorIndex(byte value) Sets the background color index.
void	setFrameTime(int time) Sets all frames duration in milliseconds.
void	setLoopsCount(int value) The loops count (If gif image contains information about loops)
void	setPageExportingAction(PageExportingAction value) Sets the page exporting action.
void	setPaletteColorResolutionBits(byte value) Sets the palette color resolution bits.
void	setPaletteSorted(boolean value) Gets or sets a value indicating whether palette is sorted.
void	setPixelAspectRatio(byte value) Sets the pixel aspect ratio.
void	setTrailer(boolean value) Gets or sets a value indicating whether GIF has trailer.
void	setTransparentColor(boolean value) A value indicating whether active frame has transparent color.
void	setXmpData(XmpPacketWrapper value) Sets the XMP metadata.

Methods inherited from class com.aspose.imaging.RasterCachedMultipageImage

binarizeBradley, cacheData, crop, getBitsPerPixel, getHeight, getWidth, hasAlpha, isCached, normalizeAngle, replaceColor, replaceNonTransparentColors, resizeHeightProportionally, resizeWidthProportionally, rotateFlipAll

Methods inherited from class com.aspose.imaging.RasterImage

dither, getArgb32Pixel, getDefaultArgb32Pixels, getDefaultPixels, getDefaultRawData, getDefaultRawData, getHorizontalResolution, getModifyDate, getPixel, getPremultiplyComponents, getRawCustomColorConverter, getRawDataFormat, getRawDataSettings, getRawFallbackIndex, getRawIndexedColorConverter, getRawLineSize, getSkewAngle, getUpdateXmpData, getUseRawData, getVerticalResolution, isRawDataAvailable, isUsePalette, loadArgb32Pixels, loadArgb64Pixels, loadCmyk32Pixels, loadCmykPixels, loadPartialArgb32Pixels, loadPartialPixels, loadPixels, loadRawData, loadRawData, normalizeAngle, readArgb32ScanLine, readScanLine, replaceColor, replaceNonTransparentColors, rotate, saveArgb32Pixels, saveCmyk32Pixels, saveCmykPixels, savePixels, saveRawData, setArgb32Pixel, setHorizontalResolution, setPalette, setPixel, setPremultiplyComponents, setRawCustomColorConverter, setRawFallbackIndex, setRawIndexedColorConverter, setResolution, setTransparentColor, setUpdateXmpData, setUseRawData, setVerticalResolution, toBitmap, writeArgb32ScanLine, writeScanLine

Methods inherited from class com.aspose.imaging.Image

canLoad, canLoad, canLoad, canLoad, canSave, create, create, create, getBounds, getBufferSizeHint, getContainer, getDefaultOptions, getFileFormat, getFileFormat, getFittingRectangle, getFittingRectangle, getInterruptMonitor, getPalette, getProgressEventHandler, getProgressEventHandlerInfo, getProportionalHeight, getProportionalWidth, getSize, isAutoAdjustPalette, load, load, load, load, load, load, resize, resizeHeightProportionally, resizeHeightProportionally, resizeWidthProportionally, resizeWidthProportionally, save, save, save, save, save, save, save, save, setAutoAdjustPalette, setBackgroundColor, setBufferSizeHint, setInterruptMonitor, setPalette

Methods inherited from class com.aspose.imaging.DataStreamSupporter

getDataStreamContainer, save, save, save

Methods inherited from class com.aspose.imaging.DisposableObject

close, dispose, getDisposed

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GifImage

public GifImage(GifFrameBlock firstFrame,
                IColorPalette globalPalette)

Initializes a new instance of the GifImage class.

Parameters:

firstFrame - The first frame to initialize gif image with.

globalPalette - The global palette to use. Note if both firstFrame and globalPalette are null then default global palette is used.

Throws:

com.aspose.ms.System.ArgumentNullException - The frame cannot be null;firstFrame

com.aspose.ms.System.ArgumentException - The first frame already belongs to some other image. Check the Container property.;firstFrame

GifImageException - The palette specified should contain entries count equal to power of 2. Minimal palette size is 2, maximal is 256.

Code example:

This example shows how to create a GIF image with a custom palette and save it to a file.

String dir = "c:\\temp\\";

// Create a GIF Frame block of 100x100 px.
com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
try {
    // Fill the entire block in red.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(firstBlock);
    com.aspose.imaging.brushes.SolidBrush brush = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed());
    gr.fillRectangle(brush, firstBlock.getBounds());

    // Use 4-bit palette to reduce the image size. The quality can get worse.
    com.aspose.imaging.IColorPalette palette = com.aspose.imaging.ColorPaletteHelper.create4Bit();

    com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock, palette);
    try {
        gifImage.save(dir + "output.gif");
    } finally {
        gifImage.dispose();
    }
} finally {
    firstBlock.dispose();
}

GifImage

public GifImage(GifFrameBlock firstFrame)

Initializes a new instance of the GifImage class.

Parameters:

firstFrame - The first frame to initialize gif image with.

Throws:

com.aspose.ms.System.ArgumentNullException - The frame cannot be null;firstFrame

com.aspose.ms.System.ArgumentException - The first frame already belongs to some other image. Check the Container property.;firstFrame

GifImageException - The palette specified should contain entries count equal to power of 2. Minimal palette size is 2, maximal is 256.

Code example:

The following example shows how to compose an animated GIF image from individual GIF blocks.

String dir = "c:\\temp\\";

// Create a GIF image 100 x 100 px.
// The first block is fully black by default.
com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
try {
    // The first circle is red
    com.aspose.imaging.brushes.SolidBrush brush1 = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed());

    // The second circle is black
    com.aspose.imaging.brushes.SolidBrush brush2 = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getBlack());

    // Gradually increase the angle of the red arc shape.
    for (int angle = 10; angle <= 360; angle += 10) {
        com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock block = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);

        com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(block);
        gr.fillPie(brush1, block.getBounds(), 0, angle);

        gifImage.addBlock(block);
    }

    // Gradually increase the angle of the black arc and wipe out the red arc.
    for (int angle = 10; angle <= 360; angle += 10) {
        com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock block = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);

        com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(block);
        gr.fillPie(brush2, block.getBounds(), 0, angle);
        gr.fillPie(brush1, block.getBounds(), angle, 360 - angle);

        gifImage.addBlock(block);
    }

    gifImage.save(dir + "animated_radar.gif");
} finally {
    firstBlock.dispose();
    gifImage.dispose();
}

GifImage

public GifImage(GifFrameBlock firstFrame,
                IColorPalette globalPalette,
                boolean isPaletteSorted,
                byte paletteColorResolution,
                byte paletteBackgroundColorIndex,
                byte aspectRatio,
                boolean hasTrailer)

Initializes a new instance of the GifImage class.

Parameters:

firstFrame - The first frame to initialize gif image with.

globalPalette - The global palette to use. Note if both firstFrame and globalPalette are null then default global palette is used.

isPaletteSorted - if set to true the palette is sorted. Note the parameter is used when globalPalette is not null.

paletteColorResolution - The palette color resolution. Note the parameter is used when globalPalette is not null.

paletteBackgroundColorIndex - The palette background color index.

aspectRatio - The aspect ratio.

hasTrailer - if set to true the gif image has trailer otherwise no trailer written at the end of the stream.

Throws:

com.aspose.ms.System.ArgumentNullException - The frame cannot be null;firstFrame

com.aspose.ms.System.ArgumentException - The first frame already belongs to some other image. Check the Container property.;firstFrame

GifImageException - The palette specified should contain entries count equal to power of 2. Minimal palette size is 2, maximal is 256.

Method Detail

getFileFormat

public long getFileFormat()

Gets a value of file format

Overrides:

getFileFormat in class Image

See Also:

FileFormat

getXmpData

public XmpPacketWrapper getXmpData()

Gets the XMP metadata.

Overrides:

getXmpData in class RasterCachedMultipageImage

Returns:

The XMP metadata.

setXmpData

public void setXmpData(XmpPacketWrapper value)

Sets the XMP metadata.

Overrides:

setXmpData in class RasterCachedMultipageImage

Parameters:

value - The XMP metadata.

hasTrailer

public boolean hasTrailer()

Gets or sets a value indicating whether GIF has trailer.

Returns:

true if GIF has trailer; otherwise, false.

setTrailer

public void setTrailer(boolean value)

Gets or sets a value indicating whether GIF has trailer.

Parameters:

value - true if GIF has trailer; otherwise, false.

isPaletteSorted

public boolean isPaletteSorted()

Gets or sets a value indicating whether palette is sorted.

Returns:

true if palette is sorted; otherwise, false.

setPaletteSorted

public void setPaletteSorted(boolean value)

Gets or sets a value indicating whether palette is sorted.

Parameters:

value - true if palette is sorted; otherwise, false.

getLoopsCount

public int getLoopsCount()

Gets the loops count (If gif image contains information about loops)

Value: The loops count or 1 (default value)

Returns:

the loops count (If gif image contains information about loops)

setLoopsCount

public void setLoopsCount(int value)

The loops count (If gif image contains information about loops)

Value: The loops count or 1 (default value)

Parameters:

value - the loops count (If gif image contains information about loops)

getPaletteColorResolutionBits

public byte getPaletteColorResolutionBits()

Gets or sets the palette color resolution bits.

Returns:

The palette color resolution bits.

setPaletteColorResolutionBits

public void setPaletteColorResolutionBits(byte value)

Sets the palette color resolution bits.

Parameters:

value - The palette color resolution bits.

getPageCount

public int getPageCount()

Gets the page count.

Value: The page count. <autogeneratedoc></autogeneratedoc>

Specified by:

getPageCount in interface IMultipageImage

Specified by:

getPageCount in class RasterCachedMultipageImage

Returns:

the page count.

getPages

public Image[] getPages()

Gets the pages.

Value: The pages. <autogeneratedoc></autogeneratedoc>

Specified by:

getPages in interface IMultipageImage

Specified by:

getPages in class RasterCachedMultipageImage

Returns:

the pages.

getDefaultPage

@Deprecated
public Image getDefaultPage()

Deprecated. Please use getPages()[index]

Gets the default page.

Value: The default page. <autogeneratedoc></autogeneratedoc>

Specified by:

getDefaultPage in interface IMultipageImage

Specified by:

getDefaultPage in class RasterCachedMultipageImage

Returns:

the default page.

getBlocks

public IGifBlock[] getBlocks()

Gets the GIF blocks.

Returns:

the GIF blocks.

isInterlaced

public boolean isInterlaced()

Gets a value indicating whether this image instance is interlaced.

Value: true if this image instance is interlaced; otherwise, false.

Specified by:

isInterlaced in interface com.aspose.fileformats.core.interfaces.IInterlaced

Returns:

a value indicating whether this image instance is interlaced.

getOriginalOptions

public ImageOptionsBase getOriginalOptions()

Gets the options based on the original file settings. This can be helpful to keep bit-depth and other parameters of the original image unchanged. For example, if we load a black-white PNG image with 1 bit per pixel and then save it using the DataStreamSupporter.save(String) method, the output PNG image with 8-bit per pixel will be produced. To avoid it and save PNG image with 1-bit per pixel, use this method to get corresponding saving options and pass them to the Image.save(String, ImageOptionsBase) method as the second parameter.

Overrides:

getOriginalOptions in class Image

Returns:

The options based on the original file settings.

addPage

public void addPage(RasterImage page)

Adds page to the image.

Specified by:

addPage in interface IMultipageImageExt

Parameters:

page - The page to add.

Throws:

com.aspose.ms.System.ArgumentNullException - page is null.

Code example:

Create multipage GIF image using single page raster images.

static void main(String[] args)
{
    // Load frames
    RasterImage[] frames = loadFrames("Animation frames");

    // Create GIF image using the first frame
    try (GifImage image = new GifImage(new GifFrameBlock(frames[0])))
    {
        // Add frames to the GIF image using the AddPage method
        for (int index = 1; index < frames.length; index++)
        {
            image.addPage(frames[index]);
        }

        // Save GIF image
        image.save("Multipage.gif");
    }

    // release resources
    for (RasterImage frame : frames)
    {
        frame.close();
    }
}

private static RasterImage[] loadFrames(String directory)
{
    LinkedList<RasterImage> list = new LinkedList<RasterImage>();
    String[] fileList = new File(directory).list();
    if (fileList != null)
    {
        for (String filePath : fileList)
        {
            list.add((RasterImage) Image.load(filePath));
        }
    }
                
    return list.toArray(new RasterImage[0]);
}

getActiveFrame

public GifFrameBlock getActiveFrame()

Gets the active frame.

Value: The active frame.

Returns:

the active frame.

Code example:

The following example shows how to remove all blocks from a GIF image.

com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
try {
    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }

    System.out.println("Clear all the blocks");
    gifImage.clearBlocks();

    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }
} finally {
    firstBlock.dispose();
    gifImage.dispose();
}

// The output looks like this:
// Active frame size: { Width = 100, Height = 100}
// Clear all the blocks
// Active frame is not set

setActiveFrame

public void setActiveFrame(GifFrameBlock value)

Sets the active frame.

Value: The active frame.

Parameters:

value - the active frame.

getBackgroundColor

public Color getBackgroundColor()

Gets the background color.

Value: The background color.

Overrides:

getBackgroundColor in class RasterCachedMultipageImage

Returns:

the background color.

setBackgroundColor

public void setBackgroundColor(Color value)

Sets the background color.

Value: The background color.

Overrides:

setBackgroundColor in class RasterCachedMultipageImage

Parameters:

value - the background color.

getBackgroundColorIndex

public byte getBackgroundColorIndex()

Gets the background color index.

Value: The background color index.

Returns:

the background color index.

setBackgroundColorIndex

public void setBackgroundColorIndex(byte value)

Sets the background color index.

Value: The background color index.

Parameters:

value - the background color index.

getPixelAspectRatio

public byte getPixelAspectRatio()

Gets the pixel aspect ratio.

Value: The pixel aspect ratio.

Returns:

the pixel aspect ratio.

setPixelAspectRatio

public void setPixelAspectRatio(byte value)

Sets the pixel aspect ratio.

Value: The pixel aspect ratio.

Parameters:

value - the pixel aspect ratio.

hasTransparentColor

public boolean hasTransparentColor()

Gets a value indicating whether active frame has transparent color.

Overrides:

hasTransparentColor in class RasterCachedMultipageImage

Returns:

a value indicating whether active frame has transparent color.

setTransparentColor

public void setTransparentColor(boolean value)

A value indicating whether active frame has transparent color.

Overrides:

setTransparentColor in class RasterImage

Parameters:

value - a value indicating whether active frame has transparent color.

getTransparentColor

public Color getTransparentColor()

Gets active frame transparent color.

Overrides:

getTransparentColor in class RasterImage

Returns:

active frame transparent color.

hasBackgroundColor

public boolean hasBackgroundColor()

Gets a value indicating whether image has background color.

Overrides:

hasBackgroundColor in class Image

Returns:

a value indicating whether image has background color.

getImageOpacity

public float getImageOpacity()

Gets opacity of this image (active frame).

Value: The opacity value between 0.0 (fully transparent) and 1.0 (fully opaque).

Overrides:

getImageOpacity in class RasterCachedMultipageImage

Returns:

opacity of this image (active frame).

getPageExportingAction

public PageExportingAction getPageExportingAction()

Gets the page exporting action. Please note that setting this method will automatically release page resources after it is executed. It will be executed just before each page is saved.

Value: The page exporting action.

Specified by:

getPageExportingAction in interface IMultipageImage

Overrides:

getPageExportingAction in class RasterCachedMultipageImage

Returns:

the page exporting action.

setPageExportingAction

public void setPageExportingAction(PageExportingAction value)

Sets the page exporting action. Please note that setting this method will automatically release page resources after it is executed. It will be executed just before each page is saved.

Value: The page exporting action.

Specified by:

setPageExportingAction in interface IMultipageImage

Overrides:

setPageExportingAction in class RasterCachedMultipageImage

Parameters:

value - the page exporting action.

resize

public void resize(int newWidth,
                   int newHeight,
                   int resizeType)

Resizes the image.

Overrides:

resize in class RasterCachedMultipageImage

Parameters:

newWidth - The new width.

newHeight - The new height.

resizeType - The resize type.

Code example:

This example loads a GIF image and resizes it using various resizing methods.

String dir = "c:\\temp\\";

com.aspose.imaging.fileformats.gif.GifImage image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // Scale up by 2 times using Nearest Neighbour resampling.
    image.resize(image.getWidth() * 2, image.getHeight() * 2, com.aspose.imaging.ResizeType.NearestNeighbourResample);
    image.save(dir + "upsample.nearestneighbour.gif");
} finally {
    image.dispose();
}

image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // Scale down by 2 times using Nearest Neighbour resampling.
    image.resize(image.getWidth() / 2, image.getHeight() / 2, com.aspose.imaging.ResizeType.NearestNeighbourResample);
    image.save(dir + "downsample.nearestneighbour.gif");
} finally {
    image.dispose();
}

image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // Scale up by 2 times using Bilinear resampling.
    image.resize(image.getWidth() * 2, image.getHeight() * 2, com.aspose.imaging.ResizeType.BilinearResample);
    image.save(dir + "upsample.bilinear.gif");
} finally {
    image.dispose();
}

image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // Scale down by 2 times using Bilinear resampling.
    image.resize(image.getWidth() / 2, image.getHeight() / 2, com.aspose.imaging.ResizeType.BilinearResample);
    image.save(dir + "downsample.bilinear.gif");
} finally {
    image.dispose();
}

resizeFullFrame

public void resizeFullFrame(int newWidth,
                            int newHeight,
                            int resizeType)

Resizes the image using full frames for each GIF page. Required to avoid possible artifacts appearance.

Parameters:

newWidth - The new width.

newHeight - The new height.

resizeType - The resize type.

rotateFlip

public void rotateFlip(int rotateFlipType)

Rotates, flips, or rotates and flips the Active frame only.

Overrides:

rotateFlip in class RasterCachedMultipageImage

Parameters:

rotateFlipType - The rotation flip type.

See Also:

RotateFlipType

Code example:

This example loads a GIF image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.

// The helper class used in the main example below.
class Utils {
    // The helper method to get a string representation of the file format.
    public String getRotateFlipTypeString(int rotateFlipType) {
        if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipNone) {
            return "RotateNoneFlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipNone) {
            return "Rotate90FlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipNone) {
            return "Rotate180FlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipNone) {
            return "Rotate270FlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipX) {
            return "RotateNoneFlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipX) {
            return "Rotate90FlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipX) {
            return "Rotate180FlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipX) {
            return "Rotate270FlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipY) {
            return "RotateNoneFlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipY) {
            return "Rotate90FlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipY) {
            return "Rotate180FlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipY) {
            return "Rotate270FlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipXY) {
            return "RotateNoneFlipXY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipXY) {
            return "Rotate90FlipXY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipXY) {
            return "Rotate180FlipXY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipXY) {
            return "Rotate270FlipXY";
        } else {
            return "UNDEFINED";
        }
    }
}

// Here is the main example
Utils utils = new Utils();

String dir = "c:\\temp\\";

int[] rotateFlipTypes = new int[]
        {
                com.aspose.imaging.RotateFlipType.Rotate90FlipNone,
                com.aspose.imaging.RotateFlipType.Rotate90FlipX,
                com.aspose.imaging.RotateFlipType.Rotate90FlipXY,
                com.aspose.imaging.RotateFlipType.Rotate90FlipY,
        };

for (int rotateFlipType : rotateFlipTypes) {
    // Rotate, flip and save to the output file.
    com.aspose.imaging.fileformats.gif.GifImage image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
    try {
        image.rotateFlip(rotateFlipType);
        image.save(dir + "sample." + utils.getRotateFlipTypeString(rotateFlipType) + ".png", new com.aspose.imaging.imageoptions.PngOptions());
    } finally {
        image.dispose();
    }
}

dither

public void dither(int ditheringMethod,
                   int bitsCount,
                   IColorPalette customPalette)

Performs dithering on the current image.

Overrides:

dither in class RasterCachedMultipageImage

Parameters:

ditheringMethod - The dithering method.

bitsCount - The final bits count for dithering.

customPalette - The custom palette for dithering.

Code example:

The following example loads a GIF image and performs threshold and floyd dithering using different palette depth.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Perform threshold dithering using 4-bit color palette which contains 16 colors.
    // The more bits specified the higher quality and the bigger size of the output image.
    // Note that only 1-bit, 4-bit and 8-bit palettes are supported at the moment.
    gifImage.dither(com.aspose.imaging.DitheringMethod.ThresholdDithering, 4, null);

    gifImage.save(dir + "sample.ThresholdDithering4.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Perform floyd dithering using 1-bit color palette which contains only 2 colors - black and white.
    // The more bits specified the higher quality and the bigger size of the output image.
    // Note that only 1-bit, 4-bit and 8-bit palettes are supported at the moment.
    gifImage.dither(com.aspose.imaging.DitheringMethod.FloydSteinbergDithering, 1, null);

    gifImage.save(dir + "sample.FloydSteinbergDithering1.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

crop

public void crop(Rectangle rectangle)

Cropping the image.

Overrides:

crop in class RasterCachedMultipageImage

Parameters:

rectangle - The rectangle.

Code example:

The following example crops a GIF image. The cropping area is be specified via Aspose.Imaging.Rectangle.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Crop the image. The cropping area is the rectangular central area of the image.
    com.aspose.imaging.Rectangle area = new com.aspose.imaging.Rectangle(
            gifImage.getWidth() / 4,
            gifImage.getHeight() / 4,
            gifImage.getWidth() / 2,
            gifImage.getHeight() / 2);
    gifImage.crop(area);

    // Save the cropped image to PNG
    gifImage.save(dir + "sample.Crop.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

adjustGamma

public void adjustGamma(float gamma)

Gamma-correction of an image.

Overrides:

adjustGamma in class RasterCachedMultipageImage

Parameters:

gamma - Gamma for red, green and blue channels coefficient

Code example:

The following example performs gamma-correction of a GIF image.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Set gamma coefficient for red, green and blue channels.
    gifImage.adjustGamma(2.5f);
    gifImage.save(dir + "sample.AdjustGamma.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

filter

public void filter(Rectangle rectangle,
                   FilterOptionsBase options)

Filters the specified rectangle.

Overrides:

filter in class RasterCachedMultipageImage

Parameters:

rectangle - The rectangle.

options - The options.

Code example:

The following example applies various types of filters to a GIF image.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Apply a median filter with a rectangle size of 5 to the entire image.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.MedianFilterOptions(5));
    gifImage.save(dir + "sample.MedianFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Apply a bilateral smoothing filter with a kernel size of 5 to the entire image.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.BilateralSmoothingFilterOptions(5));
    gifImage.save(dir + "sample.BilateralSmoothingFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Apply a Gaussian blur filter with a radius of 5 and a sigma value of 4.0 to the entire image.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.GaussianBlurFilterOptions(5, 4.0));
    gifImage.save(dir + "sample.GaussianBlurFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Apply a Gauss-Wiener filter with a radius of 5 and a smooth value of 4.0 to the entire image.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.GaussWienerFilterOptions(5, 4.0));
    gifImage.save(dir + "sample.GaussWienerFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Apply a motion wiener filter with a length of 5, a smooth value of 4.0 and an angle of 90.0 degrees to the entire image.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.MotionWienerFilterOptions(10, 1.0, 90.0));
    gifImage.save(dir + "sample.MotionWienerFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Apply a sharpen filter with a kernel size of 5 and a sigma value of 4.0 to the entire image.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.SharpenFilterOptions(5, 4.0));
    gifImage.save(dir + "sample.SharpenFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

resize

public void resize(int newWidth,
                   int newHeight,
                   ImageResizeSettings settings)

Resizes the image.

Overrides:

resize in class RasterCachedMultipageImage

Parameters:

newWidth - The new width.

newHeight - The new height.

settings - The resize settings.

Code example:

This example loads a GIF image and resizes it using various resizing settings.

String dir = "c:\\temp\\";

com.aspose.imaging.ImageResizeSettings resizeSettings = new com.aspose.imaging.ImageResizeSettings();

// The adaptive algorithm based on weighted and blended rational function and lanczos3 interpolation.
resizeSettings.setMode(com.aspose.imaging.ResizeType.AdaptiveResample);

// The small rectangular filter
resizeSettings.setFilterType(com.aspose.imaging.ImageFilterType.SmallRectangular);

// The number of colors in the palette.
resizeSettings.setEntriesCount(256);

// The color quantization is not used
resizeSettings.setColorQuantizationMethod(com.aspose.imaging.ColorQuantizationMethod.None);

// The Euclidian method
resizeSettings.setColorCompareMethod(com.aspose.imaging.ColorCompareMethod.Euclidian);

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Scale down by 2 times using adaptive resampling.
    gifImage.resize(image.getWidth() / 2, image.getHeight() / 2, resizeSettings);

    // Save to PNG
    gifImage.save(dir + "downsample.adaptive.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

setFrameTime

public void setFrameTime(int time)

Sets all frames duration in milliseconds. Changing this value will reset delay for all frames.

Parameters:

time - The time of frame duration in milliseconds.

adjustBrightness

public void adjustBrightness(int brightness)

Adjust of a brightness for image.

Overrides:

adjustBrightness in class RasterCachedMultipageImage

Parameters:

brightness - Brightness value.

Code example:

The following example performs brightness correction of a GIF image.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Set the brightness value. The accepted values of brightness are in the range [-255, 255].
    gifImage.adjustBrightness(50);
    gifImage.save(dir + "sample.AdjustBrightness.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

adjustContrast

public void adjustContrast(float contrast)

Adjusts the contrast.

Overrides:

adjustContrast in class RasterCachedMultipageImage

Parameters:

contrast - Contrast value (in range [-100; 100])

Throws:

ImageException - Can't change contrast. Frame index: " + frameIndex

Code example:

The following example performs contrast correction of a GIF image.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Set the contrast value. The accepted values of contrast are in the range [-100f, 100f].
    gifImage.adjustContrast(50f);
    gifImage.save(dir + "sample.AdjustContrast.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

adjustGamma

public void adjustGamma(float gammaRed,
                        float gammaGreen,
                        float gammaBlue)

Gamma-correction of an image.

Overrides:

adjustGamma in class RasterCachedMultipageImage

Parameters:

gammaRed - Gamma for red channel coefficient

gammaGreen - Gamma for green channel coefficient

gammaBlue - Gamma for blue channel coefficient

Code example:

The following example performs gamma-correction of a GIF image applying different coefficients for color components.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Set individual gamma coefficients for red, green and blue channels.
    gifImage.adjustGamma(1.5f, 2.5f, 3.5f);
    gifImage.save(dir + "sample.AdjustGamma.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

grayscale

public void grayscale()

Transformation of an image to its grayscale representation

Overrides:

grayscale in class RasterCachedMultipageImage

Code example:

The following example transforms a colored GIF image to its grayscale representation. Grayscale images are composed exclusively of shades of gray and carry only intensity information.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    gifImage.grayscale();
    gifImage.save(dir + "sample.Grayscale.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

binarizeFixed

public void binarizeFixed(byte threshold)

Binarization of an image with predefined threshold

Overrides:

binarizeFixed in class RasterCachedMultipageImage

Parameters:

threshold - Threshold value. If corresponding gray value of a pixel is greater than threshold, a value of 255 will be assigned to it, 0 otherwise.

Code example:

The following example binarizes a GIF image with the predefined threshold. Binarized images contain only 2 colors - black and white.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage djvuImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Binarize the image with a threshold value of 127.
    // If a corresponding gray value of a pixel is greater than 127, a value of 255 will be assigned to it, 0 otherwise.
    djvuImage.binarizeFixed((byte) 127);
    djvuImage.save(dir + "sample.BinarizeFixed.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

binarizeOtsu

public void binarizeOtsu()

Binarization of an image with Otsu thresholding

Overrides:

binarizeOtsu in class RasterCachedMultipageImage

Code example:

The following example binarizes a GIF image with Otsu thresholding. Binarized images contain only 2 colors - black and white.

String dir = "c:\\temp\\";

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // Binarize the image with Otsu thresholding.
    gifImage.binarizeOtsu();
    gifImage.save(dir + "sample.BinarizeOtsu.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

binarizeBradley

public void binarizeBradley(double brightnessDifference)

Binarization of an image using Bradley's adaptive thresholding algorithm using the integral image thresholding

Overrides:

binarizeBradley in class RasterCachedMultipageImage

Parameters:

brightnessDifference - The brightness difference between pixel and the average of an s x s window of pixels centered around this pixel.

orderBlocks

public void orderBlocks()

Orders the GIF blocks according to the GIF specification. Some GifGraphicsControlBlock may be removed for proper GIF layout.

clearBlocks

public void clearBlocks()

Clears all the GIF blocks.

Code example:

The following example shows how to remove all blocks from a GIF image.

com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
try {
    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }

    System.out.println("Clear all the blocks");
    gifImage.clearBlocks();

    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }
} finally {
    firstBlock.dispose();
    gifImage.dispose();
}

// The output looks like this:
// Active frame size: { Width = 100, Height = 100}
// Clear all the blocks
// Active frame is not set

insertBlock

public void insertBlock(int index,
                        IGifBlock block)

Adds a new GIF block.

Parameters:

index - The zero-based element, at which block will be inserted.

block - The GIF block to add.

addBlock

public void addBlock(IGifBlock block)

Adds a new GIF block.

Parameters:

block - The GIF block to add.

Code example:

The following example shows how to compose an animated GIF image from individual GIF blocks.

String dir = "c:\\temp\\";

// Create a GIF image 100 x 100 px.
// The first block is fully black by default.
com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
try {
    // The first circle is red
    com.aspose.imaging.brushes.SolidBrush brush1 = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed());

    // The second circle is black
    com.aspose.imaging.brushes.SolidBrush brush2 = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getBlack());

    // Gradually increase the angle of the red arc shape.
    for (int angle = 10; angle <= 360; angle += 10) {
        com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock block = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);

        com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(block);
        gr.fillPie(brush1, block.getBounds(), 0, angle);

        gifImage.addBlock(block);
    }

    // Gradually increase the angle of the black arc and wipe out the red arc.
    for (int angle = 10; angle <= 360; angle += 10) {
        com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock block = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);

        com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(block);
        gr.fillPie(brush2, block.getBounds(), 0, angle);
        gr.fillPie(brush1, block.getBounds(), angle, 360 - angle);

        gifImage.addBlock(block);
    }

    gifImage.save(dir + "animated_radar.gif");
} finally {
    firstBlock.dispose();
    gifImage.dispose();
}

removeBlock

public void removeBlock(IGifBlock block)

Removes the GIF block.

Parameters:

block - The block to remove.

Note: do not forget to Dispose the block if you will not add it to some other GifImage.

resizeProportional

public void resizeProportional(int newWidth,
                               int newHeight,
                               int resizeType)

Performs proportional resize on the image. The proportional resize will resize each frame according to the ratio of newWidth/width and newHeight/height.

Parameters:

newWidth - The new width.

newHeight - The new height.

resizeType - The resize type.

rotate

public void rotate(float angle,
                   boolean resizeProportionally,
                   Color backgroundColor)

RasterCachedMultipageImage.rotate(float, boolean, Color) image around the center.

Overrides:

rotate in class RasterCachedMultipageImage

Parameters:

angle - The rotation angle in degrees. Positive values will rotate clockwise.

resizeProportionally - if set to true you will have your image size changed according to rotated rectangle (corner points) projections in other case that leaves dimensions untouched and only image contents are rotated.

backgroundColor - Color of the background.