Revision 435 2.1/trunk/doc/Fase 1/dt-visor-3d.rst

View differences:

dt-visor-3d.rst
119 119
Asigna las propiedades a la capa que recibe como parámetro.
120 120

  
121 121
.. note::
122
  Falta especificar las propiedades relacionadas con la vista y la propiedades generales.
122
  Falta especificar las propiedades relacionadas con la vista, las propiedades generales y sus interfaces.
123 123

  
124 124
MapControl3D
125 125
****************************
......
269 269

  
270 270
* getRasterized() : boolean
271 271

  
272
Obtiene si el modo de carga de la capa vecotiral es rasterizado o no.
272
Obtiene si el modo de carga de la capa vectorial es rasterizado o no.
273 273

  
274 274
SWING IMPL
275 275
--------------
......
311 311

  
312 312
  * DATA_CACHE_NAME: Nombre de la carpeta dentro de la cache donde se alojará los tiles generados en tiempo de ejecución. Este nombre debe ser único.
313 313
  * SECTOR: Zona geográfica del raster especificada en grados sobre la proyección EPSG:4326.
314
  * WIDTH: ancho en píxeles de la imagen raster.
315
  * HEIGHT: alto en píxeles de la imagen raster.
316
  * DISPLAY_NAME: Nombre de la capa.
317
  * FILE_STORE: almacén de archivos de la cache. Proporciona métodos para añadir / quitar localizaciones, buscar archivos, borra archivos...
318
  * IMAGE_FORMAT: formato de los tiles que se generan.
319
  * FORMAT_SUFFIX: sufijo de archivo de los tiles generados.
314 320

  
315 321
  Además de estos parámetros también es necesario añadir en tiempo de ejecución la capa gvSIG que se desea convertir de la cual se obtendrá la información para la creación de tiles mediante la clave GVSIG_LAYER.
316 322
  Por otra parte, existen parámetros opcionales que si no se asigna ningún valor la librería asigna el valor por defecto. Debido al gran número de parámetros configurables se resaltan los siguientes:
317 323

  
318
  * Opciones de capas: nombre de la capa, opacidad, máxima y mínima altura de activación...
324
  * Opciones de capas: opacidad, máxima y mínima altura de activación...
319 325
  * Estructura de niveles de detalle: nivel máximo y mínimo de nivel de detalle, niveles inactivos...
320
  * Generación de tiles: tamaño del tile, origen del primer tile, extensión y formato de los tiles generados... 
326
  * Generación de tiles: tamaño del tile, origen del primer tile, extensión de los tiles generados... 
321 327

  
322
* Crear la capa de tipo RasterTileImageLayer a partir de los parámetros y añadirla al modelo. Al instanciar una nueva capa RasterTileImageLayer, se configura una factoría del tipo DefaultRetrieverFactory la cual permite la creación de objetos DefaultRasterRetriever. Dichos objetos son los encargados de realizar la distintas peticiones a un objeto DefaultRasterServer el cual es el encargado de servir la información procedente de un DefaultDataRaster. Los objetos DefaultDataRaster tienen asociado un almacén de datos de gvSIG que es de donde obtiene la información.
328
* Crear la capa de tipo RasterTileImageLayer a partir de los parámetros y añadirla al modelo. Al instanciar una nueva capa RasterTileImageLayer, se configura una factoría del tipo DefaultRetrieverFactory la cual permite la creación de objetos DefaultRasterRetriever. Dichos objetos son los encargados de realizar la distintas peticiones a un objeto DefaultRasterServer el cual es el encargado de servir la información procedente de un DataRaster. Dependiendo del tipo de capa y el modo de carga será una implementación u otra. En el caso de casa raster con modo de carga imagen el tipo será RasterLayerDataRaster y para capas vectoriales rasterizadas RasterizedVectorialLayer
323 329

  
324
Esta implementación de LayerConverter puede usarse tanto para FLyrRaster como para FLyrVect con modo de carga rasterizado. La unica diferencia entre ambas es que cuando el objeto DefaultRasterServer cree un DataRaster mediante DefaultDataRaster le devolverá una implementación diferente en base al tipo de capa.
330
Esta implementación de LayerConverter puede usarse tanto para FLyrRaster como para FLyrVect con modo de carga rasterizado. La única diferencia entre ambas es que cuando el objeto DefaultRasterServer cree un DataRaster mediante DefaultDataRaster le devolverá una implementación diferente en base al tipo de capa.
325 331

  
326 332
La rasterización de capa vectoriales se realiza en VectorialLayerDataRaster en base a las peticiones que recibe por parte de DefaultRasterServer. El proceso se rasterización consistirá en usar el método FLyrVect#draw(image,graphics,viewport, scale) estableciendo el ViewPort a la zona o sección requerida para la obtención del tile.
327 333

  
328 334
DefaultElevationLayerConverter implements LayerConverter
329 335
***********************************************************
330 336

  
331
.. note::
332
  TODO en fases posteriores
