REFERENCIA DEL MAPFILE MAPSERVER 4.0

Transcripción

1 REFERENCIA DEL MAPFILE MAPSERVER 4.0 Referencia del Mapfile: Los Mapfiles son el mecanismo de configuración básica del Mapserver. Todo lo relacionado con una aplicación particular esta definido aquí, aunque la mayoría de las opciones pueden ser cambiados a través de un formulario web(variables CGI). Notas: El Mapfile no es sensitivo a las mayúsculas. Las cadenas que contengan caracteres no alfanuméricos o una palabra clave de Mapserver DEBEN estar entre comillas simples. Es recomendable colocar TODAS las cadenas en comillas dobles. Hay un máximo de 50 capas por Mapfile. Esta configuración se puede cambiar editando el archivo map.h para cambiar el valor de MS_MAXLAYERS al número deseado de capas y después se debe recompilar. Las rutas de los archivos pueden ser dadas en rutas absolutas, o como rutas relativas a la localización del Mapfile. Además, los archivos de datos pueden ser especificados relativamente al atributo SHAPEPATH. El archivo de mapa tiene un estructura jerárquica, con el objeto Mapa siendo el raíz. Todos los demás objetos se colocan bajo esta raíz. Los comentarios se pueden incrustar colocando el carácter # al inicio de la frase. Los nombres de los atributos usan la siguiente sintaxis: [NOMBRE_ATRIBUTO]... Nótese que el nombre del atributo incluido entre las llaves es SENSITIVO A LAS MAYÚSCULAS. Generalmente los archivos shapes generados por ESRI tienen todos sus atributos(nombre de las columnas del.dbf) en MAYÚSCULAS, y PostGIS, SIEMPRE usa minúsculas para el nombre de sus campos. Map Object (Objeto Mapa) Define el objeto maestro para un Mapfile, que es el objeto que sostiene todos los otros(es el raíz ). Este define por sí mismo los parámetros del mapa y de su aplicación. A continuación se enlistan sus atributos y métodos: DATAPATTERN [expresión regular] Define una expresión regular para ser aplicada a los requerimientos de cambio en los parámetros del atributo DATA por medio de peticiones URL(datos_nombrecapa_mapa=...). Si un patrón no existe entonces los usuarios

2 web no pueden trabajar con los archivos soportados vía URLs. Esto le permite aislar una aplicación de otra si lo desea, con la operación por defecto siendo muy conservador. Vea también TEMPLATEPATTERN. DEBUG Habilita la depuración del map object. La cadena de salida es generada y enviada a la salida estándar de error(stderr) o el archivo de bitácora(logfile) del Mapserver si uno es estipulado usando el parámetro LOG en el objeto WEB. EXTENT [minx] [miny] [maxx] [maxy] Es la extensión espacial del mapa a crear. A menudo usted querrá especificar esta opción, sin embargo, el Mapserver extrapolará una extensión si no se especifica. FONTSET [nombre_archivo] El nombre del archivo completo del set de fuentes a usar. IMAGECOLOR [r] [v] [a] Es el color para inicializar el mapa (Color de Fondo). Cuando la transparencia esta habilitada (TRANSPARENT ON) para un caso de generación de un mapa típico seudocoloreado de 8-bits, este color será marcado como transparente en la paleta del archivo de salida. Cualquier otro componente del mapa dibujado en este color será transparente también, entonces para la generación de un mapa con transparencia es mejor usar otro color no usado como el color de fondo. IMAGEQUALITY [int] Es la calidad de compresión para salidas JPEG. Esta palabra clave esta desaprobada ahora a favor de usar FORMATOPTION "QUALITY=n" en la declaración del OUTPUTFORMAT. IMAGETYPE [gif png jpeg wbmp gtiff swf userdefined] Es el formato de la salida a generar. Véase los detalles en la sección OUTPUTFORMAT para revisar los formatos disponibles. El nombre referenciado aquí debe coincidir con el NOMBRE de una opción definida por el usuario o una sección del OUTPUTFORMAT generada internamente.

3 INTERLACE [on off] La imagen de salida debería estar entrelazada?. Por defecto se encuentra en [on]. Esta opción esta desaprobada a favor de usar la línea FORMATOPTION "INTERLACE=ON" en la declaración OUTPUTFORMAT. LAYER Señala el comienzo de un objeto LAYER. LEG Señala el comienzo de un objeto LEG. NAME [nombre] Es el nombre del mapa a crear. Este nombre se le da al objeto mapa. Debe ser un nombre corto. PROJECTION Señala el comienzo de un objeto PROJECTION. QUERYMAP Señala el comienzo de un objeto QUERYMAP. REFERENCE Señala el comienzo de un objeto REFERENCE MAP. RESOLUTION [int] Establece los píxeles por pulgada para la salida, solo afecta cómputos de escala y nada más, el valor por defecto es 72. SCALE [double] Escala computada del mapa. Establecida regularmente por la aplicación. SCALEBAR Señala el comienzo de un objeto SCALEBAR.

4 SHAPEPATH [ruta] Ruta al directorio que contiene los archivos shape o figuras. Pueden haber más subdirectorios bajo esta SHAPEPATH. SIZE [x][y] Establece el tamaño en píxeles de la imagen de salida(el mapa). STATUS [on off] Esta el mapa activo. Algunas veces usted desea colocar este en off para usar solamente el mapa de referencia o la barra de escala. SYMBOLSET [nombre_archivo] Nombre de archivo completo del set de símbolos a utilizar. SYMBOL Señala el comienzo de un objeto SYMBOL. TEMPLATEPATTERN [expresión regular] Esto define una expresión regular para ser aplicada a peticiones para cambiar los parámetros del TEMPLATE vía peticiones URL(template_nombrecapa_mapa=...). Si un patrón no existe entonces los usuarios web no pueden trabajar con los archivos soportados vía URLs. Esto le permite aislar una aplicación de otra si lo desea, con la operación por defecto siendo muy conservador. Vea también DATAPATTERN. TRANSPARENT [on off] Debería el color de fondo para los mapas ser transparente?. Esta bandera esta desaprobada a favor de declarar la transparencia dentro de las declaraciones del OUTPUTFORMAT. El valor por defecto es off. UNITS [feet inches kilometers meters miles dd] Las unidades de las coordenadas del mapa. Usada para la barra de escala y cómputos de escala. WEB Señala el comienzo de un objeto WEB.

