/**
* Applies this transform to a PDF page.
*
* <p>Using the configured PDF operator processors, a PDF stream engine ({@link PDFStreamEngine}
* parent class) iterates through the page's token stream, aggregating operands and invoking the
* appropriate PDF operator processor for each PDF operator encountered. An output list of tokens
* is created. At the end of the iteration, if any PDF operator processor has indicated to this
* transform that it has changed the output list compared to the original stream, the PDF page's
* contents are replaced with those of the output list (otherwise the PDF page is unchanged).
*
* @param pdfPage A PDF page (belonging to the PDF document).
* @throws PageTransformException if the output list stack does not have exactly one output list
* at the end of the transform.
* @throws IOException if any other processing error occurs.
* @see PDFStreamEngine#processStream
* @see #reset
*/
public synchronized boolean transform(PdfPage pdfPage) throws IOException {
logger.debug3("Begin page stream transform");
// Iterate over stream
reset();
this.currentPdfPage = pdfPage;
processStream(pdfPage.getPdPage(), pdfPage.findResources(), pdfPage.getContentStream());
// Sanity check
if (listStack.size() != 1) {
String logMessage =
"Split/merge mismatch: after processing stream, list stack has size " + listStack.size();
logger.error(logMessage);
throw new PageTransformException(logMessage);
}
writeResult(pdfPage);
logger.debug2("Page stream transform result: " + atLeastOneChange);
return atLeastOneChange;
}
