REFERENCIA DE LAS CLASES, METODOS Y PROPIEDADES DE PHP/MAPSCRIPT 4.

0
Notas muy importantes: Los nombres de constantes y variables miembro de una clase son sensibles a la escritura en PHP. Muchas funciones de Mapscript(todas aquellas que acceden archivos en el fondo como ms_newMapObj(), drawMap(), etc) afectarn el valor del Directorio de Trabajo Actual(DTA) en el ambiente de PHP.

Constantes: Las siguientes constantes de Mapserver estn disponibles: Valores Booleanos: MS_TRUE, MS_FALSE, MS_ON, MS_OFF, MS_YES, MS_NO Unidades del Mapa: MS_INCHES, MS_FEET, MS_MILES, MS_METERS, MS_KILOMETERS, MS_DD, MS_PIXELS Tipos de Capas: MS_LAYER_POINT, MS_LAYER_LINE, MS_LAYER_POLYGON, MS_LAYER_RASTER, MS_LAYER_ANNOTATION, MS_LAYER_QUERY, MS_LAYER_CIRCLE Estado de Capa/Leyenda/Barra escala/Clase: MS_ON, MS_OFF, MS_DEFAULT, MS_EMBED, MS_DELETE Tipos de Fuente: MS_TRUETYPE, MS_BITMAP Posiciones de Etiqueta: MS_UL, MS_LR, MS_UR, MS_LL, MS_CR, MS_CL, MS_UC, MS_LC, MS_CC, MS_AUTO, MS_XY Estilos de Fuente Bitmap: MS_TINY , MS_SMALL, MS_MEDIUM, MS_LARGE, MS_GIANT

Tipos de Figuras: MS_SHAPE_POINT, MS_SHAPE_NULL

MS_SHAPE_LINE,

MS_SHAPE_POLYGON,

Tipos de Archivos Shape: MS_SHP_POINT, MS_SHP_ARC, MS_SHP_POLYGON, MS_SHP_MULTIPOINT Tipos de Consulta/Unin: MS_SINGLE, MS_MULTIPLE Estilos del Mapa de Consulta: MS_NORMAL, MS_HILITE, MS_SELECTED Tipos de Conexin: MS_INLINE, MS_SHAPEFILE, MS_TILED_SHAPEFILE, MS_SDE, MS_OGR, MS_TILED_OGR, MS_POSTGIS, MS_WMS, MS_ORACLESPATIAL Tipos de Imagen de Salida: MS_GIF, MS_PNG, MS_JPEG, MS_WBMP Funciones: string ms_GetVersion() Retorna la versin del Mapserver y opciones en una cadena. Esta cadena puede ser parseada para encontrar cuales mdulos fueron compilados, etc... array ms_TokenizeMap(string nombre_archivo_mapa) Preparsea un Mapfile a travs del Parser del Mapserver y retorna un arreglo con un tem por cada token del Mapfile. Las cadenas, expresiones lgicas, expresiones regex y comentarios son retornados como tokens individuales. Clase MapObj: Constructor: mapObj ms_newMapObj(string nom_archivo_mapa [, string nueva_ruta_mapa])

Retorna un nuevo objeto para tratar con un archivo de mapa de Mapserver. Por defecto, las rutas de SYMBOLSET, FONTSET, y otras en el Mapfile son relativas a la localizacin del Mapfile. Si se establece nueva_ruta_mapa entonces este

directorio ser usado como ruta base para todas las rutas relativas dentro del Mapfile. Miembros: int numlayers (solo-lectura) string name int status int width int height int transparent int interlace int imagetype int imagequality int resolution (Pxeles por pulgada, por defecto 72) rectObj extent; double cellsize int units (tipo de unidades del mapa) double scale (solo-lectura, establecidas por drawMap()) string shapepath int keysizex int keysizey int keyspacingx int keyspacingy webObj web referenceMapObj reference colorObj imagecolor scalebarObj scalebar legendObj legend string symbolsetfilename (solo-lectura, establecida por setSymbolSet()) string fontsetfilename (solo-lectura, establecida por setFontSet()) Mtodos: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores. int addColor(int r, int v, int a) Adiciona un color a la paleta del mapa. Retorna el ndice del color. int getsymbolbyname(string symbol_name) Retorna el ndice del smbolo usando el nombre.