5 Label Object (Objeto Etiqueta) Este objeto es usado para definir un titulo, el cual es usado normalmente para estampar una figura con un texto. Los títulos pueden, sin embargo, ser usados como símbolos a través del uso de varios fuentes TrueType. ANGLE [double] Ángulo, dado en grados, para dibujar el titulo o establecer AUTO para permitir al software computar el ángulo, AUTO es valido sólo para capas tipo Línea. ANTIALIAS [true false] Debería el texto ser antirenombrado?. Note que esto requiere más colores disponibles y resulta en una imagen de salida un poco más pesada. BACKGROUNDCOLOR [r] [v] [a] El color para dibujar el fondo de un rectángulo(parecido a un cartel). El valor por defecto es off. BACKGROUNDSHADOWCOLOR [r] [v] [a] El color para dibujar la sombra del fondo de un rectángulo(parecido a un cartel). El valor por defecto es off. BACKGROUNDSHADOWSIZE [x][y] Cuan lejos el rectángulo de fondo debería ser desplazado. El valor por defecto es 1. BUFFER [entero] Relieve, en píxeles, alrededor del titulo. Útil para mantener un espaciado alrededor del texto para mejorar su lectura. El valor por defecto es 0. COLOR [r] [v] [a] El color para dibujar el texto. FONT [nombre] Nombre de la fuente(como se define en el FONTSET) a usar para el etiquetado.

6 FORCE [true false] Fuerza a las etiquetas para sobreponerse a una clase en particular. Sin tener en cuenta las colisiones. El valor por defecto es false. MAXSIZE [entero] Tamaño máximo de la fuente para usar cuando se cambie la escala del mapa(en píxeles). El valor por defecto es 256. MINDISTANCE [entero] Mínima distancia entre etiquetas duplicadas. Dado en píxeles. MINFEATURESIZE [entero auto] Tamaño mínimo de una figura para ser etiquetada. Dado en píxeles. Para datos de tipo línea el conjunto de longitud de la línea mostrada es usada, para figuras de polígonos la dimensión más pequeña del perímetro es usada. La palabra clave Auto le dice a Mapserver que debe etiquetar solo las figuras que sean mas largas que su correspondiente titulo. MINSIZE [entero] El tamaño mínimo de la fuente a usar cuando se haga una nueva escala del mapa(en píxeles). El valor por defecto es 4. OFFSET [x][y] El valor del desplazamiento para las etiquetas, relativo a la esquina inferior izquierda de la etiqueta y el punto del titulo. Dado en píxeles. En el caso de texto rotado se debe especificar los valores como si todos las etiquetas estuvieran horizontales y alguna rotación será compensada. OUTLINECOLOR [r] [v] [a] El color para dibujar una línea de un píxel alrededor del texto. PARTIALS [true false] Puede el texto etiquetarse fuera del límite del mapa. El valor por defecto es true.

7 POSITION [ul uc ur cl cc cr ll lc lr auto] Posición de la etiqueta relativo al punto del titulo(solo para capas). La primera letra es la posición en Y, la segunda es la posición en X. Con Auto se consigue que Mapserver calcule la posición del título para no interferir con otros títulos desplegados. Con puntos y polígonos, Mapserver selecciona de las 8 posiciones(incluyendo cc). Con líneas, sólo se usa lc o uc, hasta que encuentre una posición que no corte a otros títulos que ya han sido desplegados. Si todas las posiciones causan un conflicto, entonces el titulo no es dibujado(a menos que el atributo FORCE del objeto Label tenga el valor true ). SHADOWCOLOR [r] [v] [a] El color de la sombra del titulo. SHADOWSIZE [x][y] El valor del desplazamiento de la sombra a mostrar en píxeles. SIZE [entero] [tiny small medium large giant] Es el tamaño del texto. Se usa entero para dar el tamaño en píxeles de la fuente basada en etiquetas TrueType, o alguna de las otras 5 palabras clave listadas para la fuentes bitmap. TYPE [bitmap truetype] El tipo de fuente a usar. Generalmente las fuentes bitmaps son más rápidas para dibujar que las fuentes TrueType. Sin embargo, las fuentes TrueType son escalables y existen una variedad de tipos. Se debe estar seguro de establecer el atributo FONT si se selecciona TrueType. WRAP [caracter] El caracter que representa la condición de fin de línea en etiquetas de texto, esto resulta en un título multilínea.

8 Layer Object(Objeto Capa) Es el objeto más usado en el Mapfile, este describe las capas usadas para incrustar en el mapa. Las capas son dibujadas en su orden de aparición en el Mapfile(la primera es la del fondo, la última es la del frente). CLASS Señala el comienzo de un objeto CLASS. CLASSITEM [atributo] Nombre del ítem en la tabla de atributos para usar para clasificar y buscar en una clase. CONNECTION [cadena] La cadena de conexión a una base de datos geográfica para recuperar datos remotos. Una conexión SDE(Spatial Data Engine, Motor de bases de datos espaciales de ESRI) consiste en un nombre de host, nombre de una instancia, nombre de la base de datos, nombre de usuario y clave. Todo esto separado por comas. Una cadena de conexión PostGIS es básicamente una cadena de conexión a PostgreSQL, toma la forma user=usuario password=***** dbname=base_datos host=servidor port=5432 Una cadena de conexión a Oracle: usuario/clave[@base_datos] CONNECTIONTYPE [local sde ogr postgis oraclespatial wms] Define el tipo de conexión. El valor por defecto es local. DATA [nombre_archivo] [sde parámetros][postgis tabla/columna][oracle tabla/columna] Nombre completo del archivo de los datos espaciales para procesar. No se necesitan extensiones de archivo para los shape. Puede ser especificado relativamente a la opción SHAPEPATH del objeto Mapa. Si es una capa SDE, los parámetros deberían incluir el nombre de la capa como el nombre de la geometría, ej. mylayer.shape.

