Class PDInlineImage

java.lang.Object
org.apache.pdfbox.pdmodel.graphics.image.PDInlineImage
All Implemented Interfaces:
COSObjectable, PDImage

public final class PDInlineImage extends Object implements PDImage
An inline image object which uses a special syntax to express the data for a small image directly within the content stream.
Author:
Ben Litchfield, John Hewson
  • Constructor Details

    • PDInlineImage

      public PDInlineImage(COSDictionary parameters, byte[] data, PDResources resources) throws IOException
      Creates an inline image from the given parameters and data.
      Parameters:
      parameters - the image parameters
      data - the image data
      resources - the current resources
      Throws:
      IOException - if the stream cannot be decoded
  • Method Details

    • getCOSObject

      public COSBase getCOSObject()
      Description copied from interface: COSObjectable
      Convert this standard java object to a COS object.
      Specified by:
      getCOSObject in interface COSObjectable
      Returns:
      The cos object that matches this Java object.
    • getBitsPerComponent

      public int getBitsPerComponent()
      Description copied from interface: PDImage
      Returns bits per component of this image, or -1 if one has not been set.
      Specified by:
      getBitsPerComponent in interface PDImage
    • setBitsPerComponent

      public void setBitsPerComponent(int bitsPerComponent)
      Description copied from interface: PDImage
      Set the number of bits per component.
      Specified by:
      setBitsPerComponent in interface PDImage
      Parameters:
      bitsPerComponent - The number of bits per component.
    • getColorSpace

      public PDColorSpace getColorSpace() throws IOException
      Description copied from interface: PDImage
      Returns the image's color space.
      Specified by:
      getColorSpace in interface PDImage
      Throws:
      IOException - If there is an error getting the color space.
    • setColorSpace

      public void setColorSpace(PDColorSpace colorSpace)
      Description copied from interface: PDImage
      Sets the color space for this image.
      Specified by:
      setColorSpace in interface PDImage
      Parameters:
      colorSpace - The color space for this image.
    • getHeight

      public int getHeight()
      Description copied from interface: PDImage
      Returns height of this image, or -1 if one has not been set.
      Specified by:
      getHeight in interface PDImage
    • setHeight

      public void setHeight(int height)
      Description copied from interface: PDImage
      Sets the height of the image.
      Specified by:
      setHeight in interface PDImage
      Parameters:
      height - The height of the image.
    • getWidth

      public int getWidth()
      Description copied from interface: PDImage
      Returns the width of this image, or -1 if one has not been set.
      Specified by:
      getWidth in interface PDImage
    • setWidth

      public void setWidth(int width)
      Description copied from interface: PDImage
      Sets the width of the image.
      Specified by:
      setWidth in interface PDImage
      Parameters:
      width - The width of the image.
    • getInterpolate

      public boolean getInterpolate()
      Description copied from interface: PDImage
      Returns true if the image should be interpolated when rendered.
      Specified by:
      getInterpolate in interface PDImage
    • setInterpolate

      public void setInterpolate(boolean value)
      Description copied from interface: PDImage
      Sets the Interpolate flag, true for high-quality image scaling.
      Specified by:
      setInterpolate in interface PDImage
    • getFilters

      public List<String> getFilters()
      Returns a list of filters applied to this stream, or null if there are none.
      Returns:
      a list of filters applied to this stream
    • setFilters

      public void setFilters(List<String> filters)
      Sets which filters are applied to this stream.
      Parameters:
      filters - the filters to apply to this stream.
    • setDecode

      public void setDecode(COSArray decode)
      Description copied from interface: PDImage
      Sets the decode array.
      Specified by:
      setDecode in interface PDImage
      Parameters:
      decode - the new decode array.
    • getDecode

      public COSArray getDecode()
      Description copied from interface: PDImage
      Returns the decode array.
      Specified by:
      getDecode in interface PDImage
    • isStencil

      public boolean isStencil()
      Description copied from interface: PDImage
      Returns true if the image is a stencil mask.
      Specified by:
      isStencil in interface PDImage
    • setStencil

      public void setStencil(boolean isStencil)
      Description copied from interface: PDImage
      Sets whether or not the image is a stencil. This corresponds to the ImageMask entry in the image stream's dictionary.
      Specified by:
      setStencil in interface PDImage
      Parameters:
      isStencil - True to make the image a stencil.
    • createInputStream

      public InputStream createInputStream() throws IOException
      Description copied from interface: PDImage
      Returns an InputStream containing the image data, irrespective of whether this is an inline image or an image XObject.
      Specified by:
      createInputStream in interface PDImage
      Returns:
      Decoded stream
      Throws:
      IOException - if the data could not be read.
    • createInputStream

      public InputStream createInputStream(DecodeOptions options) throws IOException
      Description copied from interface: PDImage
      Returns an InputStream, passing additional options to each filter. As a side effect, the filterSubsampled flag is set in DecodeOptions.
      Specified by:
      createInputStream in interface PDImage
      Parameters:
      options - Additional decoding options passed to the filters used
      Returns:
      Decoded stream
      Throws:
      IOException - if the data could not be read
    • createInputStream

      public InputStream createInputStream(List<String> stopFilters) throws IOException
      Description copied from interface: PDImage
      Returns an InputStream containing the image data, irrespective of whether this is an inline image or an image XObject. The given filters will not be decoded.
      Specified by:
      createInputStream in interface PDImage
      Parameters:
      stopFilters - A list of filters to stop decoding at.
      Returns:
      Decoded stream
      Throws:
      IOException - if the data could not be read.
    • isEmpty

      public boolean isEmpty()
      Description copied from interface: PDImage
      Returns true if the image has no data.
      Specified by:
      isEmpty in interface PDImage
    • getData

      public byte[] getData()
      Returns the inline image data.
    • getImage

      public BufferedImage getImage() throws IOException
      Description copied from interface: PDImage
      Returns the content of this image as an AWT buffered image with an (A)RGB color space. The size of the returned image is the larger of the size of the image itself or its mask.
      Specified by:
      getImage in interface PDImage
      Returns:
      content of this image as a buffered image.
      Throws:
      IOException
    • getImage

      public BufferedImage getImage(Rectangle region, int subsampling) throws IOException
      Description copied from interface: PDImage
      Returns the content of this image as an AWT buffered image with an (A)RGB colored space. Only the subregion specified is rendered, and is subsampled by advancing the specified amount of rows and columns in the source image for every resulting pixel. Note that unlike the unparameterized version, this method does not cache the resulting image.
      Specified by:
      getImage in interface PDImage
      Parameters:
      region - The region of the source image to get, or null if the entire image is needed. The actual region will be clipped to the dimensions of the source image.
      subsampling - The amount of rows and columns to advance for every output pixel, a value of 1 meaning every pixel will be read
      Returns:
      subsampled content of the requested subregion as a buffered image.
      Throws:
      IOException
    • getRawRaster

      public WritableRaster getRawRaster() throws IOException
      Description copied from interface: PDImage
      Return the image data as WritableRaster. You should consult the PDColorSpace returned by PDImage.getColorSpace() to know how to interpret the data in this WritableRaster. Use this if e.g. want access to the raw color information of a PDDeviceN image.
      Specified by:
      getRawRaster in interface PDImage
      Returns:
      the raw writable raster for this image
      Throws:
      IOException
    • getRawImage

      public BufferedImage getRawImage() throws IOException
      Description copied from interface: PDImage
      Try to get the raw image as AWT buffered image with it's original colorspace. No color conversion is performed. You could use the returned BufferedImage for draw operations. But this would be very slow as the color conversion would happen on demand. You rather should use PDImage.getImage() for that. This method returns null if it is not possible to map the underlying colorspace into a java.awt.ColorSpace. Use this method if you want to extract the image without loosing any color information, as no color conversion will be performed. You can alwoys use PDImage.getRawRaster(), if you want to access the raw data even if no matching java.awt.ColorSpace exists
      Specified by:
      getRawImage in interface PDImage
      Returns:
      the raw image with a java.awt.ColorSpace or null
      Throws:
      IOException
    • getStencilImage

      public BufferedImage getStencilImage(Paint paint) throws IOException
      Description copied from interface: PDImage
      Returns an ARGB image filled with the given paint and using this image as a mask.
      Specified by:
      getStencilImage in interface PDImage
      Parameters:
      paint - the paint to fill the visible portions of the image with
      Returns:
      a masked image filled with the given paint
      Throws:
      IOException - if the image cannot be read
    • getColorKeyMask

      @Deprecated public COSArray getColorKeyMask()
      Deprecated.
      inline images don't have a color key mask.
      Returns the color key mask array associated with this image, or null if there is none.
      Returns:
      Mask Image XObject
    • getSuffix

      public String getSuffix()
      Returns the suffix for this image type, e.g. jpg/png.
      Specified by:
      getSuffix in interface PDImage
      Returns:
      The image suffix.