jip
Class JIPToolkit

java.lang.Object
  |
  +--jip.JIPToolkit

public final class JIPToolkit
extends java.lang.Object

Descripción:
Clase que define métodos básicos relacionados con la obtención y almacenamiento de imágenes AWT y JIP. Las imágenes AWT las podremos obtener a partir de imágenes JIP o directamente de ficheros GIF o JPEG. Las imágenes JIP las podremos obtener a partir de imágenes AWT o como secuencias directamente de ficheros JIP. Podremos también almacenar imágenes y secuencias JIP tanto en ficheros JIP como en ficheros con formato TGA (Targa).


Field Summary
(package private) static java.awt.Toolkit toolkit
           
 
Constructor Summary
(package private) JIPToolkit()
           Descripción:
Constructor Vacio de la clase
 
Method Summary
static void drawline(int x0, int y0, int x1, int y1, int icol, int irow, int[] pix)
           Descripción:
Dibuja una linea, cuyas coordenadas se pasan como parámetro, mediante el algorirmo de Bressenham
.
static java.awt.Image getAWTImage(JIPImage img)
           Descripción:
Obtiene un objeto imagen AWT a partir de una imagen JIP.
static java.awt.Image getAWTImage(JIPImage img, int b)
           Descripción:
Obtiene un objeto imagen AWT a partir de una banda de una imagen JIP.
static java.awt.Image getAWTImage(java.lang.String file)
           Descripción:
Obtiene un objeto imagen AWT a partir de un fichero GIF o JPEG.
static JIPImage getColorImage(java.awt.Image img)
           Descripción:
Obtiene un objeto imagen JIP de tipo tCOLOR a partir de una imagen AWT.
static JIPSequence getSeqFromFile(java.lang.String file)
           Descripción:
Obtiene un objeto secuencia JIP a partir de un fichero JIP.
static void saveImageIntoFile(JIPImage img, java.lang.String file)
           Descripción:
Salva un objeto imagen JIP en un fichero con formato JIP.
static void saveImageIntoTga(JIPImage img, java.lang.String file)
           Descripción:
Salva un objeto imagen JIP en un fichero con formato TGA (Targa).
static void saveSeqIntoFile(JIPSequence seq, java.lang.String file)
           Descripción:
Salva un objeto secuencia JIP en un fichero con formato JIP.
static void saveSeqIntoFileZip(JIPSequence seq, java.lang.String dir, java.lang.String namefile)
           Descripción:
Salva un objeto secuencia JIP en un fichero con formato ZIP.
static void saveSeqIntoTga(JIPSequence seq, java.lang.String file)
           Descripción:
Salva un objeto secuencia JIP en ficheros con formato TGA (Targa).
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, wait, wait, wait
 

Field Detail

toolkit

static final java.awt.Toolkit toolkit
Constructor Detail

JIPToolkit

JIPToolkit()

Descripción:
Constructor Vacio de la clase

Method Detail

getAWTImage

public static java.awt.Image getAWTImage(JIPImage img,
                                         int b)

Descripción:
Obtiene un objeto imagen AWT a partir de una banda de una imagen JIP.

Parameters:
img - Imagen JIP fuente.
b - Banda de img cuyo bitmap será convertido a imagen AWT (0 <= b <= numbandas-1)
Returns:
Imagen AWT resultado. Aunque las imágenes AWT siempre se representan en color, como una banda no contiene color, los colores de la imagen AWT obtenida serán siempre grises.

getAWTImage

public static java.awt.Image getAWTImage(JIPImage img)

Descripción:
Obtiene un objeto imagen AWT a partir de una imagen JIP. Si la imagen JIP no es del tipo tCOLOR se obtendrá la imagen de la banda 0. Si la imagen JIP es en color la imagen obtenida será también en color.

Parameters:
img - Imagen JIP fuente.
Returns:
Imagen AWT resultado. Si la imagen JIP no es en color se obtendrá la imagen de la banda 0. Por tanto, aunque la imagen AWT sea en color, contendrá una escala de grises. Si la imagen JIP es en color la imagen obtenida se corresponderá con ella.
See Also:
getAWTImage(jip.JIPImage, int)

getAWTImage

public static java.awt.Image getAWTImage(java.lang.String file)

