Gadgets (objetos marginais do mapa)

Summary
Gadgets (objetos marginais do mapa)
Arquivos
i3geo/ classesjs/ classe_gadgets.jsGPL2
i3GEO. gadgetsInclui elementos especiais no mapa
Propriedades
PARAMETROSParametros de inicialização dos gadgets.
Functions
mostraEmailMostra o e-mail armazenado na variável i3GEO.parametros.emailInstituicao
mostraVersaoMostra a versão atual do i3Geo armazenada na variável i3GEO.parametros.mensageminicial
mostraCoordenadasUTM (depreciado utilize i3GEO. coordenadas)
mostraCoordenadasGEO (depreciado utilize i3GEO. coordenadas)
mostraInserirKmlMostra no mapa a a opção para inserir kml.
mostraEscalaNumericaMostra no mapa a escala numérica.
mostraEscalaGraficaMostra no mapa a escala grafica como um elemento fora do mapa.
mostraBuscaRapidaMostra a opção de busca rápida de lugares por palavra digitada.
mostraHistoricoZoomMostra na barra de zoom os ícones que controlam a visualização do histórico da navegação sobre o mapa
i3GEO. gadgets. visualGera os ícones e controla as opções de modificação do visual do mapa.
Functions
iniciaConstrói os ícones de escolha do visual.
trocaTroca o visual atual.
i3GEO. gadgets. quadrosCria e controla o funcionamento dos quadros de animação.
Variaveis
quadrosfilmeArmazena cada quadro individualmente com as suas propriedades
quadroatualValor do índice do quadro atual
Propriedades
geraLegendaGera ou não a legenda quando o mapa é redesenhado.
Functions
iniciaGera os quadros e inicializa os objetos para armazenar as imagens
gravaArmazena um determinado valor em uma determinada característica de um objeto quadro.
avancaAvança um quadro na lista de quadros, mudando a imagem utilizada na sua representação.
zoomAplica o zoom no mapa para a extensão geográfica armazenada em um quadro
trocaMapaTroca a imagem do mapa atual pela que estiver armazenada em quadro
opcoesAbre a janela de opções que controla as características do quado e permite disparar a animação.
animaMostra as imagens armazenadas nos quadros em uma sequência animada
listaImagensLista as imagens armazenadas em uma nova página no navegador
mostraMenuSuspensoMostra o menu suspenso com opções extras de análise, ajuda, etc
mostraMenuListaMostra as opções existentes no menu suspenso porém na forma de uma lista de opções

Arquivos

i3geo/ classesjs/ classe_gadgets.js

Licenca

GPL2

I3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet

Direitos Autorais Reservados © 2006 Ministério do Meio Ambiente Brasil Desenvolvedor: Edmar Moretti edmar..nosp@m.moretti@mma.g.nosp@m.ov.br

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;

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.

i3GEO. gadgets

Inclui elementos especiais no mapa

Os elementos são opcionais e adicionam funcionalidades ao mapa.

Outras funcionalidades são definidas em botões.  Veja <classe_configura.js>

Summary
Propriedades
PARAMETROSParametros de inicialização dos gadgets.
Functions
mostraEmailMostra o e-mail armazenado na variável i3GEO.parametros.emailInstituicao
mostraVersaoMostra a versão atual do i3Geo armazenada na variável i3GEO.parametros.mensageminicial
mostraCoordenadasUTM (depreciado utilize i3GEO. coordenadas)
mostraCoordenadasGEO (depreciado utilize i3GEO. coordenadas)
mostraInserirKmlMostra no mapa a a opção para inserir kml.
mostraEscalaNumericaMostra no mapa a escala numérica.
mostraEscalaGraficaMostra no mapa a escala grafica como um elemento fora do mapa.
mostraBuscaRapidaMostra a opção de busca rápida de lugares por palavra digitada.
mostraHistoricoZoomMostra na barra de zoom os ícones que controlam a visualização do histórico da navegação sobre o mapa

