org.gvsig.raster.util

Class DefaultRasterUtils

java.lang.Object

org.gvsig.raster.util.DefaultRasterUtils

All Implemented Interfaces:

RasterUtils

public class DefaultRasterUtils
extends java.lang.Object
implements RasterUtils

Raster utilities without gvSIG dependencies

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_BYTE_BIT_VALUE
static int	MAX_SHORT_BIT_VALUE

Constructor Summary

Constructors

Constructor and Description
DefaultRasterUtils()

Method Summary

Modifier and Type	Method and Description
void	adjustToPixelSize(java.awt.geom.Point2D[] points, java.awt.geom.Point2D dim) Ajusta el valor del array de puntos pasado como primer parámetro a las dimensiones de la imagen.
Extent	calculateAdjustedView(Extent extToAdj, java.awt.geom.AffineTransform at, double w, double h) Ajusta la extensión pasada por parámetro a los valores máximos y mínimos de la imagen.
Extent	calculateAdjustedView(Extent extToAdj, Extent imgExt) Ajusta la extensión pasada por parámetro a los valores máximos y mínimos de la imagen.
boolean	compareExtents(Extent e1, Extent e2) Compara dos extents y devuelve true si son iguales
BufferHistogram	convertHistogramToRGB(BufferHistogram histogram) Convierte un histograma al rango de valores de RGB, en pocas palabras aplica una operacion 0xff a cada pixel para quitar los numeros negativos y desplazarlos a su rango visual.
void	copyToBuffer(Buffer bufResult, Extent tileExtent, Buffer buf, Extent ex, double rel, boolean hasAlphaBand) Copies a piece of image into another taking into account the different size and proportion
double[]	cornersToWorldFile(java.awt.geom.Point2D[] esq, java.awt.Dimension size) Calcula los parámetros de un worl file a partir de las esquinas del raster. 1.
java.lang.String	formatTime(long time) Formatea el tiempo en milisegundos devolviendo un String en formato . dias, horas, minutos y segundos.
long	getBytesFromRaster(int width, int height, int rasterType, int nBands) Devuelve el tamaño en bytes de una región de un raster en función de su dimensión, número de bandas y tipo de dato.
int	getBytesFromRasterBufType(int rasterBufType) Obtiene el número de bytes que ocupa un tipo de dato concreto.
java.lang.String[]	getCoord(double minx, double miny, double maxx, double maxy, int dec) Obtiene un texto con las coordenadas a partir de números en coma flotante.
java.awt.geom.Rectangle2D	getMapRectFromPxRect(java.awt.geom.Rectangle2D extent, double widthPx, double heightPx, java.awt.geom.Rectangle2D pxWindow) Convierte una ventana en coordenadas del mundo real a sus coordenadas relativas en pixels teniendo en cuenta que la coordenada superior izquierda es 0,0 y la inferior derecha es maxX y maY
java.awt.geom.Rectangle2D	getPxRectFromMapRect(java.awt.geom.Rectangle2D extent, double widthPx, double heightPx, java.awt.geom.Rectangle2D window) Convierte una ventana en coordenadas del mundo real a sus coordenadas relativas en pixels teniendo en cuenta que la coordenada superior izquierda es 0,0 y la inferior derecha es maxX y maY
int	getRasterBufTypeFromMrSIDType(int mrsidType) Conversión de los tipos de datos de MrSID a los tipos de datos de RasterBuf
Extent	getROIsMaximunExtent(java.util.List<ROI> rois) Obtiene el extent máximo de todas las ROIs pasadas por parámetro.
java.lang.String	getTrace(java.lang.Exception e) Gets the exception trace
Extent	intersection(Extent e1, Extent e2) Computes the extent which intersects both selecteds
boolean	intersects(Extent e1, Extent e2, java.awt.geom.AffineTransform at) Comprueba si un Extent tiene alguna parte en común con otro Extent dado, es decir, si ambos extents intersectan en alguna zona.
boolean	isBufferTooBig(double[] coords, double resolution, int bands) Dadas unas coordenadas pixel y un número de bandas, esta función comprueba si el tamaño de ventana que va a generarse supera el tamaño de la caché
boolean	isBufferTooBig(double[] coords, int bands) Dadas unas coordenadas pixel y un número de bandas, esta función comprueba si el tamaño de ventana que va a generarse supera el tamaño de la caché
boolean	isInside(Extent e1, Extent e2) Comprueba si un extent está contenido dentro de otro y devuelve true en este caso.
boolean	isInside(java.awt.geom.Point2D p1, Extent e1) Comprueba si un punto está contenido dentro de un extend y devuelve true en este caso.
boolean	isInside(java.awt.geom.Point2D p1, Extent e1, java.awt.geom.AffineTransform at) Comprueba si un punto está contenido dentro de un extend y devuelve true en este caso.
boolean	isOutside(Extent e1, Extent ref) Comprueba si un extent está fuera de otro extent que tenemos como referencia.
boolean	loadInMemory(RasterDataStore datasource) Devuelve true si el tamaño del dataset es menor que el de la caché y false si no lo es.
java.lang.String	parserGdalProj(java.lang.String proj) Parseo de las proyecciones que genera gdal para meter espaciados y saltos de línea HTML
void	saveGeoInfo(java.lang.String outRmf, java.awt.geom.AffineTransform at, java.awt.geom.Point2D dim) Guarda la información de georreferenciación de un raster en su fichero rmf adjunto.
java.lang.String	typesToString(int type) Convierte un tipo de dato a cadena
java.awt.geom.Point2D	worldPointToRaster(java.awt.geom.Point2D p, Extent ext, int pxWidth, int pxHeight) Convierte un punto en coordenadas del mundo a coordenadas pixel

