GvSIG Mobile Pilot 0 3 Man v1 en

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 78

gvSIG Mobile 0.3. User Manual.

gvSIG Mobile
User Manual. Version 0.3

2007 Conselleria de Infraestructuras y Transporte

Page 1 de 78

gvSIG Mobile 0.3. User Manual.

Conselleria de Infraestructuras y Transporte C/ Blasco Ibez N 0 ! "#0$0 %&'(NCI&

()*ail + ,-si,.,-a/es 0eb+ 111/cit/,-a/es

0eb del proyecto+ 2ttp+//111/,-si,/,-a/es Todos los nombres propios de programas, sistemas operativos, equipo hardware etc.., que aparecen en este manual son marcas registradas de sus respectivas compaas u organizaciones. 'ste manual se distribu&e con la licencia ()* (P+!.
!""7 #onselleria de $n%raestructuras & Transporte

1,-".-1"

P/gina ! de 78

gvSIG Mobile 0.3. User Manual.

Table of contents
$ntroduction..............................................................................0 (etting started with gv1$( 2obile................................................0 Pro3ect management..................................................................4 +a&er management....................................................................8 5ata access %ormats.................................................................1! (raphical navigation tools.........................................................10 1electing %eatures and quer&ing attributes...................................14 (P1 support............................................................................18 'diting la&ers..........................................................................!! 6ppendi7 68 Portabilit& and data integration with gv1$( 5es9top....!: 6ppendi7 ;8 Personal %orms.......................................................!8

Introduction
This guide provides detailed in%ormation on gv1$( 2obile and will allow &ou to use the program to its %ull potential.

Getting started wit

gvSIG Mobile

6 new session o% gv1$( 2obile can be started b& per%orming the %ollowing steps8

1tart the mobile device <P56=. >pen the ?indows 2obile start menu and loo9 %or the gv1$( 2obile icon. #lic9 on the icon to launch the gv1$( 2obile application.

2007 Conselleria de Infraestructuras y Transporte

Page 0 de 78

gvSIG Mobile 0.3. User Manual.

Starting the gvSIG Mobile application The application has a vertical Main Toolbar !"# with icons representing groups o% %unctions, and a horizontal Secondary Toolbar !$#, which shows the speci%ic tools o% whichever icon is selected on the main toolbar. Main Toolbar8

Pro3ect tools. (P1 tools. +a&er management tools. )avigation tools. $n%ormation tools. 'diting tools.

>n the right@hand side o% the secondar& bar is a small button !3# that displa&s a drop@down menu containing in%ormation on each o% the tools on the secondar& toolbar. Aeatures on this drop@menu can be run b& clic9ing on the relevant icon. The application also contains a View !%# where the maps are displa&ed, and a Status &ar !'#.

1,-".-1"

P/gina . de 78

gvSIG Mobile 0.3. User Manual.

A view of the gvSIG Mobile application

(ro)ect *anage*ent
6 gv1$( 2obile pro3ect is the environment or base document used to con%igure, manage and store the geographic in%ormation %rom a particular wor9 session. 6%ter starting gv1$( 2obile, clic9 (ro)ect Tools !"# on the main toolbar to displa& the pro3ect management tools on the secondar& toolbar.

2007 Conselleria de Infraestructuras y Transporte

Page 4 de 78

gvSIG Mobile 0.3. User Manual.

Project management tools +ew (ro)ect To start wor9ing with gv1$( 2obile a new pro3ect must be created b& clic9ing the +ew (ro)ect... button !"#. This will create a new pro3ect, or close the e7isting pro3ect and create a new one. The de%ault properties o% a new pro3ect can be set in the View tab !3# o% the ,pplication Setup... !$#. Bere it is possible to de%ine the spatial re%erence s&stem, the path to the pro3ect %iles, the bac9ground colour o% the view, and the ma7imum and minimum e7tents o% the pro3ect.

1,-".-1"

P/gina : de 78

gvSIG Mobile 0.3. User Manual.

Create a new project -pen (ro)ect 6 previousl& saved gv1$( 2obile pro3ect can be opened b& clic9ing the -pen (ro)ect... button !"#. This opens a standard ?indows 2obile >pen Aile dialog %rom where a pro3ect %ile <(C2= can be selected.

2007 Conselleria de Infraestructuras y Transporte

Page 7 de 78

gvSIG Mobile 0.3. User Manual.

Open an existing project Save (ro)ect #lic9 the Save (ro)ect... button !"# to save the pro3ect con%iguration and all the re%erences to the pro3ect data. The &asic tab o% the (ro)ect (roperties %orm <shown below= provides space to enter the name o% the new pro3ect, the storage location <path=, and a description o% the pro3ect.

Save the project Save (ro)ect ,s $t is possible to save a cop& o% the current pro3ect with a new name b& clic9ing the Save (ro)ect ,s... button !"#. $n the (ro)ect (roperties %orm enter the pro3ect name and storage location.

1,-".-1"

P/gina 8 de 78

gvSIG Mobile 0.3. User Manual.

Save the project with a new name (ro)ect (roperties 6 gv1$( 2obile pro3ect contains a number o% properties that can be viewed and modi%ied. These are accessed b& clic9ing the (ro)ect (roperties... button !"#. This opens the pro3ect properties dialog, which contains two tabs.

Project properties dialog The &asic tab contains the %ollowing in%ormation8
2007 Conselleria de Infraestructuras y Transporte

Page , de 78

gvSIG Mobile 0.3. User Manual.

+a*e. The name o% the pro3ect. (at . The director& path where the pro3ect is saved. .escription. 6 description o% the pro3ect. Created. The date that the pro3ect was created. Updated. The date that the pro3ected was last updated. S/S. The spatial re%erence s&stem. &g color. The bac9ground colour o% the view. 0!*in1*a2#. The range o% the 7@coordinates. 3!*in1*a2#. The range o% the &@coordinates.

The View tab contains the %ollowing in%ormation8


,pplication Setup $t is also possible to de%ine the de%ault properties %or new pro3ects. These can be accessed b& clic9ing the ,pplication Setup... button !"#, which opens a dialog bo7 with three tabs. *nder the View tab !$# the S/S, (at , &ac4ground colour, 0!*in1*a2# and 3!*in1*a2# properties can be de%ined.

Defa lt project properties Set default pro)ect gv1$( 2obile allows a de%ault pro3ect to be de%ined. $n this wa&, a previousl& de%ined pro3ect is loaded on start up, thereb& speeding up the commencement

1,-".-1"

P/gina 1" de 78

gvSIG Mobile 0.3. User Manual.

o% the wor9 session. The de%ault pro3ect settings can be %ound b& clic9ing the ,pplication Setup... button !"# and then selecting the Startup pro)ect tab !$#. 'nable the ,ctive chec9 bo7 and then provide the 5ull (at to the de%ault pro3ect.

Setting a defa lt project .efining general application settings The application language !"# can be set under the General tab in ,pplication Settings. gv1$( 2obile is available in 'nglish <en=, 1panish <es=, Arench <%r=, $talian <it= and (erman <de=. $% a new de%ault language is chosen, the application must be restarted %or the changes to ta9e e%%ect. $t is also possible to choose between two icon sets %or gv1$( 2obile !$#, namel& !.7!. and .87.8 pi7els. The de%ault size is !.7!., which is suitable %or devices with low resolution screens o% less than .8" pi7els wide. $% the mobile device <P56= supports higher resolutions, the .87.8 icon set can be chosen. 6arning7 $% the icon set is changed to .87.8 and the mobile device does not support the new setting, the previous setting o% !.7!. will not be automaticall& restored. To restore the setting edit the %ile Dgv1$(2obile-persistence-appsettings.7mlD and manuall& change the icon set bac9 to img!..

2007 Conselleria de Infraestructuras y Transporte

Page 11 de 78

gvSIG Mobile 0.3. User Manual.

Defining general properties for gvSIG Mobile 82it The 82it button !"# closes the current pro3ect <prompting the user to save an& changes= and then e7its gv1$( 2obile.

!xit gvSIG Mobile


1,-".-1" P/gina 1! de 78

gvSIG Mobile 0.3. User Manual.

9ayer *anage*ent
>nce the wor9 environment has been created, there are a number o% tools that can be used to manage the di%%erent la&ers o% in%ormation displa&ed in gv1$( 2obile. To access them clic9 the 9ayer Manage*ent Tools icon !"# on the main toolbar. This opens the secondar& toolbar, which contains a number o% la&er management tools.

"a#er management toolbar ,dd layer )ew la&ers can be added directl& %rom the secondar& tool bar la&er b& clic9ing the ,dd Vector 9ayer ... !"#, ,dd /aster 9ayer ... !$#, or ,dd 6MS !3# buttons. $t is also possible to add new la&ers to the pro3ect %rom the Table o% #ontents window, which can be opened b& clic9ing the Table of Contents... button !%#. This window shows all the la&ers that are currentl& loaded in the pro3ect. This manager has, amongst others, the same buttons %or adding la&ers that can be %ound on the secondar& toolbar mentioned above.

2007 Conselleria de Infraestructuras y Transporte

Page 10 de 78

gvSIG Mobile 0.3. User Manual.

Add new la#ers to the project

1,-".-1"

P/gina 1. de 78

gvSIG Mobile 0.3. User Manual.

Add la#ers from the $able of Contents ,dd 6MS service 6dding a ?21 service la&er to the pro3ect is done via the 6MS 9ayer -ptions dialog, where a ?21 server can be selected %rom the drop@down list o% Servers !"#. )ew services can be added b& t&ping the web address in the -t er bo7 !$# and clic9ing the 6dd button. ?hen a new service is added in
2007 Conselleria de Infraestructuras y Transporte

Page 14 de 78

gvSIG Mobile 0.3. User Manual.

this manner the #apabilities o% the service will be requested. The re%erence s&stem o%%ered b& the service can be selected %rom the S/S list !3# while the %ormat o% the image being selected is set in the 5or*at list !%#. The botto* window !'# provides a listing o% the la&ers in the service and allows the la&ers o% interest to be selected.

%orm for adding a &MS la#er .elete layer +a&ers can be removed %rom the pro3ect b& accessing the Table o% #ontents, selecting the la&er to be deleted !"#, and clic9ing the .elete 9ayer button !$#.

1,-".-1"

P/gina 1: de 78

gvSIG Mobile 0.3. User Manual.

Delete a la#er from the project 9ayer properties 6nother %eature o% the Table o% #ontents is that the properties o% an& o% the la&ers in the pro3ect can be viewed and con%igured. Airst select the la&er !"# and then clic9 the 9ayer (roperties button !$# to displa& the 9ayer (roperties dialog. Arom here the properties can be viewed and modi%ied.

+a*e. +a&er name 5ile. Path and %ile name o% the la&er Visible. $ndicates whether the la&er is visible in the pro3ect or not !3# Infoable. $ndicates whether the attributes associated with the la&er can be viewed !%# (ersonal 5or*. 6 custom %orm used to displa& the attributes o% the speci%ic la&er !'#. Tic9 the chec9 bo7 and provide the path to the %orm, which should be de%ined in an 'xml %ile. Personal %orms are described in more detail later on in this manual Ma2 scale. $ndicates the ma7imum scale o% the la&er !:# Min scale. $ndicates the minimum scale o% the la&er !:# Co**ent. 6 space %or providing in%ormation about the la&er

2007 Conselleria de Infraestructuras y Transporte

Page 17 de 78

gvSIG Mobile 0.3. User Manual.

(iew and modif# la#er properties 1ome o% the la&er properties, such as their visibilit& in the view, access to attribute in%ormation, or displa& scales, are shown alongside each la&er in the Table o% #ontents. 9ayer visibility The la&ers in a pro3ect can be switched on or o%% as needed. This is controlled %rom the Table o% #ontents where a chec9 bo7 ne7t to each la&er indicates whether it is visible or hidden in the pro3ect view. The la&er visibilit& can also be controlled %rom the 9ayer (roperties %orm using the Visible chec9 bo7. Scale dependent visibility $t is possible to de%ine a visibilit& range %or a la&er based on the current scale in the view. The visibilit& range can be set in the +a&er Properties %orm b& entering values %or the Ma2 and Min Scales. $% visibilit& ranges have been de%ined %or a la&er then this is indicated b& the presence o% a small icon in the Table o% #ontents. $% the scale bar icon is active !"# then the current scale o% the Ciew allows visualisation o% the la&er, while an inactive icon !$# indicates that the la&er is not displa&ed because the Ciew scale is outside the scale range de%ined %or the la&er.

1,-".-1"

P/gina 18 de 78

gvSIG Mobile 0.3. User Manual.

"a#er visibilit# indicated b# the scale bar icon Infoable 6nother la&er propert& that can be de%ined is whether or not their associated attributes are shown. This propert& can be set either in the 9ayer (roperties %orm or via the chec9 bo7 in the Table of Contents. ?hen quer&ing la&ers using the (et $n%ormation tool, gv1$( 2obile opens a new window containing the relevant %eature attributes i% the in%oable propert& o% the la&er has been enabled. .isplay order There are two buttons on the side toolbar o% the Table o% #ontents that manipulate the displa& order o% the pro3ect la&ers. The green up arrow !"# moves the selected la&er up one place in the displa& order, while the red down arrow !$# moves the la&er down one place in the displa& order.

2007 Conselleria de Infraestructuras y Transporte

Page 1, de 78

gvSIG Mobile 0.3. User Manual.

Ordering the la#ers within the project Si*plified layer sy*bology This tool is used de%ine the s&mbolog& o% a pro3ect la&er. To edit the s&mbolog& select a la&er in the Table o% #ontents !"# and press the 9ayer Sy*bology button !$#. The +a&er 1&mbolog& %orm <shown below= allows the s&mbolog& attributes o% a vector la&er to be edited8

1,-".-1"

P/gina !" de 78

gvSIG Mobile 0.3. User Manual.

Accessing the "a#er S#mbolog# form

(oint layers !3# Si;e. 1ize o% the points Colour. #olour o% the points 9ine and polyline layers !%# 9ine widt . ?idth o% the lines Colour. #olour o% the lines (olygon layers !*ulti<layer geo*etries# !'# 9ine widt . ?idth o% the pol&gon border &order colour. #olour o% the pol&gon border 5illed. $ndicates whether the pol&gon is %illed 5ill Colour. Aill colour o% the pol&gon

2007 Conselleria de Infraestructuras y Transporte

Page !1 de 78

gvSIG Mobile 0.3. User Manual.

S#mbolog# for points) lines and pol#gons 82porting vector layers ?ith the 82port to Vector 5ile utilit& !"# an& vector la&er loaded in the Table o% #ontents can be selected !$# and e7ported to another supported vector %ormat b& either creating a new %ile or b& overwriting an e7isting one. The available vector %ormats are GM9 !Geograp ic Mar4up 9anguage# in two di%%erent versions <!.7 and 0.!=, =M9 !=ey ole Mar4up 9anguage# and S>( !S apefile# !3#.

1,-".-1"

P/gina !! de 78

gvSIG Mobile 0.3. User Manual.

!xporting a vector la#er Capture a screens ot This utilit& captures a screenshot o% the map displa&ed in the Ciew on the device !"#.

Capt ring a screenshot of the (iew

.ata access for*ats


gvSIG Mobile is currentl& capable o% wor9ing with local or remote geographic data in vector or raster %ormat. 6s shown above, new la&ers can be added to the pro3ect %rom two di%%erent locations in the application. The& can either be added directl& %rom the +a&er 2anagement Tools secondar& toolbar, or the& can be added b& choosing options %rom the drop@down list on the right@hand side o% the secondar& toolbar. $n both cases the %ollowing buttons are available8 ,dd vector layer, ,dd /aster 9ayer, ,dd 6MS. Vector .ata

!5 and 05 Point and 2ultipoint 1hape%iles !5 and 05 +ine and Pol&line 1hape%iles !5 and 05 Pol&gon and 2ultiPol&gon 1hape%iles 2ulti(eometr& version !.7 and 1AP <1imple Aeatures Pro%ile= version 0.! (2+ <(eographic 2ar9up +anguage= %iles 2ulti(eometr& version !.1 E2+ <Ee&map 2ar9up +anguage= %iles
Page !0 de 78

2007 Conselleria de Infraestructuras y Transporte

gvSIG Mobile 0.3. User Manual.

Point and Trac9 (PF <(Ps eFchange= %iles '#? ($A <with .wld %ile= GP'( <with .wld %ile= ?21 <?eb 2ap 1ervice=

/aster .ata

-GC /e*ote Services

Grap ical navigation tools


gv1$( 2obileHs various navigation tools allow the user to view the pro3ectHs graphical in%ormation at var&ing levels o% detail, ma9ing the browsing o% di%%erent locations eas& and convenient. $n addition to providing a variet& o% navigation %unctions, gv1$( 2obile also ta9es advantage o% the navigation buttons on the mobile device itsel%. To begin browsing through the di%%erent la&ers in the pro3ect, select the +avigation Tools button !"# %rom the main toolbar. This brings up the secondar& bar containing the various navigation tools.

*avigation tools

1,-".-1"

P/gina !. de 78

gvSIG Mobile 0.3. User Manual.

?oo* by rectangle This tool allows a zoom area to be de%ined b& drawing a rectangle around the area o% interest. 1elect the ?oo* /ectangle button !"# to activate the tool and then draw a rectangle around the desired area to zoom in to it. The tool remains active and can be used repeatedl& until it is deactived b& clic9ing on the ?oo* /ectangle button once more.

Drawing a +oom rectangle in the view 5i2ed ;oo* in #lic9ing the ?oo* in button !"# zooms in to the Ciew b& a %i7ed amount, thereb& increasing the level o% detail each time the button is clic9ed.

2007 Conselleria de Infraestructuras y Transporte

Page !4 de 78

gvSIG Mobile 0.3. User Manual.

,oom in increases the level of detail 5i2ed ;oo* out The ?oo* out button !"# decreases the level o% detail b& reducing the displa& scale each time the button is clic9ed.

1,-".-1"

P/gina !: de 78

gvSIG Mobile 0.3. User Manual.

,oom o t decreases the level of detail (an and recentre ;& using the (an tool !"# to drag the map around, the user can interactivel& recentre the map without changing the scale. #lic9ing on the map with the /ecentre tool !$#, on the other hand, causes the Ciew to be recentred on the point clic9ed b& the user, also without changing the scale.

-rowse f nctionalit# with Pan and .ecentre ?oo* to full e2tent #lic9ing the ?oo* 82tension button !"# will result in the Ciew zooming out to the %ull e7tent o% all the di%%erent la&ers in the pro3ect.

2007 Conselleria de Infraestructuras y Transporte

Page !7 de 78

gvSIG Mobile 0.3. User Manual.

,oom to the f ll extent of all the project/s la#ers ?oo* previous and ?oo* ne2t The ?oo* previous button !"# returns to the previous displa& in the Ciew, while the ?oo* ne2t button !$# advances to the ne7t displa&.

1,-".-1"

P/gina !8 de 78

gvSIG Mobile 0.3. User Manual.

,oom to the previo s or to the next displa# ?oo* to selection The ?oo* to selection button !"# is %ound on the Infor*ation tools toolbar, which can be accessed %rom the main toolbar. #lic9ing this tool will cause the Ciew to zoom to selected %eatures in the pro3ectHs vector la&ers.

,oom to selected items ?oo* to layer The ?oo* to layer %unction !"#, located in the sidebar o% the Table of Contents, %ocusses the Ciew on the currentl& selected la&er. ?hen this tool is selected the Table o% #ontents window is closed and the Ciew is zoomed to the %ull e7tent o% the selected la&er.

2007 Conselleria de Infraestructuras y Transporte

Page !, de 78

gvSIG Mobile 0.3. User Manual.

,oom to the la#er/s extent Centre View to G(S location ?ith this utilit& the user can con%igure the Ciew to update and %ocus on the (P1 position automaticall&. To activate this utilit& select G(S tools on the main toolbar and then clic9 the G(S Setup... button on the secondar& toolbar. This opens the (P1 Pre%erences %orm, which contains several tabs. The .isplay tab contains various options %or con%iguring the (P1 displa&8

/ecentre. 6utomaticall& recentres the Ciew based on the (P1 position. S ow icon. 5ispla&s an icon indicating the (P1 position. S ow icon and recentre. #ombines the previous two options.

1,-".-1"

P/gina 0" de 78

gvSIG Mobile 0.3. User Manual.

*avigate with GPS positioning

Selecting features and @uerying attributes


The select and quer& tools provide a means o% obtaining in%ormation about the various la&ers in the pro3ect. To activate these tools, clic9 the Infor*ation Tools button !"# on the main toolbar in order to displa& the secondar& toolbar containing the $n%ormation %unctions.

2007 Conselleria de Infraestructuras y Transporte

Page 01 de 78

gvSIG Mobile 0.3. User Manual.

Information toolbar -btain infor*ation about a feature This quer& tool is used to displa& in%ormation about %eatures in the pro3ectHs la&ers. *sing the Get Infor*ation button !"#, clic9 on a point in the Ciew to obtain in%ormation on the %eature<s= at that position. This opens the Infor*ation by point %orm !$#, which displa&s in%ormation on the %eatures intersecting the point that was clic9ed. )ote that the quer& button retains its active or inactive state until clic9ed again <clic9ing the button toggles between these two states=. ?ith the button in its active state the Ciew can be queried multiple times. $% the position queried contains no %eatures then nothing will be displa&ed. $% the la&er being queried is a raster la&er then the in%ormation will be displa&ed in the %ormat shown in the %igure below.

1,-".-1"

P/gina 0! de 78

gvSIG Mobile 0.3. User Manual.

0 er#ing a raster la#er Bowever, i% the queried position contains at least one vector la&er with editable attributes, then a %orm is displa&ed. $% the %irst la&er intersected b& the quer& point has a personal %orm, then this is the %orm that is displa&ed. $% the la&er is not editable, the in%ormation displa&ed in the %orm cannot be changed and is displa&ed in a grey colour !3#. Bowever, i% the la&er is editable, then the %ields in the %orm can be edited and will be displa&ed in blac4 !%#. The %igure below gives e7amples o% the same in%ormation displa&ed in both a Standard 5or* !'# and a (ersonal 5or* !:#. )ote that this %igure illustrates the %orms displa&ed when the Get Infor*ation tool is used to quer& a vector la&er.

2007 Conselleria de Infraestructuras y Transporte

Page 00 de 78

gvSIG Mobile 0.3. User Manual.

%o r different formats for displa#ing information abo t a 1 eried vector feat re +-T87 The in%ormation displa&ed b& gvSIG Mobile (ilot version 2'3 when vector la&ers are queried depends on the %ollowing8

?hen clic9ing on the view, the in%ormation 4if an#5 that is displa&ed corresponds to the %eature intersecting the point that was clic9ed. The order o% the la&ers in%luences the in%ormation that is displa&ed.

1,-".-1"

P/gina 0. de 78

gvSIG Mobile 0.3. User Manual.

(eometr& is onl& shown %or the uppermost la&er that intersects the quer& point. $n%ormation is not displa&ed %or other %eatures intersecting the quer& point <The previous version o% gv1$( 2obile did loo9 at %eatures %rom la&ers lower down in the CiewHs la&er order=. To obtain in%ormation about %eatures in lower la&ers obscured b& upper la&ers it is necessar& to either change the la&er order in the Table o% contents, or to disable the $n%oable chec6boxes o% the upper la&ers.

The 8diting 9ayers section provides more in%ormation about Vector 5or*s, while ,ppendi2 & e7plains how to create (ersonal 5or*s. View coordinates The View Coordinates tool !"# displa&s the coordinates o% points clic9ed in the Ciew. These coordinates are displa&ed in the status bar !$# at the bottom o% the Ciew. This tool remains active until deselected, allowing multiple coordinate queries to be made.

Displa#ing the coordinates of a point clic6ed in the (iew Measure .istance This tool is used to measure distances on the map. >nce the tool is activated b& pressing the Measure .istance button !"#, distances between points
Page 04 de 78

2007 Conselleria de Infraestructuras y Transporte

gvSIG Mobile 0.3. User Manual.

clic9ed in the Ciew are displa&ed in the status bar. #lic9ing a series o% points de%ines a pol&line, and the status bar displa&s both the total distance !$# o% the pol&line and the length o% the last segment !3#. The 2easure 5istance button remains active once selected, allowing repeated distance measurements to be made and the results displa&ed in the status bar. To deactivate the tool clic9 the Measure .istance button again.

Meas ring distances Measure area This tool is used to measure areas on the map. 6ctivate the tool b& clic9ing the Measure ,rea button !"# and then in the Ciew clic9 the vertices o% the pol&gon to be measured. The area o% the pol&gon !$# will be displa&ed in the status bar at the bottom o% the screen. +i9e the 2easure 5istance tool, the 2easure 6rea tool also has an active and an inactive state. >nce activated it will remain active allowing area measurements to made until the tool is deactivated b& clic9ing on it again.

1,-".-1"

P/gina 0: de 78

gvSIG Mobile 0.3. User Manual.

Meas ring areas Searc by ,ttributes This %eature queries the attributes o% a vector la&er in order to locate records meeting certain criteria. #lic9ing the Searc by ,ttributes... button !"# opens the Searc by attribute value %orm, which contains the %ollowing %ields8

9ayer. 1elect the la&er to quer& %rom the list o% la&ers in the pro3ect. Colu*n. 1elect the attribute column in which to conduct the search. -p. 1elect the quer& operator. Value. 'nter the value to search %or in the selected attribute column.

2007 Conselleria de Infraestructuras y Transporte

Page 07 de 78

gvSIG Mobile 0.3. User Manual.

Search the attrib tes in a la#er Select features This tool is used to select geometries !"# in a vector la&er. ?hen using this tool, onl& one vector la&er must be mar9ed selectable <in%oable= in the Table of Contents.

Select by point. !$# 1elect a geometr& <%eature= b& clic9ing on it in the Ciew. The selected geometr& will be highlighted in &ellow. Select by rectangle. !3# 1elect a set o% geometries b& drawing a selection rectangle in the Ciew. (eometries wholl& or partiall& within the selection rectangle will be selected. The selected geometries will be highlighted in &ellow. Clear selection. !%# 5eselect all geometries and restore their original colour.

1,-".-1"

P/gina 08 de 78

gvSIG Mobile 0.3. User Manual.

Selecting feat res in a vector la#er

G(S support
gv1$( 2obile provides %acilities %or displa&ing the position o% a (P1 device, capturing points o% interest <wa&points= and recording routes <trac9logs=. #lic9ing the G(S Tools button !"# on the main toolbar opens the secondar& toolbar, which shows buttons %or con%iguring the (P1, chec9ing signal strength, displa&ing the (P1 position, etc..

2007 Conselleria de Infraestructuras y Transporte

Page 0, de 78

gvSIG Mobile 0.3. User Manual.

$he GPS toolbar G(S Setup *tilities and parameters %or con%iguring the (P1 connection.

Configuring t e G(S To con%igure the connection to a (P1 device, select the G(S Setup... button !"#. This opens the G(S (references %orm as shown below. *nder the .evice tab, the %irst parameter that needs to be set is the communication protocol. This is selected %rom the (rotocol drop@down list !$# <6t present onl& the )2'6 "180 protocol is supported=. The ne7t setting speci%ies whether (P1 signals are to be received %rom an active (P1 <1erial device=, or whether the (P1 device will be simulated b& using data %rom a te7t %ile containing )2'6 (P1 data <1imulated device=.

1,-".-1"

P/gina ." de 78

gvSIG Mobile 0.3. User Manual.

Config ring the connection to the GPS device $% a Serial .evice !3# is speci%ied, the (ort na*e and &aud rate are selected %rom the respective drop@down lists. $% the Si*ulated device !%# option is chosen, then the name o% the )2'6 data %ile is entered in the 5ile na*e te7t bo7 and the time interval between signals is speci%ied in the (eriod!*s# bo7. The 9ogging tab is used to speci%& the %ormat and %ile names %or the wa&points and trac9points !"# . Two %ormats are currentl& supported, namel& (PF and #1C. $n the 9ogging 5ile +a*es section !$# the names o% the trac9log %ile, wa&points %ile and raw )2'6 data %ile can be speci%ied. The Stop logging w en *ini*i;ed option !3# is used to suspend recording in the logging %iles when the application is not visible on the screen o% the mobile device.

2007 Conselleria de Infraestructuras y Transporte

Page .1 de 78

gvSIG Mobile 0.3. User Manual.

"ogging format and logging file names The .isplay tab is used to control how the (P1 icon is displa&ed. There are options %or recentring the Ciew based on the (P1 position !"#, displa&ing the (P1 icon !$#, or a combination o% these two options.

Parameters for controlling the displa# of the GPS position

1,-".-1"

P/gina .! de 78

gvSIG Mobile 0.3. User Manual.

Connect to G(S To activate the (P1 signal the mobile device must either have an active internal (P1, or a ;luetooth connection to an e7ternal (P1. The connection is activated when the ConnectA.isconnect button !"# is clic9ed.

Activating the GPS signal

.isconnect fro* t e G(S #lic9 the ConnectA.isconnect button !"# again to deactivate the (P1 signal.

2007 Conselleria de Infraestructuras y Transporte

Page .0 de 78

gvSIG Mobile 0.3. User Manual.

Deactivating the GPS signal G(S +avigation

.isplay G(S position ?hen the .isplay (osition button !"# is activated a small icon !$# indicating the (P1 position is displa&ed in the Ciew. This displa& icon can be turned o%% b& clic9ing the 5ispla& Position button again.

1,-".-1"

P/gina .. de 78

gvSIG Mobile 0.3. User Manual.

Displa#ing the GPS position

.isplay G(S coordinates in real<ti*e The .isplay Coordinates tool !"# displa&s the real@time coordinates o% the (P1 position in the toolbar !$#. The units o% the coordinates depend on the coordinate s&stem that has been de%ined.

2007 Conselleria de Infraestructuras y Transporte

Page .4 de 78

gvSIG Mobile 0.3. User Manual.

Displa# real7time GPS coordinates

View G(S activity This %eature displa&s various parameters providing in%ormation on the (P1 signal and its qualit&. The %eature is activated b& clic9ing the View G(S ,ctivity button !"#. This open the G(S ,ctivity %orm, which contains several tabs8

Satellites. 1hows the satellites that are visible and the qualit& o% the signal being received b& the (P1 receiver. .ata. 5ispla&s a number o% parameters on the (P1 position and the qualit& o% that position. Console. 5ispla&s a plot o% the )2'6 (P1 signal.

(iew GPS activit#

1,-".-1"

P/gina .: de 78

gvSIG Mobile 0.3. User Manual.

Information on the GPS signal $n addition, when the (P1 receiver is connected to the mobile device, a set o% icons !"# is displa&ed in the status bar at bottom right providing in%ormation about the qualit& o% the signal reception, the number o% visible satellites and the connection status.

0 alit# of the GPS signal


2007 Conselleria de Infraestructuras y Transporte

Page .7 de 78

gvSIG Mobile 0.3. User Manual.

Capturing G(S positions *sing the +ew 6aypoint button !$# it is possible to capture wa&points. The %ull path <trac9log= can be captured b& activating the StartAStop Trac4log button !"#. #lic9ing this button again stops the recording o% the trac9log. )ote that these tools record the trac9log and wa&points in di%%erent te7t %iles <as de%ined under the (P1 Pre%erences described above=. ?hen a new wa&point is de%ined the +ew 6aypoint %orm appears, allowing attributes such as )ame, 5escription, T&pe, 1&mbol and *I+ +in9 to be entered.

*ew wa#point form

Setting a .estination This %eature allows the user to enter a set o% destination coordinates, which are displa&ed b& a chequered %lag in the Ciew. The process is started b& clic9ing the Set 5inis (oint... button !"# and entering the coordinates manuall& via the Set +ew 5inis (oint %orm. The displa& o% the destination coordinates can be disabled b& clic9ing the 1et Ainish Point button again. The destination coordinates can be modi%ied as o%ten as is necessar&. $% the (P1 is on, a straight line in the Ciew connects the (P1 position with the destination, and the straight line distance to the destination <in metres= is displa&ed in the status bar.

1,-".-1"

P/gina .8 de 78

gvSIG Mobile 0.3. User Manual.

%orm for setting a destination

8diting layers
The editing tools are used to create new geometries in previousl& loaded
2007 Conselleria de Infraestructuras y Transporte

Page ., de 78

gvSIG Mobile 0.3. User Manual.

vector la&ers. Three t&pes o% geometries can be created8


(oints #reated with the (oint tool !"#. 9ines #reated with the 9ine tool !$#. (olygons #reated with the (olygon tool !3#.

There are also editing tools %or creating geometries using in%ormation %rom a (P18

<&a#point= 6dd points with the ,dd verte2 using G(S tool !%#. <$rac6= 6dd a trail o% points with the ,dd vertices auto*atically using G(S tool !'#. Points are captured according to a speci%ied time interval.

!diting toolbar ?ith the editing tools, vector la&ers can be updated with new data created b& the user. 6n& new geometries automaticall& inherit the attributes o% the la&er being edited. These attributes can be entered once the geometr& or %eature has been digitised. The procedure %or editing an e7isting vector la&er is as %ollows8

Step " < 8nable 8diting7 >nce a la&er has been loaded into the Ciew !"#, editing o% the la&er is enabled in the $able of Contents <herea%ter re%erred to as T-C=. 6s e7plained earlier in this manual, the T># is opened %rom the 9ayers toolbar !$#. To enable editing tic9 the chec9bo7 !3# below the pencil icon o% the la&er that is to be edited. Ieturn to the

1,-".-1"

P/gina 4" de 78

gvSIG Mobile 0.3. User Manual.

Ciew b& clic9ing the 6ccept button !%# to close the T>#.

!nable editing of a vector la#er

Step $ < Select t e drawing tool7 1elect the appropriate drawing tool %rom the 8diting toolbar !"#. )ote that i% the la&er being edited is a point la&er, then onl& the ,dd point !$#, ,dd verte2 using G(S !'# and ,dd verte2es auto*atically using G(S !:# tools can be activated. Aor line la&ers onl& the ,dd line !3# and the (P1 buttons mentioned above can be activated, while %or pol&gon la&ers onl& the ,dd polygon tool !%# is available. Aor la&ers that support multiple geometries, %or e7ample GM9 la&ers, an& o% the drawing tools can be activated. ?hen a tool is selected and activated %or editing it is displa&ed with a &ellow bac9ground.

2007 Conselleria de Infraestructuras y Transporte

Page 41 de 78

gvSIG Mobile 0.3. User Manual.

Activating editing tools

Step 3 < ,dd +ew Geo*etries7 '7planations o% how to use the various drawing tools appear below.

,dd (oint Tool7 >nce the ,dd point tool !"# is activated, new points are added to the editable la&er b& clic9ing at the desired positions in the Ciew !$#. 6s man& points as is needed can be digitised in this manner. )ew points are generated with the same attributes as in the la&er being edited, e7cept that these attributes are empt&. To enter attribute data %or a point %irst activate the Get Infor*ation tool !%# %rom the $n%ormation 2anagement toolbar, then clic9 on the new point to bring up the attributes %orm. 6ttributes can be entered using this %orm.

1,-".-1"

P/gina 4! de 78

gvSIG Mobile 0.3. User Manual.

Adding points to a vector la#er ,dd 9ine Tool7 >nce the ,dd line tool !"# has been selected, a new line is created in the View !$# b& digitising a series o% points that de%ine the line !3#. ?hile the line is being edited it is displa&ed in &ellow !3# but once it has been completed it will be displa&ed in the same colour as the other lines in the la&er. 6 line is completed b& clic9ing the ,dd line tool again !%# or b& 8do ble7clic6ing8. #are should there%ore be ta9en when digitising a line as clic9ing too rapidl& might be interpreted b& the program as a double@clic9 signi%&ing completion o% the line. >nce the line has been completed attributes ma& be edited b& using the Get Infor*ation tool !'# to bring up the attributes %orm %or the new line %eature. 6s with points, the new line inherits the same attribute %ields as de%ined %or the la&er in which editing is ta9ing place. )ote that the attributes o% a line cannot be entered until the editing o% the line is complete. ;ear in mind that an& edits or changes can still be re3ected b& choosing not to save them to dis9.

2007 Conselleria de Infraestructuras y Transporte

Page 40 de 78

gvSIG Mobile 0.3. User Manual.

Adding lines to a vector la#er ,dd (olygon Tool7 6%ter selecting the ,dd (olygon tool !"#, start digitising the pol&gon in the View !$# b& clic9ing a series o% points to ma9e up the shape o% the pol&gon. 6s successive points o% the pol&gon are digitised the outline o% the pol&gon is shown in &ellow !3#. To %inish editing the pol&gon, either 8do ble7clic68 on the %inal point o% the pol&gon or clic9 the ,dd (olygon tool !%# again. The newl& digitised pol&gon ta9es on the %ill and outline colour properties o% the la&er into which it has been added. >nce again, care should be ta9en not to digitise the pol&gon too quic9l& as rapid clic9s might be interpreted as a double@clic9 signi%&ing completion o% the pol&gon. 6ttributes canHt be entered while the pol&gon is still being digitised. Airst complete the pol&gon and then bring up the attributes %orm with the Get Infor*ation tool !'#. The attributes are inherited %rom the pol&gon la&er being edited.

1,-".-1"

P/gina 4. de 78

gvSIG Mobile 0.3. User Manual.

Adding pol#gons to a vector la#er ,dd Verte2 using G(S Tool7 This tool, which requires a G(S to be connected and running, is eas& to use. 1impl& clic9 the ,dd Verte2 using G(S tool !"# to add a new verte7 using the current G(S position. The tool uses the G(S as a simple and e%%ective means o% creating reliable points, thereb& eliminating possible errors that might be introduced when digitising 8freehand8. ,dd Vertices ,uto*atically using G(S Tool7 6s with the previous tool, this one also requires the G(S to be connected and running be%ore it can be activated. The tool %acilitates the capturing o% accurate point in%ormation %rom G(S readings, reducing possible errors that ma& arise %rom manual digitising o% vertices. The main di%%erence between the ,dd Vertices ,uto*atically using G(S tool !"# and the previous one is that new vertices are captured automaticall& %rom the G(S at user@de%ined time intervals. $n this manner a visible $rac6"og with editable attributes is generated in the speci%ied la&er.

>ow to 8nterA8dit ,ttribute Values7

The %ollowing steps describe how to enter attribute values %or newl& created geometries and how to modi%& the attributes o% e7isting geometries in the la&er being edited. To edit attributes the la&er must be active and editable, as described in Step " above. >pen the Infor*ation Tools and select the Get Infor*ation tool !"# described previousl& in this manual. *se this tool to

2007 Conselleria de Infraestructuras y Transporte

Page 44 de 78

gvSIG Mobile 0.3. User Manual.

select a newl& created geometr& %rom the editable la&er in the View !$#, or select an e7isting geometr& %or which the attributes need to be updated. 1electing a geometr& brings up either a Standard 5or* !'# or a (ersonal 5or* !:#, which can be used to enter or edit the geometr&Hs attributes. $% a (ersonal 5or* !:# has been de%ined %or the la&er then this is used in place o% the Standard 5or* !'# %or both editing and viewing o% attributes. ?hen the entering-editing o% attributes is complete the changes are saved b& clic9ing the Save button !3#. #lic9ing the Cancel button !%# will cancel an& changes and revert to the previousl& saved attribute values. The %ollowing %igures show the attribute %orms %or a new pol&gon created with the pol&gon tool <top= and %or an e7isting pol&gon in the editable la&er <bottom=.

!ntering attrib tes for a newl# digitised geometr#

1,-".-1"

P/gina 4: de 78

gvSIG Mobile 0.3. User Manual.

!diting attrib tes of an existing geometr# in the la#er

Step % < SaveA/e)ect edits7

The %inal step is to ensure that the new geometries, their attributes and an& other changes are saved permanentl& in the vector %ile on dis9. This is done b& returning to the T-C !"# and unchec9ing the 8nable editing bo7 !$#. This brings up an Infor*ation 6indow !3# as9ing the user whether to save the la&er or not. #lic9ing the -= button saves an& edits permanentl& to dis9 while clic9ing the Cancel button causes an& changes to be discarded !%#. $% &ou do not wish to overwrite the original la&er then the edits can be saved in a new la&er with a di%%erent %ilename using the 82port to Vector 5ile tool on the 9ayer Manage*ent toolbar described previousl&. This %ile can be e7ported in an& o% the %ormats supported b& the '7port tool.

2007 Conselleria de Infraestructuras y Transporte

Page 47 de 78

gvSIG Mobile 0.3. User Manual.

Save9Cancel the edits of the vector la#er +-T87 There are a number o% limitations when editing la&ers8

The la&er must be a vector la&er. >nl& one vector la&er can be edited at a time. $% the original vector la&er contains a single t&pe o% geometr& 4points) lines or pol#gons5 then onl& the same t&pe o% geometr& can be added. $t is not possible to create new attributes that are not alread& in the la&er being edited. 'ach new geometr& onl& inherits attributes alread& e7isting %or other geometries in the la&er. $t is not possible to modi%& geometries that e7isted in the la&er be%ore editing was enabled. Bowever, it is possible to edit their attributes. To cancel an& changes made since editing was enabled, simpl& unchec9 the !diting chec6box in the T># and clic9 the cancel button when as9ed to save changes. The la&er will return to the state it was in prior to an& editing. (enerating o% points and trac9 points %rom a G(S is onl& be possible i% the G(S is enabled and wor9ing properl&.

1,-".-1"

P/gina 48 de 78

gvSIG Mobile 0.3. User Manual.

,ppendi2 ,7 (ortability and data integration wit .es4top

gvSIG

The gv1$( 2obile '7port e7tension %or gv1$( 5es9top is used to e7change data between gv1$( 5es9top and gv1$( 2obile. $t is use%ul %or e7porting la&ers to gv1$( 2obile that %irst need to be modi%ied or clipped. This e7tension %acilitates the trans%er o% mapping in%ormation between the two di%%erent plat%orms. Installing t e gvSIG Mobile 82port 82tension on gvSIG .es4top The %irst step is to install the gv1$( 5es9top e7tension that trans%ers data %rom gv1$( 5es9top to gv1$( 2obile on the mobile device.

Installer for the data export extension This e7tension can be used to e7port all la&ers o% a pro3ect, whether local or remote, along with their s&mbolog&. Configuring t e e2port The View menu o% gv1$( contains the 82port to gvSIG *obile... option which opens the window o% the e7porter. The e7port window can also be
2007 Conselleria de Infraestructuras y Transporte

Page 4, de 78

gvSIG Mobile 0.3. User Manual.

opened b& clic9ing the relevant icon on the toolbar.

Starting the export process in gvSIG Des6top

1,-".-1"

P/gina :" de 78

gvSIG Mobile 0.3. User Manual.

Setting the export parameters The e7porter creates a new pro3ect that can be opened in gv1$( 2obile. $n the e7porter window indicate the name o% the new pro3ect as well the destination %older in the te7t bo7es (ro)ect na*e !"# and 82port to !$#. The e7port area %or the la&ers can be speci%ied as the current Ciew !3# <this is the de%ault option= or a saved '7tent <select a saved zoom e7tent %rom the drop@down list=. >nce the e7port area has been speci%ied, the e7port la&ers and attributes are chosen. $n the 9ayers section indicate which la&ers are to be e7ported b& selecting the appropriate chec9 bo7es !%#. The +a&ers sections also indicates the la&er t&pe !'#, whether the la&er is visible within the view !:#, the la&er name, the number o% %ields in the attribute table o% each la&er to e7port !B#, and the selection process !C#. ?ith respect to the attributes, the user can speci%& which attribute %ields to e7port %or each la&er. #lic9 the button ne7t to the total number o% attributes !D# and select the %ields to be e7ported to gv1$( 2obile.

2007 Conselleria de Infraestructuras y Transporte

Page :1 de 78

gvSIG Mobile 0.3. User Manual.

Choosing which attrib tes to export Ainall&, select the e7port method %or each vector la&er <%or raster la&ers the entire raster is e7ported, provided the& intersect with the region shown in the view=.

Selection. This option e7ports onl& those la&er geometries that intersect the view. 6n& geometries that donHt intersect the view <i.e. arenHt visible= wonHt be e7ported. Cut. <#+$P= This option clips all la&er geometries to the e7tent o% the view and e7ports the clipped geometries. ,ll. This option e7ports the entire la&er.

82porting t e data 6%ter con%iguring the e7port options %or the di%%erent la&ers the e7port process is started b& clic9ing the 82ecute button !"#. The e7porter creates a new %older in the indicated path and then saves the selected la&ers and gv1$( 2obile pro3ect <gvm= into this %older. This pro3ect can be opened with gv1$( 2obile.

1,-".-1"

P/gina :! de 78

gvSIG Mobile 0.3. User Manual.

Perform the export )>T'8 $n gv1$( version 1.18

There is a bug in the #+$P %unction that produces a %ault with some data sources. $n this case it is recommended that the select option is used instead o% clip. This error occurs when a 1BP.J$F %iles is present alongside the 1BP %ile <the problem disappears i% it is removed=. The #+$P process %ails when some o% the attributes have )*++ values <this is o%ten an indication that the 1BP-5;A %iles are corrupted=.

,ppendi2 &7 (ersonal for*s


Personal %orms are used to view, edit and insert alphanumeric data, e7actl& as with a generic %orm, the di%%erence being that the appearance o% the various components is de%ined b& the user. 6 personal %orm can displa& data in tabular %ormat, de%ine ranges o% integers to be met b& the values contained in the %ields, or even displa& icons alongside labels.

2007 Conselleria de Infraestructuras y Transporte

Page :0 de 78

gvSIG Mobile 0.3. User Manual.

C stomi+ing a generic gvSIG Mobile form for se with a partic lar la#er Personal %orms in gv1$( 2obile are based on Thinlet

$hinlet is a *ser $nter%ace tool that ta9es up ver& little space. $t is a Gava class, which interprets an :M" %ile to displa& in%ormation on screen, handle user input, and per%orm basic associated operations. $t separates the graphical displa& <de%ined in an F2+ %ile= %rom the methods o% the application <which are written in Gava=.

gv1$( 2obile alread& has generic application methods that interpret %orms, e7ecute the most common %ield operations, and present data in an appropriate manner. Creating a form step-by-step
Step 1: Create a new XML file

*se a te7t editor to create a new te7t %ile with an e7tension o% :M", %or e7ample 8form'xml8.
Step 2: Select the components to appear on the form

5ecide which components are needed to represent the desired attributes. The t&pes o% components that are available are as %ollows8

1,-".-1"

P/gina :. de 78

gvSIG Mobile 0.3. User Manual.

A label followed b# a chec6box and a text field Te2t field 6 te7t bo7 to enter data associated with an attribute o% a feat re.
<textfield property="featureAttribute=attribute_name"/>

(assword field 6 te7t bo7 that hides the te7t entered b& the user.
<passwordfield text="secret value"/>

Te2t area 6 bo7 in which to enter several lines o% data associated with an attribute.
<textarea text="TextArea" wrap="true" columns="40" rows="2" property="featureAttribute=attribute_name"/>

Te2t label 6 label used to name an attribute, or to displa& in%ormation on the %orm.
<label text="Label" icon="image.gif" alignment="center" />

C ec4bo2 6 selection bo7 associated with an attribute that allows onl& two values, namel& selected or not selected.
<checkbox text="CheckBox" icon="image.gif" selected="true"/> <checkbox text="RadioButton-on" group="group" selected="true"/> <checkbox text="RadioButton" group="group"/>

Co*bo bo2 6 component that displa&s a drop@down list o% values. Calues can be selected %rom the list or a new value can be entered in the te7t bo7 part o% the combo bo7.

A combo box showing a drop7down list of val es that can be selected


<combobox colspan="1" property="featureAttribute=OPTION"> <choice text="Option 1" name="CODE1"/>
2007 Conselleria de Infraestructuras y Transporte

Page :4 de 78

gvSIG Mobile 0.3. User Manual.

<choice text="Option 2" name="CODE2"/> ... <choice text="Disabled" enabled="false" /> </combobox>

+u*eric ranges 6 bo7 in which to enter number within a particular range. The bo7 has buttons to increase and decrease the number.
<spinbox text="0" minimum="0" maximum="120" property="featureAttribute=SPEED_LIMIT">

Step 3: Design the layout an

grouping of the attributes

$% attributes o% a feat re need to be grouped, or i% grouping is needed to structure the %orm then the %ollowing components can be used8 Table 6 table is used to displa& several attributes that can have multiple values. n 7 m <n samples o% m values=.
<table colspan="3" selection="multiple"> <header> <column text="Attribute"/> <column text="L"/> <column text="R"/> </header> <row selected="true"> <cell name="AreaId" text="AreaId" enabled="false"/> <cell property="featureAttribute=L_AREA_ID" enabled="true"/> <cell property="featureAttribute=R_AREA_ID" enabled="true"/> </row> <row> <cell name="Postcode" text="Postcode" enabled="false"/> <cell property="featureAttribute=L_POSTCODE"/> <cell property="featureAttribute=R_POSTCODE"/> </row> <row> <cell name="NumZones" text="NumZones" enabled="false"/> <cell property="featureAttribute=L_NUMZONES"/> <cell property="featureAttribute=R_NUMZONES"/> </row> </table>

Tree 6ttributes are displa&ed in hierarchical %orm using a tree structure.


<tree colspan="3" selection="multiple"> <node name="AreaId" text="AreaId"> <node text="L"> <node property="featureAttribute=L_AREA_ID" selected="true" /> </node>

1,-".-1"

P/gina :: de 78

gvSIG Mobile 0.3. User Manual.

<node text="R"> <node property="featureAttribute=R_AREA_ID" selected="true" /> </node> </node> <node name="Postcode" text="Postcode"> <node text="L"> <node property="featureAttribute=L_POSTCODE" selected="true" /> </node> <node text="R"> <node property="featureAttribute=R_POSTCODE" selected="true" /> </node> </node> <node name="NumZones" text="NumZones"> <node text="L"> <node property="featureAttribute=L_NUMZONES" selected="true" /> </node> <node text="R"> <node property="featureAttribute=R_NUMZONES" selected="true" /> </node> </node> </tree>

Tab Tabs can be used to group attributes, which can be displa&ed using an& o% the component t&pes described above.
<tabbedpane placement="left" selected="1" action="tabchanged"> <tab text="One"> .... Components .... </tab> <tab text="Two" alignment="right"> .... Components .... </tab> </tabbedpane>

(anel (roups o% related attributes can be displa&ed on separate panels. 6 panel can contain an& o% the component t&pes described above.
<panel columns="3" gap="4" top="4" left="4" bottom="4" right="4"> .... Components .... </panel>

Step !: "rite the XML file

>nce the components have been selected and the la&out has been designed,
2007 Conselleria de Infraestructuras y Transporte

Page :7 de 78

gvSIG Mobile 0.3. User Manual.

the F2+ code can be written. The table below lists the general attributes o% components that can be included on a %orm. Component #ttributes 6 list o% some o% the properties common to all the most %requentl& used components. $%&$'%() na*e visible font ()$' string *+,C(-&, $denti%ies the component so that it can be re%erenced b& other components. 5e%ine the te7t %ont. 5e%ine the te7t colour. 5e%ine the bac9ground colour o% the component. ?idth o% the component. $% set to zero the width is set according to the value o% the attribute. Beight o% the component. $% set to zero the height is set according to the value o% the attribute. $ndicates the number o% columns that the component occupies on the displa& <de%ault 1=. $ndicates the number o% rows the component occupies on the displa& <de%ault 1=. 5etermines the horizontal cell distribution when space is available on the %orm. 5etermines the vertical cell distribution when space is available on the %orm. Borizontal alignment o% cell contents. Possible values are8 left right center fill. Certical alignment o% cell contents. Possible values are8 left right center fill.

boolean $% set to D%alseD the component does not appear. font

foreground color bac4ground color widt eig t colspan rowspan weig t2 weig ty align valign property integer integer integer integer integer integer choice choice

propert# ;inds a propert& 9e& - value to the component. To associate the attribute value o% a %eature to apropert&KD%eature6ttributeKattributeLnameD.

82a*ple of a personal for*

1,-".-1"

P/gina :8 de 78

gvSIG Mobile 0.3. User Manual.

Ta9ing the size o% the 2obile 5evicesHs screen into account, the %ollowing %orm has been designed to show a number o% components. The screen contains a number o% $hinlet components including a panel with components arranged in columns.

An example of a form with a panel and several Thinlet elements


<?xml version="1.0" encoding="ISO-8859-1"?> <!-- generated by ThinG, the Thinlet GUI editor --> <panel top="2" left="2" bottom="2" right="2" columns="2" gap="2" height="1350" width="220" weightx="1"> <label colspan="1" text="ID"/> <textfield colspan="1" property="featureAttribute=FEAT_ID" weightx="1"/> <label colspan="1" text="Link"/> <textfield colspan="1" property="featureAttribute=LINK_ID"/> <label colspan="1" text="Name"/> <textarea colspan="1" wrap="true" rows="1" property="featureAttribute=ST_NAME"/> <label colspan="1" text="Language"/> <combobox colspan="1" property="featureAttribute=ST_LANGCD"> <choice text="Basque" name="BAQ"/> <choice text="Catalan" name="CAT"/> <choice text="Croatian" name="SCR"/> <choice text="Czech" name="CZE"/> <choice text="Danish" name="DAN"/> <choice text="Dutch" name="DUT"/> <choice text="English" name="ENG"/> <choice text="Estonian" name="EST"/>

2007 Conselleria de Infraestructuras y Transporte

Page :, de 78

gvSIG Mobile 0.3. User Manual.

<choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice <choice </combobox>

text="Finnish" name="FIN"/> text="French" name="FRE"/> text="Gaelic" name="GAE"/> text="Galician" name="GAG"/> text="German" name="GER"/> text="Greek (Modern)" name="GRT"/> text="Hungarian" name="HUN"/> text="Italian" name="ITA"/> text="Latvian" name="LAT"/> text="Lithuanian" name="LIT"/> text="Norwegian" name="NOR"/> text="Polish" name="POL"/> text="Portuguese" name="POR"/> text="Slovak" name="SLO"/> text="Slovenian" name="SLV"/> text="Spanish" name="SPA"/> text="Swedish" name="SWE"/> text="Welsh" name="WEL"/>

<panel top="2" left="2" bottom="2" right="2" colspan="2" columns="3" gap="2" border="true"> <label colspan="3" text="Steet Name" font="bold"/> <checkbox colspan="3" text="Street Type Attached" property="featureAttribute=ST_TYP_ATT;chkValue=Y"/> <label colspan="1" text="Base"/> <textfield colspan="2" property="featureAttribute=ST_NM_BASE"/> <label text="Names"/> <label text="Prefix"/> <label text="Sufix"/> <textfield colspan="1" property="featureAttribute=NUM_STNMES" width="30" height="20" weightx="1"/> <textfield colspan="1" property="featureAttribute=ST_NM_PREF" width="30" height="20" weightx="1"/> <textfield colspan="1" property="featureAttribute=ST_NM_SUFF" width="30" height="20" weightx="1"/> <label text="Type"/> <label text="Type Bef"/> <label text="Type Aft"/> <combobox colspan="1" property="featureAttribute=ADDR_TYPE" width="30" height="20"> <choice text="Base" name="B"/> <choice text="City" name="C"/> <choice text="Country" name="D"/>

1,-".-1"

P/gina 7" de 78

gvSIG Mobile 0.3. User Manual.

<choice text="Old" name="O"/> <choice text="Commercial" name="T"/> </combobox> <textfield colspan="1" property="featureAttribute=ST_TYP_BEF" width="30" height="20"/> <textfield colspan="1" property="featureAttribute=ST_TYP_AFT" width="30" height="20"/> </panel> </panel>

#ached time ".-1,-1" 1!8!78".

2007 Conselleria de Infraestructuras y Transporte

Page 71 de 78

gvSIG Mobile 0.3. User Manual.

GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Lesser General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the

1,-".-1"

P/gina 7! de 78

gvSIG Mobile 0.3. User Manual.

program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that whole or in part contains or is part thereof, to be licensed as parties under the terms of this you distribute or publish, that in derived from the Program or any a whole at no charge to all third License.

c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a
2007 Conselleria de Infraestructuras y Transporte

Page 70 de 78

gvSIG Mobile 0.3. User Manual.

notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a

1,-".-1"

P/gina 7. de 78

gvSIG Mobile 0.3. User Manual.

special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.
2007 Conselleria de Infraestructuras y Transporte

Page 74 de 78

gvSIG Mobile 0.3. User Manual.

It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE

1,-".-1"

P/gina 7: de 78

gvSIG Mobile 0.3. User Manual.

PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the to attach them to the start of each source file convey the exclusion of warranty; and each file the "copyright" line and a pointer to where the program. It is safest to most effectively should have at least full notice is found.

<one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate
2007 Conselleria de Infraestructuras y Transporte

Page 77 de 78

gvSIG Mobile 0.3. User Manual.

parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License.

1,-".-1"

P/gina 78 de 78

You might also like