Propriedades

PARAMETROS

Parametros de inicialização dos gadgets.

Essa variável define os parâmetros individuais de cada gadget e o ID do elemento HTML onde

  • gadget será incluído.

Você pode acessar os parâmetros da seguinte forma

i3GEO.gadgets.PARAMETROS.mostraMenuSuspenso.deslocaEsquerda = 400;

Para evitar o funcionamento de um gadget experimente utilizar o seguinte exemplo

i3GEO.gadgets.PARAMETROS.mostraInserirKml.idhtml = “”;

Default

i3GEO.gadgets.PARAMETROS = {

”mostraInserirKml”

{idhtml:”inserirKml”},

”mostraEscalaNumerica”

{idhtml:”escala”},

”mostraEscalaGrafica”

{idhtml:”escalaGrafica”},

”mostraBuscaRapida”

{idhtml:”buscaRapida”,servicosexternos:true,temasmapa:false},

”mostraVisual”

{idhtml:”visual”},

”mostraQuadros”

{idhtml:”lugarquadros”},

”mostraHistoricoZoom”

{idhtml:”historicozoom”},

”mostraMenuSuspenso”

{idhtml:”menus”,deslocaEsquerda:0,finaliza:””},

”mostraMenuLista”

{idhtml:”menuLista”},

”mostraVersao”

{idhtml:”versaoi3geo”},

”mostraEmail”

{idhtml:”emailInstituicao”} }

Tipo

{JSON}

Functions

mostraEmail

mostraEmail: function(id)

Mostra o e-mail armazenado na variável i3GEO.parametros.emailInstituicao

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS

mostraVersao

mostraVersao: function(id)

Mostra a versão atual do i3Geo armazenada na variável i3GEO.parametros.mensageminicial

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS

mostraCoordenadasUTM (depreciado utilize i3GEO. coordenadas)

mostraCoordenadasUTM: function(id)

mostraCoordenadasGEO (depreciado utilize i3GEO. coordenadas)

mostraCoordenadasGEO: function(id)

mostraInserirKml

mostraInserirKml: function(id)

Mostra no mapa a a opção para inserir kml.

Essa opção só funciona com a API do Google carregada

Se você não quer essa função no mapa, elimine o elemento HTML existente no mapa que contenha o id definido em i3GEO.gadgets.PARAMETROS.mostraInserirKml.idhtml

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS.mostraInserirKml.idhtml

mostraEscalaNumerica

mostraEscalaNumerica: function(id)

Mostra no mapa a escala numérica.

A escala numérica pode ser alterada pelo usuário digitando-se a nova escala.

Se você não quer essa função no mapa, elimine o elemento HTML existente no mapa que contenha o id definido em i3GEO.gadgets.PARAMETROS

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS

mostraEscalaGrafica

mostraEscalaGrafica: function(id)

Mostra no mapa a escala grafica como um elemento fora do mapa.

Se você não quer essa função no mapa, elimine o elemento HTML existente no mapa que contenha o id definido em i3GEO.gadgets.PARAMETROS(escala)

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS

mostraBuscaRapida

mostraBuscaRapida: function(id)

Mostra a opção de busca rápida de lugares por palavra digitada.

Se você não quer essa função no mapa, elimine o elemento HTML existente no mapa que contenha o id definido em i3GEO.gadgets.PARAMETROS (buscaRapida)

Onde a busca será feita é controlado pela variável i3GEO.gadgets.PARAMETROS.mostraBuscaRapida

Veja: ferramentas/<buscarapida>

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS

mostraHistoricoZoom

mostraHistoricoZoom: function(id)

Mostra na barra de zoom os ícones que controlam a visualização do histórico da navegação sobre o mapa

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS

i3GEO. gadgets. visual

Gera os ícones e controla as opções de modificação do visual do mapa.

O visual consiste na definição dos ícones utilizados no mapa.  O visual pode ser modificado na inicialização ou então escolhido pelo usuário.

