org.gvsig.raster.gdal.io

Class GdalDataSource

java.lang.Object

org.gvsig.jgdal.GdalDataset

org.gvsig.raster.gdal.io.GdalDataSource

All Implemented Interfaces:

Disposable

public class GdalDataSource
extends GdalDataset
implements Disposable

Soporte 'nativo' para ficheros desde GDAL.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	aBandNr
protected int	bBandNr
protected DataStoreColorInterpretation	colorInterpr
protected AffineTransform	externalTransformation
protected DataStoreTransparency	fileTransparency Estado de transparencia del raster.
protected int	gBandNr
protected GdalRasterBand[]	gdalBands
protected boolean	georeferenced
int	height
boolean	isSupersampling
double	originX
double	originY
protected AffineTransform	ownTransformation
protected DataStoreColorTable	palette
protected int	rBandNr
int[]	stepArrayX Vectores que contiene los desplazamientos de un pixel cuando hay supersampling
int[]	stepArrayY
GeoTransform	trans
String	version
int	width

Fields inherited from class org.gvsig.jgdal.GdalDataset

GA_ReadOnly, GA_Update, GDT_Byte, GDT_CFloat32, GDT_CFloat64, GDT_CInt16, GDT_CInt32, GDT_Float32, GDT_Float64, GDT_Int16, GDT_Int32, GDT_TypeCount, GDT_UInt16, GDT_UInt32, GDT_Unknown

Constructor Summary

Constructors

Constructor and Description
GdalDataSource(String fName)

Method Summary

Modifier and Type	Method and Description
void	dispose() Disposes the current object, to allow it to close and dispose any used resources.
boolean	existsNoDataValue() Obtiene el flag que informa de si el raster tiene valor no data o no.
boolean	existsNoDataValue(int band) Obtiene el flag que informa de si el raster tiene valor no data o no en una banda concreta.
protected void	finalize()
int	getBlockSize()
ColorInterpretation	getColorInterpretation() Gets the color interpretation
ColorTable	getColorTable() Gets the color table
Object[]	getData(int x, int y) Obtiene el valor de un pixel determinado por las coordenadas x e y que se pasan por par?
int[]	getDataType() Obtiene el tipo de dato
Extent	getExtentWithoutRot() Calcula el extent en coordenadas del mundo real sin rotaci?
String	getGdalShortName() Obtiene el nombre del driver de Gdal
static int	getGdalTypeFromRasterBufType(int rasterBufType)
NoData	getNoDataValue() Gets nodata value
AffineTransform	getOwnTransformation() Devuelve la transformaci?
static int	getRasterBufTypeFromGdalType(int gdalType) Conversi?
boolean	isOpen() Returns true if this provider is open and false if don't
Point2D	rasterToWorld(Point2D pt) Obtiene un punto del raster en coordenadas pixel a partir de un punto en coordenadas reales.
Object	readBlock(int pos, int blockHeight, double scale) Lee una bloque completo del raster y devuelve un array tridimensional del tipo correcto.
Object	readCompleteLine(int nLine, int band) Lee una l?
void	readLine(Object line) Lectura de una l?
void	readWindow(Buffer buf, BandList bandList, double ulx, double uly, double lrx, double lry, double nWidth, double nHeight, int bufWidth, int bufHeight, boolean adjustToExtent, TaskStatus status) Lee una ventana de datos con resampleo a partir de coordenadas reales.
void	readWindow(Buffer buf, BandList bandList, double ulx, double uly, double lrx, double lry, int nWidth, int nHeight, boolean adjustToExtent, TaskStatus status) Lee una ventana de datos sin resampleo a partir de coordenadas reales.
void	readWindow(Buffer buf, BandList bandList, Extent ext, Rectangle adjustedWindow, TaskStatus status)
void	readWindow(Buffer buf, BandList bandList, int x, int y, int w, int h, TaskStatus status) Lee una ventana de datos con resampleo a partir de coordenadas en pixeles.
void	selectGdalBands(int nbands) Selecciona bandas y overview en el objeto GdalRasterBand[] para el n?
void	setDataType(int[] dt) Asigna el tipo de dato
void	setExternalTransform(AffineTransform t) Asigna una transformaci?
void	setView(double dWorldTLX, double dWorldTLY, double dWorldBRX, double dWorldBRY, int nWidth, int nHeight)
Point2D	worldToRaster(Point2D pt) Obtiene un punto 2D con las coordenadas del raster a partir de uno en coordenadas del punto real.
Point2D	worldToRasterWithoutRot(Point2D pt) Obtiene un punto 2D con las coordenadas del raster a partir de uno en coordenadas del punto real.

