sharpetronics/QGIS
1
0
Fork 0
mirror of https://github.com/qgis/QGIS.git synced 2025-06-18 00:04:02 -04:00
Code Issues Packages Projects Releases Wiki Activity

Merge in docs from 0.7 branch

Browse Source 
git-svn-id: http://svn.osgeo.org/qgis/trunk@4159 c8812cc2-4d05-0410-92ff-de0c093fc19c
This commit is contained in:
timlinux 2005-11-05 17:15:37 +00:00
parent 3175cd3031
commit 9cf83128fe
22 changed files with 19431 additions and 8080 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

105
doc/index.html
View File

@ -10,61 +10,104 @@
</td>
<td valign="center">
<span class="header">Quantum GIS Documentation</span><br>
<span class="subheader">Version 0.6 <i>Simon</i></span>
<span class="subheader">Version 0.7<i>Seamus</i></span><br>
<span class="warning">Please read this entire document for important information about this release.</span>
</td>
</tr>
</table>
<!-- comment out the links so you'll read the whole thing - we hope
<a href="install.pdf" class="bar">Installation Guide</a>&nbsp;&nbsp;
<a href="userguide.pdf" class="bar">User Guide</a><br>
-->
<!-- This documentation describes the Quantum GIS (QGIS) application. More
information on QGIS is available on the web page at http://qgis.org. -->
<h2>Whats new in Version 0.6</h2>
<h2>Whats new in Version 0.7</h2>
<table>
<tr>
<td valign="top" width="50%">
<ul class="small">
<li> GEOS support to improve the method of feature
<li> PostGIS editing support in provider
<li> Vector dialog redesign to improve usability
<li> Improvement in project handling (loading and saving)
<li> Scale dependent rendering
<li> User option to load layers with out drawing them, thus allowing
you to set scale dependency, etc without waiting for the initial draw to
complete
<li> Interrupt drawing of features by hitting ESC
<li> Attribute actions - the ability to run an external program based
on the contents of an attribute field in a layer
<li> Create new vector layer (shapefile) for editing
<li> Windows installer
<li> Mac OSX binary
<li> On the fly projection support to automatically project layers from different coordinate systems
<li> Map Composer for creating map layouts
<li> Toolbox for running GRASS tools from QGIS. The toolbox can be easily customized to add additional tools
<li> Handling of spatially enabled tables and views in PostgreSQL has been greatly improved. QGIS can now load any table in the database that contains a geometry column
<li> PostgreSQL views containing a geometry column can be viewed in QGIS
<li> Raster graphing tool to produce a histogram for a raster layer
<li> Raster query using the identify tool allows you to get the pixel values from a raster by making it the active layer and clicking on the point of interest
<li> User preferences provides customizable settings for the digitizing line width, color, and selection color
<li> New symbols for use with point layers are available from the layer properties dialog
</ul>
<td valign="top" width="50%">
<ul class="small">
<li> New options in the graticule builder plugin
<li> Enhancements to the GPS plugin
<li> Man page
<li> Save delimited text as shapefile
<li> Improved Delimited Text plugin, including preview of text file
<li> Improved SPIT handling of PostgreSQL reserved words and shapefiles
with multiple geometry types
<li> Display SQL query used to create a PostGIS layer
<li> PostgreSQL query builder
<li> Ability to redefine the query used for PostgreSQL layers from the
layer properties dialog
<li> North arrow, scalebar, and copyright plugins save their state in
the project file
<li> Datasets with UTF8, Kanjii and CJK filenames now load properly
<li> Spatial bookmarks allow you to create and manage bookmarks for an area on the map. Bookmarks are persistent and global; meaning they are available for all projects
<li> Measure tool allows you to measure distances on the map with both segment length and total length displayed as you click
<li> GPX loading times and memory consumption for large GPX (GPS) files has been drastically reduced
<li> Many enhancements to the digitizing tools have been made, including the ability to capture data straight into PostgreSQL/PostGIS, and improvements to the definition of attribute tables for newly created layers
<li> The Raster Georeferencer plugin can be used to generate a world file for a raster. The plugin allows you to define known control points in the raster coordinate system. Once enough control points are defined, the world file can be generated and the raster properly displayed in QGIS or other GIS applications
<li> Improvements to the Mapserver export tool
</ul>
</td>
</tr>
</table>
<dl><dt><span class="subheader">New Requirements
<ul class="normal">
<li><a href="http://www.sqlite.org/">SQLite</a> version 3 is now required. Sqlite is used to manage the projections database and store persistent data such as spatial bookmarks.
<li>The <a href="http://expat.sourceforge.net/">Expat XML Parser</a> is required for the GPS plugin. This vastly improves the speed and memory management when loading GPX files.
<li>The raster georeferencer plugin requires the <a href="http://www.gnu.org/software/gsl/">GNU Scientfic Library</a> (GSL).
</ul>
<span class="normal">
GSL and Expat are optional and required only if you want to use the georeferencer or GPS plugins respectively. SQLite is always required.
</span>
</dl>
<dl><dt><span class="subheader">Known Issues in this Release
<dd>
General
<ul class="normal">
<li>Project files from previous versions of QGIS will likely not work. This is due to changes related to on the fly projection.
<li>Some internationalization (translation) files are incomplete. Updates to these files will be made available at http://community.qgis.org at a later date.
</ul>
</dd>
<dd>
OS X Specific
<ul class="normal">
<li>On Tiger (OS X 10.4), button animation only works with Qt 3.3.5 snapshot. Previous versions of OS X are not affected.
<li>Some dialogs have cosmetic issues with buttons
<li>Due to a limitation in the Quicktime graphics engine, there is a limit on the number points allowed per feature. See the Readme that comes with the OS X dmg
</ul>
</dd>
<dd>
Windows
<ul class="normal">
<li>The Windows release does not include the GPS plugin. The plugin will be made available at a later date.
</ul>
</dd>
</dt>
</dl>
<dl><dt><span class="subheader">Reporting Bugs
<dd>
If think you have found a bug, please consider reporting it to the development team. The steps to report a bug are:
<ol class="normal">
<li>Go to the Bug Tracker at <a href="https://sourceforge.net/tracker/?group_id=55820&atid=478378">https://sourceforge.net/tracker/?group_id=55820&atid=478378</a>
<li>If you have a Sourceforge user id, login
<li>Under the Group heading, change the choice to Version 0.7
<li>Click on the Browse button. This will give you a list of open bugs for Version 0.7
<li>Review the list to make sure your bug has not already been submitted. If it has, review the submission and see if there is anything you can add to the bug report to aid the developers
<li>If your bug has not been reported, click on Submit New
<li>Change the Group to Version 0.7
<li>Enter a summary and a detailed description
<li>Submit the bug
</ol>
<span class="warning">Note - If you don't login or don't provide an email address your bug report will be of little value since we have no way of contacting you for further information and/or clarification.</span>
</dd>
</dt>
<dl><dt><span class="subheader">Installation Guide
<dd>How to build and install QGIS. The guide is available in both
<a href="install.pdf">pdf</a> and
<a href="install_guide/index.html">HTML</a> format.</dd>
</dt>
</dl>
<dl><dt><span class="subheader">User Guide
<dl><dt><span class="subheader">User Guide
<dd>A brief guide to using QGIS. The User Guide is available in
<a href="userguide.pdf">pdf</a> format.</dd>
</dt>

BIN
doc/install.pdf
View File

Binary file not shown.

238
doc/install_guide/index.html
View File

