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

Method	Description
getPreviewImageCount()	Access the number of preview images available with ease.
getPreviewImages()	Retrieve the preview images associated with your file.
getFileFormat()	Access the file format of your image with this property.
getEpsType()	Access and interpret the subtype value of your EPS image, streamlining your workflow and enhancing compatibility across platforms.
hasRasterPreview()	Discover the presence of a raster preview effortlessly with this property.
getBitsPerPixel()	Access the precise bit depth of the image effortlessly with this property.
getWidth()	Retrieve the width of the image with this convenient property.
getHeight()	Access the height of the image using this property.
isCached()	This property provides a convenient way to check if the object’s data is currently cached, eliminating the need for additional data reading.
getPsStream()	Gets the stream containing the PostScript to execute.
getPostScriptVersion()	This property retrieves the PostScript version associated with the EpsImage instance.
getTitle()	This property retrieves the title extracted from the EPS Document Structuring Conventions (DSC) comments embedded within the EPS file.
getCreator()	This property offers access to the creator information sourced from EPS Document Structuring Conventions (DSC) comments found within the EPS file.
getCreationDate()	Retrieving the creation date from EPS Document Structuring Conventions (DSC) comments, this property provides essential metadata indicating the EPS file’s inception.
setCreationDate(Date value)	Retrieving the creation date from EPS Document Structuring Conventions (DSC) comments, this property provides essential metadata indicating the EPS file’s inception.
getBoundingBox()	Accessing the original bounding box in device-independent points, this property provides crucial geometric information about the EpsImage dimensions.
getBoundingBoxPx()	This property returns the original bounding box of the EpsImage instance in pixels, providing essential geometric data for accurate rendering and manipulation.
cacheData()	This property returns the original bounding box of the EpsImage instance in pixels, providing essential geometric data for accurate rendering and manipulation.
getPreviewImagesIter()	Accesses the preview images linked to the EpsImage instance, allowing seamless retrieval for inspection or utilization in applications.
getPreviewImage()	Retrieves the existing preview image in the specified format or returns `` if none is found.
getPreviewImage(long format)	Retrieves the existing preview image in the specified format or returns `` if none is found.
resize(int newWidth, int newHeight, int resizeType)	This method resizes the image, adjusting its dimensions according to specified parameters.
resize(int newWidth, int newHeight, ImageResizeSettings settings)	This method resizes the image using predefined settings, allowing for efficient adjustment of dimensions.
rotateFlip(int rotateFlipType)	This method facilitates versatile manipulation of the image by enabling rotation, flipping, or both rotation and flipping simultaneously.
setPalette(IColorPalette palette, boolean updateColors)	Customize image palettes to achieve unique color schemes and enhance visual appeal.
getDefaultOptions(Object[] args)	Retrieve default options effortlessly to streamline image processing tasks.

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()

Access the number of preview images available with ease. This property allows you to effortlessly retrieve the count of preview images associated with your file, enabling efficient management and navigation of your image previews. Ideal for optimizing your workflow and organizing your image assets effectively.

Returns: int

getPreviewImages()

public Image[] getPreviewImages()

Retrieve the preview images associated with your file. This property provides seamless access to the collection of preview images, allowing you to efficiently browse and manage them as needed. Ideal for quickly previewing and selecting the right image for your project.

Returns: com.aspose.imaging.Image[]

getFileFormat()

public long getFileFormat()

Access the file format of your image with this property. Retrieve essential information about the format of your image file, facilitating compatibility and efficient processing. Ideal for identifying the format of your image files for seamless integration into your projects.

Returns: long

getEpsType()

public short getEpsType()

Access and interpret the subtype value of your EPS image, streamlining your workflow and enhancing compatibility across platforms. Ideal for optimizing EPS subtype retrieval in your projects with precision and efficiency.

Returns: short

hasRasterPreview()

public boolean hasRasterPreview()

Discover the presence of a raster preview effortlessly with this property. Access the boolean value indicating whether the EpsImage instance includes a raster preview, empowering your image processing tasks with clarity and efficiency. Ideal for streamlining workflow decisions based on the presence or absence of raster previews in EPS images.

Returns: boolean

getBitsPerPixel()

public int getBitsPerPixel()

Access the precise bit depth of the image effortlessly with this property. Retrieve the bits per pixel count, providing crucial insights into the image’s color depth and aiding in optimizing processing tasks. Ideal for applications requiring fine-grained control over image manipulation and analysis.

Returns: int

getWidth()

public int getWidth()

Retrieve the width of the image with this convenient property. Obtain the image’s width effortlessly, facilitating precise layout calculations, scaling operations, and dimension-related tasks within your application. Ideal for ensuring accurate rendering and display of images across various platforms and devices.

Returns: int - The image width in pixels.

getHeight()

public int getHeight()

Access the height of the image using this property. Obtain the image’s height with ease, enabling seamless layout adjustments, aspect ratio calculations, and precise rendering across different screen resolutions and display environments.

Returns: int - The image height in pixels.

isCached()

