Class PDColorSpace
java.lang.Object
org.apache.pdfbox.pdmodel.graphics.color.PDColorSpace
- All Implemented Interfaces:
COSObjectable
- Direct Known Subclasses:
PDCIEBasedColorSpace
,PDDeviceColorSpace
,PDJPXColorSpace
,PDSpecialColorSpace
A color space specifies how the colours of graphics objects will be painted on the page.
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic PDColorSpace
Creates a color space given a name or array.static PDColorSpace
create
(COSBase colorSpace, PDResources resources) Creates a color space given a name or array.static PDColorSpace
create
(COSBase colorSpace, PDResources resources, boolean wasDefault) Creates a color space given a name or array.private static PDColorSpace
createFromCOSObject
(COSObject colorSpace, PDResources resources) Convert this standard java object to a COS object.abstract float[]
getDefaultDecode
(int bitsPerComponent) Returns the default decode array for this color space.abstract PDColor
Returns the initial color value for this color space.abstract String
getName()
Returns the name of the color space.abstract int
Returns the number of components in this color spaceabstract BufferedImage
toRawImage
(WritableRaster raster) Returns the image in this colorspace or null.protected final BufferedImage
toRawImage
(WritableRaster raster, ColorSpace awtColorSpace) Returns the given raster as BufferedImage with the given awtColorSpace using a ComponentColorModel.abstract float[]
toRGB
(float[] value) Returns the RGB equivalent of the given color value.abstract BufferedImage
toRGBImage
(WritableRaster raster) Returns the (A)RGB equivalent of the given raster.protected BufferedImage
toRGBImageAWT
(WritableRaster raster, ColorSpace colorSpace) Returns the (A)RGB equivalent of the given raster, using the given AWT color space to perform the conversion.
-
Field Details
-
colorConvertOp
-
array
-
-
Constructor Details
-
PDColorSpace
public PDColorSpace()
-
-
Method Details
-
create
Creates a color space given a name or array.- Parameters:
colorSpace
- the color space COS object- Returns:
- a new color space
- Throws:
IOException
- if the color space is unknown or cannot be created
-
create
Creates a color space given a name or array. Abbreviated device color names are not supported here, please replace them first.- Parameters:
colorSpace
- the color space COS objectresources
- the current resources.- Returns:
- a new color space
- Throws:
MissingResourceException
- if the color space is missing in the resources dictionaryIOException
- if the color space is unknown or cannot be created
-
create
public static PDColorSpace create(COSBase colorSpace, PDResources resources, boolean wasDefault) throws IOException Creates a color space given a name or array. Abbreviated device color names are not supported here, please replace them first. This method is for PDFBox internal use only, others should usecreate(COSBase, PDResources)
.- Parameters:
colorSpace
- the color space COS objectresources
- the current resources.wasDefault
- if current color space was used by a default color space.- Returns:
- a new color space.
- Throws:
MissingResourceException
- if the color space is missing in the resources dictionaryIOException
- if the color space is unknown or cannot be created.
-
createFromCOSObject
private static PDColorSpace createFromCOSObject(COSObject colorSpace, PDResources resources) throws IOException - Throws:
IOException
-
getName
Returns the name of the color space.- Returns:
- the name of the color space
-
getNumberOfComponents
public abstract int getNumberOfComponents()Returns the number of components in this color space- Returns:
- the number of components in this color space
-
getDefaultDecode
public abstract float[] getDefaultDecode(int bitsPerComponent) Returns the default decode array for this color space.- Parameters:
bitsPerComponent
- the number of bits per component.- Returns:
- the default decode array
-
getInitialColor
Returns the initial color value for this color space.- Returns:
- the initial color value for this color space
-
toRGB
Returns the RGB equivalent of the given color value.- Parameters:
value
- a color value with component values between 0 and 1- Returns:
- an array of R,G,B value between 0 and 255
- Throws:
IOException
- if the color conversion fails
-
toRGBImage
Returns the (A)RGB equivalent of the given raster.- Parameters:
raster
- the source raster- Returns:
- an (A)RGB buffered image
- Throws:
IOException
- if the color conversion fails
-
toRawImage
Returns the image in this colorspace or null. No conversion is performed. For special colorspaces like PDSeparation the image is returned in the gray colorspace. For undefined colorspaces like DeviceCMYK/DeviceRGB and DeviceGray null is returned. You can always fallback totoRGBImage(WritableRaster)
if this returns null.- Parameters:
raster
- the source raster- Returns:
- an buffered image in this colorspace. Or null if it is not possible to extract that image with the original colorspace without conversion.
- Throws:
IOException
-
toRawImage
Returns the given raster as BufferedImage with the given awtColorSpace using a ComponentColorModel.- Parameters:
raster
- the source rasterawtColorSpace
- the AWT colorspace- Returns:
- a BufferedImage in this colorspace
-
toRGBImageAWT
Returns the (A)RGB equivalent of the given raster, using the given AWT color space to perform the conversion.- Parameters:
raster
- the source rastercolorSpace
- the AWT- Returns:
- an (A)RGB buffered image
-
getCOSObject
Description copied from interface:COSObjectable
Convert this standard java object to a COS object.- Specified by:
getCOSObject
in interfaceCOSObjectable
- Returns:
- The cos object that matches this Java object.
-