9 Si es una capa PostGIS, el parámetro debería estar en la forma <nombre_columna> from <nombre_tabla>, donde nombre_columna es el nombre de la columna que contiene los objetos geométricos y nombre_tabla es el nombre de la tabla de la cual se leerán los datos geométricos. Para Oracle, se usa geometría FROM tabla o "geometría FROM (SELECT sentencia)" o incluso consultas más complejas de Oracle. Note que hay un importante impacto en el rendimiento cuando se usan subconsultas espaciales. Estas consultas pueden fallar si se utilizan consultas erróneas, como por ejemplo consultar una tabla o campo no existentes. DEBUG Habilita la depuración de un objeto Layer. La cadena de salida es generada y enviada a la salida estándar de error(stderr) o el archivo de bitácora(logfile) del Mapserver si uno es estipulado usando el parámetro LOG en el objeto WEB. DUMP [true false] Cambia para permitir a Mapserver retornar data en formato GML. Útil cuando se usa con operaciones WMS GetFeatureInfo. El valor por defecto es false. FEATURE Señala el comienzo de un objeto FEATURE. FILTER [cadena] Este parámetro permite un filtro de los datos mediante un dato específico que es realizado al mismo tiempo que el filtro espacial es realizado, pero antes de que alguna expresión de CLASS sea evaluada. Para datos tipo shape la cadena es simplemente una expresión regular de Mapserver. Para bases de datos espaciales la cadena es una consulta tipo SQL WHERE que es válida con respecto al motor utilizado. Por ejemplo: FILTERITEM [atributo] FILTER "tipo='camino' and acceso <2" Ítem a utilizar con expresiones simples FILTER. Sólo para archivos shape.

10 FOOTER [nombre_archivo] Plantilla a utilizar después que un set de resultados de una capa ha sido enviado. Sólo para consultas de modo Multiresultados. GROUP [nombre] Nombre de un grupo al cual esta capa pertenece. El nombre de grupo puede ser referenciado como un nombre regular de capa en los archivos de plantilla, permitiendo hacer cosas como apagar o prender un grupo de capas. HEADER [nombre_archivo] Plantilla a utilizar antes que un set de resultados de una capa ha sido enviado. Sólo para consultas de modo Multiresultados. LABELANGLEITEM [atributo] Nombre de un ítem en la tabla de atributos para usar como ángulos de títulos. Los valores deben estar en grados. LABELCACHE [on off] Especifica cuales etiquetas deberían ser dibujados como figuras de esta capa al mismo tiempo que se dibuja, o cuales deberían ser almacenados y dibujados después que todas las capas se hayan dibujado. El valor por defecto es on. LABELITEM [atributo] Nombre del ítem en la tabla de atributos para usar como clase de anotación(etiquetado). LABELMAXSCALE [double] Máxima escala a la cual la capa es etiquetada. LABELMINSCALE [double] Mínima escala a la cual la capa es etiquetada.

11 LABELREQUIRES [expresión] Establece el contexto para etiquetado de esta capa, por ejemplo: LABELREQUIRES ([manzana]!= 1) Quiere decir que esta capa NO será etiquetada si una capa llamada manzana esta activa. La expresión consiste en una expresión booleana basada en el estado de otras capas, cada subcadena [nombre_capa] es reemplazada por un 0 o un 1 dependiendo del estado(status) de esas capas y después evaluadas normalmente. Los operadores lógicos AND y OR pueden usarse. LABELSIZEITEM [atributo] Nombre del ítem en la tabla de atributos para usar como tamaño de la clase tipo anotación. Los valores deben estar en píxeles. MAXFEATURES [entero] Especifica el número de figuras que deberían ser dibujadas para esta capa en la Ventana Actual(CURRENT). Tiene algunos usos interesantes con anotaciones y datos ordenados(ej. lagos por aárea) MAXSCALE [double] Máxima escala a la cual la capa será dibujada. METADATA Este atributo permite guardar datos arbitrarios como pares nombre valor. Esto es usado para almacenar cosas como el titulo de la capa(titulo largo tipo cadena). Todos los valores que se coloquen aquí pueden ser fácilmente retribuidos mediante lenguajes de script o tags de plantillas. Ejemplo: METADATA titulo "Estratificación Socioeconómica" Autor "Planeación Municipal" MINSCALE [double] Mínima escala a la cual la capa será dibujada.

12 NAME [cadena] Nombre corto para esta capa. El límite es de 20 caracteres. Este nombre es el link entre el Mapfile y las interfaces web que se refieran a este nombre. Estos deben ser idénticos. El nombre debe ser único, a menos que una capa reemplace a otra a escalas diferentes. Use la opción GROUP(agrupar) para asociar capas con cualquier otra. OFFSITE [r] [v] [a] Establece el índice del color para tratar como transparencia para capas tipo raster. POSTLABELCACHE [true false] Le permite a Mapserver renderizar esta capa antes de que todas las etiquetas en el cache sean dibujadas. Útil para adicionar líneas y elementos similares. El valor por defecto es false. PROJECTION Señala el comienzo de un objeto PROJECTION. REQUIRES [expresión] Establece el contexto para mostrar esta capa(véase LABELREQUIRES) SIZEUNITS [pixels feet inches kilometers meters miles ] Establece las unidades de los valores del tamaño del objeto CLASS. El valor por defecto es pixels. Útil para simulación de buffers. STATUS [on off default] Establece el estado actual de la capa. A menudo modificado por el propio Mapserver. El valor por defecto es on. STYLEITEM [atributo] Ítem a utilizar para el estilo de figuras específicas. Esto es muy experimental y solamente usado por el momento en OGR.

