Interface

Arquivo

i3geo/classesjs/classe_interface.js

Licenca

GPL2

I3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet

Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation; tanto a versão 2 da Licença. Este programa é distribuído na expectativa de que seja útil, porém, SEM NENHUMA GARANTIA; nem mesmo a garantia implícita de COMERCIABILIDADE OU ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA. Consulte a Licença Pública Geral do GNU para mais detalhes. Você deve ter recebido uma cópia da Licença Pública Geral do GNU junto com este programa; se não, escreva para a Free Software Foundation, Inc., no endereço 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA.

Summary

Interface	i3geo/classesjs/classe_interface.js
i3GEO. Interface	Funcoes que controlam o comportamento específico de determinadas interfaces
Propriedades
OUTPUTFORMAT	Formato de geração da imagem.
BARRABOTOESTOP	Distância da barra de botões em ralação ao topo do mapa.
BARRABOTOESLEFT	Distância da barra de botões em ralação ao lado esquerdo do mapa.
ATUAL	Interface atual em uso.
IDCORPO	ID do elemento HTML que receberá o corpo do mapa
ATIVAMENUCONTEXTO	Indica se o menu de contexto deve ser ativado
Variaveis
IDMAPA	ID do elemento HTML criado para conter o mapa
STATUS	Indica o status atual do mapa.
Functions
redesenha	Aplica o método redesenha da interface atual
atualizaTema	Aplica o método atualizaTema da interface atual
adicionaKml	Aplica o método de adição de kml ao mapa conforme a interface atual
cria	Cria ou altera os elementos HTML necessários para a interface
inicia	Inicia a interface
alteraLayers	Altera todos os layers do mapa modificando um determinado parâmetro
ativaBotoes	Ativa os botões de ferramentas
i3GEO. Interface. padrao	Interface padrão com motor de navegação do próprio i3Geo
Propriedades
TRANSICAO	Ativa ou não o modo de transição suave das imagens quando o mapa é redesenhado.
Functions
ativaMenuContexto	Ativa o menu de contexto acionado com o botão direito do mouse
i3GEO. Interface. flamingo	Interface com motor de navegação baseado no software Flamingo Map Components (flash)
i3GEO. Interface. openlayers	Interface com motor de navegação baseado na API OpenLayers
Propriedades
TILES	Indica se será utilizado o modo de navegação em tiles
BUFFER	Número de TILES na área não visível do mapa
GADGETS	Lista dos controles específicos da API do OpenLayers que serão inseridos ou não no mapa
MINEXTENT	Menor extensão geográfica que pode ser mostrada no mapa
MAXEXTENT	Maior extensão geográfica que pode ser mostrada no mapa
LAYERSADICIONAIS	Array com objetos do tipo LAYER que serão adicionados após a crioação de todos os layers default.
i3GEO. Interface. googlemaps	Interface com motor de navegação baseado na API Google Maps
Propriedades
OPACIDADE	Valor da opacidade da camada i3geo do mapa
TIPOMAPA	Tipo de mapa que será usado como default, conforme constantes definidas na API do Google Maps.
Functions
adicionaKml	Insere no mapa uma camada KML com base na API do Google Maps
adicionaNoArvoreGoogle	Acrescenta na árvore de camadas um novo tema no nó que mostra os arquivos KML inseridos no mapa
ativaDesativaCamadaKml	Ativa ou desativa uma camada do nó de layers KML
i3GEO. Interface. googleearth	Interface com motor de navegação baseado na API Google Earth
Propriedades
GADGETS	Lista dos controles específicos da API do Google Earth que serão inseridos ou não no mapa
Functions
adicionaKml	Insere no mapa uma camada KML com base na API do Google Earth
adicionaNoArvoreGoogle	Acrescenta na árvore de camadas um novo tema no nó que mostra os arquivos KML inseridos no mapa
ativaDesativaCamadaKml	Ativa ou desativa uma camada do nó de layers KML

i3GEO. Interface

