Version 1 (December, 2002)
© Pedro Pereira Gonçalves (pedro@inovagis.org)

Original File vecparam.htm
Abstract This web page sumarizes the GIServer parameters created to enhace the interactivity with the Web Map Server for Vectorial Data
Author Pedro Pereira Gonçalves (email)
Last Change
History 2002-11-12 : Adapted to inovaGIS version 3.2
2001-11-27 : Parameters added
2001-10-18 : File Created
Index Page GIServer tutorial
Important Links:


Apart from WMS parameters, the GIServer accepts layer-specific parameters. These parameters enhance the interactivity of the requests and give a direct linkage to the GIS data.
When requesting these parameters it is necessary to specify to which layer are they refering. For example, if the request is to drawn a borders layer with a PEN width of 2 pixels, it is necessary to specify :
    <dataset>.<layer>.STYLE = pen-width:2
Even if the GIServer parameters do NOT respect the WMS specification, all these non-WMS conformant parameters might be transformed in to style definition (see Styles and GIServer Parameters) For vectorial data the following parameters are defined:

.FIELD
This parameter is defines the associated database field to be used when accessing vectorial data. It can be a integer (defining the field number) or a string (defining the field's name).

REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.FIELD=NAME &
TERRA.BORDERS.STYLE=
brush-style:solid;color-linkage:text


.STYLE parameters
    These parameters define the way your geographic information should be painted. Each property should be separated by a ; and the assignment instructions is the : sign (as in the CSS of HTML where the property ':' S* value;). Several options exist, among the most important are :

  • color: <color value>
    Defines the color of the brush that will fill the polygons of vectorial files. It must be express in the Hex format, where for example 0xFFFFFF is white, 0x000000 is black, 0xFF0000 is red, 0x00FF00 is green and 0x0000FF is blue. Note: The format without the prefix 0x can also be used

  • brush-style: solid | clear | bdiagonal | fdiagonal | cross | diagcross | horizontal | vertical
    This parameter defines the pattern of the brush to be used to paint polygons.

    Example
    REQUEST=GETMAP&
    LAYERS=TERRA.BORDERS&
    BBOX=-10,30,70,70&
    SRS=EPSG:4326&
    WIDTH=300&
    HEIGHT=150&
    FORMAT=GIF&
    TERRA.BORDERS.STYLE=
    color:0x630000;brush-style:solid


  • brush-color: <color value>
    This parameter defines the color for the brush (equivalent to color)

  • pen-style: solid | dash | dot | dashdot | dashdotdot | null | inside
    This integer parameter defines pen style to be used to draw the lines.
    Example
    REQUEST=GETMAP&
    LAYERS=TERRA.BORDERS&
    BBOX=-10,30,70,70&
    SRS=EPSG:4326&
    WIDTH=300&
    HEIGHT=150&
    FORMAT=GIF&
    TERRA.BORDERS.FIELD=NAME&
    TERRA.BORDERS.STYLE=pen-style:null;brush-style:solid;color-linkage:text

  • pen-color: <color value>
    Defines the color of the pen that draws the lines and points of vectorial files. It must be express in the Hex format.

  • pen-width: <integer>
    Defines the width (in pixels) of the lines, or of the polygons borders, or in the case of point data the size of point.
  • label-color: <color value>
    Defines the color of the text on the label. It must be express in the Hex format.

  • label-field: <field name>
    Defines the field to be used with the label display. If none is defined then the active feature will be used.

  • label-visible: true | false or label-visibility: visible | hidden
    Sets the on or off the label display.

  • label-bgcolor: <color value>
    Defines the background color of the label. It must be express in the Hex format.

  • label-bordercolor: <color value>
    Defines the border color of the label. It must be express in the Hex format.

  • label-emboss: true | false
    Draws the label with the emboss style.

  • label-border: <integer>
    Defines the width in pixels of the labels border.


    Example
    REQUEST=GETMAP&
    LAYERS=TERRA.BORDERS&
    BBOX=-10,30,70,70&
    SRS=EPSG:4326&
    WIDTH=300&
    HEIGHT=150&
    FORMAT=GIF&
    TERRA.BORDERS.FIELD=NAME&
    TERRA.BORDERS.STYLE=
    pen-style:null;label-visible:true;brush-style:solid;color-linkage:text;label-border:1;label-bgcolor:F0F0F0;


  • font-family: <font name>
    Use Name to specify the typeface of the font. Note: If the combination of Name, CharSet, Pitch, and Size specifies a font that is not available on the system, Windows substitutes a different font.

  • font-size: <integer>
    Use Size to specify the point size of the font. If the value is negative, the internal leading that appears at the top of each line of text is included. If the value is positive, Size represents the height of the characters but not the internal leading. When the Size property has a positive value, the Height property has a negative value. When the Height property has a positive value, the Size property has a negative value.

  • font-bold: true | false
    Sets the font to be drawn in bold


  • font-weight: <integer 100-900> | thin | light | normal | demibold | bold | black
    The 'font-weight' property specifies the weight of the font (or its relative bold value).

  • font-italic: true | false
    Sets the font to be drawn in italic

  • font-underline: true | false
    Sets the font to be drawn underlined

  • font-strikeout: true | false
    Sets the font to be drawn strikeout


    Example
    REQUEST=GETMAP&
    LAYERS=TERRA.BORDERS&
    BBOX=-10,30,70,70&
    SRS=EPSG:4326&
    WIDTH=300&
    HEIGHT=150&
    FORMAT=GIF&
    TERRA.BORDERS.FIELD=NAME&
    TERRA.BORDERS.STYLE=
    pen-style:null;label-visible:true;brush-style:solid;color-linkage:text;font-family:verdana;font-weight:bold;font-size:12



.QUERY
This string parameter will execute a query to the associated database in the vectorial file and will only draw the records resulting from that query. It accepts the following mathematical operations: TRUNC, ROUND, ABS, ARCTAN, COS, EXP, FRAC, INT, LN, PI, SIN, SQR, SQRT, POWER. In relation to strings it accepts the following functions: UPPER, LOWER, COPY, POS, LENGTH. Bitwise operations are also valid.
REQUEST=GETMAP&
LAYERS=TERRA.BORDERS&
BBOX=-10,30,70,70&
SRS=EPSG:4326&
WIDTH=300&
HEIGHT=150&
FORMAT=GIF&
TERRA.BORDERS.STYLE=pen-style:null;brush-style:solid;color-linkage:text&
TERRA.BORDERS.FIELD=NAME&
TERRA.BORDERS.QUERY=



See also: