EpsImage

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.DataStreamSupporter, com.aspose.imaging.Image, com.aspose.imaging.VectorImage

public final class EpsImage extends VectorImage

The API for Encapsulated PostScript (EPS) image file format support offers robust capabilities for manipulating compositions comprising text, graphics, and images. With features such as bitmap preview image handling, orientation flipping, bounding box retrieval for illustration bounds, resizing, rotating images, and adding preview images, this API ensures seamless processing and integration of EPS files into various applications with precision and versatility.

Methods

MethodDescription
getPreviewImageCount()Gets the preview image count.
getPreviewImages()Gets the preview images.
getFileFormat()Gets the file format.
getEpsType()Gets EPS subtype value.
hasRasterPreview()Gets the value indicating whether this EpsImage instance has a raster preview.
getBitsPerPixel()Gets the image bits per pixel count.
getWidth()Gets the image width.
getHeight()Gets the image height.
isCached()Gets a value indicating whether object’s data is cached currently and no data reading is required.
getPsStream()Gets the stream containing the PostScript to execute.
getPostScriptVersion()Gets the PostScript version.
getTitle()Gets the title from the EPS DSC comments.
getCreator()Gets the creator from the EPS DSC comments.
getCreationDate()Gets the creation date from the EPS DSC comments.
setCreationDate(Date value)The creation date from the EPS DSC comments.
getBoundingBox()Gets the original bounding box of this EpsImage instance in device independent points.
getBoundingBoxPx()Gets the original bounding box of this EpsImage instance in pixels.
cacheData()Does nothing since currently EpsImage class does not cache data.
getPreviewImagesIter()Gets the iterator with all preview images.
getPreviewImage()Gets the existing preview image by default.
getPreviewImage(long format)Gets the existing preview image of specified format or returns ``.
resize(int newWidth, int newHeight, int resizeType)Resizes the image.
resize(int newWidth, int newHeight, ImageResizeSettings settings)Resizes the image.
rotateFlip(int rotateFlipType)Rotates, flips, or rotates and flips the image.
setPalette(IColorPalette palette, boolean updateColors)Sets the image palette.
getDefaultOptions(Object[] args)Gets the default options.

Example: Convert EPS image to PNG using PostScript rendering.

try (EpsImage image = (EpsImage)Image.load("Sample.eps"))
{
    PngOptions options = new PngOptions();
    EpsRasterizationOptions epsRasterizationOptions = new EpsRasterizationOptions();
    epsRasterizationOptions.setPageWidth(500);  // Image width
    epsRasterizationOptions.setPageHeight(500); // Image height
    epsRasterizationOptions.setPreviewToExport(EpsPreviewFormat.PostScriptRendering); // Render raster image using the PostScript
    options.setVectorRasterizationOptions(epsRasterizationOptions);

    image.save("Sample.png", options);
}

Example: Convert EPS image to PDF using PostScript rendering.

try (EpsImage image = (EpsImage)Image.load("Sample.eps"))
{
    PdfOptions options = new PdfOptions();
    PdfCoreOptions coreOptions = new PdfCoreOptions();
    coreOptions.setPdfCompliance(PdfComplianceVersion.PdfA1b); // Set required PDF compliance
    options.setPdfCoreOptions(coreOptions);

    image.save("Sample.pdf", options);
}

Example: Resize EPS image and export it to PNG format.

// Load EPS image
try (Image image = Image.load("AstrixObelix.eps"))
{
    // Resize the image using the Mitchell cubic interpolation method
    image.resize(400, 400, ResizeType.Mitchell);

    // Export image to PNG format
    image.save("ExportResult.png", new PngOptions());
}

Example: Resize EPS image using advanced settings.

// Load EPS image
try (Image image = Image.load("AstrixObelix.eps"))
{
    ImageResizeSettings resizeSettings = new ImageResizeSettings();
    // Set the interpolation mode
    resizeSettings.setMode(ResizeType.LanczosResample);
    // Set the type of the filter
    resizeSettings.setFilterType(ImageFilterType.SmallRectangular);
    // Sets the color compare method
    resizeSettings.setColorCompareMethod(ColorCompareMethod.Euclidian);
    // Set the color quantization method
    resizeSettings.setColorQuantizationMethod(ColorQuantizationMethod.Popularity);

    // Resize the image using advanced resize settings
    image.resize(400, 400, resizeSettings);

    // Export image to PNG format
    image.save("ExportResult.png", new PngOptions());
}

getPreviewImageCount()

public int getPreviewImageCount()

Gets the preview image count.

Returns: int - the preview image count.

getPreviewImages()

public Image[] getPreviewImages()

Gets the preview images.

Returns: com.aspose.imaging.Image[] - the preview images.

getFileFormat()

public long getFileFormat()

Gets the file format.

Returns: long - the file format.

getEpsType()

public short getEpsType()

Gets EPS subtype value.

Returns: short - EPS subtype value.

hasRasterPreview()

public boolean hasRasterPreview()

Gets the value indicating whether this EpsImage instance has a raster preview.

Returns: boolean - the value indicating whether this EpsImage instance has a raster preview.

