Package ilda

Class IldaReader

java.lang.Object

be.cmbsoft.ilda.IldaReader

public class IldaReader
                    extends Object
                

This class reads a file and passes the data to frames and points.

Ilda files are explained here: http://www.laserist.org/StandardsDocs/IDTF05-finaldraft.pdf This document only mentions Ilda V0, 1, 2 and 3, no V4 and V5 so here's a breakdown: ILDA V0 is 3D and uses palettes ILDA V1 is 2D and uses palettes ILDA V2 is a palette ILDA V3 is a 24-bit palette, but was discontinued and is not a part of the official standard anymore ILDA V4 is 3D with true-colour information in BGR format ILDA V5 is 2D with true-colour information in BGR format.

An Ilda file is composed of headers that always start with "ILDA", followed by three zeros and the version number. A complete header is 32 bytes. After the header, the data follows. In case of a palette (V2), each data point has three bytes: R, G and B. In case of a frame (V0/1/4/5), the X, Y and Z (for 3D frames) values are spread out over two bytes Then either two status bytes follow with a blanking bit and palette colour number, or BGR values.

Field Summary

Fields

Modifier and Type	Field	Description
protected byte[]	b
protected String	location

Constructor Summary

Constructors

Constructor	Description
IldaReader (File file)
IldaReader (String location)

Method Summary

Modifier and Type	Method	Description
static List<IldaFrame>	readFile (String location)	Parse an ilda file from disk and retrieve its contents.
void	setPalette (IldaPalette palette)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

location

protected String location

b

protected byte[] b

Constructor Details

IldaReader

public IldaReader
                                            
                                            (String location)
                                            throws FileNotFoundException
                                        

Throws:

FileNotFoundException

IldaReader

public IldaReader
                                            
                                            (File file)
                                            throws FileNotFoundException
                                        

Throws:

FileNotFoundException

Method Details

readFile

public static List<IldaFrame> readFile
                                            
                                            (String location)
                                            throws FileNotFoundException
                                        

Parse an ilda file from disk and retrieve its contents. Note that since there is no information here about canvas size, all positions are normalised between -1 and 1.

Parameters:

location - path to the ilda file

Returns:

list of all loaded frames

Throws:

FileNotFoundException

setPalette

public void setPalette
                                            
                                            (IldaPalette palette)