org.gvsig.raster.impl.grid.render

Class DefaultRender

java.lang.Object

org.gvsig.raster.impl.grid.render.DefaultRender

All Implemented Interfaces:

java.lang.Runnable, java.util.EventListener, FilterListChangeListener, Render, PropertyListener, TileListener, Disposable, Persistent

public class DefaultRender
extends java.lang.Object
implements Render, PropertyListener, FilterListChangeListener, Persistent, TileListener

Esta clase se encarga de la gestión del dibujado de datos leídos desde la capa "dataaccess" sobre objetos java. Para ello necesita una fuente de datos que tipicamente es un buffer (RasterBuffer) y un objeto que realice la función de escritura de datos a partir de un estado inicial. Esta capa del renderizado gestiona Extents, rotaciones, tamaños de vista pero la escritura de datos desde el buffer al objeto image es llevada a cabo por ImageDrawer. Parámetros de control de la visualización:

• renderBands: Orden de visualizado de las bands.
• replicateBands: Para visualización de raster de una banda. Dice si se replica sobre las otras dos bandas de visualización o se ponen a 0.
• enhanced: aplicación de filtro de realce
• removeEnds: Eliminar extremos en el filtro de realce. Uso del segundo máximo y mínimo
• tailTrim: Aplicacion de recorte de colas en el realce. Es un valor decimal que representa el porcentaje del recorte entre 100. Es decir, 0.1 significa que el recorte es de un 10%

Constructor Summary

Constructors

Constructor and Description
DefaultRender() Constructor
DefaultRender(RasterDataStore ds) Constructor

Method Summary

Modifier and Type	Method and Description
void	actionValueChanged(PropertyEvent e) Evento activado cuando cambia una propiedad de transparencia.
void	addVisualPropertyListener(VisualPropertyListener listener) Asigna un listener a la lista que será informado cuando cambie una propiedad visual en la renderización.
void	buildFiltersFromPersistencyFilterParam(Statistics stats) Builds the filters from the list of classes PersistencyFilterParam recovered from a project
void	dispose() Sets buffers to null
Buffer	draw(java.awt.Graphics2D g, ViewPortData vp, ICoordTrans coordTrans, TaskStatus taskStatus) Dibuja la extensión del viewport sobre el graphics aplicando la transformación que recibe como parámetro.
Buffer	draw(java.awt.Graphics2D g, ViewPortData vp, TaskStatus taskStatus) Dibuja el raster sobre el Graphics.
void	drawThread(java.awt.Graphics2D g, ViewPortData vp) This method throws the draw call in a Thread.
void	drawTiledService(java.awt.Graphics2D g, ViewPortData vp, java.awt.geom.Dimension2D viewDimension, ICoordTrans coordTrans, TaskStatus taskStatus) Dibuja la extensión del viewport de forma teselada sobre el graphics aplicando la transformación que recibe como parámetro.
void	drawTiledService(java.awt.Graphics2D g, ViewPortData vp, java.awt.geom.Dimension2D viewDimension, TaskStatus status) Este método dibuja sobre el Graphics a partir de un Viewport sin ajustar.
void	endReading() The last tile is received
boolean	existColorTable() Informa de si el raster tiene tabla de color asociada o no.
void	filterListChanged(FilterListChangeEvent e) Evento activado cuando cambia la lista de filtros.
protected void	finalize()
int[]	formatArrayRenderBand(int[] b) Dado que la notación de bandas para renderizado admite posiciones con -1 y la notación del buffer no ya que no tendria sentido.
ColorTable	getColorTable() Gets the color table
RasterDataStore	getDataStore() Gets a data store
RasterFilterList	getFilterList() Obtiene las lista de filtros aplicados en la renderización
int	getLastAlphaBandNumber() Gets the last alpha band number
Buffer	getLastRenderBuffer() Draws the image with the parameters used in the last drawn.
ColorInterpretation	getRenderColorInterpretation() Gets the color interpretation to renderize this layer
Transparency	getRenderingTransparency() Obtiene el último objeto transparencia aplicado en la renderización
boolean	isReading() Returns true if the endReading wasn't be called yet
boolean	isRenderingAsGray() Devuelve si la asignacion de las bandas a renderizar representa una capa en escala de grises
void	loadFromState(PersistentState state) Set the state of the object from the state passed as parameter.
static void	registerPersistence()
void	run() Thread de dibujado
void	saveToState(PersistentState state) Saves the internal state of the object on the provided PersistentState object.
void	setDataSource(RasterDataStore ds) Asigna la factoria de buffer del renderizador
void	setDataStore(RasterDataStore dataStore) Sets a data store
void	setFilterList(RasterFilterList filterList) Asigna la lista de filtros que se usará en el renderizado
void	setGraphicInfo(java.awt.Graphics2D g, ViewPortData vp) Sets the view structures to draw
void	setLastTransparency(Transparency lastTransparency) Asigna el último estado de transparencia de la renderización.
void	setReading(boolean reading)
void	setRenderColorInterpretation(ColorInterpretation ci) Sets the color interpretation to renderize this layer
void	tileReady(Tile loadedTile) A new tile is received

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultRender

public DefaultRender()

Constructor

Parameters:

grid -

DefaultRender

public DefaultRender(RasterDataStore ds)

Constructor

Parameters:

ds -

Method Detail

getDataStore

public RasterDataStore getDataStore()

Description copied from interface: Render

Gets a data store

Specified by:

getDataStore in interface Render

Returns:

setDataStore

public void setDataStore(RasterDataStore dataStore)

Description copied from interface: Render

Sets a data store

Specified by:

setDataStore in interface Render

addVisualPropertyListener

public void addVisualPropertyListener(VisualPropertyListener listener)

Asigna un listener a la lista que será informado cuando cambie una propiedad visual en la renderización.

Specified by:

addVisualPropertyListener in interface Render

Parameters:

listener - VisualPropertyListener

run

public void run()

Thread de dibujado

Specified by:

run in interface java.lang.Runnable

setGraphicInfo

public void setGraphicInfo(java.awt.Graphics2D g,
                           ViewPortData vp)

Description copied from interface: Render

Sets the view structures to draw

Specified by:

setGraphicInfo in interface Render

drawThread

public void drawThread(java.awt.Graphics2D g,
                       ViewPortData vp)

Description copied from interface: Render

This method throws the draw call in a Thread. This is useful to draw tiles.

Strategy:

• If the image is out of the view the thread won't be thrown
• Throw the thread to draw
• The main thread waits until the secondary thread ends
• When the buffer of a new tile has been received then nextBuffer is called from the store
• When the last tile has been received then endReading is called from the store. This method unlocks the main thread and will finish the process

Specified by:

drawThread in interface Render

See Also:

draw

getLastRenderBuffer

public Buffer getLastRenderBuffer()
                           throws QueryException,
                                  ProcessInterruptedException

Description copied from interface: Render

Draws the image with the parameters used in the last drawn.

Specified by:

getLastRenderBuffer in interface Render

Returns:

Throws:

QueryException

ProcessInterruptedException

drawTiledService

public void drawTiledService(java.awt.Graphics2D g,
                             ViewPortData vp,
                             java.awt.geom.Dimension2D viewDimension,
                             ICoordTrans coordTrans,
                             TaskStatus taskStatus)
                      throws QueryException,
                             ProcessInterruptedException

Description copied from interface: Render

Dibuja la extensión del viewport de forma teselada sobre el graphics aplicando la transformación que recibe como parámetro.

Specified by:

drawTiledService in interface Render

Parameters:

g - Graphics sobre el que se pinta

vp - ViewPort de la extensión a dibujar

viewDimension - Dimensión de la vista

coordTrans - Transformación a aplicar sobre el buffer antes de ser dibujado. La transformación será valida si tiene como proyección fuente la proyección de la extensión del ViewPort y como proyección destino la proyección de la fuente de datos.

taskStatus - Objeto compartido para indicar el estado de la tarea

Throws:

QueryException

ProcessInterruptedException

tileReady

public void tileReady(Tile loadedTile)
               throws TileGettingException