getBitsPerPixel()

public int getBitsPerPixel()

Gets the image bits per pixel count.

Returns: int - the image bits per pixel count.

getWidth()

public int getWidth()

Gets the image width.

Value: The image width.

Returns: int - the image width.

getHeight()

public int getHeight()

Gets the image height.

Value: The image height.

Returns: int - the image height.

isCached()

public boolean isCached()

Gets a value indicating whether object’s data is cached currently and no data reading is required.

Returns: boolean - a value indicating whether object’s data is cached currently and no data reading is required.

getPsStream()

public InputStream getPsStream()

Gets the stream containing the PostScript to execute.

Returns: java.io.InputStream - the stream containing the PostScript to execute.

getPostScriptVersion()

public String getPostScriptVersion()

Gets the PostScript version.

Returns: java.lang.String - the PostScript version.

getTitle()

public String getTitle()

Gets the title from the EPS DSC comments.

Returns: java.lang.String - the title from the EPS DSC comments.

getCreator()

public String getCreator()

Gets the creator from the EPS DSC comments.

Returns: java.lang.String - the creator from the EPS DSC comments.

getCreationDate()

public Date getCreationDate()

Gets the creation date from the EPS DSC comments.

Returns: java.util.Date - the creation date from the EPS DSC comments.

setCreationDate(Date value)

public void setCreationDate(Date value)

The creation date from the EPS DSC comments.

Parameters:

ParameterTypeDescription
valuejava.util.Datethe creation date from the EPS DSC comments.

getBoundingBox()

public RectangleF getBoundingBox()

Gets the original bounding box of this EpsImage instance in device independent points.

Returns: RectangleF - the original bounding box of this EpsImage instance in device independent points.

getBoundingBoxPx()

public Rectangle getBoundingBoxPx()

Gets the original bounding box of this EpsImage instance in pixels.

Returns: Rectangle - the original bounding box of this EpsImage instance in pixels.

cacheData()

public void cacheData()

Does nothing since currently EpsImage class does not cache data.

getPreviewImagesIter()

public Iterable<Image> getPreviewImagesIter()

Gets the iterator with all preview images.

Returns: java.lang.Iterable<com.aspose.imaging.Image> - The preview images iterator.

getPreviewImage()

public Image getPreviewImage()

Gets the existing preview image by default.

Returns: Image - The existing preview image or null.

getPreviewImage(long format)

public Image getPreviewImage(long format)

Gets the existing preview image of specified format or returns ``.

Parameters:

ParameterTypeDescription
formatlongThe EPS preview image format.

Returns: Image - The existing preview image or ``.

resize(int newWidth, int newHeight, int resizeType)

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

Resizes the image.

Parameters:

ParameterTypeDescription
newWidthintThe new width.
newHeightintThe new height.
resizeTypeintThe resize type.

Example: Resize EPS image and export it to PNG format.

// Load EPS image
try (Image image = Image.load("AstrixObelix.eps"))
{
    // Resize the image using the Mitchell cubic interpolation method
    image.resize(400, 400, ResizeType.Mitchell);

    // Export image to PNG format
    image.save("ExportResult.png", new PngOptions());
}

resize(int newWidth, int newHeight, ImageResizeSettings settings)

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

Resizes the image.

Parameters:

ParameterTypeDescription
newWidthintThe new width.
newHeightintThe new height.
settingsImageResizeSettingsThe resize settings.

Example: Resize EPS image using advanced settings.

// Load EPS image
try (Image image = Image.load("AstrixObelix.eps"))
{
    ImageResizeSettings resizeSettings = new ImageResizeSettings();
    // Set the interpolation mode
    resizeSettings.setMode(ResizeType.LanczosResample);
    // Set the type of the filter
    resizeSettings.setFilterType(ImageFilterType.SmallRectangular);
    // Sets the color compare method
    resizeSettings.setColorCompareMethod(ColorCompareMethod.Euclidian);
    // Set the color quantization method
    resizeSettings.setColorQuantizationMethod(ColorQuantizationMethod.Popularity);

    // Resize the image using advanced resize settings
    image.resize(400, 400, resizeSettings);

    // Export image to PNG format
    image.save("ExportResult.png", new PngOptions());
}

rotateFlip(int rotateFlipType)

public void rotateFlip(int rotateFlipType)

Rotates, flips, or rotates and flips the image.

Parameters:

ParameterTypeDescription
rotateFlipTypeintType of the rotate flip.

setPalette(IColorPalette palette, boolean updateColors)

public void setPalette(IColorPalette palette, boolean updateColors)

Sets the image palette.

Parameters:

ParameterTypeDescription
paletteIColorPaletteThe palette to set.
updateColorsbooleanif set to true colors will be updated according to the new palette; otherwise color indexes remain unchanged. Note that unchanged indexes may crash the image on loading if some indexes have no corresponding palette entries.

getDefaultOptions(Object[] args)

public ImageOptionsBase getDefaultOptions(Object[] args)

Gets the default options.

Parameters:

ParameterTypeDescription
argsjava.lang.Object[]The arguments.

Returns: ImageOptionsBase - Default options