| gvSIG desktop 1

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

 *

 * Copyright (C) 2006 IVER T.I. and Generalitat Valenciana.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

 */

package org.gvsig.raster;

import java.io.File;

import java.util.ArrayList;

import org.gvsig.raster.dataset.io.EcwDriver;

import org.gvsig.raster.dataset.io.ErmapperWriter;

import org.gvsig.raster.dataset.io.GdalDriver;

import org.gvsig.raster.dataset.io.GdalWriter;

import org.gvsig.raster.dataset.io.MemoryRasterDriver;

import org.gvsig.raster.dataset.io.MrSidDriver;

import org.gvsig.raster.grid.filter.bands.ColorTableListManager;

import org.gvsig.raster.grid.filter.convolution.ConvolutionListManager;

import org.gvsig.raster.grid.filter.correction.MedianListManager;

import org.gvsig.raster.grid.filter.enhancement.BrightnessContrastListManager;

import org.gvsig.raster.grid.filter.enhancement.EnhancementListManager;

import org.gvsig.raster.grid.filter.segmentation.FirstDerivativeListManager;

import org.gvsig.raster.util.extensionPoints.ExtensionPoint;

import org.gvsig.raster.util.extensionPoints.ExtensionPoints;

import org.gvsig.raster.util.extensionPoints.ExtensionPointsSingleton;

/**

 * Clase principal de la libreria. En ella se definen variables globales con informaci?n

 * de uso general, as? como acciones a realizar al arracar la librer?a. El m?todo que

 * contiene las acciones de arranque es wakeUp. Las tareas principales de este m?todo

 * son de registro de drivers de lectura y escritura y eliminaci?n del directorio de 

 * temporales.

 * 

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public class RasterLibrary {

        public static ArrayList writersClassList = new ArrayList();

        /**

         * En la generaci?n autom?tica de clases esta variable representa el n?mero de

         * clases en las que se hace la divisi?n.

         */

        public static int defaultNumberOfClasses = 64;

        /**

         * Tama?o de bloque en los procesos que recorren un raster completo a base de ventanas con recorrido 

         * descendente. Esta variable indica la altura de dicho bloque. Por lo tanto cada bloque ser? de 

         * raster.width X blockHeight. Tipicamente recorridos de este tipo se usan para el calculo de estad?sticas, 

         * histogramas, salvado a raster, etc... Es importante para el buen funcionamiento que este bloque sea 

         * potencia de dos.

         */

        public static int blockHeight = 512;

        //*************CACHE*******************

        /**

         * Tama?o aproximado de cach? en Megas. Si este valor es alto cabr?n muchas p?ginas en memoria 

         * a la vez y si es bajo cabr?n pocas. Hay que tener en cuenta que al instanciar se convertira en bytes

         * para su mejor tratamiento. Al llamar al constructor esta variable contendr? el tama?o exacto

         * de la cache en bytes. El tama?o aqu? especificado es aproximado. Este variar? dependiendo de los

         * par?metros del raster a cachear ya que las p?ginas deben tener una altura potencia de 2.

         */

        public static long cacheSize = 25;

        /**

         * Tama?o m?ximo de la p?gina en Megas. Hay que tener en cuenta que al instanciar se convertira en bytes

         * para su mejor tratamiento. Al llamar al constructor esta variable contendr? el tama?o exacto

         * de la p?gina en bytes

         */

        public static double pageSize = 4;

        /**

         * N?mero de p?ginas que tiene cada conjunto de cach?

         */

        public static int pagsPerGroup = 5;

        //*************PATHS*******************

        /**

         * Directorio temporal para la cach?. Si gastamos el mismo que andami este se ocupar? de gestionar su

         * destrucci?n al cerrar gvSIG.

         */

        public static String tempCacheDirectoryPath = System.getProperty("java.io.tmpdir") + "/tmp-andami";

        /**

         * Ruta o rutas donde busca jars con clases que incorporen elementos nuevos que extiendan

         * otros ya existentes. Estos pueden ser drivers o filtros.

         */

        public static String[] pathExtensions = {"./"};

        /**

         * Ejecuta las acciones necesarias para arrancar la librer?a.

         */

        public static void wakeUp() {

                //Punto de extensi?n para registro de drivers de lectura

                ExtensionPoints extensionPoints = ExtensionPointsSingleton.getInstance();

                if (!extensionPoints.containsKey("RasterReader"))

                        extensionPoints.put( new ExtensionPoint( "RasterReader", "Raster Reader Classes"));

                //Punto de extensi?n para registro de drivers de escritura

                if (!extensionPoints.containsKey("RasterWriter"))

                        extensionPoints.put(new ExtensionPoint("RasterWriter", "Raster Writer Classes"));

                //Ejecuta el c?digo static de la clase cada driver

                GdalDriver.register();

                EcwDriver.register();

                MrSidDriver.register();

                MemoryRasterDriver.register();

                GdalWriter.register();

                ErmapperWriter.register();

                //Punto de extensi?n para registro de filtros

                if (!extensionPoints.containsKey("RasterFilter")) {

                        extensionPoints.put(new ExtensionPoint("RasterFilter", "Raster Filter Classes"));

                }

                // Invoca las llamadas estaticas de cada clase para registrarlas en los

                // puntos de extensi?n

                BrightnessContrastListManager.register();

                EnhancementListManager.register();

                FirstDerivativeListManager.register();

                MedianListManager.register();

                ConvolutionListManager.register();

                // Registrar los nuevos filtros del directorio

                registerExtensions();

                //Limpiamos el directorio temporal

                RasterLibrary.cleanUpTempFiles();

        }

        /**

         * Elimina los ficheros del directorio temporal. Realizamos esta acci?n al

         * levantar la librer?a.

         */

        public static void cleanUpTempFiles() {

                try {

                        File tempDirectory = new File(tempCacheDirectoryPath);

                        File[] files = tempDirectory.listFiles();

                        if (files != null) {

                                for (int i = 0; i < files.length; i++) {

                                        // s?lo por si en un futuro se necesitan crear directorios temporales

                                        if (files[i].isDirectory())

                                                deleteDirectory(files[i]);

                                        files[i].delete();

                                }

                        }

                        tempDirectory.delete();

                } catch (Exception e) {

                }

        }

        /**

         * Recursive directory delete.

         * @param f

         */

        private static void deleteDirectory(File f) {

                File[] files = f.listFiles();

                for (int i = 0; i < files.length; i++) {

                        if (files[i].isDirectory())

                                deleteDirectory(files[i]);

                        files[i].delete();

                }

        }

        /**

         * Esta funci?n buscar? todos los jars en las rutas de pathExtensions y

         * registrar? todos las clases registrables. En este momento hay posibilidad

         * de registro de drivers y filtros.

         */

        private static void registerExtensions() {

                for (int iPath = 0; iPath < pathExtensions.length; iPath++) {

                        File files = new File(pathExtensions[iPath]);

                        if (files.isDirectory()) {

                                // TODO:FUNCIONALIDAD: Descubrimiento de drivers y filtros registrables.

                        }

                }

        }

}