void preparequery() Calcula la escala del mapa y la asigna al Map->scale, imageObj prepareImage() Retorna un manejador a un objeto de imagen blanco. imageObj draw() Dibuja el mapa y retorna un manejador a un objeto de imagen. imageObj drawQuery() Dibuja el mapa consultado y retorna un manejador a un objeto de imagen. imageObj drawLegend() Dibuja la leyenda del mapa retorna un manejador a un objeto de imagen. imageObj drawReferenceMap() Dibuja el mapa de referencia y retorna un manejador a un objeto de imagen. imageObj drawScaleBar() Dibuja la barra de escala y retorna un manejador a un objeto de imagen. int embedlegend(imageObj image) Embebe una leyenda. Actualmente la leyenda es adicionada solamente al cache de etiquetas, as que se debe invocar drawLabelCache() para actualizar la generacin.(A menos que el atributo postlabelcache este establecido, en tal caso es dibujado correctamente.) int embedScalebar(imageObj imagen) Embebe una barra de escala. Actualmente la leyenda es adicionada solamente al cache de etiquetas, as que se debe invocar drawLabelCache() para actualizar la generacin.(A menos que el atributo postlabelcache este establecido, en tal caso es dibujado correctamente.) int drawLabelCache(imageObj imagen) Dibuja las etiquetas para un mapa. Retorna 1 si hay error. layerObj getLayer(int index) Retorna un objeto layerObj del mapa dado un valor de ndice(0 = primer capa). layerObj getLayerByName(string nombre_capa) Retorna un objeto layerObj del mapa dado un nombre de capa. colorObj getcolorbyindex(int iCloIndex) Retorna un objeto colorObj correspondiente al ndice del color en la paleta.

void setextent(double minx, double miny, double maxx, double maxy) Establece la extensin del mapa usando la extensin georeferenciada pasada como argumento. void zoompoint(int nZoomFactor, pointObj oPixelPos, int nImageWidth, int nImageHeight, rectObj oGeorefExt) Realiza un Zoom a una posicio XY. Los parmetros son: - Zoom factor : Valores positivos hacen un acercamiento, valores negativos un alejamiento. Con un factor = 1 se recentra el mapa y con 0 se realiza un pan. - PxelPos (pointObj) : Coordenadas X,Y del click teniendo (0,0) la esquina superior izquierda. - Width : Ancho en pxel de la imagen actual. - Height : Alto en pxel de la imagen actual. - Georef extent (rectObj) : Extensin Actual georeferenciada. - MaxGeoref extent (rectObj) : (opcional) Mxima extensin. Si se introduce entonces ser imposible realizar un Zoom/Pan fuera de este rango. void zoomrectange(rectObj oPixelExt, int nImageWidth, int nImageHeight rectObj oGeorefExt) Establece la extensin del mapa a una extensin dada. Los parmetros son: PixelExt, con (0,0) como la esquina superior izquierda. Width : Ancho en pxel de la imagen actual. Height : Alto en pxel de la imagen actual. Georef extent (rectObj) : La extensin actual georeferenciada.

void zoomscale(int nScale, pointObj oPixelPos, int nImageWidth, int nImageHeight, rectObj oGeorefExt) Acerca o Aleja a una posicion XY luego el mapa se mostrar a una escala especificada Los parmetros son: - Scale : Escala a la que el mapa ser mostrado. - PxelPos (pointObj) : Coordenadas X,Y del click teniendo (0,0) la esquina superior izquierda. - Width : Ancho en pxel de la imagen actual. - Height : Alto en pxel de la imagen actual.