13 SYMBOLSCALE [double] La escala a la cual los símbolos y/o los textos aparecen para el tamaño completo. Esto permite el cambio dinámico de escala para objetos basados en la escala del mapa. Si no se establece esta opción, entonces esta capa aparecerá siempre a l mismo tamaño. El cambio de escala solo actúa dentro de los límites de MINSIZE y MAXSIZE como se describió anteriormente. TEMPLATE [archivo url] Usado como alternativa global de CLASS TEMPLATE. Todas las capas que se habiliten para consultar DEBEN tener una plantilla definida. TOLERANCE [double] Tolerancia sensitiva para consultas basadas en puntos(ej. vía mouse y/o coordinadas del mapa). Dado en unidades del tipo establecido en TOLERANCEUNITS con un valor por defecto de 3 píxeles. Para restringir la búsqueda en polígonos, luego el punto debe ocurrir dentro del polígono, establezca la tolerancia a cero. TOLERANCEUNITS [pixels feet inches kilometers meters miles dd] Unidades para los valores de la tolerancia. El valor por defecto es pixels. TRANSPARENCY [entero] Establece el nivel de transparencia de todos los puntos clasificados para una capa estipulada. El valor es un porcentaje(0-100) donde 100 es opaco y 0 es totalmente transparente. TYPE [point line polygon circle annotation raster query] Especifica como deben ser dibujados los datos. No necesita ser igual al tipo del archivo shape. Por ejemplo, un archivo shape de polígono puede ser dibujado como una capa de punto, pero una archivo de punto no puede ser dibujado como una capa de polígono. Reglas de sentido común. La opción Annotation significa que un punto de etiqueta será calculado para las figuras, pero la figura misma no será dibujada aunque un símbolo de marcador puede ser opcionalmente dibujado. Esto permite un etiquetado avanzado como autopistas numeradas. Los puntos son etiquetados en ese punto. Los polígonos se etiquetan usando, en primera instancia, un centroid, y si falla se utiliza un acercamiento de scanline para garantizar que la etiqueta quede dentro de la figura. Las líneas se etiquetan en la mitad del arco más largo de la porción visible de la línea. La opción Query solo

14 significa que la capa puede ser consultada pero no dibujada. En orden a sacar diferencias entre POLIGONOS y POLILINEAS (los cuales no existen como tipo), simplemente use u omita la palabra clave COLOR cuando haga la clasificación. Si se usa, es un polígono con un color de relleno, de otra forma es una polilinea con solo un OUTLINECOLOR. Un circulo debe definirse por un mínimo rectángulo limitado. Es decir, dos puntos que definan el cuadrado más pequeño que puede contenerlo. Estos dos puntos son las esquinas opuestas de dicha caja. Class Object (Objeto de Clase) Define las clases temáticas para una capa dada y cada capa debe tener al menos una clase. En casos de más de una clase, el número de miembros es determinado usando valores de atributos y expresiones. Comienza con la palabra clave CLASS y termina con. BACKGROUNDCOLOR [r] [v] [a] Color a usar para símbolos no transparentes. COLOR [r] [v] [a] Color a usar para dibujar las figuras. DEBUG Habilita la depuración del class object. La cadena de salida es generada y enviada a la salida estándar de error(stderr) o el archivo de bitácora(logfile) del Mapserver si uno es estipulado usando el parámetro LOG en el objeto WEB. EXPRESSION [cadena] Tres tipos de expresiones están ahora soportadas para definir miembros de una clase. Las comparaciones de cadena, expresiones regulares, y expresiones lógicas simples. Si no se da ninguna expresión, entonces todas las figuras estan llamadas a pertenecer a esta clase. Las comparaciones de cadena son sensibles a la escritura y son las más rapidas para evaluar. No se necesitan delimitadores especiales, sin embargo la cadena debe estar entre comillas simples si contienen caracteres especiales(como una forma de buen hábito, es recomendable que se coloquen comillas a todas las cadenas).

15 La función para expresiones regulares es igual a versiones anteriores del Mapserver. Sin embargo, se debe delimitar una expresión regular usando /regex/. (regex=regular expression) No se necesitan ningunas comillas. Las expresiones lógicas le permiten construir pruebas complejas basadas en uno o más atributos y,por consiguiente, están solo disponibles con archivos shape. Las expresiones lógicas están delimitadas por paréntesis (expresión). Los nombres de los atributos están delimitados por llaves [atributo]. Estos nombres son sensibles a la escritura y deben coincidir con los ítems en el archivo shape. Por ejemplo: EXPRESSION ([POBLACION] > AND '[LENGUAGE]' eq 'FRANCES'). Los siguientes operadores lógicos están disponibles: =,>,<,<=,>=,=,or,and,lt,gt,ge,le,eq. Como debería esperar este nivel de complejidad es más lento para su proceso. Las comparaciones de cadena y expresiones regulares trabajan en la definición del classitem en el nivel de la capa. Se pueden mezclar tipos de expresiones dentro de las diferentes clases de una capa. JOIN Señala el comienzo de un objeto JOIN. LABEL Señala el comienzo de un objeto LABEL. MAXSIZE [entero] Tamaño máximo en píxeles para dibujar un símbolo. El valor por defecto es 50. MINSIZE [entero] Tamaño mínimo en píxeles para dibujar un símbolo. El valor por defecto es 0. NAME [cadena] Nombre para usar en la legenda del mapa para esta clase. Si no se establece el nombre no aparecerá en la definición de las leyendas. OUTLINECOLOR [r] [v] [a] Color a utilizar para las líneas externas de los polígonos y ciertos símbolos marcadores. Los símbolos de línea no soportan colores de líneas externas.

16 SIZE [entero] La altura, en píxeles, del símbolo/patrón a ser usado. Sólo útil con símbolos escalables. El valor por defecto es 1. STYLE Señala el comienzo de un objeto STYLE. Una clase puede contener múltiples estilos. SYMBOL [integer cadena] El nombre o número del símbolo a usar para todas las figuras si las tablas de atributos no son utilizadas. El número es el índice del símbolo en el archivo de símbolos., empezando con 1, el quinto símbolo en el archivo es el símbolo número 5. Se puede dar símbolos propios usando la palabra clave NAME en el archivo de definición de símbolo, y usar estos para referirlos. El valor por defecto es 0, cuyo resultado es un píxel simple, una línea de ancho simple, o un polígono con un llenado sólido, dependiendo del tipo de la capa. TEMPLATE [nombre_archivo] Archivo de plantilla o URL a usar para la presentación de resultados de consultas al usuario. TEXT [cadena] Texto estático para etiquetar las figuras que estén dentro de esta clase. Estos valores substituidos son obtenidos del LABELITEM. La cadena puede ser dada como una expresión delimitada usando los paréntesis. Esto permite concatenar múltiples atributos en una etiqueta simple. Por ejemplo: ([NOMBRE],[APELLIDO]). Se pueden almacenar 2 símbolos para lograr efectos interesantes. Se define el segundo símbolo, el cual efectivamente se coloca al frente del símbolo normalmente definido encima. Los siguientes parámetros permiten definir el símbolo, y son equivalentes a sus complementos no-cubiertos: OVERLAYBACKGROUNDCOLOR OVERLAYCOLOR OVERLAYOUTLINECOLOR OVERLAYSIZE

