24 |
</copyright> |
</copyright> |
25 |
<revhistory> |
<revhistory> |
26 |
<!-- comment this first revision out when releasing a real version --> |
<!-- comment this first revision out when releasing a real version --> |
|
<!-- |
|
27 |
<revision> |
<revision> |
28 |
<revnumber>CVS version $Id$</revnumber> |
<revnumber>CVS version $Id$</revnumber> |
29 |
<date></date> |
<date></date> |
30 |
<revremark>Under development.</revremark> |
<revremark>Under development.</revremark> |
31 |
</revision> |
</revision> |
|
--> |
|
32 |
<revision> |
<revision> |
33 |
<revnumber>1.0.0</revnumber> |
<revnumber>1.0.0</revnumber> |
34 |
<date>22-Jan-2004</date> |
<date>22-Jan-2004</date> |
66 |
<chapter><title>Introduction</title> |
<chapter><title>Introduction</title> |
67 |
<para> |
<para> |
68 |
Thuban is an interactive geographic data viewer. |
Thuban is an interactive geographic data viewer. |
69 |
It has been developed because there was no simple interactive |
Its development had been started because there was no simple interactive |
70 |
viewer for geographic information available as Free Software. Thuban is |
viewer for geographic information available as Free Software. Thuban is |
71 |
written in Python and C++ and uses the wxWindows library allowing it to |
written mainly in Python and uses the wxWidgets (former wxWindows) |
72 |
|
library allowing it to |
73 |
run on many different platforms, including GNU/Linux and Windows. |
run on many different platforms, including GNU/Linux and Windows. |
74 |
</para> |
</para> |
75 |
<para> |
<para> |
83 |
</para> |
</para> |
84 |
<para> |
<para> |
85 |
Thuban arranges a session in a hierarchy. A session contains a map which |
Thuban arranges a session in a hierarchy. A session contains a map which |
86 |
consists of layers. Each layer represents one kind of data set. For |
consists of layers. Each layer represents a data set. For |
87 |
instance, there may be a layer for roads and another layer for buildings. |
instance, there may be a layer for roads and another layer for buildings. |
88 |
These layers can either be vector shapes or images. |
These layers can either be vector shapes or images. |
89 |
</para> |
</para> |
396 |
<listitem><para>French</para></listitem> |
<listitem><para>French</para></listitem> |
397 |
<listitem><para>German</para></listitem> |
<listitem><para>German</para></listitem> |
398 |
<listitem><para>Italian</para></listitem> |
<listitem><para>Italian</para></listitem> |
399 |
|
<listitem><para>Portuguese (Brazilian)</para></listitem> |
400 |
<listitem><para>Russian</para></listitem> |
<listitem><para>Russian</para></listitem> |
401 |
<listitem><para>Spanish</para></listitem> |
<listitem><para>Spanish</para></listitem> |
402 |
</itemizedlist> |
</itemizedlist> |
408 |
LC_ALL=fr_FR for the french language support). Please check your |
LC_ALL=fr_FR for the french language support). Please check your |
409 |
systems documentation for details and supported settings. |
systems documentation for details and supported settings. |
410 |
Specifiying LC_ALL on the command line while launching thuban |
Specifiying LC_ALL on the command line while launching thuban |
411 |
allows appication specific language settings. |
allows appication specific language settings: |
412 |
</para> |
</para> |
413 |
|
<programlisting> |
414 |
|
LC_ALL=fr_FR thuban.py |
415 |
|
</programlisting> |
416 |
|
|
417 |
<para> |
<para> |
418 |
MS Windows users have to specify the language to be used via the control |
MS Windows users have to specify the language to be used via the control |
484 |
If a session is already loaded and has been modified without |
If a session is already loaded and has been modified without |
485 |
being saved a prompt will ask if the current session should |
being saved a prompt will ask if the current session should |
486 |
be saved. A new session consists of an empty map with no |
be saved. A new session consists of an empty map with no |
487 |
layers and no tables. |
layers, no tables and no projection. |
488 |
</para> |
</para> |
489 |
</section> |
</section> |
490 |
|
|
498 |
for a Thuban Session file. Thuban session files end with |
for a Thuban Session file. Thuban session files end with |
499 |
<varname>.thuban</varname>. Selecting a file a clicking |
<varname>.thuban</varname>. Selecting a file a clicking |
500 |
<guibutton>OK</guibutton> will load the session into Thuban. |
<guibutton>OK</guibutton> will load the session into Thuban. |
501 |
|
</para> |
502 |
|
|
503 |
|
<para> |
504 |
If a session is already loaded and has been modified without |
If a session is already loaded and has been modified without |
505 |
being saved a prompt will ask if the current session should |
being saved a prompt will ask if the current session should |
506 |
be saved. |
be saved. |
507 |
</para> |
</para> |
508 |
|
|
509 |
|
<para> |
510 |
|
Thuban provides a path recovery feature: If a (shape) file referenced |
511 |
|
in a Thuban session cannot be found at the specified location, the user |
512 |
|
is prompted a file dialog. Here a new location can be selected for the |
513 |
|
currents layer data source. Cancelling the dialog removes the layer |
514 |
|
from the session. If a new location has been selected, Thuban checks |
515 |
|
this again, if further layers data sources are missing. The user is |
516 |
|
informed about this and can accept or cancel the suggestion. |
517 |
|
</para> |
518 |
</section> |
</section> |
519 |
|
|
520 |
<section><title>Saving a Session</title> |
<section><title>Saving a Session</title> |
523 |
<menuchoice> |
<menuchoice> |
524 |
<guimenu>File</guimenu> |
<guimenu>File</guimenu> |
525 |
<guimenuitem>Save Session</guimenuitem> |
<guimenuitem>Save Session</guimenuitem> |
526 |
</menuchoice>. A dialog box will open allowing the user to browse |
</menuchoice>. |
527 |
|
In the case the session is not a new and unsaved one, |
528 |
|
the corresponding file is updated with the current session |
529 |
|
data. |
530 |
|
In the case the current session is a new one and yet unsaved |
531 |
|
a dialog box will open allowing the user to browse |
532 |
the file system and select a place to save the session. Thuban |
the file system and select a place to save the session. Thuban |
533 |
sessions should be saved under a name ending in |
sessions should be saved under a name ending in |
534 |
<varname>.thuban</varname>. If the file already exists the user |
<varname>.thuban</varname>. If the file already exists the user |