- Georef extent (rectObj) : Extensin Actual georeferenciada. - MaxGeoref extent (rectObj) : (opcional) Mxima extensin georeferenciada. Si se provee entonces ser imposible realizar un zomm/pan fuera de estas extensiones. int queryByPoint(pointObj point, int mode, double buffer) Consulta todas las capas seleccionadas en el mapa en la ubicacin del punto especificado en coordenadas de mapa georeferenciadas.(No en pxeles). La consulta se realiza sobre todos las figuras que hacen parte de una clase(CLASS) la cual contiene un valor de TEMPLATE o que coincide con cualquier clase en una capa que contenga un valor LAYER TEMPLATE. Se utiliza el modo MS_SINGLE o MS_MLTIPLE dependiendo del nmero de resultados que se desea obtener. Pasando como valor del buffer <=0 activa la tolerancia en el archivo de mapa(en pxeles) pero tambin se puede usar una constante (especificada en unidades de tierra). Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ). int queryByRect(rectObj rect) Consulta todas las capas en el mapa usando un rectangulo especificado en coordenadas de mapa georeferenciadas (no pxeles). La consulta se realiza sobre todos las figuras que hacen parte de una clase(CLASS) la cual contiene un valor de TEMPLATE o que coincide con cualquier clase en una capa que contenga un valor LAYER TEMPLATE. Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ). int queryByShape(shapeObj shape) Consulta todas las capas seleccionadas en el mapa basado en una simple figura, la figura debe ser un polgono a este punto. Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ). int queryByFeatures(int slayer) Realiza una consulta basada en un conjunto de resultados de una capa. Actualmente los resultados DEBEN estar basados en una capa tipo polgono. Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si

algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ). int save(string nombre_archivo) Guarda el estado del objeto de mapa actual a un archivo. Retorna 1 si hay error. char getProjection() Retorna una representacin en cadena de la proyeccin. Si no se establece ninguna proyeccin, se retorna MS_FALSE. int setProjection(string proj_params, boolean bSetUnitsAndExtents) Establece la proyeccin del mapa y el sistema de coordenadas. Los parmetros estn dados como una cadena simple delimitado por comas. El argumento: bSetUnitsAndExtents es usado para actualizar automticamente las unidades del mapa y extensiones basado en una nueva proyeccin. Los posibles valores son MS_TRUE y MS_FALSE. El valor por defecto es MS_FALSE. int getMetaData(string nombre) Trae la entrada de los metadatos por medio de un nombre(Almacenado en el objeto WEB del Mapfile). Retorna si no existe una entrada con ese nombre. La bsqueda es sensible a la escritura. int setMetaData(string nombre, string valor) Establece la entrada de un metadato para el mapa. (Almacenado en el objeto WEB del Mapfile). Retorna MS_SUCCESS/MS_FAILURE segn el caso. array getLayersIndexByGroup(string nombre_grupo) Retorna un arreglo conteniendo todos los ndices de las capas dados en un nombre de grupo. array getAllGroupNames() Retorna un arreglo conteniendo todos los nombres de grupo usados en las capas. array getAllLayerNames() Retorna un arreglo conteniendo todos los nombres de las capas. boolean moveLayerUp(int indice_capa) Mueve una capa una posicin arriba en la estructura jerrquica del Mapfile. boolean moveLayerDown(int indice_capa) Mueve una capa una posicin abajo en la estructura jerrquica del Mapfile.

array getlayersdrawingorder() Retorna un arreglo conteniendo los ndices de las capas en el orden en que aparecen en el Mapfile. boolean setlayersdrawingorder(array indice_capa) Establece el orden del arreglo de capas. El argumento pasado debe ser un arreglo valido con todos los ndices de las capas. Retorna TRUE si tuvo xito o sin retorna FALSE. char *processtemplate(array params, boolean generateimages) Procesa el archivo de plantilla especificado en el objeto web y retorna el resultado en un buffer. El procesado consiste en abrir el archivo de plantilla y reemplazar todas las etiquetas encontradas. Solo las etiquetas que tengan un elemento equivalente en el objeto de mapa son reemplazadas(ej. [scale]). Existen dos excepciones a la afirmacin anterior: - Las etiquetas [img], [scalebar], [ref], [legend] seran reemplazadas con la url apropiada si el parmetro generateimages se establece a MS_TRUE.(Nota: las imgenes correspondientes a objetos diferentes son generados si los objetos se establecen a MS_ON en el archivo de mapa). - Los usuarios pueden usar el parmetro params para especificar las etiquetas y sus valores. Por ejemplo si el usuario tiene una etiqueta especfica llamada [my_etiq] y la quiere reemplazar por valor de la etiqueta tendra que hacer: tmparray["my_etiq"] = valor de la etiqueta; $map->processtemplate($tmparray, MS_FALSE); char *processquerytemplate(array params) Procesa archivos de plantilla para consultas y retorna el resultado en un buffer. Vase tambin: funcin processtemplate char *processlegendtemplate(array params) Procesa archivos de plantilla para leyendas y retorna el resultado en un buffer. Vase tambin: funcin processtemplate int setSymbolSet(string nombre_archivo) Carga y establece dinmicamente un archivo de smbolos. int getNumSymbols() Retorna el nmero de smbolos de un mapa. int setFontSet(string fileName) Carga y establece un nuevo fonset.