Description copied from interface: TileListener

A new tile is received

Specified by:

tileReady in interface TileListener

Throws:

TileGettingException

draw

public Buffer draw(java.awt.Graphics2D g,
                   ViewPortData vp,
                   ICoordTrans coordTrans,
                   TaskStatus taskStatus)
            throws QueryException,
                   ProcessInterruptedException

Description copied from interface: Render

Dibuja la extensión del viewport sobre el graphics aplicando la transformación que recibe como parámetro.

Specified by:

draw in interface Render

Parameters:

g - Graphics sobre el que se pinta

vp - ViewPort de la extensión a dibujar

coordTrans - Transformación a aplicar sobre el buffer antes de ser dibujado. La transformación será valida si tiene como proyección fuente la proyección de la extensión del ViewPort y como proyección destino la proyección de la fuente de datos.

taskStatus - Objeto compartido para indicar el estado de la tarea

Returns:

Si el graphics es null, el buffer proyectado justo antes de ser dibujado, en cualquier otro caso un buffer inútil sin datos.

Throws:

QueryException

ProcessInterruptedException

endReading

public void endReading()

Description copied from interface: TileListener

The last tile is received

Specified by:

endReading in interface TileListener

isReading

public boolean isReading()

Description copied from interface: TileListener

Returns true if the endReading wasn't be called yet

Specified by:

isReading in interface TileListener

setReading

public void setReading(boolean reading)

Specified by:

setReading in interface Render

isRenderingAsGray

public boolean isRenderingAsGray()

Description copied from interface: Render

Devuelve si la asignacion de las bandas a renderizar representa una capa en escala de grises

Specified by:

isRenderingAsGray in interface Render

Returns:

setRenderColorInterpretation

public void setRenderColorInterpretation(ColorInterpretation ci)

Description copied from interface: Render

Sets the color interpretation to renderize this layer

Specified by:

setRenderColorInterpretation in interface Render

getRenderColorInterpretation

public ColorInterpretation getRenderColorInterpretation()

Description copied from interface: Render

Gets the color interpretation to renderize this layer

Specified by:

getRenderColorInterpretation in interface Render

Returns:

formatArrayRenderBand

public int[] formatArrayRenderBand(int[] b)

Dado que la notación de bandas para renderizado admite posiciones con -1 y la notación del buffer no ya que no tendria sentido. Esta función adapta la primera notación a la segunda para realizar la petición setAreaOfInterest y cargar el buffer.

Parameters:

b - Array que indica la posición de bandas para el renderizado

Returns:

Array que indica la posición de bandas para la petición

getRenderingTransparency

public Transparency getRenderingTransparency()

Description copied from interface: Render

Obtiene el último objeto transparencia aplicado en la renderización

Specified by:

getRenderingTransparency in interface Render

Returns:

Transparency

getLastAlphaBandNumber

public int getLastAlphaBandNumber()

Description copied from interface: Render

Gets the last alpha band number

Specified by:

getLastAlphaBandNumber in interface Render

Returns:

setLastTransparency

public void setLastTransparency(Transparency lastTransparency)

Description copied from interface: Render

Asigna el último estado de transparencia de la renderización.

Specified by:

setLastTransparency in interface Render

getFilterList

public RasterFilterList getFilterList()

Description copied from interface: Render

Obtiene las lista de filtros aplicados en la renderización

Specified by:

getFilterList in interface Render

Returns:

RasterFilterList

setFilterList

public void setFilterList(RasterFilterList filterList)

Description copied from interface: Render

Asigna la lista de filtros que se usará en el renderizado

Specified by:

setFilterList in interface Render

existColorTable

public boolean existColorTable()

Description copied from interface: Render

Informa de si el raster tiene tabla de color asociada o no.

Specified by:

existColorTable in interface Render

Returns:

true si tiene tabla de color y false si no la tiene.

getColorTable

public ColorTable getColorTable()

Description copied from interface: Render

Gets the color table

Specified by:

getColorTable in interface Render

Returns:

setDataSource

public void setDataSource(RasterDataStore ds)

Asigna la factoria de buffer del renderizador

