org.apache.poi.hslf.usermodel.PictureData Maven / Gradle / Ivy
/* ====================================================================
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.poi.hslf.usermodel;
import org.apache.poi.util.LittleEndian;
import org.apache.poi.util.POILogger;
import org.apache.poi.util.POILogFactory;
import org.apache.poi.hslf.model.Picture;
import org.apache.poi.hslf.blip.*;
import org.apache.poi.hslf.exceptions.HSLFException;
import java.io.OutputStream;
import java.io.IOException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.awt.*;
/**
* A class that represents image data contained in a slide show.
*
* @author Yegor Kozlov
*/
public abstract class PictureData {
protected POILogger logger = POILogFactory.getLogger(this.getClass());
/**
* Size of the image checksum calculated using MD5 algorithm.
*/
protected static final int CHECKSUM_SIZE = 16;
/**
* Binary data of the picture
*/
private byte[] rawdata;
/**
* The offset to the picture in the stream
*/
protected int offset;
/**
* Returns type of this picture.
* Must be one of the static constants defined in the Picture class.
*
* @return type of this picture.
*/
public abstract int getType();
/**
* Returns the binary data of this Picture
* @return picture data
*/
public abstract byte[] getData();
/**
* Set picture data
*/
public abstract void setData(byte[] data) throws IOException;
/**
* Blip signature.
*/
protected abstract int getSignature();
protected static ImagePainter[] painters = new ImagePainter[8];
static {
PictureData.setImagePainter(Picture.PNG, new BitmapPainter());
PictureData.setImagePainter(Picture.JPEG, new BitmapPainter());
PictureData.setImagePainter(Picture.DIB, new BitmapPainter());
}
/**
* Returns the raw binary data of this Picture excluding the first 8 bytes
* which hold image signature and size of the image data.
*
* @return picture data
*/
public byte[] getRawData(){
return rawdata;
}
public void setRawData(byte[] data){
rawdata = data;
}
/**
* File offset in the 'Pictures' stream
*
* @return offset in the 'Pictures' stream
*/
public int getOffset(){
return offset;
}
/**
* Set offset of this picture in the 'Pictures' stream.
* We need to set it when a new picture is created.
*
* @param offset in the 'Pictures' stream
*/
public void setOffset(int offset){
this.offset = offset;
}
/**
* Returns 16-byte checksum of this picture
*/
public byte[] getUID(){
byte[] uid = new byte[16];
System.arraycopy(rawdata, 0, uid, 0, uid.length);
return uid;
}
/**
* Compute 16-byte checksum of this picture using MD5 algorithm.
*/
public static byte[] getChecksum(byte[] data) {
MessageDigest sha;
try {
sha = MessageDigest.getInstance("MD5");
} catch (NoSuchAlgorithmException e){
throw new HSLFException(e.getMessage());
}
sha.update(data);
return sha.digest();
}
/**
* Write this picture into OutputStream
*/
public void write(OutputStream out) throws IOException {
byte[] data;
data = new byte[LittleEndian.SHORT_SIZE];
LittleEndian.putUShort(data, 0, getSignature());
out.write(data);
data = new byte[LittleEndian.SHORT_SIZE];
LittleEndian.putUShort(data, 0, getType() + 0xF018);
out.write(data);
byte[] rawdata = getRawData();
data = new byte[LittleEndian.INT_SIZE];
LittleEndian.putInt(data, 0, rawdata.length);
out.write(data);
out.write(rawdata);
}
/**
* Create an instance of PictureData by type.
*
* @param type type of the picture data.
* Must be one of the static constants defined in the Picture class.
* @return concrete instance of PictureData
*/
public static PictureData create(int type){
PictureData pict;
switch (type){
case Picture.EMF:
pict = new EMF();
break;
case Picture.WMF:
pict = new WMF();
break;
case Picture.PICT:
pict = new PICT();
break;
case Picture.JPEG:
pict = new JPEG();
break;
case Picture.PNG:
pict = new PNG();
break;
case Picture.DIB:
pict = new DIB();
break;
default:
throw new IllegalArgumentException("Unsupported picture type: " + type);
}
return pict;
}
/**
* Return 24 byte header which preceeds the actual picture data.
*
* The header consists of 2-byte signature, 2-byte type,
* 4-byte image size and 16-byte checksum of the image data.
*
*
* @return the 24 byte header which preceeds the actual picture data.
*/
public byte[] getHeader() {
byte[] header = new byte[16 + 8];
LittleEndian.putInt(header, 0, getSignature());
LittleEndian.putInt(header, 4, getRawData().length);
System.arraycopy(rawdata, 0, header, 8, 16);
return header;
}
/**
* Return image size in bytes
*
* @return the size of the picture in bytes
* @deprecated Use getData().length instead.
*/
public int getSize(){
return getData().length;
}
public void draw(Graphics2D graphics, Picture parent){
ImagePainter painter = painters[getType()];
if(painter != null) painter.paint(graphics, this, parent);
else logger.log(POILogger.WARN, "Rendering is not supported: " + getClass().getName());
}
/**
* Register ImagePainter for the specified image type
*
* @param type image type, must be one of the static constants defined in the Picture class.
* @param painter
*/
public static void setImagePainter(int type, ImagePainter painter){
painters[type] = painter;
}
/**
* Return ImagePainter for the specified image type
*
* @param type blip type, must be one of the static constants defined in the Picture class.
* @return ImagePainter for the specified image type
*/
public static ImagePainter getImagePainter(int type){
return painters[type];
}
}