Clase LayerObj: Constructor: Los objetos Layer pueden ser retornados por la clase MaoObj, o puede ser creado usando: layerObj ms_newLayerObj(MapObj mapa) Miembros: int numclasses (solo-lectura) int index (solo-lectura) int status (MS_ON, MS_OFF, MS_DEFAULT o MS_DELETE) string classitem string name string group string data int type double tolerance int toleranceunits double symbolscale double minscale double maxscale double labelminscale double labelmaxscale int maxfeatures int offsite int annotate int transform int labelcache int postlabelcache string labelitem string labelsizeitem string labelangleitem string tileitem string tileindex string header string footer string connection int connectiontype string filteritem string template

Mtodos: int set(string nombre_propiedad, nuevo_valor) Establece la propiedad especificada del objeto a un nuevo valor. Retorna 1 si hay error. int draw(imageObj imagen) Dibuja una capa simple, adiciona etiquetas. Retorna 1 si hay error. int drawQuery(imageObj imagen) Dibuja una consulta en el mapa para una capa simple. classObj getClass(int classIndex) Retorna un objeto classObj de una capa dada como un valor de ndice(0=primera clase) int queryByPoint(pointObj point, int mode, double buffer) Consulta todas las capas seleccionadas en el mapa en la ubicacin del punto especificado en coordenadas de mapa georeferenciadas.(No en pxeles). La consulta se realiza sobre todos las figuras que hacen parte de una clase(CLASS) la cual contiene un valor de TEMPLATE o que coincide con cualquier clase en una capa que contenga un valor LAYER TEMPLATE. Se utiliza el modo MS_SINGLE o MS_MLTIPLE dependiendo del nmero de resultados que se desea obtener. Pasando como valor del buffer <=0 activa la tolerancia en el archivo de mapa(en pxeles) pero tambin se puede usar una constante (especificada en unidades de tierra). Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ). int queryByRect(rectObj rect) Consulta todas las capas en el mapa usando un rectangulo especificado en coordenadas de mapa georeferenciadas (no pxeles). La consulta se realiza sobre todos las figuras que hacen parte de una clase(CLASS) la cual contiene un valor de TEMPLATE o que coincide con cualquier clase en una capa que contenga un valor LAYER TEMPLATE. Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ).

