Fundamentos de análisis geográfico con SEXTANTE - La Salle

338 CAPÍTULO 20. PROGRAMACIÓN DE MÓDULOS DE SEXTANTE
Process_Set_Text("Calculando capa de pendientes..."};
EL progreso de la operación se puede mostrar mediante el método Set Progress(double,
double). El primer parámetro es el valor actual del índice de progreso, mientras que el último
es el valor final. Si el primero es igual a cero, la barra de progreso aparece completamente gris,
mientras que en caso de ser igual al segundo la barra se muestra completamente azul.
Aquí puedes ver un ejemplo.
Set_Progress(50,100);
Esto indicaría que la operación actual se ha realizado hasta la mitad.
En ocasiones, sin embargo, no sabes exactamente cuánto llevará terminar una operación
(es decir, que no tienes un valor final que pasar al anterior método), pero incluso en estos casos
es interesante hacerle ver al usuario que el programa esta trabajando. Para ello puedes utilizar
el método Progress Blink(), el cual crea una barra de progreso oscilante. Añade una llamada a
este método cada vez que se complete un ciclo en el proceso. Al llamarla la barra se desplaza
ligeramente, de tal modo que si la llamas demasiado frecuentemente se moverá muy rápido,
mientras que si sitúas la llamada en otras partes del código quizás vaya demasiado lenta y no
dé sensación alguna de que el programa trabaja. Prueba diferentes concepciones de la idea de
ciclo (diferentes lugares dentro de tu código), y escoge aquella que te gustaría desde el punto
de vista del usuario, no del programador.
20.9. Soporte multilingüe y ayuda contextual
Como ya sabes, SEXTANTE se basa en el software SAGA, y éste a su vez recibe aportaciones
directas desde el proyecto SEXTANTE, que a fecha de hoy incluyen cerca de 80 módulos
y características del núcleo y la API tan importantes como el motor de documentación encargado
de generar ficheros en formato PDF. Tanto el núcleo como los módulos se encuentran en
castellano, pero no es difícil imaginar que no existen dos versiones distintas del código fuente
— una en inglés para SAGA y otra en castellano para SEXTANTE — y que un cambio en el
código de algún módulo existente obliga a reescribirlas ambas. Por una parte se encuentra el
código, y por otra, en ficheros distintos, la traducción de los nombres de parámetros y otras
cadenas de texto que el módulo emplea. Para gestionar esto, la API de SEXTANTE incluye
la función TL(), de la cual veremos a continuación un ejemplo de uso.
Si no tienes intención de dar soporte multilingüe a tus módulos, no es necesario que leas
este apartado. Si, por el contrario, deseas hacerlo, o quieres, por ejemplo, traducir a otro
idioma distinto los módulos de SEXTANTE, he aquí algunas indicaciones al respecto.
Para que una cadena de texto no aparezca en el idioma original en que se encuentra en el
código fuente del módulo, sino que se busque su traducción en un fichero adicional, utiliza la
función TL(). Para el caso de nuestro módulo de ejemplo, el siguiente bloque de texto muestra
la creación de la ventana de parámetros teniendo en cuenta el soporte multilingüe.
Parameters.Set_Name(_TL("MiModulo");
Parameters.Set_Description(_TL("MiModulo");
Parameters.Add_Grid(NULL, "INPUT", _TL("Input"),
_TL("Input for module calculations."), PARAMETER_INPUT);
Parameters.Add_Grid(NULL, "RESULT", "Output",
_TL("Output of module calculations."), PARAMETER_OUTPUT);