% Generated by Sphinx.
\def\sphinxdocclass{report}
\documentclass[a4paper,10pt,brazil]{sphinxmanual}
\usepackage[utf8]{inputenc}
\DeclareUnicodeCharacter{00A0}{\nobreakspace}
\usepackage{cmap}
\usepackage[T1]{fontenc}
\usepackage{babel}
\usepackage{times}
\usepackage[Sonny]{fncychap}
\usepackage{longtable}
\usepackage{sphinx}
\usepackage{multirow}


\title{QGIS User Guide}
\date{14/05/2014}
\release{1.8}
\author{QGIS Project}
\newcommand{\sphinxlogo}{}
\renewcommand{\releasename}{Versão}
\makeindex

\makeatletter
\def\PYG@reset{\let\PYG@it=\relax \let\PYG@bf=\relax%
    \let\PYG@ul=\relax \let\PYG@tc=\relax%
    \let\PYG@bc=\relax \let\PYG@ff=\relax}
\def\PYG@tok#1{\csname PYG@tok@#1\endcsname}
\def\PYG@toks#1+{\ifx\relax#1\empty\else%
    \PYG@tok{#1}\expandafter\PYG@toks\fi}
\def\PYG@do#1{\PYG@bc{\PYG@tc{\PYG@ul{%
    \PYG@it{\PYG@bf{\PYG@ff{#1}}}}}}}
\def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+\PYG@do{#2}}

\expandafter\def\csname PYG@tok@gd\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.63,0.00,0.00}{##1}}}
\expandafter\def\csname PYG@tok@gu\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.50,0.00,0.50}{##1}}}
\expandafter\def\csname PYG@tok@gt\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.27,0.87}{##1}}}
\expandafter\def\csname PYG@tok@gs\endcsname{\let\PYG@bf=\textbf}
\expandafter\def\csname PYG@tok@gr\endcsname{\def\PYG@tc##1{\textcolor[rgb]{1.00,0.00,0.00}{##1}}}
\expandafter\def\csname PYG@tok@cm\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}}
\expandafter\def\csname PYG@tok@vg\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@m\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@mh\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@cs\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}\def\PYG@bc##1{\setlength{\fboxsep}{0pt}\colorbox[rgb]{1.00,0.94,0.94}{\strut ##1}}}
\expandafter\def\csname PYG@tok@ge\endcsname{\let\PYG@it=\textit}
\expandafter\def\csname PYG@tok@vc\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@il\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@go\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.20,0.20,0.20}{##1}}}
\expandafter\def\csname PYG@tok@cp\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@gi\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.63,0.00}{##1}}}
\expandafter\def\csname PYG@tok@gh\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.00,0.50}{##1}}}
\expandafter\def\csname PYG@tok@ni\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.84,0.33,0.22}{##1}}}
\expandafter\def\csname PYG@tok@nl\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.13,0.44}{##1}}}
\expandafter\def\csname PYG@tok@nn\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.05,0.52,0.71}{##1}}}
\expandafter\def\csname PYG@tok@no\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.38,0.68,0.84}{##1}}}
\expandafter\def\csname PYG@tok@na\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@nb\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@nc\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.05,0.52,0.71}{##1}}}
\expandafter\def\csname PYG@tok@nd\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.33,0.33,0.33}{##1}}}
\expandafter\def\csname PYG@tok@ne\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@nf\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.02,0.16,0.49}{##1}}}
\expandafter\def\csname PYG@tok@si\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.44,0.63,0.82}{##1}}}
\expandafter\def\csname PYG@tok@s2\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@vi\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@nt\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.02,0.16,0.45}{##1}}}
\expandafter\def\csname PYG@tok@nv\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@s1\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@gp\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.78,0.36,0.04}{##1}}}
\expandafter\def\csname PYG@tok@sh\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@ow\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@sx\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.78,0.36,0.04}{##1}}}
\expandafter\def\csname PYG@tok@bp\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@c1\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}}
\expandafter\def\csname PYG@tok@kc\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@c\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}}
\expandafter\def\csname PYG@tok@mf\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@err\endcsname{\def\PYG@bc##1{\setlength{\fboxsep}{0pt}\fcolorbox[rgb]{1.00,0.00,0.00}{1,1,1}{\strut ##1}}}
\expandafter\def\csname PYG@tok@kd\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@ss\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.32,0.47,0.09}{##1}}}
\expandafter\def\csname PYG@tok@sr\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.14,0.33,0.53}{##1}}}
\expandafter\def\csname PYG@tok@mo\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@mi\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@kn\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@o\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.40,0.40,0.40}{##1}}}
\expandafter\def\csname PYG@tok@kr\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@s\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@kp\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@w\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.73,0.73}{##1}}}
\expandafter\def\csname PYG@tok@kt\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.56,0.13,0.00}{##1}}}
\expandafter\def\csname PYG@tok@sc\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@sb\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@k\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@se\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@sd\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}

\def\PYGZbs{\char`\\}
\def\PYGZus{\char`\_}
\def\PYGZob{\char`\{}
\def\PYGZcb{\char`\}}
\def\PYGZca{\char`\^}
\def\PYGZam{\char`\&}
\def\PYGZlt{\char`\<}
\def\PYGZgt{\char`\>}
\def\PYGZsh{\char`\#}
\def\PYGZpc{\char`\%}
\def\PYGZdl{\char`\$}
\def\PYGZhy{\char`\-}
\def\PYGZsq{\char`\'}
\def\PYGZdq{\char`\"}
\def\PYGZti{\char`\~}
% for compatibility with earlier versions
\def\PYGZat{@}
\def\PYGZlb{[}
\def\PYGZrb{]}
\makeatother

\begin{document}

\maketitle
\tableofcontents
\phantomsection\label{docs/user_manual/index::doc}\phantomsection\label{docs/user_manual/index:qgis-manual-index-reference}



\chapter{Preambulo}
\label{docs/user_manual/preamble/preamble:qgis-user-guide}\label{docs/user_manual/preamble/preamble:preamble}\label{docs/user_manual/preamble/preamble::doc}\label{docs/user_manual/preamble/preamble:qgis-documentation-preamble}
Este documento é o guia do usuário original e descreve o programa Quantum GIS. O software e hardware descritos neste documento são, na maioria dos casos, marcas registradas e são, portanto, sujeito aos requisitos legais. O Quantum GIS está sujeito à Licença Pública Geral GNU. Encontre mais informações sobre o    Quantum GIS na Página \href{http://www.qgis.org}{http://www.qgis.org}.

Os detalhes, dados, resultados etc. neste documento são escritos e verificados para o melhor conhecimento e responsabilidade de seus autores e editores. No entanto, erros sobre o conteúdo são possíveis.

Portanto, todos os dados não são susceptíveis de quaisquer direitos ou garantias. Os autores, editores e editoras não assume qualquer responsabilidade por falhas e suas consequências. Você será sempre bem-vindos para indicar possíveis erros.

This document has been typeset with reStructuredText. It is available as reST
source code via \href{https://github.com/qgis/QGIS-Documentation}{github} and
online as HTML and PDF via \href{http://documentation.qgis.org}{http://documentation.qgis.org}. Translated versions of
this document can be downloaded in several formats via the documentation area of
the QGIS project as well. For more information about contributing to this
document and about translating it, please visit: \href{http://www.qgis.org/wiki/}{http://www.qgis.org/wiki/}.

\textbf{Links neste Documento}

Este documento contém links internos e externos. Clicando sobre um link interno move-se dentro do documento, ao clicar em um link externo abre um endereço de internet. Em formato PDF, links internos e externos são mostradas em azul e são tratados pelo navegador do sistema. Em formato HTML, o navegador exibe e trata ambos de forma idêntica.

\textbf{Usuário, Instalação e Código Guia dos Autores e Editores:}

\begin{tabulary}{\linewidth}{|L|L|L|L|L|}
\hline

Tara Athan
 & 
Radim Blazek
 & 
Godofredo Contreras
 & 
Otto Dassau
 & 
Martin Dobias
\\

Peter Ersts
 & 
Anne Ghisla
 & 
Stephan Holl
 & 
N. Horning
 & 
Magnus Homann
\\

Werner Macho
 & 
Carson J.Q. Farmer
 & 
Tyler Mitchell
 & 
K. Koy
 & 
Lars Luthman
\\

Claudia A. Engel
 & 
Brendan Morely
 & 
David Willis
 & 
Jürgen E. Fischer
 & 
Marco Hugentobler
\\

Larissa Junek
 & 
Diethard Jansen
 & 
Paolo Corti
 & 
Gavin Macaulay
 & 
Gary E. Sherman
\\

Tim Sutton
 & 
Alex Bruy
 & 
Raymond Nijssen
 & 
Richard Duivenvoorde
 & 
Andreas Neumann
\\
\hline\end{tabulary}




\textbf{Sponsors}

The update of this user manual was kindly sponsored by
\href{http://www.so.ch/departemente/bau-und-justiz/amt-fuer-geoinformation.html}{Kanton Solothurn}, Switzerland.

Copyright (c) 2004 - 2013 QGIS Development Team

\textbf{Internet:} \href{http://www.qgis.org}{http://www.qgis.org}

\textbf{Licença deste documento}

Permissão é garantida para cópia, distribuição e/ou modificação deste documento sobre os tremos da Licença de Documentação Livre GNU, Versão 1.3 ou versão mais recente publicada pela Fundação Software Livre; sem Seções Invariantes, sem textos de Capa e sem textos de Contra-Capa. A cópia da licença é incluida no Apêndice {\hyperref[docs/user_manual/appendices/appendices:gfl-appendix]{\emph{GNU Licença de Documentação Gratuíta}}}.


\chapter{Convenções}
\label{docs/user_manual/preamble/conventions:label-conventions}\label{docs/user_manual/preamble/conventions::doc}\label{docs/user_manual/preamble/conventions:conventions}
Este capítulo descreve as coleções de estilos uniformes ao longo do manual. As convenções usadas neste manual são como se segue:

** Convenções GUI**

Os estilos de convenção GUI tem a intenção de imitar a aparência da GUI. Em geral, o objetivo é usar a aparência não pairada, para que um usuário possa verificar visualmente a interface gráfica para encontrar algo que se parece com a instrução no manual.
\begin{itemize}
\item {} 
Menu Opções: \emph{Camada \(\rightarrow\) Adicionar uma camada Raster} ou \emph{Configurações \(\rightarrow\) Barra de Ferramentas \(\rightarrow\) Digitalizar}

\item {} 
Ferramenta: \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Adiciona uma camada Raster}}$

\item {} 
Botão : \textbf{{[}Salvar como padrão{]}}

\item {} 
Caixa de diálogo Título: \emph{Propriedades da camada}

\item {} 
Aba: \emph{Geral}

\item {} 
Caixa de seleção: \includegraphics{checkbox.png} \emph{Renderizar}

\item {} 
Botão Raio:  \includegraphics{radiobuttonon.png} \emph{Postgis SRID} \includegraphics{radiobuttonoff.png} \emph{EPSG ID}

\item {} 
Selecionar um Número: \includegraphics{selectnumber.png}

\item {} 
Selecionar um String: \includegraphics{selectstring.png}

\item {} 
Navegue para um arquivo: \includegraphics{browsebutton.png}

\item {} 
Selecionar uma Cor: \includegraphics{selectcolor.png}

\item {} 
Barra deslizante: \includegraphics{slider.png}

\item {} 
Entrada de texto: \includegraphics{inputtext.png}

\end{itemize}

Uma sombra indica um componente GUI clicável.

\textbf{Convenções de Texto ou Teclado}

O manual também inclui estilos relacionados ao texto, comandos de teclado e codificação para indicar diferentes entidades, tais como classes ou métodos. Eles não correspondem a qualquer aparência real.
\begin{itemize}
\item {} 
Hyperlinks: \href{http://qgis.org}{http://qgis.org}

\item {} 
Combinações de teclas: Pressione: kbd:\emph{Ctrl+B}, ou seja, pressione e segure a tecla Ctrl e pressione a tecla B.

\item {} 
Nome de um arquivo: \code{lakes.shp}

\item {} 
Nome de uma classe: \textbf{NewLayer}

\item {} 
Método: \emph{classFactory}

\item {} 
Servidor: \emph{myhost.de}

\item {} 
Texto de Usuário: \code{qgis -{-}help}

\end{itemize}

Lines of code are indicated by a fixed-width font

\begin{Verbatim}[commandchars=\\\{\}]
PROJCS["NAD\_1927\_Albers",
  GEOGCS["GCS\_North\_American\_1927",
\end{Verbatim}

\textbf{Plataforma específica instruções}

Sequências GUI e pequenas quantidades de texto pode ser formatado em linha:Click \includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{win.png} \emph{Arquivo} \includegraphics[width=1em]{osx.png} :menuselection:{\color{red}\bfseries{}{}`}QGIS  --\textgreater{} Sair para fechar QGIS {\color{red}\bfseries{}{}`}.

Isso indica que em Linux, Unix e Windows, clique na opção de menu Arquivo primeiro, e depois Encerre no menu suspenso, enquanto em plataformas Macintosh OSX, clique no QGIS primeira opção do menu, em seguida, Sair no menu suspenso. Grandes quantidades de texto podem ser formatados como uma lista:
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} fazer isso;

\item {} 
\includegraphics[width=1em]{win.png} fazer isso;

\item {} 
\includegraphics[width=1em]{osx.png} fazer outra coisa.

\end{itemize}

ou como parágrafos.

\includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{osx.png} Fazer isso, isso e isso. Então faça isso, isso e isso, isso e isso, isso e isso, isso e isso.

\includegraphics[width=1em]{win.png} Fazer isso. Então faça isso e aquilo e isso e aquilo e isso e aquilo e isso e aquilo e isso e isso e aquilo e isso e aquilo e isso e aquilo.

Imagens que aparecem ao longo do guia do usuário foram criadas em diferentes plataformas, a plataforma é indicada pelo ícone específico da plataforma no final da legenda da figura.


\chapter{Preâmbulo}
\label{docs/user_manual/preamble/foreword::doc}\label{docs/user_manual/preamble/foreword:foreword}\label{docs/user_manual/preamble/foreword:label-forward}
Bem vindo ao mundo maravilhoso dos Sistemas de Informação Geográficas (SIG)!

Quantum GIS (QGIS) é um Sistema de Informação Geográfica de código aberto.O projeto foi concebido em Maio de 2002 e foi estabelecido como projeto em código fonte em Junho do mesmo ano. Nós trabalhamos duro para tornar o software SIG (que é tradicionalmente software proprietário e caro) numa perspectiva viável para qualquer pessoa com acesso básico num computador pessoal. O QGIS roda atualmente na maioria das plataformas Unix, Windows e Mac OS X. O QGIS é desenvolvido usando o kit de ferramentas Qt (\href{http://qt.digia.com}{http://qt.digia.com}) e C++. Isto significa que QGIS é bom e fácil de usar e tem uma agradável interface gráfica como usuário (GUI).

QGIS pretende ser um SIG fácil de usar, fornecendo funções e feições comuns. O objetivo inicial era fornecer um visualizador de dados SIG. O QGIS atingiu o ponto em sua evolução, onde ele está sendo usado por muitos de seus dados SIG diários de necessidade de visualização. O QGIS suporta um grande número de formatos de dados raster e vetores, e ainda novos formatos podem facilmente adicionados usando a arquitetura de complementos.

QGIS é liberado sob a licença GNU General Public License (GPL). O desenvolvimento do QGIS sob esta licença significa que você pode inspecionar e modificar o código-fonte, e garante que você, nosso usuário feliz, sempre terá acesso a um programa de SIG, que é livre de custo e pode ser livremente modificado. Você deve ter recebido uma cópia completa da licença com a sua cópia do QGIS, e você também pode encontrá-la no Apêndice {\hyperref[docs/user_manual/appendices/appendices:gpl-appendix]{\emph{GNU General Public License}}}.

\index{documentation}
\begin{notice}{tip}{Dica:}
\textbf{Up-to-date Documentation}

The latest version of this document can always be found in the documentation
area of the QGIS website at \href{http://documentation.qgis.org}{http://documentation.qgis.org}
\end{notice}


\section{Introdução ao SIG}
\label{docs/user_manual/preamble/foreword:introduction-to-gis}
Um Sistema e Informação Geográfica (SIG) (Mitchell 2005 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}}) é um conjunto de programas que permite criar, visualizar, consultar e analisar dados geoespaciais. Dados Geoespaciais se referem a informações sobre a localização geográfica de uma entidade. Isto muitas vezes envolve o uso de um sistema de coordenadas geográficas, tal como o valor de latitude e longitude. Os dados espaciais é outro termo usado, pois são: dados geográficos, dados de SIG, dados de mapas, dados de localização, dados de coordenadas e os dados de geometria espacial.

Aplicações que utilizam dados geoespaciais executam uma variedade de funções. Produção de mapas é a função mais fácil de entender de aplicações geoespaciais. Programas de mapeamento levam dados geoespaciais e tornam-os de uma forma que é visível, geralmente em uma tela de computador ou uma página impressa. Os aplicativos podem apresentar mapas estáticos (uma imagem simples) ou mapas dinâmicos que são personalizadas pela pessoa visualiza o mapa através de um programa de computador ou uma página web.

Muitas pessoas assumem erroneamente que as aplicações geoespaciais apenas produzem mapas, mas a análise de dados geoespaciais é outra função primária de aplicações geoespaciais. Alguns tipos típicos de análise incluem computação:
\begin{enumerate}
\item {} 
distância entre localizações geográficas

\item {} 
a quantidade de área (por exemplo, metros quadrados) dentro de uma determinada região geográfica

\item {} 
Quais feições geográficas se sobrepõem outras feições

\item {} 
A quantidade de sobreposição entre feições

\item {} 
O número de localizações a uma certa distância da outra

\item {} 
e assim por diante...

\end{enumerate}

Isto pode parecer simplista, mas pode ser aplicado em todos os tipos de formas de várias disciplinas. Os resultados da análise podem ser mostrados em um mapa, mas muitas vezes são tabulados em um relatório para apoiar decisões de gestão.

Os fenômenos recentes de serviços baseados em localização promete apresentar todos os tipos de outros recursos, mas muitos serão baseados em uma combinação de mapas e análises. Por exemplo, você tem um celular que rastreia a sua localização geográfica. Se você tiver o programa certo, o seu telefone pode dizer quais tipos de restaurantes estão a uma curta distância. Enquanto esta é uma nova aplicação de tecnologia geoespacial, é essencialmente fazer análise de dados geoespaciais e listar os melhores resultados para você.


\subsection{Por que tudo isso é tão novo?}
\label{docs/user_manual/preamble/foreword:why-is-all-this-so-new}
Bem, não é. Há muitos novos dispositivos de hardware que estão possibilitando serviços geoespaciais móveis. Muitas aplicações Open Source Geospatial também estão disponíveis, mas a existência de hardware e software focada geoespacialmente não é nada de novo. Sistema de Posicionamento Global (GPS) estão se tornando comuns, mas têm sido utilizados em diversas indústrias por mais de uma década. Da mesma forma, ferramentas de trabalho de mapeamento e análise têm sido também um grande mercado comercial, focado principalmente em setores como gestão de recursos naturais.

O que é novo é a forma como o mais recente hardware e software está sendo aplicado e quem está aplicando-o. Usuários tradicionais de ferramentas de mapeamento e análise foram altamente treinados em Analise SIG ou técnicos de mapeamento digital treinados para usar CAD como ferramentas. Agora, as capacidades de processamento de PCs domésticos e pacotes Open Source Software (OSS) têm permitido um exército de amadores, profissionais, desenvolvedores web, etc, para interagir com os dados geoespaciais. A curva de aprendizado veio para baixo. Os custos caíram. A quantidade de saturação tecnológica geoespacial aumentou.

Como são armazenados dados geospaciais? Em suma, existem dois tipos de dados geoespaciais em uso difundido hoje. Isto é, além dos tradicionais dados tabulares que também é amplamente utilizados pelas aplicações geoespaciais.


\subsection{Dado Raster}
\label{docs/user_manual/preamble/foreword:raster-data}
Um tipo de dado geoespacial é o chamado dado raster ou simplismente ``um raster''. A forma mais facilmente reconhecida de dados raster é de imagens de satélite digital ou fotos aéreas. Elevação Sombreada ou modelos digitais de elevação também são normalmente representados como dados raster. Qualquer tipo de feição do mapa pode ser representada como dados raster, mas há limitações.

Um raster é uma grade regular formada por células, ou, no caso de imagens, os pixeis. Eles têm um número fixo de linhas e colunas. Cada célula tem um valor numérico e tem um determinado tamanho geográfico (por exemplo, 30x30 metros de dimensão).

Várias rasters sobrepostos são usados ​​para representar as imagens usando mais do que um valor de cor (isto é, um raster para cada conjunto de valores de vermelho, verde e azul são combinados para criar uma imagem a cores). As imagens de satélite também representa dados em várias ``bandas''. Cada banda é essencialmente um raster espacialmente sobreposto separado, em que cada banda tem valores de certos comprimentos de onda de luz. Como você pode imaginar, um grande raster ocupa mais espaço de arquivo.

Um raster com células menores podem fornecer mais detalhes, mas ocupa mais espaço de arquivo. O segredo é descobrir o equilíbrio certo entre o tamanho das células para fins de armazenamento e tamanho de célula para fins de análise ou mapeamento.


\subsection{Dado Vetorial}
\label{docs/user_manual/preamble/foreword:vector-data}
Dados vetoriais também são usados em aplicações geoespaciais. Se você ficou acordado durante as aulas de trigonometria e de geometria, você já estará familiarizado com algumas das qualidades de dados vetoriais. No seu sentido mais simples, os vetores são uma forma de descrever um local usando um conjunto de coordenadas. Cada coordenada refere-se a uma localização geográfica utilizando um sistema de valores de x e y.

Isso pode ser pensado em referência a um plano cartesiano - você sabe, os diagramas de escola que mostravam um eixo x e y. Você pode tê-los usado para traçar o declínio da poupança ou o aumento dos juros de hipoteca, mas os conceitos são essenciais para a análise de dados geoespaciais e mapeamento.

Existem várias maneiras de representar essas coordenadas geográficas, dependendo da sua finalidade. Esta é toda uma área de estudo para outro dia - projeções do mapa.

Dado vetor pode assumir três formatos, cada um progressivamente mais complexos que o anterior.
\begin{enumerate}
\item {} 
Pontos - Uma coordenada simples (x y) representa localização geográfica discreta

\item {} 
Lines - Multiple coordinates (x$_{\text{1}}$ y$_{\text{1}}$, x$_{\text{2}}$ y$_{\text{2}}$,
x$_{\text{3}}$ y$_{\text{3}}$, ... x$_{\text{n}}$ y$_{\text{n}}$) strung
together in a certain order, like drawing a line from Point (x$_{\text{1}}$ y$_{\text{1}}$)
to Point (x$_{\text{2}}$ y$_{\text{2}}$) and so on. These parts between each point are considered
line segments. They have a length and the line can be said to have a
direction based on the order of the points. Technically, a line is a
single pair of coordinates connected together, whereas a line string
is multiple lines connected together.

\item {} 
Poligonos - Quando as linhas são amarradas juntas por mais de dois pontos, com o último ponto sendo no mesmo local do primeiro, nós chamamos isso de um polígono. Um triângulo, círculo, retângulo, etc, são todos os polígonos. A característica chave dos polígonos é que existe uma área fixa no seu interior.

\end{enumerate}


\chapter{Características}
\label{docs/user_manual/preamble/features::doc}\label{docs/user_manual/preamble/features:features}
oferece muitas funcionalidades comuns de um SIG fornecidos por recursos básicos e extensões. Como um pequeno resumo são apresentados em seis categorias para obter uma primeira visão.


\section{Visualizar os dados}
\label{docs/user_manual/preamble/features:view-data}
Você pode ver e sobrepor dados vetoriais e raster em diferentes formatos e projeções sem conversão para um formato interno ou comum. Os formatos suportados incluem:
\begin{itemize}
\item {} 
Spatially-enabled tables and views using PostGIS, SpatiaLite and MSSQL Spatial, vector
formats supported by the installed OGR library, including ESRI shapefiles,
MapInfo, SDTS, GML and many more, see section {\hyperref[docs/user_manual/working_with_vector/index:label-workingvector]{\emph{Trabalhando com dados vetoriais}}}.

\item {} 
Raster and imagery formats supported by the installed GDAL (Geospatial
Data Abstraction Library) library, such as GeoTiff, Erdas Img., ArcInfo Ascii
Grid, JPEG, PNG and many more, see section {\hyperref[docs/user_manual/working_with_raster/index:working-with-raster]{\emph{Trabalhando com dados Raster}}}.

\item {} 
GRASS raster e dados vetoriais de bancos de dados GRASS (localização / mapset), veja: ref: \emph{sec\_grass}.

\item {} 
Servidores de dados espaciais na rede como padrão OGC Web Map Service (WMS) ou Web Feature Service (WFS), veja: ref: \emph{working\_with\_ogc}.

\item {} 
OpenStreetMap data, see section {\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}.

\end{itemize}


\section{Explorar os dados e compor mapas}
\label{docs/user_manual/preamble/features:explore-data-and-compose-maps}
Você pode compor mapas e explorar interativamente dados espaciais com uma interface gráfica amigável. As muitas ferramentas úteis disponíveis no GUI incluem:
\begin{itemize}
\item {} 
Navegador QGIS

\item {} 
On the fly projection

\item {} 
Map composer

\item {} 
Overview panel

\item {} 
Spatial bookmarks

\item {} 
Identify/select features

\item {} 
Edit/view/search attributes

\item {} 
Feature labeling

\item {} 
Change vector and raster symbology

\item {} 
Add a graticule layer - now via fTools plugin and as decoration

\item {} 
Decorate your map with a north arrow scale bar and copyright label

\item {} 
Save and restore projects

\end{itemize}


\section{Criar, alterar,gerenciar e exportar dados}
\label{docs/user_manual/preamble/features:create-edit-manage-and-export-data}
Você pode criar, alterar, gerenciar e exportar mapas vetoriais em vários formatos. Dados raster têm de ser importados para o GRASS para poder alterar e exportá-los para outros formatos. QGIS oferece o seguinte:
\begin{itemize}
\item {} 
Digitizing tools for OGR supported formats and GRASS vector layer

\item {} 
Create and edit shapefiles and GRASS vector layers

\item {} 
Geocode images with the Georeferencer plugin

\item {} 
GPS tools to import and export GPX format, and convert other GPS
formats to GPX or down/upload directly to a GPS unit (on Linux, usb: has been
addedto list of GPS devices)

\item {} 
Visualize and edit OpenStreetMap data

\item {} 
Create PostGIS layers from shapefiles with the SPIT plugin

\item {} 
Improved handling of PostGIS tables

\item {} 
Manage vector attribute tables with the new attribute table (see section
{\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table]{\emph{Trabalhando com a Tabela de Atributos}}}) or Table Manager plugin

\item {} 
Save screenshots as georeferenced images

\end{itemize}


\section{Análise de dados}
\label{docs/user_manual/preamble/features:analyse-data}
You can perform spatial data analysis on PostgreSQL/PostGIS and other OGR
supported formats using the fTools Python plugin. QGIS currently offers
vector analysis, sampling, geoprocessing, geometry and database management
tools. You can also use the integrated GRASS tools, which
include the complete GRASS functionality of more than 400 modules (See Section
{\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integração com SIG GRASS}}}). Or you work with SEXTANTE, which provides powerful a geospatial
analysis framework to call native and third party algorithms from QGIS, such as
GDAL, SAGA, GRASS, fTools and more (see section {\hyperref[docs/user_manual/sextante/index:label-sextante]{\emph{SEXTANTE}}}).


\section{Publicar mapas na Internet}
\label{docs/user_manual/preamble/features:publish-maps-on-the-internet}
QGIS can be used to export data to a mapfile and to publish them on the
Internet using a webserver with UMN MapServer installed. QGIS can also
be used as a WMS, WMS-C or WFS and WFS-T client, and as WMS or WFS server
(see section {\hyperref[docs/user_manual/working_with_ogc/index:sec-ogc]{\emph{Trabalhando com dados OGC}}}).


\section{Estender a funcionalidade QGIS através de extensões}
\label{docs/user_manual/preamble/features:extend-qgis-functionality-through-plugins}
QGIS pode ser adaptado às suas necessidades com a arquitetura de extensões. QGIS fornece bibliotecas que podem ser usados ​​para criar extensões. Você pode até mesmo criar novas aplicações com C + + ou Python!


\subsection{Extensões de núcleo}
\label{docs/user_manual/preamble/features:core-plugins}\begin{enumerate}
\item {} 
Add Delimited Text Layer (Loads and displays delimited text files
containing x,y coordinates)

\item {} 
Coordinate Capture (Capture mouse coordinates in different CRS)

\item {} 
Gerenciador de Banco de dados (Alteração, edição e visualização de camadas e tabelas; executar consultas SQL)

\item {} 
Diagram Overlay (Placing diagrams on vector layer)

\item {} 
Dxf2Shp Converter (Convert DXF to Shape)

\item {} 
GPS Tools (Loading and importing GPS data)

\item {} 
GRASS (GRASS GIS integration)

\item {} 
GDALTools (Integrate GDAL Tools into QGIS)

\item {} 
Georeferencer GDAL (Adding projection information to raster using GDAL)

\item {} 
Heatmap tool (Generating raster heatmaps from point data)

\item {} 
Interpolation plugin (interpolate based on vertices of a vector layer)

\item {} 
Mapserver Export (Export QGIS project file to a MapServer map file)

\item {} 
Offline Editing (Allow offline editing and synchronizing with database)

\item {} 
OpenStreetMap plugin (Viewer and editor for openstreetmap data)

\item {} 
Oracle Spatial GeoRaster support

\item {} 
Plugin Installer (Download and install QGIS python plugins)

\item {} 
Raster terrain analysis (Raster based terrain analysis)

\item {} 
Road graph plugin (Shortest Path network analysis)

\item {} 
SPIT (Import Shapefile to PostgreSQL/PostGIS)

\item {} 
SQL Anywhere Plugin (Store vector layers within a SQL Anywhere database)

\item {} 
Zonal statictics plugin (Calculate count, sum, mean of raster for each polygon
of a vector layer)

\item {} 
Spatial Query plugin (Makes spatial queries on vector layers)

\item {} 
eVIS (Event Visualization Tool)

\item {} 
fTools (Tools for vector data analysis and management)

\end{enumerate}


\subsection{Extensão python externas}
\label{docs/user_manual/preamble/features:external-python-plugins}
QGIS offers a growing number of external python plugins that are provided by
the community. These plugins reside in the official plugins repository, and
can be easily installed using the Python Plugin Installer (See Section
{\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Carregar um complemento externo do QGIS}}}).


\section{Novidades na versão 1.8}
\label{docs/user_manual/preamble/features:what-s-new-in-the-version-1-8}
Please note that this is a release in our `cutting edge' release series. As such
it contains new features and extends the programmatic interface over QGIS 1.0.x
and QGIS 1.7.0. We recommend that you use this version over previous releases.

This release includes hundreds of bug fixes and many new features and enhancements
that will be described in this manual.

\textbf{QGIS Browser}

A stand alone app and a new panel in QGIS. The browser lets you easily navigate
your file system and connection based (PostGIS, WFS etc.) datasets, preview them
and drag and drop items into the canvas.

\textbf{DB Manager}

The DB manager is now officially part of QGIS core. You can drag layers from the
QGIS Browser into DB Manager and it will import your layer into your spatial
database. Drag and drop tables between spatial databases and they will get
imported. You can use the DB Manager to execute SQL queries against your spatial
database and then view the spatial output for queries by adding the results to
QGIS as a query layer. You can also create, edit, delete, and empty tables, and
move them to another schema.

\textbf{Terrain Analysis Plugin}

A new core plugin was added for doing terrain analysis (slope, aspect, hillshade,
relief and ruggedness index).

\textbf{New symbol layer types}
\begin{itemize}
\item {} 
Line Pattern Fill

\item {} 
Point Pattern Fill

\item {} 
Ellipse renderer (render ellipse and also rectangles, triangles, crosses)

\end{itemize}

\textbf{New plugin repository}

Note that the old repository is now no longer supported by default; plugin authors
are kindly requested to move their plugins to the new repository. Get the QGIS
Plugins list at \href{http://plugins.qgis.org/plugins/}{http://plugins.qgis.org/plugins/}.

\textbf{More new features}
\begin{itemize}
\item {} 
Support for nesting projects within other projects to embed content from other
project files

\item {} 
Group Selected: Option to group layers to a group

\item {} 
Message log: Lets you keep an eye on the messages QGIS generates during loading
and operation

\item {} 
GUI Customization: Allows setting up simplified QGIS interface by hiding various
components of main window and widgets in dialogs

\item {} 
Action Tool is now accessible from the map tools toolbar and allows you to
click on a vector feature and execute an action

\item {} 
New scale selector: select from a list of predefined scales

\item {} 
Pan To Selected tool: Pans the map to selected feature(s); does not change the
zoom level

\item {} 
Copy and paste styles between layers

\item {} 
Updated CRS selector dialog

\item {} 
Define Legend-independent drawing order

\item {} 
MSSQL Spatial Support - you can now connect to your Microsoft SQL Server spatial
databases using QGIS

\item {} 
Print Composers allows to have multiple lines on legend items using a specified
character

\item {} 
Expression based labeling

\item {} 
Heatmap Plugin - a new core plugin has been added for generating raster heatmaps
from point data

\item {} 
The GPS live tracking user interface was overhauled and many fixes and
improvements were added to it

\item {} 
The menu was re-organised a little - we now have separate menus for Vector,
Raster, Web and many plugins were updated to place their menus in the new
Vector, Raster and Web top level menus

\item {} 
Offset Curves - a new digitising tool for creating offset curves was added

\item {} 
New tools in the Vector menu to Densify geometries and Build spatial index

\item {} 
Export/add geometry column tool can export info using layer CRS, project CRS
or ellipsoidal measurements

\item {} 
Model/view based tree for rules in rule-based renderer

\item {} 
Improvements in Spatial Bookmarks

\item {} 
New Plugin metadata in metadata.txt

\item {} 
Refactored postgres data provider: support for arbitrary key (including
non-numeric and multi column), support for requesting a certain geometry type
and/or srid in QgsDataSourceURI

\item {} 
Added gdal\_fillnodata to GDALTools plugin

\item {} 
Support for PostGIS TopoGeometry datatype

\item {} 
Python bindings for vector field symbol layer and general updates to the Python
bindings

\item {} 
Added a Benchmark program

\item {} 
Added Row cache for attribute table

\item {} 
UUID generation widget for attribute table

\item {} 
Added support of editable views in SpatiaLite databases

\item {} 
added expression based widget in field calculator

\item {} 
Creation of event layers in analysis lib using linear referencing

\item {} 
Load/save layer styles in the new symbology renderer from/to SLD document

\item {} 
QGIS Server can act as WFS Server

\item {} 
WFS Client support is now a core feature in QGIS

\item {} 
Option to skip WKT geometry when copying from attribute table

\item {} 
Support loading of zipped and gzipped layers

\item {} 
The QGIS test suite now passes all tests on major platforms and nightly tests

\item {} 
You can set tile size for WMS layers

\end{itemize}


\chapter{Introdução}
\label{docs/user_manual/introduction/getting_started:label-getstarted}\label{docs/user_manual/introduction/getting_started:getting-started}\label{docs/user_manual/introduction/getting_started::doc}
Este capítulo apresenta uma visão geral da instalação do QGIS, alguns exemplos de dados da página web QGIS e funcionamento inicial de uma simples sessão, visualizando camadas raster e vetoriais.


\section{Instalação}
\label{docs/user_manual/introduction/getting_started:label-installation}\label{docs/user_manual/introduction/getting_started:installation}
A instalação do QGIS é muito simples. Pacotes de instalação padrão estão disponíveis para MS Windows e Mac OS X. Para muitas distribuições de pacotes binários (rpm e deb) ou repositórios para adicionar ao seu gerenciador de instalação são fornecidas. Receba as últimas informações sobre pacotes binários no site do QGIS em \href{http://download.qgis.org}{http://download.qgis.org}.


\subsection{Instalação do Código Fonte}
\label{docs/user_manual/introduction/getting_started:installation-from-source}
If you need to build QGIS from source, please refer to the installation
instructions. They are distributed with the QGIS source code in a file
called `INSTALL'. You can also find it online at
\href{https://github.com/qgis/Quantum-GIS/blob/master/INSTALL}{https://github.com/qgis/Quantum-GIS/blob/master/INSTALL}


\subsection{Intalação de uma mídia externa}
\label{docs/user_manual/introduction/getting_started:installation-on-external-media}
QGIS permite definir uma opção de configuração de caminho  que substitui o caminho  padrão (por exemplo com o /.qgis no Linux) para a configuração do usuário e força o QSettings a usar este diretório também. Isso permite aos usuários, por exemplo, levar a instalação do  QGIS  em uma unidade flash, com todos os plugins e configurações.


\section{Dados de exemplo}
\label{docs/user_manual/introduction/getting_started:label-sampledata}\label{docs/user_manual/introduction/getting_started:sample-data}
O guia do usuário contém exemplos baseados na amostra de dados.

a instalação do Windows possui uma opção de realizar o download do QGIS com os dados de exemplo. Se marcada, os dados serão baixados para suas pasta Meus Documentos e colocados em uma pasta chamada ``GIS Database''. Você pode utilizar o windows explorer para mover esta pasta para outra localização. Se você não selecionar a caixa de seleção para instalar os dados de exemplo durante a instalação inicial do QGIS você pode
\begin{itemize}
\item {} 
Utilizar dados GIS que você já possui;

\item {} 
Faça o download dos dados de exemplo no site do QGIS em \href{http://download.qgis.org}{http://download.qgis.org}; ou

\item {} 
Desinstale o QGIS e reinstale marcando a opção de download de dados, somente se as soluções acima não forem bem sucedidas.

\end{itemize}

``\textbar{} Nix \textbar{} \textbar{} OSX \textbar{} Para GNU / Linux e Mac OSX não há ainda a instalação de pacote de conjunto de dados disponíveis como rpm, deb ou dmg. Para utilizar o conjunto de dados de exemplo baixe o arquivo ``qgis\_sample\_data'' no formato de arquivo ZIP ou TAR de ``\href{http://download.osgeo.org/qgis/data/}{http://download.osgeo.org/qgis/data/} e descompacte ou descomprima os arquivos no seu sistema. O conjunto de dados do Alasca inclui todos os dados SIG que são usados como exemplos e imagens deste Guia do Usuário, e também inclui uma pequena base de dados GRASS. A projeção para os exemplos dos dados é Alaska Albers Equal Area com unidades de pés. O código EPSG é o 2964.

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{PROJCS}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Albers Equal Area}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}
    \PYG{n}{GEOGCS}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{NAD27}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}
        \PYG{n}{DATUM}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{North\PYGZus{}American\PYGZus{}Datum\PYGZus{}1927}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}
            \PYG{n}{SPHEROID}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Clarke 1866}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mf}{6378206.4}\PYG{p}{,}\PYG{l+m+mf}{294.978698213898}\PYG{p}{,}
                \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{7008}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
            \PYG{n}{TOWGS84}\PYG{p}{[}\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{3}\PYG{p}{,}\PYG{l+m+mi}{142}\PYG{p}{,}\PYG{l+m+mi}{183}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{]}\PYG{p}{,}
            \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{6267}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
        \PYG{n}{PRIMEM}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Greenwich}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}
            \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{8901}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
        \PYG{n}{UNIT}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{degree}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mf}{0.0174532925199433}\PYG{p}{,}
            \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{9108}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
        \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{4267}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PROJECTION}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Albers\PYGZus{}Conic\PYGZus{}Equal\PYGZus{}Area}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{standard\PYGZus{}parallel\PYGZus{}1}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{55}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{standard\PYGZus{}parallel\PYGZus{}2}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{65}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{latitude\PYGZus{}of\PYGZus{}center}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{50}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{longitude\PYGZus{}of\PYGZus{}center}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{154}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{false\PYGZus{}easting}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{false\PYGZus{}northing}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{UNIT}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{us\PYGZus{}survey\PYGZus{}feet}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mf}{0.3048006096012192}\PYG{p}{]}\PYG{p}{]}
\end{Verbatim}

se você pretende usar o QGIS como interface gráfica para o GRASS, você pode encontrar um seleção de localizações de amostra (por exemplo, Spearfish ou Dakota do Sul) no site oficial do GRASS htpp://grass.geo.org/download/data.php.


\section{Exemplos da Seção}
\label{docs/user_manual/introduction/getting_started:sample-session}\label{docs/user_manual/introduction/getting_started:samplesession}
Agora que você possui o QGIs instalado e os dados de amostra disponíveis, nós iremos demonstrar uma rápida e simples seção de exemplos. Iremos visualizar uma camada vetorial e uma camada de raster. Nós iremos utilizara camada de raster landcover qgis\_sample\_data/raster/landcover.img e uma camada vetorial qgis\_sample\_data/gml/lakes.gml.


\subsection{Iniciando QGIS}
\label{docs/user_manual/introduction/getting_started:start-qgis}\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Start QGIS by typing: ``QGIS'' at a command prompt, or
if using precompiled binary, using the Applications menu.

\item {} 
``\textbar{} Win \textbar{} Inicie \textbar{} qg \textbar{} usando o menu Iniciar ou atalho no desktop, ou clique duas vezes em um arquivo de projeto do \textbar{} qg {\color{red}\bfseries{}\textbar{}}.

\item {} 
\includegraphics[width=1em]{osx.png} Double click the icon in your Applications folder.

\end{itemize}
\phantomsection\label{docs/user_manual/introduction/getting_started:fig-simple-session}

\subsection{Caregando camadas vetoriais e de raster dos dados da amostra}
\label{docs/user_manual/introduction/getting_started:load-raster-and-vector-layers-from-the-sample-dataset}\begin{enumerate}
\item {} 
Clique no Load Raster ícone.

\item {} 
Navegue até a pasta qgis\_sample\_data/raster, selecione o arquivo de imagem ERDAS landcover.img e clique {[}Abrir{]}.

\item {} 
Se o arquivo não estiver listado, verifique se a caixa (combobox) do tipo de arquivo na parte inferior está marcada com o tipo correto, nesse caso ``Erdas Imagine Image ({\color{red}\bfseries{}*}.img, {\color{red}\bfseries{}*}.IMG)''.

\item {} 
Agora clique no ícone ``Load Vector''.

\item {} 
O Arquivo deve ser selecionado como tipo de caminho em ``Adicionar Camada Vetorial'' na caixa de diálogo. Agora clique em {[}procurar{]} para selecionar a camada vetorial.

\item {} 
Navegue até a pasta qgis\_sample\_data/gml, selecione GML para o tipo de arquivo na caixa de combinação e então selecione o arquivo GML lakes.gml, clique em {[}Abrir{]} então na caixa de diálogo ``Adicionar vetor'' clique em {[}Ok{]}.

\item {} 
Aplique um pouco de zoom na sua área favorita que contém alguns lagos.

\item {} 
Dê um clique duplo na camada lakes na legenda do mapa para abri a caixa de Propriedades.

\item {} 
Clique na aba Estilo e selecione azul para cor de preenchimento.

\item {} 
Clique na aba Rótulos e marque a caixa ``Mostrar Rótulos'' para habilitar a rotulagem. Escolha o campo NAMES como o campo que contém o rótulo.

\item {} 
Para melhorar a legibilidade dos rótulos você pode adicionar um buffer branco em torno do  rótulo, clicando em Buffer no rótulo e na lista da esquer escolha o tamanho do buffer como 3.

\item {} 
Clique {[}Aplicar{]}, verifique se o resultado é bom e então clique em {[}OK{]}.

\end{enumerate}

Como você pode ver é muito fácil visualizar camadas vetoriais e de raster no QGIS. Vamos passar para as seções seguintes aprendendo mais sobre como a avaliação de funcionalidades. características e configurações e como usá-las.


\section{Iniciando e fechando QGIS}
\label{docs/user_manual/introduction/getting_started:label-startingqgis}\label{docs/user_manual/introduction/getting_started:starting-and-stopping-qgis}
Na Seção: ``Exemplos'' você já aprendeu como iniciar o QGIS. Vamos repetir isso aqui e você verá que o QGIS também fornece mais opções pela linha de comando.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Assuming that QGIS is installed in the PATH, you can start QGIS
by typing: \code{qgis}  at a command prompt or by double clicking on the QGIS
application link (or shortcut) on the desktop or in the application menu.

\item {} 
\includegraphics[width=1em]{win.png} Start QGIS using the Start menu or desktop shortcut,
or double click on a QGIS project file.

\item {} 
\includegraphics[width=1em]{osx.png} Double click the icon in your Applications folder. If you need to
start QGIS in a shell, run
/path-to-installation-executable/Contents/MacOS/Qgis.

\end{itemize}

``Para encerrar QGIS, clique no menu de opções \textbar{} nix \textbar{} \textbar{} win {\color{red}\bfseries{}\textbar{}: Seleção de Menu: ``Arquivo''\textbar{}} OSX {\color{red}\bfseries{}\textbar{}}: Seleção de Menu:  QGIS  ``Encerrar'',  ou use o atalho: ``Ctrl + Q''.


\section{Opções da Linha de Comando}
\label{docs/user_manual/introduction/getting_started:label-commandline}\label{docs/user_manual/introduction/getting_started:command-line-options}
\index{command line options}
\includegraphics[width=1em]{nix.png} QGIS supports a number of options when started from the command line. To
get a list of the options, enter \code{qgis -{-}help} on the command line.
The usage statement for QGIS is:

\begin{Verbatim}[commandchars=\\\{\}]
qgis --help
Quantum GIS - 1.8.0-Lisboa 'Lisboa' (exported)
Quantum GIS (QGIS) is a viewer for spatial data sets, including
raster and vector data.
Usage: qgis [options] [FILES]
  options:
        [--snapshot filename]           emit snapshot of loaded datasets to given file
        [--width width]                 width of snapshot to emit
        [--height height]               height of snapshot to emit
        [--lang language]               use language for interface text
        [--project projectfile]         load the given QGIS project
        [--extent xmin,ymin,xmax,ymax]  set initial map extent
        [--nologo]                      hide splash screen
        [--noplugins]                   don't restore plugins on startup
        [--nocustomization]             don't apply GUI customization
        [--optionspath path]            use the given QSettings path
        [--configpath path]             use the given path for all user configuration
        [--help]                        this text

  FILES:
    Files specified on the command line can include rasters,
    vectors, and QGIS project files (.qgs):
    1. Rasters - Supported formats include GeoTiff, DEM
       and others supported by GDAL
    2. Vectors - Supported formats include ESRI Shapefiles
       and others supported by OGR and PostgreSQL layers using
       the PostGIS extension
\end{Verbatim}

\begin{notice}{tip}{Dica:}
\textbf{Example Using command line arguments}

You can start QGIS by specifying one or more data files
on the command line. For example, assuming you are in the
qgis\_sample\_data directory, you could start QGIS with a vector layer
and a raster file set to load on startup using the following command:
\code{qgis ./raster/landcover.img ./gml/lakes.gml}
\end{notice}

\textbf{Opções da Linha de Comando} - ``--snapshot''

Esta opção permite que você crie um instantâneo no formato PNG da visualização atual. Isto é bem útil quando você tem vários projetos e deseja gerar instantâneos de seus dados.

Por padrão ele gera um arquivo PNG com 800x600 pixels. Isso pode ser modificado utilizando os argumentos na linha de comando ``--widht'' e ``--height''. A nome de arquivo pode ser adicionado depois de ``--snapshot''.

\textbf{Opções da Linha de Comando} - ``--lang''

Based on your locale QGIS, selects the correct localization. If you would like
to change your language, you can specify a language code. For example:
\code{-{-}lang=it}
starts QGIS in italian localization. A list of currently supported
languages with language code and status is provided at
\href{http://hub.qgis.org/wiki/quantum-gis/GUI\_Translation\_Progress}{http://hub.qgis.org/wiki/quantum-gis/GUI\_Translation\_Progress}

\textbf{Opções da Linha de Comando} - ``--project''

É possível iniciar o  QGIS com um arquivo de projeto existente. Basta adicionar na linha de comando a opção ``--project'' seguido pelo  nome do projeto e o QGIS irá abrir com todas as camadas carregadas descritas no arquivo indicado.

\textbf{Opções da Linha de Comando} - ``--extent''

``Para iniciar em um ponto específico do mapa utilize esta opção. Você precisa adicionar na caixa delimitadora de extesão do mapa as coordenadas na seguinte ordem separadas por vírgula :

\begin{Verbatim}[commandchars=\\\{\}]
--extent xmin,ymin,xmax,ymax
\end{Verbatim}

\textbf{Opções da Linha de Comando} - ``--nologo''

Este argumento de linha de comando esconde a tela inicial do QGIS quando ele é iniciado.

\textbf{Opções da Linha de Comando} - ``--noplugins''

Se você tiver problemas ao iniciar o aplicativo com plugins, você pode evitar carregá-los na inicialização. Eles ainda estarão disponíveis no Gerenciador de Plugins para uso.

\textbf{Command line option} \code{-{-}nocustomization}

Using this command line argument existing GUI customization will not be applied
at startup.

\textbf{Opções da Linha de Comando} - ``--optionspath''

Você pode ter múltiplas configurações e decidir qual usar quando inicializar o QGIS utilizando esta opção. Vá em :ref: ``gui\_options'' para verificar onde o sistema operacional salva o arquivo de configurações. Atualmente não há maneira de especificar em qual arquivo será escrito as configurações, portanto, você pode criar uma cópia do arquivo de configurações original e renomeá-lo.

\textbf{Opções da Linha de Comando} - ``--configpath''

This option is similar to the one above, but furthermore overrides the default
path (\textasciitilde{}/.qgis) for user configuration and forces QSettings to use this directory,
too. This allows users to e.g. carry QGIS installation on a flash drive together
with all plugins and settings.


\section{Projetos}
\label{docs/user_manual/introduction/getting_started:sec-projects}\label{docs/user_manual/introduction/getting_started:projects}
The state of your QGIS session is considered a Project.  QGIS
works on one project at a time.  Settings are either considered
as being per-project, or as a default for new projects (see
Section {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Opções}}}). QGIS can save the state of your
workspace into a project file using the menu options
\emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSave.png} \emph{Save Project}
or \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSaveAs.png} \emph{Save Project As}.

Load saved projects into a QGIS session using
\emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileOpen.png} \emph{Open Project}
or \emph{File \(\rightarrow\) Open Recent Project}.

If you wish to clear your session and start fresh, choose
\emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileNew.png} \emph{New Project}.
Either of these menu options will prompt you to save the existing project
if changes have been made since it was opened or last saved.

Os tipos de informações salvas em um arquivo de projeto incluem:
\begin{itemize}
\item {} 
Camadas adicionadas

\item {} 
Propriedades das Camadas, incluido simbologia

\item {} 
Projeção do mapa de visualização

\item {} 
Último ponto visualizado

\end{itemize}

O arquivo de projeto é salvo no formato XML, por isso, é possível editar o arquivo fora do QGIS se você souber o que está fazendo.O formato de arquivo foi atualizado várias vezes em comparação com versões anteriores do QGIS. Arquivos de projeto de versões anteriores do QGIS podem não funcionar mais corretamente. Para ter certeza disso vá na barra de ferramentas, menu Configurações --\textgreater{}Opções, você pode selecionar:

\includegraphics{checkbox.png} \emph{Prompt to save project changes when required}

\includegraphics{checkbox.png} \emph{Warn when opening a project file saved with an older
version of QGIS}


\section{Saída}
\label{docs/user_manual/introduction/getting_started:output}\label{docs/user_manual/introduction/getting_started:sec-output}
\index{output save as image}
\index{print composer quick print}
Há várias maneiras de gerar a saída de sua sessão do QGIS. Já discutimos ``Projetos'' salvando um arquivo de projeto. Aqui existe exemplos de outras formas de produzir arquivos de saída:
\begin{itemize}
\item {} 
Menu option \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Save as Image}}$
opens a file dialog where you select the name, path and type of image (PNG or
JPG format). A world file with extension PNGW or JPGW saved in the same folder
georeferences the image.

\item {} 
Menu option \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionNewComposer.png} \emph{New
Print Composer} opens a dialog where you can layout and print the current map
canvas (see Section {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositor de impressão}}}).

\end{itemize}


\chapter{Interface do QGIS}
\label{docs/user_manual/introduction/qgis_gui:label-qgismainwindow}\label{docs/user_manual/introduction/qgis_gui:qgis-gui}\label{docs/user_manual/introduction/qgis_gui::doc}
When QGIS starts, you are presented with the GUI as shown below
(the numbers 1 through 5 in yellow ovals refer to the six major areas of the
interface as discussed below):
\phantomsection\label{docs/user_manual/introduction/qgis_gui:fig-startup}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{startup.png}
\caption{QGIS GUI with Alaska sample data \includegraphics[width=1em]{nix.png}}\end{figure}

\begin{notice}{note}{Nota:}
Suas decorações de janela (barra de título, etc) podem parecer diferentes dependendo do seu sistema operacional e gerenciador de janelas.
\end{notice}

A interface QGIS é dividida em cinco áreas:
\begin{enumerate}
\item {} 
Barra de Menu

\item {} 
Barra de Ferraementas

\item {} 
Legenda do Mapa

\item {} 
Visualização do mapa

\item {} 
Barra de Status

\end{enumerate}

Estes cinco componentes da interface gráfica do QGIS serão descritos com maior detalhe dentro da próximas seções. Mais duas seções apresentarão atalhos de teclado e ajuda de contexto.


\section{Barra de Menu}
\label{docs/user_manual/introduction/qgis_gui:label-menubar}\label{docs/user_manual/introduction/qgis_gui:menu-bar}
\index{menus}
The menu bar provides access to various QGIS features using a standard
hierarchical menu. The top-level menus and a summary of some of the
menu options are listed below, together with the icons of the corresponding
tools as they appear on the toolbar, as well as keyboard shortcuts. Keyboard
shortcuts can also be configured manually (shortcuts presented in this
section are the defaults), using the {[}\textbf{Configure Shortcuts}{]} tool under
\emph{Settings}.

Although most menu options have a corresponding tool and vice-versa,
the menus are not organized quite like the toolbars.
The toolbar containing the tool is listed after each menu option as a checkbox
entry. Some menu options only appear, if the corresponding plugin is loaded.
For more information about tools and toolbars, see Section {\hyperref[docs/user_manual/introduction/qgis_gui:label-toolbars]{\emph{Barra de Ferramentas}}}.


\subsection{File}
\label{docs/user_manual/introduction/qgis_gui:file}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\includegraphics[width=1.5em]{mActionFileNew.png} \emph{Novo Projeto}
 & 
\code{Ctrl+N}
 & 
ver {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Projetos}}}
 & 
\emph{Arquivo}
\\

\includegraphics[width=1.5em]{mActionFileOpen.png} \emph{Abrir Projeto}
 & 
\code{Ctrl+O}
 & 
ver {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Projetos}}}
 & 
\emph{Arquivo}
\\

\emph{Abrir projeto recente \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Projetos}}}
 & 

\\

\includegraphics[width=1.5em]{mActionFileSave.png} \emph{Salvar Projeto}
 & 
\code{Ctrl+S}
 & 
ver {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Projetos}}}
 & 
\emph{Arquivo}
\\

\includegraphics[width=1.5em]{mActionFileSaveAs.png} \emph{Salvar Projeto com}
 & 
\code{Ctrl+Shift+S}
 & 
ver {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Projetos}}}
 & 
\emph{Arquivo}
\\

\includegraphics[width=1.5em]{mActionSaveMapAsImage.png} \emph{Salvar a tela como imagem}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/getting_started:sec-output]{\emph{Saída}}}
 & 

\\

\includegraphics[width=1.5em]{mActionNewComposer.png} \emph{Novo compositor de impressão}
 & 
\code{Ctrl+P}
 & 
ver {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositor de impressão}}}
 & 
\emph{Arquivo}
\\

\includegraphics[width=1.5em]{mActionComposerManager.png} \emph{Gerenciador do compositor}
 & 

 & 
ver {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositor de impressão}}}
 & 
\emph{Arquivo}
\\

\emph{Print Composers \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositor de impressão}}}
 & 

\\

\includegraphics{mActionFileExit.png} \emph{Sair}
 & 
\code{Ctrl+Q}
 & 

 & 

\\
\hline\end{tabulary}



\subsection{Edit}
\label{docs/user_manual/introduction/qgis_gui:edit}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\includegraphics[width=1.5em]{mActionUndo.png} \emph{Desfazer}
 & 
\code{Ctrl+Z}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionRedo.png} \emph{Refazer}
 & 
\code{Ctrl+Shift+Z}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionEditCut.png} \emph{Recortar Feições}
 & 
\code{Ctrl+X}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copiar feições}
 & 
\code{Ctrl+C}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Colar feições}
 & 
\code{Ctrl+V}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Adicionar feição}
 & 
\code{Ctrl+.}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png} \emph{Move Feature(s)}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionDeleteSelected.png} \emph{Excluir Selecionado(s)}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=2em]{mActionSimplify.png} \emph{Simplificar feições}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=2em]{mActionAddRing.png} \emph{Adicionar Anel}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=2em]{mActionAddIsland.png} \emph{Adicionar Parte}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=2em]{mActionDeleteRing.png} \emph{Excluir Anel}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=2em]{mActionDeletePart.png} \emph{Excluir Parte}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionReshape.png} \emph{Remodelar feições}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionOffsetCurve.png} \emph{Curva de deslocamento}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionSplitFeatures.png} \emph{Quebras Feições}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png} \emph{Mesclar feições selecionadas}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png} \emph{Merge attr. of selected Features}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\

\includegraphics[width=1.5em]{mActionNodeTool.png} \emph{Ferramenta de nós}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionRotatePointSymbols.png} \emph{Rotacionar pontos com simbolos}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalização Avançada}}}
 & 
\emph{Digitalização Avançada}
\\
\hline\end{tabulary}






After activating \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Toggle editing}}$ mode
for a layer, you will find the \code{Add Feature} icon in the \emph{Edit}
menu depending on the layer type (point, line or polygon).


\subsection{Edit (extra)}
\label{docs/user_manual/introduction/qgis_gui:edit-extra}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Adicionar feição}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionCaptureLine.png} \emph{Adicionar feição}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionCapturePolygon.png} \emph{Adicionar feição}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}}
 & 
\emph{Digitalização}
\\
\hline\end{tabulary}



\subsection{View}
\label{docs/user_manual/introduction/qgis_gui:view}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\includegraphics[width=1.5em]{mActionPan.png} \emph{Panorâmica no Mapa}
 & 

 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionPanToSelected.png} \emph{Mover mapa para seleção}
 & 

 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionZoomIn.png} \emph{Aproximar}
 & 
\code{Ctrl++}
 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionZoomOut.png} \emph{Afastar}
 & 
\code{Ctrl+-}
 & 

 & 
\emph{Navegação no Mapa}
\\

\emph{Selecionar \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/general_tools:sec-selection]{\emph{Selecionar e desselecionar feições}}}
 & 
\emph{Atributos}
\\

\includegraphics[width=1.5em]{mActionIdentify.png} \emph{Identificar feições}
 & 
\code{Ctrl+Shift+I}
 & 

 & 
\emph{Atributos}
\\

\emph{Medir \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/general_tools:sec-measure]{\emph{Medição}}}
 & 
\emph{Atributos}
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Ver tudo}
 & 
\code{Ctrl+Shift+F}
 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionZoomToLayer.png} \emph{Aproximar à camada}
 & 

 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionZoomToSelected.png} \emph{Aproximar à seleção}
 & 
\code{Ctrl+J}
 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionZoomLast.png} \emph{Última visualização}
 & 

 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionZoomNext.png} \emph{Próxima visualização}
 & 

 & 

 & 
\emph{Navegação no Mapa}
\\

\includegraphics[width=1.5em]{mActionZoomActual.png} \emph{Zoom Actual Size}
 & 

 & 

 & 
\emph{Navegação no Mapa}
\\

\emph{Decorações \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/general_tools:decorations]{\emph{Decorações}}}
 & 

\\

\includegraphics[width=1.5em]{mActionMapTips.png} \emph{Dicas do Mapa}
 & 

 & 

 & 
\emph{Atributos}
\\

\includegraphics[width=1.5em]{mActionNewBookmark.png} \emph{Novo Favorito...}
 & 
\code{Ctrl+B}
 & 
ver {\hyperref[docs/user_manual/introduction/general_tools:sec-bookmarks]{\emph{Favoritos Espaciais}}}
 & 
\emph{Atributos}
\\

\includegraphics[width=1.5em]{mActionShowBookmarks.png} \emph{Mostrar Favoritos}
 & 
\code{Ctrl+Shift+B}
 & 
ver {\hyperref[docs/user_manual/introduction/general_tools:sec-bookmarks]{\emph{Favoritos Espaciais}}}
 & 
\emph{Atributos}
\\

\includegraphics[width=1.5em]{mActionDraw.png} \emph{Atualizar}
 & 
\code{Ctrl+R}
 &  & 
\emph{Navegação no Mapa}
\\

\emph{Escala deslizante}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:tilesets]{\emph{Tilesets}}}
 & 
\emph{Escala quadriculada}
\\
\hline\end{tabulary}



\subsection{Layer}
\label{docs/user_manual/introduction/qgis_gui:layer}
\begin{longtable}{|l|l|l|l|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline\endfirsthead

\multicolumn{4}{c}%
{{\textsf{\tablename\ \thetable{} -- continuação da página anterior}}} \\
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline\endhead

\hline \multicolumn{4}{|r|}{{\textsf{Continuação na próxima página}}} \\ \hline
\endfoot

\endlastfoot


\emph{New \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-create-shape]{\emph{Creating a new Vector layer}}}
 & 
\emph{Gerenciar camadas}
\\

\emph{Incorporar camadas e grupos...}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/general_tools:nesting-projects]{\emph{Projetos animados}}}
 & 

\\

\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} \emph{Adicionar camada vetorial...}
 & 
\code{Ctrl+Shift+V}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/index:label-workingvector]{\emph{Trabalhando com dados vetoriais}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionAddRasterLayer.png} \emph{Adicionar camada raster}
 & 
\code{Ctrl+Shift+R}
 & 
ver {\hyperref[docs/user_manual/working_with_raster/supported_data:load-raster]{\emph{Carregando dados raster no QGIS}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionAddLayer.png} \emph{Adicionar camada PostGIS}
 & 
\code{Ctrl+Shift+D}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/supported_data:label-postgis]{\emph{Camadas PostGIS}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} \emph{Adicionar camada SpatiaLite}
 & 
\code{Ctrl+Shift+L}
 & 
ver {\hyperref[docs/user_manual/working_with_vector/supported_data:label-spatialite]{\emph{Camadas SpatiaLite}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionAddMssqlLayer.png} \emph{Add MSSQL Spatial Layer}
 & 
\code{Ctrl+Shift+M}
 & 
see {\hyperref[docs/user_manual/working_with_vector/supported_data:label-mssql]{\emph{MSSQL Spatial Layers}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionAddWmsLayer.png} \emph{Adicionar camada WMS}
 & 
\code{Ctrl+Shift+W}
 & 
ver {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms]{\emph{Cliente WMS}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{delimited_text.png} \emph{Adicionar uma camada a partir de um texto delimitado}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_delimited_text:label-dltext]{\emph{Delimited Text Plugin}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{gps_importer.png} \emph{Criar uma nova camada GPX}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Complemento GPS}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{oracle_raster.png} \emph{Adicionar Camada Oracle GeoRaster}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:oracle-raster]{\emph{Complemento Oracle GeoRaster}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{sqlanywhere.png} \emph{Adicionar camada SQL Anywhere}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere]{\emph{Complemento SQL Anywhere}}}
 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{wfs.png} \emph{Adicionar camada WFS}
 & 

 & 

 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copiar estilo}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Aba de Estilo}}}
 & 

\\

\includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Colar estilo}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Aba de Estilo}}}
 & 

\\

\includegraphics[width=1.5em]{mActionOpenTable.png} \emph{Abrir tabela de Atributos}
 & 

 & 

 & 
\emph{Atributos}
\\

\includegraphics[width=1.5em]{mActionFileSave.png} \emph{Salvar alterações}
 & 

 & 

 & 
\emph{Digitalização}
\\

\includegraphics[width=1.5em]{mActionToggleEditing.png} \emph{Alternar edição}
 & 

 & 

 & 
\emph{Digitalização}
\\

\emph{Savar como...}
 & 

 & 

 & 

\\

\emph{Savar arquivo vetor como...}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table]{\emph{Trabalhando com a Tabela de Atributos}}}
 & 

\\

\includegraphics[width=1.5em]{mActionRemoveLayer.png} \emph{Remover Camada(s)}
 & 
\code{Ctrl+D}
 & 

 & 

\\

\emph{Definir SRC da(s) Camada(s)}
 & 
\code{Ctrl+Shift+C}
 & 

 & 

\\

\emph{Definir o SRC do projeto a partir da camada}
 & 

 & 

 & 

\\

\emph{Propriedades...}
 & 

 & 

 & 

\\

\emph{Pesquisa...}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionLabeling.png} \emph{Rotular}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionInOverview.png} \emph{Adicionar para a Visão Geral}
 & 
\code{Ctrl+Shift+O}
 & 

 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionAddAllToOverview.png} \emph{Adicionar tudo para a Visão Geral}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionRemoveAllFromOverview.png} \emph{Remover tudo da Visão Geral}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionShowAllLayers.png} \emph{Mostrar todas as camadas}
 & 
\code{Ctrl+Shift+U}
 & 

 & 
\emph{Gerenciar camadas}
\\

\includegraphics[width=1.5em]{mActionHideAllLayers.png} \emph{Ocultar todas as camadas}
 & 
\code{Ctrl+Shift+H}
 & 

 & 
\emph{Gerenciar camadas}
\\
\hline\end{longtable}



\subsection{Settings}
\label{docs/user_manual/introduction/qgis_gui:settings}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\emph{Painéis \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Painéis e Barra de Ferramentas}}}
 & 

\\

\emph{Barra de Ferramentas \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Painéis e Barra de Ferramentas}}}
 & 

\\

\emph{Mudar para o modo de tela inteira}
 & 
\code{Ctrl-F}
 & 

 & 

\\

\includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Propriedades do Projeto ...}
 & 
\code{Ctrl+Shift+P}
 & 
ver {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Projetos}}}
 & 

\\

\includegraphics[width=1.5em]{mActionCustomProjection.png} \emph{SRC Personalizado...}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_projections/working_with_projections:sec-custom-projections]{\emph{Sistema de Referência de Coordenadas Personalizado}}}
 & 

\\

\emph{Gerenciador de estilos...}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{\emph{Gerenciador de estilo}}}
 & 

\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Configurar atalhos...}
 & 

 & 

 & 

\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Personalização ...}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-customization]{\emph{Customização}}}
 & 

\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Opções ...}
 & 

 & 
ver {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Opções}}}
 & 

\\

\emph{Opções de ajuste ...}
 & 

 & 

 & 

\\
\hline\end{tabulary}



\subsection{Plugins}
\label{docs/user_manual/introduction/qgis_gui:plugins}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\includegraphics[width=1.5em]{plugin_installer.png} \emph{Buscar Complementos Python}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins:plugins]{\emph{Complementos QGIS}}}
 & 

\\

\includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gerenciar complementos}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gerenciar Complementos}}}
 & 

\\

\emph{Terminal Python}
 & 

 & 

 & 

\\

\emph{GRASS \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integração com SIG GRASS}}}
 & 
\emph{GRASS}
\\
\hline\end{tabulary}



\subsection{Vector}
\label{docs/user_manual/introduction/qgis_gui:vector}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\emph{Analisar \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Complemento fTools}}}
 & 

\\

\emph{Captura de Coordenadas  \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:coordcapt]{\emph{Complemento Captura de coordenadas}}}
 & 

\\

\emph{Gerenciar dados \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Complemento fTools}}}
 & 

\\

\emph{Dxf2Shp \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape]{\emph{Dxf2Shp Converter Plugin}}}
 & 
\emph{Vetor}
\\

\emph{Geometrias \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Complemento fTools}}}
 & 

\\

\emph{Geoprocessing Tools \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Complemento fTools}}}
 & 

\\

\emph{GPS \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Complemento GPS}}}
 & 
\emph{Vetor}
\\

\emph{Investigar \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Complemento fTools}}}
 & 

\\

\emph{Road Graph \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_road_graph:roadgraph]{\emph{Compemento Caminho Mais Curto}}}
 & 

\\

\emph{Consulta Epacial \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_spatial_query:spatial-query]{\emph{Plugin de Consulta Espacial}}}
 & 
\emph{Vetor}
\\
\hline\end{tabulary}



\subsection{Raster}
\label{docs/user_manual/introduction/qgis_gui:raster}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\emph{Calculadora Raster}
 & 

 & 
ver {\hyperref[docs/user_manual/working_with_raster/raster_calculator:sec-raster-calc]{\emph{Calculadora Raster}}}
 & 

\\

\emph{Georeferenciador \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_georeferencer:georef]{\emph{Complemento Georreferenciador}}}
 & 
\emph{Raster}
\\

\emph{Mapa de calor \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_heatmap:heatmap-plugin]{\emph{Complemento de Mapa de Calor}}}
 & 
\emph{Raster}
\\

\emph{Interpolação \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_interpolation:interpol]{\emph{Complemento de Interpolação}}}
 & 
\emph{Raster}
\\

\includegraphics[width=1.5em]{dem.png} \emph{Terrain Analysis}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:rasterrain]{\emph{Raster Terrain Analysis Plugin}}}
 & 

\\

\emph{Estatística por Zonas \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics]{\emph{Complemento Estatística Zonal}}}
 & 
\emph{Raster}
\\

\emph{Projeções \(\rightarrow\)}
 & 

 & 
ver :ref:{\color{red}\bfseries{}{}`}label\_plugingdaltools
 & 

\\

\emph{Conversão \(\rightarrow\)}
 & 

 & 
ver :ref:{\color{red}\bfseries{}{}`}label\_plugingdaltools
 & 

\\

\emph{Extração \(\rightarrow\)}
 & 

 & 
ver :ref:{\color{red}\bfseries{}{}`}label\_plugingdaltools
 & 

\\

\emph{Análise \(\rightarrow\)}
 & 

 & 
ver :ref:{\color{red}\bfseries{}{}`}label\_plugingdaltools
 & 

\\

\emph{Miscelânea \(\rightarrow\)}
 & 

 & 
ver :ref:{\color{red}\bfseries{}{}`}label\_plugingdaltools
 & 

\\

\emph{Configurações do GdalTools}
 & 

 & 
ver :ref:{\color{red}\bfseries{}{}`}label\_plugingdaltools
 & 

\\
\hline\end{tabulary}



\subsection{Database}
\label{docs/user_manual/introduction/qgis_gui:database}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\emph{DB manager \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Complemento DB Manager}}}
 & 
\emph{Base de Dados}
\\

\emph{eVis \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_evis:evis]{\emph{Complemento eVis}}}
 & 
\emph{Base de Dados}
\\

\emph{Edição offline \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_offline_editing:offlinedit]{\emph{Complemento Edição Offline}}}
 & 
\emph{Base de Dados}
\\

\emph{Spit \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_spit:label-spit]{\emph{Complemento SPIT}}}
 & 
\emph{Base de Dados}
\\
\hline\end{tabulary}



\subsection{Web}
\label{docs/user_manual/introduction/qgis_gui:web}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\emph{MapServer Export ... \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:mapserver-export]{\emph{Complemento de exportação do MapServer}}}
 & 
\emph{Web}
\\

\emph{OpenStreetMap \(\rightarrow\)}
 & 

 & 
ver {\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}
 & 
\emph{OpenStreetMap}
\\
\hline\end{tabulary}



\subsection{Help}
\label{docs/user_manual/introduction/qgis_gui:help}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Opção de menu
} & \textsf{\relax 
Atalho
} & \textsf{\relax 
Referência
} & \textsf{\relax 
Barra de Ferramentas
}\\
\hline
\includegraphics[width=1.5em]{mActionHelpContents.png} \emph{Conteúdo da Ajuda}
 & 
\code{F1}
 & 

 & 
\emph{Ajuda}
\\

\includegraphics[width=1.5em]{whats_this.png} \emph{What's This?}
 & 
\code{Shift+F1}
 & 

 & 
\emph{Ajuda}
\\

\emph{Documentação API}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionQgisHomePage.png} \emph{Página do QGIS}
 & 
\code{Ctrl+H}
 & 

 & 

\\

\includegraphics[width=1.5em]{mActionCheckQgisVersion.png} \emph{Verificar a versão do QGIS}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionHelpAbout.png} \emph{Sobre}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionHelpSponsors.png} \emph{Patrocinadores}
 & 

 & 

 & 

\\
\hline\end{tabulary}




Please not that for Linux \includegraphics[width=1em]{nix.png} the Menu Bar items listed above are the default ones
in KDE window manager. In GNOME, Settings menu is missing and its items are to be
found here:

\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Propriedades do Projeto}
 & 
\emph{Arquivo}
\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Opções}
 & 
\emph{Editar}
\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Configurar Atalhos}
 & 
\emph{Editar}
\\

\emph{Gerenciar estilo}
 & 
\emph{Editar}
\\

\includegraphics[width=1.5em]{mActionCustomProjection.png} \emph{SRC personalizado}
 & 
\emph{Editar}
\\

\emph{Painéis \(\rightarrow\)}
 & 
\emph{Exibir}
\\

\emph{Barra de Ferramentas \(\rightarrow\)}
 & 
\emph{Exibir}
\\

\emph{Mudar para o Modo de Tela Inteira}
 & 
\emph{Exibir}
\\

\emph{Escala deslizante}
 & 
\emph{Exibir}
\\

\emph{Live GPS tracking}
 & 
\emph{Exibir}
\\
\hline\end{tabulary}



\section{Barra de Ferramentas}
\label{docs/user_manual/introduction/qgis_gui:label-toolbars}\label{docs/user_manual/introduction/qgis_gui:toolbar}
\index{toolbar}
A barra de ferramentas permite o acesso à maioria das mesmas funções dos menus, além de ferramentas adicionais para interagir com o mapa. Cada item da barra de ferramentas pop-up tem ajuda disponível. Mantenha o mouse sobre o item e uma breve descrição do propósito da ferramenta será exibido.

Every menubar can be moved around according to your needs. Additionally every
menubar can be switched off using your right mouse button context menu holding
the mouse over the toolbars (read also {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Painéis e Barra de Ferramentas}}}).

\index{layout toolbars}
\begin{notice}{tip}{Dica:}
\textbf{Restaurar barra de ferramentas}

If you have accidentally hidden all your toolbars, you can get them
back by choosing menu option \emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\)}.
If a toolbar disappears under Windows, which seems to be a problem in
QGIS from time to time, you have to remove \code{\textbackslash{}HKEY\_CURRENT\_USER\textbackslash{}Software\textbackslash{}QuantumGIS\textbackslash{}qgis\textbackslash{}UI\textbackslash{}state}
in the registry. When you restart QGIS, the key is written again with the
default state, and all toolbars are visible again.
\end{notice}


\section{Legenda do Mapa}
\label{docs/user_manual/introduction/qgis_gui:map-legend}\label{docs/user_manual/introduction/qgis_gui:label-legend}
\index{legend}
The map legend area lists all the layers in the project. The checkbox in each
legend entry can be used to show or hide the layer.

\index{layer visibility}
Uma camada pode ser selecionada e arrastada para cima ou para baixo na legenda para mudar a z-ordenação. Z-ordenação significa que as camadas listadas mais perto do topo da legenda são desenhadas sobre camadas listadas mais abaixo na legenda.

Layers in the legend window can be organised into groups. There are two ways to do so:
\begin{enumerate}
\item {} 
Right click in the legend window and choose \emph{Add Group}. Type in a
name for the group and press \code{Enter}. Now click on an existing layer and drag it
onto the group.

\item {} 
Select some layers, right click in the legend window and choose \emph{Group Selected}.
The selected layers will automatically be placed in a new group.

\end{enumerate}

To bring a layer out of a group you can drag it out, or right click on it and
choose \emph{Make to toplevel item}. Groups can be nested inside other groups.

A caixa de seleção de um grupo vai mostrar ou ocultar todas as camadas do grupo com apenas um clique.

The content of the right mouse button context menu depends on whether the selected
legend item is a raster or a vector layer. For GRASS vector layers
\includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Toggle editing}}$ is not available. See section
{\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Digitalizando e editando uma camada vetorial GRASS}}} for information on editing GRASS vector layers.

\textbf{Menu botão direito do mouse para camadas raster}
\begin{itemize}
\item {} 
\emph{Zoom to layer extent}

\item {} 
\emph{Zoom to best scale (100 \%)}

\item {} 
\emph{Show in overview}

\item {} 
\emph{Remove}

\item {} 
\emph{Set Layer CRS}

\item {} 
\emph{Set Project CRS from Layer}

\item {} 
\emph{Propriedades...}

\item {} 
\emph{Rename}

\item {} 
\emph{Copy Style}

\item {} 
\emph{Add New Group}

\item {} 
\emph{Expand all}

\item {} 
\emph{Collapse all}

\item {} 
\emph{Update Drawing Order}

\end{itemize}

Additionally, according to layer position and selection
\begin{itemize}
\item {} 
\emph{Make to toplevel item}

\item {} 
\emph{Group Selected}

\end{itemize}



\textbf{Menu botão direito do mouse para camadas vetor}
\begin{itemize}
\item {} 
\emph{Zoom to layer extent}

\item {} 
\emph{Show in overview}

\item {} 
\emph{Remove}

\item {} 
\emph{Set Layer CRS}

\item {} 
\emph{Set Project CRS from Layer}

\item {} 
\emph{Open attribute table}

\item {} 
\emph{Toggle editing} (not available for GRASS layers)

\item {} 
\emph{Save as}

\item {} 
\emph{Save selection as}

\item {} 
\emph{Query}

\item {} 
\emph{Show Feature Count}

\item {} 
\emph{Propriedades...}

\item {} 
\emph{Rename}

\item {} 
\emph{Copy Style}

\item {} 
\emph{Add New Group}

\item {} 
\emph{Expand all}

\item {} 
\emph{Collapse all}

\item {} 
\emph{Update Drawing Order}

\end{itemize}

Additionally, according to layer position and selection
\begin{itemize}
\item {} 
\emph{Make to toplevel item}

\item {} 
\emph{Group Selected}

\end{itemize}



\textbf{Menu botão direito do mouse para grupo de camadas}
\begin{itemize}
\item {} 
\emph{Zoom to group}

\item {} 
\emph{Remove}

\item {} 
\emph{Set group CRS}

\item {} 
\emph{Rename}

\item {} 
\emph{Add New Group}

\item {} 
\emph{Expand all}

\item {} 
\emph{Collapse all}

\item {} 
\emph{Update Drawing Order}

\end{itemize}

It is possible to select more than one layer or group at the same time
by holding down the \code{Ctrl} key while selecting the layers with the
left mouse button. You can then move all selected layers to a new group at
the same time.

You are also able to delete more than one Layer or Group at once by selecting
several Layers with the \code{Ctrl} key and pressing \code{Ctrl+D} afterwards.
This way all selected Layers or groups will be removed from the layerlist.


\subsection{Working with the Legend independent layer order}
\label{docs/user_manual/introduction/qgis_gui:working-with-the-legend-independent-layer-order}
Since QGIS 1.8 there is a widget that allows to define a legend independent
drawing order. You can activate it in the menu \emph{Settings \(\rightarrow\) Panels}.
Determine the drawing order of the layers in the map view here. Doing so makes
it possible to order your layers in order of importance, for example, but to
still display them in the correct order (see {\hyperref[docs/user_manual/introduction/qgis_gui:figure-layer-order]{figure\_layer\_order}}). Checking the
\includegraphics{checkbox.png} \emph{control rendering order} box underneath the list of layers
will cause a revert to default behavior.
\phantomsection\label{docs/user_manual/introduction/qgis_gui:figure-layer-order}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{layer_order.png}
\caption{Define a legend independent layer order \includegraphics[width=1em]{nix.png}}\end{figure}


\section{Visualização do mapa}
\label{docs/user_manual/introduction/qgis_gui:map-view}\label{docs/user_manual/introduction/qgis_gui:label-mapview}
This is the ``business end'' of QGIS - maps are displayed in this area! The
map displayed in this window will depend on the vector and raster layers you
have chosen to load (see sections that follow for more information on how to
load layers). The map view can be panned (shifting the focus of the map display
to another region) and zoomed in and out. Various other operations can be
performed on the map as described in the toolbar description above.  The map
view and the legend are tightly bound to each other - the maps in view reflect
changes you make in the legend area.

\index{zoom mouse wheel}
\begin{notice}{tip}{Dica:}
\textbf{Ampliando o mapa com a roda do mouse}

You can use the mouse wheel to zoom in and out on the map. Place
the mouse cursor inside the map area and roll the wheel forward (away from
you) to zoom in and backwards (towards you) to zoom out. The mouse cursor
position is the center where the zoom occurs. You can customize the behavior
of the mouse wheel zoom using the \emph{Map tools} tab under
the \emph{Settings \(\rightarrow\) Options} menu.
\end{notice}

\begin{notice}{tip}{Dica:}
\textbf{Percorrendo o mapa com as setas e a barra de espaço}

\index{pan arrow keys}
Você pode usar as setas do teclado para se deslocar no mapa. Coloque o cursor do mouse dentro da área do mapa e clique na seta para a direita para pan Leste, seta para a esquerda para pan Oeste, seta para cima para pan Norte e para baixo seta para deslocar Sul. Você também pode deslocar o mapa utilizando a barra de espaço: basta mover o mouse enquanto pressiona barra de espaço.
\end{notice}
\phantomsection\label{docs/user_manual/introduction/qgis_gui:label-mapoverview}

\section{Barra de Status}
\label{docs/user_manual/introduction/qgis_gui:label-statusbar}\label{docs/user_manual/introduction/qgis_gui:status-bar}\label{docs/user_manual/introduction/qgis_gui:label-mapoverview}
A barra de status mostra sua posição atual nas coordenadas do mapa (por exemplo, metros ou graus decimais) como o ponteiro do mouse é movido através da visualização do mapa. Para a esquerda da tela de coordenadas na barra de status tem um pequeno botão que irá alternar entre mostrar posição coordenada ou como você está visualizando as extensões do mapa como pan e zoom in e out.

Next to the coordinate display you find the scale display. It shows the scale of
the map view. If you zoom in or out QGIS shows you the current scale. Since QGIS 1.8
there is a scale selector which allows you to choose between predefined scales
from 1:500 until 1:1000000.

Uma barra de progresso na barra de status mostra o progresso de renderização como cada camada é atraída para a visualização do mapa. Em alguns casos, como a coleta de estatísticas em camadas raster, a barra de progresso será usada para mostrar o status de operações demoradas.

If a new plugin or a plugin update is available, you will see a message at the
far right of the status bar. On the right side of the status bar is a small
checkbox which can be used to temporarily prevent layers being rendered to the
map view (see Section {\hyperref[docs/user_manual/introduction/general_tools:redraw-events]{\emph{Renderização}}} below). The icon \includegraphics[width=1.5em]{mIconStopRendering.png}
immediately stops the current map rendering process.

To the right of the render functions you find the EPSG code of the current
project CRS and a projector icon. Clicking on this opens the projection properties
for the current project.

\begin{notice}{tip}{Dica:}
\textbf{Calculando a escala correta do seu Mapa da tela/visualização}

\index{scale calculate}
When you start QGIS, degrees is the default unit, and it tells QGIS
that any coordinate in your layer is in degrees. To get correct scale values,
you can either change this to meter manually in the \emph{General} tab
under \emph{Settings \(\rightarrow\) Project Properties} or you can select a
project Coordinate Reference System (CRS) clicking on the \includegraphics[width=1.5em]{mIconProjectionDisabled.png}
$^{\text{CRS status}}$ icon in the lower right-hand corner of the statusbar. In
the last case, the units are set to what the project projection specifies,
e.g. `+units=m'.
\end{notice}


\chapter{Ferramentas Gerais}
\label{docs/user_manual/introduction/general_tools::doc}\label{docs/user_manual/introduction/general_tools:general-tools}

\section{Atalhos de teclado}
\label{docs/user_manual/introduction/general_tools:shortcuts}\label{docs/user_manual/introduction/general_tools:keyboard-shortcuts}
\index{Atalhos de teclado}
QGIS provides default keyboard shortcuts for many features. You find them in
Section {\hyperref[docs/user_manual/introduction/qgis_gui:label-menubar]{\emph{Barra de Menu}}}. Additionally the menu option
\emph{Settings \(\rightarrow\) Configure Shortcuts} allows to
change the default keyboard shortcuts and to add new keyboard shortcuts to QGIS
features.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-shortcuts}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{shortcuts.png}
\caption{Define shortcut options \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}

A configuração é muito simples. Basta selecionar uma função da lista e clicar em \textbf{{[}Mudar{]}}, \textbf{{[}Desmarcar{]} ** ou ** {[}Marcar como padrão{]}}. Depois de ter encontrado sua configuração, você pode salvar como um arquivo XML e carregá-la em outra instalação do QGIS.


\section{Conteúdo da ajuda}
\label{docs/user_manual/introduction/general_tools:context-help}\label{docs/user_manual/introduction/general_tools:id1}
\index{Conteúdo da ajuda}
Quando precisar de ajuda sobre um tópico específico, você pode acessar a contúdo da ajuda através do: guilabel: Botão `Ajuda' disponível na maioria dos diálogos - observe que complementos de terceiros podem apontar para páginas web dedicadas.


\section{Renderização}
\label{docs/user_manual/introduction/general_tools:rendering}\label{docs/user_manual/introduction/general_tools:redraw-events}
\index{Renderização}
Por padrão, o QGIS torna todas as camadas visíveis sempre que a tela do mapa for atualizada. Os eventos que desencadeiam uma atualização da tela do mapa incluem:
\begin{itemize}
\item {} 
Adicionar uma camada

\item {} 
Pan ou zoom

\item {} 
Redimensionar a janela do QGIS

\item {} 
Mudanças na visibilidade de uma camada ou camadas

\end{itemize}

QGIS permite controlar o processo de renderização de várias formas.


\subsection{Escala dependente da renderização}
\label{docs/user_manual/introduction/general_tools:scale-dependent-rendering}
\index{Rendering scale dependent}
Renderização dependente da escala permite que você especifique as escalas mínimas e máxima em que uma camada será visível. Para definir dependência de escala de renderização, abra o: guilabel: diálogo \emph{Propriedades} clicando duas vezes sobre a camada na legenda. Na: guilabel: na guia \emph{Geral}, defina os valores de escala mínimo e máximo e clique na \includegraphics{checkbox.png}: guilabel: caixa de seleção \emph{Utilize renderização de escala dependente}.

Você pode determinar os valores de escala na primeira ampliação para o nível que você deseja usar e observando o valor de escala na barra de status do QGIS.

\index{Scale}

\subsection{Controlando a renderização do mapa}
\label{docs/user_manual/introduction/general_tools:index-4}\label{docs/user_manual/introduction/general_tools:controlling-map-rendering}\label{docs/user_manual/introduction/general_tools:label-controlmap}
A renderização do mapa pode ser controlada por vários caminhos:


\subsubsection{Suspending Rendering}
\label{docs/user_manual/introduction/general_tools:label-suspendrender}\label{docs/user_manual/introduction/general_tools:suspending-rendering}
Para suspender a rendirização, clique o \includegraphics{checkbox.png} :guilabel: caixa de seleção \emph{Renderizar} no canto direito inferior da barra de status. Quando a \includegraphics{checkbox.png} :guilabel: caixa de seleção \emph{Renderizar} não estiver marcada, QGIS não redesenhará a tela em resposta a qualquer evento descrito na Seção: ref:\emph{redraw\_events}. Exemplos de quando você pode querer suspender a renderização incluem:
\begin{itemize}
\item {} 
Adicionar muitas camadas e simbolizá-las antes de desenhar

\item {} 
Adicionar uma ou mais camadas grandes e definir a dependência de escala antes de desenhar

\item {} 
Adicionar uma ou mais camadas e ampliar para uma visualização especifica antes de desenhar

\item {} 
Qualquer combinação dos anteriores

\end{itemize}

Caixa de seleção \includegraphics{checkbox.png} :guilabel: caixa de seleção \emph{Renderizar} permite renderização e causa uma atualização imediata na tela do mapa.


\subsubsection{Setting Layer Add Option}
\label{docs/user_manual/introduction/general_tools:setting-layer-add-option}\label{docs/user_manual/introduction/general_tools:label-settinglayer}
Você pode definir uma opção para sempre carregar novas camadas sem desenhá-las. Isto significa que a camada será adicionada ao mapa, mas a sua caixa visibilidade na legenda será desmarcada por padrão. Para definir esta opção, escolha a opção do menu :menuselection : \emph{Configurações -\textgreater{} Opções -\textgreater{}} e clique na: guilabel: Guia \emph{Renderização}. Desmarque a \includegraphics{checkbox.png}: guilabel: caixa de seleção \emph{Por padrão novas camadas adicionadas ao mapa podem ser mostradas}. Qualquer camada adicionada ao mapa será desligada (invisível) por padrão.


\subsubsection{Parar rendirização}
\label{docs/user_manual/introduction/general_tools:stopping-rendering}
\index{Rendering halting}\phantomsection\label{docs/user_manual/introduction/general_tools:label-stoprender}
To stop the map drawing, press the \code{ESC} key. This will halt the refresh of
the map canvas and leave the map partially drawn. It may take a bit of time
between pressing \code{ESC} and the time the map drawing is halted.

\begin{notice}{note}{Nota:}
No momento não é possível parar de renderização - ela foi desativada na porta qt4 por causa de problemas e falhas na interface do usuário (UI).
\end{notice}


\subsubsection{Updating the Map Display During Rendering}
\label{docs/user_manual/introduction/general_tools:updating-the-map-display-during-rendering}\label{docs/user_manual/introduction/general_tools:label-updatemap}
\index{rendering update during drawing}
You can set an option to update the map display as features are drawn. By
default, QGIS does not display any features for a layer until the entire
layer has been rendered. To update the display as features are read from the
datastore, choose menu option \emph{Settings \(\rightarrow\) Options}
click on the \emph{Rendering} tab. Set the feature count to an
appropriate value to update the display during rendering. Setting a value of 0
disables update during drawing (this is the default). Setting a value too low
will result in poor performance as the map canvas is continually updated
during the reading of the features. A suggested value to start with is 500.


\subsubsection{Influence Rendering Quality}
\label{docs/user_manual/introduction/general_tools:label-renderquality}\label{docs/user_manual/introduction/general_tools:influence-rendering-quality}
\index{rendering quality}
To influence the rendering quality of the map you have 2 options. Choose menu
option \emph{Settings \(\rightarrow\) Options} click on the \emph{Rendering}
tab and select or deselect following checkboxes.
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Fazer linhas aparecem com menos definição para não peder performance ao renderizar}

\item {} 
\includegraphics{checkbox.png} \emph{Ajustar problemas com polígonos preenchidos incorretamente}

\end{itemize}


\section{Medição}
\label{docs/user_manual/introduction/general_tools:measuring}\label{docs/user_manual/introduction/general_tools:sec-measure}
\index{measure}
Medindo obras nos sistemas de coordenadas projetadas (por exemplo, UTM) e dados não projetados. Se o mapa carregado é definido com um sistema de coordenadas geográficas (latitude / longitude), os resultados da linha ou a medição da área será incorreta. Para corrigir isso, você precisa definir um sistema de coordenadas adequado ao mapa (ver secção: ref: \emph{label\_projections}). Todos os módulos de medição também usam as configurações de encaixe do módulo de digitalização. Isso é útil se você quiser medir ao longo de linhas ou áreas em camadas vetoriais.

Para selecionar uma ferramenta clique medida em \includegraphics[width=1.5em]{mActionMeasure.png} e selecione a ferramenta que deseja usar.


\subsection{Medição de linha, áreas ou ângulos}
\label{docs/user_manual/introduction/general_tools:measure-length-areas-and-angles}
\index{measure!line length}
\index{measure!areas}
\index{measure!angles}
\includegraphics[width=1.5em]{mActionMeasure.png} QGIS is able to measure real distances between given points
according to a defined ellipsoid. To configure this, choose menu option
\emph{Settings \(\rightarrow\) Options}, click on the \emph{Map tools} tab and
choose the appropriate ellipsoid. There you can also define a rubberband color
and your preferred measurement units (meters or feet) and angle units (degrees,
radians and gon). The tools then allows you to click points on the map. Each
segment-length as well as the total shows up in the measure-window. To stop
measuring click your right mouse button.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-measure-length}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{measure_line.png}
\caption{Measure Distance \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}

\includegraphics[width=1.5em]{mActionMeasureArea.png} Areas can also be measured.  In the measure window the
accumulated area size appears. In addition, the measuring tool will snap to the
currently selected layer, provided that layer has its snapping tolerance set.
(See Section {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:snapping-tolerance]{\emph{Definir o valor de  tolerância de proximidade para buscar apartir do raio}}}).  So if you want to measure exactly along
a line feature, or around a polygon feature, first set its snapping tolerance,
then select the layer. Now, when using the measuring tools, each mouse click
(within the tolerance setting) will snap to that layer.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-measure-area}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{measure_area.png}
\caption{Measure Area \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}

\includegraphics[width=1.5em]{mActionMeasureAngle.png} Você também pode medir ângulos, selecionando a ferramenta Medida de Ângulo. O cursor se transforma em forma de cruz. Clique para desenhar o primeiro segmento do ângulo que você deseja medir, em seguida, mover o cursor para desenhar o ângulo desejado. A medida é exibido em uma caixa de diálogo pop-up.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-measure-angle}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{measure_angle.png}
\caption{Measure Angle \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}


\subsection{Selecionar e desselecionar feições}
\label{docs/user_manual/introduction/general_tools:select-and-deselect-features}\label{docs/user_manual/introduction/general_tools:sec-selection}
A barra de ferramentas do QGIS fornece várias ferramentas para selecionar as feições na tela do mapa. Para selecionar uma ou mais feições basta clicar sobre \textbar{} mActionSelect\textbar{} e selecionar a ferramenta:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionSelect.png} $^{\text{Select single feature}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectRectangle.png} $^{\text{Feições através de retangulo}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectPolygon.png} $^{\text{Feições através de poligono}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectFreehand.png} $^{\text{Feições através de traço livre}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectRadius.png} $^{\text{Feição através de raio}}$

\end{itemize}

To deselect all selected features click on \includegraphics[width=1.5em]{mActionDeselectAll.png} $^{\text{Deselect
features from all layers}}$.


\section{Decorações}
\label{docs/user_manual/introduction/general_tools:id2}\label{docs/user_manual/introduction/general_tools:decorations}
As Decorações do QGIS incluem o Rótulo Copyright (direitos autorais), a Seta Norte e a Barra de Escala. Elas são usadas para `decorar' o mapa adicionando os elementos cartográficos.

\begin{notice}{note}{Nota:}
Antes da versão 1.8 do QGIS a mesma funcionalidade era fornecida pelo Complemento Decoração.
\end{notice}


\subsection{Rótulo Copyright}
\label{docs/user_manual/introduction/general_tools:copyright-label}
\includegraphics[width=1.5em]{copyright_label.png} \emph{Copyright label} adds a Copyright label
using the text you prefer to the map.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-decorations-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{copyright.png}
\caption{The copyright Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{enumerate}
\item {} 
Selecione a partir do menu \emph{Exibir \(\rightarrow\) Decorações \(\rightarrow\) Rótulo de Copyright}. Abrirá a caixa de diálogo semelhante (ver {\hyperref[docs/user_manual/introduction/general_tools:figure-decorations-1]{figure\_decorations\_1}}).

\item {} 
Digite o texto que você deseja colocar no mapa. Pode usar HTML como mostrado no exemplo

\item {} 
Escolha a posição da etiqueta da: guilabel: \emph{Colocação} `direito inferior' caixa suspensa

\item {} 
Verifique se a \includegraphics{checkbox.png}: guilabel: caixa de seleção {\color{red}\bfseries{}{}`}Ativar Etiqueta Copyright{}`está marcada

\item {} 
Clique \textbf{{[}OK{]}}

\end{enumerate}

In the example above (default) QGIS places a copyright symbol followed by the
date in the lower right hand corner of the map canvas.


\subsection{Seta Norte}
\label{docs/user_manual/introduction/general_tools:north-arrow}
\includegraphics[width=1.5em]{north_arrow.png} \emph{North Arrow} places a simple north arrow on the
map canvas. At present there is only one style available. You can adjust the
angle of the arrow or let QGIS set the direction automatically. If you choose
to let QGIS determine the direction, it makes its best guess as to how the
arrow should be oriented. For placement of the arrow you have four options,
corresponding to the four corners of the map canvas.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-decorations-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{north_arrow_dialog.png}
\caption{The North Arrow Dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Barra de Escala}
\label{docs/user_manual/introduction/general_tools:scale-bar}
\includegraphics[width=2.5em]{scale_bar.png} \emph{Scale Bar} adds a simple scale bar to the map
canvas. You control the style and placement, as well as the labeling of the bar.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-decorations-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{scale_bar_dialog.png}
\caption{The Scale Bar Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

QGIS suporta apenas exibir a escala nas mesmas unidades de seu mapa do quadro. Então, se as unidades de suas camadas estão em metros, você não pode criar uma barra de escala em pés. Da mesma forma, se você estiver usando graus decimais, você não pode criar uma barra de escala para mostrar a distância em metros.

Para adicionar uma barra de escala:
\begin{enumerate}
\item {} 
Selecione através do menu: menuselection:\emph{Exibir --\textgreater{} Decorações --\textgreater{} Barra de Escala} abrirá o diálogo (ver {\hyperref[docs/user_manual/introduction/general_tools:figure-decorations-3]{figure\_decorations\_3}})

\item {} 
Escolha a posição do: guilabel: \emph{Posição} lista suspensa `Inferior Esquerda'

\item {} 
Escolha o estilo através do: guilabel:\emph{estilo de barra de escala} lista `Marque abaixo'

\item {} 
Selecione a cor para a barra: guilabel:\emph{Cor da barra}`preta' ou use a cor preta padrão

\item {} 
Defina o tamanho da barra e seu rótulo: guilabel: \emph{Tamanho da bar}`30 graus'

\item {} 
Verifique se a \includegraphics{checkbox.png}: guilabel: caixa de seleção `Ativar barra de escala{}` está marcada

\item {} 
Opcionalmente escolha para ajustar automaticamente a um número redondo quando a tela é redimensionada \includegraphics{checkbox.png}: guilabel: \emph{se encaixam automaticamente para arredondar o número em redimensionar}

\item {} 
Clique \textbf{{[}OK{]}}

\end{enumerate}

\begin{notice}{tip}{Dica:}
\textbf{Settings of Decorations}

Quando você salva um projeto .qgs, todas as alterações que tenham sido feitas para Seta Norte, barra de escala e Rótulo de Copyright serão salvas no projeto e restauradas na próxima vez que você carregar o projeto.
\end{notice}
\phantomsection\label{docs/user_manual/introduction/general_tools:sec-annotations}
\index{annotation}

\section{Ferramentas de anotação}
\label{docs/user_manual/introduction/general_tools:annotation-tools}\label{docs/user_manual/introduction/general_tools:index-12}
The \includegraphics[width=1.5em]{mActionTextAnnotation.png} \emph{Text Annotation} tools in the attribute toolbar
provides the possibility to place formatted text in a balloon on the QGIS map
canvas. Use the \emph{Text Annotation} tool and click into the map canvas.
\phantomsection\label{docs/user_manual/introduction/general_tools:annotation}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{annotation.png}
\caption{Annotation text dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Double click on the item opens a dialog with various options. There is the
text editor to enter the formatted text and other item settings. E.g. there
is the choice of having the item placed on a map position (displayed by
a marker symbol) or to have the item on a screen position (not related
to the map). The item can be moved by map position (drag the map marker)
or by moving only the balloon. The icons are part of GIS theme, and are used
by default in the other themes too.

The \includegraphics[width=1.5em]{mActionAnnotation.png} \emph{Move Annotation} tool allows to move the annotation on the
map canvas.


\subsection{Anotação de formulário}
\label{docs/user_manual/introduction/general_tools:form-annotations}
Additionally you can also create your own annotation forms. The
\includegraphics[width=1.5em]{mActionFormAnnotation.png} \emph{Form Annotation} tool is useful to display attributes of
a vector layer in a customized qt designer form (see {\hyperref[docs/user_manual/introduction/general_tools:figure-custom-annotation]{figure\_custom\_annotation}}). It is similar to the
designer forms for the
\emph{Identify features} tool, but displayed in an annotation item.
Also see QGIS blog \href{http://blog.qgis.org/node/143}{http://blog.qgis.org/node/143} for more information.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-custom-annotation}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{custom_annotation.png}
\caption{Customized qt designer annotation form \includegraphics[width=1em]{nix.png}}\end{figure}

\begin{notice}{note}{Nota:}
If you press \code{Ctrl+T} while an \emph{Annotation} tool is active
(move annotation, text annotation, form annotation), the visibility states
of the items are inverted.
\end{notice}


\section{Favoritos Espaciais}
\label{docs/user_manual/introduction/general_tools:spatial-bookmarks}\label{docs/user_manual/introduction/general_tools:sec-bookmarks}
\index{bookmarks}
\index{spatial bookmarks!see bookmarks}
Favoritos espaciais permite que você ``marque'' uma localização geográfica e volte a ela mais tarde.


\subsection{Novo Favorito}
\label{docs/user_manual/introduction/general_tools:creating-a-bookmark}
Para criar um novo favorito:
\begin{enumerate}
\item {} 
Zoom ou pan na área de interesse.

\item {} 
Select the menu option \emph{View \(\rightarrow\) New Bookmark} or press \code{Ctrl-B}.

\item {} 
Adicione um nome descritivo para o favorito (no máximo 255 caracteres).

\item {} 
Press \code{Enter} to add the bookmark or \textbf{{[}Delete{]}} to remove the bookmark.

\end{enumerate}

Note que você pode ter vários favoritos com o mesmo nome.


\subsection{Trabalhando com favoritos}
\label{docs/user_manual/introduction/general_tools:working-with-bookmarks}
To use or manage bookmarks, select the menu option
\emph{View \(\rightarrow\) Show Bookmarks}. The
\emph{Geospatial Bookmarks} dialog allows you to zoom to or delete a
bookmark. You can not edit the bookmark name or coordinates.


\subsection{Aproximar para um favorito}
\label{docs/user_manual/introduction/general_tools:zooming-to-a-bookmark}
From the \emph{Geospatial Bookmarks} dialog, select the desired
bookmark by clicking on it, then click \textbf{{[}Zoom To{]}}.
You can also zoom to a bookmark by double-clicking on it.


\subsection{Deletando um favorito}
\label{docs/user_manual/introduction/general_tools:deleting-a-bookmark}
Para excluir um favorito da: guilabel: diálogo \emph{Favoritos Geoespaciais}, clique sobre ele e depois em \textbf{{[}Excluir{]}}. Confirme sua escolha clicando \textbf{{[}OK{]}} ou cancelar a exclusão clicando \textbf{{[}Cancelar{]}}.


\section{Projetos animados}
\label{docs/user_manual/introduction/general_tools:nesting-projects}\label{docs/user_manual/introduction/general_tools:id3}
\index{nesting projects}
If you want to embed content from other project files into your project you can choose
\emph{Layer \(\rightarrow\) Embed Layers and Groups}.


\subsection{Incorporando camadas}
\label{docs/user_manual/introduction/general_tools:embedding-layers}
A seguinte aba permite incorporar camadas de outros projetos:
\begin{enumerate}
\item {} 
Pressione \includegraphics{browsebutton.png} para olhar para outro projeto do conjunto de dados Alasca.

\item {} 
Selecione o arquivo de projeto grassland. Você pode ver o conteúdo do projeto (ver {\hyperref[docs/user_manual/introduction/general_tools:figure-embed-dialog]{figure\_embed\_dialog}}).

\item {} 
Press \code{Ctrl} and klick on the layers grassland and regions.
The layers are embedded in the map legend and the map view now.

\end{enumerate}
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-embed-dialog}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{embed_dialog.png}
\caption{Select layers and groups to embed \includegraphics[width=1em]{nix.png}}\end{figure}

Enquanto as camadas incorporadas estão editáveis ​​que você não pode alterar suas propriedades como estilo e rotulagem.

\textbf{Removing embedded layers}

Right-click on the embedded layer and choose \includegraphics[width=1.5em]{mActionRemoveLayer.png} \emph{Remove} .


\chapter{Configurações do QGIS}
\label{docs/user_manual/introduction/qgis_configuration:qgis-configuration}\label{docs/user_manual/introduction/qgis_configuration::doc}
QGIS is highly configurable through the \emph{Settings} menu.
Choose between Panels, Toolbars, Project properties, Options and Customization.


\section{Painéis e Barra de Ferramentas}
\label{docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars}\label{docs/user_manual/introduction/qgis_configuration:panels-and-toolbars}
In the \emph{Panels\(\rightarrow\)} menu you can switch on and off QGIS widgets.
The \emph{Toolbars\(\rightarrow\)} menu provides the possibility to switch on
and off icon groups in the QGIS toolbar (see {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-panels-toolbars]{figure\_panels\_toolbars}}).
\phantomsection\label{docs/user_manual/introduction/qgis_configuration:figure-panels-toolbars}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{panels_and_toolbars.png}
\caption{The Panels and Toolbars menu \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Map overview}
\begin{notice}{tip}{Dica:}
\textbf{Activating the QGIS Overview}

No QGIS você pode usar uma janela de visualização geral que proporciona uma visualização completa das camadas adiconadas ao projeto. Esta pode ser selecionada na barra de menu :menuselection: \emph{Configurações - \textgreater{} Painéis}. Nesta janela de visualização há um retanguloindicando a extenção atual do mapa em sua janela principal. A janela de visualização geral permite que vocês identifique e determine que área do mapa está sendo visualizada no momento. Note que os rótulos não são são apresentados na janela de visualização geral, mesmo que as camadas do mapa tenham sido habilitadas para visualização de seus rótulos. Se você clicar a arrastar o retângulo vermelho da janela de visualização geral que mostra a extenção visualizada do mapa principal, este último será atualizado de acordo com a extensão especificada.
\end{notice}

\begin{notice}{tip}{Dica:}
\textbf{Show Log Messages}

Since QGIS 1.8 it's possible to track the QGIS messages. You can activate
\includegraphics{checkbox.png}\emph{Log Messages} in the menu
\emph{Settings \(\rightarrow\) Panels} and follow the messages
in the \emph{General} and \emph{Plugin} tab during loading and operation.
\end{notice}


\section{Propriedades do Projeto}
\label{docs/user_manual/introduction/qgis_configuration:project-properties}
Na janela de propriedades do projeto em \includegraphics[width=1em]{nix.png} \emph{Configurações - \textgreater{} Propriedades do Projeto} ou \includegraphics[width=1em]{win.png} :menuselection: cCnfigurações - \textgreater{} Propriedades do Projeto{}` configura-se suas opções. Isto inclui:
\begin{itemize}
\item {} 
Na aba \emph{General} o título do projeto, defina a cor de fundo e de seleção, unidades das camadas, precisão, e a opção de salvar caminho relativo das camadas podem ser definidas. Vocês pode definir a unidades da cmada (somente quando a tranformação do CRS está desabilitada) e a precisão de casas decimais a ser considerada.

\item {} 
A aba \emph{CRS Sistema de Referênciade Coordenadas} possibilita escolher o CRS para o projeto, e habilitar ``on the fly re-projetion'' de camadas matriciais e vetoriais quando utiliza-se camadas de CSR diferrente.

\item {} 
Na terceira aba :guilabel:Ìdentificadir de camadas{}` pode-se deefinir (ou desabilitar) as camadas que reponderão à ferramenta de identificação. (ver parágrafo de Ferramentas de mapa daa sessão :ref: \emph{opções de interface gráfica} para habilitar a identificação de múltiplas camadas.)

\item {} 
A aba \emph{OWS Server{}`permite definir informações sobre os recursos do QGIS mapserver, a extensão e o CRS, bem como os recursos WFS. Ativando o \textbar{}checkbox\textbar{} :{}`guilabel:{}`Adicionar geometria WKT à resposta de informação da feição} será possível consultar as camadas WMS.

\end{itemize}


\section{Opções}
\label{docs/user_manual/introduction/qgis_configuration:options}\label{docs/user_manual/introduction/qgis_configuration:gui-options}
\includegraphics[width=1em]{mActionOptions.png} Algumas opções basicas do QGIS podem ser selecionadas usando a caixa de diálogos {\color{red}\bfseries{}:gulabel:{}`Opções{}`}. Selecione a opção :menuselection:'Configurações . \textgreater{}'\includegraphics[width=1em]{mActionOptions.png} :menuselection: \emph{Opções}. As abas onde você pode otizimar suas configurações são:


\subsection{Aba Geral}
\label{docs/user_manual/introduction/qgis_configuration:general-tab}\begin{itemize}
\item {} 
{\color{red}\bfseries{}\textbar{}chackbox\textbar{}}\emph{Apto a salvar projeto quando requerido}

\item {} 
{\color{red}\bfseries{}\textbar{}chackbox\textbar{}}\emph{Avisar quando abrir um projeto salvo com uma versão antiga do QGIS}

\item {} 
Change Selection and Background color

\item {} 
Salvar o estilo do QGIS

\item {} 
Change the icon theme (choose between `default', `classic' and `gis')

\item {} 
Definir o tamanho dos ícones entre 16, 24 e 32 pixel.

\item {} 
Alterar o tamanho do menu

\item {} 
Definir o clique duplo para ação na legenda (escolher entre {\color{red}\bfseries{}{}`}abrir propriedade de camada' e `abrir tabela de atributos')

\item {} 
\includegraphics{checkbox.png}\emph{Tornar maiúsculo os nomes de camadas na leganda}

\item {} 
\includegraphics{checkbox.png}\emph{Mostrar nomes de atributos de classificação na legenda}

\item {} 
\includegraphics{checkbox.png}\emph{Criar ícones raster na legenda}

\item {} 
\includegraphics{checkbox.png}:guilabel:Ǹão exibir tela inicial (splash screen)

\item {} 
\includegraphics{checkbox.png}:guilabel:{\color{red}\bfseries{}{}`}Mostrar dicas ao iniciar'

\item {} 
\includegraphics{checkbox.png}\emph{Abrir resultados identificados numa pequena janela (necessário reiniciar QGIS)}

\item {} 
\includegraphics{checkbox.png}\emph{Abrir opções de ajuste em uma janela flutuante (necessário reiniciar QGIS)}

\item {} 
\includegraphics{checkbox.png}:guilabel:{\color{red}\bfseries{}{}`}Abrir tabela de atributos em uma janela flutuante{}`(necessários reiniciar QGIS)

\item {} 
\includegraphics{checkbox.png}\emph{Adicionar uma camada PostGIS com um duplo clique e seleciona no modo estendido}

\item {} 
\includegraphics{checkbox.png}\emph{Adiciona novas camadas ao grupo selecionado}

\item {} 
\includegraphics{checkbox.png}\emph{Copiar geometria em WKT a partir da tabela de atributos}

\item {} 
\includegraphics{checkbox.png}\emph{Comportamento da tabela de atributos} (escolher entre `Mostrar todas feições' (padrão), `Mostrar feições selecionadas' ou `Mostrar feições na tela atual')

\item {} 
\includegraphics{checkbox.png}\emph{Cache da linha da tabela de atributos}

\item {} 
\includegraphics{checkbox.png}\emph{Represeentação para valores nulos}

\item {} 
\emph{Prompt for raster sublayers} \includegraphics{selectstring.png}. Some rasters support
sublayers - they are called subdatasets in GDAL. An example is netcdf files -
if there are many netcdf variables, GDAL sees every variable as a subdataset.
The option is to control how to deal with sublayers when a file with sublayers
is opened. You have the following choices:
\begin{itemize}
\item {} 
`Always': always ask (if there are existing sublayers)

\item {} 
`If needed': ask if layer has no bands, but has sublayers

\item {} 
`Never': never prompt, will not load anything

\item {} 
`Load all': never prompt, but load all sublayers

\end{itemize}

\item {} 
\emph{Scan for valid items in the browser dock}  \includegraphics{selectstring.png}. The `Check
extension' option was designed to speed up the loading of a directory, which
can be time-consuming when `Check file contents' is activated and
there are many files (tens or hundreds).

\item {} 
\emph{Scan for contents of compressed files (.zip) in browser dock} \includegraphics{selectstring.png}
This option was also designed to speed up the loading of a directory. You have
the following choices:
\begin{itemize}
\item {} 
`Basic Scan': checks that the extension is supported by one of the drivers

\item {} 
`Full Scan': opens every file to check it is valid

\item {} 
`Passthru': don't use this option it will be removed in the next QGIS version

\end{itemize}

\end{itemize}


\subsection{Aba GDAL}
\label{docs/user_manual/introduction/qgis_configuration:gdal-tab}
GDAL é uma biblioteca para dados matriciais. Nesta aba pode-se definir qual driver do GDAL será utilizado para formatos matriciais. Em alguns casos mais de um driver fica disponível.


\subsection{Aba Plugins}
\label{docs/user_manual/introduction/qgis_configuration:plugins-tab}\begin{itemize}
\item {} 
Adicionar :guilabel: `Direções para procurar complementos adicionais C++'.

\end{itemize}


\subsection{Aba Renderização}
\label{docs/user_manual/introduction/qgis_configuration:rendering-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png} :guilabel: {\color{red}\bfseries{}{}`}Por padrão novas camadas adicionadas ao mapa podem ser mostradas'

\item {} 
Definir \emph{Número de feições para desenhar antes de atualizar a visualização}.

\item {} 
\includegraphics{checkbox.png} \emph{Use armazenamento de desenho onde possível para deixar a renderização masi rápida}

\item {} 
\includegraphics{checkbox.png}\emph{Fazer linhas aparecerem com menos definição para não perder performance ao renderizar}

\item {} 
\includegraphics{checkbox.png}\emph{Ajustar problemas com polígonos preenchidos incorretamente}

\item {} 
\includegraphics{checkbox.png} :guilabel:{\color{red}\bfseries{}{}`}Use nova geração de símbolos para renderização'

\item {} 
Definir as configurações pdrão para visualização de rasters: \emph{Seleção de banda RGB', \textbar{}checkbox\textbar{} :guilabel:}`Use desvio padrão{}` e \emph{Melhorar contraste}

\item {} 
Adicionar/Remover \emph{Caminhos para encontrar arquivos SVG}

\end{itemize}

Além disso você pode definir quando salvar o caminho para diretório com SVG como absoluto na aba \emph{Geral} no menu \emph{Configurações - \textgreater{} Propriedades do Projeto}.


\subsection{Aba Ferramentas de mapa}
\label{docs/user_manual/introduction/qgis_configuration:map-tools-tab}\begin{itemize}
\item {} 
A configuração do :guilabel: \emph{Modo} determina qual camada será visualizada na ferramenta de identificação. Trocando para `De cima para baixo' ou `De cima para baixo, parando no primeiro' ao invés de `Camada atual' os atributos para todas as camadas identificáveis (ver seção Propriedade do projeto :ref:'sec\_projects' para configurar qual camada será identificável) serão mostradas com a ferramenta de identificação.

\item {} 
\includegraphics{checkbox.png}\emph{Abrir formulário de feição, se uma feição simples for identificada}

\item {} 
Define :guilabel: \emph{Estabelecer um raio para identificar feições e mostrar no mapa}

\item {} 
Definir :guilabel: \emph{Elipsoide para cálculo de distância}

\item {} 
Definir :guilabel: \emph{Cor da linha de medida}

\item {} 
Definir :guilabel: \emph{Casas decimais}

\item {} 
\includegraphics{checkbox.png} \emph{Mandter unidade base}

\item {} 
\includegraphics{radiobuttonon.png} :guilabel:{\color{red}\bfseries{}{}`}Definir unidade de medida desejada (`Metros' ou `Pés')

\item {} 
\includegraphics{radiobuttonon.png} :guilabel:{\color{red}\bfseries{}{}`}Definir unidade de ângulo desejada (`Graus', `Radianos' ou'Gon')

\item {} 
Define \emph{Mouse wheel action} \includegraphics{selectstring.png} (`Zoom', `Zoom and recenter',
`Zoom to mouse cursor', `Nothing')

\item {} 
Definir :guilabel: \emph{Fator de aproximação/afastamento} para ação da roda do mouse

\end{itemize}


\subsection{Aba Sobreposições}
\label{docs/user_manual/introduction/qgis_configuration:overlays-tab}\begin{itemize}
\item {} 
Define \emph{Placement algorithm} \includegraphics{selectstring.png} for labels, symboly and
diagrams (choose between `Central point' (standard), `Chain', `Popmusic tabu
chain', `Popmusic tabu' and `Popmusic chain')

\end{itemize}


\subsection{Aba Digitalizar}
\label{docs/user_manual/introduction/qgis_configuration:digitizing-tab}\begin{itemize}
\item {} 
Definir Linha ao digitalizar \emph{Cor da linha} e \emph{espessura da linha}

\item {} 
Define \emph{Default snap mode} \includegraphics{selectstring.png} (`To vertex', `To segment',
`To vertex and segment')

\item {} 
Definir \emph{Tolerância de atração padrão} em unidades do mapa ou em pixels

\item {} 
Definir Raio de busca para editar vértice em `unidades do mapa' ou em `pixels'

\item {} 
\includegraphics{checkbox.png}\emph{Mostrar marcadores apenas para feições selecionadas}

\item {} 
Define vertex \emph{Marker style} \includegraphics{selectstring.png} (`Cross' (default), `Semi
transparent circle' or `None') and vertex \emph{Marker size}.

\item {} 
\includegraphics{checkbox.png} \emph{Suprimir atributos de janelas pop-up depois de cada feição criada}

\item {} 
\includegraphics{checkbox.png}\emph{Reutilizar útimo valor de atributo inscrito}

\item {} 
\emph{Validar geometrias} Editando linhas/polígonos complexos com muitos nós pode resultar em renderização demorada. Isto se deve ao fato de o padrão de validação no QGIS pode demandar muito tempo. Para acelerar a renderização é possível selecionar geometria de validação GEOS (iniciada no GEO 3.3) ou desligando a validação da geometria. A validação de geometria GEOS é muito mais rápida, mas a desvantagem é que apenas o primeiro problema de geometria será relatado.

\end{itemize}

As próximas 3 opções se referem a ferramenta {\color{red}\bfseries{}\textbar{}mActionOffserCurve\textbar{}} $^{\text{curva de deslocamento}}$ na \emph{Seção de edição avançada}. Através de várias configurações, é possível influenciar o formato da linha de deslocamento. Tais opções estão disponíveis a partir do GEOS 3.3 .
\begin{itemize}
\item {} 
\emph{Join style for curve offset}

\item {} 
\emph{Segmentos de quadrantes para a curva de deslocamento}

\item {} 
\emph{Limite `milter' para o deslocamento da curva}

\end{itemize}


\subsection{Aba CSR}
\label{docs/user_manual/introduction/qgis_configuration:crs-tab}
A aba CSR é dividida em duas. A primeira Permite definir o CSR padrão para novos projetos.
\begin{itemize}
\item {} 
Defina o SCR e :guilabel:{\color{red}\bfseries{}{}`}Sempre iniciar novos projetos com este SCR.

\item {} 
{\color{red}\bfseries{}\textbar{}chackbox\textbar{}}\emph{Habilitar reprojeção `on the fly' como padrão}

\end{itemize}

A segunda área permite definir o padão para quando uma nova camada é criada, ou quando uma camada sem SCR é carregada.
\begin{itemize}
\item {} 
\includegraphics{radiobuttonoff.png} \emph{Prompt para Sistema Referencial Cartográfico (SRC)}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Usar o SCR do projeto}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Usar SRC padrão mostrado abaixo}

\end{itemize}


\subsection{Aba Região}
\label{docs/user_manual/introduction/qgis_configuration:locale-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png}\emph{Sobrepor idioma do sistema} e \emph{Escolha o idioma a ser usado}

\item {} 
Informação sobre região ativa

\end{itemize}


\subsection{Aba Rede}
\label{docs/user_manual/introduction/qgis_configuration:network-tab}\phantomsection\label{docs/user_manual/introduction/qgis_configuration:figure-network-tab}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{proxy-settings.png}
\caption{Proxy-settings in QGIS}\end{figure}
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Usar proxy para acessar a web} e define `Máquina', `Porta', `Usuário' e `Senha'.

\item {} 
Set the \emph{Proxy type} \includegraphics{selectstring.png} according to your needs.
\begin{itemize}
\item {} 
\emph{Default Proxy}: Proxy is determined based on the application
proxy set using

\item {} 
\emph{Socks5Proxy}: Generic proxy for any kind of connection.
Supports TCP, UDP, binding to a port (incoming connections) and authentication.

\item {} 
\emph{HttpProxy}: Implemented using the ``CONNECT'' command, supports
only outgoing TCP connections; supports authentication.

\item {} 
\emph{HttpCachingProxy}: Implemented using normal HTTP commands, it
is useful only in the context of HTTP requests

\item {} 
\emph{FtpCachingProxy}: Implemented using an FTP proxy, it is
useful only in the context of FTP requests

\end{itemize}

\item {} 
Define:menuselection:\emph{Configurações de Cache} (Pasta e Tamanho)

\item {} 
Definir \emph{Buscar endereço WMS}, o padrão é \code{http://geopole.org/wms/search?search=\textbackslash{}\%1\textbackslash{}\&type=rss}

\item {} 
Definir \emph{Tempo máximo para pedido de rede (ms)} - O padrão é 60000

\end{itemize}

A Exclusão e inclusão de alguns endereços (URLs) pode feito através da caixa de textp abaixo das configurações de proxy (ver {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-network-tab]{Figure\_Network\_tab}}) pressionando o butão \textbf{{[}Adicionar{]}}. Após clique duplo no campo URL criado, entre o endereço da conexão. O butão \textbf{{[}Remover{]}} remove a entrada selecionada.

Se você precisa de informações detalhadas sobre as diferentes configurações de proxy, consulte o manual do QT-library-documentation no endereço \href{http://doc.trolltech.com/4.5/qnetworkproxy.html\#ProxyType-enum}{http://doc.trolltech.com/4.5/qnetworkproxy.html\#ProxyType-enum}.

\begin{notice}{tip}{Dica:}
\textbf{Usando Proxies}

Usar proxies poder ser complicados, as vezes. É útil fazer `tentativa e erro' dos tipos de proxies e checar se há sucessos.
\end{notice}

Você pode modificar as opções de acordo com suas necessidades. Algumas mudanças podem necessitar reinicialização do QGIS para que seja efetivada.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Configurações são salvas em um arquivo de texto em:\$HOME?.config/QuantumGIS/qgis.conf

\item {} 
{\color{red}\bfseries{}\textbar{}}osx\textbar{}Você pode encontrar as configurações em: \$HOME/Library/Preferences/org.qgis.qgis.plist

\item {} 
{\color{red}\bfseries{}\textbar{}}win\textbar{}As configurações são armazenadas no registro sob:

\end{itemize}

\begin{Verbatim}[commandchars=\\\{\}]
\PYGZbs{}HKEY\PYGZbs{}CURRENT\_USER\PYGZbs{}Software\PYGZbs{}QuantumGIS\PYGZbs{}qgis
\end{Verbatim}


\section{Customização}
\label{docs/user_manual/introduction/qgis_configuration:sec-customization}\label{docs/user_manual/introduction/qgis_configuration:customization}
A ferramenta de custamização é um novo desenvolvimento no QGIS 1.8. Ela permitirá a (des)ativação de quase todos os elementos na interface gráfica do QGIS. Isto pode ser muito útil se você possui muitos complementos instalados qua você não usa e que sobrecarrega a tela.
\phantomsection\label{docs/user_manual/introduction/qgis_configuration:figure-customization}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{customization.png}
\caption{The Customization dialog \includegraphics[width=1em]{nix.png}}\end{figure}

QGIS Customization is divided into five groups. In \includegraphics{checkbox.png} \emph{Docks} you
find the dock windows. Dock windows are applications that can be started and used as
a floating, top-level window or embedded to the QGIS main window as a docked widget
(see also {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Painéis e Barra de Ferramentas}}}). In \includegraphics{checkbox.png} \emph{Menus} you
can hide entries in the Menu bar. In the \includegraphics{checkbox.png} \emph{Status Bar} features
like the coordinate information can be daectivated. In \includegraphics{checkbox.png} \emph{Toolbars}
you can (de)activate the toolbar icons of QGIS and in \includegraphics{checkbox.png} \emph{Widgets}
you can (de)activate dialogs as well as their buttons.

With \includegraphics[width=1.5em]{mActionSelect.png} \emph{Switch to catching widgets in main application}
you can click on elements in QGIS you want to be hidden and find the corresponding entry
in Customization (see {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-customization]{figure\_customization}}). You can also save your various different
setups for different use cases as well. Before your changes are applied, you need to
restart QGIS.


\chapter{Trabalhando com Projeções}
\label{docs/user_manual/working_with_projections/working_with_projections::doc}\label{docs/user_manual/working_with_projections/working_with_projections:label-projections}\label{docs/user_manual/working_with_projections/working_with_projections:working-with-projections}
\index{Projections}\index{CRS}\index{Coordinate\_Reference\_System}
O QGIS permite aos usuários definirem um SRC (Sistema de Referência de Coordenadas global ou ao nível de projeto para camadas sem um SRC pré-definido. Ele permite também que o usuário defina um sistema de referência de coordenadas personalizado e suporta ``on-the-fly'' (OTF) ás camadas de vetore e ``raster''. Todas estas características permitem ao usuário visualizar camadas com diferentes SRC e tê-los sobrepostos corretamente.


\section{Visão geral do Suporte de Projeções}
\label{docs/user_manual/working_with_projections/working_with_projections:label-projoverview}\label{docs/user_manual/working_with_projections/working_with_projections:overview-of-projection-support}
O QGIS tem suporte à aproximadamente 2.700 SRC conhecidos. Definições de cada um destes SRC são armazenadas em uma base de dados SQLite, que é instalada com o QGIS. Normalmente você não necessita manipular estas bases de dados diretamente. Na verdade, isso pode causar falhas no suporte à projeções. SRC personalizados são arquivados em uma base de dados do usuário. Veja a seção :ref:'sec\_custom\_projections' para informações sobre gerenciamento do seu sistema de referência de coordenadas.

\index{EPSG}\index{IGNF}\index{European\_Petroleom\_Search\_Group}
\index{Institut\_Geographique\_National\_de\_France}
Os SRC disponíveis no QGIS são baseados naqueles definidos pelo ``European Petroleum Search Group (EPSG) e o Institut Geographique National de France (IGNF) e são em grande parte abstraídas da tabela de referência espacial usada em GDAL. Identificadores EPSG estão presentes na base de dados e pode ser usados para especificar um SRC no QGIS.

Para usar uma projeção OTF, seus dados precisam conter informações sobre seu sistema de referência de coordenadas ou você precisará definir um global , para a camada ou para o projeto. Para camadas Post GIS o QGIS usa a referência identificada que foi especificada quando a camada foi criada. Para dados suportados por OGR, o QGIS baseia-se na presença de um formato reconhecido para especificar o SRC. No caso de arquivos ``shape'', significa um arquivo contendo a especificação ``Well Known Text'' (:index:'WKT') do SRC. Este arquivo de projeção tem o mesmo nome base do shapefile e uma extensção prj. Por exemplo, um shapefile nominado :file:'alaska.shp' deve ter um arquivo de projeção correspondente nominado :file:'alaska.prj'.

Sempre que você selecionar um novo SRC, as unidades utilizadas pela camada serão automaticamente modificadas na gia :guilabel:'Geral' \includegraphics[width=1em]{mActionOptions.png} da caixa de diálogo :guilabel:'Propriedades do Projeto' sob o menu :guilabel:'Editar' (Gnome, OSX) ou :guilabel:'Configurações' (KDE, Windows).

\index{default\_CRS}

\section{Especificando uma projeção}
\label{docs/user_manual/working_with_projections/working_with_projections:index-4}\label{docs/user_manual/working_with_projections/working_with_projections:specifying-a-projection}
O QGIS inicia cada novo projeto usando uma projeção global padrão. O SRC global padrão é EPSG:4326 - WGS (\code{proj=longlat +ellps=WGS84 +datum=WGS84 +no\_defs}) e vem pré-definido no QGIS. Este padrão pode ser alterado usando o botão \textbf{{[}Select...{]}} na primeira seção, usado para definir o Sistema de Coordenadas de Referência Padrão para usar quando inicia-se um novo projeto, como apresentado em {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-1]{figura\_projeção\_1}}. Esta ecolha será salva para ser usada nas seções subsequentes do QGIS.
\phantomsection\label{docs/user_manual/working_with_projections/working_with_projections:figure-projection-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{crsdialog.png}
\caption{CRS tab in the QGIS Options Dialog \includegraphics[width=1em]{osx.png}}\end{figure}

When you use layers that do not have a CRS, you need to define how
QGIS responds to these layers. This can be done globally or
project-wide in the \emph{CRS} tab under \emph{Edit \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png}
\emph{Options} (Gnome, OSX) or \emph{Settings \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png}
\emph{Options} (KDE, Windows).

The options shown in {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-1]{figure\_projection\_1}} are:
\begin{itemize}
\item {} 
\includegraphics{radiobuttonoff.png} \emph{Prompt for CRS}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Use project CRS}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Use default CRS displayed below}

\end{itemize}

Se você quer definir o sistema de referência de coordenadas para uma certa camada sem informação de SRC, você pode também fazê-lo na guia :guialabel:'Geral' da caixa de diálogo propriedades  de raster (veja:ref:'label\_generaltab') e vetor (veja:ref:'vectorgeneraltab'). se sua camada já possui um SRC definido, esta será mostrada como em :ref:'figura\_vetor\_propriedades\_1' .

\begin{notice}{tip}{Dica:}
SRC na Legenda de Mapas

Right-clicking on a layer in the Map Legend (Section {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Legenda do Mapa}}})
provides two CRS short cuts. \emph{Set layer CRS} takes you directly
to the Coordinate Reference System Selector dialog (see {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-2]{figure\_projection\_2}}).
\emph{Set project CRS from Layer} redefines the project CRS using
the layer's CRS
\end{notice}


\section{Define On The Fly (OTF) Reprojection}
\label{docs/user_manual/working_with_projections/working_with_projections:define-on-the-fly-otf-reprojection}
QGIS supports OTF reprojection for both raster and vector data. However, OTF is
not activated by default. To use OTF projection, you must activate the \includegraphics{checkbox.png}
\emph{Enable on the fly CRS transformation} checkbox in the \emph{CRS}
tab of the \includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Project Properties} dialog.

Há três maneiras de se fazer isso:
\begin{enumerate}
\item {} 
Selecione \includegraphics[width=1em]{mActionOptions.png} :menuselection: `Propriedades do projeto' em `Editar' (Gnome, OSX) ou :menuselection:'Configurações' (KDE, Windows) menu.

\item {} 
Clique no ícone \includegraphics{geographic.png} :sup:'Situação do SRC' no canto inferior direito da barra de situação.

\item {} 
Turn OTF on by default, by selecting the \emph{CRS} tab of the
\emph{Options} dialog and selecting \includegraphics{checkbox.png}
\emph{Enable `on the fly' reprojection by default}.

\end{enumerate}

If you have already loaded a layer, and want to enable OTF projection, the
best practice is to open the \emph{Coordinate Reference System}
tab of the \emph{Project Properties} dialog, select a CRS, and
activate the \includegraphics{checkbox.png} \emph{Enable on the fly CRS transformation} checkbox.
The \includegraphics{geographic.png} $^{\text{CRS status}}$ icon will no longer be greyed-out
and all layers will be OTF projected to the CRS shown next to the icon.

\index{Proj4}\index{Proj4\_text}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{projectionDialog.png}
\caption{Projection Dialog \includegraphics[width=1em]{win.png}}\label{docs/user_manual/working_with_projections/working_with_projections:figure-projection-2}\end{figure}

The \emph{Coordinate Reference System} tab of the
\emph{Project Properties} dialog contains five important components as
shown in {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-2]{Figure\_projection\_2}} and described below.
\begin{enumerate}
\item {} 
\textbf{Enable on the fly CRS transformation} -
this checkbox is used to enable or disable OTF projection. When off, each
layer is drawn using the coordinates as read from the data source and the
components described below are inactive.When on, the coordinates in each
layer are projected to the coordinate reference system defined for the map canvas.

\item {} 
\textbf{Coordinate Reference System} - this is a list of all CRS
supported by QGIS, including Geographic, Projected and Custom coordinate
reference systems. To define a CRS,  select it from the list by expanding
the appropriate node and selecting the CRS. The active CRS is preselected.

\item {} 
\textbf{Proj4text} - este é o string SRC usado pelo mecanismo de projeção Proj4. Este texto é somente leitura e fornecido apenas com propósito de informação.

\item {} 
\textbf{Filter} - if you know the EPSG code, the identifier or the name
for a Coordinate Reference System, you can use the search feature to find it.
Enter the EPSG code, the identifier or the name.

\item {} 
\textbf{SRCs recentemente usados} - se você tem SRCs que costuma usar em seus trabalhos de diários de SIG, estes serão mostrados na tabela abaixo do Diálogo de Projeções. Clique em um destes abaixo para selecionar o SRC associado.

\end{enumerate}

\begin{notice}{tip}{Dica:}
\textbf{Diálogo Propriedades do Projeto}

Se você abrir a caixa de diálogo :guilabel:'Propriedades do projeto' do menu :menusection:'Editar' (Gnome, OSX) ou :menuselection:'Configurações (KDE, Windows), você precisará clicar na guia :guilabel:'Sistema de Referência de Coordenadas' para ver as configurações de SRC.

Abrindo a caixa de diálogo pelo ícone \includegraphics{geographic.png} :guilabel:'Situação do SRC' vai apresentar automaticamente a guia :guilabel:'Sistema de Referência de Coordenadas' para a frente das demais.
\end{notice}


\section{Sistema de Referência de Coordenadas Personalizado}
\label{docs/user_manual/working_with_projections/working_with_projections:custom-coordinate-reference-system}\label{docs/user_manual/working_with_projections/working_with_projections:sec-custom-projections}
\index{Custom\_CRS}
Se o QGIS não fornece o sistema de coordenadas que você precisa, você pode definir um SRC personalizado.para definir um SRC, selecione \includegraphics[width=1.5em]{mIconNew.png}:guilabel:'SRC Personalizado' do menu :menuselection:'Editar' (Gnome, OSX) ou :menuselection:'Configurações (KDE, Windows). SRCs personalizados são armazenados na base de dados do usuário do QGIS. Além do seu SRC personalizado, este banco de dados também contém os marcadores espaciais e outros dados personalizados.
\phantomsection\label{docs/user_manual/working_with_projections/working_with_projections:figure-projection-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{customProjectionDialog.png}
\caption{Custom CRS Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Proj.4}
Defining a custom CRS in QGIS requires a good understanding of the Proj.4
projection library. To begin, refer to the 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
\href{ftp://ftp.remotesensing.org/proj/OF90-284.pdf}{ftp://ftp.remotesensing.org/proj/OF90-284.pdf} ).

Este manual descreve o uso da proj.4 e utilitários de linha de comando relacionados. Os parâmetros cartográficos usados proj.4 são descritos no manual do usuário, e são os mesmos utilizados pelo QGIS.

A caixa de diálogo :guilabel:'Definição de um Sistema de Referência de Coordenadas Personalizado' requer somente dois parâmetros para definir um SRC personalizado:
\begin{enumerate}
\item {} 
um nome descritivo e

\item {} 
o parâmetro cartográfico no formato PROJ.4.

\end{enumerate}

Para criar um novo SRC, clique no botão \includegraphics[width=1.5em]{mIconNew.png} :sup:'Novo' e entre com um nome descritivo e os parâmetros do SRC. Depois disso você pode salvar sei SRC clicando no botão \includegraphics[width=1.5em]{mActionFileSave.png} :sup:'Salvar'.

Observe que o item :guilabel:'Parâmetros' deve começar com um bloco \code{+proj=}, para representar o novo sistema de referência de coordenadas.

Você pode testar seus parâmetros SRC para ver se eles dão resultados razoáveis clicando no botão \textbf{{[}Calcular{]}} dentro do bloco :guilabel:'Teste' e colando seus parâmetros de SRC no campo :guilabel:'Parâmetros'. Depois entre com um valor conhecido de latitude e longitude em WGS 84 nos campos :guilabel:'Norte' e guilabel:'Leste' respectivamente. Clique em \textbf{{[}Calculate{]}} e compare os resultados com os valores conhecidos em seus sistema de referência de coordenadas.

\index{Browse\_Maps}
\index{Import\_Maps}

\chapter{Navegador QGIS}
\label{docs/user_manual/qgis_browser/qgis_browser:label-qgis-browser}\label{docs/user_manual/qgis_browser/qgis_browser::doc}\label{docs/user_manual/qgis_browser/qgis_browser:index-1}\label{docs/user_manual/qgis_browser/qgis_browser:qgis-browser}
The QGIS Browser is a new panel in QGIS that lets you easily navigate in your
database. You can have access to common vector files (e.g. ESRI shapefile or
MapInfo files), databases (e.g.PostGIS or MSSQL Spatial) and WMS/WFS connections.
You can also view your GRASS data (to get the data into QGIS see {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integração com SIG GRASS}}}).
\phantomsection\label{docs/user_manual/qgis_browser/qgis_browser:figure-browser-standalone-metadata}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=35em]{browser_standalone_metadata.png}
\caption{Qgis browser as a standalone application to view metadata, preview and attributes \includegraphics[width=1em]{nix.png}}\end{figure}

Use o navegador QGIS para visualizar seus dados. A função de arrastar e soltar facilita a inserção de dados no mapa e na legenda de mapa.
\begin{enumerate}
\item {} 
Ativar Navegador QGIS: Botão direito do mouse na barra de ferramentas e clique \textbar{} caixa {\color{red}\bfseries{}\textbar{}}: guilabel: \emph{browser}.

\item {} 
Arraste o painel para a janela de legenda.

\item {} 
Clique no: guilabel: guia Navegador \emph{Aba}.

\item {} 
Procure em sua base de dados e escolha a pasta de shapefile qgis\_sample\_data.

\item {} 
Pressione o: kbd: Tecla \emph{Shift} e clique em airports.shp e alaska.shp.

\item {} 
Pressione o botão esquerdo do mouse e arraste e solte os arquivos para a tela do mapa.

\item {} 
Clique com o botão direito do mouse em uma camada e escolha: guilabel: \emph{Definir CRS projeto da camada}. Para mais informações veja: ref: \emph{label\_projections}.

\item {} 
Click on \includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom Full} to make the layers
visible.

\end{enumerate}

Também é possível executar o Navegador QGIS como um aplicativo independente.

\textbf{Iniciar navegador qgis}
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Type in ``qbrowser'' at a command prompt.

\item {} 
\includegraphics[width=1em]{win.png} Inície o navegador QGIS usando o menu Iniciar ou atalho no desktop, ou clique duas vezes em um arquivo de projeto QGIS.

\item {} 
\includegraphics[width=1em]{osx.png} QGIS browser is not available yet from your your Applications folder.
However it can easily be made available. In Finder use
\emph{Go \(\rightarrow\) Go to map...} and use it to find the folder
\code{/Applications/QGIS.app/Contents/MacOS/bin}.
Use the key combination \code{option - command} and drag \textbf{qbrowser.app}
while holding down the left mouse button to the Applications folder.
This will create a link that you can use to start QGIS browser.

\end{itemize}

In {\hyperref[docs/user_manual/qgis_browser/qgis_browser:figure-browser-standalone-metadata]{figure\_browser\_standalone\_metadata}} you can see the enhanced functionality
of Qgis browser. The \emph{Param} tab provides the details of your
connection based datasets like PostGIS or MSSQL Spatial. The \emph{Metadata}
tab contains general information about the file (see {\hyperref[docs/user_manual/working_with_vector/vector_properties:vectormetadatatab]{\emph{Aba Metadado}}}).
With the \emph{Preview} tab you can have a look at your files without
importing them into your QGIS project. It's also possible to preview the
attributes of your files in the \emph{Attributes} tab.


\chapter{Trabalhando com dados vetoriais}
\label{docs/user_manual/working_with_vector/index:label-workingvector}\label{docs/user_manual/working_with_vector/index:working-with-vector-data}\label{docs/user_manual/working_with_vector/index::doc}

\section{Formatos de dados suportados}
\label{docs/user_manual/working_with_vector/supported_data:supported-data-formats}\label{docs/user_manual/working_with_vector/supported_data::doc}
QGIS uses the OGR library to read and write vector data formats (GRASS vector and
PostgreSQL support is supplied by native QGIS data provider plugins),including
ESRI Shapefiles, MapInfo and Microstation file formats; PostGIS, SpatiaLite,
Oracle Spatial databases and many more. The vector data can also be loaded in
read mode from zip and gzip archives into QGIS. At the date of this document, 69
vector formats are supported by the OGR library (see OGR-SOFTWARE-SUITE {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}}).
The complete list is available at \href{http://www.gdal.org/ogr/ogr\_formats.html}{http://www.gdal.org/ogr/ogr\_formats.html}.

\begin{notice}{note}{Nota:}
Not all of the listed formats may work in QGIS for various reasons.
For example, some require external commercial libraries or the GDAL/OGR
installation of your OS was not build to support the format you want to use.
Only those formats that have been well tested will appear in the list of
file types when loading a vector into QGIS. Other untested formats can be
loaded by selecting \code{*.*}.
\end{notice}

Procedimentos com dados vetoriais GRASS são descritos na Seção {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integração com SIG GRASS}}}.

This section describes how to work with several common formats: ESRI
Shapefiles, PostGIS layers and SpatiaLite layers. Many of the features
available in QGIS work the same, regardless of the vector data source.
This is by design and includes the identify, select, labeling and
attributes functions.

\index{ESRI}\index{Shapefile}\index{OGR}

\subsection{Shapefiles ESRI}
\label{docs/user_manual/working_with_vector/supported_data:esri-shapefiles}\label{docs/user_manual/working_with_vector/supported_data:index-0}\label{docs/user_manual/working_with_vector/supported_data:vector-shapefiles}
O formato de arquivo vetorial padrão usado pelo QGIS é o Shapefile ESRI. O suporte é fornecido pela \index{Livraria OGR Simple Feature}Livraria OGR Simple Feature ( \href{http://www.gdal.org/ogr/}{http://www.gdal.org/ogr/} ).

Um shapefile consiste na verdade de um conjunto de vários arquivos. Os três seguintes são necessários:
\begin{enumerate}
\item {} 
\code{.shp} arquivo que contém as formas vetoriais.

\item {} 
\code{.dbf} arquivo que contém os atributos no formato dBase..

\item {} 
\code{.shx} arquivos indicadores.

\end{enumerate}

Shapefiles também podem incluir um arquivo com a extensão \code{.prj} que contém as informações de projeção. Embora seja muito útil um arquivo de projeção, não é obrigatória. Um conjunto de dados shapefile pode conter arquivos adicionais. Para mais detalhes veja a especificação técnica ESRI em: \href{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}.


\subsubsection{Carregando um Shapefile}
\label{docs/user_manual/working_with_vector/supported_data:vector-load-shapefile}\label{docs/user_manual/working_with_vector/supported_data:loading-a-shapefile}
\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} Para \index{carregar um shapefile}carregar um shapefile, inicie o QGIS e clique no botão \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Adicionar camada vetorial}}$ da barra de ferramentas ou simplesmente digite \code{Ctrl+Shift+V}. Isso fará com que surja uma nova janela (see {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-1]{figure\_vector\_1}}).
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{addvectorlayerdialog.png}
\caption{Add Vector Layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

From the available options check \includegraphics{radiobuttonon.png} \emph{File}. Click on button
\textbf{{[}Browse{]}}. That will bring up a standard open file dialog (see {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-2]{figure\_vector\_2}})
which allows you to navigate the file system and load a shapefile or other
supported data source. The selection box \emph{Filter} \includegraphics{selectstring.png} allows
you to preselect some OGR supported file formats.

Você também pode selecionar o tipo de codificação para o shapefile, se desejar.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{shapefileopendialog.png}
\caption{Open an OGR Supported Vector Layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Ao selecinar um shapefile a partir da lista e clicando em \textbf{{[}Abrir{]}} o QGIS o carregará. A {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-3]{Figure\_vector\_3}} exibe o QGIS depois de carregar o arquivo \code{alaska.shp}.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{shapefileloaded.png}
\caption{QGIS with Shapefile of Alaska loaded \includegraphics[width=1em]{nix.png}}\end{figure}
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-layer-colors}
\begin{notice}{tip}{Dica:}
\textbf{Cores das camadas}

Quando você adiciona uma camada ao mapa, é atribuída uma cor aleatória. Na adição de mais de uma camada de uma vez, são atribuídas cores diferentes para cada camada.
\end{notice}

Uma vez carregado, você pode aplicar zoom em todo o shapefile usando as ferramentas de navegação do mapa. Para alterar o estilo de uma camada, abra a caixa de diálogo \emph{Propriedades da camada} clicando duas vezes no nome da camada ou clicando com o botão direito do mouse sobre o nome na legenda e escolha \emph{Propriedades} a partir do menu pop-up. Consulte a Seção {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Aba de Estilo}}} para mais informações sobre a definição da simbologia das camadas vetoriais.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-load-from-external-drive-osx}
\begin{notice}{tip}{Dica:}
\textbf{Carregando camadas e armazenando projetos em unidades externas no OS X}

No OS X, unidades portáteis que são armazenadas além do disco rígido principal não aparecem no  \emph{File \(\rightarrow\)Open Project {}`como esperado. Para resolver isso estamos trabalhando em uma forma mais nativa do OS X com caixa de diálogo abrir/salvar. Como alternativa, você pode digitar `/Volumes' no campo Nome do arquivo e pressione :kbd:{}`Voltar}. Depois, você pode navegar para unidades externas ou armazenadas em rede.
\end{notice}


\subsubsection{Melhorando o Desempenho do Shape}
\label{docs/user_manual/working_with_vector/supported_data:vector-improving-performance-shape}\label{docs/user_manual/working_with_vector/supported_data:improving-performance-shape}
Para melhorar o desempenho do desenho de um shapefile, você pode criar um índice espacial. Um índice espacial irá melhorar a velocidade do zoom e visão panorâmica. Os índices espaciais utilizados pelo QGIS estão na extensão \code{.qix}.

Siga estes passos para criar o índice:
\begin{itemize}
\item {} 
Carregue um shapefile.

\item {} 
Abra a caixa de diálogo \emph{Propriedades da camada} clicando duas vezes sobre o nome do shapefile na legenda ou com o botão direito do mouse e escolha \emph{Propriedades} a partir do menu pop-up.

\item {} 
Na guia :guilabel:'Geral', clique no botão \textbf{{[}Criar índice espacial{]}}.

\end{itemize}


\subsubsection{Problema ao carregar um arquivo shape .prj}
\label{docs/user_manual/working_with_vector/supported_data:vector-shape-problem-loading}\label{docs/user_manual/working_with_vector/supported_data:problem-loading-a-shape-prj-file}
Se você carregar um arquivo shapefile \code{.prj} no QGIS  e o sistema não é capaz de ler a referência de coordenadas a partir desse arquivo, você tem que definir a projeção adequada manualmente dentro guia :Guilabel:'Geral' da caixa de diálogo \emph{Propriedades da camada}. Isto é devido ao fato de que arquivos \code{.prj} muitas vezes não fornecem os parâmetros de projeção completos, conforme usado no QGIS e listados na guia \emph{CRS}.

Por essa razão, se você criar um novo shapefile no QGIS, dois arquivos de projeção diferentes são criados. Um arquivo \code{.prj} com os parâmetros limitados de projeção, compatível com o software ESRI, e um arquivo \code{.qpj}, fornecendo os parâmetros completos dos CRS ​​usados. Se o QGIS encontra um arquivo \code{.qpj}, ele será usado em vez do arquivo \code{prj}.

\index{MapInfo}

\subsection{Carregando uma camada MapInfo}
\label{docs/user_manual/working_with_vector/supported_data:loading-a-mapinfo-layer}\label{docs/user_manual/working_with_vector/supported_data:vector-loading-mapinfo}\label{docs/user_manual/working_with_vector/supported_data:index-3}
\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} To load a MapInfo layer, click on the \includegraphics[width=1.5em]{mActionAddNonDbLayer.png}
$^{\text{Add Vector Layer}}$ toolbar button or type \code{Ctrl+Shift+V}, change the
file type filter \emph{Filter} \includegraphics{selectstring.png}: to `Mapinfo File {[}OGR{]}' and
select the MapInfo layer you want to load.

\index{ArcInfo\_Binary\_Coverage}\index{Tiger\_Format}\index{UK\_National\_Transfer\_Format}
\index{US\_Census\_Bureau}

\subsection{Carregando uma camada ArcInfo Binary}
\label{docs/user_manual/working_with_vector/supported_data:loading-an-arcinfo-binary-coverage}\label{docs/user_manual/working_with_vector/supported_data:index-5}\label{docs/user_manual/working_with_vector/supported_data:vector-loading-arcinfo-coverage}
\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} To load an ArcInfo binary coverage, click on the \includegraphics[width=1.5em]{mActionAddNonDbLayer.png}
$^{\text{Add Vector Layer}}$ toolbar button or press \code{Ctrl+Shift+V} to open the
\emph{Add Vector Layer} dialog. Select \includegraphics{radiobuttonon.png} \emph{Directory}.
Change to \emph{Filter} \includegraphics{selectstring.png} to `Arc/Info Binary Coverage'.
Navigate to the directory that contains the coverage files and select it.

Da mesma forma, você pode carregar arquivos vetoriais baseados em um diretório no formato  UK National Transfer, bem como os formatos TIGER do Census Bureau US.

\index{PostGIS}\index{PostgreSQL}

\subsection{Camadas PostGIS}
\label{docs/user_manual/working_with_vector/supported_data:label-postgis}\label{docs/user_manual/working_with_vector/supported_data:postgis-layers}\label{docs/user_manual/working_with_vector/supported_data:index-6}
Camadas PostGIS são armazenados em um banco de dados PostgreSQL. As vantagens do PostGIS são a indexação espacial, filtragem e recursos de consulta. Usando o PostGIS, funções vetoriais, como selecionar e identificar permitem um trabalho com mais precisão do que com camadas OGR no QGIS.

\index{Connection\_Manager}

\subsubsection{Criando uma conexão armazenada}
\label{docs/user_manual/working_with_vector/supported_data:vector-create-stored-connection}\label{docs/user_manual/working_with_vector/supported_data:creating-a-stored-connection}\label{docs/user_manual/working_with_vector/supported_data:index-7}
\includegraphics[width=1.5em]{mActionAddLayer.png} The first time you use a PostGIS data source, you must create
a connection to the PostgreSQL database that contains the data. Begin by clicking
on the \includegraphics[width=1.5em]{mActionAddLayer.png} $^{\text{Add PostGIS Layer}}$ toolbar button, selecting the
\includegraphics[width=1.5em]{mActionAddLayer.png} \emph{Add PostGIS Layer...} option from the
\emph{Layer} menu or typing \code{Ctrl+Shift+D}. You can also open the
\emph{Add Vector Layer} dialog and select \includegraphics{radiobuttonon.png} \emph{Database}.
The \emph{Add PostGIS Table(s)} dialog will be displayed. To access the
connection manager, click on the \textbf{{[}New{]}} button to display the
\emph{Create a New PostGIS Connection} dialog. The parameters required for
a connection are:
\begin{itemize}
\item {} 
\textbf{Name}: A name for this connection. Can be the same as \emph{Database}

\item {} 
\textbf{Service}: Service parameter to be used alternatively to hostname/port (and
potentially database). This can be defined in \code{pg\_service.conf}

\item {} 
\textbf{Host}: Name of the database host. This must be a resolvable host name the
same as would be used to open a telnet connection or ping the host. If the
database is on the same computer as QGIS, simply enter \emph{`localhost'} here.

\item {} 
\textbf{Port}: Port number the PostgreSQL database server listens on. The default
port is 5432.

\item {} 
\textbf{Database}: Name of the database.

\item {} 
\textbf{SSL mode}: How the SSL connection will be negotiated with the server. Note
that massive speedups in PostGIS layer rendering can be achieved by disabling
SSL in the connection editor. Following options are available:
\begin{itemize}
\item {} 
desabilitar: apenas tentar uma conexão SSL não criptografada

\item {} 
permitir: tentar uma conexão não-SSL, se isso falhar, tente uma conexão SSL

\item {} 
preferir (por padrão): tentar uma conexão SSL, se isso falhar, tentar uma conexão não-SSL;

\item {} 
requer: só tentar uma conexão SSL.

\end{itemize}

\item {} 
\textbf{Username}: User name used to login to the database.

\item {} 
\textbf{Password}: Password used with \emph{Username} to connect to the database.

\end{itemize}

Opcionalmente você pode ativar as seguintes caixas de seleção:
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Salvar nome do usuário}

\item {} 
\includegraphics{checkbox.png} \emph{Salvar Senha}

\item {} 
\includegraphics{checkbox.png} \emph{Apenas olhar na tabela geometry\_columns}

\item {} 
\includegraphics{checkbox.png} :guilabel:{\color{red}\bfseries{}{}`}Apenas olhar no esquema `público'

\item {} 
\includegraphics{checkbox.png} \emph{Também listar tabelas sem geometrias}

\item {} 
\includegraphics{checkbox.png} \emph{Usar metadados atribuidos da tabela}

\end{itemize}

Uma vez que todos os parâmetros e as opções estão configuradas, você pode testar a conexão clicando no botão \textbf{{[}Testar Conexão{]}}.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-settings-security}
\begin{notice}{tip}{Dica:}
\textbf{QGIS Configurações do Usuário e Segurança}

Depending on your computing environment, storing passwords in your QGIS
settings may be a security risk. Your customized settings for QGIS are
stored based on the operating system:
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png}, as configurações são armazenadas no arquivo \code{.qgis/} em seu diretório home.

\item {} 
\includegraphics[width=1em]{win.png}, as configurações são armazenadas no registro.

\end{itemize}
\end{notice}


\subsubsection{Carregando uma camada PostGIS}
\label{docs/user_manual/working_with_vector/supported_data:loading-a-postgis-layer}\label{docs/user_manual/working_with_vector/supported_data:vector-loading-postgis}
\includegraphics[width=1.5em]{mActionAddLayer.png} Uma vez que você tem uma ou mais conexões definidas, você pode carregar as camadas do banco de dados PostgreSQL. Claro que isso exige ter dados no PostgreSQL. Consulte a Secção {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis]{\emph{Importação de dados no PostgreSQL}}} para entender sobre a importação de dados para o banco de dados.

Para colocar uma camada no PostGIS, execute os seguintes passos:
\begin{itemize}
\item {} 
If the \emph{Add PostGIS layers} dialog is not already open,
click on the \includegraphics[width=1.5em]{mActionAddLayer.png} $^{\text{Add PostGIS Layer}}$ toolbar button.

\item {} 
Escolha a conexão a partir da lista drop-down e clique em \textbf{{[}Conectar{]}}.

\item {} 
Marque ou desmarque \includegraphics{checkbox.png} \emph{Listar tabelas sem geometrias}

\item {} 
Optionally use some \includegraphics{checkbox.png} \emph{Search Options} to define
which features to load from the layer or use the \textbf{{[}Build query{]}} button
to start the \emph{Query builder} dialog.

\item {} 
Encontre a camada(s) que deseja adicionar na lista de camadas disponíveis.

\item {} 
Selecione-a clicando sobre ela. Você pode selecionar várias camadas pressionando a tecla \code{Shift} enquanto clica. Consulte a Seção {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Ferramenta de Consulta}}} para obter informações sobre como usar o Query Builder PostgreSQL para melhor definição da camada.

\item {} 
Clique no botão \textbf{{[}Add{]}} para adicionar a camada ao mapa.

\end{itemize}
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-postgis-layers}
\begin{notice}{tip}{Dica:}
\textbf{Camadas PostGIS}

Normalmente uma camada PostGIS é definida por um caminho na tabela. A partir da versão 0.9.0 em diante, o QGIS permite carregar camadas que não têm um caminho na tabela geometry\_columns. Isto inclui ambas as tabelas e exibições. A definição de uma visão espacial fornece um meio poderoso para visualizar seus dados. Consulte o manual do PostgreSQL para obter informações sobre a criação de pontos de vista diversos.
\end{notice}


\subsubsection{Alguns detalhes sobre as camadas PostgreSQL}
\label{docs/user_manual/working_with_vector/supported_data:sec-postgis-details}\label{docs/user_manual/working_with_vector/supported_data:some-details-about-postgresql-layers}
Esta seção contém alguns detalhes sobre como o QGIS acessa camadas do PostgreSQL. Na maioria das vezes o QGIS simplesmente deve fornecer-lhe uma lista de tabelas do banco de dados que podem ser carregadas, e carregá-las mediante solicitação. No entanto, se você tiver problemas para carregar uma tabela do PostgreSQL no QGIS, as informações abaixo podem ajudá-lo a entender as mensagens do QGIS e dar-lhe orientações para alterar a tabela de PostgreSQL ou ver definições para permitir o QGIS carregá-la.

O QGIS requer que as camadas PostgreSQL contenham uma coluna que pode ser usada como uma chave única para a camada. Para tabelas, isso geralmente significa que a tabela precisa de uma chave primária, ou uma coluna com uma restrição exclusiva sobre ela. No QGIS, esta coluna tem de ser do tipo int4 (um inteiro de 4 bytes). Alternativamente, a coluna ctid pode ser usada como chave primária. Se uma tabela não tem esses itens, a coluna oid será usado em seu lugar. O desempenho será melhorado se a coluna é indexada (note que as chaves primárias são automaticamente indexadas pelo PostgreSQL).

Se a camada PostgreSQL é um ponto de vista, a mesma exigência existe, mas as vistas não têm chaves primárias ou colunas com restrições exclusivas sobre ela. Neste caso o QGIS vai tentar encontrar uma coluna na vista que é derivada de uma coluna da tabela adequada. Ele faz isso ao analisar o ponto de vista de definição do SQL. No entanto, existem vários aspectos do SQL que o QGIS ignora, estes incluem o uso de apelidos da tabela e colunas que são gerados por funções SQL.

Se uma coluna adequada não for encontrada, o QGIS não irá carregar a camada. Se isto ocorrer, a solução é alterar o ponto de vista de forma que ele inclui uma coluna adequada (um tipo de int4 com uma chave primária ou com uma única restrição, de preferência, indexados).

\index{shp2pgsql}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:loading-postgis-data}

\subsection{Importação de dados no PostgreSQL}
\label{docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis}\label{docs/user_manual/working_with_vector/supported_data:loading-postgis-data}\label{docs/user_manual/working_with_vector/supported_data:index-8}\label{docs/user_manual/working_with_vector/supported_data:importing-data-into-postgresql}
Data can be imported into PostgreSQL/PostGIS using several tools, such as the SPIT
plugin, or the command line tools shp2pgsql or ogr2ogr.


\subsubsection{Complemento SPIT}
\label{docs/user_manual/working_with_vector/supported_data:spit-plugin}\label{docs/user_manual/working_with_vector/supported_data:id1}
QGIS comes with a core plugin named \includegraphics{spiticon.png} $^{\text{SPIT}}$ (Shapefile to
PostGIS Import Tool). SPIT can be used to load multiple shapefiles at
one time and includes support for schemas. See Section {\hyperref[docs/user_manual/plugins/plugins_spit:label-spit]{\emph{Complemento SPIT}}} for
more information.


\subsubsection{shp2pgsql}
\label{docs/user_manual/working_with_vector/supported_data:shp2pgsql}
PostGIS includes a utility called \textbf{shp2pgsql} that can be used to import
shapefiles into a PostGIS enabled database. For example, to import a
shapefile named \code{lakes.shp} into a PostgreSQL database named
\code{gis\_data}, use the following command:

\begin{Verbatim}[commandchars=\\\{\}]
shp2pgsql -s 2964 lakes.shp lakes\_new \textbar{} psql gis\_data
\end{Verbatim}

Isso cria uma nova camada chamada \code{lakes\_new} no banco de dados \code{gis\_data}. A nova camada terá um identificador de referência espacial (SRID) de 2964. Consulte a Seção {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Trabalhando com Projeções}}} para mais informações sobre os sistemas de referência espacial e projeções.

\index{pgsql2shp}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-export-from-postgis}
\begin{notice}{tip}{Dica:}
\textbf{Exportando conjuntos de dados do PostGIS}

Assim como a ferramenta de importação \textbf{shp2pgsql}, há também uma ferramenta para exportar conjuntos de dados PostGIS como shapefiles: \textbf{pgsql2shp}. Este é enviado dentro de sua distribuição PostGIS.
\end{notice}

\index{ogr2ogr}

\subsubsection{ogr2ogr}
\label{docs/user_manual/working_with_vector/supported_data:ogr2ogr}\label{docs/user_manual/working_with_vector/supported_data:index-10}
Junto ao \textbf{shp2pgsql} e ao \textbf{SPIT} existe uma outra ferramenta para a insersão de dados geográficos no PostGIS: \textbf{ogr2ogr}. Esta é parte da instalação do GDAL.

Para importar um shapefile no PostGIS, faça o seguinte :

\begin{Verbatim}[commandchars=\\\{\}]
ogr2ogr -f "PostgreSQL" PG:"dbname=postgis host=myhost.de user=postgres \PYGZbs{}
password=topsecret" alaska.shp
\end{Verbatim}

Isto irá importar o shapefile \code{alaska.shp} para o banco de dados PostGIS \emph{postgis} usando o usuário \emph{postgres} com a senha \emph{topsecret} no servidor \emph{myhost.de}.

Note que o OGR deve ser construído com PostgreSQL para suportar PostGIS. Você pode ver isso digitando

\begin{Verbatim}[commandchars=\\\{\}]
ogrinfo --formats \textbar{} grep -i post
\end{Verbatim}

Se você gosta de usar o comando PostgreSQL \textbf{COPY} em vez do método padrão \textbf{INSERT INTO}, você pode exportar a seguinte variável no ambiente (pelo menos disponível no \includegraphics[width=1em]{nix.png} e \includegraphics[width=1em]{osx.png} ):

\begin{Verbatim}[commandchars=\\\{\}]
export PG\_USE\_COPY=YES
\end{Verbatim}

O \textbf{ogr2ogr} não cria índices espaciais como faz o \textbf{shp2pgsl}. Você precisa criá-los manualmente, normalmente usando o comando SQL \textbf{CREATE INDEX} como um passo extra (como descrito na próxima seção {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-improving-performance]{\emph{melhorando o Desempenho}}}).
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:label-improve}

\subsubsection{melhorando o Desempenho}
\label{docs/user_manual/working_with_vector/supported_data:label-improve}\label{docs/user_manual/working_with_vector/supported_data:improving-performance}\label{docs/user_manual/working_with_vector/supported_data:vector-improving-performance}
Retrieving features from a PostgreSQL database can be time consuming, especially
over a network. You can improve the drawing performance of PostgreSQL layers by
ensuring that a \index{PostGIS spatial index}PostGIS spatial index exists on each layer in the
database. PostGIS supports creation of a \index{GiST (Generalized Search Tree)
index}GiST (Generalized Search Tree)
index to speed up spatial searches of the data (GiST index information is taken
from the PostGIS documentation available at \href{http://postgis.refractions.net}{http://postgis.refractions.net}).

The syntax for creating a GiST index is:

\begin{Verbatim}[commandchars=\\\{\}]
CREATE INDEX [indexname] ON [tablename]
  USING GIST ( [geometryfield] GIST\_GEOMETRY\_OPS );
\end{Verbatim}

Observe que para grandes tabelas, a criação do índice pode levar um longo tempo. Uma vez que o índice é criado, você deve realizar um \code{VACUUM ANALYZE}. Consulte a documentação do PostGIS (PostGIS-PROJECT {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}}) para mais informações.

A seguir um exemplo de criação de um índice GiST:

\begin{Verbatim}[commandchars=\\\{\}]
gsherman@madison:\textasciitilde{}/current\$ psql gis\_data
Welcome to psql 8.3.0, the PostgreSQL interactive terminal.

Type:  \PYGZbs{}copyright for distribution terms
       \PYGZbs{}h for help with SQL commands
       \PYGZbs{}? for help with psql commands
       \PYGZbs{}g or terminate with semicolon to execute query
       \PYGZbs{}q to quit

gis\_data=\# CREATE INDEX sidx\_alaska\_lakes ON alaska\_lakes
gis\_data-\# USING GIST (the\_geom GIST\_GEOMETRY\_OPS);
CREATE INDEX
gis\_data=\# VACUUM ANALYZE alaska\_lakes;
VACUUM
gis\_data=\# \PYGZbs{}q
gsherman@madison:\textasciitilde{}/current\$
\end{Verbatim}

\index{ST\_Shift\_Longitude}

\subsection{Camadas vetoriais que ultrapassam 180° de longitude}
\label{docs/user_manual/working_with_vector/supported_data:vector-layers-crossing-180-degrees-longitude}\label{docs/user_manual/working_with_vector/supported_data:index-13}
Many GIS packages don't wrap vector maps, with a geographic reference system
(lat/lon), \index{crossing the 180 degrees longitude line}crossing the 180 degrees longitude line
(\href{http://postgis.refractions.net/documentation/manual-1.4/ST\_Shift\_Longitude.html}{http://postgis.refractions.net/documentation/manual-1.4/ST\_Shift\_Longitude.html}).
As result, if we open such map in QGIS, we will see two far, distinct locations,
that should show near each other. In {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-4]{Figure\_vector\_4}} the tiny point on the far
left of the map canvas (Chatham Islands), should be within the grid, right of
New Zealand main islands.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{vectorNotWrapping.png}
\caption{Map in lat/lon crossing the 180° longitude line \includegraphics[width=1em]{nix.png}}\end{figure}

A workaround is to transform the longitude values using PostGIS and the
\textbf{ST\_Shift\_Longitude} function  This function reads every point/vertex in every
component of every feature in a geometry, and if the longitude coordinate is
\textless{} 0° adds 360° to it. The result would be a 0° - 360°
version of the data to be plotted in a 180° centric map.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{vectorWrapping.png}
\caption{Crossing 180° longitude applying the \textbf{ST\_Shift\_Longitude}
function \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Uso}
\label{docs/user_manual/working_with_vector/supported_data:usage}\begin{itemize}
\item {} 
Importar dados para o PostGIS ({\hyperref[docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis]{\emph{Importação de dados no PostgreSQL}}}), utilizando, por exemplo, o complemento PostGIS Manager ou o complemento SPIT

\item {} 
Use a interface de linha de comando PostGIS para emitir o seguinte comando (este é um exemplo onde a ``TABLE'' é o nome real da sua tabela no PostGIS)

\code{gis\_data=\# update TABLE set the\_geom=ST\_Shift\_Longitude(the\_geom);}

\item {} 
Se tudo correu bem, você deve receber uma confirmação sobre o número de feições que foram atualizadas, então você vai ser capaz de carregar o mapa, veja a diferença ({\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-5]{Figure\_vector\_5}})

\end{itemize}

\index{Spatialite}\index{SQLite}

\subsection{Camadas SpatiaLite}
\label{docs/user_manual/working_with_vector/supported_data:spatialite-layers}\label{docs/user_manual/working_with_vector/supported_data:index-15}\label{docs/user_manual/working_with_vector/supported_data:label-spatialite}
\includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} A primeira vez que você carregar dados de um banco de dados SpatiaLite, comece clicando no botão \includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} :sup: \emph{Adicionar Camada SpatiaLite} na barra de ferramentas ou selecione a opção \includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} :menuselection:'Adicionar Camada SpatiaLite ... no menu \emph{Camada} ou digitando \code{Ctrl+Shift+L}. Isso fará com que surja uma janela, que permitirá você se conectar a um banco de dados SpatiaLite já identificado no QGIS, que você pode escolher no menu suspenso ou para definir uma nova conexão para um novo banco de dados. Para definir uma nova conexão, clique em \textbf{{[}New{]}} e use o navegador de arquivos para apontar para o banco de dados SpatiaLite, que é um arquivo com extensão \code{.sqlite}.

If you want to save a vector layer to SpatiaLite format you can do this by
right clicking the layer in the legend. Then click on \emph{Save as..},
define the name of the output file, select `SpatiaLite' as format and the CRS.
Also you can select `SQLite' as format, and then add \code{SPATIALITE=YES} in the
OGR data source creation option field. This tells OGR to create a SpatiaLite
database. See also \href{http://www.gdal.org/ogr/drv\_sqlite.html}{http://www.gdal.org/ogr/drv\_sqlite.html}.

QGIS also supports editable views in SpatiaLite.


\subsubsection{Criando uma nova camada SpatiaLite}
\label{docs/user_manual/working_with_vector/supported_data:creating-a-new-spatialite-layer}
Se você quiser criar uma nova camada SpatiaLite, consulte a seção {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:vector-create-spatialite]{\emph{Criando uma nova camada SpatiaLite}}}.

\index{QSpatiaLite}\index{Spatialite\_Manager}\index{DB\_Manager}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-spatialite-management-plugin}
\begin{notice}{tip}{Dica:}
\textbf{Gestão complementos de dados SpatiaLite}

For SpatiaLite data management you can also use several Python plugins:
QSpatiaLite, SpatiaLite Manager or DB Manager (core plugin, recommended). They
can be downloaded and installed with the Plugin Installer.
\end{notice}


\subsection{MSSQL Spatial Layers}
\label{docs/user_manual/working_with_vector/supported_data:mssql-spatial-layers}\label{docs/user_manual/working_with_vector/supported_data:label-mssql}
\includegraphics[width=1.5em]{mActionAddMssqlLayer.png} QGIS also provides native MS SQL 2008 support. The
\includegraphics[width=1.5em]{mActionAddMssqlLayer.png} $^{\text{Add MSSQL Spatial Layer}}$ is part of the new toolbar
button or available in the MS SQL node in the QBrowser tree, providing drag and
drop import support.


\section{Janela de Propriedades de Vetor}
\label{docs/user_manual/working_with_vector/vector_properties:the-vector-properties-dialog}\label{docs/user_manual/working_with_vector/vector_properties::doc}\label{docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog}
The \emph{Layer Properties} dialog for a vector layer provides information
about the layer, symbology settings and labeling options. If your vector layer
has been loaded from a PostgreSQL/PostGIS datastore, you can also alter the
underlying SQL for the layer by invoking the \emph{Query Builder} dialog on
the \emph{General} tab. To access the \emph{Layer Properties} dialog,
double-click on a layer in the legend or right-click on the layer and select
\emph{Properties} from the popup menu.
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{vectorLayerSymbology.png}
\caption{Vector Layer Properties Dialog \includegraphics[width=1em]{nix.png}}\label{docs/user_manual/working_with_vector/vector_properties:figure-vector-properties-1}\end{figure}


\subsection{Aba de Estilo}
\label{docs/user_manual/working_with_vector/vector_properties:vector-style-tab}\label{docs/user_manual/working_with_vector/vector_properties:style-tab}
\index{New\_Symbology}\index{Symbology\_New}
{\color{red}\bfseries{}\textbar{}}simbologia\textbar{}Desde\textbar{}qg\textbar{}1.4.0 uma nova simbologia foi integrada paralelamente para melhorar e finalmente substituir a antiga simbologia. {\color{red}\bfseries{}\textbar{}}qg\textbar{}1.8 agora usa a nova simbologia como padrão, tal qual garante uma variedades de melhorias e novas funções.

Uma descrição da antiga simbologia está disponível na seção {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-old-symbology]{\emph{Simbologia Antiga}}}.

Existem três tipos de símbolos: Símbolos de marcação (para pontos), símbolos de linhas (para linhas) e símbolos de preenchimento e contorno (para polígonos). Símbolos podem ser de uma ou mais camadas. É possivel definir a cor de um símbolo e esta cor é então definida para toda as camadas do símbolo. Algumas camadas podem ter suas cores bloqueadas - em casos que a cor não pode ser alterada. Isto é útil quando você define a cor de um símbolo multicamadas. Da mesma forma, é possivel definir a espessura dos símbolos de linha, assim como o tamanho e rotação dos simbolos de marcação.

\index{Font\_Marker}\index{Simple\_Marker}\index{SVG\_Marker}
\index{Line\_decoration}\index{Marker\_line}\index{Simple\_line}
\index{Centroid\_fill}\index{SVG\_fill}\index{Simple\_fill}\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:vector-symbol-types}
\textbf{Tipos de símbolos de camada disponíveis}
\begin{itemize}
\item {} 
Camadas de Ponto
\begin{itemize}
\item {} 
\textbf{Marcador de Fonte}: Renderização com uma fonte.

\item {} 
\textbf{Marcador Simples}. Renderização com um marcador do tipo hardcoded.

\item {} 
\textbf{Marcador SVG}: Renderização com uma imagem SVG.

\item {} 
\textbf{Marcador Elipse}: Renderizado com vetores de elipse derivados de atributos.

\item {} 
{\color{red}\bfseries{}**}Marcador do Campo Vetor'': Renderização com campos de vetores derivados de atributos.

\end{itemize}

\item {} 
Camadas tipo Linhas
\begin{itemize}
\item {} 
\textbf{Decoração de Linhas}: Adicione uma decoração de linha, ex: uma seta para indicar a direção da linha.

\item {} 
\textbf{Linha tipo Marcador}: Uma linha renderizada a partir da repetição de um símbolo do tipo marcador.

\item {} 
\textbf{Linha Simples}: Renderização normal de uma linha (com cor, espessura e estilo de pena).

\end{itemize}

\item {} 
Camada de Polígonos
\begin{itemize}
\item {} 
\textbf{Preenchimento tipo Centróide}: Preenche o centróide de um polígono com a marcação tipo hardcoded.

\item {} 
\textbf{Preenchimento SVG}: Preenche um polígono com um símbolo SVG.

\item {} 
\textbf{Preenchimento Simples}. Renderização usual de  um polígono (com cor, padrão de preenchimento e contorno definidos).

\item {} 
\textbf{Preenchimento tipo Padrão de Linha}: Preenche um polígono com um padrão de linha.

\item {} 
\textbf{Preenchimento tipo Padrão de Ponto}: Preenche um polígono com um padrão de ponto.

\item {} 
\textbf{Contorno: Decoração de Linha}: Adiciona uma decoração de linha, ex: uma linha para indicar uma direação de linha.

\item {} 
\textbf{Contorno:Linha de Marcador}: Utilize um marcador do tipo hardcoded como contorno de linha.

\item {} 
\textbf{Contorno: Linha Simples}. Define espessura, cor e estilo de pena como contorno de linha.

\end{itemize}

\end{itemize}

\index{Color\_ramps}
\textbf{Rampas de Cor}

As rampas de cor servem para definir a abrangência de cores que podem ser utilizadas durante a criação de renderizadores. A cor do símbolo será definida pela  rampa de cores.

Existem três tipos de rampas de cor:
\begin{itemize}
\item {} 
\textbf{Gradiente}: Linha gradiente de uma cor até outra.

\item {} 
\textbf{Randômica}: Cores randômicas geradas por um local específico do espaço de cores.

\item {} 
\textbf{Cor Brewer}: Criar área de cor para um esquema de cor e um número definido de classes de cor.

\end{itemize}

Rampas de cores podem ser definidas no: guilabel: \emph{Rampa de cor} da aba: guilabel: \emph{Gerenciador de Estilo} clicando no botão \textbf{{[}Adicionar{]}} e, em seguida, escolher um tipo de rampa de cores (ver seção {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{vector\_style\_manager}}).

\textbf{Estilos}

A style groups a set of various symbols and color ramps. You can define
your prefered or frequently used symbols, and can use it without having
to recreate it everytime. Style items (symbols and color ramps) have always
a name by which they can be queried from the style. There is at least one
default style in QGIS (modifiable) and the user can add further styles.
In the lower part of the Style tab there are four buttons for managing styles:
Use \textbf{{[}Restore Default Style{]}} to get back to your default settings, \textbf{{[}Save As Default{]}}
to save your style as default, \textbf{{[}Load Style...{]}} to get to your own styles and
\textbf{{[}Save Style{]}} to save your own styles. Layer styles can also be transferred
from one layer to another layer. Activate a layer and choose \emph{Layer \(\rightarrow\)}
\includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copy style} and switch to another layer. Then choose
\emph{Layer \(\rightarrow\)} \includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Paste style}.

\index{Renderers}
\textbf{Renderizando}

The renderer is responsible for drawing a feature together with the correct
symbol. There are four types of renderers: single symbol, categorized
(called unique color in the old symbology), graduated and rule-based. There
is no continuous color renderer, because it is in fact only a special case
of the graduated renderer. The categorized and graduated renderer can be created
by specifying a symbol and a color ramp - they will set the colors for symbols
appropriately.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:vector-new-symbology}
\textbf{Trabalhando com a Nova Geração de Simbologia}

In the \emph{Style} tab you can choose one of the five renderers: single
symbol, categorized, graduated, rule-based and point displacement. For each
data type (points, lines and polygons) vector symbol layer types are available
(see {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-symbol-types]{vector\_symbol\_types}}). Depending on the chosen renderer, the symbology
Depending on the chosen renderer, the \emph{Style} tab provides different
following sections. The new generation symbology dialog also provides a
\textbf{{[}Style Manager{]}} button which gives access to the Style Manager (see Section
{\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{\emph{Gerenciador de estilo}}}). The Style Manager allows you to edit and remove
existing symbols and add new ones.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:tip-change-multiple-symbols}
\begin{notice}{tip}{Dica:}
\textbf{Seleção e mudança de simbolos multiplos}

The New Generation Symbology allows to select multiple symbols and right
click to change color, transparency, size, or width of selected
entries.
\end{notice}

\index{Single\_Symbol\_Renderer}\index{Renderer\_Single\_Symbol}
\textbf{Renderizando Simbolo Individual}

The Single Symbol Renderer is used to render all features of the layer using
a single user-defined symbol. The properties, that can be adjusted in the
\code{Style} tab, depend partially on the type of the layer, but all types share
the following structure. In the top left part of the tab, there is a preview
of the current symbol to be rendered. In the bottom part of the tab, there is
a list of symbols already defined for the current style, prepared to be used
via selecting them from the list. The current symbol can be modified using
the \textbf{{[}Change{]}} button below the preview, which opens a \emph{Symbol
Properties} dialog, or the \textbf{{[}Change{]}} button right of the preview, which
opens an ordinary \emph{Color} dialog.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{singlesymbol_ng_line.png}
\caption{Single symbol line properties \includegraphics[width=1em]{nix.png}}\end{figure}

No guia: guilabel: \emph{Estilo} você pode definir além de uma camada de transparência em geral também usar a unidade de milímetros ou mapa para a escala de tamanho. No botão \textbf{{[}Avançado{]}} junto com o botão \textbf{{[}Salvar como estilo{]}}, você pode usar dados definidos pela escala de tamanho e rotação. Aqui o menu :menuselection: \emph{níveis de símbolo -\textgreater{}} permite ativar e definir a ordem pela qual as camadas de símbolos são processados ​​(se o símbolo é constituído por mais do que uma camada).

Depois de ter feito as alterações necessárias, o símbolo pode ser adicionado à lista de símbolos de estilos atuais (usando o  botão ** {[}Salvar como estilo{]} \textbf{) e então facilmente ser usado no futuro. Além disso, você pode usar o botão **{[}Salvar Estilo{]}} para salvar o símbolo como um arquivo de estilo de camada QGIS (.qml) ou arquivo SLD (. sld). Atualmente na versão 1.8 SLD podem ser exportados a partir de qualquer tipo de renderizador: símbolo, categorizado, graduado ou baseado em regras, mas quando a importação de um SLD​​, um único símbolo ou renderizador baseado em regras é criado. Isso significa que os estilos categorizados ou graduados são convertidos com baseado em regra. Se você quer preservar esses renderizadores, você tem que ficar com o formato QML. Por outro lado, pode ser muito útil, por vezes, para ter esta maneira fácil de converter estilos baseado em regra.

\index{Categorized\_Renderer}\index{Renderer\_Categorized}
\textbf{Renderizador Categorizado}

O Rendirizador Categorizado é usado para processar todos os recursos a partir de uma camada, usando um único símbolo definido pelo usuário, sua cor reflete o valor do atributo de uma feição selecionada. A guia: guilabel: \emph{estilo} permite que você selecione:
\begin{itemize}
\item {} 
O Atributo (Usando a coluna listagem)

\item {} 
Simbolo (usando a aba Simbolo)

\item {} 
As cores (usando rampa de cores lista box)

\end{itemize}

O botão \textbf{{[}Avançado{]}} no canto inferior direito da caixa de diálogo, permite definir os campos que contenham informações de rotação e tamanho de escala. Para maior comodidade, a lista na parte inferior da guia, elenca os valores de todos os atributos selecionados no momento em conjunto, incluindo os símbolos que serão renderizados.

The example in {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-2]{figure\_symbology\_2}} shows the category rendering dialog used
for the rivers layer of the QGIS sample dataset.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{categorysymbol_ng_line.png}
\caption{Categorized Symbolizing options \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Color\_Ramp}\index{Gradient\_Color\_Ramp}\index{ColorBrewer}\index{Custom\_Color\_Ramp}
You can create a custom color ramp choosing \emph{New color ramp...}
from the Color ramp dropdown menu. A dialog will prompt for the ramp type:
Gradient, Random, ColorBrewer, then each one has options for number of steps
and/or multiple stops in the color ramp. See {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-3]{figure\_symbology\_3}} for an
example of custom color ramp.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=12em]{customColorRampGradient.png}
\caption{Example of custom gradient color ramp with multiple stops \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Graduated\_Renderer}\index{Renderer\_Graduated}
\index{Natural\_Breaks\_(Jenks)}\index{Pretty\_Breaks}\index{Equal\_Interval}\index{Quartil}
\textbf{Renderização Graduada}

The Graduated Renderer is used to render all the features from a layer, using
a single user-defined symbol, whose color reflects the classification of a
selected feature's attribute to a class.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{graduatesymbol_ng_line.png}
\caption{Graduated Symbolizing options \includegraphics[width=1em]{nix.png}}\end{figure}

Like Categorized Renderer, it allows to define rotation and size scale from specified columns.

Análogo a renderização categorizada, a :guilabel: aba \emph{Estilo} permite que voce selecione:
\begin{itemize}
\item {} 
O Atributo (Usando a coluna listagem)

\item {} 
O simbolo (usando o botão Propriedades do Simbolo)

\item {} 
As cores (usando a lista de rampas de cores)

\end{itemize}

Adicionalmente, voce pode especificar o numero de classes e também o modo como classificar os recursos dentro das classes (usando o Modo lista). Os modos disponíveis são:
\begin{itemize}
\item {} 
Intervalo igual

\item {} 
Quartil

\item {} 
Quebras Naturais (Jenks)

\item {} 
Desvio padrão

\item {} 
Quebras suaves

\end{itemize}

The listbox in the bottom part of the \emph{Style} tab lists the classes
together with their ranges, labels and symbols that will be rendered.

The example in {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-4]{figure\_symbology\_4}} shows the graduated rendering dialog for
the rivers layer of the QGIS sample dataset.

\index{Rule-based\_Rendering}\index{Rendering\_Rule-based}
\textbf{Renderizador baseado em regras}

O renderizador baseado em regras é utilizado para renderizar todas as feições de uma camada utilizando símbolos baseados em regras, cujas cores refletem a classificação do atributo de uma feição selecionada para uma classe. As regras são baseadas em declarações SQL. A janela permite agrupar as regras através de filtros e escala e você pode decidir se quer habilitar níveis de símbolos ou usar somente a primeira regra correspondente.

The example in {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-5]{figure\_symbology\_5}} shows the rule-based rendering dialog
for the rivers layer of the QGIS sample dataset.

To create a rule, activate an existing row by clicking on it or click on `+' and
click on the new rule. Then press the \textbf{{[}Edit{]}} button. In the \emph{Rule
properties} dialog you can define a label for the rule. Press the \includegraphics{browsebutton.png}
button to open the Expression builder. In the \textbf{Function List}, click on
\emph{Fields and Values} to view all attributes of the attribute table to
be searched. To add an attribute to the Field calculator \textbf{Expression} field,
double click its name in the \emph{Fields and Values} list. Generally you
can use the various fields, values and functions to construct the calculation
expression or you can just type it into the box (see {\hyperref[docs/user_manual/working_with_vector/field_calculator:vector-field-calculator]{\emph{Calculadora de campo}}}).
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{rulesymbol_ng_line.png}
\caption{Rule-based Symbolizing options \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Point\_Displacement\_Renderer}\index{Renderer\_Point\_Displacement}
\index{Displacement\_plugin}
\textbf{Deslocamento de ponto}

O renderizador de deslocamento de ponto oferece a visualização de todas as feições de uma camada de pontos, mesmo se eles tem a mesma localização. Para para isso, os símbolos dos pontos são postos em um círculo de deslocamento ao redor de um símbolo.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{poi_displacement.png}
\caption{Point displacement dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Symbol\_Properties}
\textbf{Propriedades de Símbolos}

The symbol properties dialog allows the user to specify different properties
of the symbol to be rendered. In the bottom left part of the dialog, you find
a preview of the current symbol as it will be displayed in the map canvas.
Above the preview is the list of symbol layers. To start the \emph{Symbol
properties} dialog, click the \textbf{{[}} \includegraphics[width=1em]{mActionOptions.png} \textbf{Change...{]}} button in
the \emph{Style} tab of the \emph{Layer Properties} dialog.

The buttons allow adding or removing layers, changing the position of layers, or
locking layers for color changes. In the right part of the dialog, there are
shown the settings applicable to the single symbol layer selected in the symbol
layer list. The most important is the \emph{Symbol Layer Type} \includegraphics{selectstring.png}
combobox, which allows you to choose the layer type. The available options depend
on the layer type (Point, Line, Polygon). The symbol layer type options are
described in section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-symbol-types]{vector\_symbol\_types}}. You can also change the symbol
layer properties in the right part of the dialog. For example if you have chosen
an SVG marker for a point layer it is now possible to change its color using
\emph{Color} button.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{symbolproperties1.png}
\caption{Line composed from three simple lines \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Gerenciador de estilo}
\label{docs/user_manual/working_with_vector/vector_properties:style-manager}\label{docs/user_manual/working_with_vector/vector_properties:vector-style-manager}
O Gerenciador de Estilo é um pequeno aplicativo auxiliar, que lista os símbolos e as rampas de cores disponíveis em um estilo. Ele também permite adicionar e/ou remover itens. Para iniciar o Gerenciador de estilo, clique no menu \emph{Propriedades \(\rightarrow\) Gerenciador de estilo}. Alternativamente acesse via aba : \emph{Estilo}.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-10}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{stylemanager.png}
\caption{Style Manager to manage symbols and color ramps \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Old\_Symbology}\index{Symbology\_Old}

\subsection{Simbologia Antiga}
\label{docs/user_manual/working_with_vector/vector_properties:index-15}\label{docs/user_manual/working_with_vector/vector_properties:vector-old-symbology}\label{docs/user_manual/working_with_vector/vector_properties:old-symbology}
\begin{notice}{note}{Nota:}
QGIS 1.8. still supports the usage of the old symbology, although it is
recommended to switch to the new symbology, described in section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-new-symbology]{vector\_new\_symbology}},
because the old symbology will be removed in one of the next releases.
\end{notice}

Se você quer ou precisa voltar à antiga simbologia voce clica no botão \textbf{{[}Simbologia Antiga{]}} na aba \emph{Estilo} do aba \emph{Propriedades da Camada}.

Você também pode tornar a antiga simbologia em padrão, desativando \includegraphics{checkbox.png}: guilabel: \emph{Utilize nova simbologia para renderização} na aba: guilabel: \emph{Renderização} em: menuselection: \emph{Configurações -\textgreater{}} \textbar{} mActionOptions {\color{red}\bfseries{}\textbar{}}: menuselection: \emph{Opções}.

\index{Old\_Symbology\_Renderers}\index{Renderers\_Old\_Symbology}
A simbologia antiga do QGIS suporta os seguintes renderizadores:
\begin{itemize}
\item {} 
\textbf{Símbolo único} - um estilo único é aplicado a cada objeto na camada.

\item {} 
\textbf{Símbolo Graduado} - objetos na camada são mostrados com diferentes símbolos classificados por valores de um campo  em particular.

\item {} 
\textbf{Cores contínuas} - objetos na camada são apresentadas com uma variação de cores classificadas pelo valor numérico em um campo específico.

\item {} 
\textbf{Valor único} - objetos são classificados através de valores únicos de um campo especificado com cada valor tendo um símbolo diferente.

\end{itemize}

To \index{change the symbology}change the symbology for a layer, simply double click on its legend
entry and the vector \emph{Layer Properties} dialog will be shown.

\index{Fill\_Style}\index{Fill\_Color}\index{Outline\_Options}
\textbf{Opções de Estilo}

Nessa janela você pode estilizar a sua camada vetorial. Dependendo da opção de renderização selecionada, você terá a possibilidade de também classificar suas feições no mapa.

Pelo menos as seguintes opções de estilo se aplicam para quase todos os renderizadores:
\begin{itemize}
\item {} 
\textbf{Fill style} - Style for filling. Beside the given brushes you can select
\emph{Fill style:} \includegraphics{selectstring.png} `Texture' and click the \includegraphics{browsebutton.png}
button for selecting your own texture file. Currently the fileformats
\code{*.jpeg}, \code{*.xpm}, and \code{*.png} are supported.

\item {} 
\textbf{Cor de Preenchimento} - cor de preenchimento das feições.

\item {} 
\textbf{Opções de Linha}
\begin{itemize}
\item {} 
Estilo de Linha - Estilo de caneta para linha da feição. Você também pode definir \emph{Sem linha}.

\item {} 
Cor da linha - cor da linha da feição.

\item {} 
Largura da linha - largura das feições.

\end{itemize}

\end{itemize}

Uma vez que você aplicour um estilo à sua camada você também pode salvar o estilo de sua camada para um arquivo a parte (com a extensão: file:. \emph{*.qml}). Para fazer isso, use o botão \textbf{{[}Save Style...{]}}. Não é preciso dizer que \textbf{{[}Load Style...{]}} carrega seu arquivo de estilo salvo.

Se você deseja usar sempre um estilo particular, sempre que a camada é carregada, use o botão \textbf{{[}Salvar Como Padrão{]}} para fazer o seu estilo padrão. Além disso, se você fizer alterações para o estilo mas não gostou do resultado, use o botão \textbf{{[}Restore Default Style{]}} para reverter para o seu estilo padrão.

\index{Vector\_Transparency}\index{Transparency\_Vector}
\textbf{Transparência de vetor}

QGIS allows to set a transparency for every vector layer. This can be done
with the slider \emph{Transparency} \includegraphics{slider.png} inside the
\emph{Style} tab. This is very useful for overlaying several vector
layers.

\index{Style\_Manager}\index{Manage\_Symbols}\index{Manage\_Color\_Ramps}
\index{Labeling\_Engine}\index{Labeling\_New}\index{Labeling\_Old}

\subsection{Aba rótulos}
\label{docs/user_manual/working_with_vector/vector_properties:index-21}\label{docs/user_manual/working_with_vector/vector_properties:vector-labels-tab}\label{docs/user_manual/working_with_vector/vector_properties:labels-tab}
{\color{red}\bfseries{}\textbar{}rótulos\textbar{}} Assim como para à simbologia \textbar{} qg \textbar{} 1.8 fornece atualmente um antigo e um novo motor de rotulagem em paralelo. A aba: guilabel: \emph{Rótulos} ainda contém a antiga rotulagem. A nova rotulagem é implementada como um aplicativo principal e irá substituir as funções da antiga aba de rótulos em uma das próximas versões.

Recomendamos mudar para a nova rotulagem, descrita na seção :ref:'vector\_new\_labeling'.

The old labeling in the \emph{Labels} tab allows you to enable labeling
features and control a number of options related to fonts, placement, style,
alignment and buffering. We will illustrate this by labeling the lakes
shapefile of the QGIS sample dataset:
\begin{enumerate}
\item {} 
Load the Shapefile \code{alaska.shp} and GML file \code{lakes.gml}
in QGIS

\item {} 
Zoom in a bit to your favorite area with some lake

\item {} 
Make the \code{lakes} layer active

\item {} 
Open the \emph{Layer Properties} dialog

\item {} 
Click on the \emph{Labels} tab

\item {} 
Check the \includegraphics{checkbox.png} \emph{Display labels} checkbox to enable labeling

\item {} 
Choose the field to label with. We will use
\emph{Field containing label} \includegraphics{selectstring.png} \code{NAMES}

\item {} 
Enter a default for lakes that have no name. The default label will be
used each time QGIS encounters a lake with no value in the \code{NAMES} field.

\item {} 
If you have labels extending over several lines, check
\includegraphics{checkbox.png}\emph{Multiline labels?}. QGIS will check for a true line
return in your label field and insert the line breaks accordingly.
A true line return is a \textbf{single} character \code{\textbackslash{}n}, (not two separate
characters, like a backlash \code{\textbackslash{}} followed by the character \code{n}).  To insert
line returns in an attribute field configure the edit widget to be text
edit (not line edit).

\item {} 
Clique \textbf{{[}Aplicar{]}}.

\end{enumerate}

Agora temos rótulos. Como eles se aparecem? Eles são, provavelmente, grandes demais e estão mal posicionados em relação ao símbolo do marcador para os lagos.

Selecione a entrada \code{Fonte} e use os botões \textbf{{[}Fonte{]}} e \textbf{{[}Cor{]}} para definir a fonte e a cor. Você também pode alterar o ângulo e o posicionamento do rótulo de texto.

Para alterar a posição do texto relativa à feição:
\begin{enumerate}
\item {} 
Beneath the Basic label options change the placement by selecting one of the
radio buttons in the \emph{Placement} group. To fix our labels, choose
the \includegraphics{radiobuttonon.png} \emph{Right} radio button.

\item {} 
the \code{Font size units} allows you to select between \includegraphics{radiobuttonon.png}
\emph{Points} or \includegraphics{radiobuttonoff.png} \emph{Map units}.

\item {} 
Clique \textbf{{[}Aplicar{]}} para ver as alterações sem fechar o diálogo.

\end{enumerate}

As coisas estão melhores, mas os rótulos são ainda muito perto do marcador. Para corrigir isso, podemos usar as opções \emph{Afastamento}, que fica na parte inferior do menu. Aqui podemos adicionar afastamentos para as direções X e Y. Adicionando um deslocamento de 5 X irá afastar os rótulos do marcador e torná-los mais legíveis. É claro que se o seu marcador ou fonte é maior, mais deslocamento será necessário.

O último ajuste que faremos é para criar um {\color{red}\bfseries{}{}`}Buffer{}`nos rótulos. Isto significa apenas colocar um pano de fundo em torno deles para fazê-los sobressair. Para gerar um Buffer para os rótulos de lagos:
\begin{enumerate}
\item {} 
Clique na \includegraphics{checkbox.png}: guilabel: \emph{Buffer de rótulos} para habilitar os buffers de rótulos.

\item {} 
Escolha um tamanho para o buffer usando a caixa de rotação.

\item {} 
Escolha uma cor clicando em \textbf{{[}Cor{]}} e escolhendo a sua favorita a partir do seletor de cores. Você também pode definir alguma transparência para o buffer se você preferir.

\item {} 
Clique \textbf{{[}Aplicar{]}} para ver se você gosta das alterações.

\end{enumerate}

Se você não gostar dos resultados, ajuste as configurações e, em seguida, teste novamente clicando \textbf{{[}Aplicar{]}}.

Um buffer de 1 ponto parece dar um bom resultado. Observe que você também pode especificar o tamanho do buffer em unidades do mapa se isso funcionar melhor para você.

As opções  avançadas dentro da aba: guilabel: \emph{Rótulo} permitem que você controle a aparência dos rótulos usando atributos da camada. As opções começando com \emph{Definidos por dados} permitem que você defina todos os parâmetros para os rótulos usando campos na camada.

Note that the \emph{Label} tab provides a \code{preview-box} where your
selected label is shown.

\index{New\_Labeling}\index{Smart\_Labeling}

\subsection{Nova Rotulagem}
\label{docs/user_manual/working_with_vector/vector_properties:vector-new-labeling}\label{docs/user_manual/working_with_vector/vector_properties:new-labeling}\label{docs/user_manual/working_with_vector/vector_properties:index-22}
A nova aplicação \textbar{} mActionLabeling {\color{red}\bfseries{}\textbar{}}: sup: \emph{Rotulagem} fornece rotulagem inteligente para camadas vetoriais de pontos, linhas e polígonos e requer apenas alguns parâmetros. Esta nova aplicação irá substituir a atual rotulagem QGIS, descrita na seção: ref: \emph{vector\_labels\_tab} e suporta também camadas transformadas on-the-fly.

\textbf{Utilizando a Nova Rotulagem}
\begin{enumerate}
\item {} 
Inicie o  QGIS e carregue uma camada vetorial de ponto, linha ou polígono.

\item {} 
Ative a camada na legenda e clique no ícone \textbar{} mActionLabeling {\color{red}\bfseries{}\textbar{}}: sup: ícone {\color{red}\bfseries{}{}`}Rotulagem' no menu da barra de ferramentas do QGIS.

\end{enumerate}

\textbf{Rotulando camadas de pontos}

First step is to activate the \includegraphics{checkbox.png} \emph{Label this layer} checkbox
and select an attribute column to use for labeling. Click \includegraphics{browsebutton.png} if you
want to define labels based on expressions. After that you can define the text
style and the scale-based visibility in the \emph{Label settings} tab (see
{\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-1]{Figure\_labels\_1}} ). Choose the \emph{Advanced} tab for the label placement
and the labeling priority. You can define if every part of a multipart feature
is to be labeled here. With the wrap label on character function you can define
a character for a line break in the labels. The \emph{Data defined settings}
tab provides you with the attribute-based definition of Font properties, Buffer
properties and Position.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{label_points.png}
\caption{Smart labeling of vector point layers \includegraphics[width=1em]{nix.png}}\end{figure}

\textbf{Rotulando camadas de linhas}

O primeiro passo é ativar a opção \includegraphics{checkbox.png} :guilabel: `Rotule esta camada{}` na aba: guilabel:\emph{Configurações de rótulos} e selecione uma coluna de atributo para ser usada para a rotulagem. Aqui você também pode definir rótulos com base em expressões. Depois disso, você pode definir o estilo de texto e a visibilidade baseada na escala. Outras opções de rotulagem estão disponíveis através da aba :guilabel: \emph{Avançado. Você pode definir o posicionamento e a distância do rótulo, um posicionamento relacionado à orientação da linha e a prioridade da rotulagem. Além disso, você pode definir se cada parte de uma linha composta de várias partes deve ser rotulada, se as linhas serão fundidas para evitar rótulos duplicados e, se é adicionado um símbolo de direção (ver Figure\_labels\_2\_). Também é possível suprimir a rotulagem de feições e cobrir rótulos em caracteres. Use :guilabel: {}`Configurações definidas por dados} para configurações baseadas em atributos ou conexão à banco de dados.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{label_line.png}
\caption{Smart labeling of vector line layers \includegraphics[width=1em]{nix.png}}\end{figure}

\textbf{Rotulando camadas de polígonos}

O primeiro passo é ativar a opção \includegraphics{checkbox.png}: guilabel: `Rotular esta camada{}` e selecionar uma coluna de atributo a ser usada para a rotulagem. Aqui você também pode definir rótulos com base em expressões. Em \emph{Configurações de rótulos} defina o estilo de texto e a visibilidade baseada na escala (ver {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-3]{Figure\_labels\_3}}). Use a aba \emph{Avançado} para o posicionamento do rótulo, distância e prioridade de rotulagem. Defina aqui se cada parte de uma feição de várias partes deve ser rotulada, suprima a rotulagem de feições e rótulos cobertos por caracteres. Use: guilabel: \emph{configurações de dados definidos} para configurações baseadas em atributos ou banco de dados de conexão à base.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{label_area.png}
\caption{Smart labeling of vector polygon layers \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Label\_Engine\_Settings}\index{Colliding\_Labels}
\index{Popmusic\_Tabu}\index{Popmusic\_Chain}\index{Chain}\index{Popmusic\_Tabu\_Chain}\index{FALP}
\textbf{Alterar mecanismos de configurações}

Além disso, você pode clicar no botão \textbf{{[}Mecanismo de Configurações{]}} e selecione o método de pesquisa, usado para encontrar a melhor colocação de etiquetas. Disponível é Chain, Popmusic Tabu, Popmusic Chain, Popmusic Tabu Chain e FALP.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{label_engine.png}
\caption{Dialog to change label engine settings \includegraphics[width=1em]{nix.png}}\end{figure}

Além disso, o número de opções que podem ser definidos para os recursos de ponto, linha e polígonos, e você pode definir se deseja mostrar todas os rótulos (incluindo rótulos coincidentes) e opções de rótulos para a depuração.

** Palavras-chave para usar em colunas de atributo de rótulação **

Há uma lista de palavras-chave com suportadas, que podem ser utilizadas para a colocação de rótulos em colunas de atributos definidas.
\begin{itemize}
\item {} 
\textbf{For horizontal alignment}: \code{left}, \code{center}, \code{right}

\item {} 
\textbf{For vertical alignment}: \code{bottom}, \code{base}, \code{half}, \code{top}

\item {} 
{\color{red}\bfseries{}**}Cores podem ser especificados em notação svg {\color{red}\bfseries{}**}, por exemplo \# ff0000

\item {} 
** para negrito, sublinhado e itálico riscado {\color{red}\bfseries{}**}: 0 = falso 1 = verdadeiro

\end{itemize}

A combination of key words in one column also works, e.g.: \code{base right} or
\code{bottom left}.


\subsection{Aba Campos}
\label{docs/user_manual/working_with_vector/vector_properties:vector-attributes-tab}\label{docs/user_manual/working_with_vector/vector_properties:fields-tab}
\includegraphics[width=2em]{attributes.png} Within the \emph{Fields} tab the field attributes of the
selected dataset can be manipulated. The buttons \includegraphics[width=1.5em]{mActionNewAttribute.png}
$^{\text{New Column}}$ and \includegraphics[width=1.5em]{mActionDeleteAttribute.png} $^{\text{Delete Column}}$
can be used, when the dataset is \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Editing mode}}$.

At the moment only columns from PostGIS layers can be removed and added. The
OGR library supports to add and remove columns, if you have a GDAL version \textgreater{}= 1.9
installed.

\textbf{Edição de Widget}




\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-fields-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{editwidgetsdialog.png}
\caption{Dialog to select an edit widget for an attribute column \includegraphics[width=1em]{nix.png}}\end{figure}

Na aba de orientação:  guia \emph{Campos} você também encontra uma coluna {}`{}` Edição de Widget {\color{red}\bfseries{}{}`{}`}. Esta coluna pode ser utilizada para definir os valores ou uma variedade de valores que são permitidos para serem adicionados à coluna da tabela de atributos específicos. Se você clicar no botão ** {[}Editar Widget{]} {\color{red}\bfseries{}**}, uma janela se abre, onde você pode definir diferentes elementos. Estes elementos são:
\begin{itemize}
\item {} 
** Edição Linha {\color{red}\bfseries{}**}: um campo de edição que permite a inserção de texto simples (ou restritor para números de atributos numéricos).

\item {} 
\textbf{Classificação}: Exibe uma caixa de combinação com os valores utilizados para a classificação, se você tiver escolhido ``valores únicos'' como o tipo de legenda na: guia {\color{red}\bfseries{}{}`}Estilo `da caixa de diálogo Propriedades.

\item {} 
\textbf{Tamanho}: Permite definir valores numéricos de um tamanho específico. A edição do Widget pode ser um controle deslizante ou uma caixa de rotação.

\item {} 
** Valores únicoss {\color{red}\bfseries{}**}: O usuário pode selecionar um dos valores já utilizados na tabela de atributos. Se editável é ativado, uma linha de edição é mostrada com suporte para autocompletar, caso contrário, uma caixa de combinação é utilizada.

\item {} 
** Nome do Arquivo {\color{red}\bfseries{}**}: Simplifica a seleção, adicionando uma janela de seleção de arquivos.

\item {} 
** Mapa de Valor {\color{red}\bfseries{}**}: uma caixa de combinação com itens pré-definidos. O valor é armazenado no atributo, a descrição é mostrada na caixa de combinação. Você pode definir valores manualmente ou carregá-los a partir de uma camada ou um arquivo CSV.

\item {} 
** Enumeração {\color{red}\bfseries{}**}: Abre uma caixa de combinação com valores que podem ser usados ​​dentro no tipo de colunas. Atualmente é suportado apenas por provedores de postgres.

\item {} 
** Imutável {\color{red}\bfseries{}**}: A coluna de atributo imutável é somente leitura. O usuário não é habilitado para modificar o conteúdo.

\item {} 
** oculto {\color{red}\bfseries{}**}: Uma coluna de atributo oculto é invisível. O usuário não é capaz de ver o seu conteúdo.

\item {} 
** Caixa de seleção {\color{red}\bfseries{}**}: Exibe uma caixa de seleção e você pode definir qual atributo é adicionado na coluna quando a caixa de seleção é ativada ou não.

\item {} 
** Edição de texto {\color{red}\bfseries{}**}: Isto abre um campo de edição de texto que permite que várias linhas sejam utilizadas.

\item {} 
** Calendário {\color{red}\bfseries{}**}: Abre um widget de calendário para introduzir uma data. Tipo de coluna deve ser de texto.

\item {} 
\textbf{Value Relation}: Offers values from a related table in a combobox. You can
select layer, key column and value column.

\item {} 
\textbf{UUID Generator}: Generates a read-only UUID (Universally Unique Identifiers)
field, if empty.

\end{itemize}


\subsection{Guia Geral}
\label{docs/user_manual/working_with_vector/vector_properties:general-tab}\label{docs/user_manual/working_with_vector/vector_properties:vectorgeneraltab}
\includegraphics[width=2em]{general.png} The \emph{General} tab is essentially like that of the raster dialog.
There are several options available:
\begin{itemize}
\item {} 
Change the display name of the layer

\item {} 
Set a display field to be used for the \emph{Identify Results} dialog

\item {} 
Define a certain Edit User Interface for the vector layer written with the Qt
Creator IDE and tools at \href{http://qt.digia.com/Product/Developer-Tools/}{http://qt.digia.com/Product/Developer-Tools/}

\item {} 
Create a \emph{Spatial Index} (only for OGR supported formats)

\item {} 
Add an \emph{Init function} for the layer. They will overwrite existing
QGIS widget initializations, if applied

\item {} 
\emph{Update Extents} information for a layer

\item {} 
View or change the projection of the specific vector layer, clicking on
\emph{Specify CRS}

\end{itemize}

Furthermore you can activate and set \includegraphics{checkbox.png} \emph{Use scale
dependent rendering}, define provider specific options (e.g. encoding) and with the
\textbf{{[}Query Builder{]}} button you can create a subset of the features in the layer
that will be visualized (also refer to section {\hyperref[docs/user_manual/working_with_vector/query_builder:sec-selection-query]{\emph{Seleção}}}).
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-general-vect}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{vector_general_tab.png}
\caption{General tab in vector layers properties dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Aba Metadado}
\label{docs/user_manual/working_with_vector/vector_properties:metadata-tab}\label{docs/user_manual/working_with_vector/vector_properties:vectormetadatatab}
\includegraphics[width=2em]{metadata.png} The \emph{Metadata} tab contains general information about the layer,
including specifics about the type and location, number of features, feature
type, and the editing capabilities. The \emph{Extents} section, providing
layer extent information, and the \emph{Layer Spatial Reference System}
section, providing information about the CRS of the layer. This is a quick way
to get information about the layer.

Additionally you can add/edit a title for the layer and some abtract information.
These information will be saved in the QGIS project file for following sessions
and will be used for QGIS server.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-metadata-vect}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{vector_metadata_tab.png}
\caption{Metadata tab in vector layers properties dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Guia de Ações}
\label{docs/user_manual/working_with_vector/vector_properties:actions-tab}
\includegraphics[width=2em]{action.png} QGIS fornece a capacidade de executar uma ação com base nos atributos de um recurso. Isso pode ser usado para executar qualquer número de ações, por exemplo, a execução de um programa com argumentos construídos a partir dos atributos de um recurso ou passar parâmetros ao uma ferramenta de comunicação web.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-actions-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{action_dialog.png}
\caption{Overview action dialog with some sample actions \includegraphics[width=1em]{nix.png}}\end{figure}

Actions are useful when you frequently want to run an external application or
view a web page based on one or more values in your vector layer. They are
devided into 6 types and can be used like this:
\begin{itemize}
\item {} 
Generic, Mac, Windows and Unix actions start an external process,

\item {} 
Python actions execute a python expression,

\item {} 
Generic and Python actions are visible everywhere,

\item {} 
Mac, Windows and Unix actions are visible only on the respective platform (i.e.
you can define three `Edit' actions to open an editor and the users can only
see and execute the one `Edit' action for their platform to run the editor).

\end{itemize}

There are several examples included in the dialog. You can load them clicking
on \textbf{{[}Add default actions{]}}. An example is performing a search based on an
attribute value. This concept is used in the following discussion.

\index{Actions}\index{Attribute\_Actions}
** Definição de Ações **

Attribute actions are defined from the vector \emph{Layer Properties}
dialog. To \index{define an action}define an action, open the vector \emph{Layer Properties}
dialog and click on the \emph{Actions} tab. Select `Generic' as type and
provide a descriptive name for the action. The action itself must contain
the name of the application that will be executed when the action is invoked.
You can add one or more attribute field values as arguments to the application.
When the action is invoked any set of characters that start with a \code{\%}
followed by the name of a field will be replaced by the value of that field.
The special characters \index{\%\%}\%\% will be replaced by the value of the field
that was selected from the identify results or attribute table (see {\hyperref[docs/user_manual/working_with_vector/vector_properties:using-actions]{using\_actions}}
below). Double quote marks can be used to group text into a single argument to
the program, script or command. Double quotes will be ignored if preceded by a
backslash.

Se você tem os nomes de campo que são substrings de outros nomes de campo (por exemplo,{}`{}` col1{}`{}` e \code{col10} ), você deve indicar, cercando o nome do campo (e do \%caráter) entre colchetes (por exemplo, \code{{[}\%col10{]}} ). Isso impedirá que o campo com nome \code{\%Col10} seja confundido com o campo de nome \code{\%col1} com um 0 no final. Os suportes serão removidos por QGIS quando se substitui no valor do campo. Se você deseja que o campo substituído seja cercado por colchetes, utilizar um segundo conjunto da seguinte maneira: \code{{[}{[}\% Col10{]}{]}}.

Using the \emph{Identify Features} tool you can open \emph{Identify Results}
dialog. It includes a \emph{(Derived)} item that contains information relevant to the
layer type. The values in this item can be accessed in a similar way to the other
fields by using preceeding the derived field name by \code{(Derived).}. For example,
a point layer has an \code{X} and \code{Y} field and the value of these can be used in
the action with \code{\%(Derived).X} and \code{\%(Derived).Y}. The derived attributes
are only available from the \emph{Identify Results} dialog box, not the
\emph{Attribute Table} dialog box.

Two \index{example actions}example actions are shown below:
\begin{itemize}
\item {} 
\code{konqueror http://www.google.com/search?q=\%nam}

\item {} 
\code{konqueror http://www.google.com/search?q=\%\%}

\end{itemize}

No primeiro exemplo o navegador Konqueror é acionado e passa a abrir uma URL. A URL executa uma pesquisa no Google sobre o valor do campo \code{nam} de nossa camada vetorial. Note que a aplicaçao ou script acionado pela ação deve estar no caminho ou você deve fornecer o caminho completo.  Para ter certeza, poderíamos reescrever o primeiro exemplo como:{}`{}` / opt/kde3/bin/konqueror \href{http://www.google.com/search?q}{http://www.google.com/search?q} =\% nam{}`{}`.    Isto irá assegurar que a aplicação konqueror será executado quando a ação é invocado.

O segundo exemplo utiliza a notação \% \% que não depende de um campo específico para o seu valor. Quando a ação é invocada, o \% \% será substituído pelo valor do campo selecionado na identificação de resultados ou na tabela de atributos.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:using-actions}
** Utilizando Ações **

Actions can be invoked from either the \emph{Identify Results} dialog,
an \emph{Attribute Table} dialog or from \emph{Run Feature Action}
(recall that these dialogs can be opened by clicking \includegraphics[width=1.5em]{mActionIdentify.png}
$^{\text{Identify Features}}$ or \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Open Attribute Table}}$ or
\includegraphics[width=1.5em]{mAction.png} $^{\text{Run Feature Action}}$). To invoke an action, right
click on the record and choose the action from the popup menu. Actions are
listed in the popup menu by the name you assigned when defining the actions.
Click on the action you wish to invoke.

Se você está invocando uma ação que usa a notação\%\%, clique com o botão direito sobre o valor do campo no painel :guilabel: \emph{Identificar resultados} ou na \emph{Tabela Atributo} que você deseja passar para o aplicativo ou script.

Aqui está outro exemplo que puxa os dados de uma camada vetorial e os insere em um arquivo usando o bash e o comando{}`{}`eco{}`{}` (por isso só vai funcionar no\textbar{}nix\textbar{} ou talvez no\textbar{}osx\textbar{}). A camada em questão tem campos para um nome da espécie \code{taxon\_name} , latitude \code{lat} e longitude \code{long} . Eu gostaria de ser capaz de fazer uma seleção espacial das localidades e exportar esses campos de valores em um arquivo de texto para o registro selecionado (mostrado em amarelo na área do mapa do QGIS). Aqui é a ação para atingir este objectivo:

\begin{Verbatim}[commandchars=\\\{\}]
bash -c "echo \PYGZbs{}"\%taxon\_name \%lat \%long\PYGZbs{}" \textgreater{}\textgreater{} /tmp/species\_localities.txt"
\end{Verbatim}

Depois de selecionar algumas localidades e executar a ação em cada um, a abertura do arquivo de saída irái mostrar algo como isto:

\begin{Verbatim}[commandchars=\\\{\}]
Acacia mearnsii -34.0800000000 150.0800000000
Acacia mearnsii -34.9000000000 150.1200000000
Acacia mearnsii -35.2200000000 149.9300000000
Acacia mearnsii -32.2700000000 150.4100000000
\end{Verbatim}

Como um exercício, criamos uma ação que faz uma pesquisa no Google sobre o a camada \code{lagos}. Primeiro, precisamos determinar o URL necessário para realizar uma pesquisa sobre a palavra-chave. Isso póde ser realizado facilmente indo ao Google e realizando uma pesquisa simples, em seguida, pegar a URL na barra de endereços do seu navegador. A partir deste pequeno esforço, vemos que o formato é: \href{http://google.com/search?q=qgis}{http://google.com/search?q=qgis} , onde QGIS é o termo de pesquisa. Armado com esta informação, podemos prosseguir:
\begin{enumerate}
\item {} 
Verifique se a camada \code{lagos} está carregada.

\item {} 
Open the \emph{Layer Properties} dialog by double-clicking on the
layer in the legend or right-click and choose \emph{Properties}
from the popup menu.

\item {} 
Click on the \emph{Actions} tab.

\item {} 
Digite um nome para a ação, por exemplo {}`{}` Google Search {\color{red}\bfseries{}{}`{}`}.

\item {} 
Para a ação, precisamos fornecer o nome do programa externo a ser executado. Neste caso, podemos usar o Firefox. Se o programa não estiver em seu caminho, você precisará fornecer o caminho completo.

\item {} 
Seguindo o nome da aplicação externa, adicione a URL usada para fazer uma pesquisa no Google,  mas não inclua o termo de busca: {}`{}` \href{http://google.com/search}{http://google.com/search}?q={}`{}`

\item {} 
O texto no campo de ação será mostrado como este: {}`{}` firefox \href{http://google.com/search?q}{http://google.com/search?q} ={}`{}`

\item {} 
Click on the drop-down box containing the field names for the \code{lakes}
layer. It's located just to the left of the \textbf{{[}Insert Field{]}} button.

\item {} 
From the drop-down box \emph{The valid attribute names for this layer}
\includegraphics{selectstring.png} select `NAMES' and click \textbf{{[}Insert Field{]}}.

\item {} 
Your action text now looks like this: \code{firefox http://google.com/search?q=\%NAMES}

\item {} 
Para finalizar a ação clique no botão** {[}Inserir ação{]} {\color{red}\bfseries{}**}.

\end{enumerate}

A ação é completada e está pronta para usar. O texto final da ação deve ser semelhante a este:
\begin{quote}

\code{firefox http://google.com/search?q=\%NAMES}
\end{quote}

Agora podemos utilizar a ação. Feche a: aba de diálogo: `Propriedades da camada {}` e aplique um zoom em uma área de interesse. Certifique-se que a camada \code{lagos} está ativa e identifique um lago. Na caixa o resultado que você poderá visualizar que a nossa ação está visível:
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-actions-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{action_identifyaction.png}
\caption{Select feature and choose action \includegraphics[width=1em]{nix.png}}\end{figure}

Quando clicamos sobre a ação, ela faz o Firefox e navegar para o URL \href{http://www.google.com/search?q=Tustumena}{http://www.google.com/search?q=Tustumena}. Também é possível adicionar outros campos de atributo para essa açao. Para isso basta um + ao final do texto de ação, selecionar outro campo e clicar em \textbf{{[}Inserir Campo)}. Nesse exemplo não temos outro campo disponível para efetuarmos a busca.

Você pode definir múltiplas ações para uma camada e cada uma vai aparecer na caixa de diálogo: guilabel: \emph{Identificar resultados}.

Você pode pensar em todos os tipos de usos para as ações. Por exemplo, se você tem uma camada de pontos que contém as localizações de imagens ou fotos, juntamente com um nome de arquivo, você pode criar uma ação para lançar um visualizador para exibir a imagem. Você também pode usar ações para lançar relatórios baseados na web para um campo de atributo ou combinação de campos, especificando-as da mesma forma que fizemos no nosso exemplo de busca Google.

Nós também podemos fazer exemplos mais complexos, por exemplo, sobre como usar ações em ** Python {\color{red}\bfseries{}**}.

Normalmente, quando nós criamos uma ação para abrir um arquivo com uma aplicação externa, podemos usar caminhos absolutos, ou, eventualmente, caminhos relativos, no segundo caso, o caminho é relativo ao local do arquivo executável do programa externo. Mas quando, precisamos usar caminhos relativos, em relação à camada selecionada (um arquivo com base um, como um shapefile ou SpatiaLite)? O código a seguir irá fazer o truque:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{command} \PYG{o}{=} \PYG{l+s}{\PYGZdq{}}\PYG{l+s}{firefox}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{imagerelpath} \PYG{o}{=} \PYG{l+s}{\PYGZdq{}}\PYG{l+s}{images\PYGZus{}test/test\PYGZus{}image.jpg}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{layer} \PYG{o}{=} \PYG{n}{qgis}\PYG{o}{.}\PYG{n}{utils}\PYG{o}{.}\PYG{n}{iface}\PYG{o}{.}\PYG{n}{activeLayer}\PYG{p}{(}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{os.path}\PYG{p}{;}
\PYG{n}{layerpath} \PYG{o}{=} \PYG{n}{layer}\PYG{o}{.}\PYG{n}{source}\PYG{p}{(}\PYG{p}{)} \PYG{k}{if} \PYG{n}{layer}\PYG{o}{.}\PYG{n}{providerType}\PYG{p}{(}\PYG{p}{)} \PYG{o}{==} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{ogr}\PYG{l+s}{\PYGZsq{}} \PYG{k}{else} \PYGZbs{}
\PYG{p}{(}\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{core}\PYG{o}{.}\PYG{n}{QgsDataSourceURI}\PYG{p}{(}\PYG{n}{layer}\PYG{o}{.}\PYG{n}{source}\PYG{p}{(}\PYG{p}{)}\PYG{p}{)}\PYG{o}{.}\PYG{n}{database}\PYG{p}{(}\PYG{p}{)} \PYGZbs{}
\PYG{k}{if} \PYG{n}{layer}\PYG{o}{.}\PYG{n}{providerType}\PYG{p}{(}\PYG{p}{)} \PYG{o}{==} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{spatialite}\PYG{l+s}{\PYGZsq{}} \PYG{k}{else} \PYG{n+nb+bp}{None}\PYG{p}{)}\PYG{p}{;}
\PYG{n}{path} \PYG{o}{=} \PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{dirname}\PYG{p}{(}\PYG{n+nb}{str}\PYG{p}{(}\PYG{n}{layerpath}\PYG{p}{)}\PYG{p}{)}\PYG{p}{;}
\PYG{n}{image} \PYG{o}{=} \PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{join}\PYG{p}{(}\PYG{n}{path}\PYG{p}{,}\PYG{n}{imagerelpath}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{subprocess}\PYG{p}{;}
\PYG{n}{subprocess}\PYG{o}{.}\PYG{n}{Popen}\PYG{p}{(} \PYG{p}{[}\PYG{n}{command}\PYG{p}{,} \PYG{n}{image} \PYG{p}{]} \PYG{p}{)}\PYG{p}{;}
\end{Verbatim}

Temos que basta lembrar que a ação é um dos tipo * Python * e pode ser modificada as variáveis no * comando * e * imagerelpath * ​​para atender as necessidades.

Mas o que dizer se o caminho relativo precisa ser relativo ao arquivo de projeto (salvo)? O código da ação Python seria:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{command}\PYG{o}{=}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{firefox}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{imagerelpath}\PYG{o}{=}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{images/test\PYGZus{}image.jpg}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{projectpath}\PYG{o}{=}\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{core}\PYG{o}{.}\PYG{n}{QgsProject}\PYG{o}{.}\PYG{n}{instance}\PYG{p}{(}\PYG{p}{)}\PYG{o}{.}\PYG{n}{fileName}\PYG{p}{(}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{os.path}\PYG{p}{;} \PYG{n}{path}\PYG{o}{=}\PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{dirname}\PYG{p}{(}\PYG{n+nb}{str}\PYG{p}{(}\PYG{n}{projectpath}\PYG{p}{)}\PYG{p}{)} \PYGZbs{}
\PYG{k}{if} \PYG{n}{projectpath} \PYG{o}{!=} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{\PYGZsq{}} \PYG{k}{else} \PYG{n+nb+bp}{None}\PYG{p}{;}
\PYG{n}{image}\PYG{o}{=}\PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{join}\PYG{p}{(}\PYG{n}{path}\PYG{p}{,} \PYG{n}{imagerelpath}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{subprocess}\PYG{p}{;}
\PYG{n}{subprocess}\PYG{o}{.}\PYG{n}{Popen}\PYG{p}{(} \PYG{p}{[}\PYG{n}{command}\PYG{p}{,} \PYG{n}{image} \PYG{p}{]} \PYG{p}{)}\PYG{p}{;}
\end{Verbatim}

Outro exemplo de  ações usando Python  nos permite adicionar novas camadas ao projeto. O exemplo a seguir,por exemplo, irá adicionar ao projeto um vetor e raster , respectivamente,. O nome dos arquivos a serem adicionados ao projeto e o nome a ser dado à camada são controlados aos dados(\emph{filename} e \emph{layname} são o nome das colunas da tabela de atributo do vetor onde a ação será criada):

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{utils}\PYG{o}{.}\PYG{n}{iface}\PYG{o}{.}\PYG{n}{addVectorLayer}\PYG{p}{(}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{/yourpath/[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{filename}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{].shp}\PYG{l+s}{\PYGZsq{}}\PYG{p}{,}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{layername}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{]}\PYG{l+s}{\PYGZsq{}}\PYG{p}{,} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{ogr}\PYG{l+s}{\PYGZsq{}}\PYG{p}{)}
\end{Verbatim}

Para adicionar um raster (uma imagem tif, neste exemplo) utiliza-se:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{utils}\PYG{o}{.}\PYG{n}{iface}\PYG{o}{.}\PYG{n}{addRasterLayer}\PYG{p}{(}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{/yourpath/[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{filename}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{].tif}\PYG{l+s}{\PYGZsq{}}\PYG{p}{,}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{layername}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{]}\PYG{l+s}{\PYGZsq{}}\PYG{p}{)}
\end{Verbatim}


\subsection{Aba Ligações}
\label{docs/user_manual/working_with_vector/vector_properties:joins-tab}\label{docs/user_manual/working_with_vector/vector_properties:sec-joins}
\includegraphics[width=2em]{join.png} A guia {\color{red}\bfseries{}:Uniões:{}`Joins{}`} permite que você realize a \index{união de tabelas de atributos carregadas previamente ao projeto e carregalas a sua camada vetorial}união de tabelas de atributos carregadas previamente ao projeto e carregalas a sua camada vetorial. Você necessita definir as colunas chaves para \index{unir camadas}unir camadas, unir campo e campo alvo. O QGIS atualmente suporta a união de tabelas em formato não espacial suportados pelo OGR,texto delimitado e provenientes do PostgreSQL (Veja {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-joins-1]{figure\_joins\_1}}).
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-joins-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{join_attributes.png}
\caption{Join an attribute table to an existing vector layer \includegraphics[width=1em]{nix.png}}\end{figure}

Adicionalmente, o adicionar ligação de vetor  permite:
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Cache join layer in virtual memory}

\item {} 
\includegraphics{checkbox.png} \emph{Create attribute index on the join field}

\end{itemize}


\subsection{Diagrams Tab}
\label{docs/user_manual/working_with_vector/vector_properties:diagrams-tab}\label{docs/user_manual/working_with_vector/vector_properties:sec-diagram}
\includegraphics[width=2em]{diagram.png} The \emph{Diagrams} tab allows you to add a graphic overlay to a
vector layer (see {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-diagrams-1]{figure\_diagrams\_1}}).

The current core implementation of diagrams provides support for piecharts
and text diagrams. Text values ​​of different data columns are displayed one
below the other with a circle or a box and dividers. Diagram size is based
on a fixed size or on linear scaling according to a classification attribute.
The placement of the diagrams interacts with the new labeling, so position
conflicts between diagrams and labels are detected and solved. In addition
to chart positions can be fixed by the users hand.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-diagrams-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{diagram_tab.png}
\caption{Vector properties dialog with diagram tab \includegraphics[width=1em]{nix.png}}\end{figure}

We will demonstrate an example and overlay the alaska boundary layer a
text diagram showing some temperature data from a climate vector layer.
Both vector layers are part of the QGIS sample dataset (see Section
{\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dados de exemplo}}}).
\begin{enumerate}
\item {} 
Primeiro clique no ícone \textbar{} mActionAddOgrLayer {\color{red}\bfseries{}\textbar{}}: \emph{Adicionar Camada Vetorial} , procure nos exemplos da  pasta conjunto de dados de amostra e carregue as duas camadas de arquivo vetorial: arquivo: \emph{alaska.shp} e: arquivo: \emph{climate.shp}.

\item {} 
Dê um clique duplo na camada \code{clima} na legenda do mapa para abrir a aba de diálogo `Propriedades da camada {\color{red}\bfseries{}{}`}.

\item {} 
Click on the \emph{Diagrams} tab, activate \emph{Display diagrams}
and from \emph{Diagram type} \includegraphics{selectstring.png} combobox select `Text diagram'

\item {} 
As Background color we choose a light blue and set a fixed size to 18 mm.

\item {} 
Placement could be set to AroundPoint.

\item {} 
No diagrama procuramos exibir os valores das três colunas {}`{}` T\_F\_JAN {\color{red}\bfseries{}{}`{}`}, {}`{}` T\_F\_JUL {}`{}` e {}`{}` {}`{}` T\_F\_MEAN. Primeiro selecione {}`{}` T\_F\_JAN {}`{}` como atributo e clique no botão verde ** {[}+{]} ** , então {}`{}` T\_F\_JUL {}`{}` e {}`{}` {}`{}` finalmente T\_F\_MEAN.

\item {} 
Now click \textbf{{[}Apply{]}} to display the diagram in the QGIS main window.

\item {} 
You can now adapt the chart size, or change the attribute colors by double
clicking on the color values in the attribute field. {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-diagrams-2]{Figure\_diagrams\_2}}
gives an impression.

\item {} 
Finalmente, clique em \textbf{{[}Ok{]}}.

\end{enumerate}
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-diagrams-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{climate_diagram.png}
\caption{Diagram from temperature data overlayed on a map \includegraphics[width=1em]{nix.png}}\end{figure}

Additionally in the \emph{Settings \(\rightarrow\) Options} dialog, there is a
\code{Overlay} tab where it is possible to select the placement algorithm of the diagrams.
The central point method is a generic one, the others use algorithms of the PAL library.
They also consider diagram objects and labels in different layers. Also see section
{\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay]{\emph{Diagram Overlay Plugin}}} for additional diagram features.


\section{Edição}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:editing}\label{docs/user_manual/working_with_vector/editing_geometry_attributes::doc}
QGIS supports various capabilities for \index{editing}editing OGR, PostGIS and
SpatiaLite vector layers.

\begin{notice}{note}{Nota:}
The procedure for editing GRASS layers is different - see Section
{\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Digitalizando e editando uma camada vetorial GRASS}}} for details.
\end{notice}
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-concurrent-edits}
\begin{notice}{tip}{Dica:}
Edição  em uso corrente

Esta versão do QGIS não segue o mesmo caminho caso alguém mais estiver editando uma feição ao mesmo tempo que a edição que você estiver fazendo. No caso a ultima pessoa a salvar sua edição é a que estará habilitada ou dada como salvo pelo programa.
\end{notice}

\index{Snapping}\index{Snapping\_Tolerance}

\subsection{Definir o valor de  tolerância de proximidade para buscar apartir do raio}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:snapping-tolerance}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:setting-the-snapping-tolerance-and-search-radius}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-1}
Antes de editar os vértices , devemos definir a tolerância de proximidade e valores  de raio de que nos permitam uma ótimização na  edição das  geometrias  e das camadasvetoriais .


\subsubsection{Tolerância de Proximidade}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:id1}
A tolerância de Proximidade e a distancia que o QGIS utiliza  para procurar o vértice mais proximo  e /ou seguimento  que se deseja conectar quando você estabelecer um novo vértice ou mover um vértice já existente. Se não estiver nos limites de tolerância o QGIS vai posicionar o vértice onde o botão do mouse for solto, ao invés de aproximá-lo a um vértice e/ ou seguimento já existente. A configuração da tolerância de proximidade influência todas as ferramentas que trabalham com  tolerância.
\begin{enumerate}
\item {} 
A general, project wide snapping tolerance can be defined choosing
\emph{Settings \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options}.
On Mac: go to \emph{QIS \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png}
\emph{Preferences...}, on Linux: \emph{Edit \(\rightarrow\)}
\includegraphics[width=1em]{mActionOptions.png} \emph{Options}. In the \emph{Digitizing}
tab you can select between to vertex, to segment or to vertex and segment
as default snap mode. You can also define a default snapping tolerance and
a search radius for vertex edits. The tolerance an be set either in map
units or in pixels. The advantage of choosing pixels, is that the snapping
tolerance doesn't have to be changed after zoom operations. In our small
digitizing project (working with the Alaska dataset), we define the
snapping units in feet. Your results may vary, but something on the order
of 300ft should be fine at a scale of 1:10 000 should be a reasonable
setting.

\item {} 
A layer based snapping tolerance can be defined by choosing
\emph{Settings \(\rightarrow\)} (or \emph{File \(\rightarrow\)})
\emph{Snapping options...} to enable and adjust snapping mode
and tolerance on a layer basis (see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-1]{figure\_edit\_1}} ).

\end{enumerate}

Note that this layer based snapping overrides the global snapping option
set in the Digitizing tab. So if you need to edit one layer, and snap its
vertices to another layer, then enable snapping only on the \code{snap to}
layer, then decrease the global snapping tolerance to a smaller value.
Furthermore, snapping will never occur to a layer which is not checked in
the snapping options dialog, regardless of the global snapping tolerance.
So be sure to mark the checkbox for those layers that you need to snap to.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{editProjectSnapping.png}
\caption{Edit snapping options on a layer basis \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Search\_Radius}

\subsubsection{Pesquisa de Raio}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:search-radius}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-2}
Pesquisa de raio e a diatancia que o QGIS utiliza para buscar o vertice mais proximo quendo você clica no mapa. Caso não esteja dentro dos limites da pesquisa de raio, o QGIS  não encontrará e não selecionará nenhum vértice para edição e irá notificar com um aviso de alerta Tolerância de aproximar e pesquisa de raio são definidas em unidades do mapa ou em pixel, então pode ser necessário experimentar ambas para definir a utilização apropriada. Especificando uma tolerância muito grande o  QGIS  poderá aproximar a um vértice errado, especialmente se o número de vértice em que esteja trabalhando estiver em grande número e muito próximo um do outro. Definindo uma pesquisa de raio muito pequena pode não encontrar nada para mover.

A pesquisar o raio para edição de vértice em unidades da camada pode ser definida na aba Digitalizar em Configurações --\textgreater{} Opções  mesmo local onde é definido a forma geral de tolerância de proximidade do projeto.

\index{Zoom\_In Zoom\_Out}\index{Pan}\index{Map\_Navigation}

\subsection{Ampliação e Visão panorâmica}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:zooming-and-panning}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-3}
Antes de editar uma camada você deve ampliar a sua área de interesse. Isso evita a espera, enquanto todos os marcadores de vértice são renderizadospor toda camada.

Alem de usar o {\color{red}\bfseries{}\textbar{}mAaction\textbar{}}  sup: Panorâmica e \includegraphics[width=1.5em]{mActionZoomIn.png} Sup Aproximar / \includegraphics[width=1.5em]{mActionZoomOut.png}  Afastar  ícones da barra de ferramentas com o mouse, a navegação pode ser feito também com a rolagem do mouse, as setas ea barra de espaço.


\subsubsection{Zoom e Viisão panorâmica com a rolagem do mouse}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:zooming-and-panning-with-the-mouse-wheel}
No processo de Digitalização é possível utilizar o mouse clicand clicando e arrastando a visualização panorâmica e também utilizar o recurso de rolagem do mouse para aproximar e afastar a visualização do mapa. Para aproximar o local posicione o cursor do mouse na área do mapa e gire a rolagem para frente para aproximar e para trás para afastar. A posição do cursor do mouse será o ponto central da área de interesse ampliada. É possível também customizar o comportamento da ação da roda do mouse utilizando; Ferramentas de Mapa no :menuselection: Configurações ----\textgreater{} {}` \includegraphics[width=1em]{mActionOptions.png} :menuselection: Opções.


\subsubsection{Panaramica com as teclas de Seta}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:panning-with-the-arrow-keys}
Panning the map during digitizing is possible with the arrow keys.
Place the mouse cursor inside the map area and click on the right arrow key
to pan east, left arrow key to pan west, up arrow key to pan north and down
arrow key to pan south.

Você também pode usar a barra de espaço para fazer com que temporariamente o mouse para mover então Movimentos mapa. Aa teclas PgUp  e  PgDown do teclado  fazem a exibição para aproximar ou afastar sem interromper a digitalização.

\index{Topological\_Editing}

\subsection{Edição Topológica}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-4}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:topological-editing}
Além de opções de alinhamento baseados camada também pode definir algumas funcionalidades topológicas na aba Opções de  Proximidade.... Caixa de dialogo . menuselection: Configurações (ou menuselection: Arquivo ) Menu . Você pode Definir  na\textbar{} caixa de seleção\textbar{}  Na aba  Habiliar edição topológica e /ou  para as camadas de polígonos, você pode ativar a coluna \textbar{} caixa de seleção\textbar{} Na Aba Evitar int  o que evita a intersecção de novos polígonos.

\index{Shared\_Polygon\_Boundaries}

\subsubsection{Ativar a edição topologica}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-5}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:enable-topological-editing}
A opção \includegraphics{checkbox.png}.Na aba: Habilitar edição topológica  serve para editar e limites em comum em um mosaico de polígonos. O QGIS detecta um limite em comum em um mosaico de polígono sendo somente necessário mover o vértice enquanto o QGIS toma conta em atualizar o outros limites.

\index{Avoid\_Intersections\_Of\_Polygons}

\subsubsection{Evitando Intersecção de novos  polígonos.}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:avoid-intersections-of-new-polygons}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-6}
A segunda opção topológica chamada \includegraphics{checkbox.png} :guilabel:{\color{red}\bfseries{}{}`}Avoid Int. Coluna evita sobreposição no mosaico de polígonos. É um bom recurso para digitalização rápida de polígonos adjacentes. Caso já exista no projeto um polígono é possível, com esta função, digitalizar o segundo fazendo com que ambos se intersectem e o QGIS “corta” o segundo para um limite em comum com o primeiro. A vantagem esta em os usuários não precisarem digitalizar todos os vértices do limite comum.

\index{Digitizing}

\subsection{Digitalizando uma Camada Vetorial Existente}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:digitizing-an-existing-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-7}
Como padrão o QGIS carrega camadas somente para leitura, isto é uma forma de segurança evitando a edição acidental de uma camada com o deslize do mouse. De qualquer forma, é possível escolher a edição de qualquer camada contanto que o arquivo fornecido seja suportado e (se o arquivo não for somente leitura). A edição da camada é mais versátil quando for utilizado base de dados PostgreSQL/PostGIS.

Em geral a edição de camadas vetoriais é dividida em uma barra de digitalização e uma barra de Ferramentas avançadas  descrita na seção .ref:sec\_advanced\_edit. Você poderá selecionar e desmarcar tanto em:menuselection:{\color{red}\bfseries{}{}`}Configurações --\textgreater{} Barra de Ferramentas --\textgreater{}  Usando as ferramentas de digitalização básicas que você pode realizar as seguintes funções:
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:table-editing}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Ícone
} & \textsf{\relax 
Função
} & \textsf{\relax 
Ícone
} & \textsf{\relax 
Função
}\\
\hline
\includegraphics[width=1.5em]{mActionToggleEditing.png}
 & 
Alternar Edição
 & 
\includegraphics[width=1.5em]{mActionToggleEditing.png}
 & 
Adicionar feições: captura de ponto
\\

\includegraphics[width=1.5em]{mActionCaptureLine.png}
 & 
Adicionar feições: captura de linha
 & 
\includegraphics[width=1.5em]{mActionCapturePolygon.png}
 & 
Adicionar feições: captura de polígono
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png}
 & 
Mover feição
 & 
\includegraphics[width=1.5em]{mActionNodeTool.png}
 & 
Ferramenta de nó
\\

\includegraphics[width=1.5em]{mActionDeleteSelected.png}
 & 
Excluir selecionado(s)
 & 
\includegraphics[width=1.5em]{mActionEditCut.png}
 & 
Recortar feições Recortar feições
\\

\includegraphics[width=1.5em]{mActionEditCopy.png}
 & 
Copiar feições
 & 
\includegraphics[width=1.5em]{mActionEditPaste.png}
 & 
Colar feições
\\

\includegraphics[width=1.5em]{mActionFileSave.png}
 & 
Salvar alterações
 &  & \\
\hline\end{tabulary}

\begin{quote}

Tabela de Edição: Barra de ferramentas básicas de edição vetorial.
\end{quote}

All editing sessions start by choosing the \includegraphics[width=1.5em]{mActionToggleEditing.png}
$^{\text{Toggle editing}}$ option. This can be found in the context menu
after right clicking on the legend entry for that layer.

Como uma forma alternativa é possível usar o botão Alternar Edição  \includegraphics[width=1.5em]{mActionToggleEditing.png} :sup: Alternar edição da barra de digitalização para começar ou para sair do modo de edição. Uma vez que a camada estiver em modo de edição marcadores irão aparecer nos vértices e botões adicionais na barra de edição estarão disponíveis para o uso.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-save-regularly}
\begin{notice}{tip}{Dica:}
\textbf{Salvar Regularmente}

Lembre-se de clicar em  \includegraphics[width=1.5em]{mActionFileSave.png} :sup:{\color{red}\bfseries{}{}`}Salvar Edição regularamente {\color{red}\bfseries{}{}`}permitindo que as alterações recentes sejam salvas, e também confirmando que a fonte de dados aceite todas as alterações.
\end{notice}


\subsubsection{Adicionando Feições}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:adding-features}
Você podera utilizar os icones  \includegraphics[width=1.5em]{mActionCapturePoint.png}:sup  Adicionar Recurso , \includegraphics[width=1.5em]{mActionCaptureLine.png} :sup:{\color{red}\bfseries{}{}`}Adicionar Recurso  ou  \includegraphics[width=1.5em]{mActionCapturePolygon.png} :sup:{\color{red}\bfseries{}{}`}Adicionar Recurso  os icones da barra de ferramentas para colocar o curso do  QGIS em modo de digitalização.

Para cada feição é necessário primeiro digitalizar a geometria para então inserir os atributos. Para digitalizar a geometria, clique com o botão esquerdo do mouse na área do mapa para criar o ponto inicial da sua nova feição.

For lines and polygons, keep on left-clicking for each additional point you
wish to capture. When you have finished adding points, right-click anywhere
on the map area to confirm you have finished entering the geometry of that
feature.

A janela de atributos seja exibida, permitindo que seja inserido as informações para a nova feição. Figure\_edit\_2\_mostrar a configuração de atributos de um novo rio fictício no Alasca Na Aba  Dgitalizar no menu menuselection: Configurações --\textgreater{} Opções e é possível também habilitar  \includegraphics{checkbox.png} :guilabel:Suprimir atributos de janelas pop-up depois de cada feição criada  \includegraphics{checkbox.png} :guilabel:Reutilizar último valor de atributo inscrito
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{editDigitizing.png}
\caption{Enter Attribute Values Dialog after digitizing a new vector
feature \includegraphics[width=1em]{nix.png}}\end{figure}

Com o ícone \includegraphics[width=1.5em]{mActionMoveFeature.png}:sup: Mover Feição da barra de ferramentas é possível movimentar as feições existentes.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-attributes-types}
\begin{notice}{tip}{Dica:}
\textbf{Tipos de valores de atributos}

For editing the attribute types are validated during
the entry. Because of this, it is not possible to enter a number into
the text-column in the dialog \emph{Enter Attribute Values} or vice
versa. If you need to do so, you should edit the attributes in a second
step within the \emph{Attribute table} dialog.
\end{notice}

\index{Node\_Tool}

\subsubsection{Ferramenta de nó}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-9}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:node-tool}
Tanto para PostgreSQL/PostGIS quanto para camadas base em arquivo shape, a \includegraphics[width=1.5em]{mActionNodeTool.png} :sup:{\color{red}\bfseries{}{}`}Ferramenta de Nós possui a capacidade para manipular os vértices das feições de uma forma similar aos programas de CAD. É possível de uma forma simples selecionar múltiplos vértices de uma única vez e movimentá-los, adicionar ou excluí-los todos juntos. A ferramenta de nós opera também com a projeção “on the fly” ligada e suporta a edição topológica de feições. Esta ferramenta é, ao contrário de outras ferramentas no QGIS, permanente, então quando alguma operação for executada, a seleção continua ativada para esta feição e ferramenta. Caso a ferramenta de nós não encontrar nenhuma feição um aviso sera exibido.

É importante selecionar as propriedades :menuselection:{\color{red}\bfseries{}{}`}Configurações --\textgreater{} \includegraphics[width=1em]{mActionOptions.png} :menuselection: Opções--\textgreater{}  :guilabel:Encontrar Raio\textbar{}selectnumber\textbar{}para um número maior que zero.(i.e. 10).De outra forma o QGIS não estará apto a informar qual o vértice está sendo editado.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-vertex-markers}
\begin{notice}{tip}{Dica:}
\textbf{Marcadores de Vértice}

A versão atual do QGIS suporta três tipos de marcadores de vértice – Círculo semi transparente , cruz e nenhum. Para alterar o estilo de marcador escolha em \includegraphics[width=1em]{mActionOptions.png} :menuselection:Opções do menu Configurações e Clique na aba Digitalizar e selecione a entrada apropriada.
\end{notice}


\subsubsection{Operações Básicas}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:basic-operations}
\index{Nodes}\index{Vertices}\index{Vertex}
Inicie ativando a\textbar{}mActionNodeTool\textbar{} :sup: Ferramentas de nós e selecionando um recurso clicando sobre ele. Caixas vermelhas aparecerão em cada vértice desse recurso.
\begin{itemize}
\item {} 
\textbf{Selecting vertices}: You can select vertices by clicking on them one
at a time, by clicking on an edge to select the vertices at both ends, or
by clicking and dragging a rectangle around some vertices. When a vertex
is selected its color changes to blue. To add more vertices to the current
selection, hold down the \code{Ctrl} key while clicking. Hold down
\code{Ctrl} or \code{Shift} when clicking to toggle the selection state of
vertices (vertices that are currently unselected will be selected as usual,
but also vertices that are already selected will become unselected).

\item {} 
\textbf{Adicionar vértices:} Para adicionar um vértice basta clicar duas vezes perto de uma borda e um novo vértice aparecerá na borda perto do cursor. Note que o vértice aparece na borda, e não na posição do cursor, por isso, tem de ser transferida, se necessário.

\item {} 
\textbf{Excluir vértices}:Após selecionar vértices para exclusão, clique natecla  :kbd: Delete  Não é possível utilizar a \includegraphics[width=1.5em]{mActionNodeTool.png} :sup: Ferramenta de nós para deletar uma feição completa; QGIS o número mínimo de vértices para o tipo de feição que esteja trabalhando. Para deletar uma feição completa utilize a ferramenta  \includegraphics[width=1.5em]{mActionDeleteSelected.png} :sup:Excluir Seleção.

\item {} 
Mover Vértices:Selecione todos os vértices que desejar mover. Clique em um vértice selecionado ou em uma borda e arraste na direção que desejar movimentar. Todos os vértices selecionados irão ser movimentados juntos. Caso estiver habilitada a seleção toda pode pular para o vértice ou linha mais próximo.

\end{itemize}

Cada alteração executada com a ferramenta de nós sera armazenada como uma entrada separada no diálogo de refazer. Lembre-se que todas as operações suportam a edição topológica quando estiver ligada. A projeção “on the fly” também é suportada e a ferramenta de nós fornece tooltips para identificar um vértice ao passar o ponteiro sobre ele.


\subsubsection{Cortar, Copiar e Colar feições}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:cutting-copying-and-pasting-features}
Feições selecionadas podem ser recortadas, copiadas e coladas entre camadas do mesmo projeto do QGIS contanto que a camada de destino estejam selecionadas como \includegraphics[width=1.5em]{mActionToggleEditing.png} :sup: Alternar edição previamente.

\index{CSV}\index{WKT}
Features can also be pasted to external applications as text: That is, the
features are represented in CSV format with the geometry data appearing in
the OGC Well-Known Text (WKT) format.

However in this version of QGIS, text features from outside QGIS cannot be
pasted to a layer within QGIS. When would the copy and paste function come
in handy? Well, it turns out that you can edit more than one layer at a time
and copy/paste features between layers. Why would we want to do this? Say
we need to do some work on a new layer but only need one or two lakes, not
the 5,000 on our \code{big\_lakes} layer. We can create a new layer and use
copy/paste to plop the needed lakes into it.

Como exemplo,iremos copiar alguns lagos para a nova camada:
\begin{enumerate}
\item {} 
Coloque a camada que você deseja copiar (camada de origem)

\item {} 
Carregar ou criar a camada que você deseja copiar (camada alvo)

\item {} 
Iniciar a edição para a camada alvo

\item {} 
Ative a camada de origem clicando na legenda

\item {} 
Utilize o  \includegraphics[width=1.5em]{mActionSelect.png} :sup: Selecionar uma Feição Simples ferramenta para selecionar o recurso (s) sobre a camada de origem

\item {} 
Clique no  \includegraphics[width=1.5em]{mActionEditCopy.png} :sup: Funções de cópia ferramenta

\item {} 
Faça a camada de destino ativa cilcando sobre a legenda .

\item {} 
Clique no  \includegraphics[width=1.5em]{mActionEditPaste.png}  :sup: Colar Recursos

\item {} 
Para a edição e salvar as alterações

\end{enumerate}

O que acontece se a fonte e alvo de  camadas têm  esquemas diferentes (nomes de campos diferentes e tipos não são a mesma coisa)?\textbar{}qg\textbar{} povoa o que corresponde e ignora o resto.Se você não se importar com os atributos que estão sendo copiados para a camada de destino, não importa como você criar os campos e tipos de dados.Se você quer ter a certeza de que tudo-função e seus atributos-que são copiados, certifique-se que os sistemas correspondem.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-projections-and-pasting}
\begin{notice}{tip}{Dica:}
** Congruência de Recursos colados **

Se a sua fonte e as camadas de destino usar a mesma projeção, então as características colados terá geometria idêntica à camada de origem.No entanto, se a camada de destino é uma projeção diferente, então \textbar{} qg \textbar{} não pode garantir a geometria é idêntica.Isto é simplesmente porque existem pequenos erros de arredondamento envolvidos na conversão entre projeções.
\end{notice}


\subsubsection{Excluindo recursos selecionados}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:deleting-selected-features}
Se deseja excluir um polígono inteiro, nós podemos fazer isso, selecionando primeiro o polígono usando o normalmente \includegraphics[width=1.5em]{mActionSelect.png}:sup: ferramente Seleção de Recurso Único Você pode selecionar vários recursos para a eliminação.Depois de ter o conjunto de seleção, use o \includegraphics[width=1.5em]{mActionDeleteSelected.png} :sup: ferramenta de Excluir  para excluir od recursos.

O \includegraphics[width=1.5em]{mActionEditCut.png} :sup: ferramenta de Recortar feiçõesna barra de ferramentas de digitalização também pode ser utilizado para eliminar características.Isso efetivamente exclui o recurso, mas também coloca-lo em uma ``área de transferência espacial. Então nós cortamos o recurso para excluir. \includegraphics[width=1.5em]{mActionEditPaste.png} :sup:ferramenta de Colar feiçõespara colocá-lo de volta, dando-nos a capacidade de desfazer de um nível.Recortar, copiar e colar os trabalhos sobre as características escolhidas no momento, o que significa que pode operar em mais de um de cada vez.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-deleting-features}
\begin{notice}{tip}{Dica:}
** Suporte Supressão de recursos **

Quando editar arquivo do tipo shape ESRI, a exclusão de feições somente funciona se o QGIS estiver vinculado a uma GDAL versão 1.3.2 ou maior. As versões disponíveis para download OS X e Windows estão elaboradas usando GDAL 1.3.2 ou superior.
\end{notice}


\subsubsection{Salvando Camadas editadas}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:saving-edited-layers}
Quando uma camada estiver em modo de edição, qualquer alteração permanece na memória do QGIS. Portanto não estão imediatamente salvas na fonte de dados ou disco rígido. Caso queira salvar a edição para a camada em uso, mas deseja seguir editando sem sair do modo de edição basta clicar no botão \includegraphics[width=1.5em]{mActionFileSave.png} :sup:Salvar alterações. Quando sair do modo de edição a partir de\textbar{}mActionToggleEditing\textbar{} :sup:{\color{red}\bfseries{}{}`}Alternar edição(ou sair do QGIS), será perguntado se deseja salvar ou  scartar a edição.

If the changes cannot be saved (e.g. disk full, or the attributes have values
that are out of range), the QGIS in-memory state is preserved. This allows
you to adjust your edits and try again.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-data-integrity}
\begin{notice}{tip}{Dica:}
Integridade dos dados

É sempre uma boa ideia fazer um backup de sua fonte de dados antes de iniciar a edição. Enquanto
autores do QGIS fizemos todos os esforços para preservar a integridade de seus dados, não
oferecemos garantia a este respeito.
\end{notice}


\subsection{Digitalização Avançada}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:advanced-digitizing}



\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:table-advanced-editing}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Ícone
} & \textsf{\relax 
Função
} & \textsf{\relax 
Ícone
} & \textsf{\relax 
Função
}\\
\hline
\includegraphics[width=1.5em]{mActionUndo.png}
 & 
Desfazer
 & 
\includegraphics[width=1.5em]{mActionRedo.png}
 & 
Refazer
\\

\includegraphics[width=2em]{mActionSimplify.png}
 & 
Simplificar feições
 & 
\includegraphics[width=2em]{mActionAddRing.png}
 & 
Adicionar anel
\\

\includegraphics[width=2em]{mActionAddIsland.png}
 & 
Adicionar parte
 & 
\includegraphics[width=2em]{mActionDeleteRing.png}
 & 
Excluir anel
\\

\includegraphics[width=2em]{mActionDeletePart.png}
 & 
Excluir Parte
 & 
\includegraphics[width=1.5em]{mActionReshape.png}
 & 
Remodelar Feição
\\

\includegraphics[width=1.5em]{mActionOffsetCurve.png}
 & 
Deslocamento da curva
 & 
\includegraphics[width=1.5em]{mActionSplitFeatures.png}
 & 
Quebrar feições
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png}
 & 
Mesclar feições selecionadas
 & 
{\color{red}\bfseries{}\textbar{}mAçãoRotacionarpontoscomsímbolo\textbar{}}
 & 
Rotacionar pontos com símbolo
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png}
 & 
Mesclar Atributos dos recursos selecionados
 &  & \\
\hline\end{tabulary}

\begin{quote}

Tabela Edição avançada: Barra de ferramentas da edição vetorial avançada
\end{quote}


\subsubsection{Desfazer e Refazer}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:undo-and-redo}
A ferramenta de \includegraphics[width=1.5em]{mActionUndo.png} :sup:Desfazer e  \includegraphics[width=1.5em]{mActionRedo.png} :sup: Refazer permite utilizar as operações de desfazer e refazer nas operações de edição vetorial. . Existe também uma ferramenta acoplável que exibe todas as operações do histórico desfazer/refazer (veja a Figura\_edit\_3) Esta ferramenta não é exibida como padrão do sistema, mas pode ser exibida a partir de um clique direito na barra de ferramentas e ativando a caixa de seleção Desfazer/Refazer. De qualquer forma desfazer/refazer esta ativa mesmo que a ferramenta não seja exibida.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{redo_undo.png}
\caption{Redo and Undo digitizing steps \includegraphics[width=1em]{nix.png}}\end{figure}

Quando desfazer for o estado de todas as feições e atributos serão revertidos para o estado anterior a uma operação acontecer. Modificando outras operações que não forem as normais da adição vetorial (modificações feitas por um complemento por exemplo), podem ou não ser revertidas, dependendo de como as alterações foram executadas.

Para utilizar a ferramenta de histórico do recurso de desfazer/refazer clique para selecionar uma operação na lista de histórico; todas as feições serão revertidas ao estado que estavam depois de a operação selecionada.


\subsubsection{Simplificar feições}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:simplify-feature}
A ferramenta \includegraphics[width=2em]{mActionSimplify.png} :sup: Simplificar Feições permite reduzir o número de vértices de uma feição de uma forma que a geometria não altere. É necessário selecionar a feição, que será destacada por uma banda de cor avermelhada e uma barra deslizante aparecerá. Movendo a barra, a banda vermelha modifica mostrando como a feição será simplificada. Clicando em  \textbf{{[}OK{]}} a nova geometria simplificada será armazenada. Caso a feição não estiver apta a simplificação (Múltiplos polígonos por exemplo) um aviso será exibido.


\subsubsection{Adicionar anel}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:add-ring}
É possível criar polígonos em anel usando o ícone   \includegraphics[width=2em]{mActionAddRing.png} :sup: Adicionar Anel na barra de ferramentas. Isto significa que dentro de uma área existente é possível digitalizar outros polígonos, o que ocorre como um “buraco”, portanto, somente a área entre os limites de outra e dentro de polígonos mantém um polígono de anel.


\subsubsection{Adicionar parte}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:add-part}
Pode-se \includegraphics[width=2em]{mActionAddIsland.png} :sup Adicionar Parte de polígonos a multipolígonos selecionados. A nova parte do polígono precisa ser digitalizada na parte externa do multi polígono selecionado.


\subsubsection{Excluir anel}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:delete-ring}
A ferramenta de \includegraphics[width=2em]{mActionDeleteRing.png} :sup: permite excluir um polígono de anel dentro de uma área existente. Esta Ferramenta funciona somente com camadas de polígonos. A ferramenta pode ser utilizada em feições de polígono ou em multipolígonos, contudo não altera nada quando utilizada no exterior de um polígono. Antes de selecionar os vértices de uma parte, ajuste a tolerância para edição de vértices.


\subsubsection{Excluir Parte}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:delete-part}
A ferramenta \includegraphics[width=2em]{mActionDeletePart.png} :sup:  Excluir Parte permite excluir parte de multi feições(excluir polígonos de uma feição de multi polígonos por exemplo). Entretanto ela não exclui a ultima parte da feição, a ultima parte permanece intocável. Esta ferramenta trabalha com todas as geometrias multi partes de ponto, linha e polígono. Antes de selecionar os vértices de uma parte, ajuste a tolerância para edição de vértices.


\subsubsection{Remodelar Feição}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:reshape-features}
É possível remodelar feições de linha e polígono usando o ícone da barra de ferramentas  \includegraphics[width=1.5em]{mActionReshape.png} :sup: Remodelar Feições Ele substitui parte ma linha ou polígono da primeira a ultima intersecção com a linha original. Em alguns casos com  polígonos pode levar à resultados inesperados. Este recurso é muito útil quando existe a necessidade em substituir pequenas partes de um polígono, não é preciso uma grande reformulação em remodelar linhas entretanto, não é permitido cruzar anel de polígonos originando assim um polígono inválido.

Pode-se, por exemplo, editar limites de um polígono com esta ferramenta. Primeiro, clique dentro de uma área do polígono próximo ao ponto onde deseja-se adicionar o novo vértice. Em seguida cruze o limite e adicione o vértice fora do polígono. Para finalizar dê um clique direito dentro da área do polígono.

\begin{notice}{note}{Nota:}
A ferramenta de remodelar pode alterar a posição de partida de um anel ou de uma linha poligonal fechada. Assim, o ponto representado `duas vezes' não será mais o mesmo. Isto pode não ser um problema para a maioria das aplicações, mas é algo a considerar.
\end{notice}


\subsubsection{A ferramenta de Deslocamento da Curva}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:offset-curves}
The \includegraphics[width=1.5em]{mActionOffsetCurve.png} $^{\text{Offset Curve}}$ tool is a new editing tool. It
creates parallel shifts of lines and polygon rings. The tool can be applied to
the edited layer (the geometries are modified) or also to background layers
(creates copies of the lines / rings and adds it to the the edited layer). It is
thus ideally suited for the creation of distance line layers.The displacement is
shown at the bottom left of the taskbar.

\index{Split\_Features}

\subsubsection{Quebrar feições}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-14}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:split-features}
Você pode dividir recursos usando o \includegraphics[width=1.5em]{mActionSplitFeatures.png} :sup: Quebrar Feições  ícone na barra de ferramentas. Basta desenhar uma linha através do recurso que você deseja dividir.

\index{Merge\_Selected\_Features}

\subsubsection{Mesclar feições selecionadas}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:merge-selected-features}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-15}
A  Ferramenta  \includegraphics[width=1.5em]{mActionMergeFeatures.png} :sup: Mesclar Feições Selecionadas  permite  mesclar características que têm fronteiras comuns e os mesmos atributos.

\index{Merge\_Attributes\_of\_Selected\_Features}

\subsubsection{Mesclar atributos de recursos selecionados}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-16}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:merge-attributes-of-selected-features}
A ferramenta de  \includegraphics[width=1.5em]{mActionMergeFeatures.png} :sup: Mesclar Atributos de Feições Selecionadas permite mesclar atributos de feições com limites e atributos em comum sem mesclar seus limites.

\index{Rotate\_Point\_symbols}

\subsubsection{Rotacionar pontos com símbolo}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:rotate-point-symbols}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-18}
A Ferramenta \includegraphics[width=1.5em]{mActionRotatePointSymbols.png} :sup: Rotacionar Pontos com Símbolos esta em uso atualmente pelo mecanismo da antiga simbologia. Ele permite alterar a rotação de símbolos pontuais na tela do mapa, caso tenha definido na coluna de rotação na tabela de atributos da camada de pontos na aba: Estilo na aba Propriedade da Camada. De outra forma a ferramenta estará inativa.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{rotatepointsymbol.png}
\caption{Rotate Point Symbols \includegraphics[width=1em]{nix.png}}\end{figure}

Para alterar a rotação, selecione uma feição de ponto na tela do mapa e rotacione mantendo pressionado o botão esquerdo do mouse. Uma seta vermelha com um valor de rotação será visualizado (veja a {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-4]{Figura\_4}}). Quando você soltar o botão esquerdo do mouse novamente o valor será atualizado na tabela de atributos.

\begin{notice}{note}{Nota:}
Caso mantenha pressionada a tecla Control a rotação será executada em passos de 15 graus.
\end{notice}

\index{Create\_New\_Layers}\index{New\_Shapefile\_Layer}

\subsection{Creating a new Vector layer}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-create-shape}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:creating-a-new-vector-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-19}
QGIS allows to create new Shapefile layers and new SpatiaLite layers. Creation
of a new GRASS layer is supported within the GRASS-plugin. Please refer to
section {\hyperref[docs/user_manual/grass_integration/grass_integration:creating-new-grass-vectors]{\emph{Criando uma nova camada vetorial GRASS}}} for more information on creating
GRASS vector layers.


\subsubsection{Criando Uma nova Camada do tipo Shape}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:creating-a-new-shapefile-layer}
Para criar uma nova camada Shape para edição, selecione Novo--\textgreater{} \includegraphics[width=1.5em]{mActionNewVectorLayer.png} :menuselection:Camada do tipo Shape...no menu menuselection: Camada  da barra de ferramentas. A caixa de diálogo: Nova Camada Vetorial  será exibida como mostra a {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-5]{Figure\_edit\_5}}. Escolha o tipo de camada (ponto, linha ou polígono) e o SRC (Sistema de Referência de Coordenadas).

Note that QGIS does not yet support creation of 2.5D features (i.e. features
with X,Y,Z coordinates).
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{editNewVector.png}
\caption{Creating a new Shapefile layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Para completar a criação de uma nova camada do tipo shape, adicione os atributos desejados clicando no botão {[}Add{]} e especificando um nome e um tipo para os atributos. A primeira coluna id” é adicionada como padrão mas pode ser removida. Apenas a tributos do Tipo: Número Inteiro \includegraphics{selectstring.png},Tipo:  Número Decimal \includegraphics{selectstring.png}, e :guilabel: Tipo: Dados de texto são suportados. são suportados. Como uma forma adicional e de acordo com o tipo de atributo é possível também definir a espessura e precisão de uma nova coluna de atributos. Satisfeito com os atributos clique em \textbf{{[}ok{]}} forneça um nome para o arquivo Shape QGIS irá automaticamente adicionar a extensão .shp ao nome específico.Uma vez que a camada for criada ela será adicionada ao mapa e é possível editá-la como descrito na seção:ref: sec\_edit\_existing\_layer{}`acima.

\index{New\_Spatialite\_Layer}

\subsubsection{Criando uma nova camada SpatiaLite}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:creating-a-new-spatialite-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:vector-create-spatialite}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-20}
Para criar uma nova camada SpatiaLite para edição, selecione Novo--\textgreater{}  \includegraphics[width=1.5em]{mActionNewVectorLayer.png} :menuselection:Camada SpatiaLite... no menu \emph{Camada{}`da barra de ferramentas. A caixa de diálogo {}`Nova Camada Vetorialr} erá exibida como mostra a  {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-6]{Figure\_edit\_6}}.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{editNewSpatialite.png}
\caption{Creating a New SpatiaLite layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

First step is to select an existing SpatiaLite database or to create a new
SpatiaLite database. This can be done with the browse button \includegraphics{browsebutton.png} to
the right of the database field. Then add a name for the new layer and define
the layer type and the EPSG SRID. If desired you can select to \includegraphics{checkbox.png}
\emph{Create an autoincrementing primary key}.

To define an attribute table for the new SpatiaLite layer, add the names of
the attribute columns you want to create with the according column type and
click on the \textbf{{[}Add to attribute list{]}} button. Once you are happy with the
attributes, click \textbf{{[}OK{]}}. QGIS will automatically add the new layer to the
legend and you can edit it in the same way as described in Section
{\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Digitalizando uma Camada Vetorial Existente}}} above.

Further management of SpatiaLite-Layers can be done with the DB Manager see
{\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Complemento DB Manager}}}.

\index{Work\_with\_Attribute\_Table}

\subsection{Trabalhando com a Tabela de Atributos}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-21}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:working-with-the-attribute-table}
A tabela de atributos exibe feições de uma camada selecionada. Cada linha na tabela de atributos representa uma feição do mapa e cada coluna contém um pouco de informação particular a camada. Feições na tabela podem ser pesquisadas, selecionadas, movimentadas ou mesmo editadas.

Para abrir a tabela de atributos para uma camada vetorial, ative a camada clicando nela na legenda do mapa. Então, a partir do menu principal  :menuselection: \emph{Camada{}`a opção  \textbar{}mActionOpenTable\textbar{} :menuselection:{}`Abrir tabela de atributos{}`do menu. Também é possível, a partir de um clique com o botão direito do mouse sobre a camada e selecionar  \textbar{}mActionOpenTable\textbar{} :menuselection:{}`Abrir tabela de atributos} da janela de menu.

Este procedimento abrirá uma nova janela que exibe as feições doas atributos da camada ({\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-attributes-1]{figure\_attributes\_1}}). O número de feições e o numero de feições selecionadas são mostrados no título da tabela de atributos.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-attributes-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{vectorAttributeTable.png}
\caption{Attribute Table for Alaska layer \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Attribute\_Table\_Selection}

\subsubsection{Selecionar feições na tabela de atributos}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-23}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:selecting-features-in-an-attribute-table}
\textbf{Cada linha selecionada} na tabela de atributos exibe o atributo de uma feição da selecionada na camada. Caso a seleção de feições na janela principal for modificada, a seleção é também atualizada na tabela de atributos. Igualmente, caso a seleção de linhas na tabela de atributos for alterada, a seleção de feições na janela principal será atualizada.

Linhas podem ser selecionadas clicando no número de linhas ao lado esquerdo da linha. \textbf{Múltiplas linhas} podem ser marcadas mantendo pressionada a tecla \code{Control}. A \textbf{seleção Contínua} contínua pode ser executada segurando a tecla :kbd:{\color{red}\bfseries{}{}`}Shift  e clicando em vários cabeçalhos de linha no lado esquerdo da linha. Todas as linhas entre a posição do cursor e a linha são selecionadas. Movimentando a posição do cursor na tabela de atributos, clicando em célula na tabela, não modifica a seleção da linha. Alterando a seleção no menu não movimenta a posição do cursor na tabela de atributos.

A tabela pode ser ordenada por qualquer coluna clicando no cabeçalho da coluna. Uma pequena seta indica o ordenamento (apontando para baixo significa valores decrescentes da linha ao topo para baixo).

For a \textbf{simple search by attributes} on only one column the \emph{Look for}
field can be used. Select the field (column) from which the search should be
performed from the dropdown menu and hit the \textbf{{[}Search{]}} button. The
matching rows will be selected and the total number of matching rows will
appear in the title bar of the attribute table, and in the status bar of
the main window. For more complex searches use the Advanced search button
\includegraphics{browsebutton.png}, which will launch the Search Query Builder described in
Section {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Ferramenta de Consulta}}}.

Para exibir apenas registros selecionados utilize a caixa de seleção  \includegraphics{checkbox.png} \emph{Mostrar apenas selecionado(s)}. Para busca de registros selecionados somente, use a caixa de seleção \includegraphics{checkbox.png} \emph{Buscar  apenas selecionado(s)}. A caixa de seleção  \includegraphics{checkbox.png} :guilabel: :\emph{Sensível ao caractere}. permite selecionar “case sensitive”. Os outros botões no rodapé esquerdo da janela da tabela de atributos proporcionam as seguintes funcionalidades:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Desselecionar tudo}}$ também com \code{Ctrl+U}

\item {} 
\includegraphics[width=1.5em]{mActionSelectedToTop.png} :sup:Mover seleção para o topo também com \code{Ctrl+T}

\item {} 
\includegraphics[width=1.5em]{mActionInvertSelection.png} :sup::\emph{Inverter seleçãotambém com :kbd:{}`Ctrl+S}

\item {} 
\includegraphics[width=1.5em]{mActionCopySelected.png} $^{\text{Copiar linhas selecionadas para área de tranferência}}$ também com \code{Ctrl+C}

\item {} 
\includegraphics[width=1.5em]{mActionZoomToSelected.png} $^{\text{Aproximar o mapa às linhas selecionadas}}$ também com \code{Ctrl+J}

\item {} 
\includegraphics[width=1.5em]{mActionPanToSelected.png} $^{\text{Pan map to the selected rows}}$ also with \code{Ctrl+P}

\item {} 
\includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Toggle editing mode}}$ to edit single values
and to enable functionalities described below also with
\code{Ctrl+E}

\item {} 
\includegraphics[width=1.5em]{mActionDeleteSelected.png} $^{\text{Excluir recursos selecionados}}$ também com \code{Ctrl+D}

\item {} 
\includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Nova coluna{}`para camadas de PostGIS e para as camadas OGR com a versão GDAL\textgreater{} = 1.6 também com  :kbd:{}`Ctrl+W}}$

\item {} 
\includegraphics[width=1.5em]{mActionDeleteAttribute.png} $^{\text{Delete Column}}$ for PostGIS layers and for OGR
layers with GDAL version \textgreater{}= 1.9 also with \code{Ctrl+L}

\item {} 
\includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Abrir Calculadora campo {}`também com :kbd:{}`Ctrl+I}}$

\end{itemize}

\begin{notice}{tip}{Dica:}
\textbf{Ir geometria WKT}

Se você quiser usar os dados de atributos em programas externos (como Excel) utilizar o  botão  \includegraphics[width=1.5em]{mActionCopySelected.png} :sup:{\color{red}\bfseries{}{}`}Copiar linhas selecionadas para clipboard.  Você pode copiar as informações sem geometrias vetoriais, se você desativar  :menuselection:{\color{red}\bfseries{}{}`}Configurações --\textgreater{} Opções --\textgreater{} Guia geral \includegraphics{checkbox.png} :guilabel: Copiar Geometria na representação WKT  representação do atributo {\color{red}\bfseries{}{}`}tabela.
\end{notice}


\subsubsection{Salvar recursos selecionados como nova layer}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:save-selected-features-as-new-layer}
As feições selecionadas podem ser salvas como qualquer formato vetor OGR suportado e também transformado para outro sistema de referência de coordenadas (SRC). Abra o menu da camada com o botão direito do mouse e clique em  menuselection:\emph{Salvar seleção como --\textgreater{}para definir o nome do arquivo de saída, seu formato e CRS  (veja a seção :ref:{}`label\_legend})Também é possível especificar as opções para criação de OGR dentro da caixa de diálogo.

\index{Non\_Spatial\_Attribute\_Tables}

\subsubsection{Trabalhando com tabelas de atributos não espaciais}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:working-with-non-spatial-attribute-tables}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-24}
O QGIS permite também carregar tabelas não espaciais.Isto inclui atuais tabelas suportadas por OGR, textos delimitados e provedor PostgreSQL. As tabelas podem ser usadas para busca de campos ou apenas para pesquisas em geral e editadas usando a visualização da tabela. Quando você carrega a tabela que você vai vê-lo no campo lenda. Ele pode por exemplo ser aberto com o \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Atributo de Tabela Aberta}}$ da ferramenta e, em seguida, é editável como qualquer outra tabela de atributos da camada.

Como exemplo, você pode usar colunas da tabela não espacial para definir valores de atributos ou um intervalo de valores que estão autorizados a ser adicionado a uma camada de vetor específico durante a digitalização. Dê uma olhada na edição de ferramentas na seção {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-attributes-tab]{\emph{Aba Campos}}} para maiores informações.

\index{Query\_Builder}

\section{Ferramenta de Consulta}
\label{docs/user_manual/working_with_vector/query_builder:index-0}\label{docs/user_manual/working_with_vector/query_builder:vector-query-builder}\label{docs/user_manual/working_with_vector/query_builder:query-builder}\label{docs/user_manual/working_with_vector/query_builder::doc}
A Ferramenta de Consulta permite você definir um subgrupo de uma tabela, utilizando cláusulas SQL como WHERE, e exibir o resultado na janela de mapas. O resultado da consulta pode ser salvo como uma nova camada vetorial.


\subsection{Consulta}
\label{docs/user_manual/working_with_vector/query_builder:query}
Open the attribute table choosing \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Open Attribute Table}}$
from the menu bar. Click on the \textbf{{[}Advanced Search{]}} button to open the \emph{Query builder}.
For example, if you have a \code{towns} layer with a \code{population} field you could
select only larger towns by entering \code{population \textgreater{} 100000} in the SQL box of
the Query builder. {\hyperref[docs/user_manual/working_with_vector/query_builder:figure-attributes-2]{Figure\_attributes\_2}} shows an example of the Query builder
populated with data from a PostGIS layer with attributes stored in PostgreSQL.
The Fields, Values and Operators sections help the user to construct the SQL-like
query.
\phantomsection\label{docs/user_manual/working_with_vector/query_builder:figure-attributes-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{queryBuilder.png}
\caption{Query Builder \includegraphics[width=1em]{nix.png}}\end{figure}

A opção \textbf{Campos} contém todas as colunas de atributos pesquisáveis da tabela. Para adicionar uma coluna de atributos ao campo Cláusula onde SQL, clique duplo no nome do. atributo em \textbf{Campos}. Você pode utilizar campos variados, valores e operadores para construir uma consulta ou simplesmente digitá-los.

A \textbf{Lista de Valores} apresenta os valores de um atributo da tabela. Para relacionar todas os valores possíveis de um atributo, selecione o atributo na guia de Campos e clique na opção \textbf{{[}Tudo{]}}. Para relacionar os primeiros 25 valores únicos de uma coluna de atributos, selecione a coluna de atributos na guia Campos e clique em \textbf{{[}Amostra{]}}. Para adicionar um valor à Cláusula onde SQL, clique duplo no valor desejado.

The \textbf{Operators section} contains all usable operators. To add an operator
to the SQL where clause field, click the appropriate button. Relational
operators ( \code{=} , \code{\textgreater{}} , ...), string comparison operator (\code{LIKE}), logical
operators (\code{AND}, \code{OR}, ...) are available.

O botão \textbf{{[}Testar{]}} apresenta um resultado na caixa de mensagem com o número de feições que satisfazem a condição da consulta elaborada. A opção \textbf{{[}Limpar{]}} limpa todo texto da consulta no campo Cláusula onde SQL. As opções \textbf{{[}Salvar{]}} e \textbf{{[}Carregar{]}} permitem armazenar e recuperar consultas SQL. A opção \textbf{{[}OK{]}} confirma a operação, fechando a janela e selecionando as feições que satisfazem a condição da consulta. A opção \textbf{{[}Cancelar{]}} fecha a janela sem alterações na seleção atual.
\phantomsection\label{docs/user_manual/working_with_vector/query_builder:tip-sql-layer-definition}
\begin{notice}{tip}{Dica:}
\textbf{Modificando as definições da Camada}

Você pode alterar as definições de uma camada após seu carregamento a partir de uma consulta SQL utilizada para defini-la. Para isto, abra as \emph{Propriedades da camada} com um clique duplo na camada a ser alterada, e na guia :guilabel: \emph{Geral} clique na \textbf{{[}Ferramenta de Consulta{]}}. Para mais informações, veja a Seção {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog]{\emph{Janela de Propriedades de Vetor}}}.
\end{notice}

\index{Select\_using\_Query}

\subsection{Seleção}
\label{docs/user_manual/working_with_vector/query_builder:selection}\label{docs/user_manual/working_with_vector/query_builder:index-1}\label{docs/user_manual/working_with_vector/query_builder:sec-selection-query}
Com o QGIS, é possível também selecionar feições para visualização utilizando uma interface de consulta semelhante à utilizada na seção {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Ferramenta de Consulta}}}. Na seção acima, o objetivo da ferramenta de consulta é destacar,em amarelo, todas as feições selecionadas pelo critério de filtragem. As demais feições não selecionadas não mudam sua aparência.

Outra possibilidade é fazer uma seleção pelo botão direito sobre a camada da legenda e escolhendo a opção \emph{Pesquisar..}. Se você realizar uma consulta SQL nesta opção, apenas as feições selecionadas são exibidas na janela do mapa. Feições que não atendem à condição da consulta não são exibidas na janela do mapa. A mesma função está disponível na guia \emph{Geral} nas \emph{Propriedades da Camada}. Você pode encontrar a {\color{red}\bfseries{}**}{[}Ferramenta de Consulta{]}**abaixo e à direita da caixa de diálogo. O método de seleção descrito acima pode ser utilizado com todos os formatos de dados vetoriais.


\subsection{Salvar feições selecionadas como uma nova camada}
\label{docs/user_manual/working_with_vector/query_builder:save-selected-features-as-new-layer}
As feições selecionadas podem ser salvas como uma nova camada vetorial, dentre os formatos suportados pelo padrão OGR, podendo também serem transformadas para outro Sistema de Referência de Coordenadas (SRC). Basta clicar sobre a camada com o botão direito do mouse e no menu clique em \emph{Salvar seleção como...\(\rightarrow\)} para definir o arquivo de saída, seu formato e SRC (veja Seção {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Legenda do Mapa}}}). Ainda é possível especificar opções de criação OGR na caixa de diálogo.

\index{Field\_Calculator}\index{Calculator\_Field}\index{Derived\_Fields}

\section{Calculadora de campo}
\label{docs/user_manual/working_with_vector/field_calculator:vector-field-calculator}\label{docs/user_manual/working_with_vector/field_calculator:field-calculator}\label{docs/user_manual/working_with_vector/field_calculator:index-0}\label{docs/user_manual/working_with_vector/field_calculator::doc}
O botão \includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Calculadora de Campo}}$ na tabela de atributos permite realizar cálculos com base na em um atributo existente ou funções definidas. Exemplo: para calcular o comprimento ou área da geometria das feições. Os resultados podem ser gerados para uma nova coluna de atributos ou usados para atualizar valores de uma coluna já existente.

Você tem que deixar a camada vetorial em modo de edição e, após isso, clicar no ícone da calculadora de campo para abrir o diálogo (veja a {\hyperref[docs/user_manual/working_with_vector/field_calculator:figure-attributes-3]{figure\_attributes\_3}}). Na caixa de diálogo, você tem primeiro que selecionar o que se quer para atualizar somente estas, criar um novo campo de atributos onde os resultados do cálculo serão adicionados ou atualizados em um campo existente.
\phantomsection\label{docs/user_manual/working_with_vector/field_calculator:figure-attributes-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{fieldcalculator.png}
\caption{Field Calculator \includegraphics[width=1em]{nix.png}}\end{figure}

If you choose to add a new field, you need to enter a field name, a field type
(integer, real or string), the total field width, and the field precision (see
{\hyperref[docs/user_manual/working_with_vector/field_calculator:figure-attributes-3]{figure\_attributes\_3}}). For example, if you choose a field width of 10 and a field
precision of 3 it means you have 6 signs before the dot, then the dot and another
3 signs for the precision.

A \textbf{Lista de funções} contem funções assim como os campos e valores. Visualize a função de ajuda na \textbf{Ajuda de função selecionada}. Em \textbf{Expessão}, você pode ver o cálculo das expressões que você criar com a \textbf{Lista de funções}. Para os operadores mais utilizados, veja \textbf{Operadores}.

In the \textbf{Function List}, click on \emph{Fields and Values} to view all
attributes of the attribute table to be searched. To add an attribute to the
Field calculator \textbf{Expression} field, double click its name in the
\emph{Fields and Values} list. Generally you can use the various fields,
values and functions to construct the calculation expression or you can just type
it into the box. To display the values ​​of a field, you just right click on the
appropriate field. You can choose between \emph{Load top 10 unique values}
and \emph{Load all unique values}. On the right side opens the \textbf{Field Values}
list with the unique values. To add a value to the Field calculator \textbf{Expression}
box, double click its name in the \textbf{Field Values} list.

The \emph{Operators}, \emph{Math}, \emph{Conversions},
\emph{String}, \emph{Geometry} and \emph{Record} groups provides
several functions. In \emph{Operators} you find mathematical operators.
Find \emph{Math} for mathematical functions. The \emph{Conversions}
group contains functions that convert one data type to another. The \emph{String}
group provides functions for data strings. In the \emph{Geometry} group you
find functions for geometry objects. With \emph{Record} group functions you
can add a numeration to your data set. To add a function to the Field calculator
\textbf{Expression} box, click on the \textgreater{} and then doubleclick the function.

A short example illustrates how the field calculator works. We want to
calculate the length of the \code{railroads} layer from the QGIS sample dataset:
\begin{enumerate}
\item {} 
Load the Shapefile \code{railroads.shp} in QGIS and press \includegraphics[width=1.5em]{mActionOpenTable.png}
$^{\text{Open Attribute Table}}$.

\item {} 
Clique em \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Alternar modo de edição}}$ e abra a caixa de diálogo \includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Calculadora de Campo}}$.

\item {} 
Marque a caixa de seleção \includegraphics{checkbox.png} \emph{Criar um novo campo} para  calcular em um novo campo.

\item {} 
Digite \code{comprimento} como Nome do arquivo de Saida, \code{(número decimal) real} como  Tipo de arquivo de saida e defina a Espessura do campo de saida com 10 e a Precisão de 3.

\item {} 
Now click on function \code{length} in the \emph{Geometry} group to add it
as \code{\$length} into the Field calculator expression box and click \textbf{{[}Ok{]}}.

\item {} 
Você pode agora encontrar a nova coluna {\color{red}\bfseries{}{}`{}`}comprimento{}`{}`na tabela de atributos.

\end{enumerate}

The available functions are listed below.

\index{Field\_Calculator\_Functions}
\begin{Verbatim}[commandchars=\\\{\}]
column name "column name"            value of the field column name
'string'                             a string value
NULL                                 null value
a IS NULL                            a has no value
a IS NOT NULL                        a has a value
a IN (value[,value])                 a is below the values listed
a NOT IN (value[,value])             a is not below the values listed
a OR b                               a or *b* is true
a AND b                              a and *b* is true
NOT a                                inverted truth value of a
sqrt(a)                              square root of a
sin(a)                               sinus of a
cos(a)                               cosinus of b
tan(a)                               tangens of a
asin(a)                              arcussinus of a
acos(a)                              arcuscosinus of a
atan(a)                              arcustangens of a
to int(a)                            convert string a to integer
to real(a)                           convert string a to real
to string(a)                         convert number a to string
lower(a)                             convert string a to lower case
upper(a)                             convert string a to upper case
length(a)                            length of string a
atan2(y,x)                           arcustangens of y/x using the signs of the two
                                     arguments to determine the quadrant of the result
replace(*a*, replacethis, withthat)  replace this with that in string a
regexp\_replace(a,this,that)          replace the regular expression this with that
substr(*a*,from,len)                 len characters of string *a* starting from from
                                     (first character index is 1)
a \textbar{}\textbar{} b                               concatenate strings a and b
\$rownum                              number current row
\$area                                area of polygon
\$perimeter                           perimeter of polygon
\$length                              length of line
\$id                                  feature id
\$x                                   x coordinate of point
\$y                                   y coordinate of point
xat(n)                               X coordinate of the point of an n-th line (indeces
                                     start at 0; negative values refer to the line end)
yat(n)                               y coordinate of the point of an n-th line (indeces
                                     start at 0; negative values refer to the line end)
a = b                                a and b are equal
a != b and a \textless{}\textgreater{} b                    a and b are not equal
a \textgreater{}= b                               a is larger than or equal to b
a \textless{}= b                               a is less than or equal to b
a \textgreater{} b                                a is larger than b
a \textless{} b                                a is smaller than b
a \textasciitilde{} b                                a matches the regular expression b
a LIKE b                             a equals b
a ILIKE b                            a equals b (without regard to case-sensitive)
a \textbar{}wedge\textbar{} b                          a raised to the power of b
a * b                                a multiplied by b
a / b                                a divided by b
a + b                                a plus b
a - b                                a minus b
+ a                                  positive sign
- a                                  negative value of a
\end{Verbatim}

O menu da calculadora de campo \textbf{Lista de funções} com a \textbf{Ajuda de função selecionada} , \textbf{Operadores} e \emph{Expressão*} também estao disponíveis na aba Estilo  da propriedades do layer através da opção de renderização baseada em regra e na expressao baseada em rótulo \includegraphics{browsebutton.png} na aplicação  \includegraphics[width=1.5em]{mActionLabeling.png} $^{\text{Labeling}}$.


\chapter{Trabalhando com dados Raster}
\label{docs/user_manual/working_with_raster/index:working-with-raster-data}\label{docs/user_manual/working_with_raster/index::doc}\label{docs/user_manual/working_with_raster/index:working-with-raster}
\index{Raster}
\index{Arc/Info\_Binary\_Grid}\index{Arc/Info\_ASCII\_Grid}\index{GeoTIFF}
\index{Erdas Imagine}

\section{Trabalhando com dados raster}
\label{docs/user_manual/working_with_raster/supported_data:working-with-raster-data}\label{docs/user_manual/working_with_raster/supported_data::doc}\label{docs/user_manual/working_with_raster/supported_data:index-2}
This Section describes how to visualize and set raster layer properties.
QGIS uses the \index{GDAL}GDAL library to read and write raster data formats,
including Arc/Info Binary Grid, Arc/Info ASCII Grid, GeoTIFF, Erdas Imagine
and many more. GRASS raster support is supplied by a native QGIS data provider
plugin. The raster data can also be loaded in read mode from zip and gzip
archives into QGIS.

Na data deste documento, mais de 100 formatos raster são suportados pela biblioteca GDAL (ver GDAL-SOFTWARE SUITE-: ref: \emph{literature\_and\_web}). A lista completa está disponível no \href{http://www.gdal.org/formats\_list.html}{http://www.gdal.org/formats\_list.html}.

\begin{notice}{note}{Nota:}
Not all of the listed formats may work in QGIS for various reasons. For example,
some require external commercial libraries or the GDAL installation of your OS
was not built to support the format you want to use. Only those formats that
have been well tested will appear in the list of file types when loading a
raster into QGIS. Other untested formats can be loaded by selecting the
\code{{[}GDAL{]} All files (*)} filter.
\end{notice}

Trabalhando com dados raster GRASS é descrito na Seção : ref:\emph{sec\_grass}.


\subsection{O que são dados raster?}
\label{docs/user_manual/working_with_raster/supported_data:what-is-raster-data}
Dados raster em SIG são matrizes de células distintas, que representam características sobre, acima ou abaixo da superfície da terra. Cada célula na grade raster é do mesmo tamanho, e as células são geralmente retangulares (no QGIS serão sempre retangulares). Conjuntos de dados raster típicos incluem dados de sensoriamento remoto, como fotografias aéreas ou imagens de satélite e dados modelados como uma matriz de elevação.

Ao contrário dos dados vetoriais, dados raster, normalmente, não tem um registro de banco de dados associado para cada célula. Eles são georreferenciados por sua resolução de pixel e as coordenadas x/y de um pixel de canto da camada raster. Isto permite com que o QGIS posicione os dados corretamente na tela do mapa.

QGIS faz uso de informações georreferenciados dentro da camada (por exemplo: index: \emph{GeoTiff}) ou em um arquivo de mundo adequado para exibir corretamente os dados.

\index{loading\_raster}

\subsection{Carregando dados raster no QGIS}
\label{docs/user_manual/working_with_raster/supported_data:index-5}\label{docs/user_manual/working_with_raster/supported_data:load-raster}\label{docs/user_manual/working_with_raster/supported_data:loading-raster-data-in-qgis}
Raster layers are loaded either by clicking on the \includegraphics[width=1.5em]{mActionAddRasterLayer.png}
$^{\text{Load Raster}}$ icon or by selecting the \emph{Layer \(\rightarrow\)}
\includegraphics[width=1.5em]{mActionAddRasterLayer.png} \emph{Add Raster Layer} menu option. More than one
layer can be loaded at the same time by holding down the \code{Control} or
\code{Shift} key and clicking on multiple items in the dialog
\emph{Open a GDAL Supported Raster Data Source}.

Uma vez que uma camada for carregada na legenda do mapa, você pode clicar sobre o nome da camada com o botão direito do mouse para selecionar e ativar feições  específicas da camada ou para abrir uma caixa de diálogo para definir as propriedades raster para a camada.

\textbf{Menus do Botão direito do mouse para camadas raster}
\begin{itemize}
\item {} 
\emph{Aproximar a camada a sua extensão}

\item {} 
\emph{Zoom to Best Scale (100\%)}

\item {} 
\emph{Show in Overview}

\item {} 
\emph{Remover}

\item {} 
\emph{Set Layer CRS}

\item {} 
\emph{Set Project CRS from Layer}

\item {} 
\emph{Properties}

\item {} 
\emph{Rename}

\item {} 
\emph{Copy Style}

\item {} 
\emph{Add New Group}

\item {} 
\emph{Expandir tudo}

\item {} 
\emph{Fechar tudo}

\item {} 
\emph{Update Drawing Order}

\end{itemize}


\section{Diálogo propriedades Raster}
\label{docs/user_manual/working_with_raster/raster_properties:raster-properties-dialog}\label{docs/user_manual/working_with_raster/raster_properties::doc}
Para visualizar e definir as propriedades de um camada, clique duas vezes no nome da camada na legenda do mapa ou clique com o direito no nome da camada e escolha: guilabel: \emph{Propriedades} a partir do menu de contexto:

Isso irá abrir o :guilabel: Diálogo \emph{Propriedades da camada Raster} , (see {\hyperref[docs/user_manual/working_with_raster/raster_properties:figure-raster-1]{figure\_raster\_1}}).

There are several tabs on the dialog:
\begin{itemize}
\item {} 
\emph{Estilo}

\item {} 
\emph{Transparência}

\item {} 
\emph{Mapa de cores}

\item {} 
\emph{Geral}

\item {} 
\emph{Metadata}

\item {} 
\emph{Pirâmides}

\item {} 
\emph{Histograma}

\end{itemize}
\phantomsection\label{docs/user_manual/working_with_raster/raster_properties:figure-raster-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{rasterPropertiesDialog.png}
\caption{Raster Layers Properties Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Symbology}\index{Single\_Band\_Raster}\index{Three\_Band\_Color\_Raster}\index{Multi\_Band\_Raster}

\subsection{Tabela Estilo}
\label{docs/user_manual/working_with_raster/raster_properties:index-0}\label{docs/user_manual/working_with_raster/raster_properties:style-tab}\label{docs/user_manual/working_with_raster/raster_properties:label-symbology}
QGIS can render raster layers in two different ways:
\begin{enumerate}
\item {} 
Banda simples - uma banda da imagem é renderizada em escala de cinza ou em falsa cor ou Despadronizar.

\item {} 
Três bandas de cores - três bandas da imagem serão processadas, cada banda que representa o componente vermelho, verde ou azul, que irá ser utilizado para criar uma imagem a cores.

\end{enumerate}

Em ambos os tipos de renderização você pode inverter a saída de cores utilizando o \includegraphics{checkbox.png}: guilabel: caixa de seleção \emph{Inverter mapa de cores}.

\textbf{Renderizar banda simples}

Esta seleção oferece duas possibilidades para escolher. Na primeira você pode selecionar qual banda você gostaria de usar para renderização (se o conjunto de dados tem mais de uma banda).

A segunda opção oferece uma seleção de tabela de cores disponíveis para renderizar.

The following settings are available through the dropdownbox
\emph{Color map} \includegraphics{selectstring.png}

\index{Pseudocolor}\index{Freak\_out}\index{Grayscale}\begin{itemize}
\item {} 
Grayscale (default)

\item {} 
Pseudocolor

\item {} 
Freak Out

\item {} 
Mapa de cores

\end{itemize}

When selecting the entry `Colormap' from \emph{Color map} \includegraphics{selectstring.png}
combobox, the tab \emph{Colormap} becomes available. For more information
see {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-colormaptab]{\emph{Mapa de cores}}}.

QGIS pode restringir os dados exibidos para mostrar apenas as células cujos valores estão dentro de um determinado número de desvios padrão da média para a camada.

Isto é útil quando você tem uma ou duas células com valores anormalmente elevados em uma grade raster que estão tendo um impacto negativo sobre a renderização do raster. Esta opção só está disponível para imagens em pseudocores e despadronizadas.

\textbf{Três bandas de cor}

Esta seleção oferece-lhe uma ampla gama de opções para modificar a aparência da sua camada raster. Por exemplo, você poderia mudar a ordem de cor-bandas do padrão RGB para outra qualquer.

Também a escala de cores está disponível.

\begin{notice}{tip}{Dica:}
\textbf{Visualizando uma banda simples do Raster Multibanda}

Se você quiser ver uma banda única (por exemplo Vermelho) de uma imagem multibanda, você pode pensar que iria definir as faixas verde e azul para ``não informado''. Mas esta não é a maneira correta. Para apresentar a banda Vermlho, defina o tipo de imagem em tons de cinza, em seguida, selecione Vermelho, como a banda de usar para Cinza.
\end{notice}

\index{Contrast\_enhancement}
\textbf{Realce do contraste}

\begin{notice}{note}{Nota:}
When adding GRASS rasters the option \emph{Contrast enhancement} will be
always set to automatically to \emph{stretch to min max} regardless if
the Quantum GIS general options this is set to another value.
\end{notice}

\index{Transparency}

\subsection{Aba transparência}
\label{docs/user_manual/working_with_raster/raster_properties:transparency-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-3}
QGIS has the ability to display each raster layer at varying transparency levels.
Use the transparency slider to indicate to what extent the underlying layers
(if any) should be visible though the current raster layer. This is very useful,
if you like to overlay more than one rasterlayer, e.g. a shaded relief map
overlayed by a classified rastermap. This will make the look of the map more
three dimensional.

Além disso, você pode inserir um valor raster, que deve ser tratada como \emph{NODATA}. Isto pode ser feito manualmente ou com o \includegraphics[width=1.5em]{mActionContextHelp.png}: sup: ícone \emph{Adicionar valores a partir da exibição}.

An even more flexible way to customize the transparency can be done in the
\emph{Custom transparency options} section. The transparency of every pixel
can be set here.

As an example we want to set the water of our example raster file \code{landcover.tif}
to a transparency of 20 \%. The following steps are neccessary:
\begin{enumerate}
\item {} 
Carregar o arquivo raster:file:\emph{landcover}.

\item {} 
Open the \emph{Properties} dialog by double-clicking on the raster
name in the legend or by right-clicking and choosing \emph{Properties}
from the popup menu.

\item {} 
Selecione o :guilabel: Aba \emph{Transparência}

\item {} 
Clique o \includegraphics[width=1.5em]{mActionNewAttribute.png} :sup: Botão \emph{Adicionar valores manualmente}. Uma nova linha irá aparecer na lista de pixel.

\item {} 
Adicione o valor raster (usamos 0 aqui) e ajuste a transparencia para 20\%.

\item {} 
Pressione o botão \textbf{{[}Apply{]}} e dê uma visualizada no mapa.

\end{enumerate}

Você pode repetir os passos 4 e 5 para ajustar mais valores personalizados de transparência.

As you can see this is quite easy to set custom transparency, but it can be
quite a lot of work. Therefore you can use the button \includegraphics[width=1.5em]{mActionFileSave.png}
$^{\text{Export to file}}$ to save your transparency list to a file. The button
\includegraphics[width=1.5em]{mActionFolder.png} $^{\text{Import from file}}$ loads your transparency settings and
applies them to the current raster layer.


\subsection{Mapa de cores}
\label{docs/user_manual/working_with_raster/raster_properties:label-colormaptab}\label{docs/user_manual/working_with_raster/raster_properties:colormap}
\index{Mapa de cores}
The \emph{Colormap} tab is only available, when you have selected a singleband
rendering within the \emph{Style} tab (see {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-symbology]{\emph{Tabela Estilo}}}).

\index{Color\_interpolation}\index{Discrete}
Three ways of color interpolation are available:
\begin{enumerate}
\item {} 
Discrete

\item {} 
Linear

\item {} 
Exact

\end{enumerate}

The button \textbf{{[}Add Entry{]}} adds a color to the individual color table. Button
\textbf{{[}Delete Entry{]}} deletes a color from the individual color table and the
\textbf{{[}Sort{]}} button sorts the color table according to the pixel values in the
value column. Double clicking on the value-column lets you insert a specific
value. Double clicking on the color-column opens the dialog \emph{Select color}
where you can select a color to apply on that value. Further you can also add
labels for each color but this value won't be displayed when you use the identify
feature tool.

You can also click on the button \includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Load color map from band}}$,
which tries to load the table from the band (if it has any). And you can use the
buttons \includegraphics[width=1.5em]{mActionFileOpen.png} $^{\text{Load color map from file}}$ or \includegraphics[width=1.5em]{mActionFileSave.png}
$^{\text{Export color map to file}}$ to load an existing color table or to save the
defined color table for other sessions.

The block \emph{Generate new color map} allows you to create newly
categorized colormaps. You only need to select the \emph{number of entries}
\includegraphics{selectnumber.png} and press the button \emph{Classify}. Currently
only one \emph{Classification mode} \includegraphics{selectstring.png} is supported - `Equal interval'


\subsection{Aba Geral}
\label{docs/user_manual/working_with_raster/raster_properties:general-tab}\label{docs/user_manual/working_with_raster/raster_properties:label-generaltab}
The \emph{General} tab displays basic information about the selected raster,
including the layer source and display name in the legend (which can be
modified). This tab also shows a thumbnail of the layer, its legend symbol,
and the palette.

Além disso escala dependente de visibilidade pode ser definido neste guia. Você precisa verificar a caixa de seleção e definir uma escala adequada, onde seus dados serão exibidos na tela do mapa.

Também o sistema de coordenadas de referência (CRS) é impresso aqui como um PROJ.4-string. Isso pode ser modificado pressionando o botão \textbf{{[}Especifique...{]}}.

\index{Metadata}

\subsection{Aba Metadata}
\label{docs/user_manual/working_with_raster/raster_properties:metadata-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-6}
A :guilabel: Aba \emph{Metadata} exibe uma riqueza de informações sobre a camada raster, incluindo estatísticas sobre cada banda na camada atual. As estatísticas estão reunidas em uma `necessidade de saber', por isso pode muito bem ser que uma estatística de dada camada ainda não tenha sido coletadas.

This tab is mainly for information. You cannot change any values printed
inside this tab.

\index{Pyramids}

\subsection{Aba Pirâmides}
\label{docs/user_manual/working_with_raster/raster_properties:pyramids-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-7}
Camadas raster de grandes resoluções podem retardar a navegação no QGIS. Com a criação de cópias de baixa resolução dos dados (pirâmides), o desempenho pode ser melhorado consideravelmente, o QGIS seleciona a resolução mais adequado para usar dependendo do nível de zoom.

Você pode ter acesso de escrita no diretório onde os dados originais são armazenados para construir pirâmides.

Several resampling methods can be used to calculate the pyramids:
\begin{itemize}
\item {} 
Average

\item {} 
Nearest Neighbour

\end{itemize}

Ao habilitar a caixa de seleção \includegraphics{checkbox.png}: guilabel: \emph{construir pirâmides internamente se possível} o QGIS tenta construir pirâmides internamente.

Favor notar que construir pirâmides pode alterar o ficheiro original de dados e uma vez criados, eles não podem ser removidos. Se você deseja preservar uma versão ``não-piramidal'' do seu raster, faça uma cópia de segurança antes de construir pirâmides.


\subsection{Aba Histograma}
\label{docs/user_manual/working_with_raster/raster_properties:label-histogram}\label{docs/user_manual/working_with_raster/raster_properties:histogram-tab}
\index{Histogram}
The \emph{Histogram} tab allows you to view the distribution of the bands
or colors in your raster. It is generated automaticaly when you open
\emph{Histogram} tab. All existing bands will be displayed together. You can
save the histogram as an image with the \includegraphics[width=1.5em]{mActionFileSave.png} button.


\section{Calculadora Raster}
\label{docs/user_manual/working_with_raster/raster_calculator:sec-raster-calc}\label{docs/user_manual/working_with_raster/raster_calculator:raster-calculator}\label{docs/user_manual/working_with_raster/raster_calculator::doc}
\index{Raster\_Calculator}
The \emph{Raster Calculator} in the \emph{Raster} menu
(see {\hyperref[docs/user_manual/working_with_raster/raster_calculator:figure-raster-2]{figure\_raster\_2}}) allows to perform calculations on basis of existing
raster pixel values.
The results are written to a new raster layer with a GDAL supported format.
\phantomsection\label{docs/user_manual/working_with_raster/raster_calculator:figure-raster-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{raster_calculator.png}
\caption{Raster Calculator \includegraphics[width=1em]{nix.png}}\end{figure}

The \textbf{Raster bands} list contains all loaded raster layers that can be used.
To add a raster to the raster calculator expression field, double
click its name in the Fields list. You can then use the operators to construct
calculation expressions or you can just type it into the box.

Na seção \textbf{Result layer} é necessário definir a camada de saída. Em seguida, pode definir a extensão da área de cálculo com base em uma camada raster de entrada ou com base em coordenadas X, Y e em colunas e linhas para definir a resolução da camada de saída. Se a camada de entrada tem uma resolução diferente, os valores serão redefinidos com o algoritmo vizinho mais próximo.

The \textbf{Operators section} contains all usable operators. To add an operator
to the raster calculator expression box, click the appropriate button. Mathematical
calculations (\code{+}, \code{-}, \code{*}, ... ) and trigonometric functions (\code{sin},
\code{cos}, \code{tan}, ... ) are available. Stay tuned for more operators to come!

With the \includegraphics{checkbox.png} \emph{Add result to project} checkbox the result layer
will automatically added to the legend area and can be visualized.


\subsection{Examples}
\label{docs/user_manual/working_with_raster/raster_calculator:examples}
\textbf{Convert elevation values from meter to feet}

Creating an elevation raster feet from a raster in meter, you need to use the
conversion factor for meters to feet: 3.28. The expression is:

\begin{Verbatim}[commandchars=\\\{\}]
elevation@1 * 3.28
\end{Verbatim}

\textbf{Using a mask}

If you want to mask out parts of a raster, because you are only interested in
elevations above 0 meter, you can use following expression to create a mask
and apply the result to a raster in one step.

\begin{Verbatim}[commandchars=\\\{\}]
(elevation@1 \textgreater{}= 0) * elevation@1
\end{Verbatim}

For every cell greater than or equal to 0, set its value to 1, otherwise set
it to 0. This creates the mask on the fly.


\chapter{Trabalhando com dados OGC}
\label{docs/user_manual/working_with_ogc/index:working-with-ogc-data}\label{docs/user_manual/working_with_ogc/index:sec-ogc}\label{docs/user_manual/working_with_ogc/index::doc}

\section{Trabalhando com dados OGC}
\label{docs/user_manual/working_with_ogc/ogc_client_support:working-with-ogc}\label{docs/user_manual/working_with_ogc/ogc_client_support::doc}\label{docs/user_manual/working_with_ogc/ogc_client_support:working-with-ogc-data}
QGIS suporta WMS e WFS como fontes de dados.


\subsection{O que é dados OGC}
\label{docs/user_manual/working_with_ogc/ogc_client_support:what-is-ogc-data}
\index{Open\_Geospatial\_Consortium}\index{OGC}
A  Open Geospatial Consortium (OGC), é uma organização internacional com mais de 300 organizações comerciais, governamentais, sem fins lucrativos e de pesquisa em todo o mundo. Seus membros desenvolvem e implementam normas para conteúdo geoespacial e de serviços, processamento de dados SIG e intercâmbio.

Descrevendo um modelo de dados básico para feições geográficas de um número crescente de especificações são desenvolvidos para atender necessidades específicas de localização interoperabilidade ​​e tecnologia geoespacial, incluindo SIG. Mais informações podem ser encontradas em \href{http://www.opengeospatial.org/}{http://www.opengeospatial.org/}.

\index{WMS}\index{WFS}\index{WCS}\index{CAT}\index{SFS}\index{GML}
Especificações OGC importantes são:
\begin{itemize}
\item {} 
\textbf{WMS} --- Web Map Service

\item {} 
\textbf{WFS} --- Web Feature Service

\item {} 
\textbf{WCS} --- Web Coverage Service

\item {} 
\textbf{CAT} --- Web Catalog Service

\item {} 
\textbf{SFS} --- Simple Features for SQL

\item {} 
\textbf{GML} --- Geography Markup Language

\end{itemize}

OGC services are increasingly being used to exchange geospatial data between
different GIS implementations and data stores. QGIS can now deal with three of
the above specifications, being SFS (through support of the PostgreSQL / PostGIS
data provider, see Section {\hyperref[docs/user_manual/working_with_vector/supported_data:label-postgis]{\emph{Camadas PostGIS}}}), WFS and WMS as a client.


\subsection{Cliente WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:wms-client}\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms}
\index{WMS\_client}

\subsubsection{Resumo do suporte WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:overview-of-wms-support}\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-about}\label{docs/user_manual/working_with_ogc/ogc_client_support:index-2}
QGIS atualmente pode agir como um cliente WMS que entende servidores WMS 1.1, 1.1.1 e 1.3. Ele tem particularmente sido testados com servidores de acesso público, tais como DEMIS.

Servidores WMS atuam sobre os pedidos do cliente (por exemplo QGIS) para um mapa raster com uma extensão dada, conjunto de camadas, estilo de simbolização e transparência. O servidor WMS então consulta suas fontes de dados locais, rasteriza o mapa, e envia de volta para o cliente em um formato raster. Para o QGIS isso normalmente seria no formato JPEG ou PNG.

WMS é genericamente um REST (Transferência de Estado Representacional) serviço em vez de um serviço Web completamente fundido. Como tal, você pode realmente ter o URLs gerados pelo QGIS e usá-los em um navegador da Web para recuperar as mesmas imagens que o QGIS usa internamente. Isto pode ser útil para solução de problemas, pois existem várias marcas de servidores WMS no mercado e todos eles têm sua própria interpretação do padrão WMS.

Camadas WMS podem ser adicionadas simplesmente, desde que você saiba a URL para acessar o servidor WMS, você tem uma conexão útil para esse servidor, e o servidor HTTP entende como mecanismo de transporte de dados.


\subsubsection{Selecionando servidor WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-servers}\label{docs/user_manual/working_with_ogc/ogc_client_support:selecting-wms-servers}
A primeira vez que você usar o recurso de WMS, não há servidores definidos.

Comece clicando no \includegraphics[width=1.5em]{mActionAddWmsLayer.png}: sup: botão \emph{Adicionar camada WMS} dentro da barra de ferramentas, ou através do :menuselection: menu \emph{Camada --\textgreater{} Adicionar Camada WMS ...}.

O diálogo: guilabel: `Adicionar camada(s) de um servidor{}` para adicionar camadas do servidor WMS aparecerá. Você pode adicionar alguns servidores para jogar clicando no botão \textbf{{[}Adicionar servidores padrões{]}} Isto irá adicionar dois servidores de demonstração de WMS para você usar, os servidores WMS do DM Solutions Gmap e Lizardtech server. Para definir um servidor WMS novo no guia: guilabel: \emph{Camadas}, selecione o botão \textbf{{[}Novo{]}}. Em seguida, insira os parâmetros para se conectar ao servidor WMS desejado, conforme listado na {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:table-ogc-1]{table\_OGC\_1}}:
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:table-ogc-1}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

Nome
 & 
Um nome para essa conecção. Este nome será usado nas conexões de servidor caixa suspensa para que você possa distingui-lo de outros servidores WMS.
\\

URL
 & 
URL do servidor que fornece os dados. Este deve ser um nome de host resolvido, o mesmo formato que você usaria para abrir uma conexão telnet ou ping em um host.
\\

Usuário
 & 
Usuário para o acesso em servidor WMS seguro. Este parâmetro é opcional.
\\

Senha
 & 
Senha para uma autenticação básica no servidor WMS. Este parâmetro é opcional.
\\

Ignorar GetMap URI
 & 
\includegraphics{checkbox.png} \emph{Ignorar GetMap URI relatados em recursos}, usar determinado URI do campo URL acima.
\\

Ignorar GetFeatureInfo URI relatados em recursos
 & 
\includegraphics{checkbox.png} \emph{Ignorar GetMap URI relatados em recursos} , usar determinado URI do campo URL acima
\\
\hline\end{tabulary}


Tabela OGC 1: Parâmtros de coneção WMS

\index{Proxy}\index{proxy-server}
If you need to set up a proxy-server to be able to receive WMS-services from the
internet, you can add your proxy-server in the options. Choose menu
\emph{Settings \(\rightarrow\) Options} and click on the tab \emph{Network \& Proxy}.
There you can add your proxy-settings and enable them by setting the \includegraphics{checkbox.png}
\emph{Use proxy for web access}. Make sure that you select the correct
proxy type from the \emph{Proxy type} \includegraphics{selectstring.png} dropdown menu.

Uma vez que a nova conexão de servidor WMS foi criada, ela será preservada para as futuras sessões do QGIS.

\begin{notice}{tip}{Dica:}
\textbf{Nas URLs dos servidores WMS}

Certifique-se, ao entrar na URL do servidor WMS, que você tem a URL base. Por exemplo, você não deve ter fragmentos pedidos, como \code{request= GetCapabilities} ou \code{version=1.0.0} no seu URL.
\end{notice}


\subsubsection{Carregando camadas WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:loading-wms-layers}\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-layers}
Once you have successfully filled in your parameters you can select the
\textbf{{[}Connect{]}} button to retrieve the capabilities of the selected server. This
includes the Image encoding, Layers, Layer Styles and Projections. Since this is
a network operation, the speed of the response depends on the quality of your
network connection to the WMS server. While downloading data from the WMS server,
the download progress is visualized in the left bottom of the WMS dialog.

Sua tela deve agora visualizar como na {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:figure-ogr-1]{figure\_OGR\_1}}, que mostra a resposta fornecida pelo servidor WMS DM Solutions GMap.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:figure-ogr-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{connection_wms.png}
\caption{Dialog for adding a WMS server, showing its available layers \includegraphics[width=1em]{nix.png}}\end{figure}

\textbf{Codificação de imagem}

A: guilabel: \emph{Codificação da Imagem} a secção agora lista todos os formatos que são suportados pelo cliente e servidor. Escolha um de acordo com suas exigências de precisão de imagem.

\begin{notice}{tip}{Dica:}
\textbf{Codificação de imagem}

Você encontrará tipicamente que um servidor WMS oferece-lhe a escolha de codificação de imagem JPEG ou PNG. JPEG é um formato de compressão com perdas, enquanto PNG reproduz fielmente os dados raster bruto.

Use JPEG se você espera que os dados WMS sejam fotográficos na natureza e / ou você não se importa de alguma perda na qualidade da imagem. Este trade-off normalmente reduz em cinco vezes a necessidade de transferência de dados em comparação com PNG.

Use PNG, se você quiser representações precisas dos dados originais, e não se importa com o aumento dos requisitos de transferência de dados.
\end{notice}

\textbf{Opções}

The Options field provides a text field where you can add a \emph{Layer name}
for the WMS-layer. This name will be presented in the legend after loading
the layer.

Below the layer name you can define \emph{Tile size}, if you want to set tile
sizes (eg. 256x256) to split up the WMS request into multiple requests.

A: guilabel: \emph{Limite de feição para GetFeatureInfo} define quais feições do servidor serão consultadas.

Se você selecionar um WMS da lista um campo com a projeção padrão, fornecido pelo mapserver, aparecerá. Se o botão \textbf{{[}Mudar ...{]}} estiver ativo, você pode clicar nele e mudar a projeção padrão do WMS para outro SRC, fornecidos pelo servidor WMS.

\textbf{Ordem de camada}

A guia: guilabel: \emph{Ordem de camada} lista as camadas selecionadas disponíveis a partir do servidor WMS atual conectado. Você pode notar que algumas camadas são expansíveis, isso significa que a camada pode ser exibida em uma escolha de estilos de imagem.

Você pode selecionar várias camadas de uma vez, mas apenas um estilo de imagem por camada. Quando várias camadas são selecionados, elas serão combinadas e transmitidas para o servidor WMS QGIS de uma só vez.

\begin{notice}{tip}{Dica:}
\textbf{Ordenação de camada WMS}

Camadas WMS disponibilizadas por um servidor são sobrepostas na ordem listada na seção Camadas, de cima para baixo da lista. Se você quiser alterar a ordem de sobreposição, você pode usar a guia: guilabel: \emph{Ordem de camada}.
\end{notice}
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-transparency}
\textbf{Transparência}

Nesta versão do QGIS, a: guilabel: \emph{transparência global} configuração da: guilabel: {\color{red}\bfseries{}{}`}Propriedades da camada{}`é codificada para ser sempre ligada, sempre que disponível.

\index{WMS\_layer\_transparency}
\begin{notice}{tip}{Dica:}
\textbf{Transparência da camada WMS}

A disponibilidade de transparência da imagem WMS depende da codificação utilizada na imagem: PNG e GIF suportam transparência, enquanto JPEG deixa sem suporte.
\end{notice}

\textbf{Sistema de coordenada de referência}

\index{Coordinate\_Reference\_System}\index{SRS}\index{CRS}
Um Sistema de Referência de Coordenadas (SRC) é a terminologia OGC para uma projeção QGIS.

Each WMS Layer can be presented in multiple CRSs, depending on the capability of
the WMS server.

To choose a CRS, select \textbf{{[}Change...{]}} and a dialog similar to Figure Projection 3
in {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Trabalhando com Projeções}}} will appear. The main difference with the WMS version of
the screen is that only those CRSs supported by the WMS Server will be shown.


\subsubsection{Busca de servidor}
\label{docs/user_manual/working_with_ogc/ogc_client_support:server-search}\label{docs/user_manual/working_with_ogc/ogc_client_support:serversearch}
Within QGIS you can search for WMS-servers. {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:figure-ogc-2]{Figure\_OGC\_2}} shows the tab
\emph{Server Search} with the \emph{Add Layer(s) from a Server} dialog.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:figure-ogc-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{wms_server_search.png}
\caption{Dialog for searching WMS servers after some keywords \includegraphics[width=1em]{nix.png}}\end{figure}

As you can see it is possible to enter a search-string in the text field and hit
the \textbf{{[}Search{]}} button. After a short while the search result will be populated
into the list below the text field. Browse the result list and inspect your search
results within the table. To visualize the results, select a table entry, press
the \textbf{{[}Add selected row to WMS-list{]}} button and change back to the tab
\emph{Layers}. QGIS automatically has updated your server list and the
selected search result is already enabled in the list of saved WMS-servers in
the \emph{Layers} tab. You only need to request the list of layers by clicking
the \textbf{{[}Connect{]}} button. This option is quite handy when you want to search maps
by specific keywords.

Basicamente, esta opção é um frontend para o API de \href{http://geopole.org}{http://geopole.org}.


\subsubsection{Tilesets}
\label{docs/user_manual/working_with_ogc/ogc_client_support:id1}\label{docs/user_manual/working_with_ogc/ogc_client_support:tilesets}
\index{WMS\_tiles}\index{WMS-C}
When using WMS-C (Cached WMS) Services like \href{http://labs.metacarta.com/wms-c/Basic.py}{http://labs.metacarta.com/wms-c/Basic.py}
you are able to browse through the tab \emph{Tilesets} given by the server.
Additional information like tile size, formats and supported CRS are listed in
this table. In combination with this feature you can use the tile scale slider
from the \emph{View \(\rightarrow\) Tile scale slider}, which gives you the
available scales from the tileserver with nice slider docked in.


\subsubsection{Usando a ferramenta de identificação}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-identify}\label{docs/user_manual/working_with_ogc/ogc_client_support:using-the-identify-tool}
\index{WMS\_identify}
Once you have added a WMS server, and if any layer from a WMS server is queryable,
you can then use the \includegraphics[width=1.5em]{mActionIdentify.png} $^{\text{Identify}}$ tool to select a pixel on
the map canvas. A query is made to the WMS server for each selection made.
The results of the query are returned in plain text. The formatting of this text
is dependent on the particular WMS server used.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-properties}
\textbf{Exibindo propriedades}

\index{WMS\_properties}
Depois de ter adicionado um servidor WMS, você pode ver suas propriedades clicando sobre ela na legenda, e selecionando: menuselection: \emph{Propriedades}.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-properties-metadata}
\textbf{Guia Metadata}

\index{WMS\_metadata}
The tab \emph{Metadata} displays a wealth of information about the WMS
server, generally collected from the Capabilities statement returned from
that server. Many definitions can be cleaned by reading the WMS standards (see
OPEN-GEOSPATIAL-CONSORTIUM {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}}), but here are a few handy
definitions:
\begin{itemize}
\item {} 
\textbf{Propriedades do servidor}
\begin{itemize}
\item {} 
\textbf{Versão WMS} --- A versão WMS suportada pelo servidor.

\item {} 
\textbf{Image Formats} --- The list of MIME-types the server can respond with
when drawing the map. QGIS supports whatever formats the underlying Qt
libraries were built with, which is typically at least \code{image/png} and
\code{image/jpeg}.

\item {} 
\textbf{Identity Formats} --- The list of MIME-types the server can respond
with when you use the Identify tool. Currently QGIS supports the
\code{text-plain} type.

\end{itemize}

\item {} 
\textbf{Propriedades da camada}
\begin{itemize}
\item {} 
\textbf{Selecionado} --- Seja ou não essa camada foi selecionada quando o servidor foi adicionado a este projeto.

\item {} 
\textbf{Visível} --- Seja ou não essa camada é selecionada como visível na legenda. (Ainda não utilizados nesta versão do QGIS.)

\item {} 
\textbf{Pode identificar} --- ou não essa camada retornará nenhum resultado quando a ferramenta Identificar é usada nela.

\item {} 
\textbf{Pode ser transparente} --- ou não essa camada pode ser apresentada com transparência. Esta versão do QGIS sempre usa a transparência se esta é \code{Sim} e a codificação de imagens suporta transparência

\item {} 
\textbf{Pode ampliar}  --- Seja ou não essa camada pode ser ampliada pelo servidor. Esta versão do QGIS assume todas as camadas WMS tem este conjunto de \code{Sim}. Camadas deficientes podem ser apresentadas de forma estranha.

\item {} 
\textbf{Cascade Count} --- WMS servers can act as a proxy to other WMS servers to
get the raster data for a layer. This entry shows how many times the request
for this layer is forwarded to peer WMS servers for a result.

\item {} 
\textbf{Largura fixa, altura fixa} --- Seja ou não essa camada fixou dimensões de pixel de origem. Esta versão do QGIS assume todas as camadas WMS tem este conjunto vazio. Camadas deficientes podem ser apresentadas de forma estranha.

\item {} 
\textbf{WGS 84 Bounding Box} --- The bounding box of the layer, in WGS 84
coordinates. Some WMS servers do not set this correctly (e.g. UTM coordinates
are used instead). If this is the case, then the initial view of this layer
may be rendered with a very `zoomed-out' appearance by QGIS. The WMS webmaster
should be informed of this error, which they may know as the WMS XML elements
\code{LatLonBoundingBox}, \code{EX\_GeographicBoundingBox} or the CRS:84 \code{BoundingBox}.

\item {} 
\textbf{SRC Disponível} --- As projeções que esta camada pode ser apresentadas pelo servidor WMS. Elas estão listadas no formato nativo WMS.

\item {} 
\textbf{Estilo Disponível} --- Os estilos de imagem que esta camada pode renderizar pelo servidor WMS.

\end{itemize}

\end{itemize}


\subsubsection{Limitações do cliente WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-limits}\label{docs/user_manual/working_with_ogc/ogc_client_support:wms-client-limitations}
Nem todas as funcionalidade de cliente WMS possíveis tinham sido incluídas nesta versão do QGIS. Alguns das mais notáveis ​​exceções seguir.

\textbf{Editando configurações de camada WMS}

Once you've completed the \includegraphics[width=1.5em]{mActionAddWmsLayer.png} $^{\text{Add WMS layer}}$ procedure,
there is no ability to change the settings. A workaround is to delete the layer
completely and start again.

\textbf{Autenticação requerida nos servidores WMS}

Atualmente públicas acessíveis e seguros os serviços-WMS são suportados. Os servidores-WMS seguros podem ser acessados ​​por meio da autenticação pública. Você pode adicionar as credenciais (opcional) quando você adiciona um servidor-WMS. Consulte a seção: ref: \emph{ogc-wms-servers} para mais detalhes.

\index{InteProxy}\index{Secured\_OGC\_Authentication}
\begin{notice}{tip}{Dica:}
\textbf{Acessando camadas-OGC seguras}

If you need to access secured layers with other secured methods than basic
authentication, you could use InteProxy as a transparent proxy, which does
support several authentication methods. More information can be found at the
InteProxy manual found on the website \href{http://inteproxy.wald.intevation.org}{http://inteproxy.wald.intevation.org}.
\end{notice}

\index{QGIS\_mapserver}\index{WMS\_1.3.0}
\begin{notice}{tip}{Dica:}
\textbf{QGIS WMS Mapserver}

Para a versão QGIS 1.7.0 tem sua própria implementação de um WMS 1.3.0 Mapserver. Leia mais sobre isso no capítulo: ref: \emph{label\_qgisserver}.
\end{notice}


\subsection{Clientes WFS e WFS-T}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wfs}\label{docs/user_manual/working_with_ogc/ogc_client_support:wfs-and-wfs-t-client}
\index{WFS}\index{WFS-T}\index{WFS\_Transactional}
No QGIS, uma camada WFS se comporta muito bem como qualquer camada de vetor. Você pode identificar e selecionar as feições e visualizar a tabela de atributos. Desde a edição QGIS 1.6 (WFS-T) também é suportado.

Em geral, a adição de uma camada WFS é muito semelhante ao procedimento utilizado com WMS. A diferença é que não há servidores padrão definidos, por isso temos de acrescentar o nosso.

\textbf{Carregando uma camada WFS}

Como exemplo, vamos usar o DM Solutions servidor WFS e exibir uma camada. A URL é: \href{http://www2.dmsolutions.ca/cgi-bin/mswfs\_gmap}{http://www2.dmsolutions.ca/cgi-bin/mswfs\_gmap}
\begin{enumerate}
\item {} 
Clique no \includegraphics[width=1.5em]{wfs.png}: sup: ferramenta \emph{Adicionar Camada WFS} na barra de ferramentas Camadas, o diálogo: guilabel: aparece `Adiciona camada WFS de um Servidor {}`

\item {} 
Click em \textbf{{[}Novo{]}}

\item {} 
Enter `DM Solutions' as name

\item {} 
Entre com a URL (ver acima citada)

\item {} 
Clique \textbf{{[}OK{]}}

\item {} 
Choose `DM Solutions' from the \emph{Server Connections} \includegraphics{selectstring.png}
combobox

\item {} 
Clique \textbf{{[}Conectar{]}}

\item {} 
Aguarde a lista de camadas a ser preenchida

\item {} 
Select the \emph{Parks} layer in the list

\item {} 
Clique \textbf{{[}Aplicar{]}} para adicionar a camada para o mapa

\end{enumerate}

Note-se que as configurações de proxy definidas em suas preferências também são reconhecidas.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:figure-ogc-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{connection_wfs.png}
\caption{Adding a WFS layer \includegraphics[width=1em]{nix.png}}\end{figure}

Você vai notar o progresso do download é visualizado no canto inferior esquerdo da janela principal do QGIS. Uma vez que a camada é carregada, você pode identificar e selecionar uma província ou duas e ver a tabela de atributos.

Only WFS 1.0.0 is supported. At this point there have not been many tests against
WFS versions implemented in other WFS-servers. If you encounter problems with any
other WFS-server, please do not hesitate to contact the development team. Please
refer to Section {\hyperref[docs/user_manual/preamble/help_and_support:label-helpsupport]{\emph{Listas de Discurssão}}} for further information about the
mailinglists.

\begin{notice}{tip}{Dica:}
\textbf{Conclusão do servidor WFS}

Você pode encontrar mais servidores WFS, usando o Google ou o seu motor de busca favorito. Há um número de listas com URLs públicas, algumas delas mantidas e algumas não.
\end{notice}

\index{QGIS\_Server}\index{FastCGI}\index{CGI}\index{Common\_Gateway\_Interface}

\section{Servidor QGIS}
\label{docs/user_manual/working_with_ogc/ogc_server_support:index-0}\label{docs/user_manual/working_with_ogc/ogc_server_support:qgis-server}\label{docs/user_manual/working_with_ogc/ogc_server_support::doc}\label{docs/user_manual/working_with_ogc/ogc_server_support:label-qgisserver}
O Servir QGIS é uma fonte aberta WMS 1.3 e WFS 1.0.0 que implementa, além disso, implementa avançados recursos cartográficos para mapeamento temático. O servidor do QGIS é um aplicativo FastCGI/CGI (Common Gateway Interface), escrito em C++ que funciona em conjunto com um servidor web (por exemplo, o Apache, Lighttpd). É financiado pela projeto Orchestra UE, Sany e a cidade de Uster, na Suíça.

\index{SLD}\index{SLD/SE}
It uses QGIS as backend for the GIS logic and for map rendering. Furthermore the
Qt library is used for graphics and for platform independent C++ programming. In
contrast to other WMS software, the QGIS Server uses cartographic rules as a
configuration language, both for the server configuration and for the user-defined
cartographic rules.

\index{Publish\_to\_Web\_plugin}
Além disso, o projeto do Servidor QGIS fornece o complemento `Publicar na Web', um complemento para o QGIS desktop que exporta as camadas atuais e simbologia como um projeto web para o Servidor QGIS (contendo regras de visualização cartográfica expressas em SLD).

As QGIS desktop and QGIS Server use the same visualization libraries, the maps
that are published on the web look the same as in desktop GIS. The `Publish to Web'
plugin currently supports basic symbolization, with more complex cartographic
visualization rules introduced manually. As the configuration is performed with
the \href{http://www.opengeospatial.org/standards/sld}{SLD standard} and its
documented extensions, there is only one standardised language to learn, which
greatly simplifies the complexity of creating maps for the Web.

Em um dos seguintes manuais vamos fornecer um exemplo de configuração para configurar um servidor de QGIS. Mas, por ora, recomendamos que você leia uma das seguintes URLs para obter mais informações:
\begin{itemize}
\item {} 
\href{http://karlinapp.ethz.ch/qgis\_wms/}{http://karlinapp.ethz.ch/qgis\_wms/}

\item {} 
\href{http://hub.qgis.org/projects/quantum-gis/wiki/QGIS\_Server\_Tutorial}{http://hub.qgis.org/projects/quantum-gis/wiki/QGIS\_Server\_Tutorial}

\item {} 
\href{http://linfiniti.com/2010/08/qgis-mapserver-a-wms-server-for-the-masses/}{http://linfiniti.com/2010/08/qgis-mapserver-a-wms-server-for-the-masses/}

\end{itemize}

\index{apache}\index{apache2}\index{Debian\_Squeeze}

\subsection{Instalação simples no Squeeze Debian}
\label{docs/user_manual/working_with_ogc/ogc_server_support:sample-installation-on-debian-squeeze}\label{docs/user_manual/working_with_ogc/ogc_server_support:index-3}
Neste ponto, vamos dar um exemplo de instalação curto e simples para Squeeze Debian. Muitos outros sistemas operacionais também oferecem pacotes para o servidor QGIS. Se você tem que construir tudo a partir da fonte, por favor consulte as URLs acima.

Apart from qgis and qgis-mapserver you need a webserver, in our case apache2.
You can install all packages with aptitude or apt-get install together with other
necessary dependency packages. After installation you should test, if the webserver
and qgis server works as expected. Make sure the apache server is running with
\code{/etc/init.d/apache2 start}. Open a web browser and type URL: \code{http://localhost}.
If apache is up, you should see the message `It works!'.

Now we test the qgis server installation. The \code{qgis\_mapserv.fcgi} is available
at \code{/usr/lib/cgi-bin/qgis\_mapserv.fcgi} and provides a standard wms that shows
the state boundaries of Alaska. Add the WMS with the URL
\code{http://localhost/cgi-bin/qgis\_mapserv.fcgi} as described in {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-servers]{\emph{Selecionando servidor WMS}}}.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_server_support:figure-server-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{standard_wms_usa.png}
\caption{Standard WMS with USA boundaries included in the qgis server (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Creating a WMS/WFS from a QGIS project}
\label{docs/user_manual/working_with_ogc/ogc_server_support:creating-a-wms-wfs-from-a-qgis-project}\label{docs/user_manual/working_with_ogc/ogc_server_support:creating-a-wms-from-a-qgis-project}
To provide a new qgis wms/wfs server we have to create a qgis project file with
some data. Here we use the `alaska' shapefile from the qgis\_sample\_dataset. Define
the colors and styles of the layers in QGIS and define the project CRS, if not
already done.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_server_support:figure-server-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{ows_server_definition.png}
\caption{Definitions for a qgis project WMS/WFS server (KDE)}\end{figure}

Then open the \code{OWS Server} tab in the menu \emph{Settings \(\rightarrow\)
Project Properties} and define the general fields under `Service Capabilities'.
For \code{WMS Capabilities} define `Coordinate System Restrictions' and `Advertised
Extend'. Additionally you can enable the checkbox \includegraphics{checkbox.png} \emph{Add WKT
geometry to feature into response} to make the layers queryable and add a
`Maximum width' and height that can be requested. For \code{WFS Capabilities} you
only need to select the layers that you want to provide as WFS. Now save the
session in a project file \code{alaska.qgs}. To provide the project as a WMS/WFS,
we create a new folder \code{/usr/lib/cgi-bin/project} with admin privileges and
add the project file \code{alaska.qgs} and a copy of the \code{qgis\_mapserv.fcgi}
file - that's all.

Now we test our project WMS and WFS, add the WMS and WFS as described in
{\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-layers]{\emph{Carregando camadas WMS}}} and {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wfs]{\emph{Clientes WFS e WFS-T}}} to QGIS and load the WMS. The URL is:

\begin{Verbatim}[commandchars=\\\{\}]
http://localhost/cgi-bin/project/qgis\_mapserv.fcgi
\end{Verbatim}


\chapter{Trabalhando com dados GPS}
\label{docs/user_manual/working_with_gps/index::doc}\label{docs/user_manual/working_with_gps/index:working-with-gps-data}

\section{Complemento GPS}
\label{docs/user_manual/working_with_gps/plugins_gps:plugin-gps}\label{docs/user_manual/working_with_gps/plugins_gps:gps-plugin}\label{docs/user_manual/working_with_gps/plugins_gps::doc}

\subsection{O que é GPS?}
\label{docs/user_manual/working_with_gps/plugins_gps:what-is-gps}\label{docs/user_manual/working_with_gps/plugins_gps:whatsgps}
GPS, the Global Positioning System, is a satellite-based system that allows
anyone with a GPS receiver to find their exact position anywhere in the world.
It is used as an aid in navigation, for example in airplanes, in boats and by
hikers. The GPS receiver uses the signals from the satellites to calculate its
latitude, longitude and (sometimes) elevation. Most receivers also have the
capability to store locations (known as \emph{waypoints}), sequences of locations
that make up a planned \emph{route} and a tracklog or \emph{track} of the receivers
movement over time. Waypoints, routes and tracks are the three basic feature
types in GPS data. QGIS displays waypoints in point layers while routes and
tracks are displayed in linestring layers.


\subsection{Carregando dados GPS de um arquivo}
\label{docs/user_manual/working_with_gps/plugins_gps:loading-gps-data-from-a-file}\label{docs/user_manual/working_with_gps/plugins_gps:label-loadgps}
Existem dezenas de diferentes formatos de arquivo para armazenar dados GPS. O formato que o QGIS usa é chamado GPX (GPS Exchange Format), que é um formato de intercâmbio padrão e que pode conter qualquer número de ‘Locais’, ‘Rotas’ e ‘Trilhas’ no mesmo arquivo.

To load a GPX file you first need to load the plugin.
\emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png}
\emph{Plugin Manager...} opens the Plugin Manager Dialog.
Activate the \includegraphics{checkbox.png} \emph{GPS Tools} checkbox. When this plugin
is loaded two buttons with a small handheld GPS device will show up in the
toolbar:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{gps_importer.png} $^{\text{Create new GPX Layer}}$

\item {} 
\includegraphics[width=1.5em]{gps_importer.png} $^{\text{GPS Tools}}$

\end{itemize}

For working with GPS data we provide an example GPX file available in the QGIS
sample dataset: \code{qgis\_sample\_data/gps/national\_monuments.gpx}. See Section
{\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dados de exemplo}}} for more information about the sample data.
\begin{enumerate}
\item {} 
Clique na opção :menuselection: \emph{Vetor-\textgreater{}} :menuselection: \emph{GPS-\textgreater{}'\textbar{}gps\_importer\textbar{} {}`Ferramentas GPS} para abrir a caixa:guilabel:\emph{Ferramentas de GPS} e escolha a aba `Carregar arquivo GPX' (veja {\hyperref[docs/user_manual/working_with_gps/plugins_gps:figure-gps-1]{figure\_GPS\_1}}).

\item {} 
Browse to the folder \code{qgis\_sample\_data/gps/}, select the GPX file
\code{national\_monuments.gpx} and click \textbf{{[}Open{]}}.

\end{enumerate}
\phantomsection\label{docs/user_manual/working_with_gps/plugins_gps:figure-gps-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{loadgpx.png}
\caption{The \emph{GPS Tools} dialog window \includegraphics[width=1em]{nix.png}}\end{figure}

Use the \textbf{{[}Browse...{]}} button  to select the GPX file, then use the
checkboxes to select the feature types you want to load from that GPX file.
Each feature type will be loaded in a separate layer when you click
\textbf{{[}OK{]}}. The file \code{national\_monuments.gpx} only includes waypoints.

\begin{notice}{note}{Nota:}
Navegadores GPS permitem armazenar dados em diferentes sistemas de coordenadas. Quando baixar algum arquivo GPX (do navegador GPS ou de algum site da WEB) e for carregá-lo no Quantum GIS, esteja certo de que os dados estejam em WGS84(latitude/longitude). O Quantum GIS espera que tais dados estejam nesse format, que são as especificações oficiais do GPS. Para maiores informações, acesse \href{http://www.topografix.com/GPX/1/1/}{http://www.topografix.com/GPX/1/1/}
\end{notice}


\subsection{GPSBabel}
\label{docs/user_manual/working_with_gps/plugins_gps:gpsbabel}
Since QGIS uses GPX files you need a way to convert other GPS file formats to
GPX. This can be done for many formats using the free program GPSBabel, which is
available at \href{http://www.gpsbabel.org}{http://www.gpsbabel.org}. This program can also transfer GPS
data between your computer and a GPS device. QGIS uses GPSBabel to do these
things, so it is recommended that you install it. However, if you just want to
load GPS data from GPX files you will not need it. Version 1.2.3 of GPSBabel is
known to work with QGIS, but you should be able to use later versions without
any problems.


\subsection{Importando dados GPS}
\label{docs/user_manual/working_with_gps/plugins_gps:importing-gps-data}
To import GPS data from a file that is not a GPX file, you use the tool
\emph{Import other file} in the GPS Tools dialog. Here you select the file
that you want to import (and the file type), which feature type you want to
import from it, where you want to store the converted GPX file and what the name
of the new layer should be. Note that not all GPS data formats will support all
three feature types, so for many formats you will only be able to choose between
one or two types.


\subsection{Descarregando dados GPS de um receptor}
\label{docs/user_manual/working_with_gps/plugins_gps:downloading-gps-data-from-a-device}
QGIS pode utilizar o GPSBabel para descarregar dados diretamente de um receptor GPS para uma nova camada vetorial no projeto. Para tanto, utilize a opção :guilabel:{\color{red}\bfseries{}{}`}Descarregar do GPS’ da caixa de diálogo de Ferramentas de GPS (veja {\hyperref[docs/user_manual/working_with_gps/plugins_gps:figure-gps-2]{Figure\_GPS\_2}}). Deve-se selecionar o tipo de receptor GPS, a porta serial a que ele está conectado (ou USB, caso o receptor tenha esse tipo de suporte ou GPSD para receptores internos aos equipamentos), o tipo de feição que se queira descarregar, o caminho e nome do arquivo GPX que armazenará os dados e o nome da camada que será criada no projeto.
\phantomsection\label{docs/user_manual/working_with_gps/plugins_gps:figure-gps-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{download.png}
\caption{The download tool}\end{figure}

O tipo de dispositivo GPS indicado na caixa de diálogo, determina a forma como o GPSBabel tenta a comunicação com o receptor GPS. Caso nenhum dos tipos disponíveis funcione para o receptor que se esteja utilizando, pode-se criar um novo tipo (veja a seção:ref: ’definindo novos tipos de dispositivos’).

A opção Porta deve ser o nome de arquivo ou outro nome que o sistema operacional utilize para referenciar à porta física do computador onde o receptor GPS esteja conectado. Pode ser também a opção USB, para os receptores que disponham desse tipo de comunicação com o computador.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} On Linux this is something like \code{/dev/ttyS0} or \code{/dev/ttyS1}

\item {} 
\includegraphics[width=1em]{win.png} On Windows it is \code{COM1} or \code{COM2}.

\end{itemize}

Ao se clicar em \textbf{{[}OK{]}} os dados serão descarregados do receptor e serão inseridos como uma camada no projeto do QGIS.


\subsection{Carregando dados no receptor GPS}
\label{docs/user_manual/working_with_gps/plugins_gps:uploading-gps-data-to-a-device}
É possível carregar dados diretamente de uma camada vetorial do projeto QGIS em um receptor GPS utilizando a opção:guilabel:\emph{Carregar no GPS} da caixa de diálogo de Ferramentas de GPS. Para tanto, basta selecionar a camada que se queira carregar (a qual deve ser referente a um arquivo GPX), qual o tipo de dispositivo GPS e a porta (ou USB) a que o receptor esteja. Assim como no caso de Descarregar dados do GPS, é possível especificar um novo tipo de dispositivo, caso nenhuma opção da lista funcione.

Essa ferramenta é muito útil em combinação com as capacidades de edição do QGIS. É possível carregar um mapa, criar os Waypoints e as rotas e, então, carregá-los no receptor GPS.


\subsection{Definindo novos tipos de dispositivo}
\label{docs/user_manual/working_with_gps/plugins_gps:defining-new-device-types}\label{docs/user_manual/working_with_gps/plugins_gps:defining-new-device}
Existem vários tipos de receptores GPS. Os desenvolvedores do QGIS não são capazes de testar todos esses equipamentos. Caso ocorra a situação em que a comunicação com o receptor não funcione com os tipos listados nas ferramentas :guilabel:{}` Descarregar do GPS {}` e/ou :guilabel:{}` Carregar no GPS {}` é possível definir um tipo específico. Para tanto, deve-se utilizar o editor de dispositivos, clicando no botão \textbf{{[}Editar Dispositivos{]}} nas funções de carregar ou descarregar dados.

To define a new device you simply click the \textbf{{[}New device{]}} button,
enter a name, a download command and an upload command for your device, and
click the \textbf{{[}Update device{]}} button. The name will be listed in the
device menus in the upload and download windows, and can be any string. The
download command is the command that is used to download data from the device
to a GPX file. This will probably be a GPSBabel command, but you can use any
other command line program that can create a GPX file. QGIS will replace the
keywords \code{\%type}, \code{\%in}, and \code{\%out} when it runs the command.

\code{\%type} será substituido por \code{-w} se for para baixar dados de ‘Locais’ (Waypoints), \code{-r} se o caso for para baixar dados do tipo ‘Rota’ (Route) e \code{-t} se for para baixar ‘Trilhas’ (Tracklogs). Esses são os comandos utilizados pelo GPSBabel para baixar o tipo correto de dados.

\code{\%in} will be replaced by the port name that you choose in the download window
and \code{\%out} will be replaced by the name you choose for the GPX file that the
downloaded data should be stored in. So if you create a device type with the
download command \code{gpsbabel \%type -i garmin -o gpx \%in \%out} (this is actually
the download command for the predefined device type `Garmin serial') and then
use it to download waypoints from port \code{/dev/ttyS0} to the file \code{output.gpx},
QGIS will replace the keywords and run the command
\code{gpsbabel -w -i garmin -o gpx /dev/ttyS0 output.gpx}.

Os comandos indicados nas linhas de ‘Carregar’ são aqueles utilizados para carregar os dados no dispositivo. As mesmas palavras-chave são utilizadas, porém \code{\%in} é substituído pelo nome do arquivo GPS que é utilizado e \code{\%out} é substituído pelo nome da porta.

Maiores informações a respeito do GPSBabel e das opções de linha de comando que ele aceita estão disponíveis em \href{http://www.gpsbabel.org}{http://www.gpsbabel.org}.

Uma vez criado um novo dispositivo, ele aparecerá na lista de dispositivos para carregar e descarregar dados.


\section{Rastreio GPS em tempo real}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:sec-gpstracking}\label{docs/user_manual/working_with_gps/live_GPS_tracking:live-gps-tracking}\label{docs/user_manual/working_with_gps/live_GPS_tracking::doc}
To activate Live GPS tracking in QGIS you need to select \emph{Settings \(\rightarrow\)}
\includegraphics{checkbox.png} \emph{GPS information}. You will get a new docked window on the
left side of the canvas.

There are 4 possible screens in this GPS tracking window:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionToggleEditing.png} Cooredenadas da posição GPS e opções para entrar manualmente Vértices e Elementos Vetoriais.

\item {} 
\includegraphics[width=1.5em]{gpstrack_barchart.png} Apresenta a potência do sinal GPS dos satélites em uso.

\item {} 
\includegraphics[width=1.5em]{gpstrack_polarchart.png} Apresenta a tela de posicionamento polar dos satélites visíveis: indicando a posição e o número dos satélites.

\item {} 
\includegraphics[width=1em]{mActionOptions.png} GPS options screen (see {\hyperref[docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-options]{figure\_gps\_options}}).

\end{itemize}

With a plugged in GPS receiver (has to be supported by your operating system)
a simple click on \textbf{{[}Connect{]}} connects the GPS to QGIS. A second click (now
on \textbf{{[}Disconnect{]}}) disconnects the GPS-receiver from your computer. For GNU/Linux
gpsd support is integrated to support connection to most GPS receivers. Therefore
you first have to configure gpsd properly to connect QGIS to it.

\begin{notice}{warning}{Aviso:}
Caso pretenda gravar o percurso do rastreio GPS, é necessário dispor de uma camada vetorial (que aceite linhas) e acionar a edição da mesma para que ela receber a informação do trecho percorrido.
\end{notice}


\subsection{Position and additional attributes}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:position-and-additional-attributes}
\includegraphics[width=1.5em]{mActionToggleEditing.png} If the GPS is receiving signals from satellites you will
see your position in latitude, longitude and altitude together with additional
attributes.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-position}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_main.png}
\caption{GPS tracking position and additional attributes \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Força do sinal GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-signal-strength}
\includegraphics[width=1.5em]{gpstrack_barchart.png} Here you can see the signal strenght of the satellites you
are receiving signals from.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-strength}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_stren.png}
\caption{GPS tracking signal strength \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Posiçao polar GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-polar-window}
\includegraphics[width=1.5em]{gpstrack_polarchart.png} If you want to know where in the sky all the connected
satellites are, you have to switch to the polar screen. You can also see the
ID numbers of the satellites you are receiving signals from.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-polar}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_polar.png}
\caption{GPS tracking polar window \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Opções GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-options}
\includegraphics[width=1em]{mActionOptions.png} In case of connection problems you can switch between:
\begin{itemize}
\item {} 
\includegraphics{radiobuttonon.png} \emph{Autodetect}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Internal},

\item {} 
\includegraphics{radiobuttonon.png} \emph{Serial device}

\item {} 
\includegraphics{radiobuttonon.png} \emph{gpsd} (selecting Host, Port and Device your
GPS is connected to).

\end{itemize}

A click on \textbf{{[}Connect{]}} again initiates the connection to the GPS receiver.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-options}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_options.png}
\caption{GPS tracking options window \includegraphics[width=1em]{nix.png}}\end{figure}

You can activate \includegraphics{checkbox.png} \emph{Automatically save added features}
when you are in editing mode. Or you can can activate \includegraphics{checkbox.png}
\emph{Automatically add points} to the map canvas with a certain width
and color.

Activating \includegraphics{checkbox.png} \emph{Cursor} you can use a slider \includegraphics{slider.png} to shrink
and grow the position cursor on the canvas.

Activating \includegraphics{radiobuttonon.png} \emph{Map centering} allows to decide in which
way the canvas will be updated. This includes `always', `when leaving' if your
recorded coordinates start either to move out of canvas or `never' to keep map
extent.

Finally you can activate \includegraphics{checkbox.png} \emph{Log file} and define a path and a
file where log messages about the gps tracking a logged.

If you want to set a feature manually you have to go back to \includegraphics[width=1.5em]{mActionToggleEditing.png}
$^{\text{Position}}$ and click on \textbf{{[}Add Point{]}} or \textbf{{[}Add track point{]}}.

\index{GRASS}

\chapter{Integração com SIG GRASS}
\label{docs/user_manual/grass_integration/grass_integration:index-0}\label{docs/user_manual/grass_integration/grass_integration:grass-gis-integration}\label{docs/user_manual/grass_integration/grass_integration::doc}\label{docs/user_manual/grass_integration/grass_integration:sec-grass}
O complemento GRASS promove o acesso para o SIG GRASS (ver GRASS-PROJECT {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}}) base de dados e funcionalidades. Isso inclui visualização de camadas raster e vetoriais GRASS, digitalização de camadas vetoriais, edição de atributos vetoriais, criação de novas camadas vetoriais e análise de dados 2D e 3D GRASS com mais de 300 modulos GRASS.

Nesta seção, vamos apresentar as funcionalidades do complemento e dar alguns exemplos de gestão e trabalhos com dados do GRASS. As seguintes características principais são fornecidas com o menu da barra de ferramentas, quando você inicia o complento GRASS, como descrito na seção: ref: \emph{sec\_starting\_grass}:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{grass_open_mapset.png} $^{\text{Abrir mapset}}$

\item {} 
\includegraphics[width=1.5em]{grass_new_mapset.png} $^{\text{Novo mapset}}$

\item {} 
\includegraphics[width=1.5em]{grass_close_mapset.png} $^{\text{Fechar mapset}}$

\item {} 
\includegraphics[width=1.5em]{grass_add_vector.png} $^{\text{Adicionar uma camada vetorial do GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Adicionar uma camada raster do GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_new_vector_layer.png} $^{\text{Criar um novo vetor do GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_edit.png} $^{\text{Editar camada vetorial do GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_tools.png} $^{\text{Abrir ferramentas GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_region.png} $^{\text{Mostrar a região atual do GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_region_edit.png} $^{\text{Edita região atual do GRASS}}$

\end{itemize}

\index{GRASS!Start Plugin}

\section{Iniciando o complemento GRASS}
\label{docs/user_manual/grass_integration/grass_integration:starting-the-grass-plugin}\label{docs/user_manual/grass_integration/grass_integration:index-1}\label{docs/user_manual/grass_integration/grass_integration:sec-starting-grass}
To use GRASS functionalities and/or visualize GRASS vector and raster layers in
QGIS, you must select and load the GRASS plugin with the Plugin Manager.
Therefore click the menu \emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png}
\emph{Manage Plugins}, select \includegraphics{checkbox.png} \emph{GRASS} and click
\textbf{{[}OK{]}}.

Agora você pode começar a carregar camadas raster e vetoriais a partir de um GRASS existente: arquivo: \emph{LOCALIZAÇÃO} (ver seção: ref: \emph{sec\_load\_grassdata}). Ou você cria um novo GRASS: arquivo: \emph{LOCALIZAÇÃO} com QGIS (ver seção: ref: \emph{sec\_create\_loc}) e importa alguns dados raster e vetor (ver Seção: ref: \emph{sec\_import\_loc\_data}) para a análise com a caixa de ferramentas GRASS (ver seção: ref: \emph{subsec\_grass\_toolbox}).


\section{Carregando camadas raster e vetorial GRASS}
\label{docs/user_manual/grass_integration/grass_integration:loading-grass-raster-and-vector-layers}\label{docs/user_manual/grass_integration/grass_integration:sec-load-grassdata}
\index{GRASS!loading data}
Com o complemento GRASS, voce pode carregar camadas raster e vetor usando o botão apropriado do menu da barra de ferramentas. Como exemplo usamos o banco de dados alaska do QGIS (ver seção {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dados de exemplo}}}). Ele inclue uma pequena e simples camada GRASS:arquivo:\emph{LOCALIZAÇÃO} com 3 camadas vetoriais e 1 camada raster de elevação.
\begin{enumerate}
\item {} 
Criar uma pasta nova {\color{red}\bfseries{}:arquivo:{}`grassdata{}`}, baixar o conjunto de dados alaska QGIS {\color{red}\bfseries{}:arquivo:{}`qgis\textbackslash{}\_sample\textbackslash{}\_data.zip{}`} de \href{http://download.osgeo.org/qgis/data/}{http://download.osgeo.org/qgis/data/} e descompacte o arquivo em:arquivo:\emph{grassdata}.

\item {} 
Iniciar QGIS.

\item {} 
If not already done in a previous QGIS session, load the GRASS plugin
clicking on \emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png}
\emph{Manage Plugins} and activate \includegraphics{checkbox.png} \emph{GRASS}.
The GRASS toolbar appears in the QGIS main window.

\item {} 
Na barra de ferramentas GRASS. clique no \includegraphics[width=1.5em]{grass_open_mapset.png}:sup: ícone \emph{Abrir mapset} para abrir o: arquivo: assistente \emph{MAPSET}.

\item {} 
Para: arquivo: \emph{Gisdbase} busque e selecione ou digite o caminho para a pasta recém criada: arquivo: \emph{grassdata}.

\item {} 
You should now be able to select the \emph{LOCATION} \includegraphics{selectstring.png} \code{alaska}
and the \emph{MAPSET} \includegraphics{selectstring.png} \code{demo}.

\item {} 
Clique \textbf{{[}OK{]}}. Observe que algumas ferramentas anteriormente desabilitadas na barra de ferramentas GRASS agora estão habilitadas.

\item {} 
Clique em \includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Adicionar camada raster GRASS}}$, escolha o nome do mapa: arquivo: \emph{gtopo30} e clique \textbf{{[}OK{]}}. A camada de elevação será visualizada.

\item {} 
Clique em \includegraphics[width=1.5em]{grass_add_vector.png}: sup: `Adicionar camada vetorial GRASS{}`, escolha o nome do mapa: arquivo:\emph{alaska} e clique: menuselection:\emph{OK}. O limite da camada vetorial alaska será sobreposto em cima do: arquivo: mapa \emph{GTOPO30}. Agora você pode adaptar as propriedades da camada, conforme descrito no capítulo: ref: \emph{vector\_properties\_dialog}, por exemplo, alterar a opacidade, preenchimento e contorno de cor.

\item {} 
Também carregar as outras duas camadas vetor {\color{red}\bfseries{}:arquivo:{}`rivers{}`} e {\color{red}\bfseries{}:arquivo:{}`airports{}`} e adaptar as suas propriedades.

\end{enumerate}

Como você pode ver, é muito simples carregar camadas raster e vetoriais GRASS no QGIS. Consulte as seções seguintes para editar dados do GRASS e criar um novo {\color{red}\bfseries{}:arquivo:{}`LOCATION{}`}. Mais amostras GRASS em: arquivo: \emph{LOCATIONs} estão disponíveis no site do GRASS em \href{http://grass.osgeo.org/download/data.php}{http://grass.osgeo.org/download/data.php}.

\begin{notice}{tip}{Dica:}
\textbf{Carregando dados GRASS}

If you have problems loading data or QGIS terminates abnormally, check to make
sure you have loaded the GRASS plugin properly as described in section
{\hyperref[docs/user_manual/grass_integration/grass_integration:sec-starting-grass]{\emph{Iniciando o complemento GRASS}}}.
\end{notice}


\section{Localização e MAPSET GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-location-and-mapset}\label{docs/user_manual/grass_integration/grass_integration:sec-about-loc}
GRASS data are stored in a directory referred to as GISDBASE. This directory often
called \code{grassdata}, must be created before you start working with the GRASS
plugin in QGIS. Within this directory, the GRASS GIS data are organized by projects
stored in subdirectories called \code{LOCATION}. Each \code{LOCATION} is defined
by its coordinate system, map projection and geographical boundaries. Each
\code{LOCATION} can have several \code{MAPSETs} (subdirectories of the
\code{LOCATION}) that are used to subdivide the project into different topics,
subregions, or as workspaces for individual team members (Neteler \& Mitasova
2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}}). In order to analyze vector and raster layers
with GRASS modules, you must import them into a GRASS \code{LOCATION} (This is
not strictly true - with the GRASS modules \code{r.external} and \code{v.external}
you can create read-only links to external GDAL/OGR-supported data sets without
importing them. But because this is not the usual way for beginners to work with
GRASS, this functionality will not be described here.).
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-location-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{grass_location.png}
\caption{GRASS data in the alaska LOCATION}\end{figure}


\subsection{Criando uma nova Localização GRASS}
\label{docs/user_manual/grass_integration/grass_integration:sec-create-loc}\label{docs/user_manual/grass_integration/grass_integration:creating-a-new-grass-location}
Como exemplo aqui veja a amostra GRASS {\color{red}\bfseries{}:arquivo:{}`LOCATION alaska{}`}, que é projetada em projeção Albers Equal Area, com a unidade pés foi criada para o conjunto de dados da amostra QGIS. Esta amostra GRASS:arquivo:\emph{LOCATION alaska} será usada para todos os exemplos e exercícios nos seguintes capítulos relacionados com SIG GRASS. Ela é usada para baixar e instalar o conjunto de dados em seu computador: ref: \emph{label\_sampledata}).
\begin{enumerate}
\item {} 
Inicie o QGIS e certifique-se que o complemento GRASS foi carregado.

\item {} 
Visualize o {\color{red}\bfseries{}:arquivo:{}`alaska.shp{}`} Shapefile (ver Seção {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-load-shapefile]{\emph{Carregando um Shapefile}}}) da base de dados alaska QGIS {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dados de exemplo}}}.

\item {} 
In the GRASS toolbar, click on the \includegraphics[width=1.5em]{grass_new_mapset.png}$^{\text{New mapset}}$ icon
to bring up the \code{MAPSET} wizard.

\item {} 
Selecione uma pasta existente GRASS base de dados (GISDBASE): arquivo: \emph{grassdata} ou crie um novo: arquivo: \emph{LOCATION} usando um gerenciador de arquivos em seu computador. Então, clique \textbf{{[}Próximo{]}}.

\item {} 
Podemos usar este assistente para criar um novo: arquivo: \emph{MAPSET} dentro de um já existente: arquivo: \emph{LOCATION `(ver seção: ref:} sec\_add\_mapset \emph{) ou para criar um novo: arquivo:} Location'. Clique no botão de rádio \textbar{} radiobuttonon {\color{red}\bfseries{}\textbar{}}: guilabel: `Criar nova location {\color{red}\bfseries{}{}`}(ver {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-location-2]{figure\_grass\_location\_2}}).

\item {} 
Digite um nome para o: arquivo:{\color{red}\bfseries{}{}`}Location' - que usamos alasca e clique \textbf{{[}Próximo{]}}.

\item {} 
Defina a projeção, clicando no botão de rádio \textbar{} radiobuttonon {\color{red}\bfseries{}\textbar{}}: guilabel: {\color{red}\bfseries{}{}`}Projeção' para habilitar a lista de projeções.

\item {} 
We are using Albers Equal Area Alaska (feet) projection. Since we
happen to know that it is represented by the EPSG ID 2964, we enter it in
the search box. (Note: If you want to repeat this process for another
\code{LOCATION} and projection and haven't memorized the EPSG ID,
click on the \includegraphics[width=1.5em]{mIconProjectionEnabled.png} $^{\text{projector}}$ icon in the lower right-hand
corner of the status bar (see Section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Trabalhando com Projeções}}})).

\item {} 
In \emph{Filter} insert 2964 to select the projection.

\item {} 
Clique \textbf{{[}Próximo{]}}.

\item {} 
Para definir a região padrão, temos que digitar no: arquivo: \emph{LOCATION} limites na direção norte, sul, leste e oeste. Aqui, basta clicar no botão: guilabel: \emph{estabeleça} QGIS dimensão atual, para aplicar a extensão da camada carregada: arquivo: \emph{alaska.shp} como a extensão da região padrão do GRASS.

\item {} 
Clique \textbf{{[}Próximo{]}}.

\item {} 
We also need to define a \code{MAPSET} within our new
\code{LOCATION}. You can name it whatever you like - we used demo (When
creating a new \code{LOCATION}). GRASS automatically creates a special
\code{MAPSET} called \code{PERMANENT} designed to store the core data for
the project, its default spatial extend and coordinate system definitions
(Neteler \& Mitasova 2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}})

\item {} 
Confira o resumo para ter certeza que está correto e clique \textbf{{[}Fim{]}}.

\item {} 
O novo: arquivo:\emph{LOCATION alaska} e dois: arquivo:\emph{MAPSETs demo} e: arquivo:\emph{PERMANENT' são criados. O conjunto de trabalho aberto no momento é: arquivo:{}`MAPSET demo}, como você definiu.

\item {} 
Note que algumas das ferramentas na barra de ferramentas GRASS que foram desativadas estão agora habilitadas.

\end{enumerate}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-location-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{create_grass_location.png}
\caption{Creating a new GRASS LOCATION or a new MAPSET in QGIS}\end{figure}

Se isso parecia ser uma série de etapas, não é realmente tão ruim assim e uma maneira muito rápida de criar um: arquivo: \emph{LOCATION `. O: arquivo: {}`LOCATION alaska `já está pronto para importação de dados (ver seção: ref:} sec\_import\_loc\_data \emph{). Você também pode usar o vetor e dados raster já existentes no GRASS exemplo: arquivo: {}`LOCATION alaska} incluído no QGIS alaska conjunto de dados: ref: \emph{label\_sampledata} e avance para a Seção: ref: \emph{label\_vectmodel}.


\subsection{Adicionando um novo MAPSET}
\label{docs/user_manual/grass_integration/grass_integration:adding-a-new-mapset}\label{docs/user_manual/grass_integration/grass_integration:sec-add-mapset}
A user has only write access to a GRASS \code{MAPSET} he created. This means that
besides access to his own \code{MAPSET}, each user can read maps in other user's
\code{MAPSETs}, but he can modify or remove only the maps in his own \code{MAPSET}.

All \code{MAPSETs} include a \code{WIND} file that stores the current boundary
coordinate values and the currently selected raster resolution (Neteler \& Mitasova
2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Referências Bibliográficas e Web}}}, see Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass-region]{\emph{A ferramenta região GRASS}}}).
\begin{enumerate}
\item {} 
Inicie o QGIS e certifique-se que o complemento GRASS foi carregado.

\item {} 
Na barra de ferramentas GRASS, clique no ícone \textbar{} grass\_new\_mapset {\color{red}\bfseries{}\textbar{}}: sup: `Novo mapset' para abrir o: arquivo: assistente \emph{MAPSET}.

\item {} 
Selecione a pasta GRASS base de dados (GISDBASE): arquivo: \emph{grassdata} com: arquivo: \emph{LOCATION alaska}, onde queremos adicionar mais um: arquivo: \emph{MAPSET}, chamado teste.

\item {} 
Clique \textbf{{[}Próximo{]}}.

\item {} 
Podemos usar este assistente para criar um novo: arquivo: \emph{MAPSET} dentro de um já existente: arquivo: \emph{LOCATION `ou para criar um completamente novo: arquivo:{}`LOCATION'. Clique no botão de rádio \textbar{} radiobuttonon \textbar{}: guilabel: {}`Selecione a localização} (ver {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-location-2]{figure\_grass\_location\_2}}) e clique \textbf{{[}Próximo{]}}.

\item {} 
Digite o nome: arquivo: \emph{texto} para o novo:arquivo: \emph{MAPSET}. Abaixo no assistente, você verá uma lista de existente: arquivo: \emph{MAPSETs} e seus proprietários.

\item {} 
Clique \textbf{{[}Próximo{]}}, confira o resumo para se certificar de que está tudo correto e clique \textbf{{[}Fim{]}}.

\end{enumerate}


\section{Importando dados para uma localização GRASS}
\label{docs/user_manual/grass_integration/grass_integration:sec-import-loc-data}\label{docs/user_manual/grass_integration/grass_integration:importing-data-into-a-grass-location}
Esta Seção fornece um exemplo de como importar dados vetoriais e raster para o: arquivo: \emph{alaska} GRASS: arquivo: \emph{LOCATION} fornecido pelo conjunto de dados Alaska QGIS. Portanto, usamos uma landcover raster mapa: arquivo: \emph{landcover.img} e um GML arquivo vetorial: arquivo: \emph{lakes.gml} do conjunto de dados QGIS alaska: ref: \emph{label\_sampledata}.
\begin{enumerate}
\item {} 
Inicie o QGIS e certifique-se que o complemento GRASS foi carregado.

\item {} 
Na barra de ferramentas GRASS, clique no ícone \includegraphics[width=1.5em]{grass_open_mapset.png}:sup: `Abrir MAPSET' para abrir o:arquivo:assistente \emph{MAPSET}.

\item {} 
Escolha como base de dados GRASS a pasta: arquivo:\emph{grassdata} no QGIS conjunto de dados alaska, como:arquivo:\emph{LOCATION alaska}, como: arquivo: \emph{MAPSET}: arquivo: {\color{red}\bfseries{}{}`}demo' e clique \textbf{{[}OK{]}}.

\item {} 
Agora, clique no ícone \textbar{} grass\_tools {\color{red}\bfseries{}\textbar{}}: sup: `Abrir ferramentas GRASS \emph{. A caixa de ferramentas GRASS (ver secção: ref: {}`subsec\_grass\_toolbox}) aparece o diálogo.

\item {} 
Para importar o mapa raster: arquivo: \emph{landcover.img}, clique no módulo: arquivo: \emph{r.in.gdal} no: guilabel: \emph{Árvore de Módulos} guia. Este módulo GRASS permite importar arquivos raster GDAL suportados para o GRASS: arquivo: \emph{LOCATION'. O módulo diálogo para: arquivo{}`r.in.gdal} aparece.

\item {} 
Procure a pasta: arquivo: \emph{raster} no conjunto de dados QGIS alaska e selecione o arquivo: \emph{landcover.img}.

\item {} 
Como nome de saída raster defina: arquivo:\emph{landcover\_grass} e clique \textbf{{[}Rodar{]}}. Em: guilabel:guia `Saída' você vê o comando GRASS atualmente em execução: arquivo:\emph{r.in.gdal-o entrada=/path/to/landcover.img saída=landcover\_grass}.

\item {} 
Quando ele diz \textbf{Terminou com sucesso} clique em \textbf{{[}Ver saída{]}}. O: arquivo: \emph{landcover\_grass} camada raster agora é importado para o GRASS e será visualizada na tela QGIS.

\item {} 
Para importar o arquivo vetorial GML: arquivo: \emph{lakes.gml}, clique no módulo: arquivo: \emph{v.in.ogr} na guia: guilabel: \emph{Árvore de Módulos}. Este módulo GRASS permite importar arquivos vetoriais suportados OGR para o GRASS: arquivo: \emph{LOCATION'. O módulo diálogo para: arquivo: {}`v.in.ogr} aparece.

\item {} 
Procure a pasta: arquivo: \emph{GML} no conjunto de dados QGIS alaska e selecione o arquivo:\emph{lakes.gml} como arquivo OGR.

\item {} 
Como nome de saída vetor defina: arquivo:\emph{lakes\_grass} e clique \textbf{{[}Rodar{]}}. Você não precisa se preocupar com as outras opções neste exemplo. Em guia: guilabel: `Saída' você vê o comando GRASS atualmente em execução: arquivo:\emph{v.in.ogr-o dsn=/path/to/lakes.gml saída=lakes\_grass}.

\item {} 
Quando ele diz \textbf{Terminado com sucesso} clique em \textbf{{[}Ver saída{]}}. O: arquivo:\emph{lakes \_grass} camada vetorial é agora importada para o GRASS e será visualizada na tela QGIS.

\end{enumerate}


\section{O modelo de dados vetorial do GRASS}
\label{docs/user_manual/grass_integration/grass_integration:label-vectmodel}\label{docs/user_manual/grass_integration/grass_integration:the-grass-vector-data-model}
\index{GRASS!vector data model}
É importante compreender o modelo de dados vetor GRASS antes da digitalização.

\index{GRASS!digitizing}
Em geral, GRASS utiliza um modelo de vetor topológico.

\index{GRASS!topology}
Isto significa que as áreas não são representadas como polígonos fechados, mas por um ou mais limites. A fronteira entre duas áreas adjacentes é digitalizada apenas uma vez, e é compartilhada por ambas as áreas. Limites precisam estar conectados e fechados sem lacunas. Uma área é identificada (e rotulada) pelo **  centróide** da área.

Besides boundaries and centroids, a vector map can also contain points and lines.
All these geometry elements can be mixed in one vector and will be represented
in different so called `layers' inside one GRASS vector map. So in GRASS a layer
is not a vector or raster map but a level inside a vector layer. This is important
to distinguish carefully (Although it is possible to mix geometry elements, it
is unusual and even in GRASS only used in special cases such as vector network
analysis. Normally you should prefere to store different geometry elements in
different layers.).

É possível armazenar várias ``camadas'' em um conjunto de dados vetor. Por exemplo, campos, florestas e lagos podem ser armazenados em um vetor. Floresta adjacente e lago podem compartilhar o mesmo limite, mas eles têm tabelas de atributos separadas. Também é possível fixar atributos por limites. Por exemplo, a fronteira entre o lago e floresta é uma estrada, para que possa ter uma tabela de atributos diferentes.

A ``camada'' de recurso é definida por ``camada'' dentro do GRASS. ``Camada'' é o número que define, se houver mais do que uma camada dentro do conjunto de dados, por exemplo, se a geometria é floresta ou lago. Por enquanto, ela pode ser apenas um número, no futuro, GRASS também suportará nomes como campos na interface do usuário.

Attributes can be stored inside the GRASS \code{LOCATION} as DBase or SQLITE3 or
in external database tables, for example PostgreSQL, MySQL, Oracle, etc.

\index{GRASS!attribute storage}
Atributos em tabelas de base de dados estão ligados a elementos geométricos usando um valor `categoria'.

\index{GRASS!attribute linkage}
`Categoria' (chave, ID) é um número inteiro ligado a geometrias primitivas, e que é usada como ligação a uma coluna chave na tabela de base de dados.

\begin{notice}{tip}{Dica:}
\textbf{Aprendendo um Modelo Vetor GRASS}

A melhor maneira de aprender o modelo Vetor Grass e as suas capacidades é baixar um dos muitos tutoriais GRASS onde o modelo vetorial é descrito mais profundamente. Veja \href{http://grass.osgeo.org/gdp/manuals.php}{http://grass.osgeo.org/gdp/manuals.php} para mais informações, livros e tutoriais em várias línguas.
\end{notice}

\index{GRASS|see{Creating new vectors;editing;creating a new layer}}

\section{Criando uma nova camada vetorial GRASS}
\label{docs/user_manual/grass_integration/grass_integration:creating-new-grass-vectors}\label{docs/user_manual/grass_integration/grass_integration:index-8}\label{docs/user_manual/grass_integration/grass_integration:creating-a-new-grass-vector-layer}
Para criar uma nova camada vetor GRASS com o complemento GRASS clique no \textbar{} grass\_new\_vector\_layer {\color{red}\bfseries{}\textbar{}}: sup: \emph{Criar novo vetor GRASS} ícone da barra de ferramentas. Digite um nome na caixa de texto e você pode começar a digitalização de geometrias ponto, linha ou polígono, seguindo o procedimento descrito na Seção: ref: \emph{grass\_digitizing}.

No GRASS, é possível organizar toda sorte de tipos de geometria (ponto, linha e área) em uma camada, porque o GRASS utiliza um modelo de vetor topológico, assim você não precisa selecionar o tipo de geometria ao criar um novo vetor GRASS. Isto é diferente de criação Shapefile com QGIS, devido à este usar o modelo vetor de características simples (ver Seção: ref: \emph{sec\_create\_shape}).

\begin{notice}{tip}{Dica:}
\textbf{Criando uma tabela de atributos para uma nova camada vetorial GRASS}

Se você deseja atribuir atributos a seus recursos de geometria digitalizados, certifique-se de criar uma tabela de atributos com colunas antes de começar a digitalização (ver {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-5]{figure\_grass\_digitizing\_5}}).
\end{notice}


\section{Digitalizando e editando uma camada vetorial GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-digitizing}\label{docs/user_manual/grass_integration/grass_integration:digitizing-and-editing-a-grass-vector-layer}
\index{GRASS!digitizing tools}
As ferramentas de digitalização para as camadas vetor GRASS são acessadas ​​usando o \textbar{} grass\_edit {\color{red}\bfseries{}\textbar{}}: sup:ícone \emph{Editar camada vetorial GRASS} na barra de ferramentas. Certifique-se de que você tenha carregado um vetor GRASS e é a camada selecionada na legenda antes de clicar na ferramenta de edição. Figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-2]{figure\_grass\_digitizing\_2}} mostra o diálogo de edição GRASS que é exibido quando você clica na ferramenta de edição. As ferramentas e as configurações serão discutidas nas seções seguintes.

\begin{notice}{tip}{Dica:}
\textbf{Digitalizando polígonos no GRASS}

If you want to create a polygon in GRASS, you first digitize the boundary of
the polygon, setting the mode to `No category'. Then you add a centroid
(label point) into the closed boundary, setting the mode to `Next not used'.
The reason is, that a topological vector model links attribute information of
a polygon always to the centroid and not to the boundary.
\end{notice}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:label-grasstoolbar}
\textbf{Barra de Ferramentas}

Na {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-1]{figure\_grass\_digitizing\_1}} você vê os ícones da barra de ferramentas de digitalização Grass fornecido pelo complemento GRASS. Tabela {\hyperref[docs/user_manual/grass_integration/grass_integration:table-grass-digitizing-1]{table\_grass\_digitizing\_1}} explica as funcionalidades disponíveis.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_toolbar.png}
\caption{GRASS Digitizing Toolbar}\end{figure}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:table-grass-digitizing-1}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
Ícone
} & \textsf{\relax 
Ferramenta
} & \textsf{\relax 
Propósito
}\\
\hline
\includegraphics[width=1.5em]{grass_new_point.png}
 & 
Novo Ponto
 & 
Digitaliza novo ponto
\\

\includegraphics[width=1.5em]{grass_new_line.png}
 & 
Nova Linha
 & 
Digitaliza nova linha
\\

\includegraphics[width=1.5em]{grass_new_boundary.png}
 & 
Nova Fronteira
 & 
Digitaliza novo limite (acaba ao selecionar nova ferramenta)
\\

\includegraphics[width=1.5em]{grass_new_centroid.png}
 & 
Novo Centróide
 & 
Digitaliza novo centróide (etiqueta da área existente)
\\

\includegraphics[width=1.5em]{grass_move_vertex.png}
 & 
Mova vértice
 & 
Mova um vértice da linha ou limite existente e identifique nova posição
\\

\includegraphics[width=1.5em]{grass_add_vertex.png}
 & 
Adiciona vértice
 & 
Adiciona novo vértice à uma linha existente
\\

\includegraphics[width=1.5em]{grass_delete_vertex.png}
 & 
Exclua vértice
 & 
Exclua vértice da linha existente (confirme vértice selecionado por outro clique)
\\

\includegraphics[width=1.5em]{grass_move_line.png}
 & 
Mova elemento
 & 
Mova limite, linha, ponto ou centróide selecionado e clique em nova posição
\\

\includegraphics[width=1.5em]{grass_split_line.png}
 & 
Dividir linha
 & 
Dividir uma linha existente em 2 partes
\\

\includegraphics[width=1.5em]{grass_delete_line.png}
 & 
Exclua elemento
 & 
Exclua limite existente, linha, ponto ou centróide (confirme elemento selecionado por outro clique)
\\

\includegraphics[width=1.5em]{grass_edit_attributes.png}
 & 
Editar atributos
 & 
Editar atributos do elemento selecionado (note que um elemento pode representar mais recursos, veja acima)
\\

\includegraphics[width=1.5em]{grass_close_edit.png}
 & 
Fechar
 & 
Fechar sessão e salvar o estado atual (reconstrói topologia depois)
\\
\hline\end{tabulary}

\begin{quote}

GRASS Digitalização de Tabela 1: GRASS Ferramentas de Digitalização
\end{quote}

\textbf{Aba Categoria}

\index{GRASS!category settings}
A: guilabel: guia \emph{Categoria} permite definir a forma em que os valores da categoria serão atribuídos à um novo elemento geométrico.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_category.png}
\caption{GRASS Digitizing Category Tab}\end{figure}
\begin{itemize}
\item {} 
\textbf{Modo}: qual valor da categoria deve ser aplicado aos novos elementos geométricos.
\begin{itemize}
\item {} 
Próximo não usado - aplica próximo valor de categoria ainda não usados para elemento geométrico.

\item {} 
Entrada Manual - defina manualmente o valor de categoria para o elemento geométrico no campo de entrada `Categoria'.

\item {} 
Sem categoria - Não aplica um valor de categoria ao elemento geométrico. Isto é, por exemplo usado para os limites da área, pois os valores de categoria são conectados através do centróide.

\end{itemize}

\item {} 
\textbf{Categoria} - Um número (ID) está anexo a cada elemento geométrico digitalizado. Ele é usado para conectar cada elemento geométrico com seus atributos.

\item {} 
\textbf{Campo (camada)} - Cada elemento geométrico pode ser conectado com várias tabelas de atributos usando diferentes camadas geométricas GRASS. Número da camada padrão é 1.

\end{itemize}

\begin{notice}{tip}{Dica:}
\textbf{Criando uma `camada' adicional GRASS com QGIS}

If you would like to add more layers to your dataset, just add a new number
in the `Field (layer)' entry box and press return. In the Table tab you can
create your new table connected to your new layer.
\end{notice}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:label-settingtab}
\textbf{Aba Configurações}

\index{GRASS!snapping tolerance}
A: guilabel: guia \emph{Configurações} permite que você defina o encaixe em pixels da tela. O limite que define qual distância para novos pontos de linha ou extremidades são agarrados por nós existentes. Isso ajuda a evitar lacunas ou oscilações entre fronteiras. O padrão é definido como 10 pixels.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_settings.png}
\caption{GRASS Digitizing Settings Tab}\end{figure}

\textbf{Aba Simbologia}

\index{GRASS!symbology settings}
A: guilabel: guia \emph{Simbologia} permite ver e definir simbologia e definições de cor para vários tipos de geometria e seu estado topológico (por exemplo limite fechado / aberto).
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_symbology.png}
\caption{GRASS Digitizing Symbolog Tab}\end{figure}

\textbf{Aba Tabela}

\index{GRASS!table editing}
A: guilabel: guia `Tabela' fornece informação sobre a tabela base de dados para uma dada ``camada''. Aqui você pode adicionar novas colunas a uma tabela de atributos existente ou criar uma nova tabela base de dados para uma nova camada vetorial GRASS (ver Seção: ref: \emph{creating\_new\_grass\_vectors}).
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_table.png}
\caption{GRASS Digitizing Table Tab}\end{figure}

\begin{notice}{tip}{Dica:}
\textbf{GRASS Edita Permissões}

You must be the owner of the GRASS \code{MAPSET} you want to edit. It is
impossible to edit data layers in a \code{MAPSET} that is not yours, even
if you have write permissions.
\end{notice}


\section{A ferramenta região GRASS}
\label{docs/user_manual/grass_integration/grass_integration:the-grass-region-tool}\label{docs/user_manual/grass_integration/grass_integration:sec-grass-region}
\index{GRASS!region}
A definição região (janela definindo área de trabalho) no GRASS é importante para trabalhar com camadas raster. Análise vetorial por padrão não é limitado a quaisquer definições de região definida. Mas todos os rasters recém-criados terão a extensão espacial e resolução da região GRASS atualmente definidas, independentemente de sua extensão e resolução originais. A região GRASS atual é armazenada no: arquivo: \emph{\$ local / \$ mapset / WIND} arquivo, e define norte, sul, leste e oeste dos limites, o número de colunas e linhas, a resolução espacial horizontal e vertical.

É possível ligar/desligar a visualização da região GRASS na tela QGIS usando o \includegraphics[width=1.5em]{grass_region.png}: sup: botão{}`Mostrar região GRASS atual{}`.

\index{GRASS!region display}
Com o \includegraphics[width=1.5em]{grass_region_edit.png}: sup: ícone \emph{Edita região atual GRASS} você pode abrir um diálogo para mudar a região atual e a simbologia da região retângulo GRASS na tela QGIS. Digite os novos limites e resolução da região e clique \textbf{{[}OK{]}}. Ele também permite selecionar uma nova região interativamente com o mouse na tela QGIS. Portanto, clique com o botão esquerdo do mouse na tela QGIS, abra um retângulo, feche-o usando o botão esquerdo novamente e clique \textbf{{[}OK{]}}.

\index{GRASS!region editing}
O módulo GRASS: arquivo:\emph{g.region' fornece muito mais parâmetros para definir ampliação apropriada de uma região e resolução para sua análise raster. Você pode usar esses parâmetros com a caixa de ferramentas GRASS, descrito na Seção: ref: {}`subsec\_grass\_toolbox}.


\section{A caixa de ferramentas GRASS}
\label{docs/user_manual/grass_integration/grass_integration:the-grass-toolbox}\label{docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox}
\index{GRASS toolbox}
A \includegraphics[width=1.5em]{grass_tools.png}: sup: caixa \emph{Abra Ferramentas GRASS} fornece GRASS funcionalidades do módulo para trabalhar com dados dentro de um GRASS selecionado: arquivo: \emph{LOCATION' e: arquivo: {}`MAPSET}. Para usar a caixa de ferramentas GRASS que você precisa para abrir um: arquivo: \emph{LOCATION} e: arquivo: \emph{MAPSET} onde você tem permissão de escrita (geralmente concedido, se você criou o: arquivo: \emph{MAPSET}). Isto é necessário, porque novos raster ou camadas vetoriais criados durante a análise precisa ser escrito para o selecionado: arquivo: \emph{LOCATION} e: arquivo: \emph{MAPSET}.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-toolbox-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_toolbox_moduletree.png}
\caption{GRASS Toolbox and Module Tree \includegraphics[width=1em]{nix.png}}\end{figure}

A linha de comando GRASS dentro da caixa de ferramentas GRASS prove o acesso a quase todos os (mais de 330) módulos GRASS através de uma interface de linha de comando. Para oferecer um ambiente de trabalho mais amigável, cerca de 200 dos módulos GRASS disponíveis e funcionalidades também são fornecidos pelo diálogos gráficos dentro da caixa de ferramentas do complemento GRASS.


\subsection{Trabalhando com módulos GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-modules}\label{docs/user_manual/grass_integration/grass_integration:working-with-grass-modules}
The GRASS Shell inside the GRASS Toolbox provides access to almost all (more than
300) GRASS modules in a command line interface. To offer a more user friendly
working environment, about 200 of the available GRASS modules and functionalities
are also provided by graphical dialogs.

A complete list of GRASS modules available in the graphical Toolbox in QGIS version
1.8.0 is available in the GRASS wiki ( \href{http://grass.osgeo.org/wiki/GRASS-QGIS\_relevant\_module\_list}{http://grass.osgeo.org/wiki/GRASS-QGIS\_relevant\_module\_list}).

Também é possível personalizar o conteúdo da Caixa de ferramentas GRASS. Este procedimento é descrito na Seção: ref: {\color{red}\bfseries{}{}`}sec\_toolbox-customizing'.

Como mostrado na {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-toolbox-1]{figure\_grass\_toolbox\_1}}, você pode olhar para o módulo apropriado GRASS usando os tematicamente agrupados: guilabel: \emph{Módulos Árvore {}` ou o pesquisável: guilabel: {}`Aba Lista de Módulos}.

Clicking on a graphical module icon a new tab will be added to the toolbox dialog
providing three new sub-tabs \emph{Options}, \emph{Output} and \emph{Manual}.

\textbf{Opções}

The \emph{Options} tab provides a simplified module dialog where you can
usually select a raster or vector layer visualized in the QGIS canvas and enter
further module specific parameters to run the module.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_module_option.png}
\caption{GRASS Toolbox Module Options \includegraphics[width=1em]{nix.png}}\end{figure}

The provided module parameters are often not complete to keep the dialog clear.
If you want to use further module parameters and flags, you need to start the
GRASS Shell and run the module in the command line.

A new feature in QGIS 1.8.0 is the support for a \emph{show advanced options}
button below the simplified module dialog in the \emph{Options} tab. At the
moment it is only added to the module v.in.ascii as an example use, but will
probably be part of more / all modules in the GRASS toolbox in future versions
of QGIS. This allows to use the complete GRASS module options without the need
to switch to the GRASS Shell.

\textbf{Saída}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_module_output.png}
\caption{GRASS Toolbox Module Output \includegraphics[width=1em]{nix.png}}\end{figure}

The \emph{Output} tab provides information about the output status of the
module. When you click the \textbf{{[}Run{]}} button, the module switches to the
\emph{Output} tab and you see information about the analysis process. If
all works well, you will finally see a \code{Successfully finished} message.

\textbf{Manual}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_module_manual.png}
\caption{GRASS Toolbox Module Manual \includegraphics[width=1em]{nix.png}}\end{figure}

A aba: guilabel: `Manual', mostra a página de ajuda HTML do módulo GRASS. Você pode usá-la para checar outros parâmetros do módulo e bandeiras ou para obter um conhecimento mais profundo sobre o objetivo do módulo. No final de cada página do manual do módulo você vê outras ligações para o: arquivo: {\color{red}\bfseries{}{}`}Índice Principa de Ajuda', o: arquivo: {\color{red}\bfseries{}{}`}Índice Temático' e o: arquivo: {\color{red}\bfseries{}{}`}Índice Completo. Estes links fornecem a mesma informação que se você usar o módulo: arquivo: {}` g.manual'.

\index{GRASS!display results}
\begin{notice}{tip}{Dica:}
\textbf{Mostra Resultados Imediatamente}

Se você quiser exibir os resultados de cálculo imediatamente em sua tela do mapa, você pode usar o botão ``Ver Saída'' na parte inferior da aba módulo.
\end{notice}


\subsection{Exemplos de módulos GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-module-examples}
Os exemplos seguintes demonstrarão o poder de alguns dos módulos grama.


\subsubsection{Criando linhas de contorno}
\label{docs/user_manual/grass_integration/grass_integration:creating-contour-lines}
O primeiro exemplo cria um mapa de contorno vetor a partir de um raster de elevação (DEM). Supondo que você tenha o Alaska: arquivo: \emph{LOCATION'configurado como explicado na Seção: ref:{}`sec\_import\_loc\_data}.
\begin{itemize}
\item {} 
Primeiro, abra o local clicando no \includegraphics[width=1.5em]{grass_open_mapset.png}: sup: botão' Abrir mapset' e escolha o local Alaska.

\item {} 
Agora carregue o raster \code{gtopo30} elevação clicando \includegraphics[width=1.5em]{grass_add_raster.png}: sup: \emph{Adicionar camada raster GRASS' e selecionando o raster {}`{}`gtopo30{}`} a partir do local de demonstração.

\item {} 
Agora, abra a caixa de ferramentas com o \includegraphics[width=1.5em]{grass_tools.png}: sup: botão `Abrir ferramentas GRASS{}`.

\item {} 
Na lista de categorias de ferramentas clique duas vezes: menuselection: \emph{Raster -\textgreater{} Gestão de Superfície -\textgreater{} Gera vetor linhas de contorno}.

\item {} 
Now a single click on the tool \textbf{r.contour} will open the tool dialog as
explained above {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-modules]{\emph{Trabalhando com módulos GRASS}}}. The \code{gtopo30} raster should appear as
the \emph{Name of input raster}.

\item {} 
Type into the \emph{Increment between Contour levels} \includegraphics{selectnumber.png}
the value 100. (This will create contour lines at intervals of 100 meters.)

\item {} 
Type into the \emph{Name for output vector map} the name \code{ctour\_100}.

\item {} 
Clique \textbf{{[}Rodar{]}} para iniciar o processo. Aguarde alguns instantes até que a mensagem \code{Terminado com sucesso} apareça na janela de saída. Então, clique \textbf{{[}Ver saída{]}} e \textbf{{[}fechar{]}}.

\end{itemize}

Como se trata de uma grande região, vai demorar um pouco para exibir. Depois de terminar a renderização, você pode abrir a janela de propriedades da camada para alterar a cor da linha para que os contornos apareçam claramente sobre o raster elevação, como em: ref: \emph{vector\_properties\_dialog}.

Zoom Próximo em uma pequena área montanhosa no centro do Alaska. Ao aproximar-se perto você notará que os contornos tem cantos afiados. GRASS oferece uma ferramenta \textbf{v.generalize} para alterar ligeiramente mapas vetoriais, mantendo a sua forma geral. A ferramenta usa diversos algoritmos diferentes, com propósitos diferentes. Alguns dos algoritmos (por exemplo, Douglas Peuker e redução Vértice) simplificam a linha removendo alguns dos vértices. O vetor resultante carregará mais rápido. Este processo será usado quando você tem um vetor altamente detalhado, mas você está criando um mapa de escala muito pequena, de modo que o detalhe é desnecessário.

\index{GRASS!display results}
\begin{notice}{tip}{Dica:}
\textbf{A ferramenta simplificar}

Note que o complemento fTools QGIS tem um: menuselection: `Simplifique geometrias -\textgreater{}{}`ferramenta que funciona como o GRASS \textbf{v.generalize} algoritmo Douglas-Peuker.
\end{notice}

However, the purpose of this example is different. The contour lines created by
\code{r.contour} have sharp angles that should be smoothed. Among the \textbf{v.generalize}
algorithms there is Chaikens which does just that (also Hermite splines). Be
aware that these algorithms can \textbf{add} additional vertices to the vector,
causing it to load even more slowly.
\begin{itemize}
\item {} 
Abra a caixa de ferramentas GRASS e dê um duplo clique nas categorias: menuselection: \emph{Vector -\textgreater{} Desenvolver mapa -\textgreater{} Generalização}, em seguida, clique no módulo \textbf{v.generalize} para abrir a janela de opções.

\item {} 
Check that the `ctour\_100' vector appears as the \emph{Name of input vector}.

\item {} 
From the list of algorithms choose Chaiken's. Leave all other options at their
default, and scroll down to the last row to enter in the field \emph{Name for output
vector map} `ctour\_100\_smooth', and click \textbf{{[}Run{]}}.

\item {} 
O processo leva alguns instantes. Uma vez \code{Terminado com sucesso} apareça na Janela de saída, clique \textbf{{[}Ver saída{]}} e depois \textbf{{[}fechar{]}}.

\item {} 
É possível mudar a cor do vetor para apresentar claramente o fundo matricial e para contrastar com as linhas de contorno originais. Você notará que as novas linhas de contorno têm cantos mais suaves do que o original, enquanto permanecer fiel à forma geral de origem.

\end{itemize}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{grass_toolbox_vgeneralize.png}
\caption{GRASS module v.generalize to smooth a vector map \includegraphics[width=1em]{nix.png}}\end{figure}

\index{GRASS!toolbox}
\begin{notice}{tip}{Dica:}
\textbf{Outros usos para r.contour}

O procedimento acima descrito pode ser usado em outras situações equivalentes. Se você tem um mapa raster de dados de precipitação, por exemplo, então o mesmo método será usado para criar um mapa de vetores de linhas isoietas (chuvas constantes).
\end{notice}


\subsubsection{Criando um efeito 3D Sombreado}
\label{docs/user_manual/grass_integration/grass_integration:creating-a-hillshade-3d-effect}
Vários métodos são usados ​​para exibir as camadas de elevação e dar um efeito 3D aos mapas. O uso de linhas de contorno como mostrado acima é um método popular, muitas vezes escolhido para produzir mapas topográficos. Outra forma de apresentar um efeito 3D é por sombreamento. O efeito sombreado é criado a partir de uma (elevação) raster DEM primeiro calculando a inclinação e aspecto de cada célula, em seguida, simulando a posição do sol no céu e dando um valor de reflectância a cada célula. Assim você tem enfrentando o sol encostas iluminadas e as encostas de costas para o sol (na sombra) são escurecidas.
\begin{itemize}
\item {} 
Comece este exemplo por carregar o raster \code{gtopo30} elevação . Inicie a caixa de ferramentas do GRASS e sob a categoria Raster duplo clique para abrir: menuselection: \emph{Análise espacial -\textgreater{} Análise do terreno}.

\item {} 
Então, clique \textbf{r.shaded.relief} para abrir o módulo.

\item {} 
Change the \emph{azimuth angle} \includegraphics{selectnumber.png} 270 to 315.

\item {} 
Enter \code{gtopo30\_shade} for the new hillshade raster, and click \textbf{{[}Run}{]}.

\item {} 
Quando o processo termina, adicione o raster sombreado ao mapa. Você deve vê-lo exibido em escala de cinza.

\item {} 
Para visualizar tanto o sombreamento e as cores do \code{gtopo30} juntos, mude o mapa sombreado abaixo do mapa \code{gtopo30} na tabela de conteúdos, em seguida, abra o: menuselection: janela de{}`Propriedades{}` \code{gtopo30}, mude para o: guilabel: guia \emph{transparência} e defina seu nível de transparência em cerca de 25\%.

\end{itemize}

Agora você deve ter a elevação \code{gtopo30} com o seu mapa de cores e configuração de transparência apresentada \textbf{acima} o tons de cinza mapa sombreado. Para ver os efeitos visuais do sombreamento, desligue o mapa \code{gtopo30\_shade} em seguida, ligue-o novamente.

\textbf{Usando a linha de comando GRASS}

O complemento GRASS em QGIS é projetado para os novos usuários do GRASS, e não estão familiarizados com todos os módulos e opções. Como tal, alguns módulos na caixa de ferramentas não mostram todas as opções disponíveis, e alguns módulos não aparecem em tudo. A linha de comando GRASS (ou console) dá ao usuário acesso a esses módulos GRASS adicionais que não aparecem na árvore da caixa de ferramentas, e também algumas opções adicionais aos módulos que estão na caixa de ferramentas com os parâmetros padrão mais simples. Este exemplo demonstra o uso de uma opção adicional para o módulo \textbf{r.shaded.relief} que foi mostrado acima.
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_toolbox_shell.png}
\caption{The GRASS shell, r.shaded.relief module \includegraphics[width=1em]{nix.png}}\end{figure}

O módulo ** r.shaded.relief ** pode ter um parâmetro {}`{}` zmult {}`{}` que multiplica valores de elevação relativos às unidades de coordenadas XY, de modo que o efeito sombreado é ainda mais pronunciado.
\begin{itemize}
\item {} 
Carregue o raster elevação \code{gtopo30} como acima, em seguida, inicie a caixa de ferramentas GRASS e clique na linha de comando GRASS. Na janela, digite o comando \code{r.shaded.relief map=gtopo30 shade=gtopo30\_shade2 azimuth=315 zmult=3} e aperte \textbf{{[}Enter{]}}.

\item {} 
Após o término do processo vá para: guilabel: guia `Buscar' e dê um duplo clique sobre o novo raster \code{gtopo30\_shade2} para exibir no QGIS.

\item {} 
As explained above, shift the shaded relief raster below the gtopo30 raster in
the Table of Contents, then check transparency of the colored gtopo30 layer.
You should see that the 3D effect stands out more strongly compared to the
first shaded relief map.

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{grass_toolbox_shadedrelief.png}
\caption{Displaying shaded relief created with the GRASS module r.shaded.relief \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Estatísticas Raster em um mapa vetor}
\label{docs/user_manual/grass_integration/grass_integration:raster-statistics-in-a-vector-map}
O próximo exemplo mostra como um módulo GRASS pode agregar dados raster e adicionar colunas de estatísticas para cada polígono em um mapa vetor.
\begin{itemize}
\item {} 
Novamente usando os dados do Alasca, consulte a: ref: \emph{sec\_import\_loc\_data} para importar o shapefile árvores do diretório \code{shapefiles} no GRASS.

\item {} 
Now an intermediary step is required: centroids must be added to the imported
trees map to make it a complete GRASS area vector (including both boundaries
and centroids).

\item {} 
Na caixa de ferramentas escolha: menuselection: \emph{Vetor -\textgreater{} Gerenciar recursos}, e abra o módulo \textbf{v.centroids}.

\item {} 
Enter as the \emph{output vector map} `forest\_areas' and run the module.

\item {} 
Now load the \code{forest\_areas} vector and display the types of forests - deciduous,
evergreen, mixed - in different colors: In the layer \emph{Properties}
window, \emph{Symbology} tab, choose from \emph{Legend type}
\includegraphics{selectstring.png} `Unique value' and set the \emph{Classification field}
to `VEGDESC'. (Refer to the explanation of the symbology tab
:ref:sec\_symbology in the vector section).

\item {} 
Próximo reabrir a caixa de ferramentas GRASS e abra: menuselection: \emph{Vetor -\textgreater{} Atualização de Vetor} por outros mapas.

\item {} 
Clique no módulo \textbf{v.rast.stats}. Digite \code{gtopo30}, e \code{forest\_areas}.

\item {} 
Only one additional parameter is needed: Enter \emph{column prefix} \code{elev},
and click \textbf{{[}run{]}}. This is a computationally heavy operation which will run
for a long time (probably up to two hours).

\item {} 
Finalmente abra a tabela de atributos \code{forest\_areas}, e verifique que várias novas colunas foram adicionadas, incluindo \code{elev\_min}, \code{elev\_max}, \code{elev\_mean} etc para cada polígono florestal.

\end{itemize}


\subsection{Trabalhando com o buscador LOCALIZAÇÃO GRASS}
\label{docs/user_manual/grass_integration/grass_integration:working-with-the-grass-location-browser}
\index{GRASS toolbox!Browser}
Another useful feature inside the GRASS Toolbox is the GRASS \code{LOCATION}
browser. In {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-module-7]{figure\_grass\_module\_7}} you can see the current working \code{LOCATION}
with its \code{MAPSETs}.

Nas janelas esquerda do buscador você pode buscar por todos: arquivo: \emph{MAPSETs} dentro do atual: arquivo: {\color{red}\bfseries{}{}`}LOCATION'. A janela direita do navegador mostra algumas meta informações para camadas selecionadas raster ou vetoriais, por exemplo, resolução, o retângulo envolvente, fonte de dados, tabela de atributos ligados para dados vetoriais e um histórico de comando.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_mapset_browser.png}
\caption{GRASS LOCATION browser \includegraphics[width=1em]{nix.png}}\end{figure}

A barra de ferramentas dentro do: guilabel: guia \emph{Busca} oferece as seguintes ferramentas para gerenciar o selecionado: arquivo: \emph{LOCATION}:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{grass_add_map.png}: guilabel:\emph{Adicione mapa selecionado à tela}

\item {} 
\includegraphics[width=1.5em]{grass_copy_map.png}: guilabel:'Copiar mapa selecionado{}`

\item {} 
\includegraphics[width=1.5em]{grass_rename_map.png} :guilabel:'Renomeia mapa selecionado{}`

\item {} 
\includegraphics[width=1.5em]{grass_delete_map.png}: guilabel: `Exclua mapa selecionado{}`

\item {} 
\includegraphics[width=1.5em]{grass_set_region.png}: guilabel:'Defina região atual de mapa selecionado{}`

\item {} 
\includegraphics[width=1.5em]{grass_refresh.png}: guilabel: \emph{Atualizar janela de busca}

\end{itemize}

A guilabel: \includegraphics[width=1.5em]{grass_rename_map.png}: \emph{Renomeia mapa selecionado} e guilabel:\includegraphics[width=1.5em]{grass_delete_map.png}: `Exclua mapa selecionado{}`só trabalha com os mapas dentro do seu selecionado: arquivo:\emph{MAPSET}. Todas as outras ferramentas também trabalham com camadas vetoriais e raster em outro: arquivo: \emph{MAPSET}.


\subsection{Personalizando a caixa de ferramentas GRASS}
\label{docs/user_manual/grass_integration/grass_integration:customizing-the-grass-toolbox}\label{docs/user_manual/grass_integration/grass_integration:sec-toolbox-customizing}
\index{GRASS toolbox!customize}
Quase todos os módulos GRASS podem ser adicionados à caixa de ferramentas GRASS. A interface XML está disponível para analisar os arquivos XML bastante simples, o que configura os módulos de aparência e parâmetros internos da caixa de ferramentas.

Um exemplo de arquivo XML para gerar o módulo \code{v.buffer} (v.buffer.qgm) se parece com isto:

\begin{Verbatim}[commandchars=\\\{\}]
\textless{}?xml version="1.0" encoding="UTF-8"?\textgreater{}
\textless{}!DOCTYPE qgisgrassmodule SYSTEM "http://mrcc.com/qgisgrassmodule.dtd"\textgreater{}

\textless{}qgisgrassmodule label="Vector buffer" module="v.buffer"\textgreater{}
        \textless{}option key="input" typeoption="type" layeroption="layer" /\textgreater{}
        \textless{}option key="buffer"/\textgreater{}
        \textless{}option key="output" /\textgreater{}
\textless{}/qgisgrassmodule\textgreater{}
\end{Verbatim}

The parser reads this definition and creates a new tab inside the toolbox when
you select the module. A more detailed description for adding new modules, changing
the modules group, etc. can be found on the QGIS wiki at
\href{http://hub.qgis.org/projects/quantum-gis/wiki/Adding\_New\_Tools\_to\_the\_GRASS\_Toolbox}{http://hub.qgis.org/projects/quantum-gis/wiki/Adding\_New\_Tools\_to\_the\_GRASS\_Toolbox}


\chapter{OpenStreetMap}
\label{docs/user_manual/osm/openstreetmap:openstreetmap}\label{docs/user_manual/osm/openstreetmap::doc}\label{docs/user_manual/osm/openstreetmap:plugins-osm}
Nos últimos anos, o projeto OpenStreetMap (OSM) ganhou popularidade porque, em muitos países, não há dados geográficos livres, tais como roteiros digitais disponíveis. O objetivo do projeto OSM é criar um mapa livre editável do mundo a partir de dados GPS, imagem de satélite, fotografia aérea ou de conhecimento local. Para apoiar este objetivo, o QGIS oferece um plugin que permite que seus usuários trabalhem com dados OSM.

O plugin OpenStreetMap, um plugin nativo do QGIS, oferece as funcionalidades básicas de manipulação de dados OSM, o que inclui o carregamento de dados, importar, salvar, download, editar e fazer upload de dados de volta para o servidor OpenStreetMap. Ao implementar o plugin OSM a inspiração foi tirada de editores já existentes de dados OSM. O objetivo era o de combinar as suas funcionalidades para obter o melhor resultado possível.

A seção a seguir fornece uma breve introdução aos princípios do projeto OSM.

Partes dos parágrafos seguintes são copiadas do site OpenStreetMap em \href{http://www.openstreetmap.org}{http://www.openstreetmap.org}.


\section{O projeto OpenStreetMap}
\label{docs/user_manual/osm/openstreetmap:the-openstreetmap-project}
OpenStreetMap é um projeto para criar um mapa livre editável do mundo. Os mapas são criados usando dados de dispositivos portáteis de GPS, fotografias aéreas, de outras fontes livres ou simplesmente a partir do conhecimento local. O projeto foi iniciado porque a maioria dos mapas têm restrições legais ou técnicas para sua utilização, restringindo as pessoas de usá-los de forma criativa, produtiva ou outras formas alternativas. Ambas as imagens fundidas e o conjunto de dados vetoriais do OSM estão disponíveis para download sob uma licença Creative Commons Attribution ShareAlike 2.0.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{osmweb.png}
\caption{OpenStreetMap data in the web}\end{figure}

OpenStreetMap foi inspirado em sites como o Wikipédia - a visualização do mapa (ver {\hyperref[docs/user_manual/osm/openstreetmap:figure-openstreetmap-1]{Figura\_OpenStreetMap\_1}}) apresenta um proeminente: guilabel: guia \emph{Editar} e um histórico de revisão completa é mantido. Os usuários registrados podem enviar registos de trajetos de GPS e editar os dados vetoriais, utilizando as ferramentas de edição de dados.

Dados primitivos OSM são uma classe de objetos que podem serem armazenados via API no servidor. Os três tipos de suporte de dados são: \textbf{Node}, \textbf{Way} e \textbf{Relation}.
\begin{itemize}
\item {} 
\textbf{Um nó} é um par de coordenada de latitude/longitude. É usado como um bloco de construção para as outras características e como uma característica própria (pontos de interesse), para serem marcados, conforme necessário.

\item {} 
\textbf{Um Caminho} é uma lista de pelo menos dois nós que descrevem uma feição linear, tal como uma rua, ou similar. Os nós podem fazer parte de vários caminhos.

\item {} 
\textbf{Uma relação} é um grupo de zero ou mais com funções primitivas associadas. Ele é usado para especificar as relações entre objetos, e também pode modelar um objeto abstrato.

\end{itemize}

Diversas características lógicas diferentes de um mapa comum ``Ponto de interesse'', `Estrada', `linha elétrica', `ponto de ônibus' etc) são definidos por estes primitivos. Características do mapa são bem conhecidos na comunidade OSM e são armazenados como etiquetas, com base numa chave e um valor. OSM é normalmente distribuído em formato XML. Carga XML também é utilizada para a comunicação com o servidor do OSM.


\section{QGIS - Conexão OSM}
\label{docs/user_manual/osm/openstreetmap:qgis-osm-connection}\label{docs/user_manual/osm/openstreetmap:id1}
A primeira parte desta seção descreve como dados primitivos OSM são exibidos em camadas vetoriais QGIS. Como mencionado anteriormente, dados OSM consistem de Nós, Caminhos e Relações. No QGIS, eles são exibidos em três diferentes tipos de camada: camada de ponto, camada de linha e camada de polígono. Não é possível remover qualquer uma dessas camadas e trabalhar com as outras.
\begin{itemize}
\item {} 
Uma \textbf{Camada de Ponto} exibe todas as feições de tipo nó que fica sozinho. Isso significa que apenas nós que não estão incluídos em qualquer Caminho pertence à camada Ponto.

\item {} 
Uma \textbf{Camada de linha} exibe as feições OSM de Caminho do tipo que não estão fechados. Isso significa que, nenhum desses Caminhos inicia e termina com o mesmo Nó.

\item {} 
Uma \textbf{Camada de poligono} exibe todos os Caminhos que não estão incluídos na camada Linha.

\end{itemize}

OpenStreetMap tem uns dados mais primitivos além dos três mencionados acima. Isto é chamado ** Relação {\color{red}\bfseries{}**}. Não existe propositadamente nenhuma camada vetor para exibir Relaçoes. Uma relação define uma ligação entre qualquer número de dados primitivos. Depois que um ponto, linha ou polígono é identificado em um mapa, o complemento mostra uma lista de todas as relações que o recurso identificado faz parte.

Foi um desafio para projetar a conexão entre dados OSM e as ferramentas padrão de edição QGIS. Estas ferramentas são feitas para editar uma única camada vetor por vez, não importa que tipo de feição ele exibe. Isto significa que se os dados OSM são carregados para QGIS através do complemento, você poderia (teoricamente) editar a camada de Ponto, camada de Linha ou camada de Polígono com essas ferramentas padrão separadamente.

Uma camada de linha consiste em dois diferentes tipos de recursos OSM, Linha e Nós. Em formato de OSM, uma Linha é composta de Nós. Se você começar a editar uma única camada linha e mudar a forma de alguma linha, sua ação afeta não só a Linha OSM, mas também os Nós OSM que fazem parte dela.

Ferramentas de edição padrão QGIS não se comunicam com provedor OSM, que membros de qual linha foi alterada e como. Ele pode dizer apenas o que é a nova geometria e de qual linha, e isso não é o suficiente para realizar alterações para o banco de dados OSM corretamente. A camada de linha não saber também os identificadores dos membros de linha. O mesmo problema ocorre quando você tenta editar a camada de polígono.

Por esta razão, o complemento OSM precisa de suas próprias ferramentas para edição de dados OSM. Enquanto que são utilizados, as camadas OSM podem ser alteradas corretamente. O Complemento ferramentas de edição consiste em ferramentas para Ponto, Linha Polígono, e criação de Relações , deletar e mover.

\begin{notice}{note}{Nota:}
Para criar uma conexão entre o complemento OSM e ferramentas de edição padrão, as mudanças no código fonte QuantumGIS seria necessário.
\end{notice}


\section{Instalação}
\label{docs/user_manual/osm/openstreetmap:installation}
O complemento OpenStreetMap é um complemento nativo do QGIS. O complemento `OpenStreetMap' pode ser instalado via Gerenciador de Complementos como descrito na seção: ref: \emph{Carregando complementos nativos}.


\section{Interface básica do usuário}
\label{docs/user_manual/osm/openstreetmap:basic-user-interface}
The first time the OSM plugin is started (and after the first data are loaded),
several new OSM plugin icons appear in the QGIS toolbar menu together with new
dock windows as shown in {\hyperref[docs/user_manual/osm/openstreetmap:figure-openstreetmap-2]{figure\_OpenStreetMap\_2}}.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{osm_widgets.png}
\caption{OSM plugin user interface}\end{figure}


\subsection{Ferramenta de feições OSM}
\label{docs/user_manual/osm/openstreetmap:osm-features-widget}
A ferramenta de feições OSM ajuda a identificar as feições do OSM. Ela mostra informações básicas sobre o tipo de recurso e identificador, bem como informações sobre quem mudou um recurso, e quando. A ferramenta de feições OSM também fornece todas as ferramentas de edição (na parte superior da mesma). Mais informações sobre essas ferramentas podem ser encontrados nas seções abaixo. A ferramenta é inicialmente desabilitada. E ativada depois do carregamento bem-sucedido de alguns dados OSM.


\subsection{Ferramenta Desfazer/Refazer OSM}
\label{docs/user_manual/osm/openstreetmap:osm-undo-redo-widget}
Este menu OSM desfazer / refazer é usado para desfazer e refazer ações de edição. Ele consiste não só num clássico menu desfazer e refazer , mas também mostra uma lista com uma breve descrição das ações de edição que foram feitas. O menu OSM desfazer / refazer é inicialmente fechado. Você pode visualizá-lo através de um botão no menu feições do OSM.


\subsection{Icones do menu barra de ferramenta}
\label{docs/user_manual/osm/openstreetmap:toolbar-menu-icons}
\includegraphics[width=1.5em]{osm_load.png} $^{\text{OSM Carregar do arquivo}}$ é usado para carregar dados de um arquivo XML especial OpenStreetMap.

\includegraphics[width=1.5em]{osm_featureManager.png} :sup:'Mostrar / Esconder Gerenciador de Feições OSM{}` é usado para mostrar ou ocultar o menu de botões das feições OSM. O Menu de feições OSM é um painel que ajuda na identificação de feições OSM e na edição de dados OSM.

\includegraphics[width=1.5em]{osm_download.png} :sup:{\color{red}\bfseries{}{}`}Download de dados OSM' é usado para baixar dados do servidor do OpenStreetMap.

\includegraphics[width=1.5em]{osm_upload.png} $^{\text{Upload de dado OSM}}$ é usado para upload de alterações (no dado existente).

\includegraphics[width=1.5em]{osm_import.png} $^{\text{Importa dado para camada}}$ é usado para importar dados para a camada vetorial. Pelo menos uma camada de vetor deve ser carregada e os dados OSM atuais devem ser selecionados.

\includegraphics[width=1.5em]{osm_save.png} $^{\text{Salvar OSM para arquivo}}$ é usado para salvar dados OSM de volta para o arquivo XML.

Informações mais detalhadas sobre todos os menus, botões e diálogos podem ser encontradas nas seções apropriadas desta seção complemento de acordo com a sua funcionalidade (edição, identificação, etc.).


\section{Carregando dado OSM}
\label{docs/user_manual/osm/openstreetmap:loading-osm-data}
A primeira ação que deve ser feita após iniciar o complemento OSM é abrir dados de um arquivo OSM. Dados OSM podem ser importados, de arquivo shapefile ou baixado diretamente do servidor OpenStreetMap. Aqui estamos focando o primeiro método mencionado.

To load data from a file use the \includegraphics[width=1.5em]{osm_load.png} $^{\text{Load OSM from file}}$ icon. If
there is no such button, maybe someone disabled OpenStreetMap toolbar in your
QGIS installation. You can enable it again selecting \emph{Settings \(\rightarrow\)
Toolbars \(\rightarrow\) OpenStreetMap}.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{osmloaddialog.png}
\caption{Load OSM data dialog}\end{figure}

O propósito desses elementos é explicado a seguir.

\textbf{OpenStreetMap file to load}: Click on the \includegraphics{browsebutton.png} button to select the
file:\emph{.osm} file you want to load data from.

\textbf{Adicionar colunas para etiquetas}: Esta opção determina uma conexão entre OSM e dados do QGIS. Cada feição de dados OSM tem algumas etiquetas (pares de chaves e valores), que definem as propriedades da feição. Cada característica de uma camada de vetor QGIS também tem seus atributos (chave e valor). Com esta opção, você pode definir quais as propriedades dos objetos OSM devem estar visíveis ao exibir informações detalhadas sobre as feições do QGIS.

\textbf{Substitua dados atuais}: Ao marcar esta opção significa que novos dados devem substituir os dados atuais que o usuário está trabalhando. Camadas de dados atuais serão removidas e novas serão carregadas. Ao carregar dados OSM, pela primeira vez, esta opção não está ativa, porque não há nada para substituir.

\textbf{Use custom renderer}: This option determines how many details of the map will
be used. There are three pre-defined OSM styles for map displaying. Use `Small
scale' if you want to view OSM data at low level, to see all details and to edit
something. If not you can use `Medium scale' or `Large scale'. QGIS 1.8.0 doesn't
support changing the renderer style dynamically.

Clique ** {[}OK{]} ** para carregar seus dados. Se esta for a primeira vez que o ficheiro de OSM é carregado, o complemento deve primeiro analisar o banco de dados. Isso pode demorar alguns segundos ou minutos - isso depende da quantidade de dados carregados.


\section{Visualização de dados OSM}
\label{docs/user_manual/osm/openstreetmap:viewing-osm-data}
Depois que os dados são carregados OSM, você pode identificar características do mapa usando a ferramenta apropriada. Use a \includegraphics[width=1.5em]{osm_identify.png} :sup: botão \emph{Identificar feição} no canto superior esquerdo do menu OSM. Usando esta ferramenta você pode facilmente explorar todos os objetos do mapa. Quando o cursor do mouse é colocado sobre um objeto, você pode ver todas as informações sobre ele diretamente no menu feições OSM. Há também um elástico dinâmico apresentado no mapa a fim de que o utilizador seja capaz de determinar qual a feição está atualmente identificada.

A \emph{Propriedades} guia do menu contém de todas as etiquetas de feições. Clicando no: guilabel: guia \emph{Relação} mostra uma lista de todas as relações relacionadas com identificação.

Se você quer manter uma feição por um tempo para poder ler suas propriedades e relações, mova o cursor do mouse simultaneamente, tentando clicar com seu botão esquerdo enquanto estiver sobre o recurso. Processo de identificação irá parar no próximo clique com o botão esquerdo do mouse.

Por vezes, não há mais do que um recurso em um ponto onde um clique com o botão esquerdo do mouse foi realizado. Isto acontece especialmente quando se clica em encruzilhadas ou se você não der o suficiente zoom no mapa. Nesta situação, apenas uma dessas feições é identificada (e marcada com o elástico), mas o complemento se lembra de todos eles. Então (ainda no modo de pausa), você pode percorrer as características identificadas pelo botão direito do mouse.


\section{Editando dados OSM básicos}
\label{docs/user_manual/osm/openstreetmap:editing-basic-osm-data}
`Basic data' in this context means non-relational OSM features - nodes and ways.
If you prefer to examine how to perform relational editing, skip this section
and move on to the next one.

Dados básicos de edição é uma parte fundamental do complemento OSM. É possível alterar a propriedade de posição, ou a forma de qualquer feição da base vigente. Você pode remover funções ou adicionar novas. Todas as mudanças em nós e formas são lembradas por desfazer / refazer todas as alterações podem ser facilmente carregados para o servidor OpenStreetMap.


\subsection{Mudanças nas etiquetas das feições}
\label{docs/user_manual/osm/openstreetmap:changing-feature-tags}
Mudança na propriedade/etiqueta de uma feição OSM pode ser feito diretamente na tabela de etiquetas da feição. A tabela etiquetas de feições básicas podem ser encontrados no menu OSM. Não se esqueça de identificar primeiro a feição.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{osm_changefeaturetag.png}
\caption{Changing an OSM feature tag}\end{figure}

If you want to change a tag value, just double-click in the appropriate row of
column `Value' and type, or select a new value. If you want to remove a tag,
click in the relevant row, then use the button \includegraphics[width=1.5em]{osm_removeTag.png} $^{\text{Remove
selected tags}}$ on the right bottom under the table.

Para adicionar novas etiquetas basta digitar a chave e valor na última linha da tabela onde está escrito ` \textless{}próximo valor de etiqueta \textgreater{}' . Observe que você não pode alterar a chave de um par de etiquetas existentes. Convenientemente, há algumas caixas de combinação de todas as chaves de etiquetas existentes e seus valores típicos.


\subsection{Criar ponto}
\label{docs/user_manual/osm/openstreetmap:point-creation}
Para a criação do ponto há uma \includegraphics[width=1.5em]{osm_createPoint.png}: sup: botão \emph{Criar ponto} no menu feição OSM. Para criar alguns pontos, basta clicar no botão e começar a clicar sobre o mapa. Se o cursor estiver sobre alguma feição do mapa, a feição será marcada / identificada imediatamente. Se você clicar no mapa quando uma linha ou polígono estiver marcada um novo ponto será criado diretamente na linha ou polígono, bem como seu novo membro. Se o cursor estiver sobre um ponto existente, um novo ponto não poderá ser criado. Nesse caso, o complemento OSM irá mostrar a seguinte mensagem:
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{osm_pointcreation.png}
\caption{OSM point creation message}\end{figure}

O mecanismo de ajudar um usuário a tocar a linha ou polígono é chamado de ajuste e é ativado por padrão. Se você quiser criar um ponto muito próximo de alguma linha (mas não sobre ela), você deve desabilitar o ajuste mantendo o: kbd:pressionar primeiro a tecla \emph{Ctrl}.


\subsection{Criar linha}
\label{docs/user_manual/osm/openstreetmap:line-creation}
Para a criação da linha, há um \includegraphics[width=1.5em]{osm_createLine.png}: sup: botão \emph{Criar linha} no menu feições OSM. Para criar uma linha basta clicar no botão esquerdo do mouse para e começar, clicando no mapa. Cada um de seus Cliques esquerdo é registrado como um dos vértices da nova linha. A criação da linha termina quando o primeiro clique com o botão direito do mouse for realizado. A nova linha irá aparecer imediatamente no mapa.

\begin{notice}{note}{Nota:}
A Line with less than two members cannot be created. In such case the operation
is ignored.
\end{notice}

O ajuste é realizado para todos os vértices do mapa - pontos da camada de vetor Ponto e Linha e todos os nós do Poligono. O ajuste pode ser desativado mantendo o: kbd: botão {\color{red}\bfseries{}{}`}Ctrl {}` precionado.


\subsection{Criar poligono}
\label{docs/user_manual/osm/openstreetmap:polygon-creation}
Para a criação de polígonos há um {\color{red}\bfseries{}\textbar{}}osm\_createPolygon \textbar{} :sup: botão \emph{Criar polígono} no menu feições OSM. Para criar um polígono basta clicar com o botão esquerdo e começar, clicando no mapa. Cada um de seus Cliques esquerdo é gravado como um vértice pertencente ao novo polígono. A criação Polígono termina quando o primeiro clique com o botão direito do mouse é realizado. O novo polígono aparecerá imediatamente no mapa. Polígono com menos de três vertices não pode ser criado. Em tal caso, a operação é ignorada. O Ajuste de aproximação é realizado para todos os vértices do mapa - pontos (de camada de vetor Ponto) e todo poligono linhas e vértices. Ajuste de aproximação pode ser desativado mantendo a: kbd: tecla{}`Ctrl{}`.


\subsection{Feição de Mapa em movimento}
\label{docs/user_manual/osm/openstreetmap:map-feature-moving}
Se você deseja mover uma feição (não importa o tipo) por favor use o \includegraphics[width=1.5em]{osm_move.png} :sup: botão{}`Mover feição{}` a partir do menu feições OSM. Depois, você pode navegar pelo mapa (feições serão identificadas de forma dinâmica quando você passar por cima delas) e clique sobre a feição que você deseja mover. Se uma feição errada for selecionada após o seu clique, não mova do lugar. Repita o clique com botão direito do mouse até que a feição correta seja identificada. Quando a seleção é feita e você mover o cursor, você não poderá mudar sua decisão que foi movida. Para confirmar a mudança, clique no botão esquerdo do mouse. Para cancelar o movimento, clique em outro botão do mouse.

Se você estiver movendo uma feição que está ligada a outras feições, essas conexões não serão danificadas. Outras feições só irá se adaptar a uma nova posição de uma feição movida.

Ajuste de aproximação também é suportado nesta operação, isto significa:
\begin{itemize}
\item {} 
Ao mover uma entidade independente (que não faz parte de qualquer linha / polígono) ponto, ajuste de aproximação a todos os segmentos do mapa e vértices é realizado.

\item {} 
Ao mover um ponto que é membro de algumas linhas / polígonos, o ajuste de aproximação a todos os segmentos do mapa e vértices é realizado, exceto para os vértices de pontos mestre.

\item {} 
Ao mover uma linha / polígono, o ajuste de aproximação a todos os vértices mapa é realizado. Note que o complemento OSM tenta encaixar só para os 3 vértices mais próximos ao cursor de uma linha transferida / polígono, caso contrário, a operação seria muito lenta. O Ajuste de aproximação pode ser desativado por exploração :kbd:{\color{red}\bfseries{}{}`}Ctrl{}`durante a operação.

\end{itemize}


\subsection{Remover feições do mapa}
\label{docs/user_manual/osm/openstreetmap:map-feature-removing}
Se você quiser remover uma feição, você deve primeiro identificá-la. Para remover uma feição identificada, use o {\color{red}\bfseries{}\textbar{}}osm\_removeFeat : sup: botão \emph{Remover esta feição} no menu feição OSM. Ao remover uma linha / polígono, a linha / polígono propriamente dito é excluído, assim ocorrerá para todos os pontos de seus vértices que não pertencem a nenhuma outra linha / polígono.

Ao retirar um ponto que é membro de algumas linhas / polígonos, o ponto é eliminado e as geometrias de linhas / polígonos mestres são alteradas. A geometria nova mestra resultante, possuirá menos vértices do que a antiga.

Se a feição mestre era um polígono com três vértices, a sua nova geometria tem apenas dois vértices. E como não pode existir polígono com apenas dois vértices, como descrito acima, o tipo de feição é automaticamente alterada para a Linha.

Se a feição mestre era uma linha com dois vértices, e sua nova geometria tem apenas um vértice. Como não pode existir uma linha com apenas um vértice, o tipo de feição será automaticamente alterada para ponto.


\section{Edição de relações}
\label{docs/user_manual/osm/openstreetmap:editing-osm-relation}\label{docs/user_manual/osm/openstreetmap:editing-relations}
Graças a existência de relações de OSM podemos juntar feições OSM em grupos e dar-lhes propriedades comuns - de tal forma que podemos modelar qualquer objeto do mapa possível: fronteiras de uma região (como o grupo de formas e pontos), rotas de ônibus, etc cada membro de uma relação tem sua função específica. Há um suporte muito bom para as Relações OSM em nosso complemento. Vamos ver como examinar, criar, atualizar ou remover.


\subsection{Examinando relações}
\label{docs/user_manual/osm/openstreetmap:id2}\label{docs/user_manual/osm/openstreetmap:examining-relation}
Se você quiser ver as propriedades de relações, identifique primeiro um de seus membros. Depois que abrir o: guilabel: guia \emph{Relações} no menu feição OSM. No topo da página, você pode ver uma lista de todas as relações da feição identificada como parte. Por favor, escolha o que você quer examinar e olhe para as informações abaixo. Na primeira tabela chamada `Etiqueta relação' você encontra as propriedades da relação selecionada. Na tabela chamada `membros relação' você vê uma breve informação sobre os membros de relação. Se você clicar em um membro, o complemento abrirá um menu elástico sobre ele no mapa.


\subsection{Criação de relação}
\label{docs/user_manual/osm/openstreetmap:relation-creation}
Existem 2 caminhos para criar uma relação:
\begin{enumerate}
\item {} 
Você pode usar o \includegraphics[width=1.5em]{osm_createRelation.png}: sup: botão \emph{Criar relação} no menu feição OSM.

\item {} 
Você pode criá-lo a partir do: guilabel:guia `Relação{}` do menu feição OSM usando o \includegraphics[width=1.5em]{osm_addRelation.png}: sup: botão \emph{Adicionar relação}.

\end{enumerate}

Em ambos os casos, uma caixa de diálogo irá aparecer. Para o segundo caso, a feição que está identificada é automaticamente considerada o membro relação em primeiro lugar, de modo que o diálogo é previamente preenchido um pouco. Ao criar uma relação, por favor, selecione o seu primeiro tipo. Você pode selecionar um dos tipos de relação predefinidos ou escrever o seu próprio tipo. Depois que preencher as etiquetas relações e escolher seus membros.

Se você já selecionou um tipo de relação, tente usar o \includegraphics[width=1.5em]{osm_generateTags.png}: sup: botão \emph{gerar etiquetas}. Ele irá gerar etiquetas típicas para o seu tipo de relação. Então, espera-se que introduza valores para as chaves. A escolha dos membros relação pode ser feita escrevendo identificadores membros, tipos e funções ou usando o \textbar{} osm\_identify\textbar{}: sup: ferramenta \emph{Identificar} e clicando no mapa.

Finalmente, quando tipos, etiquetas e membros são escolhidos, o diálogo pode ser submetido. Nesse caso, o complemento cria uma nova relação para você.


\subsection{Alterando a relação}
\label{docs/user_manual/osm/openstreetmap:changing-relation}
Se você quiser alterar uma relação existente, identifique-a primeiro (seguindo os passos acima escritos na Seção: ref: \emph{examining\_relation}). Depois disso, clique no
\includegraphics[width=1.5em]{osm_editRelation.png}: sup: botão \emph{Editar relação}. Você vai encontrá-lo no menu feição OSM. Uma nova caixa de diálogo aparece, quase a mesmo que surge para a ação ``relação criar''. O diálogo é pré-preenchido com informações sobre as relações dadas. Você pode alterar as etiquetas relação, membros ou até mesmo o seu tipo. Depois de apresentar o diálogo de suas alterações serão cometidos.


\section{Baixando dados OSM}
\label{docs/user_manual/osm/openstreetmap:downloading-osm-data}
To download data from OpenStreetMap server click on the \includegraphics[width=1.5em]{osm_download.png}
$^{\text{Download OSM data}}$ button. If there is no such button, the OSM toolbar may
be disabled in your QGIS instalation. You can enable it again at
\emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap} . After clicking the
button a dialog occurs and provides following functionalities:
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{osm_downloaddialog.png}
\caption{OSM download dialog}\end{figure}

\textbf{Extensão}: Especifique uma área para download de dados a partir de intervalos de latitude e longitude em graus. Porque há alguma restrição do servidor OpenStreetMap da quantidade de dados que podem ser baixados, os intervalos não deve ser muito grandes. Informações mais detalhadas sobre a especificação extensão permitida é mostrado após clicar no \textbar{} osm\_questionMark {\color{red}\bfseries{}\textbar{}}: sup: {\color{red}\bfseries{}{}`}Ajuda {}` botão à direita.

\textbf{Baixar para}: Aqui você deverá escrever um caminho para o arquivo onde os dados serão armazenados. Se você não se lembra a estrutura do seu disco, não entre em pânico. O botão de navegação \includegraphics{browsebutton.png} vai te ajudar.

\textbf{Abrir dados automaticamente após baixar}: Determina, se o processo de baixar deve ser seguido para carregar o processo de dados ou não. Se você prefere não carregar os dados agora, você pode fazê-lo mais tarde usando o \includegraphics[width=1.5em]{osm_load.png}: sup: botão \emph{Carregar OSM do arquivo}.

\textbf{Substituir os dados atuas}: Esta opção só está ativa se \includegraphics{radiobuttonon.png}: guilabel: \emph{Dados abertos automaticamente após baixar} estiver marcada. Selecionar esta opção significa que os dados baixados devem substituir os dados atuais que estamos trabalhando agora. Camadas de dados atuais serão removidas e novas serão carregadas. Ao iniciar o QGIS e baixar dados OSM pela primeira vez, esta opção é inicialmente inativa, porque não há nada para substituir.

\textbf{Use custom renderer}: This option is active only if the \includegraphics{radiobuttonon.png}
\emph{Open data automatically after download} checkbox is checked. It
determines how many details will be in the map. There are three predefined OSM
styles for map displaying. Use `Small scale' if you want to view OSM data at low
level, to see all details and to edit something. If not you can use `Medium scale'
or `Large scale'. QGIS 1.8.0 does not support changing the renderer style
dynamically.

Clique o botãa \textbf{{[}Baixar{]}} para iniciar o processo de baixar.

Um diálogo do progresso continuamente informará sobre o quanto de dados já foi baixado. Quando ocorrer um erro durante o processo de baixar, uma caixa de diálogo dirá porquê. Quando a ação for concluída com sucesso, tanto as caixas de diálogo do progresso e do diálogo de download irão fechar-se.


\section{Subindo dados OSM}
\label{docs/user_manual/osm/openstreetmap:uploading-osm-data}
Note that the upload is always done on current OSM data. Before opening the OSM
Upload dialog, please be sure that you really have the right active layer with
OSM data.

To upload current data to the OSM server click on the \includegraphics[width=1.5em]{osm_upload.png}
$^{\text{Upload OSM data}}$ button. If there is no such button, OSM toolbar in your
QGIS installation is disabled. You can enable it again in
\emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap} . After clicking the
\textbf{{[}Upload{]}} button a new dialog will appear.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_uploaddialog.png}
\caption{OSM upload dialog}\end{figure}

No topo da caixa de diálogo, você pode verificar, se você esta carregando os dados corretos. Haverá um nome curto de um banco de dados atual. Na tabela, você encontrará informações sobre quantas mudanças irão ser carregadas. As estatísticas são apresentadas separadamente para cada tipo de feição.

Na caixa ``Comentário sobre as alterações'' , você pode escrever uma breve informação sobre o significado de sua operação de upload. Basta registrar a breve mudança de dados que você fez ou deixar a caixa vazia. Faça login na `conta OSM' para que o servidor possa autenticar você. Se você não tem uma conta no servidor de OSM, é o melhor momento para criar uma em \href{http://www.openstreetmap.org}{http://www.openstreetmap.org}. Finalmente usar ** {[}Upload{]} ** para começar uma operação de upload.


\section{Salvando dados OSM}
\label{docs/user_manual/osm/openstreetmap:saving-osm-data}
To save data from a current map extent to an XML file click on the \includegraphics[width=1.5em]{osm_save.png}
$^{\text{Save OSM to file}}$ button. If there is no such button, the OSM toolbar in
your QuantumGIS installation is probably disabled. You can enable it again in
\emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap}. After clicking on the
button a new dialog appears.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-8}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_savedialog.png}
\caption{OSM saving dialog}\end{figure}

Selecionar as feições que você deseja salvar em arquivo XML e o arquivo em si. Use a ** {[}OK{]} ** para iniciar a operação. O processo irá criar um arquivo XML, em que os dados OSM de sua extensão atual do mapa estão representados. A versão OSM do arquivo de saída é de 0.6. Elementos de dados OSM (\textless{}node\textgreater{}, \textless{}way\textgreater{}, \textless{}relation\textgreater{}) não contêm informações sobre suas changesets e UIDs. Esta informação não é obrigatória, no entanto, ver DTD para OSM XML versão 0.6. No arquivo de saída OSM elementos não são ordenados.

Note-se que não apenas dados da tela de extensão atual são salvos. No arquivo de saída os polígonos e linhas inteiras são gravados, mesmo os que apenas tiveram uma pequena parte visível na extensão de tela atual. Para cada linha / polígono salvos, todos os nós de seus membros também serão salvos.


\section{Importar dados OSM}
\label{docs/user_manual/osm/openstreetmap:import-osm-data}
To import OSM data from an opened non-OSM vector layer follow this instructions.
Choose current OSM data by clicking on one of their layers. Click on the
\includegraphics[width=1.5em]{osm_import.png} $^{\text{Import data from a layer}}$ button. If there is no such button,
someone has probably disabled the OpenStreetMap toolbar in your QGIS installation.
You can enable it again in \emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap}.

Depois de clicar no botão a seguinte mensagem poderá aparecer:
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-9}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_importdialog.png}
\caption{OSM import message dialog}\end{figure}

In such case there is no vector layer currently loaded. The import must be done
from a loaded layer - please load a vector layer from which you want to import
data. After a layer is opened, your second try should give you a better result
(don't forget to mark the current OSM layer again):
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-10}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_importtoosmdialog.png}
\caption{Import data to OSM dialog}\end{figure}

Use o diálogo submeter para iniciar o processo de importação de dados OSM. Rejeite caso você não tem certeza que deseja importar alguma coisa.


\chapter{SEXTANTE}
\label{docs/user_manual/sextante/index:sextante}\label{docs/user_manual/sextante/index::doc}\label{docs/user_manual/sextante/index:label-sextante}

\section{Introdução}
\label{docs/user_manual/sextante/intro:introduction}\label{docs/user_manual/sextante/intro::doc}
Este capítulo apresenta o complemento SEXTANTE, o conjunto de ferramentas de análise espacial mais poderoso do QGIS. SEXTANTE é um ambiente de geoprocessamento que pode ser utilizado para aplicar algorítmos nativos do QGIS ou desenvolvido por terceiros, de modo a facilitar e aumentar a produtividade das suas tarefas de análise espacial.

Nas seções seguintes, vamos analisar como usar os elementos gráficos do SEXTANTE e tirar o máximo de proveito de cada um deles


\subsection{Elementos básicos da GUI SEXTANTE}
\label{docs/user_manual/sextante/intro:basic-elements-of-the-sextante-gui}
There are four basic elements in the SEXTANTE GUI, which are used to run SEXTANTE
algorithms for different purposes. Choosing one tool or another will depend on
the kind of analysis that is to be performed and the particular characteristics
of each user and project. All of them (except for the batch processing interface,
which is called from the toolbox, as we will see) can be accessed from the
\emph{SEXTANTE} menu item (you will see more than four entries. The
remaining ones are not used to execute algorithms and will be explained later in
this chapter).
\begin{itemize}
\item {} 
Caixa de ferramentas SEXTANTE (SEXTANTE toolbox). O elemento principal da GUI SEXTANTE, é usado para executar um único algoritmo ou executar um processo em lote com base no referido algoritmo.

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{toolbox.png}
\caption{SEXTANTE Toolbox \includegraphics[width=1em]{win.png}}\label{docs/user_manual/sextante/intro:figure-toolbox-1}\end{figure}
\begin{itemize}
\item {} 
Modelador gráfico SEXTANTE (SEXTANTE modeler). Vários algoritmos podem ser combinados graficamente usando o modelador para definir um fluxo de trabalho, ou seja, a criação de um único processo que envolve vários sub-processos

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models.png}
\caption{SEXTANTE Models \includegraphics[width=1em]{win.png}}\label{docs/user_manual/sextante/intro:figure-model}\end{figure}
\begin{itemize}
\item {} 
Gerenciador SEXTANTE.de histórico (SEXTANTE history and log) Todas as ações realizadas usando qualquer um dos elementos acima referidos são armazenados em um ficheiro de histórico que pode ser facilmente reproduzido mais tarde utilizando o gestor de histórico

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{history.png}
\caption{SEXTANTE History \includegraphics[width=1em]{win.png}}\label{docs/user_manual/sextante/intro:figure-history}\end{figure}
\begin{itemize}
\item {} 
Gerenciador SEXTANTE de interface de processamento em lote (SEXTANTE batch process). Essa interface permite que você execute processos em lote, além de automatizar a execução de um algoritmo único em vários conjuntos de dados.

\end{itemize}
\phantomsection\label{docs/user_manual/sextante/intro:figure-batchprocess}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{batch_processing.png}
\caption{SEXTANTE Batch Processing \includegraphics[width=1em]{win.png}}\end{figure}

Ao longo das próximas seções, vamos analisar cada um desses elementos em detalhes.


\section{Caixa de ferramentas SEXTANTE}
\label{docs/user_manual/sextante/toolbox:the-sextante-toolbox}\label{docs/user_manual/sextante/toolbox::doc}

\subsection{Introdução}
\label{docs/user_manual/sextante/toolbox:introduction}
A \emph{Caixa de ferramentas} é o principal elemento da GUI SEXTANTE, é o elemento que provavelmente você mais usará em seus projetos. Ela mostra uma lista com todos os algoritmos disponíveis, agrupados em blocos diferentes, é o principal ponto de acesso para executá-los em processos unitários ou em lote, ou seja, envolvendo várias execuções de um mesmo algoritmo em diferentes conjuntos de entradas.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-toolbox-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{toolbox.png}
\caption{SEXTANTE Toolbox \includegraphics[width=1em]{win.png}}\end{figure}

The toolbox contains all the algorithms available, divided into groups. Each group
represents a so-called `algorithm provider', which is a set of algorithms coming
from the same source, for instance, from a third-party application with
geoprocessing capabilities. Some of this groups represent algorithms from one of
such third-party applications (like SAGA, GRASS or R), while other contain
algorithms directly coded along with SEXTANTE elements, not relying on any
additional software. Currently, these providers all reuse code from already
existing QGIS plugins (more specifically, from the fTools vector library shiped
along with QGIS and the contributed mmqgis plugin that you can install using the
Plugin Manager), making them more useful, since they can be executed from elements
such as the modeler or the batch processing interface, which we will soon describe.

Additionally, two more providers can be found, namely `Models' and `Scripts'.
This providers include user-created algorithms, and allow you to define your own
workflows and processing tasks. We will devote a full section to them a bit later.

Na parte superior da caixa de ferramentas, você pode encontrar uma caixa de texto. Para reduzir o número de algoritmos mostrados na caixa de ferramentas e tornar sua busca mais fácil, você pode inserir qualquer palavra ou frase na caixa de texto referente ao algoritimo desejado. Observe que, enquanto você digita, o número de algoritmos na caixa de ferramentas é reduzido a apenas aqueles que contêm o texto que foi introduzido.

Para executar um algoritmo, basta clicar duas vezes sobre o seu nome na caixa de ferramentas.


\subsection{Janela de algoritmos}
\label{docs/user_manual/sextante/toolbox:the-algorithm-dialog}
Once you double-click on the name of the algorithm that you want to execute, a
dialog similar to the next one is shown (in this case, the dialog corresponds to
the SAGA `Convergence index' algorithm).
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-parameters-dialog}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{parameters_dialog.png}
\caption{Parameters Dialog \includegraphics[width=1em]{win.png}}\end{figure}

Esta janela é usada para definir os valores de entrada que o algoritmo precisa para ser executado. Ela mostra uma tabela onde os valores de entrada e os parâmetros de configuração estão a ser definidos. Obviamente que a janela tem um teor diferente de acordo com os requisitos do algoritmo a ser executado. No lado esquerdo, o nome do parâmetro é mostrado. No lado direito o valor do parâmetro pode ser definido.

Apesar do número e tipo de parâmetros dependerem das características do algoritmo, a estrutura é semelhante para todos eles. Os parâmetros que se encontram na janela podem ser de um dos tipos que se seguem.
\begin{itemize}
\item {} 
Camada raster, para selecionar em uma lista de todas as camadas (atualmente abertas) no QGIS. O seletor contém também um botão em seu lado direito, para permitir que você selecione arquivos de camadas atualmente não carregadas no QGIS.

\item {} 
Camada vetorial, para selecionar em uma lista de todas as camadas carregadas no QGIS. As camadas não carregadas no QGIS podem ser selecionadas, bem como no caso de camadas raster, porém apenas se o algoritmo não necessitar da seleção de um campo a partir da tabela de atributos da camada. Neste caso, apenas as camadas abertas podem ser selecionadas, para recuperar os campos da tabela em uma lista.

Você verá um botão seletor para cada camada vetorial. Se o algoritmo não necessita de várias delas, irá ser capaz de ativar apenas uma. Se o botão correspondente a um vetor de entrada é alterado, o algoritmo será executado interativamente em cada uma de suas características. Vamos ver mais sobre este tipo de execução, no final desta seção.

\item {} 
A table, to select from a list of all the ones available in QGIS. Non-spatial
tables are loaded into QGIS like vector layers, and in fact they are treated as
such by the program. Currently, the list of available tables that you will see
when executing a SEXTANTE algorithm that needs one of them is restricted to
tables coming from files in DBase (\code{.dbf}) or Comma-Separated Values
(\code{.csv}) formats.

\item {} 
Opção para escolher em uma lista de seleção de opções possíveis.

\item {} 
Valor numérico, a ser introduzido na caixa de texto. Você vai encontrar um botão ao seu lado. Clicando sobre ele, você verá uma caixa que permite a digitação de uma expressão matemática, de modo que você pode usá-la como uma calculadora à mão. Algumas variáveis ​​úteis relacionadas com dados carregados no QGIS podem ser adicionado à sua expressão, de modo a permitir selecionar um valor derivado de qualquer uma destas variáveis​​, tais como a cellsize (resolução espacial) de uma camada ou a coordenada mais setentrional de outra.

\end{itemize}
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-number-selector}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{number_selector.png}
\caption{Number Selector \includegraphics[width=1em]{win.png}}\end{figure}
\begin{itemize}
\item {} 
Faixa de valores, com valores mínimo e máximo a ser introduzido em duas caixas de texto.

\item {} 
Sequência de texto, a ser introduzido em uma caixa de texto.

\item {} 
Campo, para escolher a tabela de atributos de uma camada vetorial ou uma tabela selecionando algum parâmetro.

\item {} 
A Coordinate Reference System (CRS). You can type the EPSG code directly in the
text box, or select it from the CRS selection dialog that appear when you click
on the button on the right-hand size

\item {} 
A extent, to be entered by four number representing its \code{xmin}, \code{xmax},
\code{ymin}, \code{ymax} limits. Clicking on the button on the right-hand side of the
value selector, a pop-up menu will appear, giving you two option: to select the
value from a layer or the current canvas extent, or to define it by dragging
directly onto the map canvas.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-extent}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{extent.png}
\caption{SEXTANTE Extent \includegraphics[width=1em]{win.png}}\end{figure}

Se selecionar a primeira opção, você verá uma janela como a seguinte.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-extent-list}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{extent_list.png}
\caption{SEXTANTE Extent List \includegraphics[width=1em]{win.png}}\end{figure}

Se a opção selecionada for a segunda, a janela de parâmetros vai esconder-se, portanto, você pode clicar e arrastar na tela. Depois de ter definido o retângulo selecionador, a janela vai reaparecer, contendo os valores na caixa de texto de extensão.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-extent-drag}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{extent_drag.png}
\caption{Extent Drag \includegraphics[width=1em]{win.png}}\end{figure}

\item {} 
Lista de elementos (camadas raster, vetoriais ou tabelas), para selecionar a partir da lista dos elementos disponíveis no QGIS. Para fazer a seleção, clique no pequeno botão no lado esquerdo da linha que corresponde a uma janela como a seguinte.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-multiple-selection}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{multiple_selection.png}
\caption{Multiple Selection \includegraphics[width=1em]{win.png}}\end{figure}

\item {} 
Pequena tabela para ser editada pelo usuário. Estas tabelas são usadas ​​para definir os parâmetros de procedimentos como pesquisa, convolução, entre outros em tabelas.

Clique no botão à direita para ver a tabela e editar os seus valores.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-fixed-table}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{fixed_table.png}
\caption{Fixed Table \includegraphics[width=1em]{win.png}}\end{figure}

Dependendo do algoritmo, o número de linhas pode ser modificado ou não, usando os botões ao lado direito da janela.

\end{itemize}

You will find a \textbf{{[}Help{]}} button in the lower part of the parameters dialog. If
a help file is available, it will be shown, giving you more information about the
algorithms and detailed descriptions of what each parameter does. Unfortunately,
most algorithms lack good documentation, but if you feel like contributing to the
project, this would be a good place to start.


\subsubsection{Nota sobre projeções}
\label{docs/user_manual/sextante/toolbox:a-note-on-projections}
SEXTANTE --- and also most of the external applications whose algorithms are
available from SEXTANTE --- does not perform any reprojection on input layers
and assumes that all of them are already in a common coordinate system and ready
to be analized. Whenever you use more than one layer as input to an algorithm,
whether vector or raster, it is up to you to make sure that they are all in the
same coordinate system.

Note that, due to QGIS's `on-the-fly' reprojecting capabilities, although two
layers might seem to overlap and match, that might not be true if their original
coordinates are used without reprojecting them onto a common coordinate system.
That reprojection should be done manually and then use the resulting files as
input to SEXTANTE. Also note that the reprojection process can be performed with
SEXTANTE, which incorporates tools to do so.


\subsection{Objetos de dados gerados por algoritmos do SEXTANTE}
\label{docs/user_manual/sextante/toolbox:data-objects-generated-by-sextante-algorithms}
Os objetos de dados gerados pelo SEXTANTE podem ser de qualquer um dos tipos seguintes:
\begin{itemize}
\item {} 
Camada raster

\item {} 
Camada vetorial

\item {} 
Tabela de dados

\item {} 
Arquivo HTML (usado para texto e resultados gráficos)

\end{itemize}

Todos eles são salvos em arquivos no computador (não existem resultados que sejam guardados na memória), e a janela de parâmetros irá conter uma caixa de texto correspondente a cada uma dessas saídas, onde você pode digitar o caminho da pasta de saída para salvá-la. Um caminho da pasta de saída contém as informações necessárias para salvar o objeto resultante em algum lugar. No caso mais usual, você vai salvá-lo em um arquivo, mas a arquitetura do SEXTANTE permite qualquer outra forma de armazenámento. Por exemplo, uma camada do tipo vetorial pode ser armazenada em um banco de dados ou mesmo enviada para um servidor remoto usando um serviço WFS-T. Embora procedimentos como estes ainda não estão implementados, o SEXTANTE já está preparado para lidar com eles, e esperamos adicionar suporte a novos tipos de armazenamento de saída em algum dos próximos recursos.

Para selecionar um caminho de saída, basta clicar no botão ao lado direito da caixa de texto. Isso vai abrir uma janela para salvar o arquivo, onde você pode selecionar o caminho desejado para o arquivo. As extensões de arquivos suportados são exibidos no seletor de formato de arquivo da caixa de diálogo, dependendo do tipo de produto e do algoritmo.

The format of the output is defined by the filename extension. The supported
formats depend on the ones supported by the algorithm itself. To select a format,
just select the corresponding file extension (or add it if you are directly typing
the filepath instead). If the extension of the filepath you entered does not match
any of the supported ones, a default extension (usually  \code{.dbf} for tables,
\code{.tif} for raster layers and \code{.shp} for vector ones) will be appended
to the filepath and the file format corresponding to that extension will be used
to save the layer or table.

If you do not enter any filename, the result will be saved as a temporary file and
in the corresponding default file format, and will be deleted once you exit QGIS
(take care with that in case you save your project and it contains temporary
layers).

You can set a default folder for output data objects. Go to the configuration
dialog (you can open it from the \emph{SEXTANTE} menu), and in the
\emph{General} group you will find a parameter named \emph{Output folder}.
This output folder is used as the default path in case you type just a filename
with no path (i.e. \code{myfile.shp}) when executing an algorithm.

Apart from raster layers and tables, SEXTANTE also generates graphics and texts
as HTML files. These results are shown at the end of the algorithm execution in
a new dialog. This dialog will keep the results produced by SEXTANTE during the
current session, and can be shown at any time by selecting in menu
\emph{SEXTANTE \(\rightarrow\) SEXTANTE results viewer}.

Algumas aplicações externas podem ter arquivos (sem restrições de extensão particulares) como saída, eles podem não pertencer a nenhuma das categorias acima. Esses arquivos de saída não serão processados ​​pelo QGIS, pois na maioria das vezes correspondem a formatos de arquivos ou elementos não suportados pelo QGIS. Este é, por exemplo, o caso com arquivos LAS usadas para dados LiDAR. Os arquivos são criados, mas você não vai ver nada de novo na área de trabalho do QGIS.

Para todos os outros tipos de saídas, você vai encontrar uma caixa de seleção que pode ser usada para informar ao SEXTANTE se você deseja ou não que o arquivo de saída seja inserido no projeto.

O SEXTANTE não suporta saídas opcionais, ou seja sempre que um algoritmo for executado, será produzido algo, entretanto você pode desmarcar a caixa de seleção correspondente, caso não esteja interessado em determinado produto, o que faz salvar os resultados em um arquivo temporário (que será excluído uma vez que você sair do QGIS)


\subsection{Configurando o SEXTANTE}
\label{docs/user_manual/sextante/toolbox:configuring-sextante}
Como já foi mencionado, o menu de configuração permite o acesso a uma nova janela onde é possível configurar como o SEXTANTE funcionará. Os parâmetros de configuração são estruturados em blocos separados que você pode selecionar no lado esquerdo da janela.

Along with the aforementioned \emph{Output folder} entry, the
\emph{General} block contains parameters for setting the default rendering
style for SEXTANTE layers (that is, layers generated by using algorithms from any
of the SEXTANTE components). Just create the style you want using QGIS, save it
to a file, and then enter the path to that file in the settings so SEXTANTE can
use it. Whenever a layer is loaded by SEXTANTE and added to the QGIS canvas, it
will be rendered with that style.

Rendering stlyes can be configured individually for each algorithm and each one
of its outputs. Just right-click on the name of the algorithm in the toolbox and
select \emph{Edit rendering styles}. You will see a dialog like the one shown
next.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-rendering-styles}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{rendering_styles.png}
\caption{Rendering Styles \includegraphics[width=1em]{win.png}}\end{figure}

Select the style file (\code{.qml}) that you want for each output and press
\textbf{{[}OK{]}}.

Other configuration parameters in the \emph{General} group are explained
below:
\begin{itemize}
\item {} 
\textbf{Use filename as layer name}. The name of each resulting layer created by
SEXTANTE is defined by the algorithm generating it. In some cases, a fixed name
might be used, that meaning that the same name will be used, no matter which
input layer is used. In other cases, the name might depend on the name of the
input layer or some of the parameters used to run the algorithm. If this
checkbox is checked, the name will be taken from the output filename instead.
Notice, that, if the output is saved to a temporary file, the filename of this
temporary file is usually long and meaningless one intended to avoid collision
with other already existing filenames.

\item {} 
\textbf{Use only selected features}. If this option is selected, whenever a vector
layer is used as input for an algorithm, only its selected features will be
used. If the layer has no selected features, all of them will be used.

\end{itemize}

Apart from the \emph{General} block in the settings dialog, you will also
find one for each algorithm provider. They contain an \emph{Activate} item
that you can use to make algorithms appear or not in the toolbox. Also, some
algorithm providers have their own configuration items, that we will explain later
when covering particular algorithm providers.


\section{Modelador gráfico do SEXTANTE}
\label{docs/user_manual/sextante/modeler:the-sextante-graphical-modeler}\label{docs/user_manual/sextante/modeler::doc}

\subsection{Introdução}
\label{docs/user_manual/sextante/modeler:introduction}
O \emph{modelador gráfico} permite a criação de modelos complexos usando uma interface simples e de fácil utilização. Quando se trabalha com SIGs, a maioria das operações de análise não são isoladas, mas constituem parte de uma cadeia de operações. Usando o modelador gráfico, uma cadeia de processos pode ser acondicionada em um único processo, por isso é mais fácil e mais conveniente para a execução de um processo único. Não importa quantos passos e algoritmos diferentes sejam necessários, o modelo é executado como um algoritmo único, poupando tempo e esforço, especialmente para modelos maiores, que envolem muitos processos.

The modeler can be opened from the \emph{SEXTANTE} menu, but also from
the toolbox. In the \emph{Modeler} branch of the algorithms tree you will
find a group named \emph{Tools}, which contains an entry called
\emph{Create new model}.

O modelador tem uma área de trabalho, onde a estrutura do modelo e o fluxo de trabalho representados são mostrados.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-modeler}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{modeler_canvas.png}
\caption{Modeler \includegraphics[width=1em]{win.png}}\end{figure}

A criação de um modelo envolve duas etapas:
\begin{enumerate}
\item {} 
Definition of necessary inputs*. These inputs will be added to the parameters
window, so the user can set their values when executing the model. The model
itself is a SEXTANTE algorithm, so the parameters window is generated
automatically as it happens with all the algorithms included in SEXTANTE.

\item {} 
Definition of the workflow. Using the input data of the model, the workflow is
defined adding algorithms and selecting how they use those inputs or the
outputs generated by other algorithms already in the model.

\end{enumerate}


\subsection{Definição das entradas}
\label{docs/user_manual/sextante/modeler:definition-of-inputs}
O primeiro passo para criar um modelo é definir as entradas necessárias. Os elementos seguintes encontram-se na aba \emph{Inputs} ao lado esquerdo da janela do modelador:
\begin{itemize}
\item {} 
Raster layer (Camada raster)

\item {} 
Vector layer (Camada vetorial)

\item {} 
String (Campo de texto)

\item {} 
Table field (Campo de tabela)

\item {} 
Table (Tabela)

\item {} 
Numerical Value (Valor numérico)

\item {} 
Boolean Value (Valor booleano)

\end{itemize}

Double-clicking on any of them, a dialog is shown to define its characteristics.
Depending on the parameter itself, the dialog will contain just one basic element
(the description, which is what the user will see when executing the model) or
more of them. For instance, when adding a numerical value, as it can be seen in
the next figure, apart from the description of the parameter you have to set a
default value and a range of valid values.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{models_parameters.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

Para cada entrada adicionada, um novo elemento é adicionado à tela do modelador.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{models_parameters2.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}


\subsection{Definição do fluxo de trabalho}
\label{docs/user_manual/sextante/modeler:definition-of-the-workflow}
Once the inputs have been defined, it is time to define the algorithms to apply
on them. Algorithms can be found in the \emph{Algorithms} tab, grouped much
in the same way as they are in the toolbox.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models_parameters3.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

To add an algorithm, double-click on its name. An execution dialog will appear,
with a content similar to the one found in the execution panel that SEXTANTE
shows when executing the algorithm from the toolbox. the one shown next correspond
to the SAGA `Convergence index' algorithm, the same one we saw in the section
dedicated to the SEXTANTE toolbox.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models_parameters4.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

Como você pode ver, existem algumas diferenças. Em vez do campo de saída usado para definir o arquivo e extensão da camada de saída, é exibido uma caixa de texto simples. Pois a camada gerada pelo algoritmo é apenas um resultado temporário que será usada como a entrada de um outro algoritmo e não deve ser mantido como resultado final. Se o campo for deixado em branco, o SEXTANTE interpretará que o resultado é final, e o único texto que o usuário fornecerá será a descrição para a saída, que será exibida ao utilizador quando executar o modelo.

A seleção do valor de cada parâmetro é também um pouco diferente, uma vez que existem diferenças importantes entre o ambiente do modelador e da caixa de ferramentas. Vamos ver como introduzir os valores para cada tipo de parâmetro.
\begin{itemize}
\item {} 
Camadas (raster e vetoriais) e tabelas. São selecionadas a partir de uma lista, mas neste caso, os valores possíveis não são as camadas ou tabelas carregadas atualmente no projeto do QGIS, mas a lista de entradas do modelo, ou outras camadas ou tabelas geradas por algoritmos já adicionado ao modelo.

\item {} 
Valores numéricos. Valores numéricos podem ser introduzidos diretamente na caixa de texto. Mas esta caixa de texto também é constituida por uma lista, que pode ser utilizado para selecionar qualquer uma das entradas de valores numéricos do modelo. Neste caso, o parâmetro terá o valor introduzido pelo utilizador durante a execução do modelo.

\item {} 
Campo de texto. Como no caso de valores numéricos, textos podem ser digitados diretamente nos campos de textos, além de ser possível selecionar uma sequência de entradas.

\item {} 
Table field. The fields of the parent table or layer cannot be known at
design-time, since they depend of the selection of the user each time the model
is executed. To set the value for this parameter, type the name of a field
directly in the textbox, or use the list to select a table field input already
added to the model. The validity of the selected field will be checked by
SEXTANTE at run-time.

\end{itemize}

Once all the parameter have been assigned valid values, click on \textbf{{[}OK{]}} and the
algorithm will be added to the canvas. It will be linked to all the other elements
in the canvas, whether algorithms or inputs, which provide objects that are used
as inputs for that algorithm.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models_parameters5.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

Os elementos podem ser arrastados para uma posição diferente dentro da tela do modelador, para mudar a forma como a estrutura do módulo é apresentado e torná-la mais clara e intuitiva. As ligações entre os elementos são atualizadas automaticamente.

You can run your algorithm anytime clicking on the \textbf{{[}Run{]}} button. However, in order
to use it from the toolbox, it has to be saved and the modeler dialog closed, to
allow the toolbox to refresh its contents.


\subsection{Salvando e carregando modelos}
\label{docs/user_manual/sextante/modeler:saving-and-loading-models}
Use the \textbf{{[}Save{]}} button to save the current model and the \textbf{{[}Open{]}} one to open
any model previously saved. Model are saved with the \code{.model} extension. If
the model has been previously saved from the modeler window, you will not be
prompted for a filename, since there is already a file associated with that model,
and it will be used.

Antes de salvar um modelo, é necessário digitar um nome e um grupo para ele, usando as caixas de texto na parte superior da janela.

Models saved on the \code{models} folder (the default folder when you are
prompted for a filename to save the model) will appear in the toolbox in the
corresponding branch. When the toolbox is invoked, SEXTANTE searches
the \code{models} folder for files with \code{.model} extension and loads the
models they contain. Since a model is itself a SEXTANTE algorithm, it can be
added to the toolbox just like any other algorithm.

The models folder can be set from the SEXTANTE configuration dialog, under the
\emph{Modeler} group.

Models loaded from the models folder appear not only in the toolbox, but also in
the algorithms tree in the \emph{Algorithms} tab of the modeler window. That
means that you can incorporate a model as a part of a bigger model, just as you
add any other algorithm.

Em alguns casos, o SEXTANTE pode não ser capaz de carregar um modelo, isto ocorre caso ele não possa encontrar todos os algoritmos incluídos em seu fluxo de trabalho. Se você já usou um algoritmo como parte do modelo, ele deve estar disponível (isto é, ele deve aparecer na caixa de ferramentas), possibilitando carregar esse modelo. Desativar um provedor de algoritmos na janela de configurações SEXTANTE torna todos os algoritmos deste provedor inutilizáveis pelo modelador, o que pode causar problemas ao carregamento de modelos. Por isso, Tenha isso em mente quando você tiver problemas para carregar ou executar modelos.


\subsection{Editando um modelo}
\label{docs/user_manual/sextante/modeler:editing-a-model}
É possível editar um modelo já existente, redefinindo o fluxo seu de trabalho e as relações entre os algoritmos e os elementos que constituem o modelo.

Se você clicar em um algoritmo na tela que apresenta o modelo, você verá um menu de contexto, como mostrada a seguir:
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-right-click}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{modeler_right_click.png}
\caption{Modeler Right Click \includegraphics[width=1em]{win.png}}\end{figure}

Selecting the \emph{Remove} option will cause the selected algorithm to be
removed. An algorithm can be removed only if there are no other algorithms
dependind on it. That is, if no output from the algorithm is used in a different
one as input. If you try to remove an algorithm that has others depending on it,
SEXTANTE will show you a warning message like the one you can see below:
\phantomsection\label{docs/user_manual/sextante/modeler:figure-cannot-delete-alg}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{cannot_delete_alg.png}
\caption{Cannot Delete ALG \includegraphics[width=1em]{win.png}}\end{figure}

Selecting the \emph{Edit} option or simply double-clicking on the algorithm
icon will show the parameters dialog of the algorithm, so you can change the
inputs and parameter values. Not all input elements available in the model will
appear in this case as available inputs. Layers or values generated at a more
advanced step in the workflow defined by the model will not be available if they
cause circular dependencies.

Select the new values and then click on the \textbf{{[}OK{]}} button as usual. The
connections between the model elements will change accordingly in the modeler
canvas.


\subsection{Ativando e desativando algoritmos}
\label{docs/user_manual/sextante/modeler:activating-and-deactivating-algorithms}
Algoritmos podem ser desativados no modelador, para que eles não sejam executados durante a execução do modelo. Isso pode ser útil para testar apenas uma determinada parte do modelo, ou quando você não precisa de todas as saídas que são geradas.

To deactivate an algorithm, right-click on its icon in the model canvas and
select the \emph{Deactivate} option. You will see that the algorithm is
represented now with a red label under its name indicating that is not active.
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{deactivated.png}
\caption{Deactivate \includegraphics[width=1em]{win.png}}\end{figure}

Todos os algoritmos dependentes (diretamente ou indiretamente) do algoritmo desativado, também aparecem como inativo, já que não podem ser executados.

To activate an algorithm, just right--click on its icon and select the
\emph{Activate} option.


\subsection{Editando arquivos de ajuda dos modelos e meta-informações}
\label{docs/user_manual/sextante/modeler:editing-model-help-files-and-meta-information}
You can document your models from SEXTANTE. Just click on the \textbf{{[}Edit model help{]}}
button and a dialog like the one shown next will appear.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-help-edition}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{help_edition.png}
\caption{Help Edition \includegraphics[width=1em]{win.png}}\end{figure}

No lado direito, você verá uma página HTML simples, estruturada usando a descrição dos parâmetros de entrada e saídas do algoritmo, juntamente com alguns itens adicionais, como uma descrição geral do modelo ou o seu autor. A primeira vez que você abrir o editor de ajuda todas essas descrições são vazias, mas você pode editá-las usando os elementos do lado esquerdo da janela. Basta selecionar um elemento da parte superior e escrever sua descrição na caixa de texto abaixo.

A Ajuda do modelo é salva em um arquivo na mesma pasta do arquivo do próprio modelo. Você não tem que se preocupar em salvá-lo, uma vez que o salvamento é feito automaticamente.


\subsection{Sobre os algoritmos disponíveis}
\label{docs/user_manual/sextante/modeler:about-available-algorithms}
Você pode notar que alguns algoritmos que podem ser executados a partir da caixa de ferramentas não aparecem na lista dos algoritmos disponíveis quando está projetando um modelo. Para ser incluído em um modelo, um algoritmo deve ter uma semântica correta, de modo a ser adequadamente ligado a outro, no fluxo de trabalho. Se um algoritmo não tem tal semântica bem definida (por exemplo, se o número de camadas de saída não se pode ser definido antecipadamente), então não é possível utilizá-lo dentro de um modelo e, assim, não aparecem na lista que você pode encontrar na janela do modelador.

Additionaly, you will see some algorithms in the modeler that are not found in the
toolbox. This algorithms are meant to be used exclusively as part of a model, and
they are of no interest in a different context. The `Calculator' algorithm is an
example of that. It is just a simple arithmetic calculator that you can use to
modify numerical values (entered by the user or generated by some other algorithm).
This tools is really useful within a model, but outside of that context, it doesn't
make too much sense.


\subsection{modelos SEXTANTE de código Python}
\label{docs/user_manual/sextante/modeler:sextante-models-as-python-code}
\emph{This feature is temporarily unavailable}

Junto com a guia que contém o projeto gráfico do modelo, você vai encontrar uma outra contendo um script Python que executa a mesma tarefa que o próprio modelo. Usando esse código, você pode criar um script (vamos explicar mais tarde neste mesmo manual) e modificá-lo para incorporar ações e métodos não disponíveis no modelador gráfico, como repetidores ou frases recorrentes.

Esse recurso também é uma forma muito prática de aprender a usar o SEXTANTE do console de scripts e aprender a como criar algoritmos para o SEXTANTE usando código Python, para que você possa usá-lo como uma ferramenta de aprendizagem, quando começar a criar seus próprios scripts SEXTANTE.

Você vai encontrar um botão abaixo do campo de texto que contém o código Python. Clique sobre ele para criar um novo caminho para esse código, sem ter que copiar e colá-lo no editor de script SEXTANTE.


\section{Interface SEXTANTE de processamento em lote}
\label{docs/user_manual/sextante/batch::doc}\label{docs/user_manual/sextante/batch:the-sextante-batch-processing-interface}

\subsection{Introdução}
\label{docs/user_manual/sextante/batch:introduction}
Os algoritmos SEXTANTE (incluindo modelos) podem ser executado como um processo descontínuo. Isto é, eles podem ser executados usando mais de um conjunto de entradas, ou seja, podem executar algoritmos tantas vezes quanto necessário. Isso é útil ao processamento de grandes quantidades de dados, uma vez que não é necessário iniciar o algoritmo muitas vezes a partir da caixa de ferramentas.

To execute an algorithm as a batch process, right-click on its name in the
toolbox and select the \emph{Execute as batch process} option in the pop-up
menu that will appear.
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{batch_processing_right_click.png}
\caption{Batch Processing Right Click \includegraphics[width=1em]{win.png}}\end{figure}


\subsection{Tabela de parâmetros}
\label{docs/user_manual/sextante/batch:the-parameters-table}
A execução de um processo em lote é semelhante ao realizado em processos de execução única de um algoritmo. Os valores dos parâmetros têm que ser definidos, mas, neste caso, é necessário mais de um valor para cada parâmetro, um para cada vez que o algoritmo tem de ser executado. Os valores são introduzidos usando uma tabela como a mostrada a seguir.
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{batch_processing.png}
\caption{Batch Processing \includegraphics[width=1em]{win.png}}\end{figure}

Cada linha desta tabela representa uma execução do algoritmo, e cada célula contém o valor de um dos parâmetros. É semelhante à janela de parâmetros vista quando executamos um algoritmo da caixa de ferramentas, mas com um arranjo diferente.

Por padrão, a tabela contém apenas duas linhas. Você pode adicionar ou remover linhas usando os botões na parte inferior da janela.

Once the size of the table has been set, it has to be filled with the desired
values.


\subsection{Preenchendo a tabela de parâmetros}
\label{docs/user_manual/sextante/batch:filling-the-parameters-table}
Para a maioria dos parâmetros, definir seu valor é fácil. Basta digitar o valor ou selecione-o na lista de opções disponível, dependendo do tipo de parâmetro.

As principais diferenças são encontradas para os parâmetros que representam as camadas ou tabelas, e para saídas. Quanto às camadas de entrada e tabelas, quando um algoritmo é executado como parte de um processo em lote esses elementos de dados de entrada são levados diretamente dos arquivos, e não a partir do conjunto de camadas e tabelas já inseridos no projeto atual do QGIS. Por esta razão, qualquer algoritmo pode ser executado como um processo em lote, mesmo que não existam elementos de dados abertos e o algoritmo não possa ser executado a partir da caixa de ferramentas.

Filenames for input data objects are introduced directly typing or, more
conveniently, clicking on the button on the right hand of the cell, which shows
a typical file chooser dialog. Multiple files can be selected at once. If the
input parameter represents a single data object and several files are selected,
each one of them will be put in a separate row, adding new ones if needed. If it
represents a multiple input, all the selected files will be added to a single
cell, separated by semicolons (\code{;}).

Objetos de dados de saída são sempre salvos em arquivos e, ao contrário, da execução de um algoritmo da caixa de ferramentas, não é permitida sua execução para economizar tempo. Você pode digitar o nome diretamente ou usar a janela de seleção de arquivos que aparece ao clicar no botão que o acompanha.

Depois de selecionar o arquivo, uma nova janela é mostrada para permitir o autocompletar de outras células na mesma coluna (com o mesmo parâmetro).
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{batch_processing_save.png}
\caption{Batch Processing Save}\end{figure}

If the default value (`Do not autocomplete') is selected, SEXTANTE will just put
the selected filename in the selected cell from the parameters table. If any of
the other options is selected, all the cells below the selected one will be
automatically filled based on a defined criteria. This way, it is much easier to
fill the table, and the batch process can be defined with less effort.

O preenchimento automático pode ser feito simplesmente adicionando números correlativos ao conjunto de arquivos selecionado, ou acrescentando o valor de outro campo na mesma linha. Isto é particularmente útil para nomear os dados de saída de acordo com os elementos de entrada.
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{batch_processing_filepath.png}
\caption{Batch Processing File Path \includegraphics[width=1em]{win.png}}\end{figure}


\subsection{Execução do processo em lote}
\label{docs/user_manual/sextante/batch:executing-the-batch-process}
To execute the batch process once you have introduced all the necessary values,
just click on \textbf{{[}OK{]}}. SEXTANTE will show the progress of the global batch
process in the progress bar in the lower part of the dialog.


\section{Using SEXTANTE from the console}
\label{docs/user_manual/sextante/console:using-sextante-from-the-console}\label{docs/user_manual/sextante/console::doc}

\subsection{Introdução}
\label{docs/user_manual/sextante/console:introduction}
O console permite que usuários avançados possam aumentar sua produtividade e realizar operações complexas, que não podem ser realizadas usando qualquer um dos outros elementos do GUI SEXTANTE. Modelos que envolvem vários algoritmos podem ser definidos usando a interface de linha de comando e operações adicionais, tais como loops e frases condicionais podem ser adicionados para criar fluxos de trabalho mais flexíveis e poderosos.

Não existe nenhum console SEXTANTE no QGIS, mas todos os comandos SEXTANTE estão disponíveis e embutido no console Python em vez de estarem no QGIS. Isso significa que é possivel incorporar os comandos de trabalho em consoles e conectar algoritmos SEXTANTE para todos os outros recursos disponíveis (incluindo métodos da API do QGIS).

The code that you can execute from the Python console, even if it does call any
SEXTANTE method, can be converted into a new SEXTANTE algorithm that you can later
call from the toolbox, the graphical modeler or any other SEXTANTE component, just
like you do with any other SEXTANTE algorithm. In fact, some algorithms that you
can find in the toolbox, like all the ones in the \emph{mmqgis} group, are
simple scripts.

Neste capítulo, vamos ver como usar o console SEXTANTE Python do  QGIS, além de como escrever seus próprios algoritmos usando Python.


\subsection{Iniciando o console SEXTANTE Python}
\label{docs/user_manual/sextante/console:calling-sextante-from-the-python-console}
A primeira coisa que você tem a fazer é importar as funções SEXTANTE com a seguinte linha:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{k+kn}{import} \PYG{n+nn}{sextante}
\end{Verbatim}

Agora, há, basicamente, apenas uma coisa (interessante) que você pode fazer com o console SEXTANTE: a execução de um algoritmo. Isso é feito usando o método \code{runalg()}, que tem o nome do algoritmo a ser executado como seu primeiro parâmetro e, em seguida, um número variável de parâmetros adicionais, dependendo dos requisitos do algoritmo. Então a primeira coisa que você precisa para executar é saber o nome do algoritmo. Esse não é o nome que você vê na caixa de ferramentas, mas sim o nome de linha de comando único. Para encontrar o nome certo para o seu algoritmo, você pode usar o método \code{algslist()}, Digite a seguinte linha no console:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{alglist}\PYG{p}{(}\PYG{p}{)}
\end{Verbatim}

Você verá algo como isso.

\begin{Verbatim}[commandchars=\\\{\}]
Accumulated Cost (Anisotropic)----------------\textgreater{}saga:accumulatedcost(anisotropic)
Accumulated Cost (Isotropic)------------------\textgreater{}saga:accumulatedcost(isotropic)
Add Coordinates to points---------------------\textgreater{}saga:addcoordinatestopoints
Add Grid Values to Points---------------------\textgreater{}saga:addgridvaluestopoints
Add Grid Values to Shapes---------------------\textgreater{}saga:addgridvaluestoshapes
Add Polygon Attributes to Points--------------\textgreater{}saga:addpolygonattributestopoints
Aggregate-------------------------------------\textgreater{}saga:aggregate
Aggregate Point Observations------------------\textgreater{}saga:aggregatepointobservations
Aggregation Index-----------------------------\textgreater{}saga:aggregationindex
Analytical Hierarchy Process------------------\textgreater{}saga:analyticalhierarchyprocess
Analytical Hillshading------------------------\textgreater{}saga:analyticalhillshading
Average With Mask 1---------------------------\textgreater{}saga:averagewithmask1
Average With Mask 2---------------------------\textgreater{}saga:averagewithmask2
Average With Thereshold 1---------------------\textgreater{}saga:averagewiththereshold1
Average With Thereshold 2---------------------\textgreater{}saga:averagewiththereshold2
Average With Thereshold 3---------------------\textgreater{}saga:averagewiththereshold3
B-Spline Approximation------------------------\textgreater{}saga:b-splineapproximation
...
\end{Verbatim}

Essa é uma lista de todos os algoritmos disponíveis, ordenados por ordem alfabética, juntamente com seus correspondentes nomes de linha de comando.

É possível usar um campo de texto como parâmetro para este método. Em vez de retornar a lista completa de algoritmo, ele só irá exibir aqueles que incluem esse campo. Se, por exemplo, você está procurando um algoritmo para calcular inclinação de um MDE,  digite \code{alglist("slope")} para obter o seguinte resultado:

\begin{Verbatim}[commandchars=\\\{\}]
DTM Filter (slope-based)----------------------\textgreater{}saga:dtmfilter(slope-based)
Downslope Distance Gradient-------------------\textgreater{}saga:downslopedistancegradient
Relative Heights and Slope Positions----------\textgreater{}saga:relativeheightsandslopepositions
Slope Length----------------------------------\textgreater{}saga:slopelength
Slope, Aspect, Curvature----------------------\textgreater{}saga:slopeaspectcurvature
Upslope Area----------------------------------\textgreater{}saga:upslopearea
Vegetation Index[slope based]-----------------\textgreater{}saga:vegetationindex[slopebased]
\end{Verbatim}

Este resultado pode mudar dependendo dos algoritmos que estão disponíveis.

It is easier now to find the algorithm you are looking for and its command-line
name, in this case \code{saga:slopeaspectcurvature}.

Uma vez que é conhecido o nome da linha de comando do algoritmo, a próxima coisa a ser feita é saber a sintaxe correta para executá-lo. Isso significa saber quais os parâmetros que são necessários e na ordem em que eles têm que ser passados, ​​ao chamar o método \code{runalg(){}`. o SEXTANTE tem um método para descrever um algoritmo em detalhes, o qual pode ser usado para obter uma lista de parâmetros, que necessitam de um algoritmos e as saídas que irá gerar. Para fazer isso, você pode usar o método {}`{}`alghelp(nome do algoritmo)}. Use o nome de linha de comando do algoritmo, e não o nome descritivo completo.

Se for chamado o método \code{saga:slopeaspectcurvature} como parâmetro, você terá a seguinte descrição.

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{alghelp}\PYG{p}{(}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{saga:slopeaspectcurvature}\PYG{l+s}{\PYGZdq{}}\PYG{p}{)}
\PYG{g+go}{ALGORITHM: Slope, Aspect, Curvature}
\PYG{g+go}{   ELEVATION \PYGZlt{}ParameterRaster\PYGZgt{}}
\PYG{g+go}{   METHOD \PYGZlt{}ParameterSelection\PYGZgt{}}
\PYG{g+go}{   SLOPE \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   ASPECT \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   CURV \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   HCURV \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   VCURV \PYGZlt{}OutputRaster\PYGZgt{}}
\end{Verbatim}

Now you have everything you need to run any algorithm. As we have already
mentioned, there is only one single command to execute algorithms: \code{runalg()}.
Its syntax is as follows:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{runalg}\PYG{p}{\PYGZob{}}\PYG{n}{name\PYGZus{}of\PYGZus{}the\PYGZus{}algorithm}\PYG{p}{,} \PYG{n}{param1}\PYG{p}{,} \PYG{n}{param2}\PYG{p}{,} \PYG{o}{.}\PYG{o}{.}\PYG{o}{.}\PYG{p}{,} \PYG{n}{paramN}\PYG{p}{,}
\PYG{g+go}{         Output1, Output2, ..., OutputN)}
\end{Verbatim}

The list of parameters and outputs to add depends on the algorithm you want to
run, and is exactly the list that the \code{alghelp()} method gives you, in the
same order as shown.

Dependendo do tipo de parâmetro, os valores são introduzidos de forma diferente. O próximo passo é uma revisão rápida de como introduzir os valores para cada tipo de parâmetro de entrada
\begin{itemize}
\item {} 
Para usar camadas raster, vetoriais ou tabelas. Basta usar um campo de texto com o nome que identifica o objeto de dados (o nome que tem na lista de camadas do projeto em execução QGIS) ou o nome do arquivo (se a camada correspondente não estiver aberta no QGIS, ela será aberta, mas não adicionada à tela do mapa). Se você tiver uma instância de um objeto que representa a camada QGIS, você também pode passá-lo como parâmetro. Se a entrada for opcional e você não desejar usar qualquer objeto de dados, use \code{None}.

\item {} 
Seleção. Se um algoritmo tem um parâmetro de seleção, o valor do parâmetro que deve ser introduzido deve usar um valor inteiro. Para saber as opções disponíveis, você pode usar o comando \code{algoptions}, como mostrado no exemplo a seguir:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{algoptions}\PYG{p}{(}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{saga:slopeaspectcurvature}\PYG{l+s}{\PYGZdq{}}\PYG{p}{)}
\PYG{g+go}{METHOD(Method)}
\PYG{g+go}{    0 \PYGZhy{} [0] Maximum Slope (Travis et al. 1975)}
\PYG{g+go}{    1 \PYGZhy{} [1] Maximum Triangle Slope (Tarboton 1997)}
\PYG{g+go}{    2 \PYGZhy{} [2] Least Squares Fitted Plane (Horn 1981, Costa\PYGZhy{}Cabral \PYGZam{} Burgess 1996)}
\PYG{g+go}{    3 \PYGZhy{} [3] Fit 2.Degree Polynom (Bauer, Rohdenburg, Bork 1985)}
\PYG{g+go}{    4 \PYGZhy{} [4] Fit 2.Degree Polynom (Heerdegen \PYGZam{} Beran 1982)}
\PYG{g+go}{    5 \PYGZhy{} [5] Fit 2.Degree Polynom (Zevenbergen \PYGZam{} Thorne 1987)}
\PYG{g+go}{    6 \PYGZhy{} [6] Fit 3.Degree Polynom (Haralick 1983)}
\end{Verbatim}

Neste caso, o algoritmo tem um dos referidos parâmetros, com 7 opções. Observe que a ordenação é iniciada em zero.

\item {} 
Entradas múltiplas. O valor é um conjunto de caracteres com descritores de entrada separados por ponto e vírgula. Tal como no caso de camadas únicas ou tabelas, cada descritor de entrada pode ter o nome do elemento de dados, ou o caminho do seu arquivo.

\item {} 
Campos de tabelas para XXX. Utilize um conjunto de caracteres com o nome do campo a ser usado. Este parâmetro é sensível a maiúsculas.

\item {} 
Fixed Table. Type the list of all table values separated by commas and enclosed
between quotes. Values start on the upper row and go from left to right. You can
also use a 2D array of value representing the table.

\item {} 
CRS. Enter the EPSG code number of the desired CRS.

\item {} 
Extent. You must use a string with \code{xmin}, \code{xmax}, \code{ymin} and \code{ymax}
values separated by commas.

\end{itemize}

Parâmetros Booleanos, campo de caracteres de arquivos e numérico não precisam de explicações adicionais.

Parâmetros de entrada, tais como o grupo de valores booleanos, os valores numéricos apresentam valores por padrão. Para usá-los, use o método \code{None} na entrada do parâmetro correspondente.

Para objetos de saída de dados, digite o caminho de arquivo a ser utilizado para salvá-lo, da mesma forma que é feito a partir da caixa de ferramentas. Se você quiser salvar o resultado em um arquivo temporário, use \code{None}. A extensão do arquivo determina o formato do arquivo. Se você digitar uma extensão de arquivo não incluída entre as que são suportados pelo algoritmo, será utilizado o formato de arquivo padrão para esse tipo de saída, bem como à sua extensão correspondente anexado ao conjunto de arquivos de dados.

Ao contrário de quando um algoritmo é executado a partir da caixa de ferramentas, as saídas não são adicionadas à tela do mapa, se você executar esse mesmo algoritmo no console Python. Se você desejar adicionar uma saída para à tela, você tem que fazê-lo manualmente após a execução do algoritmo. Para fazer isso, você pode usar os comandos da API QGIS, ou use um dos métodos úteis fornecidas pelo SEXTANTE para tal tarefa.

The \code{runalg()} method returns a dictionary with the output names (the ones shown
in the algorithm description) as keys and the filepaths of those outputs as values.
To add all the outputs generated by an algorithm, pass that dictionary to the
\code{loadFromAlg()} method. You can also load an individual layer passing its
filepath to the \code{load()} method.


\subsection{Criando scripts e executando-os na caixa de ferramentas}
\label{docs/user_manual/sextante/console:creating-scripts-and-running-them-from-the-toolbox}
You can create your own algorithms by writing the corresponding Python code and
adding a few extra lines to supply additional information needed by SEXTANTE. You
can find a \emph{Create new script} under the tools group in the script
algorithms block of the toolbox. Double click on it to open the script edition
dialog. That's where you should type your code. Saving the script from there in
the \code{scripts} folder (the default one when you open the save file dialog),
with \code{.py} extension, will automatically create the corresponding algorithm.

O nome do algoritmo (que você vai ver na caixa de ferramentas) é criado a partir do nome do arquivo, removendo a sua extensão e substituindo os underlines por espaços em branco.

Let's have the following code, which calculates the Topographic Wetness Index
(TWI) directly from a DEM

\begin{Verbatim}[commandchars=\\\{\}]
\#\#dem=raster
\#\#twi=output
ret\_slope = sextante.runalg("saga:slopeaspectcurvature", dem, 0, None,
                None, None, None, None)
ret\_area = sextante.runalg("saga:catchmentarea(mass-fluxmethod)", dem,
                0, False, False, False, False, None, None, None, None, None)
sextante.runalg("saga:topographicwetnessindex(twi), ret\_slope['SLOPE'],
                ret\_area['AREA'], None, 1, 0, twi)
\end{Verbatim}

Como você pode ver, envolve três algoritmos, todos eles provenientes do provedor SAGA. O último deles calcula o TWI, mas precisa de uma camada de encostas e uma camada de acumulação de fluxo. Nós não temos estes, mas já que temos o MDE, podemos calculá-los por meio dos algoritmos SAGA correspondentes.

A parte do código onde esse processamento ocorre não é difícil de entender se você leu as seções anteriores deste capítulo. As primeiras linhas, no entanto, precisam de alguma explicação adicional. Elas fornecem ao SEXTANTE as informações que precisa para transformar seu código em um algoritmo que pode ser executado a partir de qualquer um de seus componentes, como a caixa de ferramentas ou o modelador gráfico.

These lines start with a double Python comment symbol and have the following
structure:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{p}{[}\PYG{n}{parameter\PYGZus{}name}\PYG{p}{]}\PYG{o}{=}\PYG{p}{[}\PYG{n}{parameter\PYGZus{}type}\PYG{p}{]} \PYG{p}{[}\PYG{n}{optional\PYGZus{}values}\PYG{p}{]}
\end{Verbatim}

Here is a list of all the parameter types that SEXTANTE supports in its scripts,
their syntax and some examples.
\begin{itemize}
\item {} 
\code{raster}. Camada raster

\item {} 
\code{vector}. Camada Vetorial

\item {} 
\code{table}. Tabela

\item {} 
\code{number}. Um valor numérico. Um valor padrão deve ser fornecido. Por exemplo, \code{depth=number 2.4}

\item {} 
\code{string}. Um campo de texto. Tal como no caso de valores numéricos, um valor por padrão deve ser adicionado. Por exemplo, \code{name=string Victor}

\item {} 
\code{boolean}. Um valor booleano. Adicione \code{True} ou \code{False} depois de definir o valor padrão. Por exemplo, \code{verbose=boolean True}

\item {} 
\code{multiple raster}. Conjunto de camadas raster de entrada.

\item {} 
\code{multiple vector}. Conjunto de camadas vetoriais.

\item {} 
\code{field}. Um campo na tabela de atributos de uma camada vetorial. O nome da camada tem que ser adicionada depois do parâmetro \code{campo}. Por exemplo, se você tem declarado um vetor de entrada com \code{mylayer=vector}, você poderia usar \code{myfield=field mylayer} para adicionar um campo á camada, como parâmetro.

\item {} 
\code{folder}. Pasta

\item {} 
\code{file}. Nome do arquivo

\end{itemize}

O nome do parâmetro é o nome que será mostrado para o usuário quando o algoritmo for executado, é também o nome da variável para usar no código do script. O valor digitado pelo usuário para esse parâmetro será atribuído a uma variável com esse nome.

When showing the name of the parameter to the user, SEXTANTE will edit it to
improve its appearance, replacing low hyphens with blankspaces. So, for instance,
if you want the user to see a parameter named \code{A numerical value}, you can use
the variable name \code{A\_numerical\_value}.

Camadas e valores de tabelas são seqüências contendo o conjunto de arquivos do objeto correspondente. Para transformá-los em um objeto QGIS, você pode usar a função \code{sextante.getObjectFromUri()}. Várias entradas também têm um valor de seqüência, que contém os caminhos de arquivos de todos os objetos selecionados, separados por ponto e vírgula.

As saídas são definidas de uma maneira semelhante, utilizando-se as seguintes tags:
\begin{itemize}
\item {} 
\code{output raster}

\item {} 
\code{output vector}

\item {} 
\code{output table}

\item {} 
\code{output html}

\item {} 
\code{output file}

\item {} 
\code{output number}

\item {} 
\code{output string}

\end{itemize}

The value assigned to the output variables is always a string with a filepath.
It will correspond to a temporary filepath in case the use has not entered any
output filename.

Quando for declarado uma saída, o SEXTANTE vai tentar adicioná-la ao QGIS uma vez que o algoritmo for concluído. Essa é a razão por que, embora o método \code{runalg()} não carrega as camadas que produz, a camada TWI final será carregada, uma vez que for salvo o arquivo digitado pelo usuário, que é o valor correspondente ao campo de saída.

Não use a o método \code{load()} em algoritmos, mas apenas quando se trabalha com a linha de console. Se a camada é criada como saída de um algoritmo, que deve ser declarado como tal. Caso contrário, você não será capaz de usar adequadamente o algoritmo no modelador, pois corre o risco de sua sintaxe (como definido pelas tags, explicado acima) não coincidir com o que o algoritmo realmente produz.

Saídas ocultas (números e textos) não têm um valor. Em vez disso, é o usuário quem tem que atribuir um valor a eles. Para isso, basta definir o valor de uma variável com um nome para declarar a saída. Por exemplo, se você usou esta declaração,

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}\PYGZsh{}average=output number}
\end{Verbatim}

a seguinte linha irá definir o valor da saída para 5:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{average} \PYG{o}{=} \PYG{l+m+mi}{5}
\end{Verbatim}

Além das tags para os parâmetros e as saídas, você também pode definir o grupo em que o algoritmo será mostrado, usando a tag \code{group}.

Se o algoritmo leva um longo tempo para processar, é uma boa idéia informar ao usuário. Você tem um progresso global chamado \code{progress}, com dois métodos disponíveis: \code{setText(text)} e {\color{red}\bfseries{}{}`{}`}setPercentage(percent){}` para modificar o texto de progresso e a barra de progresso.

Several examples are provided with SEXTANTE. Please, check them to see real
examples of how to create algorithms using this feature of SEXTANTE. You can
right-click on any script algorithm and select \emph{Edit script} to edit
its code or just to see it.


\subsection{Documentando seus scripts}
\label{docs/user_manual/sextante/console:documenting-your-scripts}
As in the case of models, you can create additional documentation for your script,
to explain what they do and how to use them. In the script editing dialog you will
find a \textbf{{[}Edit script help{]}} button. Click on it and it will take you to the help
editing dialog. Check the chapter about the graphical modeler to know more about
this dialog and how to use it.

Help files are saved in the same folder as the script itself, adding the
\code{.help} extension to the filename. Notice that you can edit your script's
help before saving it for the first time. If you later close the script editing
dialog without saving the script (i.e. you discard it), the help content you
wrote will be lost. If your script was already saved and is associated to a
filename, saving is done automatically.


\section{Gerenciador de histórico SEXTANTE}
\label{docs/user_manual/sextante/history::doc}\label{docs/user_manual/sextante/history:the-sextante-history-manager}

\subsection{Histórico SEXTANTE}
\label{docs/user_manual/sextante/history:the-sextante-history}
Toda vez que for executado algum algoritmo no SEXTANTE, as informações sobre o processo são armazenadas no gerenciador de histórico SEXTANTE. Junto com os parâmetros utilizados, também são salvos a data e hora da execução.

Desta forma, facilmente podemos acompanhar e controlar todo o trabalho que foi desenvolvido usando o SEXTANTE, além de facilitar a reprodução de processos.

O gerenciador de histórico SEXTANTE consiste em um conjunto de entradas de registro agrupadas de acordo com sua data de execução, tornando mais fácil encontrar informações sobre um algoritmo executado a qualquer momento.
\phantomsection\label{docs/user_manual/sextante/history:figure-history-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{history.png}
\caption{History \includegraphics[width=1em]{win.png}}\end{figure}

Informações sobre o processo são mantidas como uma expressão de linha de comando, mesmo se o algoritmo tiver sido iniciado a partir da caixa de ferramentas. Isso o torna útil também para aqueles que sabem como usar a interface de linha de comando, já que podem chamar um algoritmo usando a caixa de ferramentas e, em seguida, verificar o gerenciador de histórico para ver como é que o mesmo algoritmo pode ser chamado a partir da linha de comando.

Além de exibir as entradas no registro, os processos podem ser re-executado, simplesmente clicando duas vezes sobre a entrada correspondente.

Along with algorithm executions, SEXTANTE communicates with the user using the
other groups of the registry, namely \emph{Errors}, \emph{Warnings} and
\emph{Information}. In case something is not working properly, having a look
at the \emph{Errors} might help you to see what is happening. If you get in
contact with a SEXTANTE developer to report a bug or error, the information in
that group will be very useful for him to find out what is going wrong.

When executing third party algorithms, this is usually done calling their
command-line interfaces, which communicate with the user using the console.
Although that console is not shown, a full dump of it is stored in the
\emph{Information} group each time you run one of those algorithms. If, for
instance, you are having problems executing a SAGA algorithm, look for an entry
name `SAGA execution console output' to check all the messages generated by SAGA
and try to find out where the problem is.

Some algorithms, even if they can produce a result with the given input data,
might add comments or additional information to \emph{Warning} in case
they detect potential problems from that data, in order to warn you about them.
Make sure you check those messages in case you are having unexpected results.


\section{Configurando aplicativos externos}
\label{docs/user_manual/sextante/3rdParty:configuring-external-applications}\label{docs/user_manual/sextante/3rdParty::doc}

\subsection{Introdução}
\label{docs/user_manual/sextante/3rdParty:introduction}
O SEXTANTE pode ser extendido usando aplicativos adicionais, chamando-os de dentro do SEXTANTE. Atualmente, GRASS, SAGA, OTB (Orfeo Toolbox) e R são suportados, juntamente com alguns outros aplicativos que fornecem funcionalidades de análise de dados espaciais. Algoritmos que dependem de uma aplicação externa são geridos por seu próprio provedor de algoritmos.

Este capítulo irá mostrar-lhe como configurar o SEXTANTE para incluir esses aplicativos adicionais, e explicaremos ainda algumas características particulares dos seus algoritmos. Depois de ter configurado corretamente os aplicativos, você será capaz de executar algoritmos externos de qualquer componente SEXTANTE por meio da caixa de ferramentas ou do modelador gráfico, assim como se faz com qualquer outro geoalgoritmo do SEXTANTE.

Por padrão, todos os algoritmos que dependem de um aplicativo externo, ou seja, que não são disponibilizado com o QGIS não estão habilitados no programa. Você pode habilitá-los na janela de configurações do SEXTANTE. Antes de ativá-los, certifique-se de que o aplicativo correspondente já está instalado em seu sistema. A habilitação de um provedor de algoritmos sem ter o programa correspondente instalado no sistema permitirá que os algoritmos apareçam na caixa de ferramentas, mas um erro será exibido quando você tenta executá-los.

Isto porque os procedimentos característicos dos algoritmos (necessário para criar a janela de diálogo de parâmetros e dar ao SEXTANTE as informações necessárias sobre o algoritmo) estão incluídos em cada aplicativo do SEXTANTE. Isto é, eles fazem parte do SEXTANTE, então você os têm em sua instalação SEXTANTE, mesmo que você não tenha instalado outro software qualquer. Entretanto, a execução do algoritmo, precisa dos códigos binários do software externo para ser instalado em seu sistema.


\subsubsection{Notas sobre os formatos de arquivos}
\label{docs/user_manual/sextante/3rdParty:a-note-on-file-formats}
Ao usar um software externo, abrindo um ficheiro no QGIS não significa que ele se comportará assim como no outro software. Na maioria dos casos, ele pode ler o que você abriu no QGIS, mas em alguns outros, isso pode dar incompatibilidade de tipo de arquivo. Ao usar bancos de dados ou formatos de arquivos incomuns, seja para camadas raster ou vetoriais, alguns problemas podem surgir. Se isso acontecer, tente usar formatos de arquivos conhecidos, que você tem certeza de que são aceitos por ambos os programas, e verifique a saída do console (na na janela de histórico de registros) para saber mais sobre o que está acontecendo de errado.

Using GRASS raster layers is, for instance, one case in which you might have
trouble and not be able to complete your work if you call an external algorithm
using such a layer as input. For this reason, these layers will not appear as
available to SEXTANTE algorithms (we are currently working on solving this, and
expect to have it ready soon).

Você deve, no entanto, não encontrar problemas sobretudo com camadas vetoriais, pois o SEXTANTE converte automaticamente do formato de arquivo original para um aceito pelo aplicativo externo antes de passar a camada para ele. Isso adiciona um tempo de processamento extra, que pode ser significativo se a camada tem um tamanho grande, por isso não se surpreenda se for preciso mais tempo para processar uma camada em uma conexão com banco de dados do que uma camada de tamanho similar armazenada em um shapefile.

Provedores que não usam aplicativos externos podem processar qualquer camada que pode ser aberta no QGIS.

Regarding output formats, raster layers can be saved as TIFF (\code{.tif}) files,
while vector layers are saved as shapefiles (\code{.shp}). These have been chosen
as the `lingua franca' between supported third party applications and QGIS. If
the output filename that you select is not one of the above, it will be modified,
adding the corresponding suffix, and the default file format will be used.

No caso de GDAL, o número de formatos de saída suportados é maior. Quando você abre a janela de seleção de arquivos, você verá que existem mais formatos (e suas extensões correspondentes disponíveis). Para mais informações sobre quais formatos são suportados, consulte a documentação GDAL.


\subsubsection{Notas sobre seleção de camadas vetoriais}
\label{docs/user_manual/sextante/3rdParty:a-note-on-vector-layer-selections}
By default, when an external algorithm takes a vector layer, it will use all its
features, even if a selection exist in QGIS. You can make an external algorithm
aware of that selection by checking the \emph{Use selected features in
external applications} item in the \emph{General} settings group. When you
do so, each time you execute an external algorithm that uses a vector layer, the
selected features of that layer will be exported to a new layer, and the algorithm
will work with that new layer instead.

Note que se esta opção for selecionada, uma camada com nenhuma seleção vai se comportar como uma camada com todos os seus componentes selecionados, e não como uma camada vazia.


\subsection{SAGA}
\label{docs/user_manual/sextante/3rdParty:saga}
Algoritmos SAGA podem ser executados a partir do SEXTANTE, se você tinver o SAGA instalado em seu sistema e configurar o SEXTANTE corretamente para que ele possa encontrar os qrquivos executáveis do SAGA. Em particular, linhas de comando são necessárias para executar algoritmos SAGA. Os códigos binários do SAGA não estão incluídos no SEXTANTE, então você tem que baixar e instalar o software manualmente. Visite o site do SAGA para mais informações. \emph{a versão do SAGA 2.0.8 é necessária}.

Once SAGA is installed, and if you are running Windows, open the SEXTANTE
configuration dialog. In the \emph{SAGA} block you will find a setting named
\emph{SAGA Folder}. Enter the path to the folder where SAGA is installed.
Close the configuration dialog and now you are ready to run SAGA algorithms from
SEXTANTE.

No caso se você estiver usando Linux, não há necessidade de configurar isso, verá que não existe essa configuração de pasta. Em vez disso, deve se certificar de que o aplicativo SAGA está devidamente instalado e sua pasta, adicionada no ambiente PATH do Linux. Para confirmar, basta abrir um console e digitar o comando \code{saga\_cmd} para verificar se o aplicativo SAGA pode ser encontrado.


\subsubsection{Sobre as limitações do sistema SAGA}
\label{docs/user_manual/sextante/3rdParty:about-saga-grid-system-limitations}
A maior parte dos algoritmos SAGA que requerem várias camadas raster de entrada, exigem que elas tenham o mesmo sistema de projeção. Ou seja, para cobrir a mesma área geográfica e tenham uma mesma resolução espacial (cellsize). Ao chamar algoritmos SAGA do SEXTANTE, você pode usar qualquer camada, independentemente da sua resolução espacial (cellsize) e extensão, de forma individual. Quando múltiplas camadas raster são utilizados como entrada para um algoritmo SAGA, o SEXTANTE irá adaptá-los a um sistema de coordenadas comum e, em seguida, passará ao SAGA (a menos que o algoritmo SAGA não possa operar com camadas de diferentes sistemas de projeção).

A definição do sistema de projeção comum é controlado pelo usuário, você vai encontrar vários parâmetros no grupo SAGA da janela de configuração para definí-lo. Existem duas maneiras de definir o sistema de grid de destino:
\begin{itemize}
\item {} 
Setting it manually. You define the extent setting the values of the following
parameters:
\begin{itemize}
\item {} 
Reamostragem min X

\item {} 
Reamostragem max X

\item {} 
Reamostragem min Y

\item {} 
Reamostragem max Y

\item {} 
Reamostragem da resolução espacial (cellsize)

\end{itemize}

Observe que o SEXTANTE irá reprojetar as camadas de entrada,na mesma medida, mesmo que não se sobreponham.

\item {} 
Setting it automatically from input layers. To select this option, just check
the \emph{Use min covering grid system for resampling} option. All the
other settings will be ignored and the minimum extent that covers all the input
layers will be used. The cellsize of the target layer is the maximum of all
cellsizes of the input layers.

\end{itemize}

Para algoritmos que não usam múltiplas camadas do tipo raster, ou para aquelas camadas que não precisam de um sistema de projeção único de entrada, esses parametros serão executados sem reprojeção antes de chamar o SAGA.


\subsubsection{Limitações para multiplas bandas de camadas}
\label{docs/user_manual/sextante/3rdParty:limitations-for-multi-band-layers}
Unlike QGIS, SAGA has no support for multiband layers. If you want to use a
multiband layer (such as an RGB or multispectral image), you first have to split
it into singlebanded images. To do so, you can use the `SAGA/Grid - Tools/Split
RGB image' algorithm (which creates 3 images from an RGB image) or the
`SAGA/Grid - Tools/Extract band' algorithm (to extract a single band).


\subsubsection{Limitações na resolução espacial (cellsize)}
\label{docs/user_manual/sextante/3rdParty:limitations-in-cellsize}
O SAGA pressupõe que camadas raster têm a mesma cellsize no eixo X e Y. Se você está trabalhando com uma camada com valores diferentes para seus cellsizes horizontal e vertical, você pode obter resultados inesperados. Neste caso, uma mensagem de advertência será adicionada ao log SEXTANTE, o que indica que uma camada de entrada pode não estar adequada para ser processada pelo SAGA.


\subsubsection{Carregando}
\label{docs/user_manual/sextante/3rdParty:logging}
Quando o SEXTANTE chama o SAGA, ele faz isso usando a interface de linha de comando, passando assim um conjunto de comandos para executar toda a operação requerida. O SAGA mostra seu progresso, escrevendo informações para o console, que inclui a porcentagem de processamento já realizado, juntamente com o conteúdo adicional. Esta saída é filtrada pelo SEXTANTE e usada ​​para atualizar a barra de progresso durante a execução do algoritmo.

Both the commands sent by SEXTANTE and the additional information printed by
SAGA can be logged along with other SEXTANTE log messages, and you might find
them useful to track in detailed what is going on when SEXTANTE runs a SAGA
algorithm. You will find two settings, namely \emph{Log console output} and
\emph{Log execution commands}  to activate that logging mechanism.

A maioria dos outros provedores que usam uma aplicação externa e são chamados através de linhas de comandos tem opções semelhantes, de modo que você vai encontrá-los, bem como em outros lugares na lista de configurações do SEXTANTE.


\subsection{R and R scripts}
\label{docs/user_manual/sextante/3rdParty:r-and-r-scripts}
A integração da linguagem R com o SEXTANTE é diferente do SAGA em que não há um conjunto de algoritmos predefinido que pode rodar (com exceção de alguns exemplos). Em vez disso, você deve escrever seus scripts e chamar os comandos R, e de uma forma muito semelhante ao que vimos no capítulo dedicado aos scripts SEXTANTE. Este capítulo mostra a sintaxe para usar e para chamar os comandos de R no SEXTANTE além de como usar objetos SEXTANTE (camadas, tabelas) nestes scripts.

The first thing you have to do, as we saw in the case of SAGA, is to tell SEXTANTE
where you R binaries are located. You can do so using the \emph{R folder}
entry in the SEXTANTE configuration dialog. Once you have set that parameter, you
can start creating your own R scripts and executing them.

Mais uma vez, esta configuração é diferente no Linux, e você só tem que ter certeza de que a pasta R está incluído no ambiente PATH. Para isso você pode começar apenas digitando \code{R} no console, e assim R está pronto para uso.

Para adicionar um novo algoritmo que usa uma função R (ou um script R mais complexo que você desenvolveu e que você gostaria de ter disponível a partir do SEXTANTE), você tem que criar um arquivo de script que informa ao SEXTANTE como proceder com essa operação e inserir os comoandos correspondentes em R.

Script files have the extension \code{.rsx} and creating them is pretty easy
if you just have a basic knowledge of R syntax and R scripting. They should be
stored in the R scripts folder. You can set this folder in the R settings group
(available from the SEXTANTE settings dialog), just like you do with the folder
for regular SEXTANTE scripts.

Vamos dar uma olhada em um arquivo muito simples de script, que chama o método R \code{spsample} para criar uma grade aleatória dentro do limite dos polígonos em uma dada camada do polígono. Este método pertencem ao pacote \code{maptools{}`. Uma vez que quase todos os algoritmos que você gostaria de incorporar ao Sextante vai usar ou gerar dados espaciais, conhecimento de pacotes espaciais como {}`{}`maptools} e, especialmente, \code{sp}, é obrigatório.

\begin{Verbatim}[commandchars=\\\{\}]
\#\#polyg=vector
\#\#numpoints=number 10
\#\#output=output vector
\#\#sp=group
pts=spsample(polyg,numpoints,type="random")
output=SpatialPointsDataFrame(pts, as.data.frame(pts))
\end{Verbatim}

As primeiras linhas, que começam com um sinal de duplo comentário Python (\#\#), informa ao SEXTANTE as entradas do algoritmo descrito no arquivo e as saídas que ele vai gerar. Eles trabalham exatamente com a mesma sintaxe que os scripts SEXTANTE que já vimos, para que não sejam descritos aqui novamente. Verifique a seção correspondente para obter mais informações.

When you declare an input parameter, SEXTANTE uses that information for two
things: creating the user interface to ask the user for the value of that
parameter and creating a corresponding R variable that can be later used as input
for R commands.

No exemplo acima, estamos declarando uma entrada do tipo \code{vetorial} chamado \code{polyg}. Ao executar o algoritmo, o SEXTANTE vai abrir em R a camada selecionada pelo usuário e armazená-lá em uma variável também chamado \code{polyg}. Assim, o nome de um parâmetro é também o nome da variável que podemos usar em R, exceto para o valor do parâmetro (portanto, você deve evitar o uso de palavras reservadas ao R como nomes de parâmetro).

Elementos espaciais, tais como vetores e camadas raster são lidos usando os comandos \code{readOGR()} e \code{readGDAL()} (você não tem que se preocupar em acrescentar os comandos para o seu arquivo de descrição, o SEXTANTE vai fazer isso) e armazená-las como objetos  {\color{red}\bfseries{}{}`{}`}Spatial*DataFrame{}`. Campos de tabelas são armazenados como texto contendo o nome do campo selecionado.

Tabelas são abertas usando o comando  \code{read.csv()}. Se uma tabela inserida pelo usuário não está no formato CSV, será convertida antes de importá-la para R.

Sabendo disso, podemos agora compreender a primeira linha do nosso script de exemplo (a primeira linha que não começa com um comentário Python).

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{pts}\PYG{o}{=}\PYG{n}{spsample}\PYG{p}{(}\PYG{n}{polyg}\PYG{p}{,}\PYG{n}{numpoints}\PYG{p}{,}\PYG{n+nb}{type}\PYG{o}{=}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{random}\PYG{l+s}{\PYGZdq{}}\PYG{p}{)}
\end{Verbatim}

A variável \code{polygon} já contém um objeto \code{SpatialPolygonsDataFrame}, para que possa ser usado para chamar o método \code{spsample}, assim como um \code{numpoints}, o que indica o número de pontos a serem adicionados para a grade de amostra criada.

Como declaramos uma saída vetorial, chamada \code{out}, temos que criar uma variável chamada \code{out} e criar nela um grupo de objetos \code{Spatial*DataFrame{}` (neste caso, um {}`{}`SpatialPointsDataFrame}). Você pode usar qualquer nome para as variáveis ​​intermediárias. Apenas certifique-se que a variável que armazena o resultado final tem o mesmo nome que você usou para declará-la, e contém um valor adequado.

Neste caso, o resultado obtido a partir do método \code{spsample} tem que ser convertido em um objeto explicito \code{SpatialPointsDataFrame}, uma vez que é em si mesmo um objeto da classe \code{ppp}, o que não é aceitável em uma classe a ser enviada para o SEXTANTE.

If you algorithm does not generate any layer, but a text result in the console
instead, you have to tell SEXTANTE that you want the console to be shown once the
execution is finished. To do so, just start the command lines that produce the
results you want to print with the \code{\textgreater{}} (`greater') sign. The output of all other
lines will not be shown. For instance, here is the description file of an
algorithms that performs a normality test on a given field (column) of the
attributes of a vector layer:

\begin{Verbatim}[commandchars=\\\{\}]
\#\#layer=vector
\#\#field=field layer
\#\#nortest=group
library(nortest)
\textgreater{}lillie.test(layer[[field]])
\end{Verbatim}

A saída da última linha é impressa, mas a saída da primeira não é (assim como as saídas de outras linhas de comando adicionadas automaticamente pelo SEXTANTE não serão).

Se o seu algoritmo cria qualquer tipo de gráfico (usando o método \code{plot()}, adicione a seguinte linha:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}\PYGZsh{}showplots}
\end{Verbatim}

This will cause SEXTANTE to redirect all R graphical outputs to a temporary file,
which will be later opened once R execution has finished.

Ambos, os gráficos e os resultados do console serão mostrados no gerenciador de resultados do SEXTANTE.

Para mais informações, consulte os arquivos de script fornecidos com o SEXTANTE. A maioria deles são bastante simples e vai lhe ajudar muito a entender como criar as seus próprios scripts.


\subsection{GRASS}
\label{docs/user_manual/sextante/3rdParty:grass}
Configuring GRASS is not much different from configuring SAGA. First, the path to
the GRASS folder has to be defined, but only if you are running Windows.
Additionaly, a shell interpreter (usually \code{msys.exe}, which can be found
in most GRASS for Windows distributions) has to be defined and its path set up
as well.

Por padrão, o SEXTANTE tenta configurar uma conexão com o GRASS usando a distribuição GRASS que vem junto com QGIS. Isso deve funcionar sem problemas na maioria dos sistemas, mas se você tiver problemas, é necessário fazer isso manualmente. Além disso, se você quiser usar uma versão do GRASS diferente, é possivel alterar essa configuração e apontar o caminho para a pasta onde essa outra versão se encontra. o GRASS 6.4 é necessário para os algoritmos funcionarem corretamente.

Se você estiver executando o QGIS no Linux, só tem que se certificar de que o GRASS está instalado corretamente, e que ele pode ser executado sem problemas a partir de um console.

GRASS algorithms use a region for calculations. This region can be defined
manually using values similar to the ones found in the SAGA configuration, or
automatically, taking the minimum extent that covers all the input layers used
to execute the algorithm each time. If this is the behaviour you prefer, just
check the \emph{Use min covering region} option in the GRASS configuration
parameters.

GRASS includes help files describing each algorithm. If you set the
\emph{GRASS help folder} parameter, SEXTANTE will open them when you use
the \textbf{{[}Show help{]}} button from the parameters window of the algorithm.

O último parâmetro que tem que ser configurado está relacionada com o mapset. O mapset é necessário para executar o GRASS.O SEXTANTE cria um mapset temporário para cada execução. Você tem que informar ao SEXTANTE se os dados que você está trabalhando são geográficos (latitude/longitude) ou coordenadas projetadas.


\subsection{GDAL}
\label{docs/user_manual/sextante/3rdParty:gdal}
Nenhuma configuração adicional é necessária para executar algoritmos GDAL, uma vez que ele já é incorporado ao QGIS e o SEXTANTE pode inferir sua configuração.


\subsection{Orfeo ToolBox}
\label{docs/user_manual/sextante/3rdParty:orfeo-toolbox}
Os algoritmos Orfeo Toolbox (OTB) podem ser executados a partir do SEXTANTE, desde que você tenha instalado o OTB em seu sistema e configurado corretamente o SEXTANTE para que ele possa encontrar todos os arquivos necessários (linha de comando, ferramentas e bibliotecas). Observe que os códigos binários do OTB não estão incluídos no SEXTANTE, então você tem que baixar e instalar o software manualmente. Visite o site do OTB para mais informações.

Once OTB is installed, start QGIS, open the SEXTANTE configuration dialog and
configure OTB algorithm provider. In the \emph{Orfeo Toolbox (image analysis)}
block you will find all settings related to OTB. First ensure that algorithms are
enabled.

Em seguida, configure o caminho para a pasta onde o OTB (linha de comando ferramentas e bibliotecas) estão instalados:
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} usually \emph{OTB applications folder} point to \code{/usr/lib/otb/applications}
and \emph{OTB command line tools folder} is \code{/usr/bin}

\item {} 
\includegraphics[width=1em]{win.png} if you use OSGeo4W installer, than install \code{otb-bin} package and enter
\code{C:\textbackslash{}OSGeo4W\textbackslash{}apps\textbackslash{}orfeotoolbox\textbackslash{}applications} as \emph{OTB applications folder}
and \code{C:\textbackslash{}OSGeo4W\textbackslash{}bin} as \emph{OTB command line tools folder}

\end{itemize}


\subsection{TauDEM}
\label{docs/user_manual/sextante/3rdParty:taudem}
To use this provider you need to install TauDEM command line tools.


\subsubsection{Windows}
\label{docs/user_manual/sextante/3rdParty:windows}
Please visit \href{http://hydrology.usu.edu/taudem/taudem5.0/downloads.html}{TauDEM homepage}
for installation instructions and precompiled binaries for 32bit and 64bit systems.
\textbf{IMPORTANT}: you need TauDEM 5.0.6 executables, version 5.2 currently not
supported.


\subsubsection{Linux}
\label{docs/user_manual/sextante/3rdParty:linux}
Não existem pacotes para a distribuição Linux,  então você deve compilar o TauDEM manualmente. Como TauDEM usa MPICH2, primeiro tem que instalá-lo usando algum gerenciador de pacotes de aplicativos. TauDEM também funciona bem com OpenMPI, assim é possível usá-lo em vez de MPICH2.

Download TauDEM 5.0.6 \href{http://hydrology.usu.edu/taudem/taudem5.0/TauDEM5PCsrc\_506.zip}{source code}
and extract files in some folder.

Open \code{linearpart.h} file and add after line

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZdq{}mpi.h\PYGZdq{}}
\end{Verbatim}

adicione uma nova linha com

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdint.h\PYGZgt{}}
\end{Verbatim}

para obter sucesso

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZdq{}mpi.h\PYGZdq{}}
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdlib.h\PYGZgt{}}
\end{Verbatim}

Save changes and close file. Now open \code{tiffIO.h}, find line
\code{\#include "stdint.h"} and replace quotes (\code{""}) with \code{\textless{}\textgreater{}}, so you'll get

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdint.h\PYGZgt{}}
\end{Verbatim}

Salve as alterações e feche o arquivo. Crie um diretório cd de armazenamento para ele

\begin{Verbatim}[commandchars=\\\{\}]
mkdir build
cd build
\end{Verbatim}

Configure a sua compilação com o comando

\begin{Verbatim}[commandchars=\\\{\}]
CXX=mpicxx cmake -DCMAKE\_INSTALL\_PREFIX=/usr/local ..
\end{Verbatim}

e então compile

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{make}
\end{Verbatim}

Finalmente, instale o TauDEM em \code{/usr/local/bin}, execute

\begin{Verbatim}[commandchars=\\\{\}]
sudo make install
\end{Verbatim}

\index{Create\_Maps}
\index{Layout\_Maps}
\index{Compose\_Maps}

\chapter{Compositor de impressão}
\label{docs/user_manual/print_composer/print_composer:label-printcomposer}\label{docs/user_manual/print_composer/print_composer:print-composer}\label{docs/user_manual/print_composer/print_composer::doc}\label{docs/user_manual/print_composer/print_composer:index-2}
The print composer provides growing layout and printing capabilities. It allows
you to add elements such as the QGIS map canvas, legend, scalebar, images, basic
shapes, arrows and text labels. You can size, group, align and position each
element and adjust the properties to create your layout. The layout can be printed
or exported to image formats, Postscript, PDF or to SVG (export to SVG is not
working properly with some recent Qt4 versions. You should try and check
individual on your system). You can save the layout as template and load it again
in another session. See a list of tools in {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}:

\index{print\_composer!tools}\phantomsection\label{docs/user_manual/print_composer/print_composer:table-composer-1}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
ícone
} & \textsf{\relax 
Finalidade
} & \textsf{\relax 
ícone
} & \textsf{\relax 
Finalidade
}\\
\hline &  &  & \\

\includegraphics[width=1.5em]{mActionFolder.png}
 & 
Carregar um modelo de impressão
 & 
\includegraphics[width=1.5em]{mActionFileSaveAs.png}
 & 
Salvar como modelo de impressão
\\

\includegraphics[width=1.5em]{mActionSaveMapAsImage.png}
 & 
Exportar para formato de imagem
 & 
\includegraphics[width=1.5em]{mActionSaveAsPDF.png}
 & 
Exportar para PDF
\\

\includegraphics[width=1.5em]{mActionSaveAsSVG.png}
 & 
Exportar como SVG
 & 
\includegraphics[width=1.5em]{mActionFilePrint.png}
 & 
Imprimir ou exportar para Postscript
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png}
 & 
Ver tudo
 & 
\includegraphics[width=1.5em]{mActionZoomIn.png}
 & 
Aproximar
\\

\includegraphics[width=1.5em]{mActionZoomOut.png}
 & 
Afastar
 & 
\includegraphics[width=1.5em]{mActionDraw.png}
 & 
Atualizar visualização
\\

\includegraphics[width=1.5em]{mActionUndo.png}
 & 
Desfazer ultima modificação
 & 
\includegraphics[width=1.5em]{mActionRedo.png}
 & 
Restaurar ultima modificação
\\

\includegraphics[width=1.5em]{mActionAddMap.png}
 & 
Adicionar novo mapa
 & 
\includegraphics[width=1.5em]{mActionAddImage.png}
 & 
Adicionar imagem ao leiaute
\\

\includegraphics[width=1.5em]{mActionLabel.png}
 & 
Adicionar rótulo (texto)
 & 
\includegraphics[width=1.5em]{mActionAddLegend.png}
 & 
Adicionar legenda
\\

\includegraphics[width=1.5em]{mActionScaleBar.png}
 & 
Adicionar barra de escala
 & 
\includegraphics[width=1.5em]{mActionAddBasicShape.png}
 & 
Adicionar formas básicas
\\

\includegraphics[width=1.5em]{mActionAddArrow.png}
 & 
Adicionar seta
 & 
\includegraphics[width=1.5em]{mActionOpenTable.png}
 & 
Adicionar tabela de atributos
\\

\includegraphics[width=1.5em]{mActionSelectPan.png}
 & 
Selecionar/mover item na tela do compositor
 & 
\includegraphics[width=1.5em]{mActionMoveItemContent.png}
 & 
Mover conteúdo do mapa
\\

\includegraphics[width=1.5em]{mActionGroupItems.png}
 & 
Agrupar itens
 & 
\includegraphics[width=1.5em]{mActionUngroupItems.png}
 & 
Desagrupar itens
\\

\includegraphics[width=1.5em]{mActionRaiseItems.png}
 & 
Elevar itens selecionados
 & 
\includegraphics[width=1.5em]{mActionLowerItems.png}
 & 
Abaixar itens selecionados
\\

\includegraphics[width=1.5em]{mActionMoveItemsToTop.png}
 & 
Mover itens selecionados para o topo
 & 
\includegraphics[width=1.5em]{mActionMoveItemsToBottom.png}
 & 
Mover itens selecionados para a base
\\

\includegraphics[width=1.5em]{mActionAlignLeft.png}
 & 
Alinhar itens selecionados à esquerda
 & 
\includegraphics[width=1.5em]{mActionAlignRight.png}
 & 
Alinhar itens selecionados à direita
\\

\includegraphics[width=1.5em]{mActionAlignHCenter.png}
 & 
Alinhar itens selecionados ao centro
 & 
\includegraphics[width=1.5em]{mActionAlignVCenter.png}
 & 
Alinhar itens selecionados na vertical
\\

\includegraphics[width=1.5em]{mActionAlignTop.png}
 & 
Alinhar itens selecionados ao topo
 & 
\includegraphics[width=1.5em]{mActionAlignBottom.png}
 & 
Alinhar itens selecionados á base
\\
\hline\end{tabulary}


Tabela 1 Compositor: Ferramentas do compositor de impressão

Todas as ferramentas do compositor de impressão estão disponíveis nos menus e em forma de  ícones na barra de ferramentas. A barra de ferramentas pode ser desativada e ativada pressionando o botão direito do mouse sobre ela.

\index{Composer\_Template}
\index{Map\_Template}

\section{Abrir um novo modelo no Compositor de impressão}
\label{docs/user_manual/print_composer/print_composer:index-5}\label{docs/user_manual/print_composer/print_composer:open-a-new-print-composer-template}
Antes de começar a trabalhar com o compositor de impressão, você precisa carregar algumas camadas raster e vetoriais na tela do mapa QGIS e adaptar as suas propriedades conforme seja mais conveniente. Depois que tudo esteja processado e a simbologia estiver ao seu gosto, clique no icone \includegraphics[width=1.5em]{mActionNewComposer.png} $^{\text{Novo compositor de impressão}}$ na barra de ferramentas ou selecione \emph{Arquivo \(\rightarrow\) Novo Compositor de impressão}.


\section{Usando o Compositor de Impressão}
\label{docs/user_manual/print_composer/print_composer:using-print-composer}
Ao abrir o compositor de impressão surgirá uma tela em branco na qual você pode adicionar a tela atual do projeto QGIS, legenda, barra de escala, imagens, formas básicas, norte e texto. A {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-1]{Figure\_composer\_1}} mostra a visão inicial do compositor de impressão com uma caixa ativada  \includegraphics{checkbox.png} \emph{Grade para alinhamento} , antes de quaisquer elementos serem inseridos.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{print_composer_blank.png}
\caption{Print Composer \includegraphics[width=1em]{nix.png}}\end{figure}

O compositor de impressão apresenta três guias:
\begin{itemize}
\item {} 
The \emph{Composition} tab allows you to set paper size, orientation, the
print quality for the output file in dpi and to activate snapping to a grid of
a defined resolution. Please note, the \includegraphics{checkbox.png} \emph{Snap to grid}
feature only works, if you define a grid resolution \textgreater{} 0. Furthermore you can
also activate the \includegraphics{checkbox.png} \emph{Print as raster} checkbox. This means
all elements will be rastered before printing or saving as Postscript of PDF.

\item {} 
The \emph{Item Properties} tab displays the properties for the selected
map element. Click the \includegraphics[width=1.5em]{mActionSelectPan.png} $^{\text{Select/Move item}}$ icon to select
an element (e.g. legend, scalebar or label) on the canvas. Then click the
\emph{Item Properties} tab and customize the settings for the selected
element.

\item {} 
A guia:guilabel:'Histórico de comandos{}` exibe um histórico de todas as alterações aplicadas ao leiaute do compositor de impressão. Com um clique do mouse sobre um dos itens é possível desfazer ou refazer os passos de configuração do leiaute.

\end{itemize}

You can add multiple elements to the composer. It is also possible to have more
than one map view or legend or scalebar in the print composer canvas. Each element
has its own properties and in the case of the map, its own extent. If you want
to remove any elements from the composer canvas you can do that with the
\code{Delete} or the \code{Backspace} key.


\section{Adicionando um mapa atual do QGIS ao compositor de impressão}
\label{docs/user_manual/print_composer/print_composer:adding-a-current-qgis-map-canvas-to-the-print-composer}
Click on the \includegraphics[width=1.5em]{mActionAddMap.png} $^{\text{Add new map}}$ toolbar button in the print
composer toolbar, to add the QGIS map canvas. Now drag a rectangle on the composer
canvas with the left mouse button to add the map. To display the current map, you
can choose between three different modes in the map \emph{Item Properties}
tab:
\begin{itemize}
\item {} 
\textbf{Rectangle} is the default setting. It only displays an empty box with a
message `Map will be printed here'.

\item {} 
\textbf{Cache} renders the map in the current screen resolution. If case you zoom
in or out the composer window, the map is not rendered again but the image will
be scaled.

\item {} 
\textbf{Render} means, that if you zoom in or out the composer window, the map will
be rendered again, but for space reasons, only up to a maximum resolution.

\end{itemize}

\textbf{Cache} é o modo padrão de visualização de mapas do compositor de impressão.

You can resize the map element by clicking on the \includegraphics[width=1.5em]{mActionSelectPan.png}
$^{\text{Select/Move item}}$ button, selecting the element, and dragging one of the
blue handles in the corner of the map. With the map selected, you can now adapt
more properties in the map \emph{Item Properties} tab.

To move layers within the map element select the map element, click the
\includegraphics[width=1.5em]{mActionMoveItemContent.png} $^{\text{Move item content}}$ icon and move the layers within
the map element frame with the left mouse button. After you found the right place
for an element, you can lock the element position within the print composer
canvas. Select the map element and click on the right mouse button to \includegraphics[width=1.5em]{mIconLock.png}
$^{\text{Lock}}$ the element position and again to unlock the element. You can lock
the map element also activating the \includegraphics{checkbox.png} \emph{Lock layers for map
item} checkbox in the \emph{Map} dialog of the \emph{Item Properties}
tab.

\begin{notice}{note}{Nota:}
QGIS is now able to show labels from the new labeling plugin also in the map
composer, but it is not yet scaled correctly. So it might be necessary to
switch back to the standard labeling in some cases.
\end{notice}


\subsection{Map item properties tab --- Map and Extents dialog}
\label{docs/user_manual/print_composer/print_composer:map-item-properties-tab-map-and-extents-dialog}
\textbf{Caixa de diálogo Mapa}

The \emph{Map} dialog of the map \emph{Item Properies} tab provides
following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-2]{figure\_composer\_2}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map1.png}
\caption{Map Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
The \textbf{Preview} area allows to define the preview modes `Rectangle', `Cache'
and `Render', as described above. Click on the \textbf{{[}Update preview{]}} button to
apply changes to the map view.

\item {} 
The \textbf{Map} area allows to resize the map element specifying the width and
height or the scale. The field \emph{Rotation} \includegraphics{selectnumber.png} allows to
rotate the map element content clockwise in degrees. Note, a coordinate frame
can only be added with the default value 0. Furthermore you can enable the
checkboxes \includegraphics{checkbox.png} \emph{Lock layers for map items} and \includegraphics{checkbox.png}
\emph{Draw map canvas items}.

\end{itemize}

Se você mudar a visão sobre a tela do mapa QGIS pelo zoom ou alterar as propriedades vetoriais ou raster, é possível atualizar a visualização do mapa no compositor de impressão, selecionando o elemento do tipo mapa e clicando no botão \textbf{{[}Update preview{]}}.

\textbf{Caixa de diálogo Extensão}

The \emph{Extents} dialog of the map item tab provides following
functionalities (see Figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-3]{figure\_composer\_3}})):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map2.png}
\caption{Extents Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
The \textbf{Map extent} area allow to specify the map extent using Y and X min/max
values or clicking the \textbf{{[}Set to map canvas extent{]}} button.

\end{itemize}

If you change the view on the QGIS map canvas by zooming or panning or changing
vector or raster properties, you can update the print composer view selecting
the map element in the print composer and clicking the \textbf{{[}Update preview{]}} button
in the map \emph{Item Properties} tab (see Figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-2]{figure\_composer\_2}} a)).


\subsection{Map item properties tab --- Grid and General options dialog}
\label{docs/user_manual/print_composer/print_composer:map-item-properties-tab-grid-and-general-options-dialog}
\index{Grid!Map\_Grid}
\textbf{Caixa de diálogo grid}

The \emph{Grid} dialog of the map \emph{Item Properties} tab provides
following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-4]{Figure\_composer\_4}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map3.png}
\caption{Grid Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
A opção \includegraphics{checkbox.png} \emph{Mostrar grid} permite a sobreposição de uma grade no mapa. Você pode especificar para ser aplicado o tipo de linha sólida ou cruz. Além disso, é possível definir um intervalo para as direções X e Y, e a largura usada entre as linhas X e Y da grade.

\item {} 
A opção  \includegraphics{checkbox.png} \emph{Desenhar anotações} permite adicionar coordenadas para o quadro do mapa. As anotações podem ser desenhadas dentro ou fora da estrutura do mapa. A direção das anotações pode ser definida como horizontal, vertical, horizontal e vertical, ou ao limite das linhas. E, finalmente, você pode definir a cor da grade, a fonte das anotações, a distância das anotações ao quadro do mapa, além da precisão das coordenadas desenhadas.

\end{itemize}

\textbf{Caixa de diálogo opções gerais}

The \emph{General options} dialog of the map \emph{Item Properties} tab
provides following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-5]{Figure\_composer\_5}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map4.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Here you can define color and outline width for the element frame, set a
background color and opacity for the map canvas. The \textbf{{[}Position and size{]}}
button opens the \emph{Set item position} dialog and allows to set the
map canvas position using reference points or coordinates. Furthermore you can
select or unselect to display the element frame with the \includegraphics{checkbox.png}
\emph{Show frame} checkbox. With the \emph{Item ID} you can create a
relationship to the other print composer items.

\end{itemize}


\section{Adicionando outros elementos ao Compositor de Impressão}
\label{docs/user_manual/print_composer/print_composer:adding-other-elements-to-the-print-composer}
Além de adicionar uma tela com o mapa atual do QGIS ao compositor de impressão, também é possível adicionar, mudar a posição, mover e personalizar uma legenda, barra de escala, imagens e elementos de rotulagem.


\subsection{Label item properties tab - Label and General options dialog}
\label{docs/user_manual/print_composer/print_composer:label-item-properties-tab-label-and-general-options-dialog}
To add a label, click the \includegraphics[width=1.5em]{mActionLabel.png} $^{\text{Add label}}$ icon, place the element
with the left mouse button on the print composer canvas and position and customize
their appearance in the label \emph{Item Properties} tab.

\textbf{Caixa de diálogo rótulo}

The \emph{Label} dialog of the label item tab provides following
functionalities:
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_label1.png}
\caption{Label Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
The \emph{Label} dialog offers to add text labels to the composer canvas.
You can define the horizontal and vertical alignment, select font and font color
for the text and it is possible to define a text margin in mm.

\end{itemize}

\textbf{Caixa de diálogo opções gerais}

The \emph{General options} dialog of the label \emph{Item Properties}
tab provides following functionalities:
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_label2.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Here you can define color and outline width for the element frame, set a
background color and opacity for the label. The \emph{Position} button
opens the \emph{Set items position} dialog and allows to set the map
canvas position using reference points or coordinates. Furthermore you can
select or unselect to display the element frame with the \includegraphics{checkbox.png}
\emph{Show frame} checkbox. Use the \emph{Item ID} to create a
relationship to other print composer items.

\end{itemize}


\subsection{Image item properties tab - Picture options and General options dialog}
\label{docs/user_manual/print_composer/print_composer:image-item-properties-tab-picture-options-and-general-options-dialog}
To add an image, click the \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Add image}}$ icon, place
the element with the left mouse button on the print composer canvas and position
and customize their appearance in the image \emph{Item Properties} tab.

\index{Picture\_database}
\index{Rotated\_North\_Arrow}
\textbf{Caixa de diálogo opções da figura}

The \emph{Picture options} dialog of the image \emph{Item Properties}
tab provides following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-5]{figure\_composer\_5}} a):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-8}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_image1.png}
\caption{Picture Options Dialog Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
The \textbf{Preloaded Images} field then shows all pictures stored in the selected
directories.

\item {} 
The \textbf{Options} area shows the current selected picture and allows to define
width, height and clockwise rotation of the picture. It is also possible to
add a user specific SVG path. Activating the \includegraphics{checkbox.png} \emph{Sync with
map} checkbox synchronizes the rotation of a picture in the QGIS map canvas
(i.e. a rotated north arrow) with the appropriate print composer image.

\item {} 
A área \textbf{Buscar pastas} permite adicionar e remover pastas com imagens no formato SVC para o banco de dados de imagens.

\end{itemize}

\textbf{Caixa de diálogo opções gerais}

The \emph{General options} dialog of the image \emph{Item Properties}
tab provides following functionalities:
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-9}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_image2.png}
\caption{General Options Dialog Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Here you can define color and outline width for the element frame, set a
background color and opacity for the picture. The \textbf{{[}Position and size{]}}
button opens the \emph{Set item position} dialog and allows to set the
map canvas position using reference points or coordinates. Furthermore you can
select or unselect to display the element frame with the \includegraphics{checkbox.png}
\emph{Show frame} checkbox. With the \emph{Item ID} you can create
a relationship to other print composer items.

\end{itemize}

\index{Map\_Legend}

\subsection{Legend item properties tab - General, Legend items and Item option dialog}
\label{docs/user_manual/print_composer/print_composer:index-9}\label{docs/user_manual/print_composer/print_composer:legend-item-properties-tab-general-legend-items-and-item-option-dialog}
To add a map legend, click the \includegraphics[width=1.5em]{mActionAddLegend.png} $^{\text{Add new legend}}$ icon,
place the element with the left mouse button on the print composer canvas and
position and customize their appearance in the legend \emph{Item Properties}
tab.

\textbf{Caixa de diálogo geral}

The \emph{General} dialog of the legend item tab provides following
functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-10]{figure\_composer\_10}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-10}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_legend1.png}
\caption{General Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Here you can adapt the legend title. You can change the font of the legend
title, layer and item name. You can change width and height of the legend symbol
and you can add layer, symbol, icon label and box space. Since QGIS 1.8, you
can wrap the text of the legend title to a given character.

\end{itemize}

\textbf{Caixa de diálogo itens da legenda}

The \emph{Legend items} dialog of the legend \emph{Item Properties} tab
provides following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-11]{figure\_composer\_11}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-11}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_legend2.png}
\caption{Legend Items Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
The legend items window lists all legend items and allows to change item order,
edit layer names, remove and restore items of the list. After changing the
symbology in the QGIS main window you can click on \textbf{{[}Update{]}} to adapt the
changes in the legend element of the print composer. The item order can be
changed using the \textbf{{[}Up{]}} and \textbf{{[}Down{]}} buttons or with `drag and drop'
functionality.

\end{itemize}

\textbf{Caixa de diálogo opções gerais}

The \emph{General options} dialog of the legend \emph{Item Properties}
tab provides following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-12]{figure\_composer\_12}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-12}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_legend3.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Here you can define color and outline width for the element frame, set a
background color and opacity for the legend. The \textbf{{[}Position and size{]}} button
opens the \emph{Set item position} dialog and allows to set the map canvas
position using reference points or coordinates. Furthermore you can select or
unselect to display the element frame with the \includegraphics{checkbox.png} \emph{Show frame}
checkbox. Use the \emph{Item ID} to create a relationship to other print
composer items.

\end{itemize}

\index{Scalebar!Map\_Scalebar}

\subsection{Scalebar item properties tab - Scalebar and General options dialog}
\label{docs/user_manual/print_composer/print_composer:scalebar-item-properties-tab-scalebar-and-general-options-dialog}\label{docs/user_manual/print_composer/print_composer:index-10}
To add a scalebar, click the \includegraphics[width=1.5em]{mActionScaleBar.png} $^{\text{Add new scalebar}}$ icon, place
the element with the left mouse button on the print composer canvas and position
and customize their appearance in the scalebar \emph{Item Properties} tab.

\textbf{Caixa de diálogo barra de escala}

The \emph{Scalebar} dialog of the scalebar \emph{Item Properties} tab
provides following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-13]{figure\_composer\_13}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-13}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_scalebar1.png}
\caption{Scalebar Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
The \emph{Scalebar} dialog allows to define the segment size of the
scalebar in map units, the map units used per bar units, and how many left and
right segments units from 0 should be used.

\item {} 
Você pode definir o estilo da barra de escala disponível, como sendo simples ou dupla, o espaçamento da linha do meio, para cima ou para baixo, além do estilo numérico dos textos.

\item {} 
Furthermore you can define height, line width, label and box space of the
scalebar. Add a unit label and define the scalebar font and color.

\end{itemize}

\textbf{Caixa de diálogo opções gerais}

The \emph{General options} dialog of the scalebar \emph{Item Properties}
tab provides following features (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-7]{figure\_composer\_7}} b)):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-14}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_scalebar2.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Here you can define color and outline width for the element frame, set a
background color and opacity for the scalebar. The \textbf{{[}Position and size{]}}
button opens the \emph{Set items position} dialog and allows to set the
map canvas position using reference points or coordinates. Furthermore you can
select or unselect to display the element frame with the \includegraphics{checkbox.png}
\emph{Show frame} checkbox. With the \emph{Item ID} you can create
a relationship to the other print composer items.

\end{itemize}


\section{Ferramentas de navegação}
\label{docs/user_manual/print_composer/print_composer:navigation-tools}
Para a navegação em mapas, o compositor de impressão fornece quatro ferramentas:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionZoomIn.png} $^{\text{Aproximar}}$

\item {} 
\includegraphics[width=1.5em]{mActionZoomOut.png} $^{\text{Afastar}}$

\item {} 
\includegraphics[width=1.5em]{mActionZoomFullExtent.png} $^{\text{Ampliar para exibir tudo}}$

\item {} 
\includegraphics[width=1.5em]{mActionDraw.png} $^{\text{Atualizar a exibição {}`(se você encontrar o ponto de vista em um estado não identificável)}}$

\end{itemize}

\index{Revert\_Layout\_Actions}

\section{Ferramentas para reverter e restaurar}
\label{docs/user_manual/print_composer/print_composer:revert-and-restore-tools}\label{docs/user_manual/print_composer/print_composer:index-11}
Durante o processo de criação do leiaute, é possível reverter e restaurar as alterações. Isto pode ser feito com as ferramentas reverter e restaurar:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionUndo.png} $^{\text{Desfazer as ultimas mudanças}}$

\item {} 
\includegraphics[width=1.5em]{mActionRedo.png} $^{\text{Restaurar as ultimas mudanças}}$

\end{itemize}

ou clicando com o mouse dentro da guia \emph{histórico de comandos} (veja {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-9]{figure\_composer\_9}}).
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-16}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{command_hist.png}
\caption{Command history in the Print Composer \includegraphics[width=1em]{nix.png}}\end{figure}


\section{Adicionando Forma básica e seta}
\label{docs/user_manual/print_composer/print_composer:add-basic-shape-and-arrow}
É possível adicionar formas básicas (Elipse, Retângulo, Triângulo) e setas na tela do compositor de impressão.

The \emph{Shape} dialog allows to draw an ellipse, rectangle, or triangle
in the print composer canvas. You can define its outline and fill color, the
outline width and a clockwise rotation.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-18}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_shape.png}
\caption{Shape Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

The \emph{Arrow} dialog allows to draw an arrow in the print composer canvas.
You can define color, outline and arrow width and it is possible to use a default
marker and no marker and a SVG marker. For the SVG marker you can additionally
add a SVG start and end marker from a directory on your computer.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-19}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_arrow.png}
\caption{Arrow Dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\section{Adicionando os valores da tabela de atributos}
\label{docs/user_manual/print_composer/print_composer:add-attribute-table-values}
É possível adicionar partes de uma tabela de atributos de camadas vetoriais na tela do compositor de impressão.

\textbf{Caixa de diálogo tabela}

The \emph{Table} dialog of the attribute table item tab provides following
functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-20]{figure\_composer\_20}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-20}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_attribute1.png}
\caption{Table Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
The \emph{Table} dialog allows to select the vector layer and columns of
the attribute table. Attribute columns can be sorted and you can define to show
its values ascending or descending.

\item {} 
É possível definir o número máximo de linhas a serem exibidas e se os atributos são exibidos apenas para as características visíveis da tela atual do compositor.

\item {} 
Além disso, é possível definir as características de grade da tabela e a fonte do cabeçalho e conteúdo.

\end{itemize}

\textbf{Caixa de diálogo opções gerais}

The \emph{General options} dialog of the attribute table item tab provides
following functionalities (see {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-21]{figure\_composer\_21}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-21}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_attribute2.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Here you can define color and outline width for the element frame, set a
background color and opacity for the table. The \textbf{{[}Position and size{]}} button
opens the \emph{Set item position} dialog and allows to set the map canvas
position using reference points or coordinates. Furthermore you can select or
unselect to display the element frame with the \includegraphics{checkbox.png} \emph{Show frame}
checkbox. Use the Item ID to create a relationship to the other print composeritems.

\end{itemize}


\section{Elevar, abaixar e alinhar elementos}
\label{docs/user_manual/print_composer/print_composer:raise-lower-and-align-elements}
As funcionalidades de elevar ou abaixar os elementos são encontradas no menu suspenso  \includegraphics[width=1.5em]{mActionRaiseItems.png} $^{\text{elevar itens selecionados}}$. Escolha um elemento na tela do compositor de impressão e selecione a funcionalidade correspondente para aumentar ou diminuir o elemento selecionado em relação aos outros elementos (ver  {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}).

Existem várias funcionalidades de alinhamento disponíveis no menu suspenso \includegraphics[width=1.5em]{mActionAlignLeft.png}$^{\text{Alinhar itens selecionados}}$ (ver {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}). Para usar uma funcionalidade de alinhamento, primeiramente selecione alguns elementos e, em seguida, clique no ícone de alinhamento correspondente. Então, todos os elementos selecionados serão alinhados dentro de uma caixa delimitadora.

\index{Printing!Export\_Map}

\section{Criação de saídas}
\label{docs/user_manual/print_composer/print_composer:creating-output}\label{docs/user_manual/print_composer/print_composer:index-12}
{\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-22]{Figure\_composer\_22}} shows the print composer with an example print layout
including each type of map element described in the sections above.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-22}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{print_composer_complete.png}
\caption{Print Composer with map view, legend, scalebar, coordinates and text added \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Export\_as\_image}\index{Export\_as\_PDF}\index{Export\_as\_SVG}
O compositor de impressão permite criar vários formatos de saída, é possível definir a resolução (qualidade de impressão) e tamanho do papel:
\begin{itemize}
\item {} 
O ícone \includegraphics[width=1.5em]{mActionFilePrint.png}$^{\text{Imprimir}}$ permite imprimir o leiaute para uma impressora conectada ao computador ou em um arquivo Postscript dependendo dos drivers de impressoras instalados.

\item {} 
The \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Export as image}}$ icon exports the composer
canvas in several image formats such as PNG, BPM, TIF, JPG,...

\item {} 
O ícone \includegraphics[width=1.5em]{mActionSaveAsPDF.png}:sup:'Exportar como PDF{}`salva a tela do compositor de impressão definida diretamente como PDF.

\item {} 
O ícone \includegraphics[width=1.5em]{mActionSaveAsSVG.png}:sup:'Exportar como SVG {}` salva a tela do compositor de impressão como um SVG (Scalable Vector Graphic).

\end{itemize}

\begin{notice}{note}{Nota:}
Atualmente a saída SVG é muito básica. Isto não é um problema do QGIS, mas um problema da biblioteca Qt underlaying. Esperamos que possa ser resolvido em versões futuras.
\end{notice}

\index{Composer\_Manager}

\section{Salvar e carregar um leiaute no compositor de impressão}
\label{docs/user_manual/print_composer/print_composer:saving-and-loading-a-print-composer-layout}\label{docs/user_manual/print_composer/print_composer:index-14}
With the \includegraphics[width=1.5em]{mActionFileSaveAs.png} $^{\text{Save as template}}$ and \includegraphics[width=1.5em]{mActionFolder.png}
$^{\text{Load from template}}$ icons you can save the current state of a print composer
session as a  \code{.qpt} template and load the template again in another session.

The  \includegraphics[width=1.5em]{mActionComposerManager.png} $^{\text{Composer Manager}}$ button in the QGIS toolbar
and in \emph{File \(\rightarrow\) Composer Manager} allows to add a new composer
template or to manage already existing templates.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-23}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_manager.png}
\caption{The Print Composer Manager \includegraphics[width=1em]{nix.png}}\end{figure}


\chapter{Complementos}
\label{docs/user_manual/plugins/plugins_index::doc}\label{docs/user_manual/plugins/plugins_index:plugins}
\index{plugins}

\section{Complementos QGIS}
\label{docs/user_manual/plugins/plugins:index-0}\label{docs/user_manual/plugins/plugins:qgis-plugins}\label{docs/user_manual/plugins/plugins::doc}\label{docs/user_manual/plugins/plugins:plugins}
O QGIS foi concebido para trabalhar com uma arquitetura de complementos. Isto permite que muitas novas feições/funções seja adicionadas. Muitas destas feições já estão atualmente inclusas (complementos internos que já vêm com o QGIS) e complementos externos, que você pode adicionar sob demanda.

\index{plugins!types}\begin{itemize}
\item {} 
\textbf{Complementos Internos} são mantidos pelo time de desenvolvimento do QGIS e estão presentes na sua distribuição QGIS. Eles são escritos em uma ou duas linguagens C++ ou Python. Mais informações sobre complementos internos podem ser vistas na Seção {\hyperref[docs/user_manual/plugins/core_plugins:core-plugins]{\emph{Usando Complementos Internos}}}

\item {} 
\textbf{Complementos Externos} são atualmente escritos em linguagem Python. Eles estão armazenados no repositório Oficial do QGIS e podem ser adicionados a partir de \emph{Instalador de Complementos Python}. Mais informações sobre os complementos externos podem ser vistas na Seção {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Carregar um complemento externo do QGIS}}}.

\end{itemize}


\subsection{Gerenciar Complementos}
\label{docs/user_manual/plugins/plugins:id1}\label{docs/user_manual/plugins/plugins:managing-plugins}
Gerenciar complementos em geral significa carregar ou descarregar estes usando o \emph{Gerenciador de Complementos}. Complementos externos podem ser instalados e diretamente ativados ou desinstalados usando-se o \emph{Instalados de Complementos Python}. Para desativar ou reativar complementos externos, o \emph{Gerenciador de Complementos} deverá ser usado novamente.


\subsubsection{Carregar um complemento interno}
\label{docs/user_manual/plugins/plugins:loading-a-qgis-core-plugin}\label{docs/user_manual/plugins/plugins:load-core-plugin}
Para carregar um complemento interno use o menu principal \emph{Complementos \(\rightarrow\) Gerenciar Complementos}

\index{plugins!manager}\phantomsection\label{docs/user_manual/plugins/plugins:figure-plugins-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{pluginmanager.png}
\caption{Plugin Manager \includegraphics[width=1em]{nix.png}}\end{figure}

The \emph{Plugin Manager} lists all the available plugins and their status
(loaded or unloaded), including all core plugins and all external plugins that
have been installed and automatically activated using the \emph{Python Plugin
Installer} (see Section {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Carregar um complemento externo do QGIS}}}). Those plugins that are
already loaded have a check mark to the left of their name. {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-1]{Figure\_plugins\_1}}
shows the \emph{Plugin Manager} dialog.

Para habilitar um complemento externo, marque aquele que deseja instalar e clique em \textbf{{[}OK{]}}. Ao você sair do QGIS, uma lista de complementos instalados será salva, para na sua próxima seção do QGIS ser carregada novamente.

\index{crashes}
\begin{notice}{tip}{Dica:}
\textbf{Complementos quedrados}

If you find that QGIS crashes on startup, a plugin may be at fault. You can
stop all plugins from loading by editing your stored settings file (see
{\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Opções}}} for location). Locate the plugins settings and change all
the plugin values to \code{false} to prevent them from loading.

\includegraphics[width=1em]{nix.png} For example, to prevent the `Delimited text' plugin from loading, the
entry in \code{\$HOME/.config/QuantumGIS/qgis.conf} on Linux should look like
this: \code{Add Delimited Text Layer=false}.

Do this for each plugin in the {[}Plugins{]} section. You can then start QGIS and
add the plugins one at a time from the \emph{Plugin Manager} to determine
which plugin is causing the problem.
\end{notice}


\subsubsection{Carregar um complemento externo do QGIS}
\label{docs/user_manual/plugins/plugins:load-external-plugin}\label{docs/user_manual/plugins/plugins:loading-an-external-qgis-plugin}
External QGIS plugins are written in Python. They are by default stored in either
the `Official' QGIS Repository, or in various other external repositories
maintained by individual authors. The `Official' QGIS Repository is added by
default in \emph{Python Plugin installer}.

Detailed documentation about the usage, minimum QGIS version, homepage, authors,
and other important information are provided for the `Official' QGIS Repository
at \href{http://plugins.qgis.org/plugins/}{http://plugins.qgis.org/plugins/}. For other external repositories, they might
be available with the external plugins themselves. In general it is not included
in this manual.

\begin{notice}{note}{Nota:}
Updates of core python plugins may be available in this repository as external
overlays.
\end{notice}

\begin{notice}{note}{Nota:}
fTools, Mapserver Export e o Instalador de Complmentos são complementos Python, mas eles são também parte da fonte do QGIS e são automaticamente carregados e habilitados no Gerenciador de Complementos QGIS (ver Seção {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Carregar um complemento externo do QGIS}}}).
\end{notice}

Currently there are over 150 external plugins available from the `Official' QGIS
Repository. Some of these plugins offer functionality that will be required by
many users (for example: providing the user with the ability to view and edit
OpenStreetMap data, or to add GoogleMap layers) while others offer very
specialized functions (for example: Calculate economic pipe diameters for water
supply networks).

Estas funcionalidades são bastante úteis para buscar através de todos os complementos externos, fornecendo uma palavra de busca, escolhendo um nome de repositório e/ou filtrando pela situação do complemento em seu computador (atualmente instalado ou desinstalado). Ações de buscar e filtrar podem ser realizadas a partir do Instalador de Complementos Python (veja {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-2]{figure\_plugins\_2}}).

\begin{notice}{tip}{Dica:}
\textbf{Adicionar mais repositórios}

To add external author repositories, open the Plugin Installer
(\emph{Plugins \(\rightarrow\) Fetch Python Plugins}), go to the tab
\emph{Repositories}, and click \textbf{{[}Add{]}}. If you do not want one or more
of the added repositories, they can be disabled via the \textbf{{[}Edit...{]}} button,
or completely removed with the \textbf{{[}Delete{]}} button.
\end{notice}

Existe apenas um passo necessário para integrar complementos externos ao QGIS:
\begin{itemize}
\item {} 
Baixe um complemento externo a partir de um repositório usando o \emph{Instalador de Complementos Python} (veja {\hyperref[docs/user_manual/plugins/plugins:python-plugin-installer]{\emph{Usando o Instalador de Complementos Python}}}). O novo complemento será adicionado a lista de complementos disponíveis no \emph{Gerenciador de Complementos} e ele será automaticamente carregado.

\end{itemize}


\subsubsection{Usando o Instalador de Complementos Python}
\label{docs/user_manual/plugins/plugins:python-plugin-installer}\label{docs/user_manual/plugins/plugins:using-the-qgis-python-plugin-installer}
\index{plugins!installing}
\index{plugins!Python Plugin Installer}
\index{plugins!upgrading}
In order to download and install an external Python plugin, go to
\emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{plugin_installer.png} \emph{Fetch Python
Plugins}. The \emph{Plugin Installer} window will appear ({\hyperref[docs/user_manual/plugins/plugins:figure-plugins-2]{figure\_plugins\_2}})
with the tab \emph{Plugins}, containing a list of all locally installed
Python plugins, as well as plugin available in remote repositories.
\phantomsection\label{docs/user_manual/plugins/plugins:figure-plugins-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{plugininstaller.png}
\caption{Installing external python plugins \includegraphics[width=1em]{nix.png}}\end{figure}

Cada complemento pode estar:
\begin{itemize}
\item {} 
\textbf{não instalado} - isto significa que o complemento está disponível no repositório, mas não está ainda instalado. Para instalá-lo, selecione o complemento a partir da lista e clique no botão \textbf{{[}Instalar/atualizar complemento{]}}.

\item {} 
\textbf{novo} - isto significa que o complemento foi recentemente adicionado ao repositório.

\item {} 
\textbf{instalado} - indica que o complemento já está instalado. Se ele estiver disponível em outro repositório, o botão \textbf{{[}Reinstalar complemento{]}} estará habilitado. Se a versão disponível for mais antiga do que a versão instalada, então, o botão \textbf{{[}Desatualizar complemento{]}} aparecerá.

\item {} 
\textbf{Atualizável} - significa que o complemento está instalado, mas existe uma versão mais atual disponível. Neste caso, estarão disponíveis os botões \textbf{{[}Atualizar complemento{]}} e \textbf{{[}Atualizar tudo{]}}.

\item {} 
\textbf{Inválido} - significa que o complemento está instalado, mas está indisponível ou quebrado. A razão será explicada no campo de descrição do complemento.

\end{itemize}

\textbf{Aba Complementos}

Para instalar um complemento, selecione-o a partir da lista e clique no botão \textbf{{[}Instalar complemento{]}}. O complemento será ativado e instalado no seu PC.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Linux and other unices
\begin{itemize}
\item {} 
\code{/share/qgis/python/plugins}

\item {} 
\code{\$HOME/.qgis/python/plugins}

\end{itemize}

\item {} 
\includegraphics[width=1em]{osx.png} Mac OS X
\begin{itemize}
\item {} 
\code{/Contents/MacOS/share/qgis/python/plugins}

\item {} 
\code{/Users/\$USERNAME/.qgis/python/plugins}

\end{itemize}

\item {} 
\includegraphics[width=1em]{win.png} Windows
\begin{itemize}
\item {} 
\code{C:\textbackslash{}Program Files\textbackslash{}QGIS\textbackslash{}python\textbackslash{}plugins}

\item {} 
\code{C:\textbackslash{}Documents and Settings\textbackslash{}\$USERNAME\textbackslash{}.qgis\textbackslash{}python\textbackslash{}plugins}

\end{itemize}

\end{itemize}

Se a instalação for bem sucedida, uma mensagemn de confirmação aparecerá.

If the installation fails, the reason for the failure will be displayed in a
warning dialog. Most often, errors are the result of connection problems and/or
missing Python modules. In the former case you will likely need to wait before
trying the install again, in the latter case, you should install the missing
modules relevant to your operating system prior to using the plugin. For Linux,
most required modules should be available via a package manager. For install
instructions in Windows visit the module home page.

If you are using a proxy, you may need to configure it under
\emph{Edit \(\rightarrow\) Options} (Gnome, OSX) or \emph{Settings \(\rightarrow\) Options}
(KDE, Windows){}` on the \emph{Proxy} tab.

O botão \textbf{{[}Desinstalar complemento{]}} aparece habilitado se o complemento estiver instalado e não for um complmento interno. Note que se você possuir instalado uma atualização para um complemento interno, você pode desinstalar esta atualização com {\color{red}\bfseries{}**}{[}Desinstalar complemento{]}**e reverter para a versão padrão entregue com sua versão do QGIS. Esta versão padrão, por sua vez, não pode ser desinstalada.

\textbf{Aba Repositórios}

The second tab \emph{Repositories}, contains a list of plugin repositories
available for the \emph{Plugin Installer}. By default, only the QGIS Official
Repository is enabled. You can add several user-contributed repositories,
including the central QGIS Contributed Repository and other external repositories
by clicking the \textbf{{[}Add ...{]}} button. The added repositories contain a large
number of useful plugins which are not maintained by the QGIS Development Team.
As such, we cannot take any responsibility for them. You can also manage the
repository list manually, that is add, remove, and edit the entries. Temporarily
disabling a particular repository is possible by clicking the \textbf{{[}Edit ...{]}}
button.

\textbf{Aba Opções}

A aba \emph{Opções} é onde você pode configurar as configurações do \emph{Instalador de Complementos}. A \includegraphics{checkbox.png} \emph{Verificar por atualizações ao iniciar{}`} marcada fará com que o QGIS verifique por atualizações de complementos sempre ao iniciar. O ajuste de frequência de verificação de atualizações pode ser feito através do menu de opções e, pode ser ajustado desde todos os dias até um intervalo mensal. Se um novo complemento ou atualização estiver disponível para um dos complementos instalados, uma notificação aparecerá na barra de situação. Se a opção \includegraphics{checkbox.png} \emph{Verificar por atualizações ao iniciar{}`} não estiver marcada, a verificação deverá ser feita manualmente quando aberto o \emph{Instalador de Complementos}.

Embora o atualizador do instalador de complementos consiga manusear portas diferentes de 80, algumas conexões de internet porderão causar problemas quando tentar verificar por atualizações, um indicador \emph{Buscando por novos complementos...} estará visível na Barra de Situação durante toda a sua seção do QGIS e pode causar o fechamento do programa. Neste caso, desabilite a caixa de seleção.

Adicionalemente, voc\textasciicircum{}epode especificar o tipo dos complementos que são mostrados pelo \emph{Instalador de Complementos Python}. Sob \emph{Complementos permitidos}, você pode especificar o que você deseja fazer:
\begin{itemize}
\item {} 
\includegraphics{radiobuttonon.png} \emph{Only show plugins from the official repository}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Show all plugins except those marked as experimental}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Show all plugins, even those marked as experimental}

\end{itemize}

\begin{notice}{tip}{Dica:}
\textbf{Usando complmentos experimentais}

Complementos experimentais não são indicados para uso de produção. Estes complementos estão em estágio inicial de desenvolvimento e podem ser considerados como ferramentas `incompletas'. O time de desenvolvimento do QGIS não recomenda a instalação destes complementos ao menos que você deseje testá-los.
\end{notice}

\index{data providers}

\subsection{Provedores de dados}
\label{docs/user_manual/plugins/plugins:index-7}\label{docs/user_manual/plugins/plugins:data-providers}
Data Providers are `special' plugins that provides access to a data store. By
default, QGIS supports PostGIS layers and disk-based data stores supported by
the GDAL/OGR library. A Data Provider plugin extends the ability of QGIS to use
other data sources.

Os complementos de Provedores de Dados são registrados automaticamente pelo QGIS ao iniciar. Eles não são gerenciados pelo Gerenciador de Complementos, mas usados atrás das cenas quando um tipo de dado é adicionado como uma camada do QGIS.


\section{Usando Complementos Internos}
\label{docs/user_manual/plugins/core_plugins:using-qgis-core-plugins}\label{docs/user_manual/plugins/core_plugins::doc}\label{docs/user_manual/plugins/core_plugins:core-plugins}






\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Ícone
} & \textsf{\relax 
Complemento
} & \textsf{\relax 
Descrição
} & \textsf{\relax 
Manual de referência
}\\
\hline
\includegraphics[width=1.5em]{delimited_text.png}
 & 
Adicionar camada de texto delimitado
 & 
Loads text files containing x,y coordinates
 & 
{\hyperref[docs/user_manual/plugins/plugins_delimited_text:label-dltext]{\emph{Delimited Text Plugin}}}
\\

\includegraphics[width=1.5em]{coordinate_capture.png}
 & 
Captura de coordenadas
 & 
Captura a coordenada da posição do mouse em diferentes SRCs
 & 
{\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:coordcapt]{\emph{Complemento Captura de coordenadas}}}
\\

\includegraphics[width=1.5em]{dbmanager.png}
 & 
DB Manager
 & 
Manage your databases within QGIS
 & 
{\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Complemento DB Manager}}}
\\


 & 
Diagram Overlay
 & 
Add Diagrams for vectors
 & 
{\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay]{\emph{Diagram Overlay Plugin}}}
\\

sudo apt-get install gnome-tweak-tool
 & 
Conversor DXF2Shape
 & 
Converte arquivos DXF para SHP
 & 
{\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape]{\emph{Dxf2Shp Converter Plugin}}}
\\

\includegraphics[width=1.5em]{event_id.png}
 & 
eVis
 & 
Ferramenta de Visualização de Evento
 & 
{\hyperref[docs/user_manual/plugins/plugins_evis:evis]{\emph{Complemento eVis}}}
\\

\includegraphics[width=1.5em]{ftools_logo.png}
 & 
fTools
 & 
A suite of vector tools
 & 
{\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Complemento fTools}}}
\\

\includegraphics[width=1.5em]{gps_importer.png}
 & 
Ferramentas GPS
 & 
Ferramentas para carregar e importar dados do GPS
 & 
{\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Complemento GPS}}}
\\

\includegraphics[width=1.5em]{grasslogo.png}
 & 
GRASS
 & 
GRASS functionality
 & 
{\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integração com SIG GRASS}}}
\\

\includegraphics[width=1.5em]{raster-info.png}
 & 
Ferramentas GDAL
 & 
GDAL raster functionality
 & 
{\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Ferramentas do complemento  GDAL}}}
\\

\includegraphics[width=1.5em]{georeferencer.png}
 & 
Georreferenciador GDAL
 & 
Georeference Raster with GDAL
 & 
{\hyperref[docs/user_manual/plugins/plugins_georeferencer:georef]{\emph{Complemento Georreferenciador}}}
\\

\includegraphics[width=1.5em]{heatmap.png}
 & 
Heatmap
 & 
Create heatmap raster from input vector points
 & 
{\hyperref[docs/user_manual/plugins/plugins_heatmap:heatmap-plugin]{\emph{Complemento de Mapa de Calor}}}
\\

\includegraphics[width=1.5em]{interpolation.png}
 & 
Interpolação
 & 
Interpolação com base em pontos de uma camada vetorial
 & 
{\hyperref[docs/user_manual/plugins/plugins_interpolation:interpol]{\emph{Complemento de Interpolação}}}
\\

\includegraphics{mapserver_export.png}
 & 
Exportar para MapServer
 & 
Export a QGIS project file to a MapServer map file
 & 
{\hyperref[docs/user_manual/plugins/plugins_mapserver_export:mapserver-export]{\emph{Complemento de exportação do MapServer}}}
\\

\includegraphics[width=1.5em]{offline_editing_copy.png}
 & 
Edição Offline
 & 
Edita offline e sincroniza com uma base de dados
 & 
{\hyperref[docs/user_manual/plugins/plugins_offline_editing:offlinedit]{\emph{Complemento Edição Offline}}}
\\

\includegraphics[width=1.5em]{osm_load.png}
 & 
OpenStreetMap
 & 
Access OpenStreetMap
 & 
{\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}
\\

\includegraphics[width=1.5em]{oracle_raster.png}
 & 
Georaster Oracle Spatial
 & 
Acessa Georasters Oracle Spatial
 & 
{\hyperref[docs/user_manual/plugins/plugins_oracle_raster:oracle-raster]{\emph{Complemento Oracle GeoRaster}}}
\\

\includegraphics[width=1.5em]{plugin_installer.png}
 & 
Instalador de complementos
 & 
Baixa e instala complementos python
 & 
{\hyperref[docs/user_manual/plugins/plugins:python-plugin-installer]{\emph{Usando o Instalador de Complementos Python}}}
\\

\includegraphics[width=1.5em]{raster_terrain.png}
 & 
Raster Terrain Analysis
 & 
Compute geomorphological features from DEMs
 & 
{\hyperref[docs/user_manual/plugins/plugins_raster_terrain:rasterrain]{\emph{Raster Terrain Analysis Plugin}}}
\\


 & 
Menor Distância
 & 
Shortest path analysis
 & 
{\hyperref[docs/user_manual/plugins/plugins_road_graph:roadgraph]{\emph{Compemento Caminho Mais Curto}}}
\\

\includegraphics{spiticon.png}
 & 
SPIT
 & 
Shapefile to PostGIS Import Tool
 & 
{\hyperref[docs/user_manual/working_with_vector/supported_data:loading-postgis-data]{\emph{Importação de dados no PostgreSQL}}}
\\

\includegraphics[width=1.5em]{sqlanywhere.png}
 & 
SQL Anywhere
 & 
Access SQL anywhere DB
 & 
{\hyperref[docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere]{\emph{Complemento SQL Anywhere}}}
\\

\includegraphics[width=1.5em]{spatialquery.png}
 & 
Consulta Espacial
 & 
Spatial queries on vectors
 & 
{\hyperref[docs/user_manual/plugins/plugins_spatial_query:spatial-query]{\emph{Plugin de Consulta Espacial}}}
\\

\includegraphics[width=1.5em]{raster-stats.png}
 & 
Zonal Statistics
 & 
Calculate raster statistics for vector polygons
 & 
{\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics]{\emph{Complemento Estatística Zonal}}}
\\
\hline\end{tabulary}



\section{Complemento Captura de coordenadas}
\label{docs/user_manual/plugins/plugins_coordinate_capture:coordinate-capture-plugin}\label{docs/user_manual/plugins/plugins_coordinate_capture:coordcapt}\label{docs/user_manual/plugins/plugins_coordinate_capture::doc}
O complelemento de captura de coordenadas é fácil de usar e oferece a possibilidade de visualizar as coordenadas na tela do mapa para dois Sistemas de Coordenadas de Referência (SRC) selecionados.
\phantomsection\label{docs/user_manual/plugins/plugins_coordinate_capture:figure-coordinate-capture-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{coordinate_capture_dialog.png}
\caption{Coordinate Capture Plugin \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{enumerate}
\item {} 
Start QGIS, select \includegraphics[width=1em]{mActionOptions.png} \emph{Project Properties} from the
\emph{Settings} (KDE, Windows) or \emph{File} (Gnome, OSX) menu
and click on the \emph{Projection} tab. As an alternative you can also
click on the \includegraphics[width=1.5em]{mIconProjectionEnabled.png} $^{\text{CRS status}}$ icon in the lower
right-hand corner of the statusbar.

\item {} 
Clique na \includegraphics{checkbox.png} caixa de seleção \emph{Habilitar reprojeção `on the fly' como padrão} e selecione um sistema de coordenada projetado de sua preferência (ver também {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Trabalhando com Projeções}}}).

\item {} 
Load the coordinate capture plugin in the Plugin Manager (see
{\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}) and ensure that the dialog is visible by going to
\emph{View \(\rightarrow\) Panels} and ensuring that \includegraphics{checkbox.png}
\emph{Coordinate Capture} is enabled. The coordinate capture dialog
appears as shown in Figure {\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:figure-coordinate-capture-1]{figure\_coordinate\_capture\_1}}.

\item {} 
Clique no \includegraphics{geographic.png} :sup: ícone \emph{Clique para selecionar o SRC e usá-lo para mostrar as coordenadas} e selecione um SRC diferente para uma que voce selecionou acima.

\item {} 
Para iniciar a captura de coordenadas, clique em \textbf{{[}Iniciar captura{]}}. Agora voce pode clicar onde desejar no mapa da tela e o complemento irá mostrar a coordenada para o local que voce clicou no SRC selecionado.

\item {} 
Para habilitar o rastreamento de coordenada do mouse clique no \includegraphics[width=1.5em]{tracking.png}: sup: ícone \emph{mouse rastreamento}.

\item {} 
Você também pode copiar as coordenadas selecionadas para a área de transferência.

\end{enumerate}


\section{Complemento DB Manager}
\label{docs/user_manual/plugins/plugins_db_manager:db-manager-plugin}\label{docs/user_manual/plugins/plugins_db_manager:dbmanager}\label{docs/user_manual/plugins/plugins_db_manager::doc}
The DB Manager Plugin is officially part of QGIS core and intends to replace the
SPIT Plugin and the PostGIS Manager Plugin and additionally to integrate all other
database formats supported by QGIS in one user interface. The \includegraphics[width=1.5em]{dbmanager.png}
$^{\text{DB Manager}}$ Plugin provides several features. You can drag layers from the
QGIS Browser into the DB Manager and it will import your layer into your spatial
database. You can drag and drop tables between spatial databases and they will
get imported. You can also use the DB Manager to execute SQL queries against your
spatial database and then view the spatial output for queries by adding the
results to QGIS as a query layer.
\phantomsection\label{docs/user_manual/plugins/plugins_db_manager:figure-db-manager}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{db_manager.png}
\caption{DB Manager dialog (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}

The \emph{Database} menu allows to connect to an existing database, to
start the SQL-window and to exit the DB Manager Plugin. The \emph{Schema}
menu includes tools to create and delete (empty) schemas and, if topology is
available (e.g. PostGIS 2) to start a \emph{TopoViewer}. The menu
\emph{Table} allows to create and edit tables and to delete tables and
views. It is also possible to empty tables and to move tables from one to another
schema. Finally you can also run Vacuum Analyze and add Versioning Support to a
table.

The \emph{Tree} window lists all existing databases supported by QGIS. With
a double-click you can connect to the database. With the right-mouse button you
can rename and delete existing schemas and tables. Tables can also be added to
the QGIS canvas with the context menu.

If connected to a database, the \textbf{main} window of the DB Manager offers three
tabs. The \emph{Info} tab provides information about the table and its
geometry as well as about existing Fields, Constraints and Indexes. It also
allows to run Vacuum Analyze and to create a spatial index on a selected table,
if not already done. The \emph{Table} tab shows all attributes and the
\emph{Preview} tab renders the geometries as preview.


\section{Delimited Text Plugin}
\label{docs/user_manual/plugins/plugins_delimited_text:delimited-text-plugin}\label{docs/user_manual/plugins/plugins_delimited_text:label-dltext}\label{docs/user_manual/plugins/plugins_delimited_text::doc}
The Delimited Text plugin allows you to load a delimited text file as a layer in
QGIS.


\subsection{Requirements}
\label{docs/user_manual/plugins/plugins_delimited_text:requirements}
To view a delimited text file as layer, the text file must contain:
\begin{enumerate}
\item {} 
A delimited header row of field names. This must be the first line in the text
file.

\item {} 
The header row must contain an X and Y field. These fields can have any name.

\item {} 
The x and y coordinates must be specified as a number. The coordinate system
is not important.

\end{enumerate}

As an example of a valid text file we import the elevation point data file
\code{elevp.csv} coming with the QGIS sample dataset (See Section
{\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dados de exemplo}}}):

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{X}\PYG{p}{;}\PYG{n}{Y}\PYG{p}{;}\PYG{n}{ELEV}
\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{300120}\PYG{p}{;}\PYG{l+m+mi}{7689960}\PYG{p}{;}\PYG{l+m+mi}{13}
\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{654360}\PYG{p}{;}\PYG{l+m+mi}{7562040}\PYG{p}{;}\PYG{l+m+mi}{52}
\PYG{l+m+mi}{1640}\PYG{p}{;}\PYG{l+m+mi}{7512840}\PYG{p}{;}\PYG{l+m+mi}{3}
\PYG{p}{[}\PYG{o}{.}\PYG{o}{.}\PYG{o}{.}\PYG{p}{]}
\end{Verbatim}

Some items of note about the text file are:
\begin{enumerate}
\item {} 
The example text file uses \code{;} (semicolon) as delimiter. Any character can
be used to delimit the fields.

\item {} 
The first row is the header row. It contains the fields \code{X}, \code{Y} and \code{ELEV}.

\item {} 
No quotes (\code{"}) are used to delimit text fields.

\item {} 
The x coordinates are contained in the \code{X} field.

\item {} 
The y coordinates are contained in the \code{Y} field.

\end{enumerate}


\subsection{Using the Plugin}
\label{docs/user_manual/plugins/plugins_delimited_text:using-the-plugin}
To use the plugin you must first enable it as described in Section
{\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gerenciar Complementos}}}.

Click the new toolbar icon \includegraphics[width=1.5em]{delimited_text.png} $^{\text{Add Delimited Text Layer}}$ to
open the \emph{Delimited Text} dialog as shown in {\hyperref[docs/user_manual/plugins/plugins_delimited_text:figure-delimited-text-1]{figure\_delimited\_text\_1}}.
\phantomsection\label{docs/user_manual/plugins/plugins_delimited_text:figure-delimited-text-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{delimited_text_dialog.png}
\caption{Delimited Text Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

First select the file (e.g., \code{qgis\_sample\_data/csv/elevp.csv}) to import
by clicking on the \textbf{{[}Browse{]}} button. Once the file is selected, the plugin
attempts to parse the file using the last used delimiter, in this case a semicolon
(\code{;}). To properly parse the file, it is important to select the correct
delimiter. To change the delimiter to tab use \code{\textbackslash{}t} (this is a regular expression
for the tab character).

Once the file is parsed, choose the \code{X} and \code{Y} fields from the dropdown
lists and if available also the WKT field for the CRS information. Finally enter
a Layer name (e.g., \code{elevp} ) as shown in {\hyperref[docs/user_manual/plugins/plugins_delimited_text:figure-delimited-text-1]{figure\_delimited\_text\_1}} . To
add the layer to the map, click \textbf{{[}OK{]}}. The delimited text file now behaves as
any other map layer in QGIS.


\section{Diagram Overlay Plugin}
\label{docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay-plugin}\label{docs/user_manual/plugins/plugins_diagram_overlay::doc}\label{docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay}
\includegraphics[width=2em]{diagram.png} The \emph{Diagram Overlay} Plugin allows you to add a graphic
overlay to a vector layer (see {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-1]{figure\_overlay\_1}}). It provides additional and
not yet implemented features to the \emph{Diagrams} tab, described in secion
{\hyperref[docs/user_manual/working_with_vector/vector_properties:sec-diagram]{\emph{Diagrams Tab}}}.

Before starting, the \emph{Diagram Overlay} Plugin needs to be activated
using the Plugin Manager (see Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}). It will then
appear as \emph{Overlay} tab in the \emph{Layer Properties} dialog
next to the \emph{Diagrams} tab.
\phantomsection\label{docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{overlay_tab1.png}
\caption{Vector properties dialog with overlay tab \includegraphics[width=1em]{nix.png}}\end{figure}

The \emph{Overlay} tab provides support for Pie charts, Bar charts and
proportional SVG symbols.

Similar to the \emph{Diagrams} tab, we will demonstrate an example and
overlay the alaska boundary layer a piechart diagram showing some temperature
data from a climate vector layer. Both vector layers are part of the QGIS
sample dataset (see Section {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dados de exemplo}}}).
\begin{enumerate}
\item {} 
First click on the \includegraphics[width=1.5em]{mActionAddOgrLayer.png} $^{\text{Load Vector}}$ icon, browse to
the QGIS sample dataset folder and load the two vector shape layers
\code{alaska.shp} and \code{climate.shp}.

\item {} 
Double click the \code{climate} layer in the map legend to open the
\emph{Layer Properties} dialog.

\item {} 
Click on the \emph{Overlay} tab, activate \includegraphics{checkbox.png} \emph{Display
diagrams} and select `Pie Chart' from \emph{Diagram type} \includegraphics{selectstring.png}
combobox.

\item {} 
We want to display the values of the three columns \code{T\_F\_JAN}, \code{T\_F\_JUL}
and \code{T\_F\_MEAN}. First select \code{T\_F\_JAN} as Attributes and click the
\textbf{{[}Add{]}} button, then \code{T\_F\_JUL} and finally \code{T\_F\_MEAN}.

\item {} 
Diagram size is based on linear scaling of a classification attribute. We
choose \code{T\_F\_JUL}, click on \textbf{{[}Find maximum value{]}} and set size to \code{20}
and \emph{Size unit} \includegraphics{selectstring.png} to `Millimeter'.

\item {} 
Now click \textbf{{[}Apply{]}} to display the diagram in the QGIS main window.

\item {} 
You can now adapt the chart size, or change the attribute colors double
clicking on the color values in the attribute field. {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-2]{Figure\_overlay\_2}}
gives an impression.

\item {} 
Finally click \textbf{{[}Ok{]}}.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{overlay_tab2.png}
\caption{Pie chart diagram from temperature data overlayed on a map \includegraphics[width=1em]{nix.png}}\end{figure}

Additionally in the \emph{Settings \(\rightarrow\) Options} dialog, there is a
\code{Overlay} tab where it is possible to select the placement algorithm of the
diagrams. The `Central point' method is a generic one, the others use algorithms
of the PAL library. They also consider diagram objects and labels in different
layers.


\section{Dxf2Shp Converter Plugin}
\label{docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shp-converter-plugin}\label{docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape}\label{docs/user_manual/plugins/plugins_dxf2shape_converter::doc}
The dxf2shape converter plugin can be used to convert vector data from DXF to
Shapefile format. It requires the following parameters to be specified before
running:
\phantomsection\label{docs/user_manual/plugins/plugins_dxf2shape_converter:figure-dxf2shape-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{dxf2shape_dialog.png}
\caption{Dxf2Shape Converter Plugin}\end{figure}
\begin{itemize}
\item {} 
\textbf{Input DXF file}: Enter path to the DXF file to be converted

\item {} 
\textbf{Output Shp file}: Enter desired name of the Shapefile to be created

\item {} 
\textbf{Output file type}: Specify the geometry type of the output Shapefile.
Currently supported types are polyline, polygon, and point.

\item {} 
\textbf{Export text labels}: When this checkbox is enabled, an additional
Shapefile point layer will be created, and the associated dbf table will
contain information about the ``TEXT'' fields found in the dxf file, and the text
strings themselves.

\end{itemize}


\subsection{Using the Plugin}
\label{docs/user_manual/plugins/plugins_dxf2shape_converter:using-the-plugin}\begin{enumerate}
\item {} 
Start QGIS, load the Dxf2Shape plugin in the Plugin Manager (see Section
{\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}) and click on the \includegraphics[width=1.5em]{dxf2shp_converter.png} $^{\text{Dxf2Shape
Converter}}$ icon which appears in the QGIS toolbar menu. The Dxf2Shape plugin
dialog appears as shown in {\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:figure-dxf2shape-1]{Figure\_dxf2shape\_1}}.

\item {} 
Enter input DXF file, a name for the output Shapefile and the Shapefile type.

\item {} 
Enable the \includegraphics{checkbox.png} \emph{Export text labels} checkbox if you want
to create an extra point layer with labels.

\item {} 
Click \textbf{{[}OK{]}}.

\end{enumerate}


\section{Complemento eVis}
\label{docs/user_manual/plugins/plugins_evis:evis-plugin}\label{docs/user_manual/plugins/plugins_evis:evis}\label{docs/user_manual/plugins/plugins_evis::doc}
The Biodiversity Informatics Facility at the American Museum of Natural History's
(AMNH) Center for Biodiversity and Conservation (CBC) (this section is derived
from Horning, N., K. Koy, P. Ersts. 2009. eVis (v1.1.0) User's Guide. American
Museum of Natural History, Center for Biodiversity and Conservation. Available
from \href{http://biodiversityinformatics.amnh.org/}{http://biodiversityinformatics.amnh.org/}, and released under the GNU FDL.)
has developed the Event Visualization Tool (eVis), another software tool to add
to the suite of conservation monitoring and decision support tools for guiding
protected area and landscape planning. This plugin enables users to easily link
geocoded (i.e., referenced with latitude and longitude or X and Y coordinates)
photographs, and other supporting documents, to vector data in QGIS.

eVis agora é automaticamente instalado e habilitado nas novas versões do QGIS, e como acontece com todos os complementos, ele pode ser desativado e ativado usando o Gerenciador de Complementos (Veja: ref: \emph{Gerenciar\_Complementos}).

The eVis plugin is made up of three modules: the `Database Connection tool',
`Event ID tool', and the `Event Browser'. These work together to allow viewing of
geocoded photographs and other documents that are linked to features stored in
vector files, databases, or spreadsheets.


\subsection{Navegador de Evento}
\label{docs/user_manual/plugins/plugins_evis:evis-browser}\label{docs/user_manual/plugins/plugins_evis:event-browser}
O módulo Navegador de Evento fornece a funcionalidade para exibir fotografias georreferenciadas que estão ligadas a características vetoriais exibidas na janela de mapa do QGIS. Dados pontuais, por exemplo, pode ser a partir de um arquivo vetorial que pode ser introduzido utilizando o QGIS ou pode ser a partir do resultado de uma consulta a base de dados. O recurso vetor deve ter informações de atributo associado a ele para descrever o local e o nome do arquivo que contém a fotografia e, opcionalmente, a direção que estava apontada a bússola da câmera quando a imagem foi adquirida. Sua camada de vetor deve ser carregada no QGIS antes de executar o Navegador de Evento.


\subsubsection{Iniciando o módulo Navegador de Evento}
\label{docs/user_manual/plugins/plugins_evis:launch-the-event-browser-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-browser}
To launch the Event browser module either click on the \includegraphics[width=1.5em]{event_browser.png}
$^{\text{eVis Event Browser}}$ icon or click on \emph{Database \(\rightarrow\) eVis \(\rightarrow\)
eVis Event Browser}. This will open the \emph{Generic Event Browser} window.

The \emph{Generic Event Browser} window has three tabs displayed at the top
of the window. The \emph{Display} tab is used to view the photograph and its
associated attribute data. The \emph{Options} tab provides a number of
settings that can be adjusted to control the behavior of the eVis plugin. Lastly,
the \emph{Configure External Applications} tab is used to maintain a table
of file extensions and their associated application to allow eVis to display
documents other than images.


\subsubsection{Entendendo a Janela de Exibição}
\label{docs/user_manual/plugins/plugins_evis:evis-display-window}\label{docs/user_manual/plugins/plugins_evis:understanding-the-display-window}
To see the \emph{Display} window click on the \emph{Display} tab in the
\emph{Generic Event Browser} window. The \emph{Display} window is used
to view geocoded photographs and their associated attribute data.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisdisplay.png}
\caption{The \emph{eVis} display window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Display window}: A window where the photograph will appear.

\item {} 
\textbf{Zoom in button}: Zoom in to see more detail. If the entire image cannot be
displayed in the display window, scroll bars will appear on the left and bottom
sides of the window to allow you to pan around the image.

\item {} 
\textbf{Zoom out button}: Zoom out to see more area.

\item {} 
\textbf{Zoom to full extent} button: Displays the full extent of the photograph.

\item {} 
** Janela informações de atributo {\color{red}\bfseries{}**}: Todas as informações de atributo para o ponto associado com a fotografia que está sendo visualizada é apresentada aqui. Se o tipo de arquivo que está sendo referenciado no registro exibido não é uma imagem, mas é de um tipo de arquivo definido no: guilabel: \emph{Configurar aplicações externas} guia então quando você clicar duas vezes sobre o valor do campo que contém o caminho para o arquivo, o aplicativo para abrir o arquivo será lançado para ver ou ouvir o conteúdo do arquivo. Se a extensão do arquivo é reconhecida os dados dos atributos serão exibidos em verde.

\item {} 
\textbf{Navigation buttons}: Use the Previous and Next buttons to load the previous
or next feature when more than one feature is selected.

\item {} 
** Indicador de Recurso {\color{red}\bfseries{}**}: Este título indica qual função está sendo exibida e quantos recursos estão disponíveis para exibição.

\end{enumerate}


\subsubsection{Entendendo a janela Opções}
\label{docs/user_manual/plugins/plugins_evis:understanding-the-options-window}\label{docs/user_manual/plugins/plugins_evis:evis-options-window}\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisoptions.png}
\caption{The \emph{eVis} Options window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{File path}: A dropdown list to specify the attribute field that contains
the directory path or URL for the photographs or other documents being
displayed. If the location is a relative path then the checkbox must be
clicked. The base path for a relative path can be entered in the \emph{Base
Path} text box below. Information about the different options for specifying
the file location are noted in the section {\hyperref[docs/user_manual/plugins/plugins_evis:evis-specifying]{\emph{Especificando o local e o nome de uma fotografia}}} below.

\item {} 
** Campo de exibição rumo bússola {\color{red}\bfseries{}**}: Uma lista suspensa para especificar o campo de atributo que contém o rumo associado com a fotografia que está sendo exibido. Se as informações de bússola estão disponíveis, é necessário clicar na caixa de seleção à esquerda do título do menu suspenso.

\item {} 
** Compensar bússola Configuração {\color{red}\bfseries{}**}: Deslocamentos bússola pode ser usado para compensar a declinação (ajustar rumos coletados utilizando rumos magnéticos para rumos norte verdadeiro). Clique no \textbar{} radiobuttonon {\color{red}\bfseries{}\textbar{}}: guilabel: `manual' botão de opção para entrar o deslocamento na caixa de texto ou clique no \textbar{} radiobuttonon {\color{red}\bfseries{}\textbar{}}: guilabel: {\color{red}\bfseries{}{}`}Do Atributo `botão de opção para selecionar o campo de atributo que contém os deslocamentos. Para ambas opções, declinações leste deve ser digitado valores positivos e declinações oeste devem usar valores negativos.

\item {} 
\textbf{Caminho Diretório base}: O caminho de base para que o caminho relativo definido no {\hyperref[docs/user_manual/plugins/plugins_evis:figure-evis-2]{Figure\_eVis\_2}} (A) será anexado.

\item {} 
\textbf{Substitua o caminho}: Se esta opção estiver marcada, somente o nome do arquivo A será anexado ao caminho de base.

\item {} 
\textbf{Aplicar regra a todos os documentos}: Se marcado, as mesmas regras de caminho que são definidas para as fotografias serão usadas para os documentos não-imagem, como filmes, documentos de texto e arquivos de som. Se não marcado as regras de caminho só se aplica a fotografias e outros documentos ignorará o parâmetro Caminho base.

\item {} 
\textbf{Salve as configurações}: Se esta opção estiver marcada, os valores dos parâmetros associados serão salvos para a próxima sessão, quando a janela é fechada ou quando o botão \textbf{{[}Salvar{]}} abaixo é pressionado.

\item {} 
\textbf{Redefinir valores}: Redefine os valores nesta linha para a configuração padrão.

\item {} 
\textbf{Restaure falhas **: Isso redefinirá todos os campos para suas configurações padrão. Ele tem o mesmo efeito que clicar em todos os botões **{[}Redefinir{]}}.

\item {} 
\textbf{Save}: This will save the settings without closing the \emph{Options}
pane.

\end{enumerate}


\subsubsection{Entendendo a janela Configurar Aplicações Externas}
\label{docs/user_manual/plugins/plugins_evis:evis-external-window}\label{docs/user_manual/plugins/plugins_evis:understanding-the-configure-external-applications-window}\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisexternal.png}
\caption{The \emph{eVis} External Applications window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
{\color{red}\bfseries{}**}Arquivo tabela de referência {\color{red}\bfseries{}**}: Uma tabela contendo os tipos de arquivos que podem ser abertos usando eVis. Cada tipo de arquivo tem uma extensão de arquivo e o caminho para um aplicativo poder abrí-lo. Isso fornece a capacidade de abrir uma ampla gama de arquivos como filmes, gravações sonoras, e documentos de texto em vez de apenas imagens.

\item {} 
\textbf{Adicionar novo tipo de arquivo}: Adicionar um novo tipo de arquivo com uma extensão única e o caminho para o aplicativo poder abrí-lo.

\item {} 
** Excluir linha atual {\color{red}\bfseries{}**}: Exclui o tipo de arquivo em destaque na tabela e definido por uma extensão de arquivo e um caminho para um aplicativo associado.

\end{enumerate}


\subsection{Especificando o local e o nome de uma fotografia}
\label{docs/user_manual/plugins/plugins_evis:evis-specifying}\label{docs/user_manual/plugins/plugins_evis:specifying-the-location-and-name-of-a-photograph}
O local e o nome da fotografia podem ser armazenados usando um caminho absoluto ou relativo ou um URL (Uniform Resource Locator em português Localizador-Padrão de Recursos) se a fotografia está disponível em um servidor web. Exemplos das diferentes abordagens estão listadas na Tabela eVis\_exemplos {}`{}` \_.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:evis-examples}
\begin{Verbatim}[commandchars=\\\{\}]
X        Y        FILE                                                  BEARING
780596   1784017  C:\PYGZbs{}Workshop\PYGZbs{}eVis\_Data\PYGZbs{}groundphotos\PYGZbs{}DSC\_0168.JPG       275
780596   1784017  /groundphotos/DSC\_0169.JPG                            80
780819   1784015  http://biodiversityinform.org/testdata/DSC\_0170.JPG   10
780596   1784017  pdf:http://www.test.com/attach.php?attachment\_id-12   76
\end{Verbatim}


\subsection{Especificando o local e o nome de outros documentos suportados}
\label{docs/user_manual/plugins/plugins_evis:evis-location}\label{docs/user_manual/plugins/plugins_evis:specifying-the-location-and-name-of-other-supporting-documents}
Supporting documents such as text documents, videos, and sound clips can also
be displayed or played by eVis. To do this it is necessary to add an entry in
the file reference table that can be accessed from the \emph{Configure External
Applications} window in the \emph{Generic Event Browser} that matches the
file extension to an application that can be used to open the file. It is also
necessary to have the path or URL to the file in the attribute table for the
vector layer. One additional rule that can be used for URLs that don't contain
a file extension for the document you want to open is to specify the file
extension before the URL. The format is --- \code{file extension:URL}. The URL is
preceded by the file extension and a colon, and is particularly useful for
accessing documents from Wikis and other web sites that use a database to
manage the web pages (see Table {\hyperref[docs/user_manual/plugins/plugins_evis:evis-examples]{evis\_examples}}).


\subsection{Usando o Navegador de Evento}
\label{docs/user_manual/plugins/plugins_evis:using-the-generic-event-browser}\label{docs/user_manual/plugins/plugins_evis:evis-using-browser}
When the \emph{Event Browser} window opens a photograph will appear in the
display window if the document referenced in the vector file attribute table is
an image and if the file location information in the \emph{Options} window
is properly set. If a photograph is expected and it does not appear it will be
necessary to adjust the parameters in the \emph{Options} window.

If a supporting document (or an image that does not have a file extension
recognized by eVis) is referenced in the attribute table the field containing
the file path will be highlighted in green in the attribute information window
if that file extension is defined in the file reference table located in the
\emph{Configure External Applications} window. To open the document
double-click on the green-highlighted line in the attribute information window.
If a supporting document is referenced in the attribute information window and
the file path is not highlighted in green then it will be necessary to add an
entry for the file's filename extension in the \emph{Configure External
Applications} window. If the file path is highlighted in green but does not open
when double-clicked it will be necessary to adjust the parameters in the
\emph{Options} window so the file can be located by eVis.

If no compass bearing is provided in the \emph{Options} window a red asterisk
will be displayed on top of the vector feature that is associated with the
photograph being displayed. If a compass bearing is provided then an arrow will
appear pointing in the direction indicated by the value in the compass bearing
display field in the \emph{Generic Event Browser} window. The arrow will be
centered over the point that is associated with the photograph or other document.

To close the \emph{Generic Event Browser} window click on the \textbf{{[}Close{]}}
button from the \emph{Display} window.


\subsection{Ferramenta ID de Evento}
\label{docs/user_manual/plugins/plugins_evis:evis-id-tool}\label{docs/user_manual/plugins/plugins_evis:event-id-tool}
The `Event ID' module allows you to display a photograph by clicking on a feature
displayed in the QGIS map window. The vector feature must have attribute
information associated with it to describe the location and name of the file
containing the photograph and optionally the compass direction the camera was
pointed when the image was acquired. This layer must be loaded into QGIS before
running the `Event ID' tool.


\subsubsection{Iniciando o módulo Identificação de Evento}
\label{docs/user_manual/plugins/plugins_evis:launch-the-event-id-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-id}
To launch the `Event ID' module either click on the \includegraphics[width=1.5em]{event_id.png} $^{\text{Event ID}}$
icon or click on \emph{Plugins \(\rightarrow\) eVis \(\rightarrow\) Event ID Tool}. This will
cause the cursor to change to an arrow with an `i' on top of it signifying that
the ID tool is active.

To view the photographs linked to vector features in the active vector layer
displayed in the QGIS map window, move the Event ID cursor over the feature and
then click the mouse. After clicking on the feature, the \emph{Generic Event
Browser} window is opened and the photographs on or near the clicked locality are
available for display in the browser. If more than one photograph is available,
you can cycle through the different features using the \textbf{{[}Previous{]}} and
\textbf{{[}Next{]}} buttons. The other controls are described in the ref:\emph{evis\_browser}
section of this guide.


\subsection{Conexão com o Base de Dados}
\label{docs/user_manual/plugins/plugins_evis:database-connection}\label{docs/user_manual/plugins/plugins_evis:evis-database}
The `Database Connection' module provides tools to connect to and query a
database or other ODBC resource, such as a spreadsheet.

eVis pode se conectar diretamente a quatro tipos de bases de dados: Microsoft Access, PostgreSQL, MySQL, SQLite, e também pode ler a partir de conexões ODBC. Ao ler a partir de uma base de dados ODBC (como uma planilha do Excel) é necessário configurar o driver ODBC para o sistema operacional que você está usando.


\subsubsection{Iniciando o módulo Conexão com a Base de Dados}
\label{docs/user_manual/plugins/plugins_evis:launch-the-database-connection-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-database}
To launch the `Database Connection' module either click on the appropriate icon
\includegraphics[width=1.5em]{evis_connect.png} $^{\text{eVis Database Connection}}$ or click on \emph{Plugins \(\rightarrow\)
eVis \(\rightarrow\) Database Connection}. This will launch the \emph{Database Connection}
window. The window has three tabs: \emph{Predefined Queries},
\emph{Database Connection}, and \emph{SQL Query}. The \emph{Output
Console} window at the bottom of the window displays the status of actions
initiated by the different sections of this module.


\subsubsection{Conectar a uma base de dados}
\label{docs/user_manual/plugins/plugins_evis:connect-to-a-database}\label{docs/user_manual/plugins/plugins_evis:evis-connect-database}
Click on the \emph{Database Connection} tab to open the database
connection interface. Next, use the \emph{Database Type} \includegraphics{selectstring.png}
combobox to select the type of database that you want to connect to. If a
password or username is required, that information can be entered in the
\emph{Username} and \emph{Password} textboxes.

Enter the database host in the \emph{Database Host} textbox. This option is
not available if you selected ``MS Access'' as the database type. If the database
resides on your desktop you should enter ``localhost''.

Enter the name of the database in the \emph{Database Name} textbox. If you
selected ``ODBC'' as the database type, you need to enter the data source name.

When all of the parameters are filled in, click on the \textbf{{[}Connect{]}} button.
If the connection is successful, a message will be written in the \emph{Output
Console} window stating that the connection was established. If a connection was
not established you will need to check that the correct parameters were entered
above.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisdatabase.png}
\caption{The \emph{eVis} Database connection window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Tipo de Base de dados}: Uma lista suspensa para especificar o tipo de base de dados que será usado.

\item {} 
\textbf{Base de dados hospedeiro}: O nome da base de dados hospedeiro.

\item {} 
\textbf{Port} The port number if a MySQL or PostgreSQL database type is selected.

\item {} 
\textbf{Nome da Base de Dados} O nome da base de dados.

\item {} 
\textbf{Conectar} Um botão para conectar-se a banco de dados usando os parâmetros definidos acima.

\item {} 
\textbf{Console de Saída} A janela do console onde as mensagens relacionadas ao processamento são exibidos.

\item {} 
\textbf{Nome de Usuário}: Nome de usuário para uso quando uma base de dados é protegida por senha.

\item {} 
\textbf{Senha}: Senha para uso quando uma base de dados é protegida por senha.

\item {} 
\textbf{Consultas pré-definidas}: Guia para abrir a janela ``Consultas pré-definidas''.

\item {} 
{\color{red}\bfseries{}**}Conexão com a base de dados {\color{red}\bfseries{}**}: Guia para abrir a janela ``Conexão com a Base de dados''.

\item {} 
\textbf{Consulta SQL}: Guia para abrir a janela ``Consulta SQL''.

\item {} 
\textbf{Ajuda}: Exibe a ajuda on line.

\item {} 
\textbf{OK}: Fecha a janela principal do ``Conexão com a Base de Dados''.

\end{enumerate}


\subsubsection{Execução de consultas SQL}
\label{docs/user_manual/plugins/plugins_evis:running-sql-queries}\label{docs/user_manual/plugins/plugins_evis:evis-running-sql}
Consultas SQL são usadas para extrair informações de uma base de dados ou de recursos ODBC. Em eVis a saída dessas consultas é uma camada vetorial adicionado à janela de mapa do QGIS. Clique no: guilabel: guia \emph{Consultas SQL} para exibir a interface de consulta SQL. Comandos SQL podem ser inseridos nesta janela de texto. Um tutorial útil em comandos SQL está disponível em \href{http://www.w3schools.com/sql}{http://www.w3schools.com/sql}. Por exemplo, para extrair todos os dados de uma planilha em um arquivo do Excel, {}`{}` Selecione * de {[}Plan1 \${]} {\color{red}\bfseries{}{}`{}`}, onde {}`{}` Plan1 {}`{}` é o nome da planilha.

Click on the \textbf{{[}Run Query{]}} button to execute the command. If the query
is successful a \emph{Database File Selection} window will be displayed. If
the query is not successful an error message will appear in the \emph{Output
Console} window.

In the \emph{Database File Selection} window, enter the name of the layer
that will be created from the results of the query in the \emph{Name of New
Layer} textbox.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evissql_query.png}
\caption{The eVis SQL query tab \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Janela de Texto de Consulta SQL}: Uma tela para escrever consultas SQL.

\item {} 
\textbf{Run Query}: Button to execute the query entered in the \emph{SQL Query
Window}.

\item {} 
\textbf{Janela Console}: A janela console onde as mensagens relacionadas ao processamento são exibidas.

\item {} 
\textbf{Ajuda}: Exibe a ajuda on line.

\item {} 
\textbf{OK}: Closes the main \emph{Database Connection} window.

\end{enumerate}

Use the \emph{X Coordinate} \includegraphics{selectstring.png} and \emph{Y Coordinate}
\includegraphics{selectstring.png} comboboxes to select the field from the database that store the
\code{X} (or longitude) and \code{Y} (or latitude) coordinates. Clicking on the \textbf{{[}OK{]}}
button causes the vector layer created from the SQL query to be displayed in the
QGIS map window.

To save this vector file for future use, you can use the QGIS `Save as...'
command that is accessed by right clicking on the layer name in the QGIS map
legend and then selecting `Save as...'

\begin{notice}{tip}{Dica:}
\textbf{Criando uma camada vetorial a partir de uma planilha do Microsoft Excel}

When creating a vector layer from a Microsoft Excel Worksheet you might see
that unwanted zeros (``0'') have been inserted in the attribute table rows
beneath valid data.This can be caused by deleting the values for these cells
in Excel using the \code{Backspace} key. To correct this problem you need to
open the Excel file (you'll need to close QGIS if there if you are connected
to the file to allow you to edit the file) and then use
\emph{Edit \(\rightarrow\) Delete} to remove the blank rows from the file. To
avoid this problem you can simply delete several rows in the Excel Worksheet
using \emph{Edit \(\rightarrow\) Delete} before saving the file.
\end{notice}


\subsubsection{Executando consultas pré-definidas}
\label{docs/user_manual/plugins/plugins_evis:running-predefined-queries}\label{docs/user_manual/plugins/plugins_evis:evis-predefined}
Com consultas predefinidas você pode selecionar consultas previamente escritas e armazenadas no formato XML em um arquivo. Isto é particularmente útil se você não estiver familiarizado com os comandos SQL. Clique no: guilabel: guia {\color{red}\bfseries{}{}`}Consultas Predefinidas' para exibir a interface de consulta prédefinida.

To load a set of predefined queries click on the \includegraphics[width=1.5em]{evis_file.png} $^{\text{Open File}}$
icon. This opens the \emph{Open File} window which is used to locate the file
containing the SQL queries. When the queries are loaded their titles, as
defined in the XML file, will appear in the dropdown menu located just below
the \includegraphics[width=1.5em]{evis_file.png} $^{\text{Open File}}$ icon, the full description of the query is
displayed in the text window under the dropdown menu.

Selecione a consulta que você deseja executar no menu suspenso e, então clique em: guilabel: guia \emph{Consulta SQL} para ver se a consulta foi carregada na janela Consulta. Se for a primeira vez que você estiver executando uma consulta predefinida ou estiver migrando bancos de dados, você precisa ter certeza de estar conectado ao banco de dados.

Click on the \textbf{{[}Run Query{]}} button in the \emph{SQL Query} tab to execute
the command. If the query is successful a \emph{Database File Selection}
window will be displayed. If the query is not successful an error message will
appear in the \emph{Output Console} window.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evispredefined.png}
\caption{The \emph{eVis} Predefined queries tab \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
** Abrir Arquivo de Consulta {\color{red}\bfseries{}**}: Inicia o ``Abrir Arquivo'', buscador de arquivos para procurar o arquivo XML explorando as consultas pré-definidas.

\item {} 
** Consultas predefinidas {\color{red}\bfseries{}**}: Uma lista suspensa com todas as consultas definidas pelo arquivo consultas prédefinidas XML.

\item {} 
\textbf{Consulta descrição}: Uma breve descrição da consulta. Esta descrição é do arquivo consultas prédefinida XML.

\item {} 
\textbf{Janela Console}: A janela console onde as mensagens relacionadas ao processamento são exibidas.

\item {} 
\textbf{Ajuda}: Exibe a ajuda on line.

\item {} 
\textbf{OK}: Fecha a janela principal do ``Conexão com a Base de Dados''.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_evis:evis-xml-tags}

\subsubsection{Formato XML para consultas predefinidas eVis}
\label{docs/user_manual/plugins/plugins_evis:evis-xml-tags}\label{docs/user_manual/plugins/plugins_evis:evis-xml-format}\label{docs/user_manual/plugins/plugins_evis:xml-format-for-evis-predefined-queries}
As marcas XML lidas por eVis

\begin{tabulary}{\linewidth}{|L|L|}
\hline
\textsf{\relax 
Marcas
} & \textsf{\relax 
Descrição
}\\
\hline
Consulta
 & 
Define o início e o fim de uma instrução de consulta.
\\

Descrição Breve
 & 
Uma breve descrição da consulta que aparece no menu suspenso eVis.
\\

Descrição
 & 
Uma descrição mais detalhada da consulta exibida na janela de texto Consulta Predefinida.
\\

Tipo de Base de Dados
 & 
O tipo base de dados, conforme definido no menu suspenso Tipo de Base de Dados na guia Conexão Base de Dados.
\\

Porta da Base de Dados
 & 
A porta conforme definido na caixa de texto Porta na guia Conexão com a Base de Dados.
\\

Nome da Base de Dados
 & 
O nome da base de dados, conforme definido na caixa de texto Nome da Base de Dados na guia Conexão com a Base de Dados.
\\

Nome de Usuário da Base de Dados
 & 
O nome de usuário da base de dados, conforme definido na caixa de texto Nome de usuário na guia Conexão com a Base de Dados.
\\

Senha de Base de Dados
 & 
A senha da base de dados, conforme definido na caixa de texto Senha na guia Conexão com a Base de Dados.
\\

Instrução SQL
 & 
O comando SQL.
\\

autoconexão
 & 
A bandeira (``verdadeira'' ``ou'' falsa '') para especificar se as marcas acima devem ser usadas para conectar-se automaticamente à base de dados sem executar a rotina de conexão com a base de dados na guia Conexão com a Base de Dados.
\\
\hline\end{tabulary}


Um exemplo de arquivo XML completo com três consultas é exibido abaixo:

\begin{Verbatim}[commandchars=\\\{\}]
\textless{}?xml version="1.0"?\textgreater{}
\textless{}doc\textgreater{}
 \textless{}query\textgreater{}
   \textless{}shortdescription\textgreater{}Import all photograph points\textless{}/shortdescription\textgreater{}
   \textless{}description\textgreater{}This command will import all of the data in the SQLite database to QGIS
      \textless{}/description\textgreater{}
   \textless{}databasetype\textgreater{}SQLITE\textless{}/databasetype\textgreater{}
   \textless{}databasehost /\textgreater{}
   \textless{}databaseport /\textgreater{}
   \textless{}databasename\textgreater{}C:\PYGZbs{}textbackslash Workshop/textbackslash
eVis\PYGZbs{}\_Data\PYGZbs{}textbackslash PhotoPoints.db\textless{}/databasename\textgreater{}
   \textless{}databaseusername /\textgreater{}
   \textless{}databasepassword /\textgreater{}
   \textless{}sqlstatement\textgreater{}SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec\_id=Attributes.point\_ID\textless{}/sqlstatement\textgreater{}
   \textless{}autoconnect\textgreater{}false\textless{}/autoconnect\textgreater{}
 \textless{}/query\textgreater{}
  \textless{}query\textgreater{}
   \textless{}shortdescription\textgreater{}Import photograph points "looking across Valley"\textless{}/shortdescription\textgreater{}
   \textless{}description\textgreater{}This command will import only points that have photographs "looking across
      a valley" to QGIS\textless{}/description\textgreater{}
   \textless{}databasetype\textgreater{}SQLITE\textless{}/databasetype\textgreater{}
   \textless{}databasehost /\textgreater{}
   \textless{}databaseport /\textgreater{}
   \textless{}databasename\textgreater{}C:\PYGZbs{}Workshop\PYGZbs{}eVis\_Data\PYGZbs{}PhotoPoints.db\textless{}/databasename\textgreater{}
   \textless{}databaseusername /\textgreater{}
   \textless{}databasepassword /\textgreater{}
   \textless{}sqlstatement\textgreater{}SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec\_id=Attributes.point\_ID where COMMENTS='Looking across
      valley'\textless{}/sqlstatement\textgreater{}
   \textless{}autoconnect\textgreater{}false\textless{}/autoconnect\textgreater{}
 \textless{}/query\textgreater{}
 \textless{}query\textgreater{}
   \textless{}shortdescription\textgreater{}Import photograph points that mention "limestone"\textless{}/shortdescription\textgreater{}
   \textless{}description\textgreater{}This command will import only points that have photographs that mention
      "limestone" to QGIS\textless{}/description\textgreater{}
   \textless{}databasetype\textgreater{}SQLITE\textless{}/databasetype\textgreater{}
   \textless{}databasehost /\textgreater{}
   \textless{}databaseport /\textgreater{}
   \textless{}databasename\textgreater{}C:\PYGZbs{}Workshop\PYGZbs{}eVis\_Data\PYGZbs{}PhotoPoints.db\textless{}/databasename\textgreater{}
   \textless{}databaseusername /\textgreater{}
   \textless{}databasepassword /\textgreater{}
   \textless{}sqlstatement\textgreater{}SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec\_id=Attributes.point\_ID where COMMENTS like '\%limestone\%'
      \textless{}/sqlstatement\textgreater{}
   \textless{}autoconnect\textgreater{}false\textless{}/autoconnect\textgreater{}
 \textless{}/query\textgreater{}
\textless{}/doc\textgreater{}
\end{Verbatim}


\section{Complemento fTools}
\label{docs/user_manual/plugins/plugins_ftools:ftools-plugin}\label{docs/user_manual/plugins/plugins_ftools:ftools}\label{docs/user_manual/plugins/plugins_ftools::doc}
O objetivo do complemento python fTools é fornecer recursos para tarefas muito comuns baseadas em vetores de SIGs, sem a necessidade de softwares adicionais, bibliotecas, ou soluções complexas. Ele fornece um conjunto cada vez maior de funções de gerenciamento de dados espaciais e análises rápidas e funcionais.

fTools is now automatically installed and enabled in new versions of QGIS, and
as with all plugins, it can be disabled and enabled using the Plugin Manager
(See Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}). When enabled, the fTools plugin adds a
\emph{Vector} menu to QGIS, providing functions ranging from Analysis
and Research Tools to Geometry and Geoprocessing Tools, as well as several useful
Data Management Tools.
\phantomsection\label{docs/user_manual/plugins/plugins_ftools:ftools-function}
\index{Analysis tools}

\subsection{Analysis tools}
\label{docs/user_manual/plugins/plugins_ftools:analysis-tools}\label{docs/user_manual/plugins/plugins_ftools:index-0}\label{docs/user_manual/plugins/plugins_ftools:table-ftools-1}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Ícone}
} & \textsf{\relax 
\textbf{Ferramenta}
} & \textsf{\relax 
\textbf{Finalidade}
}\\
\hline
\includegraphics[width=1.5em]{matrix.png}
 & 
Matris de distância
 & 
Medir distâncias entre dois pontos de uma camada, os resultados saem como  a) matriz de distâncias quadrada, b) matriz de distância linear, ou c) Síntese de distâncias. Pode limitar distâncias com as características mais próximas de k.
\\

\includegraphics[width=1.5em]{sum_lines.png}
 & 
Soma de comprimento de linhas
 & 
Calcular a soma total dos comprimentos das linhas para cada polígono de uma camada vetorial do tipo polígono.
\\

\includegraphics[width=1.5em]{sum_points.png}
 & 
Pontos no polígono
 & 
Conta o número de pontos que existem em cada polígono de uma camada de entrada do tipo vetorial poligonal.
\\

\includegraphics[width=1.5em]{unique.png}
 & 
Lista valores únicos
 & 
Listar todos os valores exclusivos de um campo de uma camada vetorial de entrada
\\

\includegraphics[width=1.5em]{basic_statistics.png}
 & 
Estatísticas básicas
 & 
Calcular estatísticas básicas (média, std dev, N, soma, CV) em um campo de entrada.
\\

\includegraphics[width=1.5em]{neighbour.png}
 & 
Vizinho mais próximo
 & 
Calcular estatísticas com vizinho mais próximo para avaliar o nível de agrupamento em uma camada vetorial do tipo ponto
\\

\includegraphics[width=1.5em]{mean.png}
 & 
Coordenada(s) média(s)
 & 
Calcular o centro médio ponderado normal ou inteiro de uma camada vetorial, ou de várias feições com base em um campo exclusivo de identificação.
\\

\includegraphics[width=1.5em]{intersections.png}
 & 
Interseções de linhas
 & 
Localizar cruzamentos entre as linhas, e as feições de uma outra shapefile. Útil para localizar cruzamentos ou fluxo, ignora cruzamentos de linha com comprimento \textgreater{} 0.
\\
\hline\end{tabulary}


Table Ftools 1: Ferramentas de análise fTools

\index{Research tools}

\subsection{Research tools}
\label{docs/user_manual/plugins/plugins_ftools:index-1}\label{docs/user_manual/plugins/plugins_ftools:research-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Ícone}
} & \textsf{\relax 
\textbf{Ferramenta}
} & \textsf{\relax 
\textbf{Finalidade}
}\\
\hline
\includegraphics[width=1.5em]{random_selection.png}
 & 
Seleção aleatória
 & 
Selecionar aleatoriamente um número n de recursos, ou n percentual de recursos
\\

\includegraphics[width=1.5em]{sub_selection.png}
 & 
Seleção aleatória dentro de subconjuntos
 & 
Selecionar aleatoriamente feições dentro de subconjuntos com base em um campo exclusivo de identificação.
\\

\includegraphics[width=1.5em]{random_points.png}
 & 
Pontos aleatórios
 & 
Gerar pseudo-pontos aleatórios sobre uma camada de entrada.
\\

\includegraphics[width=1.5em]{regular_points.png}
 & 
Pontos regulares
 & 
Gerar uma grade regular de pontos ao longo de uma região determinada e exportá-los como um shapefile de pontos.
\\

\includegraphics[width=1.5em]{vector_grid.png}
 & 
Grade vetorial
 & 
Gerar uma grade do tipo linha ou polígono com base no espaçamento da grade especificado pelo usuário.
\\

\includegraphics[width=1.5em]{select_location.png}
 & 
Selecionar pela localização
 & 
Selecionar feições com base na sua localização em relação a uma outra camada, para formar uma nova seleção, adicionar ou subtrair da seleção atual.
\\

\includegraphics[width=1.5em]{layer_extent.png}
 & 
Polígono a partir da extensão da camada
 & 
Criar uma camada com um único polígono retangular a partir da extensão de uma camada de entrada raster ou vetorial.
\\
\hline\end{tabulary}


Tabela fTools 2: Ferramentas de Pesquisa fTools


\subsection{Geoprocessing tools}
\label{docs/user_manual/plugins/plugins_ftools:geoprocessing-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Ícone}
} & \textsf{\relax 
\textbf{Ferramenta}
} & \textsf{\relax 
\textbf{Finalidade}
}\\
\hline
\includegraphics[width=1.5em]{convex_hull.png}
 & 
Forma(s) convexa(s)
 & 
Criar o mínimo de forma(s) convexas em uma camada de entrada, ou com base em um campo de ID.
\\

\includegraphics[width=1.5em]{buffer.png}
 & 
Buffer(s)
 & 
Criar buffer(s) em torno de feições com base em distâncias, ou em um campo de distância.
\\

\includegraphics[width=1.5em]{intersect.png}
 & 
Interseção
 & 
Intersectar sobreposição de camadas de forma que a saída contém áreas onde ambas as camadas se cruzam.
\\

\includegraphics[width=1.5em]{union.png}
 & 
União
 & 
Sobreposição de camadas de forma que a saída contém a interseção e não-interseção de áreas.
\\

\includegraphics[width=1.5em]{sym_difference.png}
 & 
Diferença simétrica
 & 
Sobreposição de camadas de forma que a saída contém tanto as áreas que não se intersectam da entrada e das camadas de diferença.
\\

\includegraphics[width=1.5em]{clip.png}
 & 
Cortar
 & 
Sobreposição de camadas de forma que a saída contém áreas que se cruzam a camada de corte.
\\

\includegraphics[width=1.5em]{difference.png}
 & 
Diferença
 & 
Sobreposição de camadas de forma que a saída contém áreas que não cruzam a camada de corte.
\\

\includegraphics[width=1.5em]{dissolve.png}
 & 
Dissolver
 & 
Mesclar feições com base no campo de entrada. Todas as feições com valores idênticos de entrada são combinadas para formar uma única feição.
\\
\hline\end{tabulary}


Tabela fTools 3: Ferramentas de Geoprocessamento fTools


\subsection{Geometry tools}
\label{docs/user_manual/plugins/plugins_ftools:geometry-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Ícone}
} & \textsf{\relax 
\textbf{Ferramenta}
} & \textsf{\relax 
\textbf{Finalidade}
}\\
\hline
\includegraphics[width=1.5em]{check_geometry.png}
 & 
Verificar a validade de geometrias
 & 
Verifica as interseções de polígonos, fechando espaços e corrigindo nós.
\\

\includegraphics[width=1.5em]{export_geometry.png}
 & 
Exportar/Adicionar geometrias de colunas
 & 
Adicionar Informações de geometrias vetoriais em camadas do tipo ponto (xCoord, yCoord), linha (comprimento), ou polígono (área, perímetro).
\\

\includegraphics[width=1.5em]{centroids.png}
 & 
Centróides de polígonos
 & 
Calcular os centróides reais para cada polígono em uma camada de entrada do tipo polígono.
\\

\includegraphics[width=1.5em]{delaunay.png}
 & 
Triangulação de Delaunay
 & 
Calcular a triangulação de Delaunay de uma camada vetorial (como do tipo polígono) de entrada.
\\
 & 
Polígonos de Voronoi
 & 
Calcular polígonos de Voronoi de uma camada vetorial de entrada.
\\

\includegraphics[width=1.5em]{simplify.png}
 & 
Simplificar geometrias
 & 
Generalizar linhas ou polígonos com o algoritmo de Douglas-Peucker.
\\
 & 
Densify
geometry
 & 
Densify lines or polygons by adding
vertices
\\

\includegraphics[width=1.5em]{multi_to_single.png}
 & 
Densificar geometrias
 & 
Converter feições de várias partes para feições de partes individuais . Cria polígonos e linhas simples.
\\

\includegraphics[width=1.5em]{single_to_multi.png}
 & 
Multipartes para partes simples
 & 
Mesclar várias feições para uma única feição multipartes baseada em um campo exclusivo de identificação.
\\

\includegraphics[width=1.5em]{to_lines.png}
 & 
Polígonos para linhas
 & 
Converte polígonos para linhas, polígonos multipartes para várias linhas de partes únicas.
\\

\includegraphics[width=1.5em]{to_lines.png}
 & 
Linhas para polígonos
 & 
Converte linhas para polígonos, linhas multipartes para polígonos de partes simples.
\\

\includegraphics[width=1.5em]{extract_nodes.png}
 & 
Extração de nós
 & 
Extrair nós de camadas do tipo linhas e polígonos, de forma a resultar camadas de pontos.
\\
\hline\end{tabulary}


Tabela fTools 4: ferramentas de Geometrias fTools

\begin{notice}{note}{Nota:}
A ferramenta \emph{Simplificar geometria} pode ser usada para remover nós duplicados em linha e geometrias poligonais, basta definir o parâmetro \emph{tolerância de simplificação} como 0, isso vai fazer o truque.
\end{notice}


\subsection{Data management tools}
\label{docs/user_manual/plugins/plugins_ftools:table-ftools-5}\label{docs/user_manual/plugins/plugins_ftools:data-management-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Ícone}
} & \textsf{\relax 
\textbf{Ferramenta}
} & \textsf{\relax 
\textbf{Finalidade}
}\\
\hline
\includegraphics[width=1.5em]{define_projection.png}
 & 
Definir projeção
 & 
Especificar o SRC para o arquivo shape cujo SRC ​​não foi definido.
\\

\includegraphics[width=1.5em]{join_location.png}
 & 
Unir atributos por localização
 & 
Unir atributos adicionais a camada vetorial com base na relação espacial. Os atributos de uma camada vetorial são anexados à tabela de atributos de uma outra camada e exportados como um shapefile.
\\

\includegraphics[width=1.5em]{split_layer.png}
 & 
Dividir camada vetorial
 & 
Dividir uma camada de entrada em várias outras camadas distintas com base em um campo de entrada.
\\

\includegraphics[width=1.5em]{merge_shapes.png}
 & 
Merge shapefiles
to one
 & 
Merge several shapefiles within a
folder into a new shapefile based on
the layer type (point, line, area).
\\
 & 
Create spatial
index
 & 
Create a spatial index for OGR
supported formats.
\\
\hline\end{tabulary}


Tabela fTools 5: ferramentas de gerenciamento de dados fTools


\section{Ferramentas do complemento  GDAL}
\label{docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools}\label{docs/user_manual/plugins/plugins_gdaltools::doc}\label{docs/user_manual/plugins/plugins_gdaltools:gdal-tools-plugin}

\subsection{O que é o GDALTools?}
\label{docs/user_manual/plugins/plugins_gdaltools:what-is-gdaltools}\label{docs/user_manual/plugins/plugins_gdaltools:whatsgdal}
The GDAL Tools plugin offers a GUI to the collection of tools in the Geospatial
Data Abstraction Library, \href{http://gdal.osgeo.org}{http://gdal.osgeo.org} . These are raster management
tools to query, re-project, warp and merge a wide variety of raster formats. Also
included are tools to create a contour (vector) layer, or a shaded relief from
a raster DEM, and to make a vrt (Virtual Raster Tile in XML format) from a
collection of one or more raster files. These tools are available when the
plugin is installed and activated.


\subsubsection{A Biblioteca GDAL}
\label{docs/user_manual/plugins/plugins_gdaltools:the-gdal-library}
A biblioteca GDAL consiste em um conjunto de programas de linha de comando, cada uma com uma grande lista de opções. Usuários familiarisados ​​com a execução de comandos em um terminal podem preferir a linha de comando, tendo acesso ao conjunto completo de opções. O complemento GDALTools oferece uma interface intuitiva para as ferramentas, expondo apenas as opções mais populares.


\subsection{List of GDAL tools}
\label{docs/user_manual/plugins/plugins_gdaltools:list-of-gdal-tools}\phantomsection\label{docs/user_manual/plugins/plugins_gdaltools:figure-gdal-tools-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{raster_menu.png}
\caption{The \emph{GDALTools} menu list}\end{figure}


\subsubsection{Projections}
\label{docs/user_manual/plugins/plugins_gdaltools:projections}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{warp.png} \emph{Warp (Reproject)}
 & 
This utility is an image mosaicing, reprojection and
warping utility. The program can reproject to any
supported projection, and can also  apply GCPs stored
with the image if the image is ``raw'' with control
information. For more information you can read on
the GDAL website \href{http://www.gdal.org/gdalwarp.html}{http://www.gdal.org/gdalwarp.html}
\\

\includegraphics[width=1.5em]{projection-add.png} \emph{Assign projection}
 & 
This tool allows to assign projection to rasters that
already georeferenced but miss projection
information. Also with it help it is possible to
alter existing projection definition. Both single
file and batch mode are supported. For more
information please visit utility page at GDAL site
\href{http://www.gdal.org/gdalwarp.html}{http://www.gdal.org/gdalwarp.html}
\\

\includegraphics[width=1.5em]{projection-export.png}
\emph{Extract projection}
 & 
This utility helps you to extract projection
information from an input file. If you want to
extract projection from a whole directory you can use
the Batch mode. It creates both \code{.prj} and
\code{.wld} files.
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id1}

\subsubsection{Conversion}
\label{docs/user_manual/plugins/plugins_gdaltools:conversion}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{rasterize.png} \emph{Rasterize}
 & 
This program burns vector geometries (points, lines
and polygons) into the raster band(s) of a raster
image. Vectors are read from OGR supported vector
formats. Note that the vector data must in the same
coordinate system as the raster data; on the fly
reprojection is not provided. For more information see
\href{http://www.gdal.org/gdal\_rasterize.html}{http://www.gdal.org/gdal\_rasterize.html}
\\

\includegraphics[width=1.5em]{polygonize.png} \emph{Polygonize}
 & 
This utility creates vector polygons for all connected
regions of pixels in the raster sharing a common pixel
value. Each polygon is created with an attribute
indicating the pixel value of that polygon.  The
utility will create the output vector datasource if it
does not already exist, defaulting to ESRI shapefile
format. See also
\href{http://www.gdal.org/gdal\_polygonize.html}{http://www.gdal.org/gdal\_polygonize.html}
\\

\includegraphics[width=1.5em]{translate.png} \emph{Translate}
 & 
This utility can be used to convert raster data
between different formats, potentially performing some
operations like subsettings, resampling, and rescaling
pixels in the process. For more information you can
read on \href{http://www.gdal.org/gdal\_translate.html}{http://www.gdal.org/gdal\_translate.html}
\\

\includegraphics[width=1.5em]{raster-rgb.png} \emph{RGB to PCT}
 & 
This utility will compute an optimal pseudo-color
table for a given RGB image using a median cut
algorithm on a downsampled RGB histogram. Then it
converts the image into a pseudo-colored image using
the color table. This conversion utilizes
Floyd-Steinberg dithering (error diffusion) to
maximize output image visual quality. The utility is
also desribed at \href{http://www.gdal.org/rgb2pct.html}{http://www.gdal.org/rgb2pct.html}
\\

\includegraphics[width=1.5em]{raster-rgb.png} \emph{PCT to RGB}
 & 
This utility will convert a pseudocolor band on the
input file into an output RGB file of the desired
format. For more information see
\href{http://www.gdal.org/pct2rgb.html}{http://www.gdal.org/pct2rgb.html}
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id2}

\subsubsection{Extraction}
\label{docs/user_manual/plugins/plugins_gdaltools:extraction}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{contour.png} \emph{Contour}
 & 
This program generates a vector contour file from the
input raster elevation model (DEM).
On \href{http://www.gdal.org/gdal\_contour.html}{http://www.gdal.org/gdal\_contour.html} you can find
more information.
\\

\includegraphics[width=1.5em]{raster-clip.png} \emph{Clipper}
 & 
This utility allows to clip (extract subset) raster
using selected extent or based on mask layer bounds.
More information can be found at
\href{http://www.gdal.org/gdal\_translate.html}{http://www.gdal.org/gdal\_translate.html}.
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id3}

\subsubsection{Analysis}
\label{docs/user_manual/plugins/plugins_gdaltools:analysis}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{sieve.png} \emph{Sieve}
 & 
This utility removes raster polygons smaller than a
provided threshold size (in pixels) and replaces
them with the pixel value of the largest neighbor
polygon. The result can be written back to the
existing raster band, or copied into a new file. For
more information see
\href{http://www.gdal.org/gdal\_sieve.html}{http://www.gdal.org/gdal\_sieve.html} .
\\

\includegraphics[width=1.5em]{nearblack.png} \emph{Near Black}
 & 
This utility will scan an image and try to set all
pixels that are nearly black (or nearly white) around
the edge to exactly black (or white). This is often
used to ``fix up'' lossy compressed aerial photos so
that color pixels can be treated as transparent when
mosaicing. See also
\href{http://www.gdal.org/nearblack.html}{http://www.gdal.org/nearblack.html} .
\\

\includegraphics[width=1.5em]{fillnodata.png} \emph{Fill nodata}
 & 
This utility fills selection raster regions (usually
nodata areas) by interpolation from valid pixels
around the edges of the area. On
\href{http://www.gdal.org/gdal\_fillnodata.html}{http://www.gdal.org/gdal\_fillnodata.html} you can find
more information.
\\

\includegraphics[width=1.5em]{proximity.png}\emph{Proximity}
 & 
This utility generates a raster proximity map
indicating the distance from the center of each pixel
to the center of the nearest pixel identified as a
target pixel. Target pixels are those in the source
raster for which the raster pixel value is in the set
of target pixel values. For more information see
\href{http://www.gdal.org/gdal\_proximity.html}{http://www.gdal.org/gdal\_proximity.html} .
\\

\includegraphics[width=1.5em]{grid.png} \emph{Grid}
 & 
This utility creates regular grid (raster) from the
scattered data read from the OGR datasource. Input
data will be interpolated to fill grid nodes with
values, you can choose from various interpolation
methods. The utility is also described on the GDAL
website \href{http://www.gdal.org/gdal\_grid.html}{http://www.gdal.org/gdal\_grid.html} .
\\

\includegraphics[width=1.5em]{gdal_dem.png} \emph{DEM terrain models}
 & 
Tools to analyze and visualize DEMs. It can create a
shaded relief, a slope, an aspect, a color relief, a
Terrain Ruggedness Index, a Topographic Position Index
and a roughness map from any GDAL-supported elevation
raster. For more information you can read on
\href{http://www.gdal.org/gdaldem.html}{http://www.gdal.org/gdaldem.html}
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id4}

\subsubsection{Miscellaneous}
\label{docs/user_manual/plugins/plugins_gdaltools:miscellaneous}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{vrt.png} \emph{Build Virtual Raster}
 & 
This program builds a VRT (Virtual Dataset) that is a
mosaic of the list of input gdal datasets. See also
\href{http://www.gdal.org/gdalbuildvrt.html}{http://www.gdal.org/gdalbuildvrt.html} .
\\

\includegraphics[width=1.5em]{merge.png} \emph{Merge}
 & 
This utility will automatically mosaic a set of
images. All the images must be in the same coordinate
system and have a matching number of bands, but they
may be overlapping, and at different resolutions. In
areas of overlap, the last image will be copied over
earlier ones. The utility is also described on
\href{http://www.gdal.org/gdal\_merge.html}{http://www.gdal.org/gdal\_merge.html} .
\\

\includegraphics[width=1.5em]{raster-info.png} \emph{Information}
 & 
This utility lists various information about a
GDAL supported raster dataset.
On \href{http://www.gdal.org/gdalinfo.html}{http://www.gdal.org/gdalinfo.html} you can find
more information.
\\

\includegraphics[width=1.5em]{raster-overview.png} \emph{Build Overviews}
 & 
The gdaladdo utility can be used to build or rebuild
overview images for most supported file formats with
one of several downsampling algorithms. For more
information see \href{http://www.gdal.org/gdaladdo.html}{http://www.gdal.org/gdaladdo.html} .
\\

\includegraphics[width=1.5em]{tileindex.png} \emph{Tile Index}
 & 
This utility builds a shapefile with a record for
each input raster file, an attribute containing the
filename, and a polygon geometry outlining the raster.
See also \href{http://www.gdal.org/gdaltindex.html}{http://www.gdal.org/gdaltindex.html} .
\\
\hline\end{tabulary}



\section{Complemento Georreferenciador}
\label{docs/user_manual/plugins/plugins_georeferencer:georef}\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-plugin}\label{docs/user_manual/plugins/plugins_georeferencer::doc}
O complemento Georreferenciador permite georreferenciar imagens rasters para um sistema de coordenadas geográficas ou projetadas (métricas), através da criação de uma nova imagem GeoTiff ou através da adição de um arquivo world com extensão PRJ à imagem existente. A maneira básica para georreferenciar uma imagem raster consiste em localizar pontos no arquivo, cujas coordenadas possam ser determinadas com a maior acurácia possível.

\textbf{Recursos}

\index{Georeferencer tools}\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:table-georeferencer-1}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Ícone
} & \textsf{\relax 
Propósito
} & \textsf{\relax 
Ícone
} & \textsf{\relax 
Propósito
}\\
\hline &  &  & \\

\includegraphics[width=1.5em]{mActionAddRasterLayer.png}
 & 
Abrir Raster
 & 
\includegraphics[width=1.5em]{mActionStartGeoref.png}
 & 
Iniciar georreferenciamento
\\

\includegraphics[width=1.5em]{mActionGDALScript.png}
 & 
Gerar scrip GDAL
 & 
\includegraphics[width=1.5em]{mActionFileOpen.png}
 & 
Carregar pontos GCP
\\

\includegraphics[width=1.5em]{mActionFileSave.png}
 & 
Salvar pontos GCP como
 & 
\includegraphics[width=1em]{mActionOptions.png}
 & 
Configurações de transformação
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png}
 & 
Adicionar ponto
 & 
\includegraphics[width=1.5em]{mActionDeleteSelected.png}
 & 
Excluir ponto
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png}
 & 
Mover ponto GCP
 & 
\includegraphics[width=1.5em]{mActionPan.png}
 & 
Movimentar
\\

\includegraphics[width=1.5em]{mActionZoomIn.png}
 & 
Aproximar
 & 
\includegraphics[width=1.5em]{mActionZoomOut.png}
 & 
Afastar
\\

\includegraphics[width=1.5em]{mActionZoomToLayer.png}
 & 
Ver a camada
 & 
\includegraphics[width=1.5em]{mActionZoomLast.png}
 & 
Última visualização
\\

\includegraphics[width=1.5em]{mActionZoomNext.png}
 & 
Próxima visualização
 & 
\includegraphics[width=2.5em]{mActionLinkGeorefToQGis.png}
 & 
Conectar georreferenciador ao QGIS
\\

\includegraphics[width=2.5em]{mActionLinkQGisToGeoref.png}
 & 
Conectar QGIS ao Georreferenciador
 &  & \\
\hline\end{tabulary}


Tabela Georreferenciador 1: Ferramentas do georreferenciador.


\subsection{Procedimento comum}
\label{docs/user_manual/plugins/plugins_georeferencer:usual-procedure}
Para inserir as coordenadas – Lat/Long (geográficas) ou X e Y (cartesianas) em pontos selecionados, para realizar o georreferenciamento da imagem, dois procedimentos podem ser aplicados:
\begin{itemize}
\item {} 
A própria imagem raster pode algumas vezes fornecer/apresentar interseções entre meridianos e paralelos da grade, com coordenadas expressas na imagem. Neste caso, pode-se inserir “manualmente” as coordenadas.

\item {} 
Utilizar camadas já georreferenciados – podendo ser arquivos vetoriais ou raster – que contenham os mesmos objetos/feições existentes na imagem que deverá ser georreferenciada. Por exemplo, podemos utilizar as coordenadas de cruzamentos de vias e também vértices de polígonos, como de edificações ou lotes urbanos utilizando-os como pontos (coordenadas) adequados.

\end{itemize}

O procedimento habitual para o georreferenciamento de uma imagem consiste em selecionar múltiplos pontos no raster, especificar suas coordenadas e escolher o tipo de transformação mais apropriado para o arquivo. Baseado nos dados e parâmetros de entrada, o complemento irá computar os parâmetros do arquivo world ou então criar um novo GeoTIFF. Quanto mais pontos de controle (coordenadas) forem informados, melhor será o resultado do processo.

O primeiro passo é iniciar o QGIS, carregar o Complemento Georreferenciador (ver Seção {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}) e clicar no ícone \includegraphics[width=1.5em]{georeferencer.png} $^{\text{Georreferenciador}}$ icon which appears in the QGIS toolbar menu. A caixa de diálogo Complemento Georreferenciador aparece como mostra a {\hyperref[docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-1]{figure\_georeferencer\_1}}.

For this example, we are using a topo sheet of South Dakota from SDGS. It can
later be visualized together with the data from the GRASS \code{spearfish60}
location. You can download the topo sheet here:
\href{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}.
\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{georefplugin.png}
\caption{Georeferencer Plugin Dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Entrando com pontos de controle GCPs (Ground Control Points)}
\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-entering}\label{docs/user_manual/plugins/plugins_georeferencer:entering-ground-control-points-gcps}\begin{enumerate}
\item {} 
To start georeferencing an unreferenced raster, we must load it using the
\includegraphics[width=1.5em]{mActionAddRasterLayer.png} button. The raster will show up in the main working
area of the dialog. Once the raster is loaded, we can start to enter reference
points.

\item {} 
Using the \includegraphics[width=1.5em]{mActionCapturePoint.png} $^{\text{Add Point}}$ button, add points to the
main working area and enter their coordinates (see Figure {\hyperref[docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-2]{figure\_georeferencer\_2}}).
For this procedure you have three options:
\begin{itemize}
\item {} 
Clique em determinado ponto da imagem raster e entre com suas coordenadas X e Y manualmente.

\item {} 
Clique em um determinado ponto da imagem raster e escolha o botão \includegraphics[width=1.5em]{pencil.png} $^{\text{from map canvas}}$ para adicionar as coordenadas a partir de uma camada já georreferenciada, previamente carregada na tela do QGIS.

\item {} 
Com o botão \includegraphics[width=1.5em]{mActionMoveFeature.png} é possível mover os pontos GCP em ambas as janelas, caso algum deles esteja no lugar errado.

\end{itemize}

\item {} 
Continue inserindo os pontos de controle. São necessários no mínimo 4 pontos (espalhados pelas 4 pontas da imagem), e quanto mais pontos (coordenadas) forem adicionados, melhor será o resultado obtido. Existem ferramentas adicionais na caixa de diálogo do complemento para usar o zoom e pan na tela a fim de que seja possível localizar um conjunto de possíveis GCPs.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{choose_points.png}
\caption{Add points to the raster image \includegraphics[width=1em]{nix.png}}\end{figure}

The points that are added to the map will be stored in a separate text file
(\code{{[}filename{]}.points}) usually together with the raster image. This allows
us to reopen the Georeferencer plugin at a later date and add new points or delete
existing ones to optimize the result. The points file contains values of the
form: \code{mapX, mapY, pixelX, pixelY}. You can use the \includegraphics[width=1.5em]{mActionFileOpen.png}
$^{\text{Load GCP Points}}$ and \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Save GCP Points}}$ buttons to
manage the files.

Within the GCP table you can click on a column header and therewith enable
e.g. numerical sorting. The GCP list is automatically updated.


\subsubsection{Definindo as configurações de transformação}
\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-transformation}\label{docs/user_manual/plugins/plugins_georeferencer:defining-the-transformation-settings}
Depois que os pontos GCP estão devidamente adicionados à imagem raster, é necessário definir as configurações de transformação para o processo de georreferenciamento.
\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{transformation_settings.png}
\caption{Defining the georeferencer transformation settings \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Algoritmos de transformação disponíveis}
\label{docs/user_manual/plugins/plugins_georeferencer:available-transformation-algorithms}
Dependendo da quantidade de pontos de controle capturados, será possível a utilização de diferentes algoritmos de transformação. A escolha de um desses algoritmos também depende do tipo e da qualidade dos dados de entrada inseridos e a quantidade de distorção geométrica que se está disposto a introduzir no resultado final.

Atualmente, os seguintes algoritmos estão disponíveis:
\begin{itemize}
\item {} 
O algoritmo \textbf{Linear} é utilizado para criar um arquivo world, sendo diferentes dos demais uma vez que não transforma o raster verdadeiramente. Este algoritmo provavelmente não será suficiente para aqueles que estão trabalhando com imagens digitalizadas.

\item {} 
A transformação \textbf{Helmert} realiza transformações simples de escala e rotação.

\item {} 
Os algoritmos \textbf{Polinomiais} 1-3 estão entre os algoritmos mais amplamente aplicados para georreferenciamento, cada um diferindo no grau de distorção introduzido para combinar os pontos de controle da fonte e do destino. Destes, o mais utilizado é o algoritmo de transformação polinomial de segunda ordem, que permite alguma curvatura. A transformação polinomial de primeira ordem (affine – afim) preserva a colinearidade e permite apenas escala, translação e rotação.

\item {} 
O algoritmo \textbf{Suavizador em Lâminas Finas (Thin Plate Spline – TPS)} é um método moderno de georreferenciamento, que é capaz de introduzir deformações locais na imagem. Este algoritmo é útil quando se está georreferenciado arquivos originais de qualidade muito baixa.

\item {} 
A transformação \textbf{Projetiva} consiste na rotação linear e na translação de coordenadas.

\end{itemize}


\subsubsection{Definindo o método de reamostragem}
\label{docs/user_manual/plugins/plugins_georeferencer:define-the-resampling-method}
The type of resampling you choose will likely depending on your input data
and the ultimate objective of the exercise. If you don't want to change
statistics of the image, you might want to choose `Nearest neighbour', whereas a
`Cubic resampling' will likely provide a more smoothed result.

No QGIS, é possível escolher entre 5 diferentes métodos de reamostragem:
\begin{enumerate}
\item {} 
Vizinho mais próximo

\item {} 
Linear

\item {} 
Cúbico

\item {} 
Cúbico suavizado

\item {} 
Lanczos

\end{enumerate}


\subsubsection{Definindo as configurações de transformação}
\label{docs/user_manual/plugins/plugins_georeferencer:define-the-transformation-settings}
Existem várias opções que devem ser definidas para o arquivo raster (georreferenciado) de saída.
\begin{itemize}
\item {} 
The checkbox \includegraphics{checkbox.png} \emph{Create world file} is only available, if you
decide to use the linear transformation type, because this means that the
raster image actually won't be transformed. In this case, the field
\emph{Output raster} is not activated, because only a new world-file will
be created.

\item {} 
For all other transformation type you have to define an \emph{Output
raster}. As default a new file ({[}filename{]}\_modified) will be created in the
same folder together with the original raster image.

\item {} 
As a next step you have to define the \emph{Target SRS} (Spatial Reference
System) for the georeferenced raster (see section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Trabalhando com Projeções}}}).

\item {} 
Também é possível \textbf{gerar um mapa em pdf} e também um \textbf{Relatório pdf}. O relatório inclui informações sobre os parâmetros de transformação utilizados, além de uma imagem dos resíduos e uma lista com todos os GCPs e seus erros RMS.

\item {} 
Além disso, é possível ativar a caixa de diálogo \includegraphics{checkbox.png} \emph{Acertar a definição de saída} e definir a resolução dos pixels do raster de saída. Como padrão, as resoluções horizontal e vertical são iguais a 1.

\item {} 
A caixa \includegraphics{checkbox.png} \emph{Use 0 para transparência quando necessário} pode ser ativada, caso os pixels com valor 0 devam ser visualizados como transparentes.

\item {} 
Finalmente, marcando \includegraphics{checkbox.png} \emph{Carregar no QGIS quando concluído}, o raster de saída será automaticamente carregado na tela do QGIS depois que a transformação for concluída.

\end{itemize}


\subsubsection{Mostrando e adaptando as propriedades do raster}
\label{docs/user_manual/plugins/plugins_georeferencer:show-and-adapt-raster-properties}
Clicando no menu  \emph{Propriedades do raster} dialog in the \emph{Settings} abrirá a caixa de diálogo com as propriedades do raster que será georreferenciado.


\subsubsection{Configurando o georreferenciador}
\label{docs/user_manual/plugins/plugins_georeferencer:configure-the-georeferencer}\begin{itemize}
\item {} 
É possível definir a visualização ou não das coordenadas GCPs e/ou IDs.

\item {} 
Podem ser definidas como unidades residuais pixels e unidades do mapa.

\item {} 
Para o relatório PDF podem ser definidas as margens direita e esquerda e também o tamanho do papel para o mapa PDF.

\item {} 
Por último, também pode-se ativar a caixa \includegraphics{checkbox.png} \emph{Mostrar a janela do Georreferenciador ancorada}

\end{itemize}


\subsubsection{Iniciando a transformação}
\label{docs/user_manual/plugins/plugins_georeferencer:running-the-transformation}\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-running}
After all GCPs have been collected and all transformation settings are defined,
just press the button \includegraphics[width=1.5em]{mActionStartGeoref.png} $^{\text{Start georeferencing}}$ to create
the new georeferenced raster.


\section{Complemento de Interpolação}
\label{docs/user_manual/plugins/plugins_interpolation::doc}\label{docs/user_manual/plugins/plugins_interpolation:interpolation-plugin}\label{docs/user_manual/plugins/plugins_interpolation:interpol}
O Complemento de Interpolação pode ser utilizado para gerar uma interpolação TIN ou IDW de uma camada de vetores de pontos. É muito simples de lidar e fornece uma interface gráfica de usuário intuitiva para criar camadas raster interpoladas. (See {\hyperref[docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1]{Figure\_interpolation\_1}}). O complemento requer a especificação dos seguintes parâmetros antes de ser executado:
\begin{itemize}
\item {} 
\textbf{Input vector layer}: Specify the input point vector layer(s) from a list of
loaded point layers. If several layers are specified, then data from all layers
is used for interpolation. Note: It is possible to insert lines or polygons as
constraints for the triangulation, by specifying either ``points'', ``structure
lines'' or ``break lines'' in the \emph{Type} \includegraphics{selectstring.png} combobox.

\item {} 
\textbf{Atributos da interpolação}: Selecione uma coluna de atributo para ser usada na interpolação ou habilite a opção \includegraphics{checkbox.png} \emph{Usar Coordenada-Z} para usar os valores de Z armazenados nas camadas.

\item {} 
\textbf{Interpolation Method}: Select interpolation method. This can be either
`Triangulated Irregular Network (TIN)' or `Inverse Distance Weighted (IDW)'.

\item {} 
\textbf{Número de colunas/linhas}: Define o número de linhas e colunas do arquivo raster de saida.

\item {} 
\textbf{Arquivo de Saída}: Define o nome do arquivo raster de saída.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{interpolate_dialog.png}
\caption{Interpolation Plugin \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Using the plugin}
\label{docs/user_manual/plugins/plugins_interpolation:using-the-plugin}\label{docs/user_manual/plugins/plugins_interpolation:interpolation-usage}\begin{enumerate}
\item {} 
Inicie o QGIS e carregue uma camada de vetor de pontos (p. ex., \code{elevp.csv}).

\item {} 
Load the Interpolation plugin in the Plugin Manager (see Section
{\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}) and click on the \includegraphics[width=1.5em]{raster-interpolate.png} $^{\text{Interpolation}}$
icon which appears in the QGIS toolbar menu. The Interpolation plugin dialog
appears as shown in {\hyperref[docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1]{Figure\_interpolation\_1}}.

\item {} 
Selecione uma camada de entrada (p. ex., \emph{elevp' \textbar{}selectstring\textbar{}) e a coluna (p. ex., {}`{}`ELEV{}`}) para interpolação.

\item {} 
Select an interpolation method (e.g. `Triangulated Irregular Network (TIN)'),
and specify a cellsize of 5000 as well as the raster output filename (e.g.,
\code{elevation\_tin}).

\item {} 
Clique \textbf{{[}OK{]}}.

\item {} 
For the current example, double click \code{elevation\_tin} in the layer list
to open the raster \emph{Layer Properties} dialog and select `Pseudocolor'
as \emph{Color Map} \includegraphics{selectstring.png} in the \emph{Symbology} tab. Or
you can define a new color table as described in section {\hyperref[docs/user_manual/working_with_raster/index:working-with-raster]{\emph{Trabalhando com dados Raster}}}.

\end{enumerate}

\index{Mapserver\_Export\_Plugin}

\section{Complemento de exportação do MapServer}
\label{docs/user_manual/plugins/plugins_mapserver_export:mapserver-export-plugin}\label{docs/user_manual/plugins/plugins_mapserver_export:index-0}\label{docs/user_manual/plugins/plugins_mapserver_export::doc}\label{docs/user_manual/plugins/plugins_mapserver_export:mapserver-export}
Você pode usar o QGIS para `compor' o seu mapa, adicionando e organizando camadas, simbolizando-as, personalizando as cores e, em seguida, criar um arquivo de mapa para o MapServer.

\begin{notice}{note}{Nota:}
Currently the plugin only works when you use `Old Symbology' in QGIS. `New
Symbology' is not yet supported.
\end{notice}


\subsection{Criando o arquivo de projeto}
\label{docs/user_manual/plugins/plugins_mapserver_export:creating-the-project-file}
O complemento de exportação do MapServer opera em um arquivo de projeto salvo no QGIS e ** não ** sobre o conteúdo atual da tela do mapa e da legenda. Isto tem confundido um grande número de utilizadores. Conforme descrito abaixo, antes de você começar a usar o complemento de exportação do MapServer, você precisa organizar as camadas raster e vetoriais que deseja usar no MapServer e salvar esse status em um arquivo de projeto do QGIS.
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{mapserver_export_qgis.png}
\caption{Arrange raster and vector layers for QGIS project file \includegraphics[width=1em]{nix.png}}\end{figure}

Neste exemplo, demonstramos os quatro passos necessários para criar um arquivo de projeto simples, que pode ser utilizado para criar o arquivo de mapa MapServer. Usamos arquivos raster e arquivos vetoriais a partir do conjunto de dados amostrais QGIS: ref: \emph{label\_sampledata}.
\begin{enumerate}
\item {} 
Adicionar a camada raster: file:\emph{landcover.tif} clicando no ícone \emph{Adicionar Camada Raster} \textbar{} mActionAddRasterLayer {\color{red}\bfseries{}\textbar{}}: sup:.

\item {} 
Adicione os  arquivos vetoriais: file: \emph{lakes.shp},: file: \emph{majrivers.shp} e: file: \emph{airports.shp} a partir do conjunto de dados amostrais QGIS clicando no ícone \emph{Adicionar Camada Vetorial} \textbar{} mActionAddNonDbLayer {\color{red}\bfseries{}\textbar{}}: sup:.

\item {} 
Change the colors and symbolize the data as you like (for example see
{\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-1]{figure\_mapserver\_export\_1}})

\item {} 
Save a new project named \code{mapserverproject.qgs} using
\emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSave.png} \emph{Save Project}.

\end{enumerate}

\index{msexport}

\subsection{Criando o arquivo de mapa}
\label{docs/user_manual/plugins/plugins_mapserver_export:creating-the-map-file}\label{docs/user_manual/plugins/plugins_mapserver_export:index-1}
Para usar o complemento de exportação a partir do QGIS Mapserver, você precisa habilitar primeiro o complemento de exportação do MapServer usando o Gerenciador de complementos (veja: ref: \emph{load\_core\_plugin}).
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{mapserver_export_dialog.png}
\caption{Export to MapServer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\begin{tabulary}{\linewidth}{|L|L|}
\hline

Arquivo de Mapa
 & 
Digite o nome para o arquivo de mapa que esta sendo criado. Você pode usar o botão à direita para navegar até o diretório onde você deseja que o arquivo do mapa seja criado.
\\

Arquivo de projeto Qgis
 & 
Digite o caminho completo para o arquivo de projeto QGIS (. QGS) que deseja exportar. Você pode usar o botão à direita para procurar o arquivo de projeto QGIS.
\\

Nome do mapa
 & 
Um nome para o mapa. Este nome é prefixado para todas as imagens geradas pelo MapServer.
\\

Largura do mapa
 & 
Largura da imagem de saída em pixels.
\\

Altura do mapa
 & 
Altura da imagem de saída em pixels.
\\

Unidades do Mapa
 & 
Unidades de medida utilizadas para a saída.
\\

Tipo de Imagem
 & 
Formato para a imagem de saída gerada pelo MapServer
\\

Modelo da Web
 & 
Caminho completo para o arquivo de modelo MapServer para ser usado com o arquivo de mapa
\\

Cabeçalho da web
 & 
Caminho completo para o arquivo de cabeçalho do MapServer para ser usado com o arquivo de mapa
\\

Rodapé da web
 & 
Caminho completo para o arquivo de rodapé do MapServer para ser usado com o arquivo de mapa
\\
\hline\end{tabulary}


Apenas as entradas: guilabel: \emph{arquivo de mapa} e: guilabel: \emph{arquivo de projeto QGIS} são necessárias para criar um arquivo de mapa, no entanto, omitindo os outros parâmetros, você pode acabar criando um arquivo de mapa não-funcional, dependendo da sua intenção de uso. Embora o QGIS seja bom em criar um  mapa do seu arquivo de projeto, pode exigir alguns ajustes para obter os resultados desejados. Para este exemplo, vamos criar um arquivo de mapa usando o arquivo de projeto: file: \emph{mapserverproject.qgs} que acabamos de criar (ver {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2]{Figure\_mapserver\_export\_2}}):
\begin{enumerate}
\item {} 
Clique no ícone \emph{Exportador do MapServer} \textbar{} mapserver\_export {\color{red}\bfseries{}\textbar{}}: sup: no menu da barra de ferramentas para iniciar o diálogo MapServer (ver {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2]{Figure\_mapserver\_export\_2}}).

\item {} 
Digite um nome para o seu novo arquivo de mapa (por exemplo: file: \emph{qgisproject.map}).

\item {} 
Procure e localize o arquivo de projeto QGIS que você salvou anteriormente (ex.: file: \emph{mapserverproject.qgs}).

\item {} 
Digite um nome para o mapa (por exemplo, {}`{}` MyMap {\color{red}\bfseries{}{}`{}`}).

\item {} 
Digite a largura e a altura para a sua imagem de saída (por exemplo, \code{600} para a largura e \code{400} para a altura).

\item {} 
Para este exemplo, as camadas são em metros, portanto, mudar as unidades para metros.

\item {} 
Escolha: guilabel: `png' para o tipo de imagem.

\item {} 
Clique ** {[}OK{]} ** para gerar o novo arquivo do mapa: file: \emph{qgisproject.map}. QGIS mostra o sucesso de seus esforços.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{mapserver_export_success.png}
\caption{Export to MapServer Succesfull Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Você pode visualizar o arquivo de mapa em qualquer visualizador ou editor de texto. Se você der uma olhada, você vai notar que a ferramenta de exportação agrega os metadados necessários para habilitar o nosso arquivo de mapa para WMS.

\index{shp2img}\index{FWTools}

\subsection{Solução de problemas}
\label{docs/user_manual/plugins/plugins_mapserver_export:troubleshooting}\label{docs/user_manual/plugins/plugins_mapserver_export:index-2}
If you get error messages from mapserver like:

\begin{Verbatim}[commandchars=\\\{\}]
loadSymbolSet(): Unable to access file. (./symbols/symbols.txt)
\end{Verbatim}

or:

\begin{Verbatim}[commandchars=\\\{\}]
msLoadFontset(): Unable to access file. Error opening fontset ./fonts/fonts.txt.
\end{Verbatim}

Isso significa que o arquivo de mapa está solicitando como fontes ou arquivos de símbolo que o Mapserver não consegue encontrar.

Either comment the lines containing those names in the map file (this is possible
if you do not have labels or use styles from the \code{symbols.txt}). Or create
those files (see below).

The most simple \code{fonts.txt} file (because arial is used in the QGIS generated
map files) contains the following line

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{} either relative to the map file or a full path:}
\PYG{n}{arial} \PYG{o}{/}\PYG{n}{usr}\PYG{o}{/}\PYG{n}{share}\PYG{o}{/}\PYG{n}{fonts}\PYG{o}{/}\PYG{n}{truetype}\PYG{o}{/}\PYG{n}{msttcorefonts}\PYG{o}{/}\PYG{n}{arial}\PYG{o}{.}\PYG{n}{ttf}
\end{Verbatim}

The most simple \code{symbols.txt} file contains the definition of a circle
symbol (because a circle symbol is used for point layers)

\begin{Verbatim}[commandchars=\\\{\}]
SYMBOLSET
    SYMBOL
    NAME "circle"
    TYPE ellipse
    FILLED true
    POINTS
    1 1
    END
    END
END
\end{Verbatim}


\subsection{Testando o arquivo de mapa}
\label{docs/user_manual/plugins/plugins_mapserver_export:testing-the-map-file}
Agora podemos testar o nosso trabalho.

Se o arquivo do mapa é acessível para o seu mapserver cgi você pode usar um dos urls do diálogo de sucesso.

Outra opção é usar a ferramenta \textbf{shp2img}  para criar uma imagem a partir do arquivo do mapa. O {\color{red}\bfseries{}**}shp2img ** utilitário é parte do MapServer e FWTools. Para criar uma imagem do nosso mapa:
\begin{itemize}
\item {} 
Abra uma janela de terminal

\item {} 
Se você não salvou o arquivo de mapa em seu diretório principal, mude para a pasta onde você salvou.

\item {} 
Executar {}`{}` shp2img-m qgisproject.map-o MapServer \_test.png {}`{}` e exibir a imagem

\end{itemize}

This creates a PNG with all the layers included in the QGIS project file. In
addition, the extent of the PNG will be the same as when we saved the project.
As you can see in {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-4]{figure\_mapserver\_export\_4}}, all information except the airport
symbols are included.
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{mapserver_export_test.png}
\caption{Test PNG created by shp2img with all MapServer Export layers \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Usando o arquivo do mapa}
\label{docs/user_manual/plugins/plugins_mapserver_export:using-map-file}
If you plan to use the map file to serve WMS requests, you probably don't have
to tweak anything. If you plan to use it with a mapping template or a custom
interface, you may have a bit of manual work to do. To see how easy it is to go
from QGIS to serving maps on the web, take a look at Christopher Schmidt's 5
minute \href{http://openlayers.org/presentations/mappingyourdata/}{flash video}. He
used an older version of QGIS (version 0.8), but the demo applies equally well
to newer versions.


\section{Complemento Edição Offline}
\label{docs/user_manual/plugins/plugins_offline_editing:offline-editing-plugin}\label{docs/user_manual/plugins/plugins_offline_editing::doc}\label{docs/user_manual/plugins/plugins_offline_editing:offlinedit}
Para a coleta de dados, que é uma situação comum de trabalhar com um laptop ou um telefone celular offline em campo. Ao retornar para a rede, as mudanças precisam ser sincronizados com a fonte de dados mestre, por exemplo, um banco de dados PostGIS. Se várias pessoas estão trabalhando simultaneamente nos mesmos conjuntos de dados, é difícil de fundir as edições manualmente, mesmo que as pessoas não mudem as mesmas feições.

The \includegraphics[width=1.5em]{offline_editing_copy.png}$^{\text{Offline Editing}}$ Plugin automates the
synchronisation by copying the content of a datasource (usually PostGIS or
WFS-T) to a SpatiaLite database and storing the offline edits to dedicated
tables. After being connected to the network again, it is possible to apply the
offline edits to the master dataset.


\subsection{Using the plugin}
\label{docs/user_manual/plugins/plugins_offline_editing:using-the-plugin}\begin{itemize}
\item {} 
Abra algumas camadas de vetor, por exemplo de um PostGIS ou WFS-T datasource

\item {} 
Salve elas em um projeto

\item {} 
Press the \includegraphics[width=1.5em]{offline_editing_copy.png}$^{\text{Convert to offline project}}$ icon and
select the layers to save. The content of the layers is saved to SpatiaLite
tables.

\item {} 
Editar as camadas offline.

\item {} 
After being connected again, upload the changes with the \includegraphics[width=1.5em]{offline_editing_sync.png}
$^{\text{Synchronize}}$ button.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_offline_editing:figure-offline-editing-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{create_offline_project.png}
\caption{Create an offline project from PostGIS or WFS layers}\end{figure}


\section{Complemento Oracle GeoRaster}
\label{docs/user_manual/plugins/plugins_oracle_raster:oracle-georaster-plugin}\label{docs/user_manual/plugins/plugins_oracle_raster::doc}\label{docs/user_manual/plugins/plugins_oracle_raster:oracle-raster}
In Oracle databases, raster data can be stored in SDO\_GEORASTER objects available
with the Oracle Spatial extension. In QGIS, the \includegraphics[width=1.5em]{oracle_raster.png}
$^{\text{OracleGeoRasterPlugin}}$ is supported by GDAL, and depends on Oracle's
database product being installed and working on your machine. While Oracle is
proprietary software, they provide their software free for development and testing
purposes. Here is one simple example of how to load raster images to GeoRaster:

\begin{Verbatim}[commandchars=\\\{\}]
\$ gdal\_translate -of georaster input\_file.tif geor:scott/tiger@orcl
\end{Verbatim}

This will load the raster into the default GDAL\_IMPORT table, as a column named
\code{RASTER}.


\subsection{Gerenciando conexões}
\label{docs/user_manual/plugins/plugins_oracle_raster:managing-connections}
Firstly, the Oracle GeoRaster Plugin must be enabled using the Plugin Manager
(see Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}). The first time you load a GeoRaster in
QGIS, you must create a connection to the Oracle database that contains the data.
To do this, begin by clicking on the \includegraphics[width=1.5em]{oracle_raster.png} $^{\text{Select GeoRaster}}$
toolbar button, it will open the \emph{Select Oracle Spatial GeoRaster}
dialog window. Click on \textbf{{[}New{]}} to open the dialog window, and specify
the connection parameters (See {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-1]{Figure\_oracle\_raster\_1}}):
\begin{itemize}
\item {} 
\textbf{Name}: Enter a name for the database connection

\item {} 
\textbf{Database instance}: Enter the name of the database that you will connect to

\item {} 
\textbf{Username}: Specify your own username that you will use to access the database

\item {} 
\textbf{Password}: The password associated with your username that is required to
access the database

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{oracle_create_dialog.png}
\caption{Create Oracle connection dialog}\end{figure}

Now, back on the main \emph{Oracle Spatial GeoRaster} dialog window
(see {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-2]{Figure\_oracle\_raster\_2}}), use the drop-down list to choose one connection,
and use the \textbf{{[}Connect{]}} button to establish a connection. You may also
\textbf{{[}Edit{]}} the connection by opening the previous dialog and making changes to
the connection information, or use the \textbf{{[}Delete{]}} button to remove the
connection from the drop-down list.


\subsection{Selecionando um GeoRaster}
\label{docs/user_manual/plugins/plugins_oracle_raster:selecting-a-georaster}
Uma vez a conexão estabelecida, a janela de subconjunto de dados mostra os nomes de todas as tabelas que contêm colunas GeoRaster naquele banco de dados no formato de um nome de subconjunto de dados GDAL.

Clique em um dos subconjuntos de dados listados e em seguida clique em \textbf{{[}Selecione{]}} para escolher um nome de tabela. Agora outra lista de subconjunto de dados vai ser mostrada com os nomes de colunas GeoRaster naquela tabela. É geralmente uma lista pequena, já que a maioria dos usuários não terá mais do que uma ou duas colunas GeoRaster na mesma tabela.

Clique em um dos subconjuntos de dados e aí clique em \textbf{{[}Selecione{]}} para escolher uma das combinações da tabela/coluna. A janela não mostrará todas as linhas que contêm objetos GeoRaster. Note que a lista de subconjunto de dados não mostrará a Tabela de Dados Raster e pares de Raster Id's.

A qualquer momento a entrada de Seleção pode ser editada a fim de ir diretamente a um GeoRaster conhecido ou voltar ao início e selecionar outro nome de tabela.
\phantomsection\label{docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{oracle_select_dialog.png}
\caption{Select Oracle GeoRaster dialog}\end{figure}

A entrada dos dados de Seleção pode ser também utilizada para introduzir uma cláusula onde no fim da série de identificação, e.g. \code{geor:scott/tiger@orcl,gdal\_import,raster,geoid=}. Ver \href{http://www.gdal.org/frmt\_georaster.html}{http://www.gdal.org/frmt\_georaster.html} para mais informações.


\subsection{Mostrando GeoRaster}
\label{docs/user_manual/plugins/plugins_oracle_raster:displaying-georaster}
Finalmente, selecionando um GeoRaster da lista de Tabela de Dados Raster e Raster Id's, a imagem raster vai carregar no QGIS.

The \emph{Select Oracle Spatial GeoRaster} dialog can be closed now and next
time it opens it will keep the same connection, and will show the same previous
list of subdataset making it very easy to open up another image from the same
context.

\begin{notice}{note}{Nota:}
GeoRasters que contêm pirâmides serão exibidos mais rapidamente, mas as pirâmides precisam ser geradas fora do uso de QGIS usando Oracle PL/SQL ou gdaladdo.
\end{notice}

The following is example using \code{gdaladdo}:

\begin{Verbatim}[commandchars=\\\{\}]
gdaladdo georaster:scott/tiger@orcl,georaster\PYGZbs{}\_table,georaster,georid=6 \PYGZbs{}
-r nearest 2 4 6 8 16 32
\end{Verbatim}

This is an example using PL/SQL:

\begin{Verbatim}[commandchars=\\\{\}]
\$ sqlplus scott/tiger
SQL\textgreater{} DECLARE
 gr sdo\_georaster;
BEGIN
    SELECT image INTO gr FROM cities WHERE id = 1 FOR UPDATE;
    sdo\_geor.generatePyramid(gr, 'rLevel=5, resampling=NN');
    UPDATE cities SET image = gr WHERE id = 1;
    COMMIT;
END;
\end{Verbatim}


\section{Raster Terrain Analysis Plugin}
\label{docs/user_manual/plugins/plugins_raster_terrain:raster-terrain-analysis-plugin}\label{docs/user_manual/plugins/plugins_raster_terrain:rasterrain}\label{docs/user_manual/plugins/plugins_raster_terrain::doc}
\includegraphics[width=1.5em]{dem.png} The Raster Terrain Analysis Plugin can be used to calculate the
slope, aspect, hillshade, ruggedness index and relief for digital elevation
models (DEM). It is very simple to handle and provides an intuitive graphical
user interface for creating new raster layers (See {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1]{Figure\_raster\_terrain\_1}}).

Descrição da análise:
\begin{itemize}
\item {} 
\textbf{Declive}: Calcula o ângulo de declive para cada célula em graus (baseado na estimativa da derivada de primeira ordem).

\item {} 
\textbf{Aspecto}: Exposição (começando de 0 na direção norte, em graus antihorário).

\item {} 
\textbf{Hillshade}: Create shaded map using light and shadow to provide a more
three-dimensional appearance for a shaded relief map.

\item {} 
\textbf{Ruggedness Index}: A quantitative measurement of terrain heterogeneity as
described by Riley et al. (1999). It is calculated for every location, by
summarizing the change in elevation within the 3x3 pixel grid.

\item {} 
\textbf{Relief}: Creating a shaded relief map from digital elevation data.
Implemented is a method to choose the elevation colors analysing the frequency
distribution.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{raster_terrain_dialog.png}
\caption{Raster Terrain Modelling Plugin (slope calculation)}\end{figure}


\subsection{Usando o complemento}
\label{docs/user_manual/plugins/plugins_raster_terrain:using-the-plugin}\label{docs/user_manual/plugins/plugins_raster_terrain:raster-terrain-usage}\begin{enumerate}
\item {} 
Start QGIS and load the \code{gtopo30} raster layer from the GRASS sample
location.

\item {} 
Load the Raster Terrain Analysis plugin in the Plugin Manager (see Section
{\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}})

\item {} 
Select an analysis method from menu (e.g. \emph{Raster \(\rightarrow\) Terrain Analysis \(\rightarrow\)
Slope}). The \emph{Slope} dialog appears as shown in {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1]{Figure\_raster\_terrain\_1}}.

\item {} 
Especifique um caminho para o arquivo de saída, e um tipo de arquivo de saída.

\item {} 
Clique \textbf{{[}OK{]}}.

\end{enumerate}


\section{Complemento de Mapa de Calor}
\label{docs/user_manual/plugins/plugins_heatmap::doc}\label{docs/user_manual/plugins/plugins_heatmap:heatmap-plugin}\label{docs/user_manual/plugins/plugins_heatmap:id1}
O \includegraphics[width=1.5em]{heatmap.png}$^{\text{Complemento do Mapa de Calor}}$ permite criar um mapa de calor a partir de um ponto no mapa vetor. Um mapa de calor é  um mapa de bits mostrando a densidade ou magnitude de informações de pontos relacionados. A partir dos resultados,  ``pontos quentes''  podem ser facilmente  identificados.


\subsection{Ativando o complemento do Mapa de Calor}
\label{docs/user_manual/plugins/plugins_heatmap:activate-the-heatmap-plugin}
Primeiro esse complemento central precisa ser ativado usando o Administrador de Complemento (ver seção':ref:´carregamento\_núcleo\_complemento´). Depois o ícone de ativação do mapa de calor {\color{red}\bfseries{}\textbar{}mapa de calor\textbar{}} pode ser encontrado na Barra de Ferramentas Raster.

Select from menu \emph{View \(\rightarrow\) Toolbars \(\rightarrow\) Raster} to activate the
Raster Toolbar when it is not yet activated.


\subsection{Usando o complemento de Mapa de Calor}
\label{docs/user_manual/plugins/plugins_heatmap:using-the-heatmap-plugin}
The \includegraphics[width=1.5em]{heatmap.png} $^{\text{Heatmap}}$ toolbutton starts the dialog of the Heatmap plugin
(see {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2]{figure\_heatmap\_2}}).

A janela apresenta as seguintes opções:
\begin{itemize}
\item {} 
\textbf{Input Point Vector} dialog: Provides a selection of loaded point vector maps.

\item {} 
\textbf{Output Raster}: Using the \includegraphics{browsebutton.png} button you select the folder and
the name of the output raster the Heatmap plugin will generate. It is not
necessary to give a file extension

\item {} 
\textbf{Output Format}: Selection of the output format. Although all formats supported
by GDAL can be choosen, GeoTIFF is most in cases the best format to choose.

\item {} 
\textbf{Raio}: pode ser usado para dar o alcance em metros  ou unidade de mapeamento. Quando o raio  escolhido é muito pequeno, você não conseguirá um bom Mapa de Calor. Em lugares onde mais círculos ao redor dos pontos se  contrapôem, pontos quentes mais brilhantes irão ocorrer!

\item {} 
\textbf{Decaimento da Proporção}: é usado para mostrar com qual proporção o calor  desaparece do centro.
\begin{itemize}
\item {} 
When 0 is given (=minimum) the heat will be concentrated in the centre of
given radius and be completely extinguished at the edge.

\item {} 
Quando  o valor 10 é dado (=máximo) o calor é concentrado na extremidade e completamente extinto no centro. Valores mais altos são permitidos, mas não tem nenhum efeito.

\item {} 
When 1 is given the heat is spread evenly over the whole circle.

\item {} 
Quando uma decaimento de proporção negativa é gerada, você irá criar um Mapa Frio ao invés de um Mapa de Calor!

\end{itemize}

\end{itemize}

Quando a {\color{red}\bfseries{}\textbar{}}checkbox: :guilabel: Caixa de verificação avançada é marcada esta permitirá acesso a opções adicionais avançadas.
\begin{itemize}
\item {} 
\textbf{Row} and \textbf{Column}, can be used to change the pixelsize of the output raster.
More rows and colums means a smaller pixelsize and the size of the output file
will become bigger and processing a bit slower. When doubling the number of rows
this will automatically double the size of Columns and the cell sizes will also
be halved. The area of the output raster will remain the same!

\item {} 
\textbf{Tamanho da célula X **e **tamanho da célula Y} influencia no tamanho dos pixels do raster de saída e também muda as linhas e colunas.

\end{itemize}

A camada de ponto vetor pode ter  campos de características que podem ser usados para criar mapas de calor:
\begin{itemize}
\item {} 
\textbf{Use raio do campo}: o raio se estabelece de um campo de atributos.

\item {} 
\textbf{Use peso do campo}: o  fator peso se estabelece de um campo de atributos.

\end{itemize}

Quando o raster de saída é dado, o botão \textbf{{[}OK{]}} pode ser usado para criar o mapa de calor. O primeiro resultado será uma superfície cinza que ainda precisará de um tratamento adicional para se transformar em um mapa de calor.

\begin{notice}{warning}{Aviso:}
\textbf{Mudando as propriedades do tamanho do raster}

Ao mudar as propriedades de tamanho do raster, você também mudará o resultado produzido. As áreas de pontos quentes se tornarão maiores.
\end{notice}


\subsection{Criando um Mapa de Calor}
\label{docs/user_manual/plugins/plugins_heatmap:creating-a-heatmap}
Para o exemplo seguinte, nos usaremos o \code{aeroporto} de camadas de vetores de ponto QGIS amostra conjunto de dados (ver {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dados de exemplo}}}). Outro excelente tutorial de QGIS  para fazer mapas de calor pode ser encontrado em \href{http://qgis.spatialthoughts.com/2012/07/tutorial-making-heatmaps-using-qgis-and.html}{http://qgis.spatialthoughts.com}.

Na {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-1]{Figure\_Heatmap}} {\color{red}\bfseries{}1\_} os aeroportos do Alaska são mostrados.
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{heatmap_start.png}
\caption{Airports of Alaska \includegraphics[width=1em]{osx.png}}\end{figure}
\begin{enumerate}
\item {} 
Selecione o botão de ferramenta \includegraphics[width=1.5em]{heatmap.png} $^{\text{Mapa de Calor}}$. A janela Mapa de Calor começa (ver {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2]{Figure\_Heatmap\_2}}).

\item {} 
In field \emph{Input Point Vector} \includegraphics{selectstring.png} select \code{airpoirt}
from the list of  point layers loaded in current project.

\item {} 
In field \emph{Output Raster} give the name and location using the
\includegraphics{browsebutton.png} button of the output raster. Give the output raster file the
name \code{heatmap\_airports} to give an file extension is not necessary.

\item {} 
No campo \emph{Formato Saída} selecione \code{GeoTIFF}.

\item {} 
No campo \emph{Raio} gera \code{1000000} metros.

\item {} 
O original \emph{Decaimento de Proporção} de \code{0.1} está bom.

\item {} 
Clique em \textbf{{[}OK{]}} para criar e carregar o novo mapa raster (ver {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-3]{Figure\_Heatmap\_3}}).

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{heatmap_dialog.png}
\caption{The Heatmap Dialog \includegraphics[width=1em]{osx.png}}\end{figure}

O resultado depois de carregar o Mapa de Calor não será provavelmente o resultado esperado.Ainda será uma superfície lisa cinza sem nehuma variação. Primeiro algumas configurações adicionais dessa camada precisam ser feitas para fazer o Mapa de Calor aparecer.
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{heatmap_loaded_grey.png}
\caption{The heatmap after loading looks like a grey surface \includegraphics[width=1em]{osx.png}}\end{figure}
\begin{enumerate}
\item {} 
Open the properties dialog of layer \code{heatmap\_airports} (select the layer
\code{heatmap\_airports}, open context menu with right mouse button and select
\emph{Properties}).

\item {} 
Select the \emph{Symbology} tab.

\item {} 
Change \emph{Color map} \includegraphics{selectstring.png} from `Grayscale' to `Pseudocolor'.

\item {} 
Press the \textbf{{[}Apply{]}} button.

\item {} 
Switch to the \emph{Transparency} tab and set \emph{Global transparency}
\includegraphics{slider.png} to 40\%.

\item {} 
Selecione \textbf{{[}OK{]}}

\end{enumerate}

O resultado final  pode ser visto na Figura\_Heatmap\_4-.
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{heatmap_loaded_colour.png}
\caption{Final result of heatmap created of airports of Alaska \includegraphics[width=1em]{osx.png}}\end{figure}


\section{Compemento Caminho Mais Curto}
\label{docs/user_manual/plugins/plugins_road_graph:roadgraph}\label{docs/user_manual/plugins/plugins_road_graph::doc}\label{docs/user_manual/plugins/plugins_road_graph:road-graph-plugin}
O complemento Caminho Mais Curto é um complemento C++ para o QGIS, que calcula o caminho mais curto entre dois pontos em qualquer camada de polilinha e desenha este caminho sobre a rede rodoviária.
\phantomsection\label{docs/user_manual/plugins/plugins_road_graph:figure-road-graph-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{roadgraph_sample.png}
\caption{Road Graph Plugin \includegraphics[width=1em]{nix.png}}\end{figure}

Main features:
\begin{itemize}
\item {} 
calcular o caminho, seu comprimento e a duração das viagens

\item {} 
otimizar pelo comprimento ou pelo tempo de viagem

\item {} 
exportar caminho para uma camada vetorial

\item {} 
destaque direções de estradas (isso é lento e utilizado principalmente para fins de depuração e para o teste de configurações)

\end{itemize}

Como uma camada de estradas que você pode usar qualquer camada de vetor polilinha em qualquer formato suportado pelo QGIS. Duas linhas com um ponto em comum são consideradas conectadas. Por favor, note que é necessário para usar SRC da camada como SRC do projeto durante a edição de camada de estradas. Isto é devido ao fato de recalcular as coordenadas entre diferentes SRC ​​introduzir alguns erros que podem resultar em descontinuidades, mesmo quando ``atração'' é usado.

Na tabela de atributos da camada os campos que se seguem podem ser usados:
\begin{itemize}
\item {} 
velocidade no trecho de estrada --- campo numérico;

\item {} 
direction --- any type, that can be casted to string. Forward and reverse
directions are correspond to the one-way road, both directions --- two-way road

\end{itemize}

If some fields don't have any value or do not exist --- default values are used.
You can change defaults and some plugin settings in plugin settings dialog.


\subsection{Using the plugin}
\label{docs/user_manual/plugins/plugins_road_graph:using-the-plugin}
After plugin activation you will see an additional panel on the left side of
the main QGIS window. Now make some definitions to the \emph{Road graph
plugin settings} dialog in the menu \emph{Vector \(\rightarrow\) Road Graph}.

Selecione um ponto inicial e um final na camada da rede viária e clique em ** {[}Calcular{]} {\color{red}\bfseries{}**}.


\section{Plugin de Consulta Espacial}
\label{docs/user_manual/plugins/plugins_spatial_query:spatial-query}\label{docs/user_manual/plugins/plugins_spatial_query::doc}\label{docs/user_manual/plugins/plugins_spatial_query:spatial-query-plugin}
O plugin de \includegraphics[width=1.5em]{spatialquery.png} $^{\text{Consulta Espacial}}$ permite fazer uma consulta espacial(selecionar feições) em uma camada com referência em outra. Este plugin é baseado na biblioteca GEOS e depende de ter uma camada fonte selecionada.

Operações possíveis:
\begin{itemize}
\item {} 
Contém

\item {} 
Igual

\item {} 
Sobrepõe

\item {} 
Cruza

\item {} 
Intersecta

\item {} 
Disjunto

\item {} 
Toca

\item {} 
Dentro

\end{itemize}


\subsection{Using the plugin}
\label{docs/user_manual/plugins/plugins_spatial_query:using-the-plugin}
Como exemplo, queremos encontrar as feições da camada Alaska que contenham aeroportos. Os seguintes passos são necessários:
\begin{enumerate}
\item {} 
Inici o QGIS e abra os seguintes vetores:file:\emph{regions.shp} e  \code{airports.shp}.

\item {} 
Load the Spatial Query plugin in the Plugin Manager (see Section
{\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Carregar um complemento interno}}}) and click on the \includegraphics[width=1.5em]{spatialquery.png}
$^{\text{Spatial Query}}$ icon which appears in the QGIS toolbar menu. The plugin
dialog appears.

\item {} 
Selecione a camada regions como fonte e  a camada airports como referência.

\item {} 
Selecione a operação `Contém' e clique em \textbf{{[}Apply{]}}.

\end{enumerate}

Now you get a list of feature IDs from the query and you have several options as
shown in {\hyperref[docs/user_manual/plugins/plugins_spatial_query:figure-spatial-query-1]{figure\_spatial\_query\_1}}.
\begin{itemize}
\item {} 
Clique em \includegraphics[width=1.5em]{selectesubsetlayer.png} $^{\text{Criar camada a partir dos itens selecionados}}$

\item {} 
Selecione um ID na lista e clique em \includegraphics[width=1.5em]{selectcreatelayer.png} $^{\text{Criar camada a partir da seleção}}$

\item {} 
Select the `Remove from current selection' in the field
\emph{And use the result to} \includegraphics{selectstring.png}.

\item {} 
adicionalmente você pode \includegraphics{checkbox.png} \emph{Aproximar do Item} ou exibir o \includegraphics{checkbox.png} \emph{Registro de mensagens}.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_spatial_query:figure-spatial-query-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{spatial_query_sample.png}
\caption{Spatial Query analysis - regions contain airports \includegraphics[width=1em]{nix.png}}\end{figure}

\index{SPIT}\index{Shapefile\_to\_Postgis\_Import\_Tool}

\section{Complemento SPIT}
\label{docs/user_manual/plugins/plugins_spit:spit-plugin}\label{docs/user_manual/plugins/plugins_spit:index-0}\label{docs/user_manual/plugins/plugins_spit::doc}\label{docs/user_manual/plugins/plugins_spit:label-spit}
QGIS comes with a plugin named SPIT (Shapefile to PostGIS Import Tool). SPIT can
be used to load multiple shapefiles at one time and includes support for schemas.
To use SPIT, open the Plugin Manager from the \emph{Plugins} menu,
check the box next to the \includegraphics{checkbox.png} \emph{SPIT plugin} and click \textbf{{[}OK{]}}.
The SPIT icon will be added to the plugin toolbar.

To import a shapefile, click on the \includegraphics{spiticon.png} $^{\text{SPIT}}$ tool in the toolbar
to open the \emph{SPIT - Shapefile to PostGIS Import Tool} dialog. Select
the PostGIS database you want to connect to and click on \textbf{{[}Connect{]}}. If you
want, you can define or change some import options. Now you can add one or more
files to the queue by clicking on the \textbf{{[}Add{]}} button. To process the files,
click on the \textbf{{[}OK{]}} button. The progress of the import as well as any
errors/warnings will be displayed as each shapefile is processed.
\phantomsection\label{docs/user_manual/plugins/plugins_spit:figure-spit-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{spit_plugin.png}
\caption{Using SPIT Plugin to import Shape files to PostGIS \includegraphics[width=1em]{nix.png}}\end{figure}
\phantomsection\label{docs/user_manual/plugins/plugins_spit:tip-importing-shapefiles}
\begin{notice}{tip}{Dica:}
\textbf{Importing Shapefiles Containing PostgreSQL Reserved Words}

If a shapefile is added to the queue containing fields that are reserved
words in the PostgreSQL database a dialog will popup showing the status of
each field. You can edit the field names prior to import and change any that
are reserved words (or change any other field names as desired). Attempting
to import a shapefile with reserved words as field names will likely fail.
\end{notice}


\section{Complemento SQL Anywhere}
\label{docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere}\label{docs/user_manual/plugins/plugins_sql_anywhere::doc}\label{docs/user_manual/plugins/plugins_sql_anywhere:sql-anywhere-plugin}
SQL Anywhere é um sistema de gerenciamento de banco de dados relacional de propriedade (RDBMS) da Sybase. SQL Anywhere inclui suporte espacial, incluindo OGC,  arquivos shape etc. e construído em funções para exportar para KML, GML e formatos SVG.
\phantomsection\label{docs/user_manual/plugins/plugins_sql_anywhere:figure-sql-anywhere}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{sql_anywhere.png}
\caption{SQL Anywhere dialog (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}

The \includegraphics[width=1.5em]{sqlanywhere.png} $^{\text{SQL Anywhere}}$ allows to connect to spatialy enabled
SQL Anywhere databases. The \emph{Add SQL Anywhere layer} dialog is similar
in functionality to the dialogs for PostGIS and SpatiaLite.


\section{Complemento Estatística Zonal}
\label{docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics-plugin}\label{docs/user_manual/plugins/plugins_zonal_statistics::doc}\label{docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics}
With the \includegraphics[width=1.5em]{raster-stats.png} $^{\text{Zonal Statistics Plugin}}$ you can
analyze the results of a thematic classification. It allows to calculate several
values of the pixels of a raster layer with the help of a polygonal vector layer
(see {\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:figure-zonal-statistics]{figure\_zonal\_statistics}}). You can calculate the sum, the mean value and
the total count of the pixels that are within a polygon. The plugin generates
output columns in the vector layer with a user-defined prefix.
\phantomsection\label{docs/user_manual/plugins/plugins_zonal_statistics:figure-zonal-statistics}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{zonal_statistics.png}
\caption{Zonal statistics dialog (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}


\chapter{Ajuda e Suporte}
\label{docs/user_manual/preamble/help_and_support:help-and-support}\label{docs/user_manual/preamble/help_and_support::doc}

\section{Listas de Discurssão}
\label{docs/user_manual/preamble/help_and_support:mailing-lists}\label{docs/user_manual/preamble/help_and_support:label-helpsupport}
QGIS está em desenvolvimento ativo e como tal ele nem sempre funciona como você esperaria. O caminho preferido para obter ajuda é se juntando à lista de discurssão dos usuários de QGIS. Suas dúvidas chegarão a um público maior e as respostas beneficiará outros usuários.


\subsection{Usuários QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-users}
Esta lista é utilizada para discurssão do QGIS em geral, bem como sobre questões específicas em relação à instalaçao e uso. Você pode se inscrever na lista de discurssão dos usuário de QGIS visitando a seguinte URL: \href{http://lists.osgeo.org/mailman/listinfo/qgis-user}{http://lists.osgeo.org/mailman/listinfo/qgis-user}


\subsection{Lista fossgis-talk}
\label{docs/user_manual/preamble/help_and_support:fossgis-talk-liste}
Para o público de língua alemã, o alemão FOSSGIS e.V. fornece a lista de discussão fossgis-talk. Esta lista de discussão é utilizada para o debate de SIG de código aberto em geral incluindo QGIS. Você pode se inscrever para a lista fossgis-talk visitando a seguinte URL: \href{https://lists.fossgis.de/mailman/listinfo/fossgis-talk-liste}{https://lists.fossgis.de/mailman/listinfo/fossgis-talk-liste}


\subsection{Desenvolvedor QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-developer}
Se você é um desenvolvedor enfrentando problemas de natureza mais técnica, você pode querer se juntar a lista de discussão qgis-desenvolvedor aqui: \href{http://lists.osgeo.org/mailman/listinfo/qgis-developer}{http://lists.osgeo.org/mailman/listinfo/qgis-developer}


\subsection{Atualizações QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-commit}
Cada vez que uma atualização é realizada no repositório de código QGIS um email é enviado para esta lista. Se você quer ser informado das atualizações de todas as mudanças da código base atual, você pode se inscrever nesta lista:
\href{http://lists.osgeo.org/mailman/listinfo/qgis-commit}{http://lists.osgeo.org/mailman/listinfo/qgis-commit}


\subsection{QGIS-trac}
\label{docs/user_manual/preamble/help_and_support:qgis-trac}
Esta lista fornece uma notificação de email relacionado a gerenciamento de projetos, incluindo relatórios de bugs, tarefas e solicitações de recursos. Você pode se inscrever para esta lista em: \href{http://lists.osgeo.org/mailman/listinfo/qgis-trac}{http://lists.osgeo.org/mailman/listinfo/qgis-trac}


\subsection{Equipe da Comunidade QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-community-team}
Esta lista trata de temas como a documentação, ajuda de contexto, guia do usuário, experiência online  incluindo sítios, blog, listas de discussão, fóruns e esforços de tradução. Se você gosta de trabalhar com o guia do usuário, esta lista é um bom ponto de partida para fazer suas perguntas. Você pode se inscrever para esta lista em: \href{http://lists.osgeo.org/mailman/listinfo/qgis-community-team}{http://lists.osgeo.org/mailman/listinfo/qgis-community-team}


\subsection{Equipe de lançamento QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-release-team}
Esta lista inclui tópicos como o processo de lançamento, pacotes binários para vários Sistemas Operacionais e anúncios de novos lançamentos para o mundo em geral. Você pode se inscrever nesta lista em: \href{http://lists.osgeo.org/mailman/listinfo/qgis-release-team}{http://lists.osgeo.org/mailman/listinfo/qgis-release-team}


\subsection{Tradução do QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-tr}
Esta lista trata dos esforços de tradução. Se você gosta de trabalhar na tradução dos manuais ou na interface gráfica do usuário (GUI), esta lista é um bom ponto de partida para fazer suas perguntas. Você pode se inscrever nesta lista em: \href{http://lists.osgeo.org/mailman/listinfo/qgis-tr}{http://lists.osgeo.org/mailman/listinfo/qgis-tr}


\subsection{Aprendizado QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-edu}
Esta lista trata dos esforços de Aprendizado do QGIS. Se você gosta de trabalhar com materiais de aprendizado do QGIS, esta lista é um bom ponto de partida para fazer suas perguntas.  Você pode se inscrever nesta lista em: \href{http://lists.osgeo.org/mailman/listinfo/qgis-edu}{http://lists.osgeo.org/mailman/listinfo/qgis-edu}


\subsection{Comitê Diretor QGIS}
\label{docs/user_manual/preamble/help_and_support:qgis-psc}
Esta lista é usada para discutir com o Comitê Diretor questões relacionadas com a gestão e direcionamento do Quantum GIS. Você pode se inscrever nesta lista em: \href{http://lists.osgeo.org/mailman/listinfo/qgis-psc}{http://lists.osgeo.org/mailman/listinfo/qgis-psc}

Você está convidado a se inscrever em qualquer uma das listas. Por favor, lembre-se de contribuir com a lista respondendo a perguntas e compartilhando suas experiências. Note que os links das listas Atualizações QGIS e QGIS-trac são projetados apenas para notificação e não destinado a postagens de usuários.


\section{IRC}
\label{docs/user_manual/preamble/help_and_support:irc}
Nós também marcamos presença no IRC - visite-nos acessando o canal \# qgis em irc.freenode.net. Por favor, aguarde pela resposta de sua pergunta. Como muitas pessoas no canal estão fazendo outras atividades  isso pode levar um tempo para para perceberem sua pergunta. O suporte comercial para o QGIS também está disponível. Confira no site: \href{http://qgis.org/en/commercial-support.html}{http://qgis.org/en/commercial-support.html} para mais informações.

Se você perdeu uma discussão no IRC, não é problema! Nós gravamos todas as discussões para que você possa acessá-las facilmente. Basta acessar \href{http://logs.qgis.org}{http://logs.qgis.org} e ler os registros do IRC.


\section{Rastreador de Erros}
\label{docs/user_manual/preamble/help_and_support:bugtracker}
Emquanto a lista de discussão de usuários QGIS é útil para perguntas do tipo ``como eu faço XYZ no QGIS'' , você poderá nos informar sobre erros no QGIS. Você pode enviar relatórios de erros usando o Rastreador de Erros do QGIS em \href{http://hub.qgis.org/projects/quantum-gis/issues}{http://hub.qgis.org/projects/quantum-gis/issues}. Quando criar uma nova mensagem de erro, por favor, forneça um endereço de email onde possamos solicitar informações adicionais.

Por favor, tenha em mente que o erro nem sempre é avaliado com a prioridade que você desejaria (dependendo de sua gravidade). Alguns erros podem requerer um esforço significativo dos desenvolvedores para solucioná-lo e a mão de obra não está sempre disponível para isso.

Solicitações de recursos também podem ser enviadas usando o mesmo sistema de mensagem de erros. Por favor, certifique-se de ter selecionado o tipo de recurso.

Se você encontrou algum erro e conseguiu fixá-lo você pode enviar esta correção também.Novamente, o adorável sistema de mensagens da redmine em \href{http://hub.qgis.org/projects/quantum-gis/issues}{http://hub.qgis.org/projects/quantum-gis/issues} faz isso muito bem. Vá em ``correção fornecida'' marque e anexe sua correção antes de enviar o erro. Algum desenvolvedores irá analisá-lo e aplicá-lo no QGIS. Por favor não se assuste se a sua correção não é aplicada de imediato --- desenvolvedores podem estar ocupados com outros compromissos.


\section{Blog}
\label{docs/user_manual/preamble/help_and_support:blog}
A comunidade QGIS também mantém um weblog em \href{http://www.qgis.org/planet}{http://www.qgis.org/planet} que tem alguns artigos interessantes para usuários e desenvolvedores bem como fornecido por outros blogs da comunidade. Você está convidado a contribuir no blog do QGIS!


\section{Plugins}
\label{docs/user_manual/preamble/help_and_support:plugins}
The website \href{http://plugins.qgis.org}{http://plugins.qgis.org} provides the official QGIS plugins web portal.
Here you find a list of all stable and experimental QGIS plugins available via
the `Official QGIS Plugin Repository'.


\section{Wiki}
\label{docs/user_manual/preamble/help_and_support:wiki}
Por fim, nós mantemos um site wiki em \href{http://hub.qgis.org/projects/quantum-gis/wiki}{http://hub.qgis.org/projects/quantum-gis/wiki} onde você pode encontrar uma variedade de informações úteis relacionadas com o desenvolvimento em QGIS, planos de lançamento, links para sites de download, tradução de mensagens, dicas e assim por diante. Confira, há coisas interessantes por lá!


\chapter{Apêndice}
\label{docs/user_manual/appendices/appendices:appendix}\label{docs/user_manual/appendices/appendices::doc}
\index{license!GPL}

\section{GNU General Public License}
\label{docs/user_manual/appendices/appendices:index-0}\label{docs/user_manual/appendices/appendices:gpl-appendix}\label{docs/user_manual/appendices/appendices:gnu-general-public-license}
Versão 2, Junho 1991

Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place - Suite 330, Boston, MA  02111-1307, USA

Qualquer pessoa tem permissão para copiar e distribuir cópias fiéis deste documento de licença, mas modifica-lo não é permitido.

Preâmbulo

As licenças para a maioria dos softwares são projetadas para tirar a sua liberdade de compartilhar e modifica-los. Por outro lado, a GNU (Licença Publica Geral) tem o objetivo de garantir a sua liberdade de compartilhar e modificar softwares livres para garantir que o software seja gratuito para todos os seus usuários. Estal Licença Publica Geral se aplica a maioria dos softwares da Fundação de Softwares Livres e a qualquer outro programa cujo autor venha a utiliza-la. (Outros softwares da Fundaçao de Softwares Livres estão cobertos pela GNU Biblioteca Licença Publica Geral.) Você pode aplica-la aos seus programas também.

Quando falamos em softwares livres, nos referimos a liberdade, não preço. Nossa Licença Publica Geral é projetada para garantir: que você tenha liberdade de compartilhar cópias do software livre (e cobrar por este serviço, se desejar) que você recebeu o código fonte ou pode adquirir se quiser; que você possa modificar o software ou usar partes dele em novos softwares livres; que você saiba que pode fazer tais coisas.

Para proteger os seus direitos nós precisamos fazer restrições que proibem qualquer pessoa a negar a você tais direitos ou a pedir que se renda a eles.Estas restriçoes se traduzem em certas responsabilidades para você, se você distribuir ou modificar cópias do software.

Por exemplo, se você distribuir cópias de determinado programa, seja ele gratis ou por uma taxa, você deve dar aos beneficiários todos os direitos que você tem. Você deve garantir que eles também recebam ou possam acessar o codigo fonte.E você deve mostrar a eles estes termos para que eles saibam seus direitos.

Nós protegemos seus direitos com dois passos: (1) direitos autorais do software, e (2) oferecemos a você esta licença que lhe dá a permissão legal para copiar, distruibuir e/ou modificar o software.

Também, para a proteção nossa e de cada autor, nós queremos garantir que todos compreendam que não há garantia para este software livre. Se o software for modificado por outra pessoa e passado adiante, os beneficiários devem saber que oque eles tem não é o software original, para que, qualquer problema introduzido por outros não reflita na reputaçao do autor original.

Por fim, qualquer programa livre é constantemente ameaçado por patentes de softwares. Nós queremos evitar o risco de que redistribuidores de um programa livre obtenham licenças individuais, fazendo assim do programa proprietário. Para prevenir isso, nós deixamos claro que qualquer patente deve ser licenciada para o uso livre de todas as pessoas.

Seguem os precisos termos e condições para cópia, ditribuiçao e modificaçao. TERMOS E CONDIÇÕES PARA CÓPIA, DISTRIBUIÇAO E MODIFICAÇÃO
\begin{enumerate}
\setcounter{enumi}{-1}
\item {} 
Esta licença se aplica a qualquer programa ou outro trabalho que contenha um aviso inserido pelo detentor dos direitos autorais informando que o mesmo pode ser distribuído sob as condições desta Licença Pública Geral.O ``Programa'' abaixo refere-se a qualquer programa ou trabalho, e ``trabalho baseado no Programa'' significa tanto o Programa em si como quaisquer trabalhos derivados, de acordo com a lei de direitos autorais: isto quer dizer um trabalho que contenha o Programa ou parte dele, tanto originalmente ou com modificações, e/ou tradução para outros idiomas. (Doravante o processo de tradução está incluído sem limites no termo ``modificação''.) Cada licenciado é mencionado como ``você''.

Atividades outras que a cópia, a distribuição e modificação não estão cobertas por esta Licença; elas estão fora de seu escopo.  O ato de executar o Programa não é restringido e o resultado do Programa é coberto apenas se seu conteúdo contenha trabalhos baseados no Programa (independentemente de terem sido gerados pela execução do Programa). Se isso é verdadeiro depende do que o programa faz.

\item {} 
Você pode copiar e distribuir cópias fiéis do código-fonte do Programa da mesma forma que você o recebeu, usando qualquer meio, deste que você conspícua e apropriadamente publique em cada cópia um aviso de direitos autorais e uma declaração de inexistência de garantias; mantenha intactas todos os avisos que se referem a esta Licença e à ausência total de garantias; e forneça a outros recebedores do Programa uma cópia desta Licença, junto com o Programa.

Você pode cobrar uma taxa pelo ato físico de transferir uma cópia e pode, opcionalmente, oferecer garantia em troca de pagamento.

\item {} 
Você pode modificar sua cópia ou cópias do Programa, ou qualquer parte dele, assim gerando um trabalho baseado no Programa, e copiar e distribuir essas modificações ou trabalhos sob os termos da seção 1 acima, desde que você também se enquadre em todas estas condições:
\begin{enumerate}
\item {} 
Você tem que fazer com que os arquivos modificados levem avisos proeminentes afirmando que você alterou os arquivos, incluindo a data de qualquer alteração.

\item {} 
Você tem que fazer com que quaisquer trabalhos que você  distribua ou publique, e que integralmente ou em partes contenham ou sejam derivados do Programa ou de suas partes, sejam licenciados, integralmente e sem custo algum para quaisquer terceirose, sob os termos desta Licnça.

\item {} 
Se qualquer programa modificado normalmente lê comandos interativamente quando executados, você tem que fazer com que, quando iniciado tal uso interativo da forma mais simples, seja impresso ou mostrado um anúncio de que não há qualquer garantia (ou então que você fornece a garantia) e que os usuários podem redistribuir o programa sob estas condições, ainda informando os usuários como consultar uma cópia desta Licença. (Exceção: se o Programa em si é interativo mas normalmente não imprime estes tipos de anúncios, seu trabalho baseado no Programa não precisa imprimir um anúncio.)

\end{enumerate}

Estas exigências aplicam-se ao trabalho modificado como um todo. Se seções identificáveis de tal trabalho não são derivadas do Programa, e podem ser razoavelmente consideradas trabalhos independentes e separados por si só, então esta Licença, e seus termos, não se aplicam a estas seções quando você distribui-las como trabalhos em separado. Mas quando você distribuir as mesmas seções como parte de um todo que é trabalho baseado no Programa, a distribuição como um todo tem que se enquadrar nos termos desta Licença, cujas permissões para outros licenciados se estendem ao todo, portanto também para cada e toda parte independente de quem a escreveu.

Desta forma, esta seção não tem a intenção de reclamar direitos os contestar seus direitos sobre o trabalho escrito completamente por você; ao invés disso, a intenção é a de exercitar o direito de controlar a distribuição de trabalhos, derivados ou coletivos, baseados no Programa.

Adicionalmente, a mera adição ao Programa de outro trabalho não baseado no Programa (ou de trabalho baseado no Programa) em um volume de armazenamento ou meio de distribuição não faz o outro trabalho parte do escopo desta Licença.

\item {} 
Você pode copiar e distribuir o Programa (ou trabalho baseado nele, conforme descrito na Seção 2) em código-objeto ou em forma executável sob os termos das Seções 1 e 2 acima, desde que você faça um dos seguintes:
\begin{enumerate}
\item {} 
O acompanhe com o código-fonte completo e em forma acessível por máquinas, que tem que ser distribuído sob os termos das Seções 1 e 2 acima e em meio normalmente utilizado para o intercâmbio de software; ou,

\item {} 
O acompanhe com uma oferta escrita, válida por pelo menos três anos, de fornecer a qualquer um, com um custo não superior ao custo de distribuição física do material, uma cópia do código-fonte completo e em forma acessível por máquinas, que tem que ser distribuído sob os termos das Seções 1 e 2 acima e em meio normalmente utilizado para o intercâmbio de software; ou,

\item {} 
O acompanhe com a informação que você recebeu em relação à oferta de distribuição do código-fonte correspondente. (Esta alternativa é permitida somente em distribuição não comerciais, e apenas se você recebeu o programa em forma de código-objeto ou executável, com oferta de acordo com a Subseção b acima.)

\end{enumerate}

O código-fonte de um trabalho corresponde à forma de trabalho preferida para se fazer modificações. Para um trabalho em forma executável, o código-fonte completo significa todo o código-fonte de todos os módulos que ele contém, mais quaisquer arquivos de definição de ``interface'', mais os ``scripts'' utilizados para se controlar a compilação e a instalação do executável. Contudo, como exceção especial, o código-fonte distribuído não precisa incluir qualquer componente normalmente distribuído (tanto em forma original quanto binária) com os maiores componentes (o compilador, o ``kernel'' etc.) do sistema operacional sob o qual o executável funciona, a menos que o componente em si acompanhe o executável.

Se a distribuição do executável ou código-objeto é feita através da oferta de acesso a cópias de algum lugar, então ofertar o acesso
equivalente a cópia, do mesmo lugar, do código-fonte equivale à distribuição do código-fonte, mesmo que terceiros não sejam compelidos a copiar o código-fonte com o código-objeto.

\item {} 
Você não pode copiar, modificar, sub-licenciar ou distribuir o Programa, exceto de acordo com as condições expressas nesta
Licença. Qualquer outra tentativa de cópia, modificação, sub-licenciamento ou distribuição do Programa não é valida, e
cancelará automaticamente os direitos que lhe foram fornecidos por esta Licença. No entanto, terceiros que de você receberam cópias ou direitos, fornecidos sob os termos desta Licença, não terão suas licenças terminadas, desde que permaneçam em total concordância com ela.

\item {} 
Você não é obrigado a aceitar esta Licença já que não a assinou. No entanto, nada mais o dará permissão para modificar ou
distribuir o Programa ou trabalhos derivados deste. Estas ações são proibidas por lei, caso você não aceite esta Licença. Desta forma, ao modificar ou distribuir o Programa (ou qualquer trabalho derivado do Programa), você estará indicando sua total aceitação desta Licença para fazê-los, e todos os seus termos e condições para copiar, distribuir ou modificar o Programa, ou trabalhos baseados nele.

\item {} 
Cada vez que você redistribuir o Programa (ou qualquer trabalho baseado nele), os recebedores adquirirão automaticamente do
licenciador original uma licença para copiar, distribuir ou modificar o Programa, sujeitos a estes termos e condições. Você não poderá impor aos recebedores qualquer outra restrição ao exercício dos direitos então adquiridos. Você não é responsável em garantir a concordância de terceiros a esta Licença.

\item {} 
Se, em conseqüência de decisões judiciais ou alegações de infringimento de patentes ou quaisquer outras razões (não limitadas a
assuntos relacionados a patentes), condições forem impostas a você (por ordem judicial, acordos ou outras formas) e que contradigam as condições desta Licença, elas não o livram das condições desta Licença. Se você não puder distribuir de forma a satisfazer simultaneamente suas obrigações para com esta Licença e para com as outras obrigações pertinentes, então como conseqüência você não poderá distribuir o Programa. Por exemplo, se uma licença de patente não permitirá a redistribuição, livre de ``royalties'', do Programa, por todos aqueles que receberem cópias direta ou indiretamente de você, então a única forma de você satisfazer a ela e a esta Licença seria a de desistir completamente de distribuir o Programa.

Se qualquer parte desta seção for considerada inválida ou não aplicável em qualquer circunstância particular, o restante da seção se
aplica, e a seção como um todo se aplica em outras circunstâncias.

O propósito desta seção não é o de induzi-lo a infringir quaisquer patentes ou reivindicação de direitos de propriedade outros, ou a contestar a validade de quaisquer dessas reivindicações; esta seção tem como único propósito proteger a integridade dos sistemas de distribuição de software livres, o que é implementado pela prática de licenças públicas. Várias pessoas têm contribuído generosamente e em grande escala para os software distribuídos usando este sistema, na certeza de que sua aplicação é feita de forma consistente; fica a critério do autor/doador decidir se ele ou ela está disposto a distribuir software utilizando outro sistema, e um licenciado não pode impor esta escolha.

Esta seção destina-se a tornar bastante claro o que se acredita ser conseqüência do restante desta Licença.

\item {} 
Se a distribuição e/ou uso do Programa são restringidos em certos países por patentes ou direitos autorais, o detentor dos direitos autorais original, e que colocou o Programa sob esta Licença, pode incluir uma limitação geográfica de distribuição, excluindo aqueles países de forma a tornar a distribuição permitida apenas naqueles ou entre aqueles países então não excluídos. Nestes casos, esta Licença incorpora a limitação como se a mesma constasse escrita nesta Licença.

\item {} 
A Free Software Foundation (Fundação do Software Livre) pode publicar versões revisadas e/ou novas da Licença Pública Geral de tempos em tempos. Estas novas versões serão similares em espírito à versão atual, mas podem diferir em detalhes que resolvem novos problemas ou situações.

A cada versão é dada um número distinto. Se o Programa especifica um número de versão específico desta Licença que se aplica a ele e a ``qualquer nova versão'', você tem a opção de aceitar os termos e condições daquela versão ou de qualquer outra versão publicada pela Free Software Foundation. Se o programa não especifica um número de versão desta Licença, você pode escolher qualquer versão já publicada pela Free Software Foundation.

\item {} 
Se você pretende incorporar partes do Programa em outros programas livres cujas condições de distribuição são diferentes,
escreva ao autor e solicite permissão. Para o software que a Free Software Foundation detém direitos autorais, escreva à Free Software Foundation; às vezes nós permitimos exceções a este caso. Nossa decisão será guiada pelos dois objetivos de preservar a condição de liberdade de todas as derivações do nosso software livre, e de promover o compartilhamento e reutilização de software em aspectos gerais.

\end{enumerate}

AUSÊNCIA DE GARANTIA
\begin{enumerate}
\setcounter{enumi}{10}
\item {} 
PELO PROGRAMA SER LICENCIADO SEM ÔNUS, NÃO HÁ QUALQUER GARANTIA PARA O PROGRAMA, NA EXTENSÃO PERMITIDA PELAS LEIS APLICÁVEIS. EXCETO QUANDO EXPRESSADO DE FORMA ESCRITA, OS DETENTORES DOS DIREITOS AUTORAIS E/OU TERCEIROS DISPONIBILIZAM O PROGRAMA ``NO ESTADO'', SEM QUALQUER TIPO DE GARANTIAS, EXPRESSAS OU IMPLÍCITAS,
INCLUINDO, MAS NÃO LIMITADO A, AS GARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO E AS DE ADEQUAÇÃO A QUALQUER PROPÓSITO. O RISCO TOTAL COM A QUALIDADE E DESEMPENHO DO PROGRAMA É SEU. SE O PROGRAMA SE MOSTRAR DEFEITUOSO, VOCÊ ASSUME OS CUSTOS DE TODAS AS MANUTENÇÕES, REPAROS E CORREÇÕES.

\item {} 
EM NENHUMA OCASIÃO, A MENOS QUE EXIGIDO PELAS LEIS APLICÁVEIS OU ACORDO ESCRITO, OS DETENTORES DOS DIREITOS AUTORAIS, OU QUALQUER OUTRA PARTE QUE POSSA MODIFICAR E/OU REDISTRIBUIR O PROGRAMA CONFORME
PERMITIDO ACIMA, SERÃO RESPONSABILIZADOS POR VOCÊ POR DANOS, INCLUINDO QUALQUER DANO EM GERAL, ESPECIAL, ACIDENTAL OU CONSEQÜENTE, RESULTANTES DO USO OU INCAPACIDADE DE USO DO PROGRAMA (INCLUINDO, MAS NÃO LIMITADO A, A PERDA DE DADOS OU DADOS TORNADOS INCORRETOS, OU PERDAS SOFRIDAS POR VOCÊ OU POR OUTRAS PARTES, OU FALHAS DO PROGRAMA AO OPERAR COM QUALQUER OUTRO PROGRAMA), MESMO QUE TAL DETENTOR OU
PARTE TENHAM SIDO AVISADOS DA POSSIBILIDADE DE TAIS DANOS.

\end{enumerate}

\textbf{Quantum GIS Qt exceção para GPL}
\begin{quote}

Em adição, excepcionalmente, a Equipe de Desenvolvimento QGIS dá a permissão de linkar o código deste programa com a biblioteca QT, inclusa, mas não limitada as seguintes versões (ambas gratuitas e comerciais):Qt / Não-Comercial do Windows, Qt / Windows, Qt/X11, Qt / Mac, e Qt / Embedded (ou com versões modificadas do Qt que usam a mesma licença do Qt) e distribuir combinações relacionadas, incluindo os dois. Você deve obedecer a GNU General Public License em todos os aspectos para todo o código usado em outra Qt. Se você modificar este arquivo, você pode estender essa exceção para a sua versão do arquivo, mas você não é obrigado a fazê-lo. Se você não quiser fazer isso, exclua essa declaração exceção de sua versão.
\end{quote}


\section{GNU Licença de Documentação Gratuíta}
\label{docs/user_manual/appendices/appendices:gfl-appendix}\label{docs/user_manual/appendices/appendices:gnu-free-documentation-license}\begin{quote}

Versão 1.3, 3 de Novembro de 2008

Direitos Autorais  2000, 2001, 2002, 2007, 2008 Free Software Foundation (Fundação do Software Livre)

\textless{}\href{http://fsf.org/}{http://fsf.org/}\textgreater{}
\end{quote}

Qualquer pessoa tem permissão para copiar e distribuir cópias fiéis deste documento de licença, mas modifica-lo não é permitido.

\textbf{Preâmbulo}

O objetivo desta licença é produzir um manual, compêndio, ou outro documento funcional e útil. ``Grátis'' no sentido de liberdade: para garantir a todos a efetiva liberdade de copiar e distribui-la com ou sem modificações, comercialmente ou não.Secundariamente esta licença preserva ao autor e editor  uma maneira de ter crédito pelo seu trabalho, embora não sejam considerados responsaveis por modificações feitas por outros.

Esta licença é uma espécie de ``copyleft'', oque significa que trabalhos derivativos do documento devem ser livres no mesmo sentido. Ela complementa a GNU (Licença Publica Geral), que é uma licença copyleft projetada para softwares livres.

Criamos esta Licença para que seja usada em manuais para programas livres, porque programas livres precisam de documentação livre: um programa livre deveria vir com manuais que ofereçam as mesmas liberdades que o programa oferece. Mas esta Licença não está limitada a manuais de programas de computador; ela pode ser usada para qualquer trabalho de texto, independentemente do assunto ou se é publicado como um livro impresso. Nós recomendamos esta Licença principalmente para trabalhos cujo propósito é instrução ou referência.

\textbf{1. APPLICABILITY AND DEFINITIONS}

Esta licença se aplica a qualquer manual ou outro trabalho, em qualquer meio, que contenha uma nota introduzida pelo detentor dos direitos autorais dizendo que o documento pode ser distribuído sob os termos desta. Tal nota garante uma licença mundial, livre de royalties, de duração ilimitada, para usar este trabalho sob as condições aqui colocadas. O ``Documento'', abaixo, se refere a qualquer tal manual ou trabalho. Qualquer membro do público é um licenciado, e será tratado por ``você''. Você aceita a licença se copiar, modificar ou distribuir o trabalho de um modo que necessite de permissão de acordo com a lei de direitos autorais.

Uma ``Versão Modificada'' do Documento se refere a qualquer trabalho contendo o Documento ou uma parte deste, quer seja copiado sem modificações, quer com modificações e/ou traduzido para outra língua.

Uma ``Seção Secundária'' é um apêndice com nome ou uma seção inicial do Documento que trata exclusivamente da relação dos editores ou autores do Documento com seu assunto geral (ou temas relacionados) e não contém nada que possa estar diretamente dentro do assunto geral. Assim, se o Documento é em parte um livro- texto de matemática, uma Seção Secundária não pode explicar nada de matemática. Tal relação pode ser uma conexão histórica com o assunto ou com temas relacionados, ou tratar de questões legais, comerciais, filosóficas, éticas ou políticas com relação a eles.

``Seções Invariantes'' são certas Seções Secundárias cujos títulos são designados como sendo de Seções invariantes na nota que afirma que o Documento é publicado sob esta Licença. Se uma seção não se encaixa na definição acima de Secundária, então não se permite que seja designada como Invariante. O Documento pode não conter nenhuma Seção Invariante. Se o documento não identificar quaisquer Seções Invariantes, então não há nenhuma.

``Textos de Capa'' são certas passagens de texto que são listada como Textos de Capa Frontal ou Texto de Quarta Capa, na nota que afirma que o Documento é publicado sob esta Licença. Um Texto de Capa Frontal pode ter no máximo 5 palavras, e um Texto de Quarta Capa pode ter no máximo 25 palavras.

Uma cópia ``Transparente'' do Documento significa uma cópia que pode ser lida pelo computador, representada em um formato cuja especificação esteja disponível ao público geral, que seja apropriada para a imediata revisão do documento usando-se editores de texto genéricos ou (para imagens compostas de pixeis) programas gráficos genéricos ou (para desenhos) algum editor de desenhos amplamente disponível, e que seja apropriado para inclusão em formatadores de texto ou para tradução automática para uma variedade de formatos apropriados para inclusão em formatadores de texto. Uma cópia feita em outro formato de arquivo Transparente cuja marcação, ou ausência desta, foi manipulada para impedir ou desencorajar modificação subseqüente pelos leitores não é Transparente. Um formato de imagem não é Transparente se usado em lugar de qualquer quantidade substancial de texto. Uma cópia que não é ``Transparente'' é chamada ``Opaca''.

Exemplos de formatos apropriados para cópias Transparentes incluem ASCII puro sem marcação, formato de entrada Texinfo, LaTex, SGML ou XML usando um DTD publicamente disponível, e HTML padrão simples, PostScript ou PDF projetados para modificação por humanos. Exemplos de formatos de imagem transparentes incluem PNG, XCF e JPG. Formatos Opacos incluem formatos proprietários que podem ser lidos e editados somente por processadores de texto proprietários, SGML ou XML para os quais o DTD e/ou ferramentas de processamento não são largamente disponibilizadas, e HTML, Postscript ou PDF gerados automaticamente com propósito apenas de saída por alguns processadores de texto.

``Página de Título'' significa, para um livro impresso, a própria página do título, além das páginas subseqüentes necessárias para conter, de forma legível, o material que esta Licença requer que apareça na página do título. Para trabalhos em formatos que não têm uma página de título assim, ``Página de Título'' significa o texto próximo à ocorrência mais proeminente do título do trabalho, precedendo o início do corpo do texto.

O ``\textbf{publicador}'' é qualquer pessoa ou entidade que distribua cópias do Documento para o público.

Uma seção ``Intitulada XYZ'' significa uma sub-unidade com nome do Documento cujo título ou é precisamente XYZ ou contém XYZ em parênteses seguindo o texto que traduz XYZ em outra língua. (Aqui XYZ representa o nome de uma seção específica mencionado acima, tal como ``Agradecimentos'', ``Dedicatória'', ``Apoio'', ou ``Histórico''.) ``Preservar o Título'' de uma seção assim quando você modifica o Documento significa que ela continua sendo uma seção ``Intitulada XYZ'' de acordo com esta definição.

O Documento pode incluir Notas de Garantia em seguida à nota que afirma que esta Licença se aplica ao Documento. Estas Notas de Garantia são tidas como inclusas por referência nesta Licença, mas somente com relação às notas de garantia: qualquer outra implicação que estas Notas de Garantia possam ter é anulada e não tem efeito algum no conteúdo desta Licença.

\textbf{2. VERBATIM COPYING}

Você pode copiar e distribuir o Documento em qualquer meio, comercialmente ou não-comercialmente, desde que esta licença, as notas de direitos autorais (copyright), e a nota de licença afirmando que esta Licença se aplica ao Documento sejam reproduzidas em todas as cópias, e que você não inclua outras condições, quaisquer que sejam, às condições desta Licença. Você não pode usar de medidas técnicas para obstruir ou controlar a leitura ou cópia futura das cópias que você fizer ou distribuir. Contudo, você pode aceitar compensação em troca das cópias. Se você distribuir um número suficientemente grande de cópias, você deve também respeitar as condições na seção 3.

Você pode também emprestar cópias, sob as mesmas condições acima mencionadas, e você também as pode mostrar publicamente.

\textbf{3. COPYING IN QUANTITY}

Se você publicar cópias impressas (ou cópias em um meio que normalmente tem capas impressas) do documento, em número maior que 100, e a nota de licença do Documento requer Textos de Capa, você deve encadernar as cópias em capas que carreguem, de forma clara e legível, todos estes Textos de Capa: Textos de Capa Frontal na capa frontal, e Textos de Quarta Capa na quarta capa. Ambas as capas devem também identificar, de forma clara e legível, você como o editor das cópias. A capa frontal deve apresentar o título completo com todas as palavras deste igualmente proeminentes e visíveis. Você pode adicionar outro material nas capas. Cópias com mudanças limitadas às capas, desde que preservando o título do Documento e satisfazendo estas condições, podem ser tratadas como cópias literais em outros aspectos.

Se os textos necessários a qualquer uma das capas são demasiado volumosos para serem incluídos de forma legível, você deve colocar os primeiros listados (quantos couberem razoavelmente) na própria capa, e continuar o resto nas páginas adjacentes.

Se você publicar ou distribuir cópias Opacas do Documento em número maior que 100, você deve ou incluir uma cópia Transparente legível por computador juntamente com cada cópia Opaca, ou dizer em, ou juntamente com, cada cópia Opaca um endereço de rede a partir do qual o público geral possa acessar e obter, usando protocolos de rede públicos padrão, uma cópia Transparente completa do Documento, livre de material adicionado. Se você decidir pela segunda opção, você deve seguir passos razoavelmente prudentes, quando começar a distribuir as cópias Opacas em quantidade, para garantir que esta cópia transparente permanecerá acessível no local indicado por pelo menos um ano após a última vez que você distribuir uma cópia Opaca (diretamente ou através de seus agentes ou distribuidor) desta edição ao público.

É solicitado, mas não exigido, que você contate os autores do Documento muito antes de redistribuir qualquer número grande de cópias, para dar a eles uma chance de lhe fornecer uma versão atualizada do Documento.

\textbf{4. MODIFICATIONS}

Você pode copiar e distribuir uma Versão Modificada do Documento sob as condições das seções 2 e 3 acima, desde que você forneça a Versão Modificada estritamente sob esta Licença, com a Versão Modificada no papel de Documento, permitindo assim a distribuição e modificação da Versão Modificada a quem quer que possua uma cópia desta. Além disso, você deve executar os seguintes procedimentos na Versão Modificada:
\begin{enumerate}
\item {} 
Use in the Title Page (and on the covers, if any) a title distinct
from that of the Document, and from those of previous versions
(which should, if there were any, be listed in the History section
of the Document).  You may use the same title as a previous version
if the original publisher of that version gives permission.

\item {} 
Liste na Página de Título, como autores, uma ou mais pessoas ou entidades responsáveis pela autoria ou modificações na Versão Modificada, juntamente com pelo menos cinco dos autores principais do Documento (todos seus autores principais, se houver menos que cinco), a menos que estes lhe desobriguem desta exigência.

\item {} 
Mencione na Página de Título o nome do editor da Versão Modificada, como seu editor.

\item {} 
Preserve todas as notas de direitos autorais (copyright) do Documento.

\item {} 
Adicione uma nota apropriada de direitos autorais para suas modificações, adjacente às outras notas de direitos autorais.

\item {} 
Inclua, imediatamente após as notas de direitos autorais, uma nota de licença dando ao público permissão para usar a Versão Modificada sob os termos desta Licença, na forma mostrada no Adendo abaixo.

\item {} 
Preserve naquela nota de licença a lista completa de Seções Invariantes e Textos de Capa requeridos dados na nota de licença do Documento.

\item {} 
Inclua uma cópia inalterada desta Licença.

\item {} 
Preserve a seção intitulada ``Histórico'', preserve seu título, e adicione a esta um item mencionando pelo menos o título, ano, novos autores, e editor da Versão Modificada conforme incluído na Página de Título. Se não houver uma seção intitulada ``Histórico'' no Documento, crie uma mencionando o título, ano, autores e editor do Documento como mostrado na Página de Título, em seguida adicione um item descrevendo a Versão Modificada como mencionado na sentença anterior.

\item {} 
Preserve o endereço de rede, se algum, dado no Documento para acesso público a uma cópia Transparente deste e, da mesma maneira, os endereços de rede dados no Documento para versões prévias nas quais este se baseia. Estes podem ser colocados na seção ``Histórico''. Você pode omitir um endereço de rede para um trabalho que foi publicado pelo menos quatro anos antes do Documento em si, ou se o editor original da versão à qual o endereço se refere der permissão.

\item {} 
Para qualquer seção intitulada ``Agradecimentos'' ou ``Dedicatória'', preserve o título da seção, e preserve dentro da seção toda a substância e tom de cada um dos agradecimentos e/ou dedicatórias lá mencionados.

\item {} 
Preserve todas as Seções Invariantes do Documento, inalteradas no seu texto e títulos. Números de seção ou o equivalente não são considerados parte dos títulos das seções.

\item {} 
Apague qualquer seção intitulada ``Apoio''. Tal seção não ser incluída na Versão Modificada.

\item {} 
Não modifique o título de qualquer seção a ser intitulada ``Apoio'' ou que resulte em conflito com título de qualquer Seção Invariante.

\item {} 
Preserve any Warranty Disclaimers.

\end{enumerate}

Se a Versão Modificada incluir novas seções iniciais ou apêndices que sejam qualificados como Seções Secundárias, e não contiver material copiado do Documento, você pode, a seu critério, tornar algumas dessas ou todas essas seções em invariantes. Para fazer isso, adicione seus títulos à lista de Seções Invariantes na nota de licença da Versão Modificada. Estes títulos devem ser distintos de quaisquer outros títulos de seções.

Você pode incluir uma seção intitulada ``Apoio'', dado que ela contenha nada além de apoio recebido para sua Versão Modificada por várias fontes -- por exemplo, notas do revisor ou de que o texto foi aprovado por uma organização como a definição autoritativa de um padrão.

Você pode adicionar uma passagem de até cinco palavras como Texto de Capa Frontal, e uma passagem de até 25 palavras como Texto de Quarta Capa, ao fim da lista de Textos de Capa na Versão Modificada. Somente uma passagem de Texto de Capa Frontal e uma de Texto de Quarta Capa pode ser adicionado por (ou através de arranjos feitos por) uma entidade qualquer. Se o Documento já incluir um texto de capa para a mesma capa, previamente incluído por você ou por arranjo feito pela mesma entidade em cujo nome você está agindo, você não pode adicionar outro; mas você pode substituir o antigo, com permissão explícita do editor anterior, que o incluiu.

O(s) autor(es) e editor(es) do Documento, por esta Licença, não dão permissão para seus nomes serem usados para publicidade ou defesa ou apoio implícito para qualquer Versão Modificada.

\textbf{5. COMBINING DOCUMENTS}

Você pode combinar o documento com outros documentos publicados sob esta Licença, sob os termos definidos na seção 4 acima para versões modificadas, desde que você inclua na combinação todas as Seções Invariantes de todos os documentos originais, sem modificações, e as liste como Seções Invariantes de seu trabalho combinado, na sua nota de licença, e que você preserve todas as Notas de Garantia.

O trabalho combinado somente precisa conter uma cópia desta Licença, e múltiplas Seções Invariantes idênticas podem ser substituídas por uma única cópia. Se houver múltiplas Seções Invariantes com o mesmo nome, porém com conteúdos diferentes, torne o título de cada uma destas seções único, adicionando ao fim dele, entre parênteses, o nome do autor ou editor original desta seção, se conhecido, ou então um número único. Faça o mesmo ajuste nos títulos de seção na lista de Seções Invariantes na nota de licença do trabalho combinado.

Na combinação, você deve combinar quaisquer seções intituladas ``Histórico'' nos vários documentos originais, formando uma seção intitulada ``Histórico''; do mesmo modo, combine quaisquer seções intituladas ``Agradecimentos'', e quaisquer seções intituladas ``Dedicatória''. Você deve apagar todas as seções intituladas ``Apoio''.

\textbf{6. COLLECTIONS OF DOCUMENTS}

Você pode fazer uma coleção consistindo do Documento e outros documentos publicados sob esta Licença, e substituir as cópias individuais desta Licença, nos vários documentos, por uma única cópia a ser incluída na coleção, desde que você siga as regras desta Licença para cópias literais de cada documento em todos os outros aspectos.

Você pode extrair um único documento desta coleção, e distribuí-lo individualmente sob esta Licença, desde que você insira uma cópia desta Licença no documento extraído, e siga esta Licença em todos os outros aspectos com relação à cópia literal do documento.

\textbf{7. AGGREGATION WITH INDEPENDENT WORKS}

Uma compilação do Documento ou seus derivados com outros documentos ou trabalhos separados e independentes, dentro de ou junto a um volume de um meio de armazenagem ou distribuição, configura um ``agregado'' se os direitos autorais resultantes da compilação não forem usados para limitar os direitos legais dos usuários desta além do que os trabalhos individuais permitem. Quando o Documento é incluído em um agregado, esta Licença não se aplica aos outros trabalhos no agregado que não forem, por sua vez, derivados do Documento.

Se o requerimento do Texto de Capa da seção 3 for aplicável a estas cópias do documento, então, se o Documento for menor que metade do agregado inteiro, os Textos de Capa do Documento podem ser colocados em capas que encerrem o Documento dentro do agregado, ou o equivalente eletrônico das capas se o Documento estiver em formato eletrônico. Do contrário, eles devem aparecer como capas impressas que envolvam o agregado inteiro.

\textbf{8. TRANSLATION}

Uma tradução é considerada como sendo um tipo de modificação, então você pode distribuir traduções do Documento sob os termos da seção 4. A substituição de Seções Invariantes por traduções requer permissão especial dos detentores dos direitos autorais, embora você possa incluir traduções de algumas ou todas as Seções Invariantes juntamente às versões originais destas. Você pode incluir uma tradução desta Licença, e todas as notas de licença no Documento, e qualquer Nota de Garantia, desde que você também inclua a versão original em Inglês desta Licença e as versões originais das notas de licença e garantia. Em caso de discordância entre a tradução e a versão original desta Licença ou nota de licença ou garantia, a versão original prevalecerá.

Se uma seção no Documento for intitulada ``Agradecimentos'', ``Dedicatória'', ou ``Histórico'', o requerimento (seção 4) de Preservar seu Título (seção 1) tipicamente exigirá a mudança do título em si.

\textbf{9. TERMINATION}

Você não pode copiar, modifica, sub-licenciar, ou distribuir o Documento à exceção do modo expressamente provido por esta Licença. Qualquer outra tentativa de copiar, modificar, sub-licenciar ou distribuir o Documento é anulada, e implicará em término automático de seus direitos sob esta Licença.

However, if you cease all violation of this License, then your license
from a particular copyright holder is reinstated (a) provisionally,
unless and until the copyright holder explicitly and finally
terminates your license, and (b) permanently, if the copyright holder
fails to notify you of the violation by some reasonable means prior to
60 days after the cessation.

Além disso, sua licença de um detentor dos direitos autorais é permanentemente reinstalada se o detentor nofiticar você da violação por motivos razoáveis, esta é a primeira vez que você recebeu noticias da violação desta licença de qualquer detentor e você remedia a violaçao anteriormente a 30 dias após ter recebido a notícia.

O término dos seus direitos sobre esta seção nao finaliza a licença de partes que receberam cópias de você sobre esta licença. Se seus direitos terminaram a não foram permanentemente reinstalados, o recebimento de uma cópia ou parte do mesmo material nao dá a você o direito de usá-lo.

\textbf{10. FUTURAS REVISÕES DESTA LICENÇA}

A Fundação do Software Livre pode publicar novas, revisadas versões do GNU de tempos em tempos. A nova versão será similar a presente versão, mas pode diferir em detalhes para encaminhar novos problemas ou preocupações. Veja \href{http://www.gnu.org/copyleft/}{http://www.gnu.org/copyleft/}.

Para cada versão da Licença é dado um número de versão distinto. Se o Documento especificar que uma versão particular desta Licença ``ou qualquer versão posterior'' se aplica a ele, você tem a opção de seguir os termos e condições tanto daquela versão específica, ou de qualquer versão posterior que tenha sido publicada (não como um rascunho) pela Free Software Foundation. Se o Documento não especificar um número de versão desta Licença, você pode escolher qualquer versão já publicada (não como rascunho) pela Free Software Foundation. Se o Documento especificar que um procurador pode decidir quais versões futuras desta licença pode ser usada, uma afirmação pública do procurador de aceitação de uma versão permanentemente autoriza você a escolher essa versão para o documento.

\textbf{11. RELICENCIAMENTO}

``Massive Multiauthor Collaboration Site'' (ou ``Site MMC'') significa que qualquer servidor da World Wide Web que publica trabalhos protegidos por direitos autorais e também oferece facilidades importantes para qualquer pessoa para editar essas obras. Um wiki público que qualquer um pode editar, está um exemplo de um servidor. A ``Massive Multiauthor Collaboration'' (ou ``MMC'') contidos no site significa que qualquer conjunto de trabalhos protegidos por direitos autorais, assim, publicado no site da MMC.

``CC-BY-SA'' significa Creative Commons Attribution-Share Alike 3.0 publicado pela Creative Commons Corporation, uma corporação sem fins lucrativos com sede principal em San Francisco, Califórnia, bem como futuras versões de copyleft da licença publicada pela mesma organização.

``Incorporar''significa publicar ou republicar um Documento, por inteiro ou em partes, como parte de outro documento.

O MMC é ``elegível para um novo licenciamento'' se está licenciado sob esta Licença, e se todas as obras que foram publicadas pela primeira vez sob esta licença em outro lugar que este MMC e, posteriormente, incorporadas no todo ou em parte para o MMC, (1) não tinha textos cobertos ou seções invariantes, e (2) foram assim incorporados antes de 1 de novembro de 2008.

O operador de um site MMC pode republicar uma MMC contido no site sob CC-BY-SA no mesmo local, a qualquer momento, antes de 1 de agosto de 2009, desde que o MMC é elegível para um novo licenciamento.

\textbf{ADDENDUM: Como usar esta Licença em seus documentos}

Para usar esta Licença num documento que você escreveu, inclua uma cópia da Licença no documento e ponha as seguintes notas de copyright e licenças logo após a página de título:
\begin{quote}

Copyright © ANO  SEU NOME. É concedida permissão para copiar, distribuir e / ou modificar este documento sob os termos da GNU Free Documentation License, Versão 1.3 ou qualquer versão posterior publicada pela Free Software Foundation; sem Secções Invariantes, sem Textos de Capa Frontal, e sem volta Textos de Capa. Uma cópia da licença é incluída na seção intitulada ``GNU Free Documentation License''.
\end{quote}

Se você tiver Seções Invariantes, Textos de Capa Frontal e Textos de Capa Traseira, substitua a linha''com ... Textos'' por esta:
\begin{quote}

com as Seções Invariantes sendo LISTA SEUS TÍTULOS, com os Textos de Capa sendo LISTA, e com os textos de Contra-Capa sendo LISTA.
\end{quote}

Se você tiver Seções Invariantes, sem Textos de Capa, ou alguma outra combinação dos três, mesclar essas duas alternativas para se adequar a situação.

Se o documento contiver exemplos não triviais de código de programas, nós recomendamos a publicação desses exemplos em paralelo sob a sua escolha de licença de software livre, como a GNU General Public License, para permitir seu uso em software livre.


\chapter{Referências Bibliográficas e Web}
\label{docs/user_manual/literature_web/literature_and_web_references::doc}\label{docs/user_manual/literature_web/literature_and_web_references:literature-and-web-references}\label{docs/user_manual/literature_web/literature_and_web_references:literature-and-web}
GDAL-SOFTWARE-SUITE. Geospatial data abstraction library. htt://www.gdal.org, 2012.

GRASS-PROJECT. Geographic ressource analysis support system. \href{http://grass.osgeo.org}{http://grass.osgeo.org} , 2012.

MITCHELL, T. Web mapping illustrated, 2005.

NETELER, M., AND MITASOVA, H. Open source gis: A grass gis approach, 2008.

OGR-SOFTWARE-SUITE. Geospatial data abstraction library. \href{http://www.gdal.org/ogr}{http://www.gdal.org/ogr} , 2012.

OPEN-GEOSPATIAL-CONSORTIUM. Web map service (1.1.1) implementation specification. \href{http://portal.opengeospatial.org}{http://portal.opengeospatial.org}, 2002.

OPEN-GEOSPATIAL-CONSORTIUM. Web map service (1.3.0) implementation specification. \href{http://portal.opengeospatial.org}{http://portal.opengeospatial.org}, 2004.

POSTGIS-PROJECT. Spatial support for postgresql. \href{http://postgis.refractions.net/}{http://postgis.refractions.net/} , 2012.



\renewcommand{\indexname}{Índice}
\printindex
\end{document}