Methods inherited from class java.lang.Object

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

Field Detail

MAX_BYTE_BIT_VALUE

public static final int MAX_BYTE_BIT_VALUE

See Also:

Constant Field Values

MAX_SHORT_BIT_VALUE

public static final int MAX_SHORT_BIT_VALUE

See Also:

Constant Field Values

Constructor Detail

DefaultRasterUtils

public DefaultRasterUtils()

Method Detail

loadInMemory

public boolean loadInMemory(RasterDataStore datasource)

Description copied from interface: RasterUtils

Devuelve true si el tamaño del dataset es menor que el de la caché y false si no lo es.

Specified by:

loadInMemory in interface RasterUtils

Parameters:

datasource - Fuente de datos

Returns:

true si podemos cargar en memoria el raster

isBufferTooBig

public boolean isBufferTooBig(double[] coords,
                              int bands)

Description copied from interface: RasterUtils

Dadas unas coordenadas pixel y un número de bandas, esta función comprueba si el tamaño de ventana que va a generarse supera el tamaño de la caché

Specified by:

isBufferTooBig in interface RasterUtils

Parameters:

coords - Coordenadas pixel del raster

bands - Número de bandas

Returns:

true si la ventana supera el tamaño de la caché o false si no lo supera.

isBufferTooBig

public boolean isBufferTooBig(double[] coords,
                              double resolution,
                              int bands)

Description copied from interface: RasterUtils

Dadas unas coordenadas pixel y un número de bandas, esta función comprueba si el tamaño de ventana que va a generarse supera el tamaño de la caché

Specified by:

isBufferTooBig in interface RasterUtils

Parameters:

coords - Coordenadas pixel del raster

bands - Número de bandas

Returns:

true si la ventana supera el tamaño de la caché o false si no lo supera.

getRasterBufTypeFromMrSIDType

public int getRasterBufTypeFromMrSIDType(int mrsidType)

Description copied from interface: RasterUtils

Conversión de los tipos de datos de MrSID a los tipos de datos de RasterBuf

Specified by:

getRasterBufTypeFromMrSIDType in interface RasterUtils

Parameters:

mrsidType - Tipo de dato de MrSID

Returns:

Tipo de dato de RasterBuf

getBytesFromRasterBufType

public int getBytesFromRasterBufType(int rasterBufType)

Description copied from interface: RasterUtils

Obtiene el número de bytes que ocupa un tipo de dato concreto. Los tipos de datos son los utilizados en RasterBuffer