Methods inherited from class org.gvsig.jgdal.GdalDataset

close, getColorInterpretationName, getDataset, getDriverByName, getDriverShortName, getGCPCount, getGeoTransform, getMetadata, getMetadata, getProjectionRef, getRasterBand, getRasterCount, getRasterXSize, getRasterYSize, open, setGeoTransform, setProjection

Methods inherited from class java.lang.Object

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

Field Detail

trans

public GeoTransform trans

width

public int width

height

public int height

originX

public double originX

originY

public double originY

version

public String version

rBandNr

protected int rBandNr

gBandNr

protected int gBandNr

bBandNr

protected int bBandNr

aBandNr

protected int aBandNr

georeferenced

protected boolean georeferenced

stepArrayX

public int[] stepArrayX

Vectores que contiene los desplazamientos de un pixel cuando hay supersampling. , es decir el n?mero de pixels de pantalla que tiene un pixel de imagen. Como todos los pixeles no tienen el mismo ancho y alto ha de meterse en un array y no puede ser una variable. Adem?s hay que tener en cuenta que el primer y ?ltimo pixel son de distinto tama?o que el resto.

stepArrayY

public int[] stepArrayY

gdalBands

protected GdalRasterBand[] gdalBands

isSupersampling

public boolean isSupersampling

fileTransparency

protected DataStoreTransparency fileTransparency

Estado de transparencia del raster.

palette

protected DataStoreColorTable palette

colorInterpr

protected DataStoreColorInterpretation colorInterpr

ownTransformation

protected AffineTransform ownTransformation

externalTransformation

protected AffineTransform externalTransformation

Constructor Detail

GdalDataSource

public GdalDataSource(String fName)
               throws GdalException,
                      IOException

Throws:

GdalException

IOException

Method Detail

getGdalTypeFromRasterBufType

public static int getGdalTypeFromRasterBufType(int rasterBufType)

getRasterBufTypeFromGdalType

public static int getRasterBufTypeFromGdalType(int gdalType)

Conversi?n de los tipos de datos de gdal a los tipos de datos de RasterBuf

Parameters:

gdalType - Tipo de dato de gdal

Returns:

Tipo de dato de RasterBuf

isOpen

public boolean isOpen()

Returns true if this provider is open and false if don't

Returns:

existsNoDataValue

public boolean existsNoDataValue()
                          throws GdalException

Obtiene el flag que informa de si el raster tiene valor no data o no. Consultar? todas las bandas del mismo y si alguna tiene valor no data devuelve true sino devolver? false.

Returns:

true si tiene valor no data y false si no lo tiene

Throws:

GdalException

existsNoDataValue

public boolean existsNoDataValue(int band)
                          throws GdalException

Obtiene el flag que informa de si el raster tiene valor no data o no en una banda concreta.

Parameters:

band - Posici?n de la banda a consultar (0..n)

Returns:

true si tiene valor no data en esa banda y false si no lo tiene

Throws:

GdalException

getNoDataValue

public NoData getNoDataValue()

Gets nodata value

Returns:

setDataType

public void setDataType(int[] dt)

Asigna el tipo de dato

Parameters:

dt - entero que representa el tipo de dato

getDataType

public int[] getDataType()

Obtiene el tipo de dato

Returns:

entero que representa el tipo de dato

getColorInterpretation