Funcoes que controlam o comportamento específico de determinadas interfaces

As interfaces são definidas na inicialização do i3Geo, por exemplo, openlayers, flamingo,etc

A classe “interface” contém os métdos específicos utilizados nessas interfaces

Exemplo

Para iniciar o i3geo com uma interface específica, utilize http://localhost- /i3geo- /ms_criamapa.php?interface=flamingo.htm O HTML deve conter as definições da interface criada e deve estar armazenado em i3geo/aplicmap

Summary

Propriedades
OUTPUTFORMAT	Formato de geração da imagem.
BARRABOTOESTOP	Distância da barra de botões em ralação ao topo do mapa.
BARRABOTOESLEFT	Distância da barra de botões em ralação ao lado esquerdo do mapa.
ATUAL	Interface atual em uso.
IDCORPO	ID do elemento HTML que receberá o corpo do mapa
ATIVAMENUCONTEXTO	Indica se o menu de contexto deve ser ativado
Variaveis
IDMAPA	ID do elemento HTML criado para conter o mapa
STATUS	Indica o status atual do mapa.
Functions
redesenha	Aplica o método redesenha da interface atual
atualizaTema	Aplica o método atualizaTema da interface atual
adicionaKml	Aplica o método de adição de kml ao mapa conforme a interface atual
cria	Cria ou altera os elementos HTML necessários para a interface
inicia	Inicia a interface
alteraLayers	Altera todos os layers do mapa modificando um determinado parâmetro
ativaBotoes	Ativa os botões de ferramentas

Propriedades

OUTPUTFORMAT

Formato de geração da imagem.

Os formatos devem estar definidos no mapfile geral1windows.map e geral1.map. A definição dessa variável não afeta a interface padrão, que utiliza a definição que estiver ativa nos mapfiles de inicialização.

Tipo

{MAPSERVER OUTPUTFORMAT}

Default

{“AGG_Q”}

BARRABOTOESTOP

Distância da barra de botões em ralação ao topo do mapa.

Tipo

{number}

Default

{12}

BARRABOTOESLEFT

Distância da barra de botões em ralação ao lado esquerdo do mapa.

Tipo

{number}

Default

{3}

ATUAL

Interface atual em uso.

Tipo

{string}

Default

{“padrao”}

IDCORPO

ID do elemento HTML que receberá o corpo do mapa

Tipo

{string}

Default

{“corpoMapa”}

ATIVAMENUCONTEXTO

Indica se o menu de contexto deve ser ativado

Tipo

{Boolean}

Default

{true}

Variaveis

IDMAPA

ID do elemento HTML criado para conter o mapa

Esse elemento normalmente é criado dentro de IDCORPO dependendo da interface

STATUS

Indica o status atual do mapa.

É utilizado para verificar o status do mapa e bloquear ou não determinadas funções.

Por exemplo, na interface OpenLayers, identifica se as camadas estão sendo atualizadas

