com.itextpdf.pdfoptimizer.handlers.converters

Class AbstractCsConverter

java.lang.Object

com.itextpdf.pdfoptimizer.handlers.converters.AbstractCsConverter

All Implemented Interfaces:

ICsConverter

Direct Known Subclasses:

CmykToRgbCsConverter, RgbToCmykCsConverter

public abstract class AbstractCsConverter
extends Object
implements ICsConverter

This is the abstract class for color space converters which are used to convert PDF objects in the original color space to PDF objects in target color space.

Constructor Summary

Constructors

Constructor and Description
AbstractCsConverter(CsConverterProperties csConverterProperties)

Method Summary

Modifier and Type	Method and Description
void	attemptToConvertTransparencyGroup(com.itextpdf.kernel.pdf.PdfObject groupEntryHolder, OptimizationSession session) Attempt to converts transparency group dictionary which stored in passed groupEntryHolder PDF object, if this groupEntryHolder can store transparency group by PDF specification.
com.itextpdf.kernel.pdf.PdfArray	convertAnnotationIcArray(com.itextpdf.kernel.pdf.PdfArray icArray) Converts annotation interior color array by using of current color converter.
com.itextpdf.kernel.pdf.PdfStream	convertContentStream(com.itextpdf.kernel.pdf.PdfStream stream, com.itextpdf.kernel.pdf.PdfResources externalResources, OptimizationSession session) Converts color space of the passed content stream.
com.itextpdf.kernel.pdf.xobject.PdfImageXObject	convertImageCs(com.itextpdf.kernel.pdf.xobject.PdfImageXObject imageToConvert, OptimizationSession session) Converts passed image in original color space to image in target color space.
protected List	convertOperatorParameters(List operands) Converts passed operator parameters color space.
void	convertStoredResources(OptimizationSession session) Converts color space of the stored content stream resources.
protected abstract ColorConverter	getColorConverter() Gets ColorConverter for appropriate convertion.
CsConverterProperties	getConverterProperties() Gets current converter properties instance.
protected abstract Class	getOriginalCsClass() Gets original color space class.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractCsConverter

public AbstractCsConverter(CsConverterProperties csConverterProperties)

Method Detail

convertImageCs

public com.itextpdf.kernel.pdf.xobject.PdfImageXObject convertImageCs(com.itextpdf.kernel.pdf.xobject.PdfImageXObject imageToConvert,
                                                                      OptimizationSession session)

Converts passed image in original color space to image in target color space.

Specified by:

convertImageCs in interface ICsConverter

Parameters:

imageToConvert - the image in original color space

session - is an auxiliary object used to support share data between stages of optimization process

Returns:

the image in target color space if converting can be performed and the same instance otherwise

convertContentStream

public com.itextpdf.kernel.pdf.PdfStream convertContentStream(com.itextpdf.kernel.pdf.PdfStream stream,
                                                              com.itextpdf.kernel.pdf.PdfResources externalResources,
                                                              OptimizationSession session)

Converts color space of the passed content stream. Note that this method does not process content stream resources and passed external resources. Also, this method saves resources for their subsequent processing within the convertStoredResources(OptimizationSession) method.

Specified by:

convertContentStream in interface ICsConverter

Parameters:

stream - the PDF content stream instance for conversion

externalResources - the external content stream resources. Used in the case when the page content stream is converted, and the resources are stored not in the content stream but in the page dictionary. In other case should be null

session - is an auxiliary object used to support share data between stages of optimization process

Returns:

the content stream with converted color space if converting can be performed and the same instance otherwise

convertStoredResources

public void convertStoredResources(OptimizationSession session)

Converts color space of the stored content stream resources. Resource stored takes place within the convertContentStream(PdfStream, PdfResources, OptimizationSession) method. Note that this method should be called after all content streams have been processed.

Specified by:

convertStoredResources in interface ICsConverter

Parameters:

session - is an auxiliary object used to support share data between stages of optimization process

convertAnnotationIcArray

public com.itextpdf.kernel.pdf.PdfArray convertAnnotationIcArray(com.itextpdf.kernel.pdf.PdfArray icArray)

Converts annotation interior color array by using of current color converter.

Specified by:

convertAnnotationIcArray in interface ICsConverter

Parameters:

icArray - the interior color array

Returns:

the converted interior color array if converting can be performed and the same instance otherwise

attemptToConvertTransparencyGroup

public void attemptToConvertTransparencyGroup(com.itextpdf.kernel.pdf.PdfObject groupEntryHolder,
                                              OptimizationSession session)

Description copied from interface: ICsConverter

Attempt to converts transparency group dictionary which stored in passed groupEntryHolder PDF object, if this groupEntryHolder can store transparency group by PDF specification.

Specified by:

attemptToConvertTransparencyGroup in interface ICsConverter

Parameters:

groupEntryHolder - the PDF object which stored transparency group dictionary to convert

session - is an auxiliary object used to support share data between stages of optimization process

getConverterProperties

public CsConverterProperties getConverterProperties()

Description copied from interface: ICsConverter

Gets current converter properties instance.

Specified by:

getConverterProperties in interface ICsConverter

Returns:

the converter properties instance

getOriginalCsClass

protected abstract Class getOriginalCsClass()

Gets original color space class. The result of this method is used to check that passed PDF object has a necessary color space.

Returns:

the original color space class

getColorConverter

protected abstract ColorConverter getColorConverter()

Gets ColorConverter for appropriate convertion. The result of this method is used for conversion and for filling necessary fields in converted PDF object.

Returns:

the target color space name

convertOperatorParameters

protected List convertOperatorParameters(List operands)

Converts passed operator parameters color space.

Parameters:

operands - the operator with operator parameters

Returns:

the converted operator parameters without parameter