public ColorInterpretation getColorInterpretation()

Gets the color interpretation

Returns:

getColorTable

public ColorTable getColorTable()

Gets the color table

Returns:

worldToRasterWithoutRot

public Point2D worldToRasterWithoutRot(Point2D pt)

Obtiene un punto 2D con las coordenadas del raster a partir de uno en coordenadas del punto real. Supone rasters no girados

Parameters:

pt - punto en coordenadas del punto real

Returns:

punto en coordenadas del raster

worldToRaster

public Point2D worldToRaster(Point2D pt)

Obtiene un punto 2D con las coordenadas del raster a partir de uno en coordenadas del punto real. Supone rasters no girados

Parameters:

pt - punto en coordenadas del punto real

Returns:

punto en coordenadas del raster

rasterToWorld

public Point2D rasterToWorld(Point2D pt)

Obtiene un punto del raster en coordenadas pixel a partir de un punto en coordenadas reales.

Parameters:

pt - Punto en coordenadas reales

Returns:

Punto en coordenadas pixel.

setView

public void setView(double dWorldTLX,
                    double dWorldTLY,
                    double dWorldBRX,
                    double dWorldBRY,
                    int nWidth,
                    int nHeight)
             throws GdalException

Throws:

GdalException

selectGdalBands

public void selectGdalBands(int nbands)
                     throws GdalException

Selecciona bandas y overview en el objeto GdalRasterBand[] para el n?mero de bandas solicitado.

Parameters:

nbands - N?mero de bandas solicitado.

Throws:

GdalException

readCompleteLine

public Object readCompleteLine(int nLine,
                               int band)
                        throws GdalException

Lee una l?nea completa del raster y devuelve un array del tipo correcto. Esta funci?n es util para una lectura rapida de todo el fichero sin necesidad de asignar vista.

Parameters:

nLine - N?mero de l?nea a leer

band - Banda requerida

Returns:

Object que es un array unidimendional del tipo de datos del raster

Throws:

GdalException

readBlock

public Object readBlock(int pos,
                        int blockHeight,
                        double scale)
                 throws GdalException,
                        ProcessInterruptedException

Lee una bloque completo del raster y devuelve un array tridimensional del tipo correcto. Esta funci?n es util para una lectura rapida de todo el fichero sin necesidad de asignar vista.

Parameters:

nLine - N?mero de l?nea a leer

band - Banda requerida

Returns:

Object que es un array unidimendional del tipo de datos del raster

Throws:

GdalException

ProcessInterruptedException

readLine

public void readLine(Object line)
              throws GdalException

Lectura de una l?nea de datos.

Parameters:

line -

Throws:

GdalException

readWindow

public void readWindow(Buffer buf,
                       BandList bandList,
                       double ulx,
                       double uly,
                       double lrx,
                       double lry,
                       int nWidth,
                       int nHeight,
                       boolean adjustToExtent,
                       TaskStatus status)
                throws GdalException,
                       ProcessInterruptedException

Lee una ventana de datos sin resampleo a partir de coordenadas reales.

Parameters:

buf - Buffer donde se almacenan los datos

bandList - Lista de bandas que queremos leer y sobre que bandas del buffer de destino queremos escribirlas

dWorldTLX - Posici?n X superior izquierda en coord reales

dWorldTLY - Posici?n Y superior izquierda en coord reales

dWorldBRX - Posici?n X inferior derecha en coord reales

dWorldBRY - Posici?n Y inferior derecha en coord reales

nWidth - Ancho en pixeles del buffer

nHeight - Alto en pixeles del buffer

Throws:

GdalException

ProcessInterruptedException

readWindow

public void readWindow(Buffer buf,
                       BandList bandList,
                       Extent ext,
                       Rectangle adjustedWindow,
                       TaskStatus status)
                throws GdalException,
                       ProcessInterruptedException

Throws:

GdalException

ProcessInterruptedException

readWindow

