/2.1/trunk/doc/Fase 1/dt-visor-3d.rst - Diff - gvSIG 3D - gvSIG

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

     A partir de una vista 2D, se desea representar la información cargada de forma tridimensional. Para ello, el usuario dispondrá de dos entradas de menú / botones para crear los dos tipos de visores: esférico y plano definidos en TYPE.SPHERE y TYPE.FLAT. Las dos entradas de menú ejecutarán una misma extensión, View3DExtension, la cual dependiendo del *action command* realizará una acción u otra. Pero antes de explicar la creación de visor el usuario debe definir parámetros o propiedades para la carga y gestión de las capas dentro del visor 3D.
     Las capas tienen propiedades comunes, definidas en LayerProperties3D, y especificas que varían en función del tipo de capa, definidas en las subclases RasterLayerProperties3D y VectorialLayerProperties3D. La propiedades comunes son las siguientes:
     Las capas tienen propiedades comunes, definidas en `LayerProperties3D`_, y especificas que varían en función del tipo de capa, definidas en las subclases ``RasterLayerProperties3D`` y ``VectorialLayerProperties3D``. La propiedades comunes son las siguientes:
     * Nivel máximo de detalle: nivel máximo de detalle en la visualización de la capa. Cuanto más alto sea el número máximo de nivel de detalle más tiles se generarán y más espacio ocuparán en el disco.
     * Nivel mínimo de detalle: nivel mínimo de detalle en la visualización de la capa. Cuanto más pequeño sea el número mínimo de nivel de detalle menos tiles se generarán y menos espacio ocuparán en el disco.