Specified by:

getBytesFromRasterBufType in interface RasterUtils

Parameters:

rasterBufType - Tipo de dato del que se solicita el número de bytes ocupados

Returns:

getBytesFromRaster

public long getBytesFromRaster(int width,
                               int height,
                               int rasterType,
                               int nBands)

Description copied from interface: RasterUtils

Devuelve el tamaño en bytes de una región de un raster en función de su dimensión, número de bandas y tipo de dato.

Specified by:

getBytesFromRaster in interface RasterUtils

Returns:

typesToString

public java.lang.String typesToString(int type)

Description copied from interface: RasterUtils

Convierte un tipo de dato a cadena

Specified by:

typesToString in interface RasterUtils

Parameters:

type - Tipo de dato

Returns:

cadena que representa el tipo de dato

parserGdalProj

public java.lang.String parserGdalProj(java.lang.String proj)

Description copied from interface: RasterUtils

Parseo de las proyecciones que genera gdal para meter espaciados y saltos de línea HTML

Specified by:

parserGdalProj in interface RasterUtils

Parameters:

proj - Proyección

Returns:

Cadena con la proyección parseada

getPxRectFromMapRect

public java.awt.geom.Rectangle2D getPxRectFromMapRect(java.awt.geom.Rectangle2D extent,
                                                      double widthPx,
                                                      double heightPx,
                                                      java.awt.geom.Rectangle2D window)

Description copied from interface: RasterUtils

Convierte una ventana en coordenadas del mundo real a sus coordenadas relativas en pixels teniendo en cuenta que la coordenada superior izquierda es 0,0 y la inferior derecha es maxX y maY

Specified by:

getPxRectFromMapRect in interface RasterUtils

Parameters:

extent - Extent de la imagen original

widthPx - Ancho en pixeles de la imagen original

heightPx - Alto en pixeles de la imagen original

window - Ventana en coordenadas reales a transportar a coordenadas pixel

Returns:

Ventana en coordenadas pixel

getMapRectFromPxRect

public java.awt.geom.Rectangle2D getMapRectFromPxRect(java.awt.geom.Rectangle2D extent,
                                                      double widthPx,
                                                      double heightPx,
                                                      java.awt.geom.Rectangle2D pxWindow)

Description copied from interface: RasterUtils

Convierte una ventana en coordenadas del mundo real a sus coordenadas relativas en pixels teniendo en cuenta que la coordenada superior izquierda es 0,0 y la inferior derecha es maxX y maY

Specified by:

getMapRectFromPxRect in interface RasterUtils

Parameters:

extent - Extent de la imagen original

widthPx - Ancho en pixeles de la imagen original

heightPx - Alto en pixeles de la imagen original

Returns:

Ventana en coordenadas pixel

worldPointToRaster

public java.awt.geom.Point2D worldPointToRaster(java.awt.geom.Point2D p,
                                                Extent ext,
                                                int pxWidth,
                                                int pxHeight)

Description copied from interface: RasterUtils

Convierte un punto en coordenadas del mundo a coordenadas pixel

Specified by:

worldPointToRaster in interface RasterUtils

Parameters:

p - Punto a convertir

ext - Extent completo de la imagen

Returns:

Punto en coordenadas pixel

intersects

public boolean intersects(Extent e1,
                          Extent e2,
                          java.awt.geom.AffineTransform at)
                   throws java.awt.geom.NoninvertibleTransformException

Description copied from interface: RasterUtils

Comprueba si un Extent tiene alguna parte en común con otro Extent dado, es decir, si ambos extents intersectan en alguna zona. La llamada tiene en cuenta alguna transformación aplicada al Extent.

Specified by:

intersects in interface RasterUtils

Returns:

true si intersectan y false si no lo hacen

Throws:

java.awt.geom.NoninvertibleTransformException

intersection

public Extent intersection(Extent e1,
                           Extent e2)

Description copied from interface: RasterUtils

Computes the extent which intersects both selecteds

Specified by:

intersection in interface RasterUtils

Returns:

intersection

isInside