Parameters:

ds -

actionValueChanged

public void actionValueChanged(PropertyEvent e)

Evento activado cuando cambia una propiedad de transparencia.

Specified by:

actionValueChanged in interface PropertyListener

filterListChanged

public void filterListChanged(FilterListChangeEvent e)

Evento activado cuando cambia la lista de filtros.

Specified by:

filterListChanged in interface FilterListChangeListener

dispose

public void dispose()

Sets buffers to null

Specified by:

dispose in interface Disposable

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

registerPersistence

public static void registerPersistence()

loadFromState

public void loadFromState(PersistentState state)
                   throws PersistenceException

Description copied from interface: Persistent

Set the state of the object from the state passed as parameter.

Specified by:

loadFromState in interface Persistent

Throws:

PersistenceException

saveToState

public void saveToState(PersistentState state)
                 throws PersistenceException

Description copied from interface: Persistent

Saves the internal state of the object on the provided PersistentState object.

Specified by:

saveToState in interface Persistent

Throws:

PersistenceException

buildFiltersFromPersistencyFilterParam

public void buildFiltersFromPersistencyFilterParam(Statistics stats)
                                            throws PersistenceException

Builds the filters from the list of classes PersistencyFilterParam recovered from a project

Parameters:

stats -

Throws:

PersistenceException

draw

public Buffer draw(java.awt.Graphics2D g,
                   ViewPortData vp,
                   TaskStatus taskStatus)
            throws QueryException,
                   ProcessInterruptedException

Description copied from interface: Render

Dibuja el raster sobre el Graphics. Para ello debemos de pasar el viewPort que corresponde a la vista. Este viewPort es ajustado a los tamaños máximos y mínimos de la imagen por la función calculateNewView. Esta función también asignará la vista a los drivers. Posteriormente se calcula el alto y ancho de la imagen a dibujar (wImg, hImg), así como el punto donde se va a pintar dentro del graphics (pt). Finalmente se llama a updateImage del driver para que pinte y una vez dibujado se pasa a través de la función renderizeRaster que es la encargada de aplicar la pila de filtros sobre el Image que ha devuelto el driver. Para calcular en que coordenada pixel (pt) se empezará a pintar el BufferedImage con el raster leído se aplica sobre la esquina superior izquierda de esta la matriz de transformación del ViewPortData pasado vp.mat.transform(pt, pt). Si el raster no está rotado este punto es el resultante de la función calculateNewView que devuelve la petición ajustada al extent de la imagen (sin rotar). Si el raster está rotado necesitaremos para la transformación el resultado de la función coordULRotateRaster. Lo que hace esta última es colocar la petición que ha sido puesta en coordenadas de la imagen sin rotar (para pedir al driver de forma correcta) otra vez en coordenadas de la imagen rotada (para calcular su posición de dibujado). Para dibujar sobre el Graphics2D el raster rotado aplicaremos la matriz de transformación con los parámetros de Shear sobre este Graphics de forma inversa. Como hemos movido el fondo tendremos que recalcular ahora el punto donde se comienza a dibujar aplicandole la transformación sobre este at.inverseTransform(pt, pt);. Finalmente volcamos el BufferedImage sobre el Graphics volviendo a dejar el Graphics en su posición original al acabar.

Specified by:

draw in interface Render

Parameters:

g - Graphics sobre el que se pinta

vp - ViewPort de la extensión a dibujar

Throws:

QueryException

ProcessInterruptedException

drawTiledService

public void drawTiledService(java.awt.Graphics2D g,
                             ViewPortData vp,
                             java.awt.geom.Dimension2D viewDimension,
                             TaskStatus status)
                      throws QueryException,
                             ProcessInterruptedException

Description copied from interface: Render

Este método dibuja sobre el Graphics a partir de un Viewport sin ajustar. Los tiles que van llegando no están en el tamaño ajustado sino que llegan en su tamaño origina, tipicamente 256x256 píxeles. Estos son reescalados al ir a dibujarlos sobre el Graphics.

Specified by:

drawTiledService in interface Render

Throws:

ProcessInterruptedException

QueryException