-...
     * Modo de carga elevación: permite indicar si el raster es de tipo elevación o no.
     Una vez definidas las propiedades 3D de la capas, se procede a la creación de un visor 3D. La extensión obtendrá la instancia única mediante el Locator y ejecutará el método ViewPanel3DManager#createViewPanel3D(MapContext, TYPE) pasándole como parámetro el mapContext de la vista activa y el tipo de visor dependiendo del *action command*. En la creación del visor, se accederá a la capas del MapContext para cargarlas obteniendo las propiedades asociadas a las capas mediante ViewPanel3D#getLayerProperties3D(FLayer) para determinar que tipo de LayerConverter instanciar.
     Una vez definidas las propiedades 3D de la capas, se procede a la creación de un visor 3D. La extensión obtendrá la instancia única mediante el Locator y ejecutará el método ``ViewPanel3DManager#createViewPanel3D(MapContext, TYPE)`` pasándole como parámetro el mapContext de la vista activa y el tipo de visor dependiendo del *action command*. En la creación del visor, se accederá a la capas del MapContext para cargarlas obteniendo las propiedades asociadas a las capas mediante ``ViewPanel3D#getLayerProperties3D(FLayer)`` para determinar que tipo de LayerConverter instanciar.
     Instanciado el conversor para la obtención de una capa WW se ejecutará el método LayerConverter#convert(FLayer) el cual realizará todo lo necesario para obtener la capa WW correspondiente. Una vez obtenida la capa se debe de añadir al componente WW y mostrar la ventan mediante ViewPanel3D#show().
     Instanciado el conversor para la obtención de una capa WW se ejecutará el método ``LayerConverter#convert(FLayer)`` el cual realizará todo lo necesario para obtener la capa WW correspondiente. Una vez obtenida la capa se debe de añadir al componente WW y mostrar la ventana mediante ``ViewPanel3D#show()``.
     Por otra parte cuando se activa un visor, se activan dos entradas de menú adicionales: Refrescar visor y Sincronizar enfoques. La entrada de menú Refrescar visor esta asociada a la extensión RefreshView3DExtension la cual obtendrá el MapControl3D del visor activo y ejecutará el método MapControl3D#reloadLayers(). La entrada de menú Sincronizar enfoques esta asociada a la extensión SynchronizeView3DExtension la cual obtendrá el enfoque de la vista 2D a la que esta enlazada para mover el enfoque del visor hasta que los dos enfoques estén sincronizados.
     Por otra parte cuando se activa un visor, se activan dos entradas de menú adicionales: Refrescar visor y Sincronizar enfoques. La entrada de menú Refrescar visor esta asociada a la extensión RefreshView3DExtension la cual obtendrá el `MapControl3D`_ del visor activo y ejecutará el método ``MapControl3D#reloadLayers()``. La entrada de menú Sincronizar enfoques esta asociada a la extensión SynchronizeView3DExtension la cual obtendrá el enfoque de la vista 2D a la que esta enlazada para mover el enfoque del visor hasta que los dos enfoques estén sincronizados.
     Integración con la librería NASA WW SDK
     ----------------------------------------
     World Wind es una colección de componentes que de forma interactiva muestran información geográfica en 3D. Las aplicaciones o applets que usen la librería deberá integrar uno o más componentes dentro de su interfaz gráfica. World wind sigue el siguiente esquema:
     .. image:: ../images/world-wind-diagram.png
     * Globe: representa la forma del planeta y el terreno. Contiene un Tessellator el cual es el encargado de generar el terreno.
     * Layer: las capas añaden las imágenes, objetos u otra información al globo. La capas se ajustan a la forma del globo y se mueven junto a el cuando el usuario navega por el espacio tridimensional.
     * Model: junta el globo y las capas.
     * View: determina la vista del usuario sobre el modelo. La vista se va modificando en base a los eventos de ususario que recibe.
     * SceneController: asocia la vista con el modelo. Controla el tiempo y el renderizado del modelo.
     Se pretende crear una nivel de abstracción que ofrezca a los consumidores de la librería la funcionalidades descritas en el análisis funcional de forma que no tengan que interactuar con la librería WW. La integración del plugin con la librería World Wind se ha diseñado del siguiente modo:
     * El componente `ViewPanel3D`_ integra un componente ``WorldWindowGLJPanel``. ``WorldWindowGLJPanel`` es autocontenido y su propósito es servir la aplicación WorldWind mostrando el modelo definido (globo y capas).
     * La librería posee unos archivos de configuración en XML que son cargados cuando la librería se registra. Estos archivos de configuración por un lado definen la clases que implementan los distintos servicios que ofrece la librería y por otro las capas que se cargan por defecto al crear un modelo básico.
     * Además de esta configuración, es necesario configurar unos parámetros espeficios para crear un ``WorldWindowGLJPanel`` esférico o plano. Esta configuración se realiza al instanciar un objeto `ViewPanel3D`_. Dependiendo del modo indicado como parámetro, se establece una configuración u otra.
     * La obtención de las capas WW a partir de capas de gvSIG se realiza mediante la clase `LayerConverter`_ la cual permite obtener la capa equivalente en WW a partir de una capa de gvSIG para añadirla a las capas del modelo WW. Se ha implementa un nuevo tipo de capa llamado RasterTiledImageLayer la cual gestiona la peticiones de tiles en tiempo para que se obtengan los datos directamente desde el DAL de gvSIG. Esta gestión se realiza mediante los objetos ``DefaultRetrieverFactory``, ``DefaultRasterRetriever``, ``DefaultRasterServer``, ``DefaultDataRasterReaderFactory``, ``DefaultDataRasterReader`` y ``DefaultDataRaster``.
     SWING API
     ----------