public void readWindow(Buffer buf,
                       BandList bandList,
                       double ulx,
                       double uly,
                       double lrx,
                       double lry,
                       double nWidth,
                       double nHeight,
                       int bufWidth,
                       int bufHeight,
                       boolean adjustToExtent,
                       TaskStatus status)
                throws GdalException,
                       ProcessInterruptedException

Lee una ventana de datos con resampleo a partir de coordenadas reales. Este m?todo lee la ventana de una vez cargando los datos de un golpe en el buffer. Las coordenadas se solicitan en coordenadas del mundo real por lo que estas pueden caer en cualquier parte de un pixel. Esto se hace m?s evidente cuando supersampleamos en la petici?n, es decir el buffer de de mayor tama?o que el n?mero de pixels solicitado. Para resolver esto escribiremos con la funci?n readRaster los datos sobre un buffer mayor que el solicitado. Despu?s calcularemos el desplazamiento en pixels dentro de este buffer de mayor tama?o hasta llegar a la coordenada real donde comienza la petici?n real que ha hecho el usuario. Esto es as? porque cuando supersampleamos no queremos los pixeles del raster de disco completos sino que en los bordes del buffer quedan cortados.

Parameters:

buf - Buffer donde se almacenan los datos

bandList - Lista de bandas que queremos leer y sobre que bandas del buffer de destino queremos escribirlas

dWorldTLX - Posici?n X superior izquierda en coord reales

dWorldTLY - Posici?n Y superior izquierda en coord reales

dWorldBRX - Posici?n X inferior derecha en coord reales

dWorldBRY - Posici?n Y inferior derecha en coord reales

nWidth - Ancho en pixeles de la petici?n

nHeight - Alto en pixeles de la petici?n

bufWidth - Ancho del buffer

bufHeight - Alto del buffer

Throws:

GdalException

ProcessInterruptedException

readWindow

public void readWindow(Buffer buf,
                       BandList bandList,
                       int x,
                       int y,
                       int w,
                       int h,
                       TaskStatus status)
                throws GdalException,
                       ProcessInterruptedException

Lee una ventana de datos con resampleo a partir de coordenadas en pixeles. Este m?todo lee la ventana de una vez cargando los datos de un golpe en el buffer.

Parameters:

buf - Buffer donde se almacenan los datos

bandList - Lista de bandas que queremos leer y sobre que bandas del buffer de destino queremos escribirlas

x - Posici?n X en pixeles

y - Posici?n Y en pixeles

w - Ancho en pixeles

h - Alto en pixeles

bufWidth - Ancho del buffer

bufHeight - Alto del buffer

Throws:

GdalException

ProcessInterruptedException

getData

public Object[] getData(int x,
                        int y)

Obtiene el valor de un pixel determinado por las coordenadas x e y que se pasan por par?metro

Parameters:

x - Coordenada X del pixel

y - Coordenada Y del pixel

Returns:

Array de Object donde cada posici?n representa una banda y el valor ser? Integer en caso de ser byte, shot o int, Float en caso de ser float y Double en caso de ser double.

getBlockSize

public int getBlockSize()

getOwnTransformation

public AffineTransform getOwnTransformation()

Devuelve la transformaci?n del fichero de georreferenciaci?n

Returns:

AffineTransform

getExtentWithoutRot

public Extent getExtentWithoutRot()

Calcula el extent en coordenadas del mundo real sin rotaci?n. Solo coordenadas y tama?o de pixel

Returns:

Extent

setExternalTransform

public void setExternalTransform(AffineTransform t)

Asigna una transformaci?n que es aplicada sobre la que ya tiene el propio fichero

Parameters:

t -

getGdalShortName

public String getGdalShortName()

Obtiene el nombre del driver de Gdal

Returns:

Cadena que representa el nombre del driver de gdal

dispose

public void dispose()

Description copied from interface: Disposable

Disposes the current object, to allow it to close and dispose any used resources.

NOTE:After calling this method, the object may not be usable anymore.

Specified by:

dispose in interface Disposable

finalize

protected void finalize()

Overrides:

finalize in class Object