17 OVERLAYMINSIZE OVERLAYMAXSIZE OVERLAYSYMBOL Style Object(Objeto Estilo) Este objeto contiene parámetros para la simbolización. Múltiples estilos pueden ser aplicados dentro de una clase. Este objeto permite separar la lógica de la apariencia, y es la manera preferida de definir la apariencia de un objeto. ANTIALIAS [true false] Deberían las fuentes TrueType ser antirenombradas. BACKGROUNDCOLOR [r] [v] [a] El color a usar para símbolos no transparentes. COLOR [r] [v] [a] Color a utilizar para dibujar las figuras. MAXSIZE [entero] Tamaño máximo, en píxeles, para dibujar un símbolo. El valor por defecto es 50. MINSIZE [entero] Tamaño mínimo, en píxeles, para dibujar un símbolo. El valor por defecto es 0. OFFSET [x][y] El valor del desplazamiento para las sombras, símbolos sin sombra, etc.. OUTLINECOLOR [r] [v] [a] Color a utilizar para las líneas externas de un polígono y ciertos símbolos marcadores. Los símbolos de línea no soportan colores de líneas externas. SIZE [entero] La altura, en píxeles, del símbolo/patrón a ser usado. Sólo útil con símbolos escalables. El valor por defecto es 1.

18 SYMBOL [integer cadena] El nombre o número del símbolo a usar para todas las figuras si las tablas de atributos no son utilizadas. El número es el índice del símbolo en el archivo de símbolos., empezando con 1, el quinto símbolo en el archivo es el símbolo número 5. Se puede dar símbolos propios usando la palabra clave NAME en el archivo de definición de símbolo, y usar estos para referirlos. El valor por defecto es 0, cuyo resultado es un píxel simple, una línea de ancho simple, o un polígono con un llenado sólido, dependiendo del tipo de la capa. Feature Object(Objeto de Característica) Define características de las líneas. Se pueden usar características de líneas cuando no es posible(o es demasiado complicado) para crear un archivo shape. Las líneas de características pueden ser construidas también vía URLs o formularios. Comienza con la palabra clave FEATURE y termina con. POINTS Un conjunto de pares xy terminados con, por ejemplo: POINTS Notar que con capas de tipo POLÍGONOS/POLILÍNEA los POINTS deben comenzar y terminar con el mismo punto(para cerrar la figura). TEXT [cadena] Cadena a usar para etiquetar esta figura. Legend Object (Objeto Leyenda) Define como se construirá la leyenda del mapa. Los componentes de la leyenda son construidos automáticamente desde los objetos de clase hasta las capas individuales. Comienza con la palabra clave LEG y termina con. El tamaño de la imagen de la legenda NO es conocido previamente a la creación, luego se debe ser cuidadoso no recargar con el ancho y el alto de la imagen que se coloque en la interfaz web. IMAGECOLOR [r] [v] [a] El color para inicializar la leyenda. (El color de fondo)

19 INTERLACE [on off] La imagen de salida debería estar entrelazada?. Por defecto se encuentra en [on]. Esta opción esta desaprobada a favor de usar la línea FORMATOPTION "INTERLACE=ON" en la declaración OUTPUTFORMAT. LABEL Señala el comienzo de un objeto LABEL. OUTLINECOLOR [r] [v] [a] El color a usar para símbolos con líneas externas. POSITION [ul uc ur ll lc lr] Donde colocar una leyenda embebida dentro del mapa. La opción por defecto es lr. KEYSIZE [x][y] Tamaño de los símbolos en píxeles. El valor por defecto es 20 por 10. KEYSPACING [x][y] Espaciado entre los símbolos([y]) y las etiquetas([x]). El valor por defecto es 5 por 5. POSTLABELCACHE [true false] Le permite a Mapserver renderizar esta capa antes de que todas las etiquetas en el cache sean dibujadas. Útil para adicionar líneas y elementos similares. El valor por defecto es false. STATUS [on off embed] Esta opción se utiliza para definir si se crea(on) o no(off) una imagen con las leyendas del mapa o por el contrario si se embebe dentro de la imagen del mapa. TRANSPARENT [on off] Debería el color de fondo para la leyenda ser transparente?. Esta bandera esta desaprobada a favor de declarar la transparencia dentro de las declaraciones del OUTPUTFORMAT. El valor por defecto es off.

20 QueryMap Object(Objeto Consulta del Mapa) Define un mecanismo para mapear los resultados de una consulta. Comienza con la palabra clave QUERYMAP y termina con. COLOR [r] [v] [a] El color que tomarán las figuras consultadas. El valor por defecto es amarillo. SIZE [x][y] Tamaño del mapa a generar en píxeles. El valor por defecto es el tamaño definido en el objeto MAP. STATUS [on off] La consulta será dibujada?. STYLE [normal hilite selected] Establece como se manejarán las figuras seleccionadas. Las capas no consultadas son dibujadas normalmente. Normal: Dibuja todas las figuras de acuerdo a las configuraciones para esa capa. Hilite: Dibuja las figuras seleccionadas usando el valor de COLOR. Las figuras no seleccionadas se dibujan normalmente. Selected: Dibuja normalmente solo las figuras seleccionadas. Join Object(Objeto de Unión) Define como se maneja una unión específica. Comienza con la palabra clave JOIN y termina con. Las uniones(joins) estan definidas dentro de los objetos de consulta. FROM [ítem] Ítem de la unión en el archivo shape. NAME [cadena] Nombre único para esta unión.

