org.gvsig.fmap.dal.coverage.util

Interface RasterUtils

All Known Implementing Classes:

DefaultRasterUtils

public interface RasterUtils

Raster utilities without gvSIG dependencies

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

Method Detail

loadInMemory

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.

Parameters:

datasource - Fuente de datos

Returns:

true si podemos cargar en memoria el raster

isBufferTooBig

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é

Parameters:

coords - Coordenadas pixel del raster

bands - Número de bandas

ds -

Returns:

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

isBufferTooBig

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é

Parameters:

coords - Coordenadas pixel del raster

bands - Número de bandas

ds -

Returns:

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

getRasterBufTypeFromMrSIDType

int getRasterBufTypeFromMrSIDType(int mrsidType)

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

Parameters:

mrsidType - Tipo de dato de MrSID

Returns:

Tipo de dato de RasterBuf

getBytesFromRasterBufType

int getBytesFromRasterBufType(int rasterBufType)

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

Parameters:

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

Returns:

getBytesFromRaster

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.

Parameters:

width -

height -

rasterType -

nBands -

Returns:

typesToString

java.lang.String typesToString(int type)

Convierte un tipo de dato a cadena

Parameters:

type - Tipo de dato

Returns:

cadena que representa el tipo de dato

parserGdalProj

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

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

Parameters:

proj - Proyección

Returns:

Cadena con la proyección parseada

getPxRectFromMapRect

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

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

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

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

worldPointToRaster

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

Parameters:

p - Punto a convertir

ext - Extent completo de la imagen

Returns:

Punto en coordenadas pixel

intersects

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

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.

Parameters:

e1 -

e2 -

Returns:

true si intersectan y false si no lo hacen

Throws:

java.awt.geom.NoninvertibleTransformException

intersection

Extent intersection(Extent e1,
                    Extent e2)

Computes the extent which intersects both selecteds

Parameters:

e1 -

e2 -

Returns:

intersection

isInside

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. Se tiene en cuenta la transformación aplicada al raster.

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

boolean isInside(Extent e1,
                 Extent e2)

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

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

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.

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

boolean isOutside(Extent e1,
                  Extent ref)

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

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

boolean compareExtents(Extent e1,
                       Extent e2)

Compara dos extents y devuelve true si son iguales

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

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. 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

Parameters:

corner - (tl, tr, br, bl)

Returns:

adjustToPixelSize

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. 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.

Parameters:

points - Lista de puntos a ajustar

dim - Dimension

getTrace

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

Gets the exception trace

Parameters:

e -

Returns:

formatTime

java.lang.String formatTime(long time)

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

Parameters:

time - Tiempo en milisegundos

getCoord

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.

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

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. 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.

Parameters:

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

AffineTransform - Matriz de transformación del raster destino

Returns:

adjustedExtent Extent ajustado a máximos y mínimos

saveGeoInfo

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

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

Parameters:

path -

at -

dim -

Throws:

java.io.IOException

calculateAdjustedView

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. 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.

Parameters:

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

extToAdj - Extent a ajustar.

Returns:

adjustedExtent Extent ajustado a máximos y mínimos

getROIsMaximunExtent

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

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

Parameters:

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

Returns:

Entent máximo

convertHistogramToRGB

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.

Parameters:

histogram -

copyToBuffer

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

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