337
Implementación de la interfaz LayerConverter que permite convertir una capa FLyrRaster en DefaultElevationModel mediante LayerConverter#convert(FLayer layer). El proceso de conversión debe seguir los siguientes puntos:
333 338

  
339
* Configuración de los parámetros necesarios en un fichero XML para crear una modelo de elevación ElevationModel. Los parámetros necesarios son:
340

  
341
  * DISPLAY_NAME: Nombre del modelo de elevación
342
  * SECTOR: Zona geográfica del raster especificada en grados sobre la proyección EPSG:4326.
343
  * WIDTH: ancho en píxeles de la imagen raster.
344
  * HEIGHT: alto en píxeles de la imagen raster.
345
  * FILE_STORE: almacén de archivos de la cache. Proporciona métodos para añadir / quitar localizaciones, buscar archivos, borra archivos...
346
  * IMAGE_FORMAT: formato de los tiles genera
347
  * DATA_TYPE: tipo de dato de la información del raster.
348
  * PIXEL_FORMAT: formato del pixel: AVKey.ELEVATION o AVKey.IMAGE
349
  * FORMAT_SUFFIX: sufijo de archivo de los tiles generados.
350

  
351
  Además de estos parámetros también es necesario añadir en tiempo de ejecución la capa gvSIG que se desea convertir de la cual se obtendrá la información para la creación de tiles mediante la clave GVSIG_LAYER.
352

  
353
  Por otra parte, existen parámetros opcionales que si no se asigna ningún valor la librería asigna el valor por defecto. Los parámetros opcionales son:
354

  
355
  * BYTE_ORDER: orden de los bytes. Little endian o big endian.
356
  * ELEVATION_MAX: elevación máxima y mínima.
357
  * ELEVATION_MIN: elevación mínima del raster.
358
  * EXPIRY_TIME: tiempo de expiración de un tile dentro de la cache.
359
  * MISSING_DATA_SIGNAL: Valor "no data"
360
  * MISSING_DATA_REPLACEMENT: Valor que se obtiene al obtener la elevación sobre un punto "no data".
361
  * NETWORK_RETRIEVAL_ENABLED: Indica el modo de trabajo online o offline.
362
  * ELEVATION_EXTREMES_FILE: ruta al fichero que contiene información sobre las elevaciones extremas.
363

  
364
* Crear el modelo de elevación DefaultElevationModel a partir de lo parámetros y añadirlo al modelo ya existente. El modelo existente será de tipo CompoundElevationModel el cual permite añadir varios modelos de elevación y mostrarlos a la vez. Al instanciar un nuevo modelo de elevación, se configura una factoría del tipo DefaultRetrieverFactory la cual permite la creación de objetos DefaultRasterRetriever. Dichos objetos son los encargados de realizar las distintas peticiones a un objeto DefaultRasterServer el cual es el encargado de servir la información procedente de un DataRaster. Para este caso el DataRaster será de tipo ElevationLayerDataRaster el cual atacará sobre la capa raster para obtener la información que se precise.
365

  
334 366
DefaultWMSLayerConverter implements LayerConverter
335 367
**********************************************************
336 368

  
......
350 382

  
351 383
Esta capa tiene enlazado un objeto DefaultRetrieverFactory que le permite a la capa crear objetos DefaultRasterRetriever para gestionar las peticiones de datos para la creación de tiles.
352 384

  
353
En principio solo que habrá que sobrescribir los constructores de la clase BasicTiledImageLayer para que cuando se instancie una capa RasterTiledImageLayer se instance también un DefaultretrieverFactory a partir de los parámetros.
385
En principio solo que habrá que sobrescribir los constructores de la clase BasicTiledImageLayer para que cuando se instancie una capa RasterTiledImageLayer se instancie también un DefaultretrieverFactory a partir de los parámetros.
354 386

  
355 387
DefaultRetrieverFactory implements RetrieverFactory
356 388
***************************************************

Also available in: Unified diff