create
public static Paint create(Document targetDocument,
ColorSpace colorSpace,
double[] color,
Transparency transparency)
throws ConformanceException
Create an new paint.
Transparency is supported by PDF 1.4 or higher and by PDF/A-2 or higher.
The returned paint object is not yet used on any page, but it is associated with the given target document.
- Parameters:
targetDocument - the output document with which the returned object is associated
colorSpace - the color space of the paint
color - the color components
transparency - the transparency parameters.
Use null to create an opaque paint.
- Returns:
- newly created paint object
- Throws:
ConformanceException - if the transparency argument is not null
and Transparency.getAlpha() of transparency is not 1.0
and the explicitly specified conformance does not support transparency (PDF/A-1, PDF 1.0 - 1.3).
ConformanceException - if the transparency argument is not null
and Transparency.getBlendMode() is not BlendMode.NORMAL
and the explicitly specified conformance does not support transparency (PDF/A-1, PDF 1.0 - 1.3).
java.lang.IllegalArgumentException - if the targetDocument argument has already been closed
java.lang.IllegalArgumentException - if the targetDocument argument is read-only
java.lang.IllegalArgumentException - if the colorSpace object has already been closed
java.lang.IllegalArgumentException - if the colorSpace is associated with a different document
java.lang.IllegalArgumentException - if the color argument contains too few elements
java.lang.IllegalArgumentException - if an element of the color argument is out of range
java.lang.IllegalArgumentException - if targetDocument is null
java.lang.IllegalArgumentException - if colorSpace is null
java.lang.IllegalArgumentException - if color is null