int queryByShape(shapeObj shape) Consulta todas las capas seleccionadas en el mapa basado en una simple figura, la figura debe ser un polgono a este punto. Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ). int queryByFeatures(int slayer) Realiza una consulta basada en un conjunto de resultados de una capa. Actualmente los resultados DEBEN estar basados en una capa tipo polgono. Retorna MS_SUCCESS si encontr figuras o MS_FAILURE si no encontr nada o si algn otro error ocurri(Cabe destacar que el mensaje de error en el caso de que no encuentre nada puede ser evitado en PHP usando el operador de control @ ). int setFilter(string expresion) Establece la expresin de filtro de una capa. char getProjection() Retorna una representacin de cadena de la proyeccin. Si no se se estableci ninguna, se retorna MS_FALSE. int setProjection(string proj_params) Establece la proyeccin del mapa y el sistema de coordenadas. Los parmetros estn dados como una cadena simple delimitado por comas. int getNumResult() Retorna el nmero de resultados de esta capa en la ltima consulta. resultCacheMemberObj getResult(int index) Retorna un objeto resultCacheMemberObj como ndice de un objeto de capa con el ndice en el rango numero_resultados-1. Retorna un objeto valido o FALSE(0) si el ndice es invalido. int open(string ruta_shape) Abre la capa para usar con getShape(). Retorna MS_SUCCESS/MS_FAILURE. void close() Cierra la capa previamente abierta con la funcin open(). shapeObj getShape(int tileindex, int shapeindex) Devuelve un objeto shapeObj de una capa por un ndice. El tileindex es usado para archivos shape recortados(se obtiene de el objeto resultCacheMemberObj

retornado por la funcin getResult() por ejemplo). Simplemente se pasa el tileindex = -1 para otras fuentes de datos. int addFeature(shapeObj shape) Adiciona una nueva figura en una cpa. Retorna 1 si hay error. int getMetaData(string nombre) Trae la entrada de los metadatos por medio de un nombre(Almacenado en el objeto WEB del Mapfile). Retorna si no existe una entrada con ese nombre. La bsqueda es sensible a la escritura. int setMetaData(string nombre, string valor) Establece la entrada de un metadato para el mapa. (Almacenado en el objeto WEB del Mapfile). Retorna MS_SUCCESS/MS_FAILURE segn el caso. int getWMSFeatureInfoURL(int clickX, int clickY, int featureCount, string infoFormat) Retorna una URL GetFeatureInfo de WMS(trabaja slo para capas WMS). Los parmetros ClickX y ClickY son las coordenadas de localizacin de la consulta en pxeles con (0,0) como la esquina superior izquierda de la imagen, featureCount es el nmero de resultados ha devolver y infoFormat es el formato en el cual el resultado debera ser consultado. Depende de las capacidades del servidor remoto. Los servidores WMS Mapserver soportan solo MIME (y debera soportar GML.1 pronto). Retorna y muestra un mensaje de advertencia si la capa no es una capa WMS o si no es consultable. char ** getItems() Retorna una lista de tems. Debe llamarse primero la funcin open(). Clase ClassObj: Constructor: Los objetos classObj pueden ser retornados por la clase LayerObj, o pueden ser creados usando: classObj ms_newClassObj(layerObj capa) Miembros: string name int type int status int color

(MS_ON, MS_OFF o MS_DELETE)

int backgroundcolor int outlinecolor int overlaycolor int overlaybackgroundcolor int overlayoutlinecolor int symbol string symbolname int size int minsize int maxsize int overlaysymbol string overlaysymbolname int overlaysize int overlayminsize int overlaymaxsize labelObj label Mtodos: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores. int setexpression(string expresion) Establece una cadena de expresin para el objeto clase. int settext(string texto) Establece la cadena de texto para el objeto clase. int drawLegendIcon(int width, int height, imageObj im, int dstX, int dstY) Dibuja el icono de la leyenda en un objeto imagen a una distancia en X y Y, segn los parmetros dstX y dstY. Retorna MS_SUCCESS/MS_FAILURE segn el caso. imageObj createLegendIcon(int width, int height) Dibuja el icono de la legenda y retorna un nuevo objeto de imagen. Clase ImageObj: Constructor: Las instancias de la clase ImageObj son siempre creadas por los mtodos de la clase Map.