21 TABLE [archivo] Nombre del archivo Xbase(DBF, debe ser una ruta completa) con el cual realizar la unión. TEMPLATE [nombre_archivo] Plantilla a usar con uniones uno a muchos. La plantilla es procesado una vez por cada registro y puede contener solamente substituciones para ítems en la tabla unida. TO [ítem] Ítem de unión presente en la tabla a unir. TYPE [multiple single] El tipo de unión. El valor por defecto es single(uno a uno). Reference Map Object (Objeto Mapa de Referencia) Define como se crearán los mapas de referencia. Comienza con la palabra clave REFERENCE y termina con. Existen tres tipos de mapas soportados. El mas común será un que muestre la extensión del mapa en una interfase interactiva. Es posible también realizar peticiones al mapa de referencia como parte de una consulta. Las consultas de tipo punto generarán una imagen con una marca situada en el lugar de la consulta. Las consultas basadas en regiones pintarán la extensión de un área de interés. Finalmente, las consultas basadas en figuras mostrarán las figuras seleccionadas utilizadas. COLOR [r] [v] [a] El color en que se dibujará el cuadro de referencia. Se puede establecer algun componente a 1 para no rellenar. El valor por defecto es rojo. EXTENT [minx][miny][maxx][maxy] La extensión espacial de la imagen base de la referencia. IMAGE [nombre_archivo]

22 El nombre completo del archivo de la imagen del mapa base de referencia. Debe ser una imagen tipo GIF. MARKER [entero cadena] Define un símbolo(del archivo de símbolos) a usar cuando el cuadro del mapa de referencis se vuelva muy pequeña(véase MINBOXSIZE y MAXBOXSIZE abajo). Usa una cruz por defecto. MARKERSIZE [entero] Define el tamaño del símbolo a usar en vez de una caja.(ver MARKER arriba) MINBOXSIZE [entero] Si la caja del mapa de referencia es mas pequeña que el MINBOXSIZE(use alto o ancho de la caja) entonces use el símbolo definido por MARKER y MARKERSIZE. MAXBOXSIZE [entero] Si la caja del mapa de referencia es mas grande que el MAXBOXSIZE(use alto o ancho de la caja) entonces no dibuje nada(a menudo todo el mapa se cubre cuando se amplia demasiado y es perfectamente obvio saber donde se encuentra.) OUTLINECOLOR [r] [v] [a] Color a utilizar para las líneas externas de la caja del mapa de referencia. Establezca cualquier componente a 1 para no colocar líneas externas. SIZE [x][y] Tamaño, en píxeles, de la imagen del mapa de referencia. STATUS [on off] Se creará el mapa de referencia?. El valor por defecto es off. Scalebar Object (Objeto Barra de Escala) Define como se creará la barra de escala del mapa. Comienza con la palabra clave SCALEBAR y termina con. Las barras de escala no hacen uso actualmente de fuentes TrueType. El tamaño de la barra de escala no es conocido de antemano, luego se debe ser cuidadoso en no sobrecargar en alto y ancho de la imagen en la interfaz web.

23 BACKGROUNDCOLOR [r] [v] [a] Color a utilizar para el fondo de la barra de escala, no es el fondo de la imagen. COLOR [r] [v] [a] Color a usar para dibujar todas las figuras si las tablas de atributos no estan definidas. IMAGECOLOR [r] [v] [a] Color para inicializar la barra de escala(el fondo). INTERLACE [true false] La imagen de salida debería estar entrelazada?. Por defecto se encuentra en [on]. Esta opción esta desaprobada a favor de usar la línea FORMATOPTION "INTERLACE=ON" en la declaración OUTPUTFORMAT. INTERVALS [intervalo] Número de intervalos para dividir la barra de escala. El valor por defecto es 4. LABEL Señala el inicio de un objeto LABEL. OUTLINECOLOR [r] [v] [a] Color a usar para pintar las líneas externas de los intervalos individuales. Establezca cualquier componente a 1 para no colocar líneas externas, lo cual es el valor por defecto. POSITION [ul uc ur ll lc lr] Donde colocar la barra de escala cuando se embebe dentro del mapa. El valor por defecto es lr. POSTLABELCACHE [true false]

24 Para uso con barras de escala embebidas solamente. Esta opción le dice a Mapserver que embeba la barra de escala antes de que todas las etiquetas sean dibujadas. El valor por defecto es false. SIZE [x][y] Tamaño en píxeles de la barra de escala. El etiquetado no se toma dentro de la cuenta. STATUS [on off embed] Se creará una imagen aparte para la barra de escala o se embeberá dentro de la imagen del mapa. El valor por defecto es off. (Cabe destacar que las barras de escala embebidas requieren que se defina un Markerset. En esencia, la barra de escala se convierte en un marcador personalizado que es manejado como si fuese una anotación.) STYLE [entero] Escoge el estilo de la barra de escala. Los estilos validos son 0 o 1. TRANSPARENT [on off] Debería ser transparente el color de fondo de la barra de escala. Esta bandera esta desaprobada a favor de declarar la transparencia dentro de las declaraciones del OUTPUTFORMAT. El valor por defecto es off. UNITS [feet inches kilometers meters miles] Las unidades de medida de la barra de escala generada. El valor por defecto es miles(millas). Usado en conjunción con las unidades del mapa para desarrollar la gráfica actual. Cabe destacar que los grados decimales no son unidades correctas de la barra de escala. Web Object(Objeto Web) Define como operará una interfaz web. Comienza con la palabra clave WEB y termina con. EMPTY [url] URL para direccionar a los usuarios cuando las consultas sean erróneas. Si no se define el valor del atributo ERROR es usado.

25 ERROR [url] URL para direccionar a los usuarios cuando se produzca un error. Si no se define aparecerán feos errores de Mapserver. FOOTER [nombre_archivo] Plantilla a utilizar después de que se haya enviado todo. Solamente para consultas Multiresultados. HEADER [filename] Plantilla a utilizar antes de que se haya enviado todo. Solamente para consultas Multiresultados. IMAGEPATH [ruta] Ruta a un directorio temporal para escribir los archivos temporales e imágenes. Este directorio debe tener permisos de escritura en el servidor web que se este utilizando. Debe terminar con un /(UNIX) o un \(guindows) dependiendo de la plataforma. IMAGEURL [ruta] URL base para el atributo IMAGEPATH. Este es el URL que tomará el browser para obtener las imágenes generadas. LOG [nombre_archivo] Archivo para monitorizar la actividad del Mapserver. Debe tener permisos de escritura en el servidor que se este ejecutando. MAXSCALE [double] Máxima escala a la cual esta interfaz es válida. Cuando un usuario pide un mapa a una escala mayor, Mapserver Automáticamente retorna el mapa a esta escala. Esto efectivamente previene al usuario de alejarse demasiado del mapa. MAXTEMPLATE [archivo url]