STATUS = { atualizando: new Array() //guarda os códigos dos layers que estão sendo redesenhados }

Functions

redesenha

redesenha: function()

Aplica o método redesenha da interface atual

atualizaTema

atualizaTema: function( retorno,
tema )

Aplica o método atualizaTema da interface atual

Parametros

retorno {JSON}	objeto JSON com os parâmetros obtidos da função PHP de redesenho do mapa
tema {string}	código do tema

adicionaKml

adicionaKml: function()

Aplica o método de adição de kml ao mapa conforme a interface atual

cria

cria: function( w,
h )

Cria ou altera os elementos HTML necessários para a interface

Essa função é executada na inicialização do i3geo

Parametros

w {Integer}	largura do corpo do mapa em pixels
h {Integer}	altura do corpo do mapa em pixels

inicia

inicia: function( w,
h )

Inicia a interface

alteraLayers

Altera todos os layers do mapa modificando um determinado parâmetro

ativaBotoes

ativaBotoes: function()

Ativa os botões de ferramentas

i3GEO. Interface. padrao

Interface padrão com motor de navegação do próprio i3Geo

Utilizado quando

i3GEO.Interface.ATUAL = “padrao”

Summary

Propriedades
TRANSICAO	Ativa ou não o modo de transição suave das imagens quando o mapa é redesenhado.
Functions
ativaMenuContexto	Ativa o menu de contexto acionado com o botão direito do mouse

Propriedades

TRANSICAO

Ativa ou não o modo de transição suave das imagens quando o mapa é redesenhado.

Default

true

Tipo

{Boolean}

Functions

ativaMenuContexto

ativaMenuContexto: function()

Ativa o menu de contexto acionado com o botão direito do mouse

i3GEO. Interface. flamingo

Interface com motor de navegação baseado no software Flamingo Map Components (flash)

Utilizado quando

i3GEO.Interface.ATUAL = “flamingo”

i3GEO. Interface. openlayers

Interface com motor de navegação baseado na API OpenLayers

Utilizado quando

i3GEO.Interface.ATUAL = “openlayers”

Cria o objeto i3geoOL que pode receber os métodos da API do OpenLayers

Para detalhes sobre a configuração da interface, veja i3geo/aplicmap/openlayers.htm

Summary

Propriedades
TILES	Indica se será utilizado o modo de navegação em tiles
BUFFER	Número de TILES na área não visível do mapa
GADGETS	Lista dos controles específicos da API do OpenLayers que serão inseridos ou não no mapa
MINEXTENT	Menor extensão geográfica que pode ser mostrada no mapa
MAXEXTENT	Maior extensão geográfica que pode ser mostrada no mapa
LAYERSADICIONAIS	Array com objetos do tipo LAYER que serão adicionados após a crioação de todos os layers default.

Propriedades

TILES

Indica se será utilizado o modo de navegação em tiles

Tipo

{boolean}

Default

{true}

BUFFER

Número de TILES na área não visível do mapa

Tipo

{integer}

Default

{0}

GADGETS

Lista dos controles específicos da API do OpenLayers que serão inseridos ou não no mapa

Tipo

{object}

Default

{PanZoomBar:true,LayerSwitcher:true,ScaleLine:true,OverviewMap:true}

MINEXTENT

Menor extensão geográfica que pode ser mostrada no mapa

Tipo

{array}

Default

{-0.001, -0.001, 0.001, 0.001]}

MAXEXTENT

Maior extensão geográfica que pode ser mostrada no mapa

Tipo

{array}

Default

{[-180, -90, 180, 90]}

LAYERSADICIONAIS

Array com objetos do tipo LAYER que serão adicionados após a crioação de todos os layers default.

Tipo

{array}

i3GEO. Interface. googlemaps

Interface com motor de navegação baseado na API Google Maps

Utilizado quando

i3GEO.Interface.ATUAL = “googlemaps”

Cria o objeto i3GeoMap que pode receber os métodos da API

Summary

Propriedades
OPACIDADE	Valor da opacidade da camada i3geo do mapa
TIPOMAPA	Tipo de mapa que será usado como default, conforme constantes definidas na API do Google Maps.
Functions
adicionaKml	Insere no mapa uma camada KML com base na API do Google Maps
adicionaNoArvoreGoogle	Acrescenta na árvore de camadas um novo tema no nó que mostra os arquivos KML inseridos no mapa
ativaDesativaCamadaKml	Ativa ou desativa uma camada do nó de layers KML

Propriedades

OPACIDADE

Valor da opacidade da camada i3geo do mapa

Varia de 0 a 1

Default

0.8

Tipo

{Numeric}

TIPOMAPA

Tipo de mapa que será usado como default, conforme constantes definidas na API do Google Maps.

Default

”G_PHYSICAL_MAP”

Tipo

{string

Google API constante GMapType “G_SATELLITE_MAP”|”G_PHYSICAL_MAP”|”G_HYBRID_MAP”}

Functions

adicionaKml

adicionaKml: function( pan,
url,
titulo,
ativo )

Insere no mapa uma camada KML com base na API do Google Maps

