/*
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.
*/
package org.apache.batik.transcoder.image;
import java.awt.image.BufferedImage;
import java.awt.image.SinglePixelPackedSampleModel;
import java.lang.reflect.InvocationTargetException;
import org.apache.batik.bridge.UserAgent;
import org.apache.batik.transcoder.TranscoderException;
import org.apache.batik.transcoder.TranscoderOutput;
import org.apache.batik.transcoder.TranscodingHints;
import org.apache.batik.transcoder.keys.StringKey;
This class is an ImageTranscoder that produces a TIFF image.
Author: Thierry Kormann Version: $Id: TIFFTranscoder.java 1810083 2017-09-29 10:39:45Z ssteiner $
/**
* This class is an <code>ImageTranscoder</code> that produces a TIFF image.
*
* @author <a href="mailto:Thierry.Kormann@sophia.inria.fr">Thierry Kormann</a>
* @version $Id: TIFFTranscoder.java 1810083 2017-09-29 10:39:45Z ssteiner $
*/
public class TIFFTranscoder extends ImageTranscoder {
Constructs a new transcoder that produces tiff images.
/**
* Constructs a new transcoder that produces tiff images.
*/
public TIFFTranscoder() {
hints.put(KEY_FORCE_TRANSPARENT_WHITE, Boolean.FALSE);
}
Returns: the transcoder's user agent
/** @return the transcoder's user agent */
public UserAgent getUserAgent() {
return this.userAgent;
}
Creates a new ARGB image with the specified dimension.
Params: - width – the image width in pixels
- height – the image height in pixels
/**
* Creates a new ARGB image with the specified dimension.
* @param width the image width in pixels
* @param height the image height in pixels
*/
public BufferedImage createImage(int width, int height) {
return new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB);
}
private WriteAdapter getWriteAdapter(String className) {
WriteAdapter adapter;
try {
Class clazz = Class.forName(className);
adapter = (WriteAdapter)clazz.getDeclaredConstructor().newInstance();
return adapter;
} catch (ClassNotFoundException e) {
return null;
} catch (InstantiationException e) {
return null;
} catch (IllegalAccessException e) {
return null;
} catch (NoSuchMethodException e) {
return null;
} catch (InvocationTargetException e) {
return null;
}
}
Writes the specified image to the specified output.
Params: - img – the image to write
- output – the output where to store the image
Throws: - TranscoderException – if an error occured while storing the image
/**
* Writes the specified image to the specified output.
* @param img the image to write
* @param output the output where to store the image
* @throws TranscoderException if an error occured while storing the image
*/
public void writeImage(BufferedImage img, TranscoderOutput output)
throws TranscoderException {
//
// This is a trick so that viewers which do not support the alpha
// channel will see a white background (and not a black one).
//
boolean forceTransparentWhite = false;
if (hints.containsKey(PNGTranscoder.KEY_FORCE_TRANSPARENT_WHITE)) {
forceTransparentWhite =
(Boolean) hints.get
(PNGTranscoder.KEY_FORCE_TRANSPARENT_WHITE);
}
if (forceTransparentWhite) {
SinglePixelPackedSampleModel sppsm;
sppsm = (SinglePixelPackedSampleModel)img.getSampleModel();
forceTransparentWhite(img, sppsm);
}
WriteAdapter adapter = getWriteAdapter(
"org.apache.batik.ext.awt.image.codec.tiff.TIFFTranscoderInternalCodecWriteAdapter");
if (adapter == null) {
adapter = getWriteAdapter(
"org.apache.batik.ext.awt.image.codec.imageio.TIFFTranscoderImageIOWriteAdapter");
}
if (adapter == null) {
throw new TranscoderException(
"Could not write TIFF file because no WriteAdapter is availble");
}
adapter.writeImage(this, img, output);
}
// --------------------------------------------------------------------
// TIFF specific interfaces
// --------------------------------------------------------------------
This interface is used by TIFFTranscoder to write TIFF images
through different codecs.
Version: $Id: TIFFTranscoder.java 1810083 2017-09-29 10:39:45Z ssteiner $
/**
* This interface is used by <code>TIFFTranscoder</code> to write TIFF images
* through different codecs.
*
* @version $Id: TIFFTranscoder.java 1810083 2017-09-29 10:39:45Z ssteiner $
*/
public interface WriteAdapter {
Writes the specified image to the specified output.
Params: - transcoder – the calling PNGTranscoder
- img – the image to write
- output – the output where to store the image
Throws: - TranscoderException – if an error occured while storing the image
/**
* Writes the specified image to the specified output.
* @param transcoder the calling PNGTranscoder
* @param img the image to write
* @param output the output where to store the image
* @throws TranscoderException if an error occured while storing the image
*/
void writeImage(TIFFTranscoder transcoder, BufferedImage img,
TranscoderOutput output) throws TranscoderException;
}
// --------------------------------------------------------------------
// Keys definition
// --------------------------------------------------------------------
The forceTransparentWhite key.
Key:
KEY_FORCE_TRANSPARENT_WHITE
Value:
Boolean
Default:
false
Required:
No
Description:
It controls whether the encoder should
force the image's fully transparent pixels to be fully transparent
white instead of fully transparent black. This is useful when the
encoded TIFF is displayed in a viewer which does not support TIFF
transparency and lets the image display with a white background instead
of a black background.
However, note that the modified image will display differently
over a white background in a viewer that supports
transparency.
/**
* The forceTransparentWhite key.
*
* <table summary="" border="0" cellspacing="0" cellpadding="1">
* <tr>
* <th valign="top" align="right">Key:</th>
* <td valign="top">KEY_FORCE_TRANSPARENT_WHITE</td>
* </tr>
* <tr>
* <th valign="top" align="right">Value:</th>
* <td valign="top">Boolean</td>
* </tr>
* <tr>
* <th valign="top" align="right">Default:</th>
* <td valign="top">false</td>
* </tr>
* <tr>
* <th valign="top" align="right">Required:</th>
* <td valign="top">No</td>
* </tr>
* <tr>
* <th valign="top" align="right">Description:</th>
* <td valign="top">It controls whether the encoder should
* force the image's fully transparent pixels to be fully transparent
* white instead of fully transparent black. This is useful when the
* encoded TIFF is displayed in a viewer which does not support TIFF
* transparency and lets the image display with a white background instead
* of a black background.
* <br>
* However, note that the modified image will display differently
* over a white background in a viewer that supports
* transparency.</td>
* </tr>
* </table>
*/
public static final TranscodingHints.Key KEY_FORCE_TRANSPARENT_WHITE
= ImageTranscoder.KEY_FORCE_TRANSPARENT_WHITE;
The compression method for the image.
Key:
KEY_COMPRESSION_METHOD
Value:
String ("none", "packbits", "jpeg" etc.)
Default:
"none" (no compression)
Required:
Recommended
Description:
Specify the compression method used to encode the image.
/**
* The compression method for the image.
* <table summary="" border="0" cellspacing="0" cellpadding="1">
* <tr>
* <th valign="top" align="right">Key:</th>
* <td valign="top">KEY_COMPRESSION_METHOD</td>
* </tr>
* <tr>
* <th valign="top" align="right">Value:</th>
* <td valign="top">String ("none", "packbits", "jpeg" etc.)</td>
* </tr>
* <tr>
* <th valign="top" align="right">Default:</th>
* <td valign="top">"none" (no compression)</td>
* </tr>
* <tr>
* <th valign="top" align="right">Required:</th>
* <td valign="top">Recommended</td>
* </tr>
* <tr>
* <th valign="top" align="right">Description:</th>
* <td valign="top">Specify the compression method used to encode the image.</td>
* </tr>
* </table>
*/
public static final TranscodingHints.Key KEY_COMPRESSION_METHOD
= new StringKey();
}