26 Plantilla a ser usada si se esta por encima de la escala máxima permitida para la aplicación, útil para aplicaciones anidadas. METADATA Este atributo permite guardar datos arbitrarios como pares nombre valor. Esto es usado para almacenar cosas como el titulo de la capa(titulo largo tipo cadena). Todos los valores que se coloquen aquí pueden ser fácilmente retribuidos mediante lenguajes de script o tags de plantillas. Ejemplo: METADATA titulo "Estratificación Socioeconómica" Autor "Planeación Municipal" MINSCALE [double] Mínima escala a la cual esta interfaz es válida. Cuando un usuario pide un mapa a una escala menor, Mapserver Automáticamente retorna el mapa a esta escala. Esto efectivamente previene al usuario se acerque demasiado del mapa. MINTEMPLATE Plantilla a ser usada si se esta por debajo de la escala mínima permitida para la aplicación, útil para aplicaciones anidadas. TEMPLATE [nombre_archivo url] Archo de plantilla o URL para usar en la presentación de resultados al usuario en un modo interactivo. Projection Object (Objeto de Proyección) Para habilitar proyecciones se debe definir dos objetos de proyección: uno para la imagen de salida(en el objeto MAP) y una para cada capa(en los objetos LAYER) para ser proyectada. Los objetos de proyección simplemente consisten en una serie de palabras clave de la librería PROJ.4. Aquí hay un ejemplo definiendo la zona UTM 15, NAD83: PROJECTION "proj=utm"

27 "ellps=grs80" "zone=15" "north" "no_defs" Las coordenadas geográficas están definidas así: PROJECTION "proj=latlong" Ver la librería PROJ.4 para una completa descripción de las proyecciones soportadas y el sistema de coordenadas. OutputFormat Object(Objeto Formato de Salida) En esta sección se discute como definir y seleccionar los diferentes formatos de salida. Un archivo de Mapa(Mapfile) puede tener cero, una o varias declaraciones de objetos OUTPUTFORMAT, definiendo formatos de salida disponibles soportados, incluyendo formatos como PNG, GIF, JPEG, GeoTIFF and Flash(SWF). Si no se encuentran secciones de declaración de OUTPUTFORMAT en el Mapfile, las siguientes declaraciones implícitas se realizarán. El formato GeoTIFF depende de la construcción del Mapserver con soporte para GDAL, y el formato Flash(SWF) depende de la compilación con soporte de la librería MING. OUTPUTFORMAT NAME gif DRIVER "GD/GIF" MIMETYPE "image/gif" IMAGEMODE PC256 EXTENSION "gif" OUTPUTFORMAT NAME png DRIVER "GD/PNG" MIMETYPE "image/png" IMAGEMODE PC256 EXTENSION "png" OUTPUTFORMAT

28 NAME jpeg DRIVER "GD/JPEG" MIMETYPE "image/jpeg" IMAGEMODE RGB EXTENSION "jpg" OUTPUTFORMAT NAME wbmp DRIVER "GD/WBMP" MIMETYPE "image/wbmp" IMAGEMODE PC256 EXTENSION "wbmp" OUTPUTFORMAT NAME swf DRIVER "SWF" MIMETYPE "application/x-shockwave-flash" EXTENSION "swf" IMAGEMODE PC256 FORMATOPTION "OUTPUT_MOVIE=SINGLE" OUTPUTFORMAT NAME GTiff DRIVER "GDAL/GTiff" MIMETYPE "image/tiff" IMAGEMODE RGB EXTENSION "tif" NAME [nombre] El nombre a usar en la palabra clave IMAGETYPE del Mapfile para seleccionar este formato de salida.(opcional) DRIVER [nombre] El nombre del driver a utilizar para generar este formato de salida. Algunos nombres de drivers incluyen la definición del formato si el driver soporta múltiples formatos. Para GD el nombre del driver puede ser GD/Gif, "GD/PNG", "GD/WBMP" y "GD/JPEG". Para flash el driver es llamado solamente SWF. Para

29 salidas a través de GDAL el nombre corto para el formato es añadido, como "GDAL/Gtiff. Cabe destacar que las salidas PNG, JPEG y GIF pueden ser generados con las librerías GDAL o GD(Normalmente la librería GD es más eficiente). IMAGEMODE [PC256/RGB/RGBA/INT16/FLOAT32] Selecciona el modo de la imagen en la cual se generará la salida. Es importante para formatos no raster como flash. No todos los formatos soportan todas las combinaciones. Por ejemplo GD/GIF soporta solamente el modo PC256. PC256: Produce un resultado seudocoloreado con 256 colores en la paleta(normalmente el modo de Mapserver). RGB: Renderiza imágenes en modo 24 bits Rojo/Verde/Azul(RGB). Soporta todos los colores pero no soporta transparencias. RGBA: Renderiza imágenes en modo 32 bits Rojo/Verde/Azul/Apha(RGBA). Soporta todos los colores, y transparencia alfa. INT16: Renderiza una banda de datos en profundidad entera de 16 bit. Solo trabaja actualmente con capas tipo RASTER y capas WMS. FLOAT32: Renderiza una banda de datos en profundidad flotante de 32 bit. Solo trabaja actualmente con capas tipo RASTER y capas WMS. MIMETYPE [tipo] Provee el tipo mime a usar cuando se retornen datos sobre la web. EXTENSION [tipo] Provee la extensión a usar cuando se creen los archivos de este tipo. TRANSPARENT [ON/OFF] Indica si la transparencia debería habilitarse para este formato. Cabe destacar que la transparencia no trabaja para salidas IMAGEMODE RGB. No todos los formatos soportan transparencia. Cuando la transparencia esta activa para el típico caso de generación de mapas seudocoloreados de 8-bit, el color del atributo IMAGECOLOR será marcada como transparente en la paleta del archivo de salida. Cualquier otro componente del mapa dibujado en este color también será transparente, luego para la creación del mapa con transparencia es mejor usar otro color no usado como el color de fondo.