Os visuais disponíveis são definidos no servidor e consistem em diretórios localizados em i3geo/imagens/visual.  A lista de visuais disponíveis é obtida na inicialização do i3geo.

Os ícones para mudança do visual são incluídos no elemento HTML definido em i3geo.gadgets.PARAMETROS.visual

Summary
Functions
iniciaConstrói os ícones de escolha do visual.
trocaTroca o visual atual.

Functions

inicia

inicia: function(id)

Constrói os ícones de escolha do visual.

Parametro

id {String}id do elemento que receberá os ícones (opcional)

troca

troca: function(visual)

Troca o visual atual.  A lista de visuais disponíveis é obtida em i3GEO.parametros.listavisual

Parametro

visual {String}nome do visual que será utilizado.

i3GEO. gadgets. quadros

Cria e controla o funcionamento dos quadros de animação.

Os quadros são mostrados no mapa como uma sequência de quadros de um filme.  As imagens que são produzidas no mapa são armazenadas em cada quadro, permitindo sua recuperação.

Os quadros armazenam também a extensão geográfica de cada imagem, permitindo sua recuperação.

Summary
Variaveis
quadrosfilmeArmazena cada quadro individualmente com as suas propriedades
quadroatualValor do índice do quadro atual
Propriedades
geraLegendaGera ou não a legenda quando o mapa é redesenhado.
Functions
iniciaGera os quadros e inicializa os objetos para armazenar as imagens
gravaArmazena um determinado valor em uma determinada característica de um objeto quadro.
avancaAvança um quadro na lista de quadros, mudando a imagem utilizada na sua representação.
zoomAplica o zoom no mapa para a extensão geográfica armazenada em um quadro
trocaMapaTroca a imagem do mapa atual pela que estiver armazenada em quadro
opcoesAbre a janela de opções que controla as características do quado e permite disparar a animação.
animaMostra as imagens armazenadas nos quadros em uma sequência animada
listaImagensLista as imagens armazenadas em uma nova página no navegador
mostraMenuSuspensoMostra o menu suspenso com opções extras de análise, ajuda, etc
mostraMenuListaMostra as opções existentes no menu suspenso porém na forma de uma lista de opções

Variaveis

quadrosfilme

Armazena cada quadro individualmente com as suas propriedades

Tipo

{Array}

quadroatual

Valor do índice do quadro atual

Tipo

{Integer}

Propriedades

geraLegenda

Gera ou não a legenda quando o mapa é redesenhado.  Ativando essa opção, o i3Geo fica um pouco mais lento

Type

{boolean}

Default

{false}

Functions

inicia

inicia: function(qs,
lugarquadros)

Gera os quadros e inicializa os objetos para armazenar as imagens

Parametros

qs {Integer}número de quadros
lugarquadros {String}id do elemento HTML que receberá os quadros (opcional)

grava

grava: function(variavel,
valor)

Armazena um determinado valor em uma determinada característica de um objeto quadro.

Parametros

variavel {String}parâmetro do objeto quadro.
valor{String} valor que será aplicado.

avanca

avanca: function()

Avança um quadro na lista de quadros, mudando a imagem utilizada na sua representação.

zoom

zoom: function(quadro)

Aplica o zoom no mapa para a extensão geográfica armazenada em um quadro

Parametro

quadro {String}id do quadro que será utilizado

trocaMapa

trocaMapa: function(quadro)

Troca a imagem do mapa atual pela que estiver armazenada em quadro

A imagem mostrada no mapa é um clone do mapa atual, preservando o mapa.

Parametro

quadro {String}id do quadro que terá a imagem recuperada

opcoes

opcoes: function(obj)

Abre a janela de opções que controla as características do quado e permite disparar a animação.

Parametro

obj {Object}objeto clicado

anima

anima: function(Qanima,
t)

Mostra as imagens armazenadas nos quadros em uma sequência animada

