/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* $Id: TIFFRenderer.java 447325 2006-09-18 10:55:33 +0200 (Mon, 18 Sep 2006) jeremias $ */
package org.apache.fop.render.bitmap;
// Code originaly contributed by Oleg Tkachenko of Multiconn International Ltd
// (olegt@multiconn.com).
import java.awt.image.BufferedImage;
import java.awt.image.DataBuffer;
import java.awt.image.PixelInterleavedSampleModel;
import java.awt.image.RenderedImage;
import java.awt.image.SampleModel;
import java.awt.image.SinglePixelPackedSampleModel;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Iterator;
import org.apache.avalon.framework.configuration.Configuration;
import org.apache.avalon.framework.configuration.ConfigurationException;
import org.apache.commons.logging.Log;
import org.apache.xmlgraphics.image.GraphicsUtil;
import org.apache.xmlgraphics.image.rendered.FormatRed;
import org.apache.xmlgraphics.image.writer.ImageWriter;
import org.apache.xmlgraphics.image.writer.ImageWriterParams;
import org.apache.xmlgraphics.image.writer.ImageWriterRegistry;
import org.apache.xmlgraphics.image.writer.MultiImageWriter;
import org.apache.fop.apps.FOPException;
import org.apache.fop.apps.FOUserAgent;
import org.apache.fop.apps.MimeConstants;
import org.apache.fop.render.java2d.Java2DRenderer;
/**
* <p>
* This class represents renderer to TIFF (Tagged Image File Format) format. It
* is one of the most popular and flexible of the current public domain raster
* file formats, which was is primarily designed for raster data interchange.
* Supported compression types are:
* <ul>
* <li>Raw noncompressed data</li>
* <li>Byte-oriented run-length encoding "PackBits" compression.</li>
* <li>Modified Huffman Compression (CCITT Group 3 1D facsimile compression)</li>
* <li>CCITT T.4 bilevel compression (CCITT Group 3 2D facsimile compression)</li>
* <li>CCITT T.6 bilevel compression (CCITT Group 4 facsimile compression)</li>
* <li>JPEG-in-TIFF compression</li>
* <li>DEFLATE lossless compression (also known as "Zip-in-TIFF")</li>
* <li>LZW compression</li>
* TODO
* <p>
* This class actually does not render itself, instead it extends
* <code>org.apache.fop.render.java2D.Java2DRenderer</code> and just encode
* rendering results into TIFF format using Batik's image codec
*/
public class TIFFRenderer extends Java2DRenderer {
/** The MIME type for tiff-Rendering */
public static final String MIME_TYPE = MimeConstants.MIME_TIFF;
//private static final String COMPRESSION_NONE = "NONE";
//private static final String COMPRESSION_JPEG = "JPEG";
private static final String COMPRESSION_PACKBITS = "PackBits";
//private static final String COMPRESSION_DEFLATE = "Deflate";
//private static final String COMPRESSION_LZW = "LZW";
//private static final String COMPRESSION_ZLIB = "ZLib";
private static final String COMPRESSION_CCITT_T6 = "CCITT T.6"; //CCITT Group 4
private static final String COMPRESSION_CCITT_T4 = "CCITT T.4"; //CCITT Group 3
/** ImageWriter parameters */
private ImageWriterParams writerParams;
/** Image Type as parameter for the BufferedImage constructor (see BufferedImage.TYPE_*) */
private int bufferedImageType = BufferedImage.TYPE_INT_ARGB;
private OutputStream outputStream;
/** @see org.apache.fop.render.AbstractRenderer */
public String getMimeType() {
return MIME_TYPE;
}
/** Creates TIFF renderer. */
public TIFFRenderer() {
writerParams = new ImageWriterParams();
writerParams.setCompressionMethod(COMPRESSION_PACKBITS);
}
/**
* @see org.apache.fop.render.java2d.Java2DRenderer#setUserAgent(
* org.apache.fop.apps.FOUserAgent)
*/
public void setUserAgent(FOUserAgent foUserAgent) {
super.setUserAgent(foUserAgent);
//Set target resolution
int dpi = Math.round(userAgent.getTargetResolution());
writerParams.setResolution(dpi);
}
/**
* Configure the TIFF renderer. Get the configuration to be used for
* compression
* @see org.apache.avalon.framework.configuration.Configurable#configure(Configuration)
*/
public void configure(Configuration cfg) throws ConfigurationException {
super.configure(cfg);
//set compression
String name = cfg.getChild("compression").getValue(COMPRESSION_PACKBITS);
//Some compression formats need a special image format:
if (name.equalsIgnoreCase(COMPRESSION_CCITT_T6)) {
bufferedImageType = BufferedImage.TYPE_BYTE_BINARY;
} else if (name.equalsIgnoreCase(COMPRESSION_CCITT_T4)) {
bufferedImageType = BufferedImage.TYPE_BYTE_BINARY;
} else {
bufferedImageType = BufferedImage.TYPE_INT_ARGB;
}
if (!"NONE".equalsIgnoreCase(name)) {
writerParams.setCompressionMethod(name);
}
log.info("TIFF compression set to " + name);
}
/** @see org.apache.fop.render.Renderer#startRenderer(java.io.OutputStream) */
public void startRenderer(OutputStream outputStream) throws IOException {
this.outputStream = outputStream;
super.startRenderer(outputStream);
}
/** @see org.apache.fop.render.Renderer#stopRenderer() */
public void stopRenderer() throws IOException {
super.stopRenderer();
log.debug("Starting TIFF encoding ...");
// Creates lazy iterator over generated page images
Iterator pageImagesItr = new LazyPageImagesIterator(getNumberOfPages(), log);
// Creates writer
ImageWriter writer = ImageWriterRegistry.getInstance().getWriterFor(getMimeType());
if (writer == null) {
throw new NullPointerException("No ImageWriter for " + getMimeType() + " available!");
}
if (writer.supportsMultiImageWriter()) {
MultiImageWriter multiWriter = writer.createMultiImageWriter(outputStream);
try {
// Write all pages/images
while (pageImagesItr.hasNext()) {
RenderedImage img = (RenderedImage) pageImagesItr.next();
multiWriter.writeImage(img, writerParams);
}
} finally {
multiWriter.close();
}
} else {
writer.writeImage((RenderedImage) pageImagesItr.next(), outputStream, writerParams);
if (pageImagesItr.hasNext()) {
log.error("Image encoder does not support multiple images. Only the first page"
+ " has been produced.");
}
}
// Cleaning
outputStream.flush();
clearViewportList();
log.debug("TIFF encoding done.");
}
/** @see org.apache.fop.render.java2d.Java2DRenderer#getBufferedImage(int, int) */
protected BufferedImage getBufferedImage(int bitmapWidth, int bitmapHeight) {
return new BufferedImage(bitmapWidth, bitmapHeight, bufferedImageType);
}
/** Private inner class to lazy page rendering. */
private class LazyPageImagesIterator implements Iterator {
/** logging instance */
private Log log;
private int count;
private int current = 0;
/**
* Main constructor
* @param c number of pages to iterate over
* @param log the logger to use (this is a hack so this compiles under JDK 1.3)
*/
public LazyPageImagesIterator(int c, Log log) {
count = c;
this.log = log;
}
public boolean hasNext() {
return current < count;
}
public Object next() {
if (log.isDebugEnabled()) {
log.debug("[" + (current + 1) + "]");
}
// Renders current page as image
BufferedImage pageImage = null;
try {
pageImage = getPageImage(current++);
} catch (FOPException e) {
log.error(e);
return null;
}
if (COMPRESSION_CCITT_T4.equalsIgnoreCase(writerParams.getCompressionMethod())
|| COMPRESSION_CCITT_T6.equalsIgnoreCase(writerParams.getCompressionMethod())) {
return pageImage;
} else {
//Decorate the image with a packed sample model for encoding by the codec
SinglePixelPackedSampleModel sppsm;
sppsm = (SinglePixelPackedSampleModel)pageImage.getSampleModel();
int bands = sppsm.getNumBands();
int[] off = new int[bands];
int w = pageImage.getWidth();
int h = pageImage.getHeight();
for (int i = 0; i < bands; i++) {
off[i] = i;
}
SampleModel sm = new PixelInterleavedSampleModel(
DataBuffer.TYPE_BYTE, w, h, bands, w * bands, off);
RenderedImage rimg = new FormatRed(GraphicsUtil.wrap(pageImage), sm);
return rimg;
}
}
public void remove() {
throw new UnsupportedOperationException(
"Method 'remove' is not supported.");
}
}
}