30 FORMATOPTION [opcion] Provee una opción específica para un formato o driver. Cero o más sentencias FORMATOPTION pueden ser presentadas dentro de una declaración de OUTPUTFORMAT. GD/JPEG: La opción "QUALITY=n" puede ser usada para establecer la calidad del jpeg producido.(valor de 0 a 100) GD/PNG: La opción "INTERLACE=[ON/OFF]" puede ser usada para activar o desactivar el entrelazado. GD/GIF: La opción "INTERLACE=[ON/OFF]" puede ser usada para activar o desactivar el entrelazado. GDAL/GTiff: Soporta los formatos específicos de opción TILED=YES, BLOCKXSIZE=n, BLOCKYSIZE=n, INTERLEAVE=[PIXEL/BAND] y COMPRESS=[NONE,PACKBITS,JPEG,LZW,DEFLATE]. GDAL/*: Todas los formatos de opción (FORMATOPTIONs) son pasados dentro de la función create de GDAL. Las opciones soportadas por GDAL son descritas en la documentación detallada para cada formato GDAL. Referencia de la Simbología: Esta sección explica como trabajar con la simbología definida en Mapserver. Notas: La definición de símbolos puede ser incluida dentro del archivo Mapfile o, mas comúnmente, en un archivo separado. La definición de símbolos en un archivo separado esta designado usando la palabra clave SYMBOLSET, como parte del objeto MAP. Esta configuración recomendada es ideal para reusar los símbolos a través de múltiples aplicaciones Mapserver. Existen 3 tipos principales de símbolos en Mapserver: Marcadores, Sombras y líneas. El símbolo 0 es siempre el caso generado para una clase particular de símbolo. Para puntos, el símbolo 0 es un píxel simple, para sombreado(polígonos rellenos) el símbolo 0 es un relleno sólido, y para las líneas el símbolo 0 es una línea de un píxel de ancho.

31 La definición de los símbolos no contienen información de color, los colores se establecen en el objeto CLASS. Hay un máximo de 64 símbolos por archivo. Esto puede ser cambiado editando el archivo mapsymbol.h, y cambiando el valor de MS_MAXSYMBOLS al inicio del archivo. Sintaxis: ANTIALIAS [true false] Deberían ser renombradas las fuentes TrueType. CHARACTER [caracter] Esta opción es usada para referenciar una fuente particular TrueType. Se necesita calcular el mapeo desde caracteres del teclado hacia caracteres de la fuente. FILLED [true false] Establece los símbolos a llenar con un color definido por el usuario(vea el objeto clase). Para símbolos marcadores, si la opción OUTLINECOLOR fue especificada entonces el símbolo es delineado en su exterior. FONT [cadena] Nombre de la fuente TrueType a usar como se define en el FONTSET. GAP [int] Dado en píxeles. Este define una distancia entre los símbolos para líneas TrueType. IMAGE [cadena] Imagen (GIF o PNG) a usar como marcador o pincel para símbolos de tipo PIXMAX. NAME [cadena] Alias para esta fuente a ser usada en objetos CLASS.

32 POINTS [x y] [x y]... Significa el comienzo de la definición de puntos que constituye un símbolo tipo vector o que define los radios X y Y de un símbolo tipo elipse. El final de esta sección se estipula con la palabra clave. Las coordenadas estan dadas en píxeles y definen el tamaño por defecto del símbolo antes de cualquier cambio de escala. Se pueden crear rutas no contiguas insertando coordenadas negativas en el lugar apropieado. Para símbolos tipo elipse se provee un puunto simple que define el radio en X y Y de la elipse. Los circulos son creados cuando la coordenada X y Y son iguales. STYLE [num on] [num off] [num on]... Define un estilo o patrón punteado. TRANSPARENT [índice color] Establezca un color transparente para la imagen GIF de entrada en símbolos tipo PIXMAP, o determine si todos los símbolos sombreados deben tener un fondo transparente. Para símbolos sombreados es deseable tener figuras de fondo para Mostrar a Través de un patrón de compuertas transparentes, creando un mapa mas complejo. Por defecto el fondo de un símbolo es el mismo que la imagen padre(color 0). Esto puede ser configurado por el usuario. TYPE [vector ellipse pixmap truetype simple] vector: Un dibujo simple es usado para definir la forma del símbolo. ellipse: Valores de radio en direcciones X y Y definen una elipse. pixmap: Una imagen proporcionada por el usuario que será usada como símbolo. truetype: Fuente TrueType a usar como se define en el FONSET. Ejemplos Aquí hay algunos ejemplos que ilustran las diferentes formas de crear símbolos en el Mapserver. Ejemplo 1. Línea Punteada SYMBOL NAME 'punteada1' TYPE ELLIPSE POINTS 1 1

33 FILLED true STYLE Esto crea una línea punteada con 10 píxeles seguidos, 5 cortados, 5 seguidos, 10 cortados. Ejemplo 2. Símbolo marcador de Fuente TrueType SYMBOL NAME "fuente1" TYPE TRUETYPE FONT geo FILLED true ANTIALIAS true CHARACTER "r" Este símbolo es una estrella, usada para representar la capital nacional, dentro del nombre. El nombre de la fuente esta definida en el archivo FONSET. El código 114 varía, se puede usar el mapa de caracteres de MS Windows para encontrarlo, o estimarlo. Ejemplo 3. Símbolo marcador de un triangulo vector. SYMBOL NAME "triangulo" TYPE vector POINTS Este es un concepto adelantado. Note que para tener 3 lados se necesitan 4 puntos, donde el punto inicial y final son iguales. Ejemplo 4. Símbolo tipo marcador vector no contiguo.(cruz) SYMBOL

34 NAME "cross" TYPE vector POINTS Este ejemplo dibuja una cruz, que son dos líneas(vectores) que no están conectados inici-final(como el ejemplo anterior). El valor negativo separa las dos. Ejemplo 5. Símbolo Vector Círculo SYMBOL NAME "circle" TYPE ellipse FILLED true POINTS 1 1 Un simple circulo relleno. Usando valores no-iguales para los puntos dará una elipse actual. Ejemplo 6. Llenado diagonal descendente. SYMBOL NAME "diagonal_desc" TYPE vector TRANSPARENT 0 POINTS