Descripción:
Obtiene un objeto imagen AWT a partir de un fichero GIF o JPEG. Este método es bloqueante y no devuelve el control hasta que la imagen resultado está completamente formada. Conviene utilizarlo frente a los métodos de carga de imágenes no bloqueantes de AWT como getImage() para evitar la utilización de un protocolo asíncrono basado en la interfaz ImageObserver de AWT que asegure que accedemos a los valores correctos de los pixels de la imagen. También nos desentendemos de la utilización del objeto MediaTracker para esperar la carga de la imagen pues este método ya utiliza MediaTracker internamente.

Parameters:
file - Fichero fuente (debe ser GIF o JPEG)
Returns:
Imagen AWT resultado. (null si no puede cargar la imagen)

getColorImage

public static JIPImage getColorImage(java.awt.Image img)

Descripción:
Obtiene un objeto imagen JIP de tipo tCOLOR a partir de una imagen AWT.

Parameters:
img - Imagen AWT fuente (debe estar cargada completamente lo cual se asegura con getAWTImage(String fich).
Returns:
Imagen JIP resultado (tipo tCOLOR).
See Also:
getAWTImage(java.lang.String)

saveImageIntoFile

public static void saveImageIntoFile(JIPImage img,
                                     java.lang.String file)

Descripción:
Salva un objeto imagen JIP en un fichero con formato JIP. La imagen se salvará como una secuencia con un único frame que la contenga.

Parameters:
img - Imagen a salvar.
file - Fichero en el cual almacenar la imagen (si no existe se crea, si existe se sobreescribe)

saveImageIntoTga

public static void saveImageIntoTga(JIPImage img,
                                    java.lang.String file)

Descripción:
Salva un objeto imagen JIP en un fichero con formato TGA (Targa). Si la imagen dispone de varias bandas de grises, se generará un fichero para cada una de ellas, añadiéndose al nombre (antes de la extensión) el postfijo "_b0", "_b1", ... según la banda a la que corresponda.

Parameters:
img - Imagen a salvar.
file - Fichero en el cual almacenar la imagen (si no existe se crea, si existe se sobreescribe)

getSeqFromFile

public static JIPSequence getSeqFromFile(java.lang.String file)

Descripción:
Obtiene un objeto secuencia JIP a partir de un fichero JIP.

Parameters:
file - Nombre del fichero.
Returns:
Secuencia JIP. (null si no puede cargar la secuencia)

saveSeqIntoFile

public static void saveSeqIntoFile(JIPSequence seq,
                                   java.lang.String file)

Descripción:
Salva un objeto secuencia JIP en un fichero con formato JIP.

Parameters:
seq - Secuencia a salvar.
file - Fichero en el cual almacenar la secuencia (si no existe se crea, si existe se sobreescribe)

saveSeqIntoFileZip

public static void saveSeqIntoFileZip(JIPSequence seq,
                                      java.lang.String dir,
                                      java.lang.String namefile)

Descripción:
Salva un objeto secuencia JIP en un fichero con formato ZIP.

Parameters:
seq - Secuencia a salvar.param file Nombre del fichero .jip.param fliezip Nombre del fichero .zip
file - Fichero en el cual almacenar la secuencia (si no existe se crea, si existe se sobreescribe)

saveSeqIntoTga

public static void saveSeqIntoTga(JIPSequence seq,
                                  java.lang.String file)

Descripción:
Salva un objeto secuencia JIP en ficheros con formato TGA (Targa). Si la secuencia dispone de varios frames, se generará un fichero para cada uno de ellos, (o más si los frames tienen varias bandas de grises), añadiéndose al nombre (antes de la extensión) el postfijo "_f0", "_f1", ... según el frame al que corresponda y el postfijo "_b0", "_b1", ... en el caso de varias bandas de grises para un mismo frame.

Parameters:
seq - Secuencia a salvar.
file - Fichero en el cual almacenar la secuencia (si no existe se crea, si existe se sobreescribe)

drawline

public static void drawline(int x0,
                            int y0,
                            int x1,
                            int y1,
                            int icol,
                            int irow,
                            int[] pix)

Descripción:
Dibuja una linea, cuyas coordenadas se pasan como parámetro, mediante el algorirmo de Bressenham
.

Parameters:
x0 - Coordenada X del punto inicial
y0 - Coordenada Y del punto inicial
x1 - Coordenada X del punto final
y1 - Coordenada Y del punto final
icol - Columna
irow - Fila
pix - Array de Pixels