com.jogamp.opengl.util.texture.spi.SGIImage Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jogl Show documentation
Show all versions of jogl Show documentation
Java™ Binding for the OpenGL® API (Atomic Jar files)
/*
* Portions Copyright (c) 2005 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* - Redistribution of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* - Redistribution in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
* INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
* PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN
* MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR
* ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
* DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR
* ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR
* DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE
* DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF
* SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed or intended for use
* in the design, construction, operation or maintenance of any nuclear
* facility.
*
* Sun gratefully acknowledges that this software was originally authored
* and developed by Kenneth Bradley Russell and Christopher John Kline.
*/
package com.jogamp.opengl.util.texture.spi;
import java.io.*;
import javax.media.opengl.*;
import com.jogamp.common.util.IOUtil;
/** Reads and writes SGI RGB/RGBA images.
Written from Paul
Bourke's adaptation of the SGI
specification.
*/
public class SGIImage {
private final Header header;
private int format;
private byte[] data;
// Used for decoding RLE-compressed images
private int[] rowStart;
private int[] rowSize;
private int rleEnd;
private byte[] tmpData;
private byte[] tmpRead;
private static final int MAGIC = 474;
static class Header {
short magic; // IRIS image file magic number
// This should be decimal 474
byte storage; // Storage format
// 0 for uncompressed
// 1 for RLE compression
byte bpc; // Number of bytes per pixel channel
// Legally 1 or 2
short dimension; // Number of dimensions
// Legally 1, 2, or 3
// 1 means a single row, XSIZE long
// 2 means a single 2D image
// 3 means multiple 2D images
short xsize; // X size in pixels
short ysize; // Y size in pixels
short zsize; // Number of channels
// 1 indicates greyscale
// 3 indicates RGB
// 4 indicates RGB and Alpha
int pixmin; // Minimum pixel value
// This is the lowest pixel value in the image
int pixmax; // Maximum pixel value
// This is the highest pixel value in the image
int dummy; // Ignored
// Normally set to 0
String imagename; // Image name; 80 bytes long
// Must be null terminated, therefore at most 79 bytes
int colormap; // Colormap ID
// 0 - normal mode
// 1 - dithered, 3 mits for red and green, 2 for blue, obsolete
// 2 - index colour, obsolete
// 3 - not an image but a colourmap
// 404 bytes char DUMMY Ignored
// Should be set to 0, makes the header 512 bytes.
Header() {
magic = MAGIC;
}
Header(final DataInputStream in) throws IOException {
magic = in.readShort();
storage = in.readByte();
bpc = in.readByte();
dimension = in.readShort();
xsize = in.readShort();
ysize = in.readShort();
zsize = in.readShort();
pixmin = in.readInt();
pixmax = in.readInt();
dummy = in.readInt();
final byte[] tmpname = new byte[80];
in.read(tmpname);
int numChars = 0;
while (tmpname[numChars++] != 0);
imagename = new String(tmpname, 0, numChars);
colormap = in.readInt();
final byte[] tmp = new byte[404];
in.read(tmp);
}
@Override
public String toString() {
return ("magic: " + magic +
" storage: " + (int) storage +
" bpc: " + (int) bpc +
" dimension: " + dimension +
" xsize: " + xsize +
" ysize: " + ysize +
" zsize: " + zsize +
" pixmin: " + pixmin +
" pixmax: " + pixmax +
" imagename: " + imagename +
" colormap: " + colormap);
}
}
private SGIImage(final Header header) {
this.header = header;
}
/** Reads an SGI image from the specified file. */
public static SGIImage read(final String filename) throws IOException {
return read(new FileInputStream(filename));
}
/** Reads an SGI image from the specified InputStream. */
public static SGIImage read(final InputStream in) throws IOException {
final DataInputStream dIn = new DataInputStream(new BufferedInputStream(in));
final Header header = new Header(dIn);
final SGIImage res = new SGIImage(header);
res.decodeImage(dIn);
return res;
}
/** Writes this SGIImage to the specified file name. If
flipVertically is set, outputs the scanlines from top to bottom
rather than the default bottom to top order. */
public void write(final String filename, final boolean flipVertically) throws IOException {
write(new File(filename), flipVertically);
}
/** Writes this SGIImage to the specified file. If flipVertically is
set, outputs the scanlines from top to bottom rather than the
default bottom to top order. */
public void write(final File file, final boolean flipVertically) throws IOException {
writeImage(file, data, header.xsize, header.ysize, header.zsize, flipVertically);
}
/** Creates an SGIImage from the specified data in either RGB or
RGBA format. */
public static SGIImage createFromData(final int width,
final int height,
final boolean hasAlpha,
final byte[] data) {
final Header header = new Header();
header.xsize = (short) width;
header.ysize = (short) height;
header.zsize = (short) (hasAlpha ? 4 : 3);
final SGIImage image = new SGIImage(header);
image.data = data;
return image;
}
/** Determines from the magic number whether the given InputStream
points to an SGI RGB image. The given InputStream must return
true from markSupported() and support a minimum of two bytes
of read-ahead. */
public static boolean isSGIImage(InputStream in) throws IOException {
if (!(in instanceof BufferedInputStream)) {
in = new BufferedInputStream(in);
}
if (!in.markSupported()) {
throw new IOException("Can not test non-destructively whether given InputStream is an SGI RGB image");
}
final DataInputStream dIn = new DataInputStream(in);
dIn.mark(4);
final short magic = dIn.readShort();
dIn.reset();
return (magic == MAGIC);
}
/** Returns the width of the image. */
public int getWidth() {
return header.xsize;
}
/** Returns the height of the image. */
public int getHeight() {
return header.ysize;
}
/** Returns the OpenGL format for this texture; e.g. GL.GL_RGB or GL.GL_RGBA. */
public int getFormat() {
return format;
}
/** Returns the raw data for this texture in the correct
(bottom-to-top) order for calls to glTexImage2D. */
public byte[] getData() { return data; }
@Override
public String toString() {
return header.toString();
}
//----------------------------------------------------------------------
// Internals only below this point
//
private void decodeImage(final DataInputStream in) throws IOException {
if (header.storage == 1) {
// Read RLE compression data; row starts and sizes
final int x = header.ysize * header.zsize;
rowStart = new int[x];
rowSize = new int[x];
rleEnd = 4 * 2 * x + 512;
for (int i = 0; i < x; i++) {
rowStart[i] = in.readInt();
}
for (int i = 0; i < x; i++) {
rowSize[i] = in.readInt();
}
tmpRead = new byte[header.xsize * 256];
}
tmpData = readAll(in);
final int xsize = header.xsize;
final int ysize = header.ysize;
final int zsize = header.zsize;
int lptr = 0;
data = new byte[xsize * ysize * 4];
final byte[] rbuf = new byte[xsize];
final byte[] gbuf = new byte[xsize];
final byte[] bbuf = new byte[xsize];
final byte[] abuf = new byte[xsize];
for (int y = 0; y < ysize; y++) {
if (zsize >= 4) {
getRow(rbuf, y, 0);
getRow(gbuf, y, 1);
getRow(bbuf, y, 2);
getRow(abuf, y, 3);
rgbatorgba(rbuf, gbuf, bbuf, abuf, data, lptr);
} else if (zsize == 3) {
getRow(rbuf, y, 0);
getRow(gbuf, y, 1);
getRow(bbuf, y, 2);
rgbtorgba(rbuf, gbuf, bbuf, data, lptr);
} else if (zsize == 2) {
getRow(rbuf, y, 0);
getRow(abuf, y, 1);
latorgba(rbuf, abuf, data, lptr);
} else {
getRow(rbuf, y, 0);
bwtorgba(rbuf, data, lptr);
}
lptr += 4 * xsize;
}
rowStart = null;
rowSize = null;
tmpData = null;
tmpRead = null;
format = GL.GL_RGBA;
header.zsize = 4;
}
private void getRow(final byte[] buf, final int y, final int z) {
if (header.storage == 1) {
final int offs = rowStart[y + z * header.ysize] - rleEnd;
System.arraycopy(tmpData, offs, tmpRead, 0, rowSize[y + z * header.ysize]);
int iPtr = 0;
int oPtr = 0;
for (;;) {
byte pixel = tmpRead[iPtr++];
int count = pixel & 0x7F;
if (count == 0) {
return;
}
if ((pixel & 0x80) != 0) {
while ((count--) > 0) {
buf[oPtr++] = tmpRead[iPtr++];
}
} else {
pixel = tmpRead[iPtr++];
while ((count--) > 0) {
buf[oPtr++] = pixel;
}
}
}
} else {
final int offs = (y * header.xsize) + (z * header.xsize * header.ysize);
System.arraycopy(tmpData, offs, buf, 0, header.xsize);
}
}
private void bwtorgba(final byte[] b, final byte[] dest, final int lptr) {
for (int i = 0; i < b.length; i++) {
dest[4 * i + lptr + 0] = b[i];
dest[4 * i + lptr + 1] = b[i];
dest[4 * i + lptr + 2] = b[i];
dest[4 * i + lptr + 3] = (byte) 0xFF;
}
}
private void latorgba(final byte[] b, final byte[] a, final byte[] dest, final int lptr) {
for (int i = 0; i < b.length; i++) {
dest[4 * i + lptr + 0] = b[i];
dest[4 * i + lptr + 1] = b[i];
dest[4 * i + lptr + 2] = b[i];
dest[4 * i + lptr + 3] = a[i];
}
}
private void rgbtorgba(final byte[] r, final byte[] g, final byte[] b, final byte[] dest, final int lptr) {
for (int i = 0; i < b.length; i++) {
dest[4 * i + lptr + 0] = r[i];
dest[4 * i + lptr + 1] = g[i];
dest[4 * i + lptr + 2] = b[i];
dest[4 * i + lptr + 3] = (byte) 0xFF;
}
}
private void rgbatorgba(final byte[] r, final byte[] g, final byte[] b, final byte[] a, final byte[] dest, final int lptr) {
for (int i = 0; i < b.length; i++) {
dest[4 * i + lptr + 0] = r[i];
dest[4 * i + lptr + 1] = g[i];
dest[4 * i + lptr + 2] = b[i];
dest[4 * i + lptr + 3] = a[i];
}
}
private static byte imgref(final byte[] i,
final int x,
final int y,
final int z,
final int xs,
final int ys,
final int zs) {
return i[(xs*ys*z)+(xs*y)+x];
}
private void writeHeader(final DataOutputStream stream,
final int xsize, final int ysize, final int zsize, final boolean rle) throws IOException {
// effects: outputs the 512-byte IRIS RGB header to STREAM, using xsize,
// ysize, and depth as the dimensions of the image. NOTE that
// the following defaults are used:
// STORAGE = 1 (storage format = RLE)
// BPC = 1 (# bytes/channel)
// DIMENSION = 3
// PIXMIN = 0
// PIXMAX = 255
// IMAGENAME = <80 nulls>
// COLORMAP = 0
// See ftp://ftp.sgi.com/pub/sgi/SGIIMAGESPEC for more details.
// write out MAGIC, STORAGE, BPC
stream.writeShort(474);
stream.write((rle ? 1 : 0));
stream.write(1);
// write out DIMENSION
stream.writeShort(3);
// write XSIZE, YSIZE, ZSIZE
stream.writeShort(xsize);
stream.writeShort(ysize);
stream.writeShort(zsize);
// write PIXMIN, PIXMAX
stream.writeInt(0);
stream.writeInt(255);
// write DUMMY
stream.writeInt(0);
// write IMAGENAME
for (int i = 0; i < 80; i++)
stream.write(0);
// write COLORMAP
stream.writeInt(0);
// write DUMMY (404 bytes)
for (int i = 0; i < 404; i++)
stream.write(0);
}
private void writeImage(final File file,
byte[] data,
final int xsize,
final int ysize,
final int zsize,
final boolean yflip) throws IOException {
// Input data is in RGBRGBRGB or RGBARGBARGBA format; first unswizzle it
final byte[] tmpData = new byte[xsize * ysize * zsize];
int dest = 0;
for (int i = 0; i < zsize; i++) {
for (int j = i; j < (xsize * ysize * zsize); j += zsize) {
tmpData[dest++] = data[j];
}
}
data = tmpData;
// requires: DATA must be an array of size XSIZE * YSIZE * ZSIZE,
// indexed in the following manner:
// data[0] ...data[xsize-1] == first row of first channel
// data[xsize]...data[2*xsize-1] == second row of first channel
// ... data[(ysize - 1) * xsize]...data[(ysize * xsize) - 1] ==
// last row of first channel
// Later channels follow the same format.
// *** NOTE that "first row" is defined by the BOTTOM ROW of
// the image. That is, the origin is in the lower left corner.
// effects: writes out an SGI image to FILE, RLE-compressed, INCLUDING
// header, of dimensions (xsize, ysize, zsize), and containing
// the data in DATA. If YFLIP is set, outputs the data in DATA
// in reverse order vertically (equivalent to a flip about the
// x axis).
// Build the offset tables
final int[] starttab = new int[ysize * zsize];
final int[] lengthtab = new int[ysize * zsize];
// Temporary buffer for holding RLE data.
// Note that this makes the assumption that RLE-compressed data will
// never exceed twice the size of the input data.
// There are surely formal proofs about how big the RLE buffer should
// be, as well as what the optimal look-ahead size is (i.e. don't switch
// copy/repeat modes for less than N repeats). However, I'm going from
// empirical evidence here; the break-even point seems to be a look-
// ahead of 3. (That is, if the three values following this one are all
// the same as the current value, switch to repeat mode.)
final int lookahead = 3;
final byte[] rlebuf = new byte[2 * xsize * ysize * zsize];
int cur_loc = 0; // current offset location.
int ptr = 0;
int total_size = 0;
int ystart = 0;
int yincr = 1;
int yend = ysize;
if (yflip) {
ystart = ysize - 1;
yend = -1;
yincr = -1;
}
final boolean DEBUG = false;
for (int z = 0; z < zsize; z++) {
for (int y = ystart; y != yend; y += yincr) {
// RLE-compress each row.
int x = 0;
byte count = 0;
boolean repeat_mode = false;
boolean should_switch = false;
final int start_ptr = ptr;
int num_ptr = ptr++;
byte repeat_val = 0;
while (x < xsize) {
// see if we should switch modes
should_switch = false;
if (repeat_mode) {
if (imgref(data, x, y, z, xsize, ysize, zsize) != repeat_val) {
should_switch = true;
}
} else {
// look ahead to see if we should switch to repeat mode.
// stay within the scanline for the lookahead
if ((x + lookahead) < xsize) {
should_switch = true;
for (int i = 1; i <= lookahead; i++) {
if (DEBUG)
System.err.println("left side was " + ((int) imgref(data, x, y, z, xsize, ysize, zsize)) +
", right side was " + (int)imgref(data, x+i, y, z, xsize, ysize, zsize));
if (imgref(data, x, y, z, xsize, ysize, zsize) !=
imgref(data, x+i, y, z, xsize, ysize, zsize))
should_switch = false;
}
}
}
if (should_switch || (count == 127)) {
// update the number of elements we repeated/copied
if (x > 0) {
if (repeat_mode)
rlebuf[num_ptr] = count;
else
rlebuf[num_ptr] = (byte) (count | 0x80);
}
// perform mode switch if necessary; output repeat_val if
// switching FROM repeat mode, and set it if switching
// TO repeat mode.
if (repeat_mode) {
if (should_switch)
repeat_mode = false;
rlebuf[ptr++] = repeat_val;
} else {
if (should_switch)
repeat_mode = true;
repeat_val = imgref(data, x, y, z, xsize, ysize, zsize);
}
if (x > 0) {
// reset the number pointer
num_ptr = ptr++;
// reset number of bytes copied
count = 0;
}
}
// if not in repeat mode, copy element to ptr
if (!repeat_mode) {
rlebuf[ptr++] = imgref(data, x, y, z, xsize, ysize, zsize);
}
count++;
if (x == xsize - 1) {
// Need to store the number of pixels we copied/repeated.
if (repeat_mode) {
rlebuf[num_ptr] = count;
// If we ended the row in repeat mode, store the
// repeated value
rlebuf[ptr++] = repeat_val;
}
else
rlebuf[num_ptr] = (byte) (count | 0x80);
// output zero counter for the last value in the row
rlebuf[ptr++] = 0;
}
x++;
}
// output this row's length into the length table
final int rowlen = ptr - start_ptr;
if (yflip)
lengthtab[ysize*z+(ysize-y-1)] = rowlen;
else
lengthtab[ysize*z+y] = rowlen;
// add to the start table, and update the current offset
if (yflip)
starttab[ysize*z+(ysize-y-1)] = cur_loc;
else
starttab[ysize*z+y] = cur_loc;
cur_loc += rowlen;
}
}
// Now we have the offset tables computed, as well as the RLE data.
// Output this information to the file.
total_size = ptr;
if (DEBUG)
System.err.println("total_size was " + total_size);
final DataOutputStream stream = new DataOutputStream(new BufferedOutputStream(IOUtil.getFileOutputStream(file, true)));
writeHeader(stream, xsize, ysize, zsize, true);
final int SIZEOF_INT = 4;
for (int i = 0; i < (ysize * zsize); i++)
stream.writeInt(starttab[i] + 512 + (2 * ysize * zsize * SIZEOF_INT));
for (int i = 0; i < (ysize * zsize); i++)
stream.writeInt(lengthtab[i]);
for (int i = 0; i < total_size; i++)
stream.write(rlebuf[i]);
stream.close();
}
private byte[] readAll(final DataInputStream in) throws IOException {
byte[] dest = new byte[16384];
int pos = 0;
int numRead = 0;
boolean done = false;
do {
numRead = in.read(dest, pos, dest.length - pos);
if (pos == dest.length) {
// Resize destination buffer
final byte[] newDest = new byte[2 * dest.length];
System.arraycopy(dest, 0, newDest, 0, pos);
dest = newDest;
}
if (numRead > 0) {
pos += numRead;
}
done = ((numRead == -1) || (in.available() == 0));
} while (!done);
// Trim destination buffer
if (pos != dest.length) {
final byte[] finalDest = new byte[pos];
System.arraycopy(dest, 0, finalDest, 0, pos);
dest = finalDest;
}
return dest;
}
// Test case
/*
import java.awt.image.*;
import javax.swing.*;
public static void main(String[] args) {
for (int i = 0; i < args.length; i++) {
try {
System.out.println(args[i] + ":");
SGIImage image = SGIImage.read(args[i]);
System.out.println(image);
BufferedImage img = new BufferedImage(image.getWidth(), image.getHeight(), BufferedImage.TYPE_4BYTE_ABGR);
WritableRaster raster = img.getRaster();
DataBufferByte db = (DataBufferByte) raster.getDataBuffer();
byte[] src = image.getData();
byte[] dest = db.getData();
for (int j = 0; j < src.length; j += 4) {
dest[j + 0] = src[j + 3];
dest[j + 1] = src[j + 2];
dest[j + 2] = src[j + 1];
dest[j + 3] = src[j + 0];
}
// System.arraycopy(src, 0, dest, 0, src.length);
ImageIcon icon = new ImageIcon(img);
JLabel label = new JLabel();
label.setIcon(icon);
JFrame frame = new JFrame(args[i]);
frame.getContentPane().add(label);
frame.pack();
frame.show();
} catch (IOException e) {
e.printStackTrace();
}
}
}
*/
}