As camadas adicionadas são crescentadas na árvore de camadas

A lista de nomes dos objetos geoXml criados é mantida em i3GEO.mapas.GEOXML

Parametros

pan {Boolean}	define se o mapa será deslocado para encaixar o KML
url {String}	URL do arquivo KML. Se não for definido, a URL será obtida do INPUT com id = i3geo_urlkml (veja i3GEO.gadgets.mostraInserirKml)
titulo {string}	titulo que aparecerá na árvore. Se não for definido, será calculado aleatoriamente.
ativo {boolean}	indica se a camada estará ativa ou não. Se não for definido, será considerado como true

adicionaNoArvoreGoogle

adicionaNoArvoreGoogle: function( url,
nomeOverlay,
ativo,
id )

Acrescenta na árvore de camadas um novo tema no nó que mostra os arquivos KML inseridos no mapa

Os temas são incluídos em um nó chamado “Google Maps”.

Para obter esse nó utilize var node = i3GEO.arvoreDeCamadas.ARVORE.getNodeByProperty(“idkml”,”raiz”);

Parametros

url {string}	url do arquivo KML
nomeOverlay {string}	título do tema
ativo {boolean}	indica o estado do checkbox
id {string}	nome do objeto GGeoXml

ativaDesativaCamadaKml

ativaDesativaCamadaKml: function( obj )

Ativa ou desativa uma camada do nó de layers KML

Parametro

obj {object}

objeto do tipo checkbox que foi ativado/desativado

i3GEO. Interface. googleearth

Interface com motor de navegação baseado na API Google Earth

Utilizado quando

i3GEO.Interface.ATUAL = “googleearth”

Cria o objeto i3GeoMap que pode receber os métodos da API do google Earth

Summary

Propriedades
GADGETS	Lista dos controles específicos da API do Google Earth que serão inseridos ou não no mapa
Functions
adicionaKml	Insere no mapa uma camada KML com base na API do Google Earth
adicionaNoArvoreGoogle	Acrescenta na árvore de camadas um novo tema no nó que mostra os arquivos KML inseridos no mapa
ativaDesativaCamadaKml	Ativa ou desativa uma camada do nó de layers KML

Propriedades

GADGETS

Lista dos controles específicos da API do Google Earth que serão inseridos ou não no mapa

Tipo

{object}

Default

{}

Functions

adicionaKml

adicionaKml: function( pan,
url,
titulo,
ativo )

Insere no mapa uma camada KML com base na API do Google Earth

As camadas adicionadas são crescentadas na árvore de camadas

A lista de nomes dos objetos geoXml criados é mantida em i3GEO.mapas.GEOXML

Parametros

pan {Boolean}	define se o mapa será deslocado para encaixar o KML
url {String}	URL do arquivo KML. Se não for definido, a URL será obtida do INPUT com id = i3geo_urlkml (veja i3GEO.gadgets.mostraInserirKml)
titulo {string}	titulo que aparecerá na árvore. Se não for definido, será calculado aleatoriamente.
ativo {boolean}	indica se a camada estará ativa ou não. Se não for definido, será considerado como true

adicionaNoArvoreGoogle

adicionaNoArvoreGoogle: function( url,
nomeOverlay,
ativo,
id )

Acrescenta na árvore de camadas um novo tema no nó que mostra os arquivos KML inseridos no mapa

Os temas são incluídos em um nó chamado “Google Earth”.

Para obter esse nó utilize var node = i3GEO.arvoreDeCamadas.ARVORE.getNodeByProperty(“idkml”,”raiz”);

Parametros

url {string}	url do arquivo KML
nomeOverlay {string}	título do tema
ativo {boolean}	indica o estado do checkbox
id {string}	nome do objeto GGeoXml

ativaDesativaCamadaKml

ativaDesativaCamadaKml: function( obj )

Ativa ou desativa uma camada do nó de layers KML

Parametro

obj {object}

objeto do tipo checkbox que foi ativado/desativado