Miembros: int width (solo-lectura) int height (solo-lectura) string imagepath string imageurl Mtodos: void free() Destruye los recursos utilizados por un objeto de imagen. int saveImage(string filename, int type, int transparent, int interlace, int quality) Escribe el objeto imagen a un archivo especfico. Pasando un nombre de archivo vaco. La salida se enva a stdout. En este caso la funcin PHP header() debera ser usada para establecer el tipo de contenido del documento antes de llamar saveImage(). El parmetro type puede ser MS_GIF, MS_PNG, MS_JPEG o MS_WBMP(dependiendo de que versin fue usada para compilar Mapscript). El parmetro quality debera ser un valor en el rango 0-95, valores ms altos implica una mayor calidad de la imagen y grandes tamaos de los archivos. Si la calidad es negativa, entonces el valor de la calidad por defecto de la IJG JPEG es usado. (El valor de calidad es ignorado para todos los otros formatos menos JPEG). La funcin retorna 1 si hay error. Si tuvo xito, retorna 0 si ha escrito a un archivo externo, o el nmero de bytes escritos si la salida es enviada a stdout. string saveWebImage(int type, int transparent, int interlace, int quality) Escribe una imagen a un archivo temporal. Retorna la URL de la imagen. El parmetro type puede ser MS_GIF, MS_PNG, MS_JPEG o MS_WBMP(dependiendo de que versin fue usada para compilar Mapscript). El parmetro quality debera ser un valor en el rango 0-95, valores ms altos implica una mayor calidad de la imagen y grandes tamaos de los archivos. Si la calidad es negativa, entonces el valor de la calidad por defecto de la IJG JPEG es usado. (El valor de calidad es ignorado para todos los otros formatos menos JPEG). void pasteImage(imageObj srcImg, int transparentColorIndex [, int dstX, dstY]) Copia la imagen que se encuentra en la ruta srcImg en la parte superior del objeto imageObj actual. El parmetro transparentColorIndex es el color de srcImg que se debera considerar transparente(esos pxeles no sern copiados).Pasando 1 no se pondr ningn color como transparente. Si se adiciona los parmetros opcionales dstx y dsty, entonces se define la posicin donde se debera copiar la imagen(dstx,dsty = coordenadas de la esquina superior izquierda)

Clase LabelObj: Constructor: Las instancias del la clase LabelObj estn siempre embebidas dentro de otras clases. Miembros: string font int type int color int outlinecolor int shadowcolor int shadowsizex int shadowsizey int backgroundcolor int backgroundshadowcolor int backgroundshadowsizex int backgroundshadowsizey int size int minsize int maxsize int position int offsetx int offsety double angle int autoangle int buffer int antialias int wrap int minfeaturesize int autominfeaturesize int mindistance int partials int force Mtodos: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores.

Clase webObj: Constructor: Las instancias del la clase webObj estn siempre embebidas dentro de la clase mapObj. Miembros: string log; string imagepath string template string imageurl string header string footer string empty (solo-lectura) string error (solo-lectura) string mintemplate string maxtemplate double minscale double maxscale rectObj extent (solo-lectura) Mtodo: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores. Clase referenceMapObj: Constructor: Las instancias del la clase referenceMapObj estn siempre embebidas dentro de la clase mapObj. Miembros: string image int width int height int status rectObj extent (solo-lectura) ColorObj color (solo-lectura) ColorObj outlinecolor (solo-lectura)

Mtodo: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores. Clase ColorObj: Constructor: Las instancias del la clase ColorObj estn siempre embebidas dentro de otras clases. Miembros: int int int red green blue

Mtodo: void setRGB(int rojo, int verde, int azul) Establece los valores para los colores rojo, verde y azul. Clase PointObj: Constructor: PointObj ms_newPointObj() Miembros: double x double y double m (usado para medida de archivos shape. Se coloca a 0 para otros tipos) Mtodos: int setXY(double x, double y, double m) Establece los valores de las coordenadas X y Y. Nota: el tercer parmetro m es usado para medida de archivos shape. No es necesario.

int draw(mapObj map, layerObj layer, imageObj img, int class_index, string text) Dibuja el punto individual usando una capa. El parmetro class_index es usado para clasificar el punto basado en las clases definidas por la capa. El parmetro cadena text es usado para anotar el punto. Retorna MS_SUCCESS/MS_FAILURE segn el caso. double distanceToPoint(pointObj poPoint) Calcula la distancia entre dos puntos. double distanceToLine(pointObject p1, pointObject p2) Calcula la distancia entre un punto y una lnea definida por los dos puntos pasados como argumentos. double distanceToShape(shapeObj shape) Calcula la distancia mnima entre un punto y una figura. projectionObj project(projectionObj in, projectionObj out) Proyecta el punto dentro de la proyeccin in(1 argumento) a la proyeccin out(2 argumento). void free() Descarga todos los recursos usados por el objeto. Clase LineObj: Constructor: LineObj ms_newLineObj() Miembros: int numpoints (solo-lectura)