@ -37,71 +37,103 @@ Contents</A>
<!--Table of Contents-->
<UL>
<LI><A NAME="tex2html41"
<LI><A NAME="tex2html48"
HREF="install.html#SECTION00020000000000000000">Introduction</A>
<UL>
<LI><A NAME="tex2html42"
<LI><A NAME="tex2html49"
HREF="install.html#SECTION00021000000000000000">Installing Windows Version</A>
<LI><A NAME="tex2html43"
HREF="install.html#SECTION00022000000000000000">Installing Mac OSX Version</A>
<LI><A NAME="tex2html44"
<LI><A NAME="tex2html50"
HREF="install.html#SECTION00022000000000000000">Installing Mac OS X Version</A>
<LI><A NAME="tex2html51"
HREF="install.html#SECTION00023000000000000000">Building from Source</A>
</UL>
<BR>
<LI><A NAME="tex2html45"
HREF="install.html#SECTION00030000000000000000">Getting QGIS</A>
<LI><A NAME="tex2html46"
HREF="install.html#SECTION00040000000000000000">PostgreSQL</A>
<LI><A NAME="tex2html47"
HREF="install.html#SECTION00050000000000000000">GEOS</A>
<LI><A NAME="tex2html48"
HREF="install.html#SECTION00060000000000000000">PostGIS</A>
<LI><A NAME="tex2html49"
HREF="install.html#SECTION00070000000000000000">GRASS</A>
<LI><A NAME="tex2html50"
HREF="install.html#SECTION00080000000000000000">GDAL/OGR</A>
<LI><A NAME="tex2html51"
HREF="install.html#SECTION00090000000000000000">Qt</A>
<LI><A NAME="tex2html52"
HREF="install.html#SECTION000100000000000000000">Building QGIS</A>
<UL>
HREF="install.html#SECTION00030000000000000000">Getting QGIS</A>
<LI><A NAME="tex2html53"
HREF="install.html#SECTION000101000000000000000">Quick and Dirty</A>
HREF="install.html#SECTION00040000000000000000">PostgreSQL</A>
<LI><A NAME="tex2html54"
HREF="install.html#SECTION000102000000000000000">Configuring QGIS the Right Way</A>
HREF="install.html#SECTION00050000000000000000">GEOS</A>
<LI><A NAME="tex2html55"
HREF="install.html#SECTION00060000000000000000">PostGIS</A>
<LI><A NAME="tex2html56"
HREF="install.html#SECTION00070000000000000000">GRASS</A>
<LI><A NAME="tex2html57"
HREF="install.html#SECTION00080000000000000000">Proj4</A>
<LI><A NAME="tex2html58"
HREF="install.html#SECTION00090000000000000000">SQLite</A>
<LI><A NAME="tex2html59"
HREF="install.html#SECTION000100000000000000000">GDAL/OGR</A>
<LI><A NAME="tex2html60"
HREF="install.html#SECTION000110000000000000000">Qt</A>
<LI><A NAME="tex2html61"
HREF="install.html#SECTION000120000000000000000">Building QGIS</A>
<UL>
<LI><A NAME="tex2html62"
HREF="install.html#SECTION000121000000000000000">Quick and Dirty</A>
<LI><A NAME="tex2html63"
HREF="install.html#SECTION000122000000000000000">Configuring QGIS the Right Way</A>
</UL>
<BR>
<LI><A NAME="tex2html55"
HREF="install.html#SECTION000110000000000000000">Building Plugins</A>
<LI><A NAME="tex2html64"
HREF="install.html#SECTION000130000000000000000">Building Plugins</A>
</UL>
<!--End of Table of Contents-->
<P>
<P>
<H1><A NAME="SECTION00020000000000000000"></A><A NAME="label_introduction"></A>
<BR>
Introduction
</H1>
This document briefly describes how to build QGIS 0.6 (<I>`Simon'</I>) from the source distribution. These instructions are for Linux/Unix and other POSIX systems which have the required build environment.
The majority of this document is devoted to describing how to build QGIS 0.7
(<I>`Seamus'</I>) from the source distribution. These instructions are for
Linux/Unix and other POSIX systems which have the required build
environment. If you are building on FreeBSD, see
<TT><A NAME="tex2html1"
HREF="http://community.qgis.org/buildingOnFreeBSD.html">http://community.qgis.org/buildingOnFreeBSD.html</A></TT> for hints and further
information.
<P>
The latest version of this document can always be found at <TT><A NAME="tex2html1"
Installing on Windows and Mac OS X is a simple process as described
below.
<P>
You don't have to build all the QGIS dependencies from source. If your
platform provides packages at an acceptable version for the needed
dependencies, you can install them prior to building QGIS. Make sure you
also install the "development" package (if separate from the main package)
for each dependency. QGIS needs the header files from these packages in
order to build.
<P>
The latest version of this document can always be found at
<TT><A NAME="tex2html2"
HREF="http://qgis.org/docs/install.html">http://qgis.org/docs/install.html</A></TT>.
<H2><A NAME="SECTION00021000000000000000">
Installing Windows Version</A>
</H2>
Installing the Windows version of QGIS is simply a matter of running the user friendly setup wizard. See the README.WIN32 file for additional information regarding the Windows version of QGIS. At version 0.6, the GRASS plugin is not available in Windows.
Installing the Windows version of QGIS is simply a matter of running the
user friendly setup wizard. See the README.WIN32 file for additional
information regarding the Windows version of QGIS. At version 0.7, the GRASS
plugin is not available in Windows. Work on including the plugin in the next
version of QGIS is under way.
<P>
<H2><A NAME="SECTION00022000000000000000">
Installing Mac OSX Version</A>
Installing Mac OS X Version</A>
</H2>
To install the compressed disk image containing the OSX version of QGIS,
double-click to expand and mount the image, then drag QGIS application to your
hard drive. The OSX version does not include GRASS support.
double-click to expand and mount the image, then drag QGIS application to
your hard drive. If you want to build from source on Mac OS X, see
<TT><A NAME="tex2html3"
HREF="http://wiki.qgis.org/qgiswiki/BuildingOnMacOsX">http://wiki.qgis.org/qgiswiki/BuildingOnMacOsX</A></TT>. Installing the
compressed disk image is the easiest method and gives you the full
functionality of QGIS and all plugins, including GRASS. See the README file
included on the disk image for additional instructions.
<P>
@ -111,6 +143,9 @@ Building from Source</A>
The remainder of this document deals with compiling and installing QGIS from the
source code. Specifically this applies to Linux/Unix systems.
<P>
At 0.7, there are two new requirements: SQLite and Proj4. These must be built and installed prior to configuring QGIS.
<P>
QGIS can be installed with three levels of support for data stores:
@ -124,18 +159,21 @@ QGIS can be installed with three levels of support for data stores:
</OL>
<P>
Basic support uses the GDAL/OGR libraries and supports many raster and vector formats. For more information on the available formats, see <TT><A NAME="tex2html2"
HREF="http://www.remotesensing.org:16080/gdal/formats_list.html">http://www.remotesensing.org:16080/gdal/formats_list.html</A></TT> and <TT><A NAME="tex2html3"
HREF="http://www.remotesensing.org:16080/gdal/ogr/ogr_formats.html">http://www.remotesensing.org:16080/gdal/ogr/ogr_formats.html</A></TT>.
Basic support uses the GDAL/OGR libraries and supports many raster and
vector formats. For more information on the available formats, see
<TT><A NAME="tex2html4"
HREF="http://gdal.maptools.org/formats_list.html">http://gdal.maptools.org/formats_list.html</A></TT> and
<TT><A NAME="tex2html5"
HREF="http://gdal.maptools.org/ogr/ogr_formats.html">http://gdal.maptools.org/ogr/ogr_formats.html</A></TT>.
<P>
PostgreSQL/PostGIS support allows you to store spatial data in a PostgreSQL database. GRASS support provides access to GRASS mapsets.
<P>
<B>Note:</B> - If you plan to build QGIS with GRASS support, version 1.2.3 or higher of GDAL must be used.
<B>Note:</B> - If you plan to build QGIS with GRASS support, version 1.2.6 or higher of GDAL must be used.
<P>
Each of the requirements are discussed below. Note that the information given below is abstracted from the installation documentation for each of the libraries. See the install information for each library to get detailed instructions. In the documentation below, the file names and versions used are examples.
Each of the requirements is discussed below. Note that the information given below is abstracted from the installation documentation for each of the libraries. See the install information for each library to get detailed instructions. In the documentation below, the file names and versions used are examples.
<P>
If you are building QGIS without PostgreSQL or GRASS support, skip to the section on Installing GDAL/OGR.
@ -143,38 +181,43 @@ If you are building QGIS without PostgreSQL or GRASS support, skip to the sectio
<H1><A NAME="SECTION00030000000000000000">
Getting QGIS</A>
</H1>
QGIS is available in both source and package format from <TT><A NAME="tex2html4"
QGIS is available in both source and package format from <TT><A NAME="tex2html6"
HREF="http://qgis.org">http://qgis.org</A></TT>.
<P>
In addition, packages for many Linux distributions are independently maintained in various locations. See
the <I>Download</I> section on <TT><A NAME="tex2html5"
the <I>Download</I> section on <TT><A NAME="tex2html7"
HREF="http://qgis.org">http://qgis.org</A></TT> for the latest information on package locations.
<P>
Packages for most of the software/libraries discussed below can be found for almost all Linux distributions. While it is possible to mix compiling from source and installing packages to meet the requirements for QGIS, sometimes this becomes tricky. Following the steps below will generally ensure a successful installation. If you are using SuSE 9.1, the LinGIS distribution <TT><A NAME="tex2html6"
Packages for most of the software/libraries discussed below can be found for almost all Linux distributions. While it is possible to mix compiling from source and installing packages to meet the requirements for QGIS, sometimes this becomes tricky. Following the steps below will generally ensure a successful installation. If you are using SuSE 9.1, the LinGIS distribution <TT><A NAME="tex2html8"
HREF="ftp://ftp.lingis.org">ftp://ftp.lingis.org</A></TT> is a good choice for installing QGIS and its dependencies.
<P>
For information on installing dependencies and building QGIS on FreeBSD, see
<I>Building QGIS on FreeBSD</I> on <TT><A NAME="tex2html9"
HREF="http://community.qgis.org">http://community.qgis.org</A></TT>.
<P>
<H1><A NAME="SECTION00040000000000000000">
PostgreSQL</A>
</H1>
QGIS uses the latest features of PostgreSQL. For this reason, version 7.4.x or higher is recommended with QGIS version 0.5. If you choose to add PostgreSQL, you must also install PostGIS and the GEOS library (see below).
QGIS uses the latest features of PostgreSQL. For this reason, version 8.0.x or higher is recommended with QGIS version 0.7. If you choose to add PostgreSQL, you must also install PostGIS (see below).
<OL>
<LI>Download PostgreSQL source from www.postgresql.org
</LI>
<LI>Extract the source
<PRE>
tar -xzf postgresql-7.4.1.tar.gz
tar -xzf postgresql-8.0.1.tar.gz
</PRE>
<P>
</LI>
<LI>Change to the source directory
<PRE>
cd postgresql-7.4.1
cd postgresql-8.0.1
</PRE>
<P>
@ -271,7 +314,7 @@ PostgreSQL</A>
select version();
version
-------------------------------------------------------------------------------------
PostgreSQL 7.4.1 on i686-pc-linux-gnu, compiled by GCC gcc (GCC) 3.3.1 (SuSE Linux)
PostgreSQL 8.0.1 on i686-pc-linux-gnu, compiled by GCC gcc (GCC) 3.3.1 (SuSE Linux)
(1 row)
\q
@ -301,7 +344,7 @@ QGIS uses GEOS to properly fetch features from the the underlying datastore
To install GEOS:
<OL>
<LI>Download GEOS source from <TT><A NAME="tex2html7"
<LI>Download GEOS source from <TT><A NAME="tex2html10"
HREF="http://geos.refractions.net">http://geos.refractions.net</A></TT>
</LI>
<LI>Untar GEOS
@ -336,12 +379,12 @@ NOTE - You must edit the PostGIS Makefile and make sure that USE_GEOS=1 is
set. Also adjust GEOS_DIR to point to your GEOS installation directory.
<OL>
<LI>Download PostGIS source from <TT><A NAME="tex2html8"
<LI>Download PostGIS source from <TT><A NAME="tex2html11"
HREF="http://postgis.refractions.net">http://postgis.refractions.net</A></TT>
<P>
</LI>
<LI>Untar PostGIS into the contrib subdirectory of the postgresql build directory. The contrib subdirectory is located in the directory created in step 3 of the PostgreSQL installation process.
<LI>Untar PostGIS into the contrib subdirectory of the PostgreSQL build directory. The contrib subdirectory is located in the directory created in step 3 of the PostgreSQL installation process.
</LI>
<LI>Change to the postgis subdirectory
</LI>
@ -352,18 +395,18 @@ NOTE - You must edit the PostGIS Makefile and make sure that USE_GEOS=1 is
<LI>The quick and dirty steps to install PostGIS are:
<PRE>
cd contrib
gunzip postgis-0.8.0.tar.gz
tar xvf postgis-0.8.0.tar
cd postgis-0.8.0
gunzip postgis-1.0.2.tar.gz
tar xvf postgis-1.0.2.tar
cd postgis-1.0.2
make
make install
createlang plpgsql yourtestdatabase
psql -d yourtestdatabase -f postgis.sql
psql -d yourtestdatabase -f lwpostgis.sql
psql -d yourtestdatabase -f spatial_ref_sys.sql
</PRE>
</LI>
</OL>
The <B>better way</B> to install PostGIS is to carefully follow the instructions in the PostGIS manual in the doc/html subdirectory or the online manual at <TT><A NAME="tex2html9"
The <B>better way</B> to install PostGIS is to carefully follow the instructions in the PostGIS manual in the doc/html subdirectory or the online manual at <TT><A NAME="tex2html12"
HREF="http://postgis.refractions.net/docs">http://postgis.refractions.net/docs</A></TT>
<P>
@ -371,30 +414,53 @@ The <B>better way</B> to install PostGIS is to carefully follow the instructions
GRASS</A>
</H1>
If you want QGIS to support GRASS vector and raster layers, you must build GRASS prior to proceeding.
Follow the directions on the GRASS website carefully to build version 5.7. Additional information and the build instructions can be found at <TT><A NAME="tex2html10"
Follow the directions on the GRASS website carefully to build version 6.0.x. Additional information and the build instructions can be found at <TT><A NAME="tex2html13"
HREF="http://grass.itc.it">http://grass.itc.it</A></TT>.
<P>
The GRASS software is available for download at <TT><A NAME="tex2html11"
The GRASS software is available for download at <TT><A NAME="tex2html14"
HREF="http://grass.itc.it/download.html">http://grass.itc.it/download.html</A></TT>.
<P>
<H1><A NAME="SECTION00080000000000000000">
Proj4</A>
</H1>
Proj4 provides the functions needed for on the fly projection of map layers in version 0.7. To build and install Proj4, download the latest version from <TT><A NAME="tex2html15"
HREF="http://proj.maptools.org">http://proj.maptools.org</A></TT>, untar the distribution and:
<PRE>
./configure
make
make install
</PRE>
<H1><A NAME="SECTION00090000000000000000">
SQLite</A>
</H1>
Sqlite is used to manage the projections database and store persistent data such as spatial bookmarks. Download the latest (3.x) version of SQLite from <TT><A NAME="tex2html16"
HREF="http://www.sqlite.org/">http://www.sqlite.org/</A></TT>. Untar the distribution and:
<PRE>
./configure
make
make install
</PRE>
Note - SQLite 3.x is included on Mac OS X 10.4.
<H1><A NAME="SECTION000100000000000000000">
GDAL/OGR</A>
</H1>
The GDAL and OGR libraries provide support for raster and vector data formats. QGIS makes use of both of these libraries (which come bundled in one distribution).
<P>
Note: A Linux binary of GDAL is available at <TT><A NAME="tex2html12"
Note: A Linux binary of GDAL is available at <TT><A NAME="tex2html17"
HREF="http://www.remotesensing.org/gdal">http://www.remotesensing.org/gdal</A></TT>. If you choose to install the binary you will also need to download and unpack the source tree since QGIS needs the header files in order to compile.
<P>
To install GDAL/OGR from source:
<OL>
<LI>Download the GDAL distribution from <TT><A NAME="tex2html13"
HREF="http://www.remotesensing.org/gdal">http://www.remotesensing.org/gdal</A></TT>. You should use version 1.1.9 or higher. Versions prior to 1.1.9 contained a bug that caused problems when a null feature was encountered. If you want to build vector support for GRASS, you must use GDAL 1.2.3.
<LI>Download the GDAL distribution from
<TT><A NAME="tex2html18"
HREF="http://www.remotesensing.org/gdal">http://www.remotesensing.org/gdal</A></TT>. You should use the latest
version of GDAL if possible. The minimum recommended version for use
with QGIS is 1.2.6.
<P>
</LI>
@ -420,7 +486,9 @@ To install GDAL/OGR from source:
<PRE>
./configure --with-grass=&lt;full path to grass install&gt;
</PRE>
Depending on the GDAL version you are building, it may be necessary to specify -without-ogdi when running configure if you don't have the OGDI libary avaiable on your system.
Depending on the GDAL version you are building, it may be necessary to
specify -without-ogdi when running configure if you don't have the OGDI
library available on your system.
<P>
</LI>
@ -458,15 +526,15 @@ To install GDAL/OGR from source:
</OL>
<P>
If you've had problems during the installation, refer to this manual, where the whole process is described with some more detail: <TT><A NAME="tex2html14"
If you've had problems during the installation, refer to this manual, where the whole process is described with some more detail: <TT><A NAME="tex2html19"
HREF="http://www.remotesensing.org/gdal/gdal_building.html">http://www.remotesensing.org/gdal/gdal_building.html</A></TT>
<P>
<H1><A NAME="SECTION00090000000000000000">
<H1><A NAME="SECTION000110000000000000000">
Qt</A>
</H1>
Qt 3.1.2 or higher is required in order to compile QGIS. You may already have Qt on your system. If so, check to see if you have version 3.1.2 or later. You can check the Qt version using the find command:
Qt 3.2.1 or higher is required in order to compile QGIS. You may already have Qt on your system. If so, check to see if you have version 3.2.1 or later. You can check the Qt version using the find command:
<PRE>
find ./ -name qglobal.h 2&gt;/dev/null | xargs grep QT_VERSION_STR
</PRE>
@ -487,7 +555,7 @@ If Qt is not installed, you will have to install the Qt development package for
To install Qt from source:
<OL>
<LI>Download Qt from <TT><A NAME="tex2html15"
<LI>Download Qt from <TT><A NAME="tex2html20"
HREF="http://www.trolltech.com/developer">http://www.trolltech.com/developer</A></TT> (choose the Qt/X11 Free Edition)
</LI>
<LI>Unpack the distribution
@ -505,17 +573,19 @@ To install Qt from source:
</LI>
</OL>
NOTE - QGIS will not compile under Qt 4.0.x. The best choice for compiling
QGIS is Qt 3.3.x.
<P>
<H1><A NAME="SECTION000100000000000000000">
<H1><A NAME="SECTION000120000000000000000">
Building QGIS</A>
</H1>
<P>
After you have installed the required libraries, you are ready to build QGIS. Download and untar the QGIS distribution and change to the QGIS source directory. You have two options for building and installing QGIS: <B>Quick and Dirty</B> and the <B>right way</B>.
<H2><A NAME="SECTION000101000000000000000">
<H2><A NAME="SECTION000121000000000000000">
Quick and Dirty</A>
</H2>
If you don't need PostgreSQL support and have installed GDAL ,
@ -528,7 +598,7 @@ Quick and Dirty</A>
The above assumes that the gdal-config program is in your PATH
See the next section for the full configuration instructions.
<H2><A NAME="SECTION000102000000000000000">
<H2><A NAME="SECTION000122000000000000000">
Configuring QGIS the Right Way</A>
</H2>
To see the configure options available, change the the QGIS
@ -549,7 +619,7 @@ Configuring QGIS the Right Way</A>
<P>
<H3><A NAME="SECTION000102100000000000000">
<H3><A NAME="SECTION000122100000000000000">
Qt</A>
</H3>
The configure script will detect Qt, unless it is installed in a
@ -557,7 +627,7 @@ Qt</A>
make ensure that the detection succeeds. You can also specify the
path using the -with-qtdir option.
<H3><A NAME="SECTION000102200000000000000">
<H3><A NAME="SECTION000122200000000000000">
GDAL</A>
</H3>
If the gdal-config script is in the PATH, configure will automatically
@ -566,7 +636,7 @@ GDAL</A>
<PRE>
/configure --with-gdal=/usr/mystuff/bin/gdal-config
</PRE>
<H3><A NAME="SECTION000102300000000000000">
<H3><A NAME="SECTION000122300000000000000">
PostgreSQL</A>
</H3>
If the pg_config script is in the PATH, configure will automatically
@ -575,16 +645,16 @@ PostgreSQL</A>
<PRE>
./configure --with-pg=/usr/local/psql/bin/pg_config
</PRE>
<H3><A NAME="SECTION000102400000000000000">
<H3><A NAME="SECTION000122400000000000000">
GRASS</A>
</H3>
To build QGIS with GRASS support you must specify the full path to the installed GRASS binary package:
<PRE>
./configure --with-grass=/usr/local/grass-5.7.0
./configure --with-grass=/usr/local/grass-6.0.0
</PRE>
This assumes that GRASS is installed in the default location. Change the path to match the location of your GRASS installation.
<H3><A NAME="SECTION000102500000000000000">
<H3><A NAME="SECTION000122500000000000000">
Example Use of Configure</A>
</H3>
An example of use of configure for building QGIS with all options:
@ -592,7 +662,7 @@ Example Use of Configure</A>
./configure --prefix=/usr/local/qgis \
--with-gdal=/usr/local/gdal/bin/gdal-config \
--with-pg=/usr/local/psql/bin/pg_config \
--with-grass=/usr/local/grass-5.7.0
--with-grass=/usr/local/grass-6.0.0
</PRE>
This will configure QGIS to use GDAL, GRASS, and PostgreSQL. QGIS will be
installed in /usr/local/qgis.
@ -603,7 +673,7 @@ If QTDIR is set and gdal-config and pg_config are both
options. The configure script will properly detect and configure
GDAL and PostgreSQL. You must still use the -with-grass option if building with GRASS support.
<H3><A NAME="SECTION000102600000000000000">
<H3><A NAME="SECTION000122600000000000000">
Compiling and Installing QGIS</A>
</H3>
Once properly configured simply issue the following commands:
@ -611,21 +681,21 @@ Compiling and Installing QGIS</A>
make
make install
</PRE>
NOTE - As of version 0.1, you can no longer run QGIS from the src directory. You must do a make install and start QGIS from the installed location. In the case of the example above, the QGIS binary resides in the bin subdirectory of the directory specified with the prefix option (/usr/local/qgis/bin).
NOTE - You must do a <I>make install</I> and start QGIS from the installed location. In the case of the example above, the QGIS binary resides in the bin subdirectory of the directory specified with the prefix option (/usr/local/qgis/bin).
<P>
For information on using QGIS see the QGIS User Guide.
<P>
<H1><A NAME="SECTION000110000000000000000">
<H1><A NAME="SECTION000130000000000000000">
Building Plugins</A>
</H1>
The QGIS source distribution contains a number of "core" plugins. These are built along with QGIS using the instructions above. Additional external plugins are available from the QGIS community website at <TT><A NAME="tex2html16"
HREF="http://community.qgis.org">http://community.qgis.org</A></TT>. Instructions for building an external plugin can be found at <TT><A NAME="tex2html17"
The QGIS source distribution contains a number of "core" plugins. These are built along with QGIS using the instructions above. Additional external plugins are available from the QGIS community website at <TT><A NAME="tex2html21"
HREF="http://community.qgis.org">http://community.qgis.org</A></TT>. Instructions for building an external plugin can be found at <TT><A NAME="tex2html22"
HREF="http://wiki.qgis.org/qgiswiki/StepByStepBuildInstructions">http://wiki.qgis.org/qgiswiki/StepByStepBuildInstructions</A></TT>. Some external plugins may include instructions on building. If so, follow the instructions provided with the plugin rather than those provided in the wiki.
<H1><A NAME="SECTION000120000000000000000">
<H1><A NAME="SECTION000140000000000000000">
About this document ...</A>
</H1>
<STRONG>Building and Installing QGIS</STRONG><P>
@ -641,13 +711,13 @@ Copyright &#169; 1997, 1998, 1999,
Mathematics Department, Macquarie University, Sydney.
<P>
The command line arguments were: <BR>
<STRONG>latex2html</STRONG> <TT>-dir html -nonavigation -split 0 install.tex</TT>
<STRONG>latex2html</STRONG> <TT>-nonavigation -split 0 install.tex</TT>
<P>
The translation was initiated by Gary Sherman on 2004-12-19
The translation was initiated by Gary Sherman on 2005-09-01
<BR><HR>
<ADDRESS>
Gary Sherman
2004-12-19
2005-09-01
</ADDRESS>
</BODY>
</HTML>

238
doc/install_guide/install.html
View File

@ -37,71 +37,103 @@ Contents</A>
<!--Table of Contents-->
<UL>
<LI><A NAME="tex2html41"
<LI><A NAME="tex2html48"
HREF="install.html#SECTION00020000000000000000">Introduction</A>
<UL>
<LI><A NAME="tex2html42"
<LI><A NAME="tex2html49"
HREF="install.html#SECTION00021000000000000000">Installing Windows Version</A>
<LI><A NAME="tex2html43"
HREF="install.html#SECTION00022000000000000000">Installing Mac OSX Version</A>
<LI><A NAME="tex2html44"
<LI><A NAME="tex2html50"
HREF="install.html#SECTION00022000000000000000">Installing Mac OS X Version</A>
<LI><A NAME="tex2html51"
HREF="install.html#SECTION00023000000000000000">Building from Source</A>
</UL>
<BR>
<LI><A NAME="tex2html45"
HREF="install.html#SECTION00030000000000000000">Getting QGIS</A>
<LI><A NAME="tex2html46"
HREF="install.html#SECTION00040000000000000000">PostgreSQL</A>
<LI><A NAME="tex2html47"
HREF="install.html#SECTION00050000000000000000">GEOS</A>
<LI><A NAME="tex2html48"
HREF="install.html#SECTION00060000000000000000">PostGIS</A>
<LI><A NAME="tex2html49"
HREF="install.html#SECTION00070000000000000000">GRASS</A>
<LI><A NAME="tex2html50"
HREF="install.html#SECTION00080000000000000000">GDAL/OGR</A>
<LI><A NAME="tex2html51"
HREF="install.html#SECTION00090000000000000000">Qt</A>
<LI><A NAME="tex2html52"
HREF="install.html#SECTION000100000000000000000">Building QGIS</A>
<UL>
HREF="install.html#SECTION00030000000000000000">Getting QGIS</A>
<LI><A NAME="tex2html53"
HREF="install.html#SECTION000101000000000000000">Quick and Dirty</A>
HREF="install.html#SECTION00040000000000000000">PostgreSQL</A>
<LI><A NAME="tex2html54"
HREF="install.html#SECTION000102000000000000000">Configuring QGIS the Right Way</A>
HREF="install.html#SECTION00050000000000000000">GEOS</A>
<LI><A NAME="tex2html55"
HREF="install.html#SECTION00060000000000000000">PostGIS</A>
<LI><A NAME="tex2html56"
HREF="install.html#SECTION00070000000000000000">GRASS</A>
<LI><A NAME="tex2html57"
HREF="install.html#SECTION00080000000000000000">Proj4</A>
<LI><A NAME="tex2html58"
HREF="install.html#SECTION00090000000000000000">SQLite</A>
<LI><A NAME="tex2html59"
HREF="install.html#SECTION000100000000000000000">GDAL/OGR</A>
<LI><A NAME="tex2html60"
HREF="install.html#SECTION000110000000000000000">Qt</A>
<LI><A NAME="tex2html61"
HREF="install.html#SECTION000120000000000000000">Building QGIS</A>
<UL>
<LI><A NAME="tex2html62"
HREF="install.html#SECTION000121000000000000000">Quick and Dirty</A>
<LI><A NAME="tex2html63"
HREF="install.html#SECTION000122000000000000000">Configuring QGIS the Right Way</A>
</UL>
<BR>
<LI><A NAME="tex2html55"
HREF="install.html#SECTION000110000000000000000">Building Plugins</A>
<LI><A NAME="tex2html64"
HREF="install.html#SECTION000130000000000000000">Building Plugins</A>
</UL>
<!--End of Table of Contents-->
<P>
<P>
<H1><A NAME="SECTION00020000000000000000"></A><A NAME="label_introduction"></A>
<BR>
Introduction
</H1>
This document briefly describes how to build QGIS 0.6 (<I>`Simon'</I>) from the source distribution. These instructions are for Linux/Unix and other POSIX systems which have the required build environment.
The majority of this document is devoted to describing how to build QGIS 0.7
(<I>`Seamus'</I>) from the source distribution. These instructions are for
Linux/Unix and other POSIX systems which have the required build
environment. If you are building on FreeBSD, see
<TT><A NAME="tex2html1"
HREF="http://community.qgis.org/buildingOnFreeBSD.html">http://community.qgis.org/buildingOnFreeBSD.html</A></TT> for hints and further
information.
<P>
The latest version of this document can always be found at <TT><A NAME="tex2html1"
Installing on Windows and Mac OS X is a simple process as described
below.
<P>
You don't have to build all the QGIS dependencies from source. If your
platform provides packages at an acceptable version for the needed
dependencies, you can install them prior to building QGIS. Make sure you
also install the "development" package (if separate from the main package)
for each dependency. QGIS needs the header files from these packages in
order to build.
<P>
The latest version of this document can always be found at
<TT><A NAME="tex2html2"
HREF="http://qgis.org/docs/install.html">http://qgis.org/docs/install.html</A></TT>.
<H2><A NAME="SECTION00021000000000000000">
Installing Windows Version</A>
</H2>
Installing the Windows version of QGIS is simply a matter of running the user friendly setup wizard. See the README.WIN32 file for additional information regarding the Windows version of QGIS. At version 0.6, the GRASS plugin is not available in Windows.
Installing the Windows version of QGIS is simply a matter of running the
user friendly setup wizard. See the README.WIN32 file for additional
information regarding the Windows version of QGIS. At version 0.7, the GRASS
plugin is not available in Windows. Work on including the plugin in the next
version of QGIS is under way.
<P>
<H2><A NAME="SECTION00022000000000000000">
Installing Mac OSX Version</A>
Installing Mac OS X Version</A>
</H2>
To install the compressed disk image containing the OSX version of QGIS,
double-click to expand and mount the image, then drag QGIS application to your
hard drive. The OSX version does not include GRASS support.
double-click to expand and mount the image, then drag QGIS application to
your hard drive. If you want to build from source on Mac OS X, see
<TT><A NAME="tex2html3"
HREF="http://wiki.qgis.org/qgiswiki/BuildingOnMacOsX">http://wiki.qgis.org/qgiswiki/BuildingOnMacOsX</A></TT>. Installing the
compressed disk image is the easiest method and gives you the full
functionality of QGIS and all plugins, including GRASS. See the README file
included on the disk image for additional instructions.
<P>
@ -111,6 +143,9 @@ Building from Source</A>
The remainder of this document deals with compiling and installing QGIS from the
source code. Specifically this applies to Linux/Unix systems.
<P>
At 0.7, there are two new requirements: SQLite and Proj4. These must be built and installed prior to configuring QGIS.
<P>
QGIS can be installed with three levels of support for data stores:
@ -124,18 +159,21 @@ QGIS can be installed with three levels of support for data stores:
</OL>
<P>
Basic support uses the GDAL/OGR libraries and supports many raster and vector formats. For more information on the available formats, see <TT><A NAME="tex2html2"
HREF="http://www.remotesensing.org:16080/gdal/formats_list.html">http://www.remotesensing.org:16080/gdal/formats_list.html</A></TT> and <TT><A NAME="tex2html3"
HREF="http://www.remotesensing.org:16080/gdal/ogr/ogr_formats.html">http://www.remotesensing.org:16080/gdal/ogr/ogr_formats.html</A></TT>.
Basic support uses the GDAL/OGR libraries and supports many raster and
vector formats. For more information on the available formats, see
<TT><A NAME="tex2html4"
HREF="http://gdal.maptools.org/formats_list.html">http://gdal.maptools.org/formats_list.html</A></TT> and
<TT><A NAME="tex2html5"
HREF="http://gdal.maptools.org/ogr/ogr_formats.html">http://gdal.maptools.org/ogr/ogr_formats.html</A></TT>.
<P>
PostgreSQL/PostGIS support allows you to store spatial data in a PostgreSQL database. GRASS support provides access to GRASS mapsets.
<P>
<B>Note:</B> - If you plan to build QGIS with GRASS support, version 1.2.3 or higher of GDAL must be used.
<B>Note:</B> - If you plan to build QGIS with GRASS support, version 1.2.6 or higher of GDAL must be used.
<P>
Each of the requirements are discussed below. Note that the information given below is abstracted from the installation documentation for each of the libraries. See the install information for each library to get detailed instructions. In the documentation below, the file names and versions used are examples.
Each of the requirements is discussed below. Note that the information given below is abstracted from the installation documentation for each of the libraries. See the install information for each library to get detailed instructions. In the documentation below, the file names and versions used are examples.
<P>
If you are building QGIS without PostgreSQL or GRASS support, skip to the section on Installing GDAL/OGR.
@ -143,38 +181,43 @@ If you are building QGIS without PostgreSQL or GRASS support, skip to the sectio
<H1><A NAME="SECTION00030000000000000000">
Getting QGIS</A>
</H1>
QGIS is available in both source and package format from <TT><A NAME="tex2html4"
QGIS is available in both source and package format from <TT><A NAME="tex2html6"
HREF="http://qgis.org">http://qgis.org</A></TT>.
<P>
In addition, packages for many Linux distributions are independently maintained in various locations. See
the <I>Download</I> section on <TT><A NAME="tex2html5"
the <I>Download</I> section on <TT><A NAME="tex2html7"
HREF="http://qgis.org">http://qgis.org</A></TT> for the latest information on package locations.
<P>
Packages for most of the software/libraries discussed below can be found for almost all Linux distributions. While it is possible to mix compiling from source and installing packages to meet the requirements for QGIS, sometimes this becomes tricky. Following the steps below will generally ensure a successful installation. If you are using SuSE 9.1, the LinGIS distribution <TT><A NAME="tex2html6"
Packages for most of the software/libraries discussed below can be found for almost all Linux distributions. While it is possible to mix compiling from source and installing packages to meet the requirements for QGIS, sometimes this becomes tricky. Following the steps below will generally ensure a successful installation. If you are using SuSE 9.1, the LinGIS distribution <TT><A NAME="tex2html8"
HREF="ftp://ftp.lingis.org">ftp://ftp.lingis.org</A></TT> is a good choice for installing QGIS and its dependencies.
<P>
For information on installing dependencies and building QGIS on FreeBSD, see
<I>Building QGIS on FreeBSD</I> on <TT><A NAME="tex2html9"
HREF="http://community.qgis.org">http://community.qgis.org</A></TT>.
<P>
<H1><A NAME="SECTION00040000000000000000">
PostgreSQL</A>
</H1>
QGIS uses the latest features of PostgreSQL. For this reason, version 7.4.x or higher is recommended with QGIS version 0.5. If you choose to add PostgreSQL, you must also install PostGIS and the GEOS library (see below).
QGIS uses the latest features of PostgreSQL. For this reason, version 8.0.x or higher is recommended with QGIS version 0.7. If you choose to add PostgreSQL, you must also install PostGIS (see below).
<OL>
<LI>Download PostgreSQL source from www.postgresql.org
</LI>
<LI>Extract the source
<PRE>
tar -xzf postgresql-7.4.1.tar.gz
tar -xzf postgresql-8.0.1.tar.gz
</PRE>
<P>
</LI>
<LI>Change to the source directory
<PRE>
cd postgresql-7.4.1
cd postgresql-8.0.1
</PRE>
<P>
@ -271,7 +314,7 @@ PostgreSQL</A>
select version();
version
-------------------------------------------------------------------------------------
PostgreSQL 7.4.1 on i686-pc-linux-gnu, compiled by GCC gcc (GCC) 3.3.1 (SuSE Linux)
PostgreSQL 8.0.1 on i686-pc-linux-gnu, compiled by GCC gcc (GCC) 3.3.1 (SuSE Linux)
(1 row)
\q
@ -301,7 +344,7 @@ QGIS uses GEOS to properly fetch features from the the underlying datastore
To install GEOS:
<OL>
<LI>Download GEOS source from <TT><A NAME="tex2html7"
<LI>Download GEOS source from <TT><A NAME="tex2html10"
HREF="http://geos.refractions.net">http://geos.refractions.net</A></TT>
</LI>
<LI>Untar GEOS
@ -336,12 +379,12 @@ NOTE - You must edit the PostGIS Makefile and make sure that USE_GEOS=1 is
set. Also adjust GEOS_DIR to point to your GEOS installation directory.
<OL>
<LI>Download PostGIS source from <TT><A NAME="tex2html8"
<LI>Download PostGIS source from <TT><A NAME="tex2html11"
HREF="http://postgis.refractions.net">http://postgis.refractions.net</A></TT>
<P>
</LI>
<LI>Untar PostGIS into the contrib subdirectory of the postgresql build directory. The contrib subdirectory is located in the directory created in step 3 of the PostgreSQL installation process.
<LI>Untar PostGIS into the contrib subdirectory of the PostgreSQL build directory. The contrib subdirectory is located in the directory created in step 3 of the PostgreSQL installation process.
</LI>
<LI>Change to the postgis subdirectory
</LI>
@ -352,18 +395,18 @@ NOTE - You must edit the PostGIS Makefile and make sure that USE_GEOS=1 is
<LI>The quick and dirty steps to install PostGIS are:
<PRE>
cd contrib
gunzip postgis-0.8.0.tar.gz
tar xvf postgis-0.8.0.tar
cd postgis-0.8.0
gunzip postgis-1.0.2.tar.gz
tar xvf postgis-1.0.2.tar
cd postgis-1.0.2
make
make install
createlang plpgsql yourtestdatabase
psql -d yourtestdatabase -f postgis.sql
psql -d yourtestdatabase -f lwpostgis.sql
psql -d yourtestdatabase -f spatial_ref_sys.sql
</PRE>
</LI>
</OL>
The <B>better way</B> to install PostGIS is to carefully follow the instructions in the PostGIS manual in the doc/html subdirectory or the online manual at <TT><A NAME="tex2html9"
The <B>better way</B> to install PostGIS is to carefully follow the instructions in the PostGIS manual in the doc/html subdirectory or the online manual at <TT><A NAME="tex2html12"
HREF="http://postgis.refractions.net/docs">http://postgis.refractions.net/docs</A></TT>
<P>
@ -371,30 +414,53 @@ The <B>better way</B> to install PostGIS is to carefully follow the instructions
GRASS</A>
</H1>
If you want QGIS to support GRASS vector and raster layers, you must build GRASS prior to proceeding.
Follow the directions on the GRASS website carefully to build version 5.7. Additional information and the build instructions can be found at <TT><A NAME="tex2html10"
Follow the directions on the GRASS website carefully to build version 6.0.x. Additional information and the build instructions can be found at <TT><A NAME="tex2html13"
HREF="http://grass.itc.it">http://grass.itc.it</A></TT>.
<P>
The GRASS software is available for download at <TT><A NAME="tex2html11"
The GRASS software is available for download at <TT><A NAME="tex2html14"
HREF="http://grass.itc.it/download.html">http://grass.itc.it/download.html</A></TT>.
<P>
<H1><A NAME="SECTION00080000000000000000">
Proj4</A>
</H1>
Proj4 provides the functions needed for on the fly projection of map layers in version 0.7. To build and install Proj4, download the latest version from <TT><A NAME="tex2html15"
HREF="http://proj.maptools.org">http://proj.maptools.org</A></TT>, untar the distribution and:
<PRE>
./configure
make
make install
</PRE>
<H1><A NAME="SECTION00090000000000000000">
SQLite</A>
</H1>
Sqlite is used to manage the projections database and store persistent data such as spatial bookmarks. Download the latest (3.x) version of SQLite from <TT><A NAME="tex2html16"
HREF="http://www.sqlite.org/">http://www.sqlite.org/</A></TT>. Untar the distribution and:
<PRE>
./configure
make
make install
</PRE>
Note - SQLite 3.x is included on Mac OS X 10.4.
<H1><A NAME="SECTION000100000000000000000">
GDAL/OGR</A>
</H1>
The GDAL and OGR libraries provide support for raster and vector data formats. QGIS makes use of both of these libraries (which come bundled in one distribution).
<P>
Note: A Linux binary of GDAL is available at <TT><A NAME="tex2html12"
Note: A Linux binary of GDAL is available at <TT><A NAME="tex2html17"
HREF="http://www.remotesensing.org/gdal">http://www.remotesensing.org/gdal</A></TT>. If you choose to install the binary you will also need to download and unpack the source tree since QGIS needs the header files in order to compile.
<P>
To install GDAL/OGR from source:
<OL>
<LI>Download the GDAL distribution from <TT><A NAME="tex2html13"
HREF="http://www.remotesensing.org/gdal">http://www.remotesensing.org/gdal</A></TT>. You should use version 1.1.9 or higher. Versions prior to 1.1.9 contained a bug that caused problems when a null feature was encountered. If you want to build vector support for GRASS, you must use GDAL 1.2.3.
<LI>Download the GDAL distribution from
<TT><A NAME="tex2html18"
HREF="http://www.remotesensing.org/gdal">http://www.remotesensing.org/gdal</A></TT>. You should use the latest
version of GDAL if possible. The minimum recommended version for use
with QGIS is 1.2.6.
<P>
</LI>
@ -420,7 +486,9 @@ To install GDAL/OGR from source:
<PRE>
./configure --with-grass=&lt;full path to grass install&gt;
</PRE>
Depending on the GDAL version you are building, it may be necessary to specify -without-ogdi when running configure if you don't have the OGDI libary avaiable on your system.
Depending on the GDAL version you are building, it may be necessary to
specify -without-ogdi when running configure if you don't have the OGDI
library available on your system.
<P>
</LI>
@ -458,15 +526,15 @@ To install GDAL/OGR from source:
</OL>
<P>
If you've had problems during the installation, refer to this manual, where the whole process is described with some more detail: <TT><A NAME="tex2html14"
If you've had problems during the installation, refer to this manual, where the whole process is described with some more detail: <TT><A NAME="tex2html19"
HREF="http://www.remotesensing.org/gdal/gdal_building.html">http://www.remotesensing.org/gdal/gdal_building.html</A></TT>
<P>
<H1><A NAME="SECTION00090000000000000000">
<H1><A NAME="SECTION000110000000000000000">
Qt</A>
</H1>
Qt 3.1.2 or higher is required in order to compile QGIS. You may already have Qt on your system. If so, check to see if you have version 3.1.2 or later. You can check the Qt version using the find command:
Qt 3.2.1 or higher is required in order to compile QGIS. You may already have Qt on your system. If so, check to see if you have version 3.2.1 or later. You can check the Qt version using the find command:
<PRE>
find ./ -name qglobal.h 2&gt;/dev/null | xargs grep QT_VERSION_STR
</PRE>
@ -487,7 +555,7 @@ If Qt is not installed, you will have to install the Qt development package for
To install Qt from source:
<OL>
<LI>Download Qt from <TT><A NAME="tex2html15"
<LI>Download Qt from <TT><A NAME="tex2html20"
HREF="http://www.trolltech.com/developer">http://www.trolltech.com/developer</A></TT> (choose the Qt/X11 Free Edition)
</LI>
<LI>Unpack the distribution
@ -505,17 +573,19 @@ To install Qt from source:
</LI>
</OL>
NOTE - QGIS will not compile under Qt 4.0.x. The best choice for compiling
QGIS is Qt 3.3.x.
<P>
<H1><A NAME="SECTION000100000000000000000">
<H1><A NAME="SECTION000120000000000000000">
Building QGIS</A>
</H1>
<P>
After you have installed the required libraries, you are ready to build QGIS. Download and untar the QGIS distribution and change to the QGIS source directory. You have two options for building and installing QGIS: <B>Quick and Dirty</B> and the <B>right way</B>.
<H2><A NAME="SECTION000101000000000000000">
<H2><A NAME="SECTION000121000000000000000">
Quick and Dirty</A>
</H2>
If you don't need PostgreSQL support and have installed GDAL ,
@ -528,7 +598,7 @@ Quick and Dirty</A>
The above assumes that the gdal-config program is in your PATH
See the next section for the full configuration instructions.
<H2><A NAME="SECTION000102000000000000000">
<H2><A NAME="SECTION000122000000000000000">
Configuring QGIS the Right Way</A>
</H2>
To see the configure options available, change the the QGIS
@ -549,7 +619,7 @@ Configuring QGIS the Right Way</A>
<P>
<H3><A NAME="SECTION000102100000000000000">
<H3><A NAME="SECTION000122100000000000000">
Qt</A>
</H3>
The configure script will detect Qt, unless it is installed in a
@ -557,7 +627,7 @@ Qt</A>
make ensure that the detection succeeds. You can also specify the
path using the -with-qtdir option.
<H3><A NAME="SECTION000102200000000000000">
<H3><A NAME="SECTION000122200000000000000">
GDAL</A>
</H3>
If the gdal-config script is in the PATH, configure will automatically
@ -566,7 +636,7 @@ GDAL</A>
<PRE>
/configure --with-gdal=/usr/mystuff/bin/gdal-config
</PRE>
<H3><A NAME="SECTION000102300000000000000">
<H3><A NAME="SECTION000122300000000000000">
PostgreSQL</A>
</H3>
If the pg_config script is in the PATH, configure will automatically
@ -575,16 +645,16 @@ PostgreSQL</A>
<PRE>
./configure --with-pg=/usr/local/psql/bin/pg_config
</PRE>
<H3><A NAME="SECTION000102400000000000000">
<H3><A NAME="SECTION000122400000000000000">
GRASS</A>
</H3>
To build QGIS with GRASS support you must specify the full path to the installed GRASS binary package:
<PRE>
./configure --with-grass=/usr/local/grass-5.7.0
./configure --with-grass=/usr/local/grass-6.0.0
</PRE>
This assumes that GRASS is installed in the default location. Change the path to match the location of your GRASS installation.
<H3><A NAME="SECTION000102500000000000000">
<H3><A NAME="SECTION000122500000000000000">
Example Use of Configure</A>
</H3>
An example of use of configure for building QGIS with all options:
@ -592,7 +662,7 @@ Example Use of Configure</A>
./configure --prefix=/usr/local/qgis \
--with-gdal=/usr/local/gdal/bin/gdal-config \
--with-pg=/usr/local/psql/bin/pg_config \
--with-grass=/usr/local/grass-5.7.0
--with-grass=/usr/local/grass-6.0.0
</PRE>
This will configure QGIS to use GDAL, GRASS, and PostgreSQL. QGIS will be
installed in /usr/local/qgis.
@ -603,7 +673,7 @@ If QTDIR is set and gdal-config and pg_config are both
options. The configure script will properly detect and configure
GDAL and PostgreSQL. You must still use the -with-grass option if building with GRASS support.
<H3><A NAME="SECTION000102600000000000000">
<H3><A NAME="SECTION000122600000000000000">
Compiling and Installing QGIS</A>
</H3>
Once properly configured simply issue the following commands:
@ -611,21 +681,21 @@ Compiling and Installing QGIS</A>
make
make install
</PRE>
NOTE - As of version 0.1, you can no longer run QGIS from the src directory. You must do a make install and start QGIS from the installed location. In the case of the example above, the QGIS binary resides in the bin subdirectory of the directory specified with the prefix option (/usr/local/qgis/bin).
NOTE - You must do a <I>make install</I> and start QGIS from the installed location. In the case of the example above, the QGIS binary resides in the bin subdirectory of the directory specified with the prefix option (/usr/local/qgis/bin).
<P>
For information on using QGIS see the QGIS User Guide.
<P>
<H1><A NAME="SECTION000110000000000000000">
<H1><A NAME="SECTION000130000000000000000">
Building Plugins</A>
</H1>
The QGIS source distribution contains a number of "core" plugins. These are built along with QGIS using the instructions above. Additional external plugins are available from the QGIS community website at <TT><A NAME="tex2html16"
HREF="http://community.qgis.org">http://community.qgis.org</A></TT>. Instructions for building an external plugin can be found at <TT><A NAME="tex2html17"
The QGIS source distribution contains a number of "core" plugins. These are built along with QGIS using the instructions above. Additional external plugins are available from the QGIS community website at <TT><A NAME="tex2html21"
HREF="http://community.qgis.org">http://community.qgis.org</A></TT>. Instructions for building an external plugin can be found at <TT><A NAME="tex2html22"
HREF="http://wiki.qgis.org/qgiswiki/StepByStepBuildInstructions">http://wiki.qgis.org/qgiswiki/StepByStepBuildInstructions</A></TT>. Some external plugins may include instructions on building. If so, follow the instructions provided with the plugin rather than those provided in the wiki.
<H1><A NAME="SECTION000120000000000000000">
<H1><A NAME="SECTION000140000000000000000">
About this document ...</A>
</H1>
<STRONG>Building and Installing QGIS</STRONG><P>
@ -641,13 +711,13 @@ Copyright &#169; 1997, 1998, 1999,
Mathematics Department, Macquarie University, Sydney.
<P>
The command line arguments were: <BR>
<STRONG>latex2html</STRONG> <TT>-dir html -nonavigation -split 0 install.tex</TT>
<STRONG>latex2html</STRONG> <TT>-nonavigation -split 0 install.tex</TT>
<P>
The translation was initiated by Gary Sherman on 2004-12-19
The translation was initiated by Gary Sherman on 2005-09-01
<BR><HR>
<ADDRESS>
Gary Sherman
2004-12-19
2005-09-01
</ADDRESS>
</BODY>
</HTML>

13
doc/qgisdoc.css
View File

@ -1,3 +1,16 @@
body{
font-family: trebuchet,arial,helvetica,sans;
font-size: 11pt;
}
.normal{
font-size: 11pt;
}
.warning{
font-family: trebuchet,arial,helvetica,sans;
font-size: 12pt;
font-weight: bold;
color: #800000;
}
span.header{
font-family: trebuchet,arial,helvetica,sans;
font-size: 18pt;

2
doc/source/install_guide/install.tex
View File

@ -73,7 +73,7 @@
%Set up page headers
\usepackage{fancyhdr}
% \fancyhead[L,R]{\slshape \rightmark}
\fancyhead[L]{\slshape Building QGIS 0.5}
\fancyhead[L]{\slshape Building QGIS 0.7}
%
% \fancyfoot[L,L]{\slshape}
% \fancyfoot[C]{\page}

110
doc/source/install_guide/install_source.tex
View File

@ -1,15 +1,42 @@
% vim:textwidth=76:autoindent
\section{Introduction}\label{label_introduction}
This document briefly describes how to build QGIS 0.6 (\textit{`Simon'}) from the source distribution. These instructions are for Linux/Unix and other POSIX systems which have the required build environment.
The majority of this document is devoted to describing how to build QGIS 0.7
(\textit{`Seamus'}) from the source distribution. These instructions are for
Linux/Unix and other POSIX systems which have the required build
environment. If you are building on FreeBSD, see
\url{http://community.qgis.org/buildingOnFreeBSD.html} for hints and further
information.
The latest version of this document can always be found at \url{http://qgis.org/docs/install.html}.
%\textsc{NOTE - All of the required packages for SuSE 9.1 are available at }\url{ftp://ftp.lingis.org}
Installing on Windows and Mac OS X is a simple process as described
below.
You don't have to build all the QGIS dependencies from source. If your
platform provides packages at an acceptable version for the needed
dependencies, you can install them prior to building QGIS. Make sure you
also install the "development" package (if separate from the main package)
for each dependency. QGIS needs the header files from these packages in
order to build.
The latest version of this document can always be found at
\url{http://qgis.org/docs/install.html}.
%\textsc{NOTE - All of the required packages for SuSE 9.1 are available at
%}\url{ftp://ftp.lingis.org}
\subsection{Installing Windows Version}
Installing the Windows version of QGIS is simply a matter of running the user friendly setup wizard. See the README.WIN32 file for additional information regarding the Windows version of QGIS. At version 0.6, the GRASS plugin is not available in Windows.
\subsection{Installing Mac OSX Version}
Installing the Windows version of QGIS is simply a matter of running the
user friendly setup wizard. See the README.WIN32 file for additional
information regarding the Windows version of QGIS. At version 0.7, the GRASS
plugin is not available in Windows. Work on including the plugin in the next
version of QGIS is under way.
\subsection{Installing Mac OS X Version}
To install the compressed disk image containing the OSX version of QGIS,
double-click to expand and mount the image, then drag QGIS application to your
hard drive. The OSX version does not include GRASS support.
double-click to expand and mount the image, then drag QGIS application to
your hard drive. If you want to build from source on Mac OS X, see
\url{http://wiki.qgis.org/qgiswiki/BuildingOnMacOsX}. Installing the
compressed disk image is the easiest method and gives you the full
functionality of QGIS and all plugins, including GRASS. See the README file
included on the disk image for additional instructions.
%This document does not contain instructions for building the GRASS plugins. Information on building the GRASS plugin with raster and vector support can be found in the \textit{Building QGIS with GRASS Support} document, available at \url{http://community.qgis.org/grass_plugin}.
@ -17,6 +44,7 @@ hard drive. The OSX version does not include GRASS support.
The remainder of this document deals with compiling and installing QGIS from the
source code. Specifically this applies to Linux/Unix systems.
At 0.7, there are two new requirements: SQLite and Proj4. These must be built and installed prior to configuring QGIS.
QGIS can be installed with three levels of support for data stores:
\begin{enumerate}
@ -25,13 +53,16 @@ QGIS can be installed with three levels of support for data stores:
\item GRASS raster and vector support
\end{enumerate}
Basic support uses the GDAL/OGR libraries and supports many raster and vector formats. For more information on the available formats, see \url{http://www.remotesensing.org:16080/gdal/formats\_list.html} and \url{http://www.remotesensing.org:16080/gdal/ogr/ogr\_formats.html}.
Basic support uses the GDAL/OGR libraries and supports many raster and
vector formats. For more information on the available formats, see
\url{http://gdal.maptools.org/formats_list.html} and
\url{http://gdal.maptools.org/ogr/ogr_formats.html}.
PostgreSQL/PostGIS support allows you to store spatial data in a PostgreSQL database. GRASS support provides access to GRASS mapsets.
\textbf{Note:} - If you plan to build QGIS with GRASS support, version 1.2.3 or higher of GDAL must be used.
\textbf{Note:} - If you plan to build QGIS with GRASS support, version 1.2.6 or higher of GDAL must be used.
Each of the requirements are discussed below. Note that the information given below is abstracted from the installation documentation for each of the libraries. See the install information for each library to get detailed instructions. In the documentation below, the file names and versions used are examples.
Each of the requirements is discussed below. Note that the information given below is abstracted from the installation documentation for each of the libraries. See the install information for each library to get detailed instructions. In the documentation below, the file names and versions used are examples.
If you are building QGIS without PostgreSQL or GRASS support, skip to the section on Installing GDAL/OGR.
@ -43,19 +74,21 @@ the \textit{Download} section on \url{http://qgis.org} for the latest informatio
Packages for most of the software/libraries discussed below can be found for almost all Linux distributions. While it is possible to mix compiling from source and installing packages to meet the requirements for QGIS, sometimes this becomes tricky. Following the steps below will generally ensure a successful installation. If you are using SuSE 9.1, the LinGIS distribution \url{ftp://ftp.lingis.org} is a good choice for installing QGIS and its dependencies.
For information on installing dependencies and building QGIS on FreeBSD, see
\textit{Building QGIS on FreeBSD} on \url{http://community.qgis.org}.
\section{PostgreSQL}
QGIS uses the latest features of PostgreSQL. For this reason, version 7.4.x or higher is recommended with QGIS version 0.5. If you choose to add PostgreSQL, you must also install PostGIS and the GEOS library (see below).
QGIS uses the latest features of PostgreSQL. For this reason, version 8.0.x or higher is recommended with QGIS version 0.7. If you choose to add PostgreSQL, you must also install PostGIS (see below).
\begin{enumerate}
\item Download PostgreSQL source from www.postgresql.org
\item Extract the source
\begin{verbatim}
tar -xzf postgresql-7.4.1.tar.gz
tar -xzf postgresql-8.0.1.tar.gz
\end{verbatim}
\item Change to the source directory
\begin{verbatim}
cd postgresql-7.4.1
cd postgresql-8.0.1
\end{verbatim}
\item Configure PostgreSQL:
@ -125,7 +158,7 @@ Packages for most of the software/libraries discussed below can be found for alm
select version();
version
-------------------------------------------------------------------------------------
PostgreSQL 7.4.1 on i686-pc-linux-gnu, compiled by GCC gcc (GCC) 3.3.1 (SuSE Linux)
PostgreSQL 8.0.1 on i686-pc-linux-gnu, compiled by GCC gcc (GCC) 3.3.1 (SuSE Linux)
(1 row)
\q
@ -169,20 +202,20 @@ Packages for most of the software/libraries discussed below can be found for alm
\begin{enumerate}
\item Download PostGIS source from \url{http://postgis.refractions.net}
\item Untar PostGIS into the contrib subdirectory of the postgresql build directory. The contrib subdirectory is located in the directory created in step 3 of the PostgreSQL installation process.
\item Untar PostGIS into the contrib subdirectory of the PostgreSQL build directory. The contrib subdirectory is located in the directory created in step 3 of the PostgreSQL installation process.
\item Change to the postgis subdirectory
\item Edit the Makefile to enable GEOS support (see the note above)
\item PostGIS provides a manual in the doc/html subdirectory that explains the build process (see the Installation section)
\item The quick and dirty steps to install PostGIS are:
\begin{verbatim}
cd contrib
gunzip postgis-0.8.0.tar.gz
tar xvf postgis-0.8.0.tar
cd postgis-0.8.0
gunzip postgis-1.0.2.tar.gz
tar xvf postgis-1.0.2.tar
cd postgis-1.0.2
make
make install
createlang plpgsql yourtestdatabase
psql -d yourtestdatabase -f postgis.sql
psql -d yourtestdatabase -f lwpostgis.sql
psql -d yourtestdatabase -f spatial_ref_sys.sql
\end{verbatim}
\end{enumerate}
@ -190,10 +223,24 @@ The \textbf{better way} to install PostGIS is to carefully follow the instructio
\section{GRASS}
If you want QGIS to support GRASS vector and raster layers, you must build GRASS prior to proceeding.
Follow the directions on the GRASS website carefully to build version 5.7. Additional information and the build instructions can be found at \url{http://grass.itc.it}.
Follow the directions on the GRASS website carefully to build version 6.0.x. Additional information and the build instructions can be found at \url{http://grass.itc.it}.
The GRASS software is available for download at \url{http://grass.itc.it/download.html}.
\section{Proj4}
Proj4 provides the functions needed for on the fly projection of map layers in version 0.7. To build and install Proj4, download the latest version from \url{http://proj.maptools.org}, untar the distribution and:
\begin{verbatim}
./configure
make
make install
\end{verbatim}
\section{SQLite}
Sqlite is used to manage the projections database and store persistent data such as spatial bookmarks. Download the latest (3.x) version of SQLite from \url{http://www.sqlite.org/}. Untar the distribution and:
\begin{verbatim}
./configure
make
make install
\end{verbatim}
Note - SQLite 3.x is included on Mac OS X 10.4.
\section{GDAL/OGR}
The GDAL and OGR libraries provide support for raster and vector data formats. QGIS makes use of both of these libraries (which come bundled in one distribution).
@ -201,7 +248,10 @@ The GRASS software is available for download at \url{http://grass.itc.it/downloa
To install GDAL/OGR from source:
\begin{enumerate}
\item Download the GDAL distribution from \url{http://www.remotesensing.org/gdal}. You should use version 1.1.9 or higher. Versions prior to 1.1.9 contained a bug that caused problems when a null feature was encountered. If you want to build vector support for GRASS, you must use GDAL 1.2.3.
\item Download the GDAL distribution from
\url{http://www.remotesensing.org/gdal}. You should use the latest
version of GDAL if possible. The minimum recommended version for use
with QGIS is 1.2.6.
\item Untar the distribution
\begin{verbatim}
@ -221,7 +271,9 @@ The GRASS software is available for download at \url{http://grass.itc.it/downloa
\begin{verbatim}
./configure --with-grass=<full path to grass install>
\end{verbatim}
Depending on the GDAL version you are building, it may be necessary to specify --without-ogdi when running configure if you don't have the OGDI libary avaiable on your system.
Depending on the GDAL version you are building, it may be necessary to
specify --without-ogdi when running configure if you don't have the OGDI
library available on your system.
\item Build and install GDAL:
\begin{verbatim}
@ -251,7 +303,7 @@ The GRASS software is available for download at \url{http://grass.itc.it/downloa
If you've had problems during the installation, refer to this manual, where the whole process is described with some more detail: \url{http://www.remotesensing.org/gdal/gdal\_building.html}
\section{Qt}
Qt 3.1.2 or higher is required in order to compile QGIS. You may already have Qt on your system. If so, check to see if you have version 3.1.2 or later. You can check the Qt version using the find command:
Qt 3.2.1 or higher is required in order to compile QGIS. You may already have Qt on your system. If so, check to see if you have version 3.2.1 or later. You can check the Qt version using the find command:
\begin{verbatim}
find ./ -name qglobal.h 2>/dev/null | xargs grep QT_VERSION_STR
\end{verbatim}
@ -279,6 +331,8 @@ The GRASS software is available for download at \url{http://grass.itc.it/downloa
\item Complete the installation per the instructions provided in the Qt documentation (see step 3)
\end{enumerate}
NOTE - QGIS will not compile under Qt 4.0.x. The best choice for compiling
QGIS is Qt 3.3.x.
\section{Building QGIS}
@ -333,7 +387,7 @@ The GRASS software is available for download at \url{http://grass.itc.it/downloa
\subsubsection{GRASS}
To build QGIS with GRASS support you must specify the full path to the installed GRASS binary package:
\begin{verbatim}
./configure --with-grass=/usr/local/grass-5.7.0
./configure --with-grass=/usr/local/grass-6.0.0
\end{verbatim}
This assumes that GRASS is installed in the default location. Change the path to match the location of your GRASS installation.
\subsubsection{Example Use of Configure}
@ -342,7 +396,7 @@ This assumes that GRASS is installed in the default location. Change the path to
./configure --prefix=/usr/local/qgis \
--with-gdal=/usr/local/gdal/bin/gdal-config \
--with-pg=/usr/local/psql/bin/pg_config \
--with-grass=/usr/local/grass-5.7.0
--with-grass=/usr/local/grass-6.0.0
\end{verbatim}
This will configure QGIS to use GDAL, GRASS, and PostgreSQL. QGIS will be
installed in /usr/local/qgis.
@ -357,7 +411,7 @@ This assumes that GRASS is installed in the default location. Change the path to
make
make install
\end{verbatim}
NOTE - As of version 0.1, you can no longer run QGIS from the src directory. You must do a make install and start QGIS from the installed location. In the case of the example above, the QGIS binary resides in the bin subdirectory of the directory specified with the prefix option (/usr/local/qgis/bin).
NOTE - You must do a \textit{make install} and start QGIS from the installed location. In the case of the example above, the QGIS binary resides in the bin subdirectory of the directory specified with the prefix option (/usr/local/qgis/bin).
For information on using QGIS see the QGIS User Guide.

18
doc/source/user_guide/introduction.tex
View File

@ -1,13 +1,15 @@
% vim: set textwidth=78 autoindent:
\chapter{Introduction To GIS}
A Geographical Information System (GIS) is a collection of software that
allows you to create, visualise, query and analyse geospatial data. Geospatial
data refers to information about the geographic location of an entity. This
often involves the use of a geographic coordinate, like a latitude or
longitude value. Spatial data is another commonly used term, as are:
geographic data, GIS data, map data, location data, coordinate data and
spatial geometry data.
A Geographical Information System (GIS)\footnote{This chapter is by Tyler Mitchell
(\url{http://www.oreillynet.com/pub/wlg/7053}) and
used under the Creative Commons License. Tyler is the author of \textit{Web
Mapping Illustrated}, published by O'Reilly, 2005.}
is a collection of software that allows you to create, visualise, query and
analyse geospatial data. Geospatial data refers to information about the
geographic location of an entity. This often involves the use of a geographic
coordinate, like a latitude or longitude value. Spatial data is another
commonly used term, as are: geographic data, GIS data, map data, location
data, coordinate data and spatial geometry data.
Applications using geospatial data perform a variety of functions. Map
production is the most easily understood function of geospatial applications.

92
doc/source/user_guide/map_composer.tex Normal file
View File

@ -0,0 +1,92 @@
% vim:autoindent:set textwidth=78:
\chapter{Map Composer}
The map composer is a feature that provides improved layout and printing
capabilities. The composer allows you to add elements such as the QGIS map
canvas, legend, scalebar, and text. You can size and position each item and
adjust the properties to create your layout. The result can be printed,
exported as an image, or exported to SVG.
To access the map composer, click on the \textit{Print} button in the toolbar
or choose \textit{Print} from the \textit{File} menu.
\section{Using Map Composer} To use the map composer, first add the layers you
want to print to QGIS. The layes should be rendered and symbolized to your
liking prior to composing the map.
\begin{figure}[h]
\begin{center}
\caption{Map Composer}\label{fig:map_composer_blank}\smallskip
\includegraphics[scale=.70]{qgis_user_guide_images/map_composer_blank}
\end{center}
\end{figure}
Opening the map composer provides you with a blank canvas to which you can add
the current map view, legend, scalebar, and text. Figure
\ref{fig:map_composer_blank} shows the initial view of the map composer before
any elements are added.
The map composer has two tabs: \textit{General} and \textit{Item}. The
\textit{General} tab allows you to set the paper size, orientation, and
resolution for the map. The \textit{Item} tab displays the properties for the
currently selected map element. By selecting an element on the map (eg.
legend, scalebar, text, etc.) and clicking on the \textit{Item} tab, you can
customize the settings.
You can add multiple elements to the composer. This allows you to have more
than one map view and legend in the composer. Each element has its own
properties and in the case of the map, its own extent.
\subsection{Adding a Map to the Composer}
\parpic[l]{\includegraphics{qgis_user_guide_images/composer_add_map}}To add the QGIS map canvas to the map composer, click on the \textit{Add a new
map} button in toolbar. Drag a rectangle on the composer canvas to add the
map. You can resize the map later by clicking on the \textit{Select/move item}
button, clicking on the map, and dragging one of the handles in the corner of
the map. With the map selected, you can also resize the map by specifying the
width and height on the Item properties tab.
The map is linked to the QGIS map canvas. If you change the view on the map
canvas by zooming or panning, you can update the map composer view by
selecting the map in composer and clicking on the \textit{Set Extent} button.
You can also change the composer view by specifying a map scale. To set the
view to a specific scale:
\begin{compactenum}
\item Choose \textit{Scale (calculate extent)} from the \textit{Set} drop-down
box
\item Enter the scale denominator in the scale box
\item Press Enter
\end{compactenum}
\subsection{Adding other Elements to the Composer}
\parpic[l]{\includegraphics{qgis_user_guide_images/composer_add_legend}}A
legend can be added to the composer canvas and customized to show only the
desired layers. To add a legend, click on the \textit{Add Vector Legend}
button. The legend will be placed on the composer canvas and you can move it
where you like. Click on the \textit{Items} tab to customize the appearance of
the legend, including which layers are shown.
\parpic[l]{\includegraphics{qgis_user_guide_images/composer_add_scalebar}}To add
a scalebar to the composer, click on the \textit{Add Scalebar} button. Use the
\textit{Item} tab to customize the segment size, number of segments, scalebar
units, size, and font for the scalebar.
\parpic[l]{\includegraphics{qgis_user_guide_images/composer_add_text}}You can
add text labels to the composer by clicking on the \textit{Add New Label}
button. Use the \textit{Item} tab while the text is selected to customize the
settings or change the default text.
Figure \ref{fig:map_composer_complete} shows the map composer after adding
each type of map element.
\begin{figure}[h]
\begin{center}
\caption{Map Composer with map view, legend, scalebar, and text added. The
map view is currently selected (note the blue rectangles in each corner)}\label{fig:map_composer_complete}\smallskip
\includegraphics[scale=.70]{qgis_user_guide_images/map_composer}
\end{center}
\end{figure}
\subsection{Other Features}
The map composer has navigation tools to zoom in and out. To zoom in, click
the zoom in tool. The map composer canvas will be scaled by a factor to 2. Use
the scrollbars to adjust the view to the area of interest. Zooming out works
in a similar fashion.
If you find the view in an inconsistent state, you can use the refresh button
to redraw the map composer canvas.
\subsection{Creating Output}
The map composer allows you to print the map to a printer, export to a PNG, or
export to SVG. Each of these functions is available from the composer toolbar.

3
doc/source/user_guide/qgis_user_guide.tex
View File

@ -10,7 +10,7 @@
\usepackage{paralist}
\usepackage{color}
\usepackage{hyperref}
\hypersetup{backref,colorlinks=true}
\hypersetup{backref,colorlinks=true}
\usepackage{ae,aecompl}
\usepackage{graphicx}
\usepackage{picins}
@ -75,6 +75,7 @@ Quantum GIS User Guide\\
\input{working_with_raster.tex}
\input{working_with_projections.tex}
\input{grass_integration.tex}
\input{map_composer.tex}
%first the general intro to plugins
%then each individual plugin can have a section
%in the plugins chapter

BIN
doc/source/user_guide/qgis_user_guide_images/composer_add_legend.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 417 B

BIN
doc/source/user_guide/qgis_user_guide_images/composer_add_map.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 518 B

BIN
doc/source/user_guide/qgis_user_guide_images/composer_add_scalebar.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 469 B

BIN
doc/source/user_guide/qgis_user_guide_images/composer_add_text.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 474 B

BIN
doc/source/user_guide/qgis_user_guide_images/map_composer.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 84 KiB

BIN
doc/source/user_guide/qgis_user_guide_images/map_composer_blank.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 36 KiB

60
doc/source/user_guide/working_with_projections.tex
View File

@ -1,19 +1,21 @@
% vim:autoindent:set textwidth=78:
\chapter{Working with Projections}
QGIS supports on the fly projection of vector layers. This feature allows you
\chapter{Working with Projections}\label{chp:projections}\index{Projections!working with}
QGIS supports on-the-fly projection of vector layers. This feature allows you
to display layers with different coordinate systems and have them overlay
properly.
\section{Overview of Projection Support}
QGIS has support for approximately 2,700 known projections.
Projections are stored in a Sqlite database that is installed with QGIS.
Appendix \ref{app:datamodel} contains information about the database and the
schema. Normally you do not need to manipulate the database directly. In fact,
%Appendix \ref{app:datamodel} contains information about the database and the schema.
Normally you do not need to manipulate the database directly. In fact,
doing so may cause projection support to fail. Custom projections are
stored in a user database. See Section \ref{sec:custom_projections} for
stored in a user database. See Section \ref{sec:customprojections} for
information on managing your custom projections.
The projections available in QGIS are based on those defined by EPSG and are
largely abstracted from the spatial\_references table in PostGIS version 1.x.
The projections available in QGIS are based on those defined by
EPSG\index{EPSG} and are
largely abstracted from the spatial\_references table in
PostGIS\index{PostGIS} version 1.x.
Note that the identifiers used in QGIS do not correspond to the EPSG or
PostGIS spatial reference identifiers. The EPSG and PostGIS identifiers are
present in the database and can be used to specify a projection in QGIS.
@ -23,7 +25,7 @@ coordinate system. For PostGIS layers QGIS uses the spatial reference
identifier that was specified when the layer was created. For data supported
by OGR, QGIS relies on the presence of a format specific means of specifying
the coordinate system. In the case of shapefiles, this means a file containing
the Well Known Text (WKT) specification of the the coordinate system. The
the Well Known Text (WKT)\index{WKT} specification of the the coordinate system. The
projection file has the same base name as the shapefile and a prj extension.
For example, a shapefile named lakes.shp would have a corresponding projection
file named lakes.prj.
@ -59,7 +61,7 @@ The Projection dialog contains four important components as numbered in Figure
\end{center}
\end{figure}
\begin{compactenum}
\item Enable projections - this checkbox is used to enable or disable OTF
\item Enable projections\index{Projections!enabling} - this checkbox is used to enable or disable OTF
projection. When off, no projection takes place and each layer
is drawn using the coordinates as read from the data source. When on, the
coordinates in each layer are projected to the coordinate system of the map
@ -75,7 +77,7 @@ you can use the search feature to find it. Enter the identifier and click on
\textit{Find}.
\end{compactenum}
\subsection{Specifying a Projection}
\subsection{Specifying a Projection}\index{Projections!specifying}
QGIS automatically sets the map projection to the coordinate system of the first
layer loaded. One way to specify the map projection is to first load a layer
with the projection you want for the entire map. Then open the \textit{Project Properties}
@ -88,6 +90,40 @@ If you have already added layers and want to enable OTF projection, open the
coordinate system you want to use in the list of projections. Alternatively
you can use the search feature as described in the previous section.
\section{Custom Projections}
\section{Custom
Projections}\label{sec:customprojections}\index{Projections!custom}
If QGIS doesn't have the projection you need, you can define a custom
projection.
projection. To define a projection, select \textit{Custom Projections} from
the \textit{Settings} menu. Custom projections are stored in your QGIS user
database. In addition to your projections, this database contains your spatial
bookmarks and other custom data.
At version 0.7 of QGIS, defining a custom projection requires a good
understanding of the Proj.4 projection library. To begin, refer to
Cartographic Projection Procedures for the UNIX EnvironmentÑA UserÕs Manual by
Gerald I. Evenden, U.S. Geological Survey Open-File Report 90-284, 1990
(available at \url{ftp://ftp.remotesensing.org/proj/new\_docs/OF90-284.pdf}). This
manual describes the use of the \textit{proj} and related command line
utilities. The cartographic parameters used with \textit{proj} and described in
the user manual are the same as those used by QGIS.
The Custom Projections dialog requires only two parameters to define a user
projection: 1) a descriptive name, and 2) the cartographic parameters. To
create a new projection, click the \textit{New} button and enter a descriptive
name and the projection parameters. Figure
\ref{fig:customprojections} shows the dialog with an example projection. The
parameters shown were entered based on a knowledge of the projection and the
information found in OF90-284.
\begin{figure}[h]
\begin{center}
\caption{Custom Projection Dialog (OS X)}\label{fig:customprojections}\smallskip
\includegraphics[scale=.70]{qgis_user_guide_images/customprojection}
\end{center}
\end{figure}
You can test your projection parameters to see if they give sane results by
clicking on the \textit{Test} tab and pasting your projection parameters into
the \textit{Parameters} field. Then enter known WGS 84 latitude and longitude
values in North and East fields respectively. Click on \textit{Calculate} and
compare the results with the known values in your projected coordinate system.

7
doc/source/user_guide/working_with_vector.tex
View File

@ -159,7 +159,7 @@ Builder}\label{sec:query_builder}\index{PostgreSQL!query builder}
The PostgreSQL Query Builder allows you to define a subset of a table and add it
as a layer in QGIS. For example, if you have a towns layer with a population
field you could select only larger towns by entering \textsl{population >
100000} in the SQL box of the query builder. Figure \ref{fig:querybuilder} shows an
100000} in the SQL box of the query builder. Figure \ref{fig:query_builder} shows an
example of the query builder populated with data from a layer in PostgreSQL.
\begin{figure}[h]
@ -231,7 +231,10 @@ a PostGIS enabled database. For example, to import a shapefile named lakes into
\begin{verbatim}
shp2pgsql -s 2964 lakes.shp lakes_new | psql gis_data
\end{verbatim}
This creates a new layer named lakes\_new in the the gis\_data database. The new layer will have a spatial reference identifier (SRID) of 2964. See Section \ref{sec:projections} for more information on spatial reference systems and projections.
This creates a new layer named lakes\_new in the the gis\_data database. The
new layer will have a spatial reference identifier (SRID) of 2964. See Chapter
\ref{chp:projections} for more information on spatial reference systems and
projections.
\parpic[l]{\includegraphics{qgis_user_guide_images/spiticon}}QGIS comes with a
plugin named SPIT (Shapefile to PostGIS Import Tool)\index{SPIT}.

71
doc/source/user_guide_sk/foreword_sk.tex Executable file
View File

@ -0,0 +1,71 @@
%documentation for 0.6 (not updated for 0.7 yet)
%translated by Lubos Balazovic (balazovic at mailbox dot sk)
%used encoding: iso-8859-2
% TODO list
% * Capture localized screenshots
% * Update for 0.7
\chapter{Predstavenie}
Vitajte v úžasnom svete GIS -- vo svete geografických informačných systémov! Quantum GIS (QGIS) je slobodný voľne šíriteľný geografický informačný systém. Tento projekt sa zrodil v máji 2002 a v tom istom roku v júni bol založený na SourceForge. Tvrdo sme pracovali na vytvorení softvéru GIS (ktorý býva tradične drahým komerčným softvérom) prístupnom a užitočnom pre každého, kto má základný prístup k osobnému počítaču. QGIS beží v súčasnosti na väčšine systémov založených na platformách UNIX, Windows a OS X. QGIS je vyvíjaný s použitím knižnice a nástrojov Qt (\url{http://www.trolltech.com}) a C++. Z toho vyplýva, že QGIS sa cíti byť elegantne použiteľným programom s príjemným a ľahko ovládateľným grafickým požívateľským rozhraním.
QGIS sa usiluje byť jednoducho použiteľným GIS-om poskytujúcim bežné funkcie a vlastnosti. Prvotným cieľom bolo pripraviť prehliadač údajov GIS. Tento bod už QGIS vo svojom vývoji dosiahol a denne slúži mnohým ľuďom na prezeranie ich údajov GIS. QGIS podporuje množstvo rastrových a vektorových údajových formátov a s využitím architektúry zásuvných modulov je tu možnosť ľahko pridať ďalšie (úplný zoznam v súčasnosti podporovaných údajových formátov nájdete v prílohe \ref{appdx_data_formats} ). QGIS vyšiel pod verejnou licenciou GNU (GPL). Jeho vývoj pod touto licenciou znamená, že môžete skúmať a upravovať zdrojový kód (pokiaľ si to želáte) a zároveň Vám táto licencia garantuje, že Vy, náš šťastný používateľ, budete mať vždy prístup ku programu GIS, ktorý je zadarmo a možno ho slobodne meniť. Spolu s Vašou kópiou QGIS-u by ste mali obdržať aj úplné znenie tejto licencie, ktorá je tiež súčasťou prílohy \ref{gpl_appendix}.
\begin{quote}
\begin{center}
\textbf{Poznámka:} Ostatnú verziu tohoto dokumentu je vždy možné nájsť na \newline
http://qgis.sourceforge.net/docs/userguide.html %change for link to Slovak version of this document
\end{center}
\end{quote}
\section{Hlavné vlastnosti}
QGIS obsahuje mnohé bežné vlastnosti a funkcie GIS programu. Jeho hlavné črty sú uvedené v nasledujúcom zozname.
\begin{compactenum}
\item Podpora pre tabuľky PostgreSQL s využitím PostGIS-u pre priestorovo orientované údaje
\item Podpora ESRI shape súborov a iných vektorových formátov podporovaných knižnicou OGR, vrátane súborov MapInfo
\item Identifikácia objektov
\item Zobrazovanie tabuľky atribútov
\item Výber objektov
\item Popisy objektov
\item Trvalé výbery
\item Ukladanie a načítavanie projektov
\item Podpora rastrových formátov podporovaných knižnicou GDAL
\item Zmena vektorovej symboliky (jednoduchá, stupňovaná, jedinečná hodnota a spojitá)
\item Symbolika SVG značiek (jednoduchá, jedinečná hodnota a stupňovaná)
\item Zobrazovanie rastrových údajov ako sú digitálne výškové modely, letecké snímky, alebo snímky landsat
\item Zmena rastovej symboliky (odtiene šedej, pseudofarby a viackanálové RGB)
\item Export do mapového súboru Mapserver
\item Predbežná podpora digitalizácie
\item Mapový prehľad
\item Zásuvné moduly
\end{compactenum}
\section{Čo je nové vo verzii 0.6}
QGIS sa stále vyvíja. V tomto vydaní pribudli mnohé nové vlastnosti ako napríklad:
\begin{compactenum}
\item V správcovi údajov OGR podpora GEOS-u na zlepšenie výberu objektov prostredníctvom identifikácie. To prinieslo zlepšenie oproti metóde výberu objektu založenej na jednoduchej kontrole prieniku MBR.
\item V správe údajov -- podpora možnosti upravovať vrstvu PostGIS
\item Prepracovaný dialóg vektorovej vrstvy na zlepšenie použiteľnosti
\item Vylepšenia v obsluhe projektu (nahrávanie a ukladanie)
\item Vykresľovanie v závislosti od mierky
\item Používateľská voľba nahrať vrstvy bez ich vykreslenia, čo dovoľuje nastaviť závislosť vykresľovania od mierky a i., bez nutnosti čakať, kým sa prvýkrát úplne nevykreslia všetky vrstvy
\item Prerušenie vykresľovania objektov stlačením klávesy ESC
\item Akcie atribútov -- schopnosť spustiť externý program na základe obsahu atribútového poľa vo vrstve
\item Možnosť vytvoriť novú vektorovú upravovateľnú vrstvu (shape)
\item Windows inštalátor binárna verzia pre Mac OSX
\item Nové voľby v zásuvnom module na tvorbu zemepisnej siete
\item Rozšírenie zásuvného modulu GPS
\item Manuálova stránka
\item Možnosť uložiť textový úbor s oddeľovačom vo forme shape súboru
\item Zdokonalený nástroj na import textového súboru s oddeľovačom, vrátane náhľadu na textový súbor
\item V nástroji SPIT bola vylepšená obsluha rezervovaných slov v PostgreSQL a obsluha shape súborov s viacerými typmi geometrie
\item Zobrazuje sa SQL dopyt použitý pri vytvorení PostGIS vrstvy
\item Tvorba PostgreSQL dopytov
\item Schopnosť znovudefinovať dopyt použitý v PostgreSQL vrstvách z dialógu vlastnosti vrstvy
\item Zásuvné moduly smerová ružica, grafická mierka a nástroj na tvorbu copyrightu odteraz ukladajú svoj stav do projektového súboru
\item Nahrávanie údajových súprav s názvami súborov v UTF8, Kanjii a CJK už funguje správne
\end{compactenum}

169
doc/source/user_guide_sk/getting_started_sk.tex Executable file
View File

@ -0,0 +1,169 @@
%documentation for 0.6 (not updated for 0.7 yet)
%translated by Lubos Balazovic (balazovic at mailbox dot sk)
%used encoding: iso-8859-2
% TODO list
% * Capture localized screenshots
% * Update for 0.7
\chapter{Prvé kroky}
Táto kapitola Vám podá rýchly prehľad ako funguje QGIS a ako možno vyskúšať vzorku údajov dostupnú z webovej stránky QGIS-u.
\section{Inštalácia}
\index{Inštalácia}
Inštalácia QGIS-u je opísaná v prílohe \ref{install_guide}. Inštalačná príručka sa šíri spolu so zdrojovým kódom QGIS-u a taktiež je dostupná na stránke \url{http://qgis.org}. Pre platformy Windows a Mac OSX existuje QGIS v podobe štandardného inštaléčného inštalačného balíka.
\section{Vzorky údajov} \index{údaje!vzorky} Pokiaľ nemáte po ruke žiadne GIS
údaje, môžete si stiahnuť vzorku obsahujúcu údajovú súpravu Aljaška z webovej
stránky QGIS-u na \url{http://qgis.org}. Údajová súprava Aljaška bude slúžiť ako základ pre mnohé príklady a snímky obrazovky uvádzané v tomto dokumente.
\section{Spustenie QGIS}
V prípade, že je QGIS nainštalovaný v adresári, ku ktorému je v premennej PATH nastavená cesta, stačí na jeho spustenie napísať do príkazového riadku: \textbf{qgis} alebo použiť dvojklik na odkaz na ploche smerujúci ku aplikácii QGIS. Pod MS Windows, spustíte QGIS použitím menu Štart a príslušného odkazu; pod Mac OSX, dvojklikom na ikonu v priečinku vašich aplikácií.
%\begin{figure}
%\caption{QGIS Main Window}
%\end{figure}
\subsection{Parametre príkazového riadku}\index{parametre príkazového riadku}
QGIS spúštaný z príkazového riadku podporuje množstvo parametrov. Zoznam týchto parametrov je možné získať s použitím príkazu \texttt{qgis ---help}. Prehľad ich použitia v QGIS-e vyzerá taktoormuláci:
\small
\begin{verbatim}
Použitie: /home/gsherman/qgis06_rc/bin/qgis [parametre] [SÚBORY]
parametre:
[--snapshot súbor] vysiela snímky nahratých údajových súprav daného súboru
[--lang jazyk] použitá jazyková mutácia
[--project projektový_súbor] nahrá daný QGIS projekt
[--help] zobrazí tento text (v angličtine -- pozn. prekl.)
SÚBORY:
Súbory špecifikované v príkazovom riadku môžu byť súbormi rastrovými,
vektorovými, a súbormi projektov QGIS (.qgs):
1. Rastrové súbory - podporované formáty sú GeoTiff, DEM
a ostatné podporované knižnicou GDAL
2. Vektorové súbory - podpororvané formáty sú ESRI Shape súbory
a ostatné podporované knižnicou OGR a PostgreSQL vrstvy s použitím
rozšírenia PostGIS
\end{verbatim}
\normalsize
\begin{Tip} \caption{\textsc{Príklad na použitie parametrov príkazového riadku}}
\qgistip{
Qgis je možné spustiť aj tak, že do príkazového riadku zadáme jeden, alebo viac údajových súborov. Napríklad, na to, aby sa okamžite nahrali dva shape súbory a jeden rastrový súbor, v prípade pokiaľ QGIS spúšťame z adresára, kde sa naše súbory s údajmi nachádzajú, použijeme príkaz:
\ttfamily{ qgis ak\_shade.tif alaska.shp majrivers.shp}
}
\end{Tip}
\section{Hlavné okno QGIS-u}\index{hlavné okno}
Akonáhle sa QGIS spustí, prichádzate do kontaktu s jeho hlavným okno v podobe ako je zobrazené pod týmto textom.
\begin{figure}[h]
\begin{center}
\caption{Hlavné okno}\label{fig:startup}
\includegraphics[scale=.5]{qgis_user_guide_images/startup}
\end{center}
\end{figure}
\textsc{Poznámka -- vzhľad dekorácie okien (titulná lišta atď.) sa môžu na vašom počítači líšiť, závisia totiž od operačného systému a správcu okien}
Hlavné okno QGIS-u je rozdelené do šiestich oblastí:
\begin{compactenum}
\item Hlavné menu
\item Nástrojová lišta
\item Mapová legenda
\item Mapové plátno
\item Panel Prehľad
\item Stavový riadok
\end{compactenum}
Týmto šiestim komponentom rozhrania QGIS-u sa bližšie venujú ďalšie časti tohoto dokumentu.
\subsection{Hlavné menu}
\index{menu}
Hlavné menu poskytuje prostedníctvom štandardných okien hierarchického menu prístup k rôznym funckiám QGIS-u. Tu je zoznam menu na najvyššej úrovni a zhrnutie niektorých funkcií, ktoré sprostredkujú:
\begin{compactitem}
\item Súbor (otvorenie projektu, uloženie, export obrázku, vlastnosti)
\item Vrstva (pridanie, zobrazenie a skrytie vrstvy)
\item Pohľad (zoom, obnovenie pohľadu)
\item Nástroje (správca zásuvných modulov, vlastnosti)
\item Zásuvné moduly (menu pridané zásuvnými modulmi, ktoré sú nahraté)
\item Pomocník (dokumentácia a web odkazy)
\end{compactitem}
%See Appendix \ref{app_menu} for complete descriptions of the menu items.
\subsection{Nástrojové lišty}
\index{nástrojové lišty}
Nástrojové lišty umožňujú prístup k tým najpoužívanejším funkciám z menu a mnohým ďalším nástrojom pre interaktívnu prácu s mapou. Ku každej položke nástrojovej lišty existuje rozbaľovacie pomocný informačný text. Stačí chvíľu podržať myš nad nejakou položkou a čochvíľa sa objaví krátky popis nástroja a jeho účel. %See Appendix \ref{app_toolbar} for complete
%descriptions and illustrations of the various toolbars.
\subsection{QGIS Mapová legenda}
\index{legenda}
Oblasť mapovej legendy sa používa na nastavenie viditeľnosti a z-poradia vrstiev.
Z-poradie znamená, že v zozname vyššie umiestnené vrstvy legendy sú vykresľované cez nižšie vrstvy v zozname v legende. Zaškrtávacie políčko pri každej položke legendy slúži na zobrazenie alebo skrytie tej-ktorej vrstvy.\index{vrstva!viditeľnosť}
\begin{Tip} \caption{\textsc{Zobrazenie menu vrstvy}}\index{vrstva!kontextové menu}
\qgistip{Kontextové menu pre ľubovoľnú vrstvu v legende môžete zobraziť v kliknutím pravým tlačidlom na meno vrstvy. Kontextové menu pozostáva z položiek na prácu s vrstvou a vlastností jej zobrazenia.}
\end{Tip}
Pri každej položke legendy sa môžu objaviť nasledujúce mini ikony:
\includegraphics[scale=1]{qgis_user_guide_images/pyramid} Toto je rastrová vrstva, ktorá má na zvýšenie efektívnosti vykresľovania postavené pyramídy (pozri Sekciu \ref{raster_pyramids}).\\
\includegraphics[scale=1]{qgis_user_guide_images/no_pyramid} Toto je rastová vrstva ktorá nemá žiadne pyramídy (pozri Sekciu \ref{raster_pyramids}).\\
\includegraphics[scale=1]{qgis_user_guide_images/inoverview} Táto vrstva je zobrazovaná okrem hlavného mapového plátna aj v paneli Prehľad.\\
\includegraphics[scale=1]{qgis_user_guide_images/editable} Toto je vektorová vrstva, ktorá je momentálne nastavená ako upravovateľná.\\
\subsection{QGIS Mapový pohľad}
\index{mapa!pohľad}
Toto je 'pracovná časť' QGIS-u -- v tejto oblasti sú zobrazované mapy! Mapa zobrazená v tomto okne závisí na vektorových a rastrových vrstvách, ktoré sú nahraté (viac informácií o tomto je v ďalších častiach dokumentu). Mapový pohľad sa dá posúvať (je možné zmeniť pohľad posunutím mapového pohľadu na inú oblasť záujmu), približovať a vzdiaľovať (zoom) a podporuje rôzne ďalšie akcie tak ako sú uvednené vo vyššie opísané v opise nástrojovej lišty vyššie. Mapový pohľad a legenda sú navzájom úzko previazané -- mapy v pohľade reagujú na zmeny, vykonané v legende...
\begin{Tip}\caption{\textsc{Zmena pohľadu kolieskom myši}}\index{zoom!koliesko myši}
\qgistip{S kolieskom myši sa dá mapa približovať alebo vzdaľovať. Umiestnite kurzor myši do oblasti mapy a otáčaním kolieska dopredu (smerom od vás) pohľad približujete a opačným smerom (smerom k vám) vzdaľujete.
}
\end{Tip}
\subsection{QGIS panel Prehľad}
\index{map!overview}
Oblasť mapového prehľadu poskytuje celkový pohľad na vrstvy, ktoré boli do neho pridané. Červeným obdĺžnikom je vymedzený rozsah (poloha) aktuálneho mapového pohľadu. To Vám umožňuje rýchlo zistiť, ktorú oblasť si práve prezeráte. Majte na pamäti, že popisy v mapovom prehľade nie sú zobrazované dokonca ani v prípade, ak je zapnuté zobrazovanie popisov v nastavení vrstvy.
\subsection{QGIS stavový riadok mapy}
Stavový riadok zobrazuje v mapových súradniciach (t.j. meteroch alebo desiatkových stupňoch) aktuálnu polohu kurzora myši v mapovom pohľade. Stavový riadok tiež tiež ukazuje rozsah mapového pohľadu tak, ako ste ho posunuli, priblížili, či vzdialili. Ukazovateľ priebehu v stavovom riadku zobrazuje priebeh vykresľovania každej vrsty vykresľovanej do mapového pohľadu. V niektorých prípadoch (ako je napríklad zozbieranie štatistiky v rastrových vrstvách) slúži ukazovateľ priebehu na zobrazovanie priebehu časovo náročnejších operácií. Na konci stavového riadku je malé zaškrtávacie políčko ktoré sa používa na dočasné pozastavenie vykresľovania vrstiev do mapového pohľadu) pozri ďalej -- časť \ref{subsec:redraw_events}.
\section{Vykresľovanie}\label{subsec:redraw_events}\index{rendering}
Štandardne QGIS vykresľuje všetky viditeľné vrstvy vždy keď je potrebné obnoviť (aktualizovať) obraz mapového plátna. Udalosti, ktorých dôsledkom je obnovenie mapového plátna:
\begin{compactitem}
\item pridanie vrstvy
\item posun, alebo zmena veľkosťi pohľadu
\item zmena veľkosti okna QGIS
\item zmena viditeľnosti vrstvy, alebo vrstiev
\end{compactitem}
QGIS vám dovoľuje riadiť proces vykresľovania viacerými spôsobmi.
\subsection{Vykresľovanie v závislosti od mierky}\index{rendering!vykresľovanie v závislosti od mierky}
Vykresľovanie v závislosti od mierky vám umožňuje určiť minimálnu a maximálnu mierku, v ktorej bude vrstva viditeľná. Nastavenie vykresľovania v závislosti od mierky, nájdete v menu vlastnosti, ktoré otvoríte dvojklikom na danú vrstvu v legende. Na karte
\textit{Všeobecné} , nastavte hodnoty minimálnej a maximálnej mierky a kliknite na zašrtávacie políčko \textit{Použiť vykresľovanie v závislosti od mierky}.
Hodnoty mierok je možné zistiť priblížením pohľadu na danú veľkosť a odčítaním mierky zo stavového riadku QGIS-u.
\index{mierka}
\subsection{Ovaládanie mapového vykresľovania}
Mapové vykresľovanie sa dá ovládať nasledujúcimi spôsobmi:
\begin{compactenum}
\item Prerušenie vykresľovania počas vykresľovania mapového plátna
\item Dočasné pozastavenie vykresľovania
\item Nastavenie voľby na ovládanie viditeľnosti vrstiev pridávaných do mapy
\end{compactenum}
\subsection{Zastavenie vykresľovania}\index{rendering!halting}
Vykresľovania mapy je možné zastaviť stlačením klávesy ESC. Tým sa zastaví obnovenie mapového plátna a ostane mapa zostane len čiastočne vykreslené. Medzi stlačením klávesy ESC a momentom, keď bude vykresľovanie mapy zastvené môže ubehnúť istý čas.
\subsection{Pozastavenie Vykresľovania}\index{rendering!suspending}
Na pozastavenie vykresľovania, kliknite na zaškrtávacie políčko \textit{Vykresľovanie} v spodnom pravom horu stavového riadku. Pokiaľ políčko \textit{Vykresľovanie} nie zaškrtnuté, QGIS mapové plátno neprekreľuje v prípade žiadnej z udalostí opísaných v časti
\ref{sec:redraw_events}. Príkladmi sitácií, keď je užitočné prerušiť vykresľovanie sú napr.:
\begin{compactitem}
\item pridanie mnohých vrstiev a nastavenie symboliky pre ne ich pred vykreslením
\item pridanie jednej alebo viac rozsiahlych vrstiev a nastavenie vykresľovania v závislosti od mierky pred ich vykreslením
\item pridanie jednej alebo viac vrstiev a nastavenie osobitného pohľadu pred ich vykreslením
\item ľubovoľná kombinácia vyššie spomentých
\end{compactitem}
Zaškrtnutie políčka \textit{Vykresľovanie} zapne vykresľovanie a pričiní sa o okamžité obnovenie mapového plátna.
\subsection{Nastavenie voľby pridávania vrstvy}\index{vykresľovanie!nastavenie}\index{vrstvy!počiatočná viditeľnosť}
Je možné nastaviť voľbu vždy naharať nové vrstvy bez ich vykreslenia. To znamená, že vrstva bude pridaná do mapy, ale zaškrtávacie políčko jej viditeľnosti v legende bude nastavené ako nezaškrtnuté. Táto voľba sa dá nastaviť kliknitím na kartu \textit{Vykresľovanie} v menu \textit{Vlastnosti}, ktoré sa nachádza v hlavnom menu pod položkou \textit{Nastavenia}. Tu zaškrtnite políčko
\textit{Nové vrstvy pridané do mapy nie sú zobrazované}. Každá vrstva pridávané do mapy bude prednastavená ako vypnutá (neviditeľná).
\subsection{Aktualizácia zobrazenia mapy počas vykresľovania}\index{rendering!update
during drawing}
Môžete nastaviť voľbu na aktualizáciu zobrazenia mapy v priebehu generovania objektov. Štandardne QGIS nerzobrazí žiadne objekty vrstvy, pokiaľ nie je vygenerovaná celá vrstva. Aktualizáciu zobrazenia počas načítavania objektov zo zdroja údajov sa dá nastaviť kliknutím na kartu \textit{Vykresľovanie}v menu \textit{Vlastnosti} nachádzajúcom sa v položke \textit{Nastavenia} z hlavného menu. Tu sa nastaví počet objektov na vhodnú hodnotu pre aktualizáciu zobrazenia počas generovnia vrstvy. Nastavenie na 0 znemožní aktualizáciu počas generovania (toto je predvolená hodnota). Nastavenie príliš nízkej hodnoty bude mať za následok nízky výkon, keďže mapové plátno bude priebežne aktualizované počas načítavania objektov. Odporúča sa začať s hodnotou 500.

115
doc/source/user_guide_sk/qgis_user_guide_sk.tex Executable file
View File

@ -0,0 +1,115 @@
%Slovak version of QGIS documantation - DRAFT
%modificated qgis_user_guide.tex
%translated by Lubos Balazovic (balazovic at mailbox dot sk)
%used encoding: iso-8859-2
\documentclass[10pt,slovak]{timthesis}
\usepackage{geometry}
\geometry{verbose,letterpaper,tmargin=1in,bmargin=1in,lmargin=1in,rmargin=
1in}
\usepackage{helvet}
\usepackage[T1]{fontenc}
\usepackage[latin1]{inputenc}
\usepackage{setspace}
\usepackage{paralist}
\usepackage{color}
\usepackage{hyperref}
\hypersetup{backref,colorlinks=true}
\usepackage{ae,aecompl}
\usepackage{graphicx}
\usepackage{picins}
\usepackage{fancyhdr}
\usepackage{extramarks}
\usepackage{makeidx}
\usepackage{datetime}
\pagestyle{empty}
%define tip float
\usepackage{float}
\floatstyle{ruled}
\newfloat{Tip}{H}{lox}
\floatname{Tip}{Tip}
\newcommand\qgistip[1]{\raggedright\small{#1}}
\renewcommand{\topfraction}{0.85}
\renewcommand{\textfraction}{0.1}
\renewcommand{\floatpagefraction}{0.75}
\makeindex
%Added by Tim to define a month year date style
\newdateformat{mydate}{\monthname[\THEMONTH] \THEYEAR}
%\renewcommand\familydefault{lucidabrightsans}
\title{
\includegraphics[scale=0.4]{qgis_user_guide_images/qgis_icon_new_verylarge}\\
Pouívateµská príruèka Quantum GIS\\
\large Verzia 0.7 \textsl{'Seamus'}}
\author{Gary E. Sherman \\Tim Sutton \\Radim Bla¾ek (GRASS) \\ Lars Luthman (GPS modul)\\
\date{\mydate\today}
}
\begin{document}
\pagenumbering{roman}
% To disable first line indents of paragraphs after the first one
\setlength{\parindent}{0in}
\maketitle
\tableofcontents
\listof{Tip}{Zoznam QGIS tipov}
\newpage
%\newpage
%added by Tim to create a decent space between paragraphs
%note its only after toc so toc remains compact
\setlength{\parskip}{8pt plus 1pt minus 1pt}
%\fancyfoot[C]{\thepage}
\pagestyle{fancy}
\fancyhead[L]{Pou¾ívateµská príruèka QGIS}
\fancyhead[R]{\textsl{Verza 0.7}}
\pagenumbering{arabic}
\begin{onehalfspace}
\reversemarginpar
\input{forward_sk.tex}
%\input{introduction.tex} not translated yet
\input{getting_started_sk.tex}
%\input{working_with_vector.tex} not translated yet
%\input{working_with_raster.tex} not translated yet
%\input{working_with_projections.tex} not translated yet
%\input{grass_integration.tex} not translated yet
%first the general intro to plugins
%then each individual plugin can have a section
%in the plugins chapter
%\input{plugins.tex} not translated yet
%\input{plugins_gps.tex} not translated yet
%\input{plugins_delimited_text.tex} not translated yet
%end of plugin docs
%\input{help_and_support.tex} not translated yet
\appendix
%\input{appendices/supported_data_formats.tex} not translated yet
%\input{appendices/gpl.tex} not included yet
%\input{appendices/qgis_qt_gpl_exception.tex} not translated yet
%install guide is a special case because we are snarfing it
%out of a separate document, we need to add the chapter here
\chapter{In¹talaèná príruèka QGIS}
\label{install_guide}
%\input{../install_guide/install_source.tex} not translated yet
\end{onehalfspace}
%\index{PostgreSQL!layer definition| \see{query builder}}
%\index{PostgreSQL!import data| \see{SPIT}}
%\index{layers!vector| \see{vector layers}}
%\index{vector layers!symbology!renderers| \see{renderers}}
\index{vrstvy!rastrové| \see{rastre}}
%\index{attribute actions| \see{actions}}
%\index{indexes| \see{spatial index}}
\printindex
\end{document}

26270
doc/userguide.pdf
View File

File diff suppressed because one or more lines are too long