-...
     * Package: or.gvsig.view3d.swing.api
     View3DManager
     ********************
     ~~~~~~~~~~~~~~~~~~~~~~
     Punto de entrada a la librería view3D. Proporciona métodos para la creación de visores, paneles de propiedades y obtención de las propiedades 3D de una capa.
     * createViewPanel3D(MapContext theMapContext, TYPE type) : ViewPanel3D
     Crea un objeto ViewPanel3D pasándole como parámetro el MapContext y el tipo de panel.
       Crea un objeto `ViewPanel3D`_ pasándole como parámetro el MapContext y el tipo de panel.
     * getLayerProperties3D(FLayer layer) : LayerProperties3D
     Obtiene las propiedades asociadas a un capa.
       Obtiene las propiedades asociadas a un capa.
     * setLayerProperties3D(FLayer layer, LayerProperties3D properties) : void
     Asigna las propiedades a la capa que recibe como parámetro.
       Asigna las propiedades a la capa que recibe como parámetro.
     .. note::
       Falta especificar las propiedades relacionadas con la vista, las propiedades generales y sus interfaces.
     MapControl3D
     ****************************
     ~~~~~~~~~~~~~~~~~~~~~~
     Define el API del componente 3D.
     * getMapContext() : MapContext
     Obtiene el MapContext asociado al visor. Del MapContext asociado se extrae la información necesaria para la representación de los datos en 3D y la sincronización de enfoques.
       Obtiene el MapContext asociado al visor. Del MapContext asociado se extrae la información necesaria para la representación de los datos en 3D y la sincronización de enfoques.
     * getType() : TYPE
     Obtiene el tipo del visor. Devuelve un objeto enum que puede ser TPYE.SPHERE o TYPE.FLAT (ver `TYPE`_).
       Obtiene el tipo del visor. Devuelve un objeto enum que puede ser TPYE.SPHERE o TYPE.FLAT (ver `TYPE`_).
     * getVerticalExaggeration() : double
     Obtiene la exageración vertical del visor.
       Obtiene la exageración vertical del visor.
     * reloadLayers() : void
     Elimina las capas cargadas. Accede al MapContext asociado al visor y carga de nuevo las capas. Se usa para actualizar el visor con los posibles cambios realizados sobre la vista 2D.
       Elimina las capas cargadas. Accede al MapContext asociado al visor y carga de nuevo las capas. Se usa para actualizar el visor con los posibles cambios realizados sobre la vista 2D.
     * setMapContext(MapContext theMapContext) : void
     Establece el MapContext al visor y recarga la información mediante reloadLayers().
       Establece el MapContext al visor y recarga la información mediante reloadLayers().
     * setVerticalExaggeration(double verticalExaggeration) : void
     Establece las exageración vertical del visor.
       Establece las exageración vertical del visor.
     * setAtmosphereVisibility(boolean visibility) : void
     Asigna la visibilidad al componente que representa la atmósfera.
       Asigna la visibilidad al componente que representa la atmósfera.
     * setNortIndicatorVisibility(boolean visibility) : void
     Asigna la visibilidad al componente que indica el norte y la inclinación del plano.
       Asigna la visibilidad al componente que indica el norte y la inclinación del plano.
     * setMiniMapVisibility(boolean visibility) : void
     Asigna la visibilidad al componente minimapa.
       Asigna la visibilidad al componente minimapa.
     * setScaleVisibility(boolean visibility) : void
     Asigna la visibilidad al componente que representa la escala.
       Asigna la visibilidad al componente que representa la escala.
     * setStarBackgroundVisibility(boolean visibility) : void
     Asigna la visibilidad al componente que representa el fondo de estrellas.
       Asigna la visibilidad al componente que representa el fondo de estrellas.
     * synchronizeViewPorts() : void
     Obtiene el ViewPort de la vista y realiza las transformaciones necesarias para el enfoque del visor 3D muestra la misma región. Hay que tener en cuenta si la opción "Animación en la sincronización de enfoques" esta marcada o no. En caso de que este marcada la sincronización se debe animar, en caso contrario, no.
       Obtiene el ``ViewPort`` de la vista y realiza las transformaciones necesarias para el enfoque del visor 3D muestra la misma región. Hay que tener en cuenta si la opción "Animación en la sincronización de enfoques" esta marcada o no. En caso de que este marcada la sincronización se debe animar, en caso contrario, no.
     * getAtmosphereVisibility() : boolean
     Obtiene la visibilidad del componente que representa la atmósfera.
       Obtiene la visibilidad del componente que representa la atmósfera.
     * getMiniMapVisibility() : boolean
     Obtiene la visibilidad del componente que representa el minimapa.
       Obtiene la visibilidad del componente que representa el minimapa.
     * getStarBackgroundVisibility() : boolean
     Obtiene la visibilidad del componente que representa el fondo de estrellas.
       Obtiene la visibilidad del componente que representa el fondo de estrellas.
     * getNorthIndicatorVisibility() : boolean
     Obtiene la visibilidad del componente que representa el indicar del norte y el grado de inclinación.
       Obtiene la visibilidad del componente que representa el indicar del norte y el grado de inclinación.
     * getScaleVisibility() : boolean
     Obtiene la visibilidad del componente que representa la escala.
       Obtiene la visibilidad del componente que representa la escala.
     ViewPanel3D
     *************
     ~~~~~~~~~~~~~~~~~~~~~~
     Representa la ventana que contiene el componente MapControl3D.
     Representa la ventana que contiene el componente `MapControl3D`_.
     * show() : void
     Invoca al WindowManager para mostrar el visor en modo ventana.
       Invoca al WindowManager para mostrar el visor en modo ventana.
     * getMapControl3D() : MapControl3D
     Devuelve el componente asociado a la ventana.
       Devuelve el componente asociado a la ventana.
     TYPE
     *************
     ~~~~~~~~~~~~~~~~~~~~~~
     Enumerado que representa los dos tipos posibles de un visor 3D. Los dos tipos son: SPHERE y FLAT.
     LayerProperties3D
     *******************
     ~~~~~~~~~~~~~~~~~~~~~~
     Clase que representa la propiedades 3D de una capa.
     * setMaxLevel(int maxLevel) : void
     Asigna el máximo nivel de detalle de la capa.
       Asigna el máximo nivel de detalle de la capa.
     * getMaxLevel() : int
     Obtiene el máximo nivel de detalle de la capa.
       Obtiene el máximo nivel de detalle de la capa.
     * setMinLevel(int minLevel) : void
     Asigna el mínimo nivel de detalle de la capa.
       Asigna el mínimo nivel de detalle de la capa.
     * getMinLevel() : int
     Obtiene el mínimo nivel de detalle de la capa.
       Obtiene el mínimo nivel de detalle de la capa.
     * setFileStore(String path) : void
     Asigna el directorio padre donde se ubicarán las diferentes capas cacheadas
       Asigna el directorio padre donde se ubicarán las diferentes capas cacheadas
     * getFileStore() : String
     Obtiene el directorio padre donde se ubican las diferentes capas cacheadas.
       Obtiene el directorio padre donde se ubican las diferentes capas cacheadas.
     * getCacheName() : String
     Obtiene el nombre único de la caché el cual da nombre a la carpeta dentro del file store que contiene los tiles cacheados y los archivos de configuración.
       Obtiene el nombre único de la caché el cual da nombre a la carpeta dentro del file store que contiene los tiles cacheados y los archivos de configuración.
     RasterLayerProperties3D extends LayerProperties3D
     ****************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Clase que representa la propiedades 3D de una capa raster.
     * setElevation(boolean elevation) : void
     Asigna a la capa si el modo de carga de la capa es de elevación o no.
       Asigna a la capa si el modo de carga de la capa es de elevación o no.
     * getElevation() : boolean
     Obtiene si el modo de carga de la capa raster es de elevación o no.
       Obtiene si el modo de carga de la capa raster es de elevación o no.
     VectorialLayerProperties3D extends LayerProperties3D
     ****************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Clase que representa la propiedades 3D de una capa vectorial.
     * setRasterized(boolean rasterized) : void
     Asigna a la capa si el modo de carga de la capa es rasterizado o no.
       Asigna a la capa si el modo de carga de la capa es rasterizado o no.
     * getRasterized() : boolean
     Obtiene si el modo de carga de la capa vectorial es rasterizado o no.
       Obtiene si el modo de carga de la capa vectorial es rasterizado o no.
     SWING IMPL
     --------------