Parametros

Qanima {Integer}quadro atual na sequência de animação
t {Numeric}tempo em milisegundos entre cada quadro

listaImagens

listaImagens: function()

Lista as imagens armazenadas em uma nova página no navegador

mostraMenuSuspenso

mostraMenuSuspenso: function(id)

Mostra o menu suspenso com opções extras de análise, ajuda, etc

Paradefinir os ícones existentes nos elementos principais do menu, edite o arquivo i3geo/css/botoes2.css e acrescente

  • estilo desejado.  Utilize # para se referenciar ao elemento, cujo identificador é composto por “menu”+chave, exemplo #menuinterface ou #menuajuda

O objeto YAHOO.widget.MenuBar resultante pode ser obtido na variável i3GEOoMenuBar

i3GEOoMenuBar pode ser manipulado com os métodos da biblioteca YUI, por exemplo, i3GEOoMenuBar.getMenuItem(“omenudataInterface1”).cfg.setProperty(“text”, “ “);

Para executar uma operação após o menu ser montado, utilize a propriedade i3GEO.gadgets.PARAMETROS.mostraMenuSuspenso.finaliza, por exemplo (a string é executada por meio da função eval do javascript)

i3GEO.gadgets.PARAMETROS.mostraMenuSuspenso.finaliza = ‘i3GEOoMenuBar.getMenuItem(“omenudataInterface1”).cfg.setProperty(“text”, “ “);’

O conteúdo do menu é baseado na variável i3GEO.configura.oMenuData

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS

mostraMenuLista

mostraMenuLista: function(id)

Mostra as opções existentes no menu suspenso porém na forma de uma lista de opções

O conteúdo do menu é baseado na variável i3GEO.configura.oMenuData

Parametro

id {String}id do elemento HTML que receberá o resultado.  Esse id por default é obtido de i3GEO.gadgets.PARAMETROS
mostraEmail: function(id)
Mostra o e-mail armazenado na variável i3GEO.parametros.emailInstituicao
mostraVersao: function(id)
Mostra a versão atual do i3Geo armazenada na variável i3GEO.parametros.mensageminicial
mostraCoordenadasUTM: function(id)
mostraCoordenadasGEO: function(id)
mostraInserirKml: function(id)
Mostra no mapa a a opção para inserir kml.
mostraEscalaNumerica: function(id)
Mostra no mapa a escala numérica.
mostraEscalaGrafica: function(id)
Mostra no mapa a escala grafica como um elemento fora do mapa.
mostraBuscaRapida: function(id)
Mostra a opção de busca rápida de lugares por palavra digitada.
mostraHistoricoZoom: function(id)
Mostra na barra de zoom os ícones que controlam a visualização do histórico da navegação sobre o mapa
inicia: function(id)
Constrói os ícones de escolha do visual.
troca: function(visual)
Troca o visual atual.
inicia: function(qs,
lugarquadros)
Gera os quadros e inicializa os objetos para armazenar as imagens
grava: function(variavel,
valor)
Armazena um determinado valor em uma determinada característica de um objeto quadro.
avanca: function()
Avança um quadro na lista de quadros, mudando a imagem utilizada na sua representação.
zoom: function(quadro)
Aplica o zoom no mapa para a extensão geográfica armazenada em um quadro
trocaMapa: function(quadro)
Troca a imagem do mapa atual pela que estiver armazenada em quadro
opcoes: function(obj)
Abre a janela de opções que controla as características do quado e permite disparar a animação.
anima: function(Qanima,
t)
Mostra as imagens armazenadas nos quadros em uma sequência animada
listaImagens: function()
Lista as imagens armazenadas em uma nova página no navegador
mostraMenuSuspenso: function(id)
Mostra o menu suspenso com opções extras de análise, ajuda, etc
mostraMenuLista: function(id)
Mostra as opções existentes no menu suspenso porém na forma de uma lista de opções