public boolean isInside(java.awt.geom.Point2D p1,
                        Extent e1,
                        java.awt.geom.AffineTransform at)

Description copied from interface: RasterUtils

Comprueba si un punto está contenido dentro de un extend y devuelve true en este caso. Se tiene en cuenta la transformación aplicada al raster.

Specified by:

isInside in interface RasterUtils

Parameters:

p1 - Punto a comprobar si está contenido en e1

e1 - Extent sobre el que se comprueba si e1 está dentro el punto

Returns:

true si p1 está dentro de e1

isInside

public boolean isInside(Extent e1,
                        Extent e2)

Description copied from interface: RasterUtils

Comprueba si un extent está contenido dentro de otro y devuelve true en este caso.

Specified by:

isInside in interface RasterUtils

Parameters:

e1 - Extent a comprobar si está contenido en e2

e2 - Extent sobre el que se comprueba si e1 está dentro

Returns:

true si e1 está dentro de e1

isInside

public boolean isInside(java.awt.geom.Point2D p1,
                        Extent e1)

Description copied from interface: RasterUtils

Comprueba si un punto está contenido dentro de un extend y devuelve true en este caso.

Specified by:

isInside in interface RasterUtils

Parameters:

p1 - Punto a comprobar si está contenido en e1

e1 - Extent sobre el que se comprueba si e1 está dentro el punto

Returns:

true si p1 está dentro de e1

isOutside

public boolean isOutside(Extent e1,
                         Extent ref)

Description copied from interface: RasterUtils

Comprueba si un extent está fuera de otro extent que tenemos como referencia.

Specified by:

isOutside in interface RasterUtils

Parameters:

e1 - Extent a comprobar si está fuera

ref - Extent de referencia

Returns:

Devuelve true si todo el extent cae fuera de ref y false si no está fuera.

compareExtents

public boolean compareExtents(Extent e1,
                              Extent e2)

Description copied from interface: RasterUtils

Compara dos extents y devuelve true si son iguales

Specified by:

compareExtents in interface RasterUtils

Parameters:

e1 - Extent a comparar

e2 - Extent a comparar

Returns:

true si los extents pasados por parámetro son iguales y false si no lo son

cornersToWorldFile

public double[] cornersToWorldFile(java.awt.geom.Point2D[] esq,
                                   java.awt.Dimension size)

Description copied from interface: RasterUtils

Calcula los parámetros de un worl file a partir de las esquinas del raster. 1. X pixel size A 2. X rotation term D 3. Y rotation term B 4. Y pixel size E 5. X coordinate of upper left corner C 6. Y coordinate of upper left corner F where the real-world coordinates x',y' can be calculated from the image coordinates x,y with the equations x' = Ax + By + C and y' = Dx + Ey + F. The signs of the first 4 parameters depend on the orientation of the image. In the usual case where north is more or less at the top of the image, the X pixel size will be positive and the Y pixel size will be negative. For a south-up image, these signs would be reversed. You can calculate the World file parameters yourself based on the corner coordinates. The X and Y pixel sizes can be determined simply by dividing the distance between two adjacent corners by the number of columns or rows in the image. The rotation terms are calculated with these equations: # B = (A * number_of_columns + C - lower_right_x') / number_of_rows * -1 # D = (E * number_of_rows + F - lower_right_y') / number_of_columns * -1

Specified by:

cornersToWorldFile in interface RasterUtils

Returns:

adjustToPixelSize

public void adjustToPixelSize(java.awt.geom.Point2D[] points,
                              java.awt.geom.Point2D dim)

Description copied from interface: RasterUtils

Ajusta el valor del array de puntos pasado como primer parámetro a las dimensiones de la imagen. Estas dimensiones serán 0-dim.getX() a 0-dim.getY(). Para cada valor, si es menor que 0 se pondrá a 0 y si es mayor del máximo se asignará al máximo.

Specified by:

adjustToPixelSize in interface RasterUtils

Parameters:

points - Lista de puntos a ajustar

dim - Dimension

getTrace

public java.lang.String getTrace(java.lang.Exception e)

Gets the exception trace

Specified by:

getTrace in interface RasterUtils