-...
     * Package: or.gvsig.view3d.swing.impl
     DefaultView3DManager implements View3DManager
     ********************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Implementación por defecto del manager View3DManager
     DefaultViewPanel3D implements ViewPanel3D
     ***************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Implementación por defecto de los métodos descritos en la interfaz ViewPanel3D. Esta clase tendrá asociado un MapContext que permitirá obtener información acerca del enfoque, escucha eventos de cambio sobre capas y enfoque, versionado...
     * public DefaultViewPanel3D(MapContext mapContext, TYPE type);
     Constructor que permite instancia un nuevo visor 3D a partir de un MapContext y el tipo. Este constructor accederá a las capas del mapContext para añadirlas al componente de la librería WW. Para añadir una capa al componente WW es necesaria una transformación (LayerConverter#convert(layer)) de la capa gvSIG a una capa WW en base al modo de carga asociado especificado por el usuario.
       Constructor que permite instancia un nuevo visor 3D a partir de un MapContext y el tipo. Este constructor accederá a las capas del mapContext para añadirlas al componente de la librería WW. Para añadir una capa al componente WW es necesaria una transformación (``LayerConverter#convert(layer)``) de la capa gvSIG a una capa WW en base al modo de carga asociado especificado por el usuario.
     LayerConverter
     ****************
     ~~~~~~~~~~~~~~~~~~~~~~
     Interfaz que permite convertir una capa gvSIG en una capa WW. Este proceso depende del tipo de capa y el modo de carga definido.
     * convert(FLayer layer) : gov.nasa.worldwind.layers.Layer
     Método que a partir de una capa gvSIG obtiene la capa correspondiente en WW.
       Método que a partir de una capa gvSIG obtiene la capa correspondiente en WW.
     DefaultRasterLayerConverter implements LayerConverter
     **********************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Implementación de la interfaz LayerConverter que permite convertir una capa FLyrRaster en RasterTiledImageLayer mediante LayerConverter#convert(FLayer layer). El proceso de conversión debe seguir los siguientes puntos:
     Implementación de la interfaz LayerConverter que permite convertir una capa FLyrRaster en RasterTiledImageLayer mediante ``LayerConverter#convert(FLayer layer)``. El proceso de conversión debe seguir los siguientes puntos:
     * Configuración de los parámetros necesarios en un fichero XML para crear una capa del tipo RasterTileImageLayer. Los parámetros necesarios son:
       * 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.
       * SECTOR: Zona geográfica del raster especificada en grados sobre la proyección EPSG:4326.
       * WIDTH: ancho en píxeles de la imagen raster.
       * HEIGHT: alto en píxeles de la imagen raster.
       * DISPLAY_NAME: Nombre de la capa.
       * FILE_STORE: almacén de archivos de la cache. Proporciona métodos para añadir / quitar localizaciones, buscar archivos, borra archivos...
       * IMAGE_FORMAT: formato de los tiles que se generan.
       * FORMAT_SUFFIX: sufijo de archivo de los tiles generados.
      * 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.
      * SECTOR: Zona geográfica del raster especificada en grados sobre la proyección EPSG:4326.
      * WIDTH: ancho en píxeles de la imagen raster.
      * HEIGHT: alto en píxeles de la imagen raster.
      * DISPLAY_NAME: Nombre de la capa.
      * FILE_STORE: almacén de archivos de la cache. Proporciona métodos para añadir / quitar localizaciones, buscar archivos, borra archivos...
      * IMAGE_FORMAT: formato de los tiles que se generan.
      * FORMAT_SUFFIX: sufijo de archivo de los tiles generados.
       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.
       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:
     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. 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:
       * Opciones de capas: opacidad, máxima y mínima altura de activación...
       * Estructura de niveles de detalle: nivel máximo y mínimo de nivel de detalle, niveles inactivos...
       * Generación de tiles: tamaño del tile, origen del primer tile, extensión de los tiles generados...
      * Opciones de capas: opacidad, máxima y mínima altura de activación...
      * Estructura de niveles de detalle: nivel máximo y mínimo de nivel de detalle, niveles inactivos...
      * Generación de tiles: tamaño del tile, origen del primer tile, extensión de los tiles generados...
     * 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.
     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.
     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.
     DefaultElevationLayerConverter implements LayerConverter
     ***********************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     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:
     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:
     * Configuración de los parámetros necesarios en un fichero XML para crear una modelo de elevación ElevationModel. Los parámetros necesarios son:
-...
       * PIXEL_FORMAT: formato del pixel: AVKey.ELEVATION o AVKey.IMAGE
       * FORMAT_SUFFIX: sufijo de archivo de los tiles generados.
       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.
         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. 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:
       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:
       * BYTE_ORDER: orden de los bytes. Little endian o big endian.
       * ELEVATION_MAX: elevación máxima y mínima.
       * ELEVATION_MIN: elevación mínima del raster.
-...
     * 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.
     DefaultWMSLayerConverter implements LayerConverter
     **********************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     .. note::
       TODO en fases posteriores
     DefaultVectorialLayerConverter implements LayerConverter
     *********************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     .. note::
       TODO en fases posteriores
     RasterTiledImageLayer extends BasicTiledImageLayer
     *****************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Implementación de una capa WW. Entre otras funcionalidades, esta capa gestiona las peticiones de texturas e imágenes que recibe por parte de la aplicación así como la composición de tiles para un sector en concreto, las diferentes resoluciones por nivel de detalle y la creación de tareas para la recuperación / generación de tiles.
-...
     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.
     DefaultRetrieverFactory implements RetrieverFactory
     ***************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Implementación por defecto de un RetrieverFactory. Representa la factoría para la creación de instancias de objetos Retriever.
     * createRetriever(AVList params, RetrievalPostProcessor postProcessor) : Retriever
     Instancia una implementación de la interfaz Retriever a partir de una lista de parámetros y un RetrievalPostProcessor que recibe como parámetro y una instancia local de RasterServer.
       Instancia una implementación de la interfaz Retriever a partir de una lista de parámetros y un RetrievalPostProcessor que recibe como parámetro y una instancia local de RasterServer.
     DefaultRasterRetriever implements Retriever
     ***************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Implementación por defecto de Retriever. Esta clase gestiona las peticiones de imágenes que recibe por parte de la capa. Permite configurar tiempos de respuesta como timeouts, tiempo de expiración... además permite saber el estado en que se encuentra el retriever.
     DefaultRasterServer implements RasterServer
     ***************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Implementación por defecto de la interfaz RasterServer. Como su nombre indica esta clase representa un servidor de raster que atiende a las peticiones realizadas por objetos Retriever. Cuando recibe una petición mediante el método RasterServer#getRasterAsByteBuffer() accede al DataRaster que tiene asociado obtiene la información que precisa y la devuelve en un objeto de tipo java.nio.ByteBuffer.
     Implementación por defecto de la interfaz RasterServer. Como su nombre indica esta clase representa un servidor de raster que atiende a las peticiones realizadas por objetos Retriever. Cuando recibe una petición mediante el método ``RasterServer#getRasterAsByteBuffer()`` accede al DataRaster que tiene asociado obtiene la información que precisa y la devuelve en un objeto de tipo java.nio.ByteBuffer.
     * getRasterAsByteBuffer(AVList params) : ByteBuffer
     Obtiene del DataRaster asociado la información definida en los parámetros que recibe y la devuelve en un objeto java.nio.ByteBuffer.
       Obtiene del DataRaster asociado la información definida en los parámetros que recibe y la devuelve en un objeto java.nio.ByteBuffer.
     * getSector() : Sector
     Obtiene el sector del data raster asociado.
       Obtiene el sector del data raster asociado.
     DefaulDataRasterReaderFactory extends BasicDataRasterReaderFactory
     *********************************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Factoría que permite la creación de nuestra implementación DefaultDataReaderRasterReader a partir de un objeto de tipo DataStore.
     * findReaderFor(Object source, AVList params) : DataRasterReader
     Obtiene la instancia de DataRasterReader apropiada para la lectura de la fuente de datos.
       Obtiene la instancia de DataRasterReader apropiada para la lectura de la fuente de datos.
     DefaultDataRasterReader extends AbstractDataRasterReader
     ********************************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Permite saber si se puede leer y obtener objetos DataRaster a partir de DataStore validando lo parámetros y metadatos del almacén.
     * canRead(Object source, AVList params) : boolean
     Obtiene si este DataRasterReader es capaz de leer la fuente de datos y crear objetos DataRaster.
       Obtiene si este DataRasterReader es capaz de leer la fuente de datos y crear objetos DataRaster.
     * read(Object source, AVList params) throws java.io.IOException : DataRaster[]
     Lee de la fuente de datos y crea objetos DataRaster
       Lee de la fuente de datos y crea objetos DataRaster
     * readMetadata(Object source, AVList params) throws java.io.IOException : AVList
     Obtiene los metadatos asociados a las fuente de datos. Los metadatos varían en función de la fuente y el DataRasterReader.
       Obtiene los metadatos asociados a las fuente de datos. Los metadatos varían en función de la fuente y el DataRasterReader.
     * isImageryRaster(Object source, AVList params) : boolean
     Obtiene si la fuente de datos es de tipo raster imagen.
       Obtiene si la fuente de datos es de tipo raster imagen.
     * isElevationsRaster(Object source, AVList params) : boolean
     Obtiene si la fuente de datos es de tipo imagen
       Obtiene si la fuente de datos es de tipo imagen
     XXLayerDataRaster implements DataRaster
     ********************************************
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     Representa información raster. Esta clase recibe peticiones de datos para la generación de tiles por lo que es la encargada de acceder al DAL de gvSIG mediante su API para obtener la información precisada.
     * getWidth() : int
     Obtiene el ancho en pixeles del raster.
       Obtiene el ancho en pixeles del raster.
     * getHeiht() : int
     Obtiene el alto en pixeles del raster.
       Obtiene el alto en pixeles del raster.
     * drawOnTo(DataRaster canvas) : void
     Copia la información de este raster al espceficado por parámetro. Es usado para hacer peticiones de datos sobre zonas determindas por el tamaño y posición del DataRaster especificado.
       Copia la información de este raster al espceficado por parámetro. Es usado para hacer peticiones de datos sobre zonas determindas por el tamaño y posición del DataRaster especificado.
     * getSubRaster(AVList params) : DataRaster
     A partir de los paŕametros que recibe obtiene una sección del raster.
       A partir de los parámetros que recibe obtiene una sección del raster.
     * getSubRaster(int with, int height, Sector sector, AVList params) : DataRaster
     A partir de los paŕametros que recibe obtiene una sección del raster.
       A partir de los parámetros que recibe obtiene una sección del raster.
     View3D APP
     ----------------
-...
       * package.info
     Plugin common
     *************
     ~~~~~~~~~~~~~~~~~~~~~~
     El plugin common (org.gvsig.view3d.app.common) estará compuesto por tres extensiones: View3DExtension, RefreshView3DExtension y SynchronizeView3DExtension. Además, gestionará la persistencia de las opciones establecidas por el usuario.
     * View3DExtension: extensión de Andami asociada a dos acciones: "create-flat-view3d" y "create-spherical-view3d". Esta extensión deberá estar siempre visible y activa solo cuando se active una vista 2D con un capa o más. Las dos acciones obtendrán la instancia del View3DSwingManager, crearán el panel, añadirán las capas de la vista activa, y lo mostrarán.
     * RefreshView3DExtension: extensión de Andami asociada a la acción: "refresh-view3d". Esta extensión deberá estar visible cuando se active un visor 3D y siempre activa. La extensión obtendrá la instancia de tipo ViewPanel3D y ejecutará la operación ViewPanel3D#reloadLayers().
     * SynchronizeView3DExtension: extensión de Andami asociada a la acción: "synchronize-view3d". Esta extensión deberá estar visible cuando se active una vista3D y siempre activa. La extensión obtendrá la instancia de tipo ViewPanel3D y ejecutará la operación ViewPanel3D#synchronizeViewPorts().
     * RefreshView3DExtension: extensión de Andami asociada a la acción: "refresh-view3d". Esta extensión deberá estar visible cuando se active un visor 3D y siempre activa. La extensión obtendrá la instancia de tipo ViewPanel3D y ejecutará la operación ``ViewPanel3D#reloadLayers()``.
     * SynchronizeView3DExtension: extensión de Andami asociada a la acción: "synchronize-view3d". Esta extensión deberá estar visible cuando se active una vista3D y siempre activa. La extensión obtendrá la instancia de tipo ViewPanel3D y ejecutará la operación ``ViewPanel3D#synchronizeViewPorts()``.
     Persistencia
     *************
     ~~~~~~~~~~~~~~~~~~~~~~
     .. note::
       TODO en fases posteriores. Definir panales y gestión de preferencias.
     Integración con la librería NASA WW SDK
     ----------------------------------------
     World Wind es una colección de componentes que de forma interactiva muestran información geográfica en 3D. Las aplicaciones o applets que usen la librería deberá integrar uno o más componentes dentro de su interfaz gráfica. World wind sigue el siguiente esquema:
     .. image:: ../images/world-wind-diagram.png
     * Globe: representa la forma del planeta y el terreno. Contiene un Tessellator el cual es el encargado de generar el terreno.
     * Layer: las capas añaden las imágenes, objetos u otra información al globo. La capas se ajustan a la forma del globo y se mueven junto a el cuando el usuario navega por el espacio tridimensional.
     * Model: junta el globo y las capas.
     * View: determina la vista del usuario sobre el modelo. La vista se va modificando en base a los eventos de ususario que recibe.
     * SceneController: asocia la vista con el modelo. Controla el tiempo y el renderizado del modelo.
     Se pretende crear una nivel de abstracción que ofrezca a los consumidores de la librería la funcionalidades descritas en el análisis funcional de forma que no tengan que interactuar con la librería WW. La integración del plugin con la librería World Wind se ha diseñado del siguiente modo:
     * El componente ViewPanel3D integra un componente WorldWindowGLJPanel. WorldWindowGLJPanel es autocontenido y su propósito es servir la aplicación WorldWind mostrando el modelo definido (globo y capas).
     * La librería posee unos archivos de configuración en XML que son cargados cuando la librería se registra. Estos archivos de configuración por un lado definen la clases que implementan los distintos servicios que ofrece la librería y por otro las capas que se cargan por defecto al crear un modelo básico.
     * Además de esta configuración, es necesario configurar unos parámetros espeficios para crear un WorldWindowGLJPanel esférico o plano. Esta configuración se realiza al instanciar un objeto ViewPanel3D. Dependiendo del modo indicado como parámetro, se establece una configuración u otra.
     * La obtención de las capas WW a partir de capas de gvSIG se realiza mediante la clase LayerConverter la cual permite obtener la capa equivalente en WW a partir de una capa de gvSIG para añadirla a las capas del modelo WW. Se ha implementa un nuevo tipo de capa llamado RasterTiledImageLayer la cual gestiona la peticiones de tiles en tiempo para que se obtengan los datos directamente desde el DAL de gvSIG. Esta gestión se realiza mediante los objetos DefaultRetrieverFactory, DefaultRasterRetriever, DefaultRasterServer, DefaultDataRasterReaderFactory, DefaultDataRasterReader y DefaultDataRaster.

Also available in: Unified diff

Application: gvSIG desktop » gvSIG 3D

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