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

322 CAPÍTULO 20. PROGRAMACIÓN DE MÓDULOS DE SEXTANTE
20.2. Librerías y módulos
Como ya sabrás, los módulos de SEXTANTE se agrupan en librerías. A la hora de crear un
nuevo módulo, éste tiene que estar contenido en una librería, y esta circunstancia es algo que
debe reflejarse también en el código fuente. Puesto que esto es algo que siempre ha de hacerse,
comenzaré explicando la estructura básica de una librería antes de comenzar a escribir código
fuente.
En el código fuente de SEXTANTE (descárgalo si aún no lo has hecho) encontrarás una
carpeta llamada modules template que contiene una plantilla de módulo. En dicha carpeta
encontrarás los siguientes ficheros:
Template.dsp
Template.h
Template.cpp
MLB Interface.cpp
MLB Interface.h
Este grupo de ficheros corresponde a una librería con un único módulo. La estructura de
ésta queda definida en el fichero MLB Interface.cpp, mientras que el módulo en sí se describe
en Template.h y Template.cpp. El archivo Template.dsp contiene un proyecto de Visual Studio
correspondiente a la librería al completo.
Puedes abrir este último y compilar la librería, en cuyo caso obtendrás un fichero de librería
(una dll en el caso de trabajar en Windows). Al cargarlo en SEXTANTE, tendrá su propia
entrada de menú en el menú Módulos. Tal y como veremos cuando analicemos su código
fuente, el módulo simplemente toma una capa y genera una nueva con su misma extensión,
que contiene en sus celdas el valor de la capa original multiplicado por una constante.
Usaremos esta plantilla para crear una nueva librería que no sólo contenga un módulo, sino
dos, uno de ellos siendo una versión simplificada del otro. Lo primero que debemos hacer es
darle el nombre que deseemos a la librería, así que crea una copia de la carpeta y renombra
los archivos según el siguiente esquema.
Template.h → MiLibreria.h
Template.cpp → MiLibreria.cpp
Template.dsp → MiLibreria.dsp
Por supuesto, renombrar los archivos no es estrictamente necesario para compilar nuestra
librería de módulos, pero es el primer paso lógico si queremos crear nuestro propio módulo y
darle una identidad dentro del conjunto de ellos de SEXTANTE.
No cambies el nombre de los archivos MLB Interface.*.
Aún nos faltan dos archivos (un .cpp y un archivo .h de cabecera) correspondientes al
segundo módulo, que será nuestra versión simplificada del ya existente. Veremos después cómo
añadir más módulos a la librería, pero por ahora nos basta con el que tenemos.
Antes de seguir, modifiquemos el nombre de la librería también en los ficheros de proyecto
de Visual Studio (o en sus correspondientes makefiles si trabajamos en otro entorno). Simplemente
abre el fichero MiLibreria.dsp y con tu editor de texto favorito (el bloc de notas de
Windows no es muy potente, pero para este cometido te bastará) reemplaza todas las ocurrencias
de la cadena de texto Template por MiLibreria (o el nombre que desees darle). Guarda el