public boolean isCached()

This property provides a convenient way to check if the object’s data is currently cached, eliminating the need for additional data reading. It offers a quick and efficient method to determine if the required information is readily available, optimizing performance and reducing resource overhead in data-intensive operations.

Returns: boolean

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()

This property retrieves the PostScript version associated with the EpsImage instance. It offers insight into the specific PostScript language version utilized within the EPS file, aiding in compatibility assessment and facilitating seamless integration with PostScript-compatible environments.

Returns: java.lang.String

getTitle()

public String getTitle()

This property retrieves the title extracted from the EPS Document Structuring Conventions (DSC) comments embedded within the EPS file. It provides valuable metadata about the content of the EPS file, aiding in document organization and identification within compatible software applications.

Returns: java.lang.String

getCreator()

public String getCreator()

This property offers access to the creator information sourced from EPS Document Structuring Conventions (DSC) comments found within the EPS file. Understanding the creator details provides insights into the software or tool used to generate the EPS file, facilitating compatibility assessment across various platforms and applications.

Returns: java.lang.String

getCreationDate()

public Date getCreationDate()

Retrieving the creation date from EPS Document Structuring Conventions (DSC) comments, this property provides essential metadata indicating the EPS file’s inception. By accessing this information, users gain insights into the file’s origin and chronology, enhancing file management and organization.

Returns: java.util.Date

setCreationDate(Date value)

public void setCreationDate(Date value)

Retrieving the creation date from EPS Document Structuring Conventions (DSC) comments, this property provides essential metadata indicating the EPS file’s inception. By accessing this information, users gain insights into the file’s origin and chronology, enhancing file management and organization.

Parameters:

Parameter	Type	Description
value	java.util.Date

getBoundingBox()

public RectangleF getBoundingBox()

Accessing the original bounding box in device-independent points, this property provides crucial geometric information about the EpsImage dimensions. By retrieving this data, users can accurately assess the image’s size and aspect ratio, facilitating precise layout and positioning in various applications.

Returns: RectangleF

getBoundingBoxPx()

public Rectangle getBoundingBoxPx()

This property returns the original bounding box of the EpsImage instance in pixels, providing essential geometric data for accurate rendering and manipulation. With this information, users can ensure precise placement and sizing of EPS images in their projects, enhancing overall visual presentation and quality.

Returns: Rectangle

cacheData()

public void cacheData()

This property returns the original bounding box of the EpsImage instance in pixels, providing essential geometric data for accurate rendering and manipulation. With this information, users can ensure precise placement and sizing of EPS images in their projects, enhancing overall visual presentation and quality.

getPreviewImagesIter()

public Iterable<Image> getPreviewImagesIter()

Accesses the preview images linked to the EpsImage instance, allowing seamless retrieval for inspection or utilization in applications. This method provides convenient access to preview images, enhancing user interaction with the image data.

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

getPreviewImage()

public Image getPreviewImage()

Retrieves the existing preview image in the specified format or returns `` if none is found. This method offers flexibility in accessing preview images tailored to specific formats, optimizing compatibility and resource management within applications.

Returns: Image - The existing preview image or null.

getPreviewImage(long format)

public Image getPreviewImage(long format)

Retrieves the existing preview image in the specified format or returns `` if none is found. This method offers flexibility in accessing preview images tailored to specific formats, optimizing compatibility and resource management within applications.

Parameters:

Parameter	Type	Description
format	long	The 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)

This method resizes the image, adjusting its dimensions according to specified parameters. It offers a straightforward way to modify the size of the image, ensuring flexibility and ease of use for developers.

Parameters:

Parameter	Type	Description
newWidth	int	The new width.
newHeight	int	The new height.
resizeType	int	The 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)

This method resizes the image using predefined settings, allowing for efficient adjustment of dimensions. It provides a convenient way to modify the image size while maintaining control over various parameters, ensuring optimal results for different use cases.

Parameters:

Parameter	Type	Description
newWidth	int	The new width.
newHeight	int	The new height.
settings	ImageResizeSettings	The 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)

This method facilitates versatile manipulation of the image by enabling rotation, flipping, or both rotation and flipping simultaneously. It offers flexibility in adjusting the orientation of the image to suit specific requirements, enhancing its usability and visual appeal.

Parameters:

Parameter	Type	Description
rotateFlipType	int	Type of the rotate flip.

setPalette(IColorPalette palette, boolean updateColors)

public void setPalette(IColorPalette palette, boolean updateColors)

Customize image palettes to achieve unique color schemes and enhance visual appeal. Tailor colors for specific effects and optimize image quality across different platforms and devices with ease.

Parameters:

Parameter	Type	Description
palette	IColorPalette	The palette to set.
updateColors	boolean	if 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)

Retrieve default options effortlessly to streamline image processing tasks. Access preconfigured settings to expedite workflow and ensure consistent output quality without manual configuration.

Parameters:

Parameter	Type	Description
args	java.lang.Object[]	The arguments.

Returns: ImageOptionsBase - Default options