Mtodos: int add(pointObj point) Adiciona un punto al final de la lnea. int addXY(double x, double y, double m) Adiciona un punto al final de la lnea. Nota: el 3er argumento m es usado para medir distancias en archivos shape. No es necesario.

PointObj point(int i) Retorna una referencia al punto nmero i. La referencia es vlida slo durante la vida del objeto lineObj que contiene el punto. projectionObj project(projectionObj in, projectionObj out) Proyecta el punto dentro de la proyeccin in(1 argumento) a la proyeccin out(2 argumento). void free() Descarga todos los recursos usados por el objeto. Clase RectObj: Constructor: Los objetos rectObj algunas veces estn embebidos dentro de otros objetos. Los nuevos pueden sin embargo ser creados con: RectObj ms_newRectObj() Miembros: double double double double Mtodos: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores. void setextent(double minx, double miny, double maxx, double maxy) Establece la extensin del rectngulo. int draw(mapObj map, layerObj layer, imageObj img, int class_index, string text) Dibuja el rectangulo individual usando una capa. El parmetro class_index es usado para clasificar el rectngulo basandose en las clases definidas por la capa. El parmetro cadena text es usado para rotular el polgono. Retorna MS_SUCCESS/MS_FAILURE segn el caso. minx miny maxx maxy

double fit(int width, int height) Ajusta la extensin del rectangulo para cuadrar con los parmetros width/height especificados. projectionObj project(projectionObj in, projectionObj out) Proyecta el punto dentro de la proyeccin in(1 argumento) a la proyeccin out(2 argumento). void free() Descarga todos los recursos usados por el objeto. Clase ResultCacheMemberObj: Constructor: Las instancias del objeto ResultCacheMemberObj son obtenidas siempre a travs del mtodo getResult() del objeto layerObj. Miembros: int int int shapeindex (solo-lectura) tileindex (solo-lectura) classindex (solo-lectura)

Clase ProjectionObj: Constructor: ProjectionObj ms_newprojectionobj(string projectionstring) Crea un nuevo objeto de proyeccin basado en la cadena de proyeccin pasada como argumento. Ejemplo: La sentencia $projInObj = ms_newprojectionobj("proj=latlong") crear una clase de proyeccin geogrfica. Ejemplo de uso, el siguiente ejemplo convertir un punto en coordenadas lat/long a una proyeccin LCC: $projInObj = ms_newprojectionobj("proj=latlong"); $projOutObj = ms_newprojectionobj("proj=lcc,ellps=GRS80,lat_0= 49,lon_0=-95,lat_1=49,lat_2=77"); $poPoint = ms_newpointobj(); $poPoint->setXY(-92.0, 62.0);

$poPoint = $poPoint->project($projInObj, $projOutObj); Clase scalebarObj: Constructor: Las instancias del objeto scalebarObj son embebidas siempre dentro de la clase mapObj. Miembros: int height; int width; int style; int intervals; int color; int backgroundcolor; int outlinecolor; int units; int status; //MS_ON, MS_OFF, MS_EMBED int position; //Para barras de escalas embebidas, MS_UL, MS_UC, ... int transparent; int interlace; int postlabelcache; labelObj label; colorObj imagecolor; Mtodos: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores. int setimagecolor(int rojo, int verde, int azul) Establece la propiedad imagecolor(fondo) del objeto. Retorna false cuando hay error. Clase LegendObj: Constructor: Las instancias del objeto legendObj son embebidas siempre dentro de la clase mapObj.

Miembros: int height; int width; int keysizex; int keysizey; int keyspacingx; int keyspacingy; int outlinecolor; //Color de la lnea externa de la caja, -1 para no colocarla. int status; //MS_ON, MS_OFF, MS_EMBED int position; //Para leyendas embebidas, MS_UL, MS_UC, ... int transparent; int interlace; int postlabelcache; //MS_TRUE, MS_FALSE labelObj label; colorObj imagecolor; string template Mtodos: int set(string nombre_propiedad, nuevo_valor) Establece una propiedad del objeto MAP a un nuevo valor. Retorna 1 si hay errores.