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

326 CAPÍTULO 20. PROGRAMACIÓN DE MÓDULOS DE SEXTANTE
}
"Choose a method from this select option.",
"First Method|"
"Second Method|",
0 );
Como puedes ver, todas las líneas hacen uso de la variable Parameters, que se encuentra
definida como un variable de miembro en la clase CModule y puede, por tanto, accederse desde
cualquier módulo que crees.
Las primeras dos líneas establecen el nombre y la descripción del módulo, y se emplean
para dar nombre a la entrada de menú correspondiente y facilitar información adicional cuando
se selecciona el módulo en cuestión dentro de la pestaña Módulos.
Las siguientes líneas definen la ventana de parámetros que verás una vez que arranques el
módulo. En este caso, sólo se trabaja con capas raster y no es necesaria una gran cantidad de
información, por lo que hay muchas posibilidades que no se recogen en este módulo de ejemplo.
Todas ellas usan simplemente otros métodos de la clase CParameter, que a continuación serán
explicados uno por uno.
Lo primero que habitualmente se requiere para ejecutar un módulo es una capa (o un
grupo de ellas), ya sea de tipo raster o de tipo vectorial. Para el caso de una única capa raster,
tal y como sucede en el ejemplo, se utiliza el método Add Grid, definido de la siguiente forma.
CParameter * Add_Grid (CParameter *pParent,
const char *Ident,
const char *Name,
const char *Desc,
int Constraint);
donde
pParent es un puntero al parámetro ✭✭padre✮✮ del que depende el parámetro especificado. Este
puntero aparece en todos los métodos para obtener del usuario cualquier tipo de información,
y veremos más adelante como utilizarlo para agrupar parámetros. Por el momento, dale valor
NULL, que es la opción más habitual.
*Ident es un identificador interno del módulo.
Ésta es la cadena de texto que sirve para
llamar al parámetro cuando se usa la línea de comandos, y también para grabar valores de
parámetros, como vimos en el capítulo anterior.
*Name es el nombre del parámetro mostrado al usuario en la ventana correspondiente
*Desc es una descripción más detallada del parámetro.
Constraint es un descriptor de las características de la capa raster que constituye el parámetro.
Pueden usarse las siguientes constantes como valores de esta variable:
PARAMETER INPUT: La capa es de entrada y obligatoria
PARAMETER OUTPUT: La capa es de salida y obligatoria
PARAMETER INPUT OPTIONAL: La capa es de entrada y opcional
PARAMETER OUTPUT OPTIONAL: La capa es de salida y opcional
Aquí tienes un ejemplo de cómo usar esto, tomado del código del módulo de ejemplo:
Parameters.Add_Grid(NULL, "INPUT", "Input" ,
"Input for module calculations.", PARAMETER_INPUT);