Parameters:

e -

Returns:

the exception trace

formatTime

public java.lang.String formatTime(long time)

Description copied from interface: RasterUtils

Formatea el tiempo en milisegundos devolviendo un String en formato . dias, horas, minutos y segundos.

Specified by:

formatTime in interface RasterUtils

Parameters:

time - Tiempo en milisegundos

getCoord

public java.lang.String[] getCoord(double minx,
                                   double miny,
                                   double maxx,
                                   double maxy,
                                   int dec)

Description copied from interface: RasterUtils

Obtiene un texto con las coordenadas a partir de números en coma flotante.

Specified by:

getCoord in interface RasterUtils

Parameters:

minx - coordenada mínima de X

miny - coordenada mínima de Y

maxx - coordenada máxima de X

maxy - coordenada máxima de Y

dec - Número de decimales a mostrar en la caja de texto

calculateAdjustedView

public Extent calculateAdjustedView(Extent extToAdj,
                                    Extent imgExt)

Description copied from interface: RasterUtils

Ajusta la extensión pasada por parámetro a los valores máximos y mínimos de la imagen. Esto sirve para que la petición al driver nunca sobrepase los límites de la imagen tratada aunque la vista donde se dibuje sea de mayor tamaño.

Specified by:

calculateAdjustedView in interface RasterUtils

Parameters:

extToAdj - Extent a ajustar.

imgExt - Extent completo de la vista donde se va a dibujar.

Returns:

adjustedExtent Extent ajustado a máximos y mínimos

calculateAdjustedView

public Extent calculateAdjustedView(Extent extToAdj,
                                    java.awt.geom.AffineTransform at,
                                    double w,
                                    double h)

Description copied from interface: RasterUtils

Ajusta la extensión pasada por parámetro a los valores máximos y mínimos de la imagen. Esto sirve para que la petición al driver nunca sobrepase los límites de la imagen tratada aunque la vista donde se dibuje sea de mayor tamaño. Este método tiene en cuenta la rotación aplicada al raster por lo que no ajustamos a un extent sino a una matriz de transformación. Esta tiene los parámetros de traslación, rotación y escalado del raster destino. Esta matriz transforma coordenadas pixel a real y viceversa.

Specified by:

calculateAdjustedView in interface RasterUtils

Returns:

adjustedExtent Extent ajustado a máximos y mínimos

saveGeoInfo

public void saveGeoInfo(java.lang.String outRmf,
                        java.awt.geom.AffineTransform at,
                        java.awt.geom.Point2D dim)
                 throws java.io.IOException

Description copied from interface: RasterUtils

Guarda la información de georreferenciación de un raster en su fichero rmf adjunto.

Specified by:

saveGeoInfo in interface RasterUtils

Throws:

java.io.IOException

getROIsMaximunExtent

public Extent getROIsMaximunExtent(java.util.List<ROI> rois)

Obtiene el extent máximo de todas las ROIs pasadas por parámetro.

Specified by:

getROIsMaximunExtent in interface RasterUtils

Parameters:

rois - Lista de ROIs para calcular la extensión máxima que ocupan

Returns:

Entent máximo

convertHistogramToRGB

public BufferHistogram convertHistogramToRGB(BufferHistogram histogram)

Convierte un histograma al rango de valores de RGB, en pocas palabras aplica una operacion 0xff a cada pixel para quitar los numeros negativos y desplazarlos a su rango visual.

Specified by:

convertHistogramToRGB in interface RasterUtils

Parameters:

histogram -

copyToBuffer

public void copyToBuffer(Buffer bufResult,
                         Extent tileExtent,
                         Buffer buf,
                         Extent ex,
                         double rel,
                         boolean hasAlphaBand)

Description copied from interface: RasterUtils

Copies a piece of image into another taking into account the different size and proportion

Specified by:

copyToBuffer in interface RasterUtils

Parameters:

bufResult - output buffer

tileExtent - bounding box of the output buffer

buf - input buffer

ex - bounding box of the input buffer

rel - ratio between both pixel sizes

hasAlphaBand - true if the last band is a alpha band