i3geo/classesjs/classe_i3geo.js
GPL2
i3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet
Direitos Autorais Reservados © 2006 Ministério do Meio Ambiente Brasil Desenvolvedor: Edmar Moretti edmar.moretti@gmail.com
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 ADEQUACÃ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 | i3geo/classesjs/classe_i3geo.js |
| i3GEOF | Esse objeto recebe os métodos sob demanda por meio de injeção de javascripts (script tag). |
| i3GEO | A classe i3GEO possuí os métodos de criação e atualização do mapa. |
| Propriedades | |
| parametros | Parametros obtidos do mapa atual. |
| scrollerWidth | Largura da barra de rolagem do navegador. |
| finaliza | Função que será executada após a criação e posicionamento do mapa. |
| finalizaAPI | Função que será executada após a API utilizada (Openlayers ou Googlemaps) ter sido inicializada e o objeto com o mapa ter sido criado. |
| Variaveis | |
| tamanhodoc | Largura e altura do navegador após a inicialização do mapa |
| temaAtivo | Indica o último tema que foi ativado no mapa |
| contadorAtualiza | Essa variável é um contador utilizado para indicar quantos processos estão ativos e que irão executar o redesenho do mapa. |
| Functions | |
| cria | Cria e configura a visualização do mapa, definindo posicionamentos, tamanho etc |
| inicia | Inicializa o mapa |
| aposIniciar | Executa operações após o mapa ter sido posicionado na tela |
| atualiza | Atualiza o mapa atual, altera a imagem do mapa os gadgets ativos e os parametros e verifica a integridade do mapa em uso (arquivo mapfile) |
| calculaTamanho | Calcula o tamanho do mapa atual e define alguns elementos HTML do mapa |
| reCalculaTamanho | Recalcula o tamanho do mapa com base nas configurações do navegador |
| atualizaParametros | Atualiza os valores da variável i3GEO.parametros |
A classe i3GEO possuí os métodos de criação e atualização do mapa. Todas as subclasses são baseadas em i3GEO, por exemplo, para criar uma janela flutuante sobre o mapa, utilize i3GEO.janela.cria()
Para inicializar o mapa, utilize i3GEO.inicia() e para atualizar o mapa, utilize i3GEO.atualiza(). Após terminado o processo de inicialização, pode-se executar uma função de ajuste. Essa função deve ser definida em i3GEO.finaliza, por exemplo i3GEO.finaliza = “funcaoDeAjuste()” ou i3GEO.finaliza = function(){}
Ao inicializar ou atualizar o i3Geo, é feita uma chamada em AJAX para a obtenção dos parametros necessários ao funcionamento do mapa. Esses parametros são armazenados na variável i3GEO.parametros
Nessa classe estão disponíveis variáveis internas utilizadas em várias funções, como i3GEO.temaAtivo
| Propriedades | |
| parametros | Parametros obtidos do mapa atual. |
| scrollerWidth | Largura da barra de rolagem do navegador. |
| finaliza | Função que será executada após a criação e posicionamento do mapa. |
| finalizaAPI | Função que será executada após a API utilizada (Openlayers ou Googlemaps) ter sido inicializada e o objeto com o mapa ter sido criado. |
| Variaveis | |
| tamanhodoc | Largura e altura do navegador após a inicialização do mapa |
| temaAtivo | Indica o último tema que foi ativado no mapa |
| contadorAtualiza | Essa variável é um contador utilizado para indicar quantos processos estão ativos e que irão executar o redesenho do mapa. |
| Functions | |
| cria | Cria e configura a visualização do mapa, definindo posicionamentos, tamanho etc |
| inicia | Inicializa o mapa |
| aposIniciar | Executa operações após o mapa ter sido posicionado na tela |
| atualiza | Atualiza o mapa atual, altera a imagem do mapa os gadgets ativos e os parametros e verifica a integridade do mapa em uso (arquivo mapfile) |
| calculaTamanho | Calcula o tamanho do mapa atual e define alguns elementos HTML do mapa |
| reCalculaTamanho | Recalcula o tamanho do mapa com base nas configurações do navegador |
| atualizaParametros | Atualiza os valores da variável i3GEO.parametros |
Parametros obtidos do mapa atual. Os parametros são fornecidos pelos programas PHP de redesenho e criação do mapa e atualizados sempre que o mapa é alterado.
alert(i3GEO.parametros.mapexten); i3GEO.parametros.mapscale = 25000;
| mapexten {String} | extensão geográfica do mapa no formato xmin ymin xmax ymax |
| mapscale {Numeric} | denominador da escala do mapa |
| mapres {Numeric} | resolução da imagem do mapa em DPI |
| pixelsize {Numeric} | tamanho em unidades de terreno dos pixels da imagem |
| mapfile {String} | nome do mapfile atualmente em uso |
| cgi {String} | endereço do executável do mapserver no servidor acessível pela URL |
| extentTotal {String} | extensão do mapa na inicialização |
| mapimagem {String} | URL da imagem que compõe o mapa |
| geoip {sim|nao} | indica se o geoip está instalado |
| listavisual {String} | (depreciado) lista de visuais disponíveis |
| utilizacgi {sim|nao} | indica se o mapa atual está no modo CGI |
| versaoms {String} | versão do Mapserver instalado no servidor (maior) |
| versaomscompleta {String} | versão do Mapserver instalado no servidor (completa) |
| mensagens {String} | mensagens para uso no letreiro |
| w {Integer} | largura do mapa atual |
| h {Integer} | altura do mapa atual |
| locsistemas {String} | endereço do xml com a lista de sistemas adicionais |
| locidentifica {String} | endereço do xml com a lista de sistemas de identificação |
| r {sim|nao} | indica se o software R está instalado no servidor |
| locmapas {String} | endereço do xml com a lista de mapas |
| extentref {String} | extensão geográfica do mapa de referência |
| celularef {Numeric} | tamanho do pixel do mapa de referência em unidades do terreno |
| kmlurl {String} | url de um arquivo kml que será inserido no mapa. Válido apenas na interface Google Maps |
| mensagemInicia {String} | mensagem definida em ms_configura.php indicando a versão atual do i3Geo. |
| interfacePadrao {String} | interface padrão definida em ms_configura |
| embedLegenda {String} | sim|nao indica se na inicialização a legenda foi inserida no conteúdo do mapa ou não |
| celularef {Numeric} | tamanho da célula do mapa de referência |
| autenticadoopenid {sim|nao} | indica se o usuário foi autenticado em alguma rede social |
| editor {sim|nao} | indica se o usuário atual é um editor (administrador) |
cordefundo {r,g,b}
| copyright {String} | texto existente no Layer copyright do mapfile de inicialização |
Largura da barra de rolagem do navegador. Se for igual a “”, a largura será calculada automaticamente.
O valor “scrollerWidth” será utilizado no calculo da largura do mapa. Se vc não quer diminuir o tamanho do mapa, subtraindo a largura da barra de rolagem, defina scrollerWidth = 0
{numérico}
{“”}
Essa variável é um contador utilizado para indicar quantos processos estão ativos e que irão executar o redesenho do mapa. O mapa só é atualizado quando o contador for menor que 1. Esse contador é utilizado no método i3GEO.atualiza O contador é necessário para evitar chamadas desnecessárias a função de redesenho do mapa.
{string}
cria:function()
Cria e configura a visualização do mapa, definindo posicionamentos, tamanho etc
Após as definições básicas, é executado o programa i3GEO.Interface.cria que irá realizar as operações conforme a interface atualmente em uso. A interface é definida em i3GEO.Interface.ATUAL
Veja i3GEO.Interface
inicia:function( retorno )
Inicializa o mapa
Verifica se o mapa apresenta algum problema no processamento no lado do servidor e realiza as operações de tentativa de recuperação, se for o caso
No início do processo é executada a função <i3GEOmantemCompatibilidade> para realizar as operações necessárias de manutenção de compatibilidade da versão atual para as anteriores
A inicialização é baseada em i3GEO.php.inicia cujo retorno é utilizado para definir a variável i3GEO.parametros
Após a inicialização é executado i3GEO.Interface.inicia
atualiza: function( retorno )
Atualiza o mapa atual, altera a imagem do mapa os gadgets ativos e os parametros e verifica a integridade do mapa em uso (arquivo mapfile)
O processo executa também a função de atualização específica da interface atual em uso, veja i3GEO.Interface.redesenha
Os seguintes gadgets são processados
i3GEO.arvoreDeCamadas.atualiza
i3GEO.arvoreDeCamadas.atualizaFarol
Os eventos definidos em i3GEO.eventos.navegaMapa são executados
| retorno {String} | string com os parametros do novo mapa. Se retorno não for especificado ou se for vazio, será feita uma chamada em ajax para sua obtenção. O resultado dessa chamada é armazenada em i3GEO.parametros |
Cria e configura a visualização do mapa, definindo posicionamentos, tamanho etc
cria:function()
Inicializa o mapa
inicia:function( retorno )
Executa operações após o mapa ter sido posicionado na tela
aposIniciar: function()
Atualiza o mapa atual, altera a imagem do mapa os gadgets ativos e os parametros e verifica a integridade do mapa em uso (arquivo mapfile)
atualiza: function( retorno )
Calcula o tamanho do mapa atual e define alguns elementos HTML do mapa
calculaTamanho: function()
Recalcula o tamanho do mapa com base nas configurações do navegador
reCalculaTamanho: function()
Atualiza os valores da variável i3GEO.parametros
atualizaParametros:function( variaveis )
Cria ou altera os elementos HTML necessários para a interface
cria: function( w, h )
INICIA
inicia: function( funcao, embedLegenda, w, h )
Inicia a interface
inicia: function( w, h )
Aplica o método redesenha da interface atual.
redesenha: function()
Atualiza a árvore de camadas.
atualiza: function( temas, forca )
Atualiza o farol de cada tema.
atualizaFarol: function( mapscale )
Executa as funções armazenadas em NAVEGAMAPA, ou seja, operações executadas quando o mapa tem sua extensão geográfica alterada.
navegaMapa: function()
