funcoes.js

$im = function( g )

Retorna o caminho correto de uma imagem incluindo o endereço da aplicação e do visual em uso.

Exemplo: $im(“imagem.png”)

Parâmetros

Retorno

$top = function( id, valor )

Muda a posição (superior) de um objeto tanto no IE como no Firefox.

Exemplo: $top(“imagem”,100)

Parâmetros

$left = function( id, valor )

Muda a posição (esquerda) de um objeto tanto no IE como no Firefox.

Exemplo: $left(“imagem”,100)

Parâmetros

function trataErro()

Fecha o objeto aguarde quando ocorre um erro.

function iCookie( nome, valor )

Cria um cookie.

function pCookie( nome )

Pega o valor de um cookie.

function ativaMensagemBanner()

Ativa o letreiro móvel.

A mensagem é incluída em um elemento HTML com id = “bannerMensagem”

As mensagens são obtidas do METADATA “MENSAGEM” que pode ser incluída na configuração dos layers adicionados ao mapa atual.

Veja a função mensagemBanner

function mensagemBanner()

Mostra uma mensagem na tela como um letriro móvel.

As mensagens são obtidas no metadata MENSAGEM que pode ser colocado nos layers disponíveis no i3geo.

Veja a função ativaMensagemBanner

function sobeferramentas()

Sobe a pilha de ícones na barra de ferramentas.

Utilizado na barra de ferramentas 2 quando o usuário clica no ícone para subir a lista de ícones.

function desceferramentas()

Desce a pilha de ícones na barra de ferramentas.

Utilizado na barra de ferramentas 2 quando o usuário clica no ícone para descer a lista de ícones.

function trocalingua( l )

Troca o idioma atual utilizado na interface principal.

O código atual da linguagem é armazenado em um Cookie.  Essa função troca o valor do Cookie e redesenha o mapa.

A troca de linguagem é ativada pelo clique nas bandeiras inseridas na parte superior do menu suspenso.

Os termos utilizados em cada idioma é definido em configura.js

Adefinição do termo a ser utilizado é definido pela função $trad

See: configura.js

Parameters

function criaContainerRichdraw()

Cria os elementos ‘dom’ necessários ao uso das funções de desenho sobre o mapa.

As ferramentas de cálculo de distâncias e áreas utilizam esse container.

Richdraw é uma biblioteca utilizada pelo i3geo para abstrair as diferenças entre as linguagens svg e vml.

Essa abstração é necessária devido às diferenças entre os navegadores.

function mudaVisual( visual )

Muda o visual do mapa atual (ícones).

Busca as imagens existentes na interface aberta e substituí pelas imagens existentes no diretório correspondente ao visual selecionado.

As imagens existentes no mapa são comparadas com as existentes no diretório i3geo/imagens/visual/visual caso ocorra correspondência são então substituídas.

A lista de visuais disponíveis é obtida na inicialização do i3geo e corresponde à lista de diretórios existentes em i3geo/imagens/visual

Parameters

function initJanelaMen()

Abre a janela com as mensagens de ajuda ao usuário.  Essa janela é mostrada no canto inferior esquerdo e mostra textos de ajuda quando o usuário passa omouse sobre uma opção do i3geo.

Quando essa janela estiver aberta, o resultado da função de etiquetas e de ajuda é mostrado nessa janela.

Se o usuário fechar a janela de mensagens, é definido um cookie para controlar a abertura da janela ou não na próxima vez que oi3geo for utilizado.

function docaguias()

Coloca as guias de navegação em uma janela interna do mapa e altera o tamanho do mapa para ajustá-lo à nova situação.

O conteúdo da nova janela é aquele que estiver dentro de um DIV com id= “contemFerramentas”

function ativaGuias()

Ativa as guias principais do mapa, definindo as funções que serão executadas quando a guia é escolhida.

Quando o usuário clica em uma guia, todas as guias são escondidas e a guia clicada é ativada.

Algumas guias só são preenchidas quando o usuário clicar nelas pela primeira vez.

O preenchimento sob demanda dessas guias torna necessário a definição da função que será executada quando o clique ocorrer.

Essas funções são definidas por default nas guias principais.

As guias principais são definidas nos objetos

objmapa.guiaTemas

objmapa.guiaMenu

objmapa.guiaLegenda

objmapa.guiaListaMapas

function pegalistademenus( retorno )

Pega a lista de menus que deverão compor a árvore de adição de temas e cria/adiciona os elementos raiz para cada árvore

A lista de menus é definida em ms_configura.php ou no sistema de administração.

Para cada menu é montada uma árvore com os grupos e sub-grupos de temas.

Parameters

function mensagemf( m )

Abre uma mensagem na tela em um DIV.

A mensagem é incluída em um elemento HTML com id =”mensagem”

Parameters

function wdocaf( wlargura, waltura, wsrc, nx, ny, texto )

Abre a janela flutuante para executar algum programa.

A janela flutuante contém um iframe onde o programa, definido no parâmetro wsrc, será carregado.

A janela é criada por meio da biblioteca YUI

Parameters

function redimwdocaf( wlargura, waltura )

Redimensiona a janela flutuante.

Parameters

function wdocaf2( wlargura, waltura, wsrc, nx, ny, texto )

Abre uma segunda janela flutuante.

Parameters

function wdocafechaf( odoca )

Fecha uma janela flutuante.

Depreciado

Parameters

function mostradicasf( objeto, dica, hlpt )

Mostra dicas sobre uma função quando o mouse passa sobre um botão ou outra opção qualquer.

O texto da dica pode ser obtido com a função $trad

Se a janela de mensagens estiver aberta, o texto será colocado nela.

Parameters

function mostraguiaf( guia )

Ativa a visualização de uma determinada guia.

A ativação consiste em tornar visível os elementos correspondentes a uma determinada guia.  Esses elementos devem estar contidos em um DIV cujo id deve ser composto pela palavra “guia” seguida do número da guia e a palavra “obj”, por exemplo, guia9obj.

Parâmetros

function aguarde()

Cria um objeto aguarde.  O objeto é um banner mostrado na tela quando uma função ajax é executada.

Method

Parâmetros

Method

Parâmetros

function zoomAnterior()

Retorna ao zoom anterior do mapa.

A memória das extensões geográficas são mantidas nos quador s de animação (objeto quadrosfilme).

function zoomProximo()

Avança para o zoom definido antes de aplciar o zoom anterior.

A memória das extensões geográficas são mantidas no array g_zoomProximo.

function pegaCoordenadaUTM()

Mostra as coordenadas do mouse em UTM.

Disparada apenas quando o mouse é estacionado por alguns instantes sobre o mapa.<b>

Para que esta função seja executada, é necessário existir um DIV com id=mostraUTM

function mostraRosaDosVentos()

Mostra a rosa dos ventos quando o mouse é estacionado por alguns instantes sobre o mapa.

Executado apenas se a variável g_mostraRosa = “sim”

function initJanelaZoom( qual )

Abre a janela com as ferramentas de zoom

Parametros

function initJanelaRef()

Abre a janela com o mapa de referencia

function mudaboxnf( tipo, obj )

Posiciona o botao aplicar quando o check box que liga/desliga um tema é pressionado.

Parâmetros

function movelentef()

Move a imagem na lente de aumento conforme o movimento do mouse sobre o mapa.

A lente de aumento é uma ferramenta do i3geo.

Esta função é executada sempre que o mouse é movido sobre o mapa e se o elemento “lente” estiver visível.

function zoomiauto()

Aproxima o mapa tendo o centro do mapa atual como referência.

function zoomoauto()

Afasta o mapa tendo o centro do mapa atual como referência.

function zoomboxf( tipo )

Faz o zoom no mapa utilizando a opção de desenhar um retângulo.

As coordenadas de tela devem estar no objeto “objposicaocursor”.  A opção “desloca” altera a posição do box (box1) na tela.  A opção “termina”, pega as coordenadas de tela do box1 e chama a função ajax que redesenha o mapa.

Parameters

function zoomIP()

Localiza no mapa o usuário baseado em seu número IP.

O ponto de localização é adicionado ao mapa como um novo tema.

function zoomPonto()

Localiza uma coordenada no mapa e desloca o mapa centralizando no ponto.

O ponto de localização é adicionado ao mapa como um novo tema.

function clicouRef()

Altera a abrangência do mapa quando o mapa de referência é clicado

function movimentoRef( obj )

Pega a coordenada do cursor sobre o mapa de referência

function aplicaescala()

Aplica a escala numerica definida no formulário existente no mapa.

O valor da escala a ser aplicada é obtido do elemento com id=”escalanum”

function zoomtot()

Zoom para a extensão default.

O valor da extensão default é obtido de objmapa.extentTotal, cujo valor é definido na inicialização do mapa.

function panFixo( direcao )

Desloca o mapa em uma direção determinada.

Parameters

function ativaEntorno()

Ativa ou desativa a carga do entorno.

Com o entorno ativo, são produzidas imagens no entorno do mapa, no estilo Google.

function geraURLentorno()

Gera as urls que farão parte dos divs de desenho do entorno do mapa.  Essas URLs utilizam o mapserver no modo CGI

function ajustaEntorno()

Ajusta o tamanho do mapa e das imagens do entorno, quando a opção de desenho do entorno estiver ativa.

Os valores que definem o tamanho do mapa são obtidos do objeto objmapa (métodos w e h)

function verificaTip()

Verifica se a opção de identificação está ativa e se o mouse está parado.  Se o mouse estiver parado, chama a função de mostrar tip.

A função de busca dos dados para a etiqueta é definida na variável de configuração g_funcaoTip

Pode-se definir uma outra função qualquer, sem a necessidade de alteração do código original do i3geo, definindo-se no HTML da interface a variável, por exemplo, gfuncaoTip = “minhasEtiquetas()”

Por default, utiliza-se a função verificaTipDefault()

function verificaTipDefault()

Executa a operação de identificação para mostrar uma etiqueta no mapa.

Esta é a função default, definida na variável g_funcaoTip

function mostraTip( retorno )

Mostra a descrição de um elemento do mapa como uma etiqueta na posição do mouse.

Para que um tema tenha uma etiqueta, é necessário configurar o metadata TIP no map file.

Parameters

function legendaGrafico( par )

Mostra a legenda dos gráficos adicionados no mapa.

Chamado pela ferramenta de inclusão de gráficos

Parâmetros

function inverteStatusClasse( leg )

Ativa ou desativa a visualização de uma classe de um tema.

Parameters

function atualizagoogle()

Atualiza o box do google se a função google estiver ativa

function atualizascielo()

Atualiza a lista de dados na opção de busca Scielo

function atualizaconfluence()

Atualiza a lista de dados na opção de busca confluence

function atualizawiki()

Atualiza a lista de dados na opção de busca wiki

function procurartemas( texto )

Localiza um tema no menu de temas.

O texto para busca é obtido do elemento INPUT com id=”buscatema”, ou no parâmetro “texto”

Parameters

function expandeTema( itemID )

Busca dados sobre um tema quando o botão de expandir tema é clicado.

Os dados obtidos sobre o tema são utilizados para montagem do nó “opções” que é mostrado abaixo do nome do tema.

Algumas das opções apenas serão mostradas se a variável de configuração g_opcoesTemas = “sim”

Parameters

function expandeGrupo( itemID )

Chama a função ajax que pega a lista de temas de um subgrupo no menu de temas.

Parameters

Recebe os dados da função Ajax com a lista de grupos e subgrupos.

Monta a árvore para adição de um novo tema no mapa.

Se existir o id=”arvoreAdicionaTema”, a árvore será incluída nele, se não, será incluída na guia definida em objmapa.guiaMenu

Parameters

function i3geo_comboGruposMenu( funcaoOnchange, idDestino, idCombo, largura, altura )

Busca a lista de grupos existentes no menu de temas do i3geo e monta um combo com o resultado.

Ao escolher uma opção do combo, a função de retorno receberá como parâmetro o id do grupo.

Parameters

function i3geo_comboSubGruposMenu( funcaoOnchange, idDestino, idCombo, idGrupo, largura, altura )

Monta um combo com a lista de subgrupos de um grupo do menu de temas do i3geo.

Ao escolher um subgrupo, a função de retorno receberá o id do grupo e o id do subgrupo.

Parameters

function i3geo_comboTemasMenu( funcaoOnchange, idDestino, idCombo, idGrupo, idSubGrupo, largura, altura )

Monta um combo com a lista de subgrupos de um grupo do menu de temas do i3geo.

Ao escolher um subgrupo, a função de retorno receberá o id do grupo e o id do subgrupo.

Parameters

function pegavalSistemas( sis )

Adiciona uma árvore no menu de adição de temas, contendo os sistemas que podem ser executados.

Parameters

function pegaMapas( retorno )

Recebe a lista de mapas (banners) e monta a apresentação na guia “mapas”.

Adiciona na guia mapas os banners que dão acesso direto a mapas especiais.

A indicação do arquivo xml é feita em ms_configura.php ou no sistema de administração

Parameters

function arvoreclick( itemID )

Marca o checkbox de adição de temas

Parameters

function pegaTema( celula )

Pega o tema de um no na guia de temas.

Utilizado nas opções que operam sobre um tema específico.

Parameters

Returns

Id do tema.

function autoRedesenho( opcao )

Controla a opção de redesenho automático temporizado

Para funcionar, a variável de inicialização g_autoRedesenho deve ser > 0

Parameters

opcao: ativa|desativa|redesenha

function remapaf()

Prepara o redesenho do mapa de acordo com o que esta visivel ou nao.

Chamado por algumas funções que necessitam refazer o desenho do mapa.

Verifica na lista de temas já adicionados, os temas que estão ligados e desligados, Chama a função que verifica na lista de temas adicionais.

function processevent1( exy1 )

Captura a posição do mouse tendo como referência o navegador.

Atualiza o objeto objposicaomouse e movimenta as janelas docáveis.

Recalcula a posição correta da imagem do mapa.

Parameters

function calcposf()

Calcula a posição do corpo do mapa e posiciona-o corretamente na tela.

function movecursor()

Move o ícone que segue o mouse quando da movimentação sobre o mapa

function capturaposicao( e )

Captura a posição do mouse em função do evento onmousemove sobre o corpo do mapa ou sobre o mapa de referência.

Atualiza o objeto objposicaocursor.  A função de mostrar etiquetas é definida como “” quando o mouse é movimentado.

Parameters

function gerafilmef( qs )

Cria os quadros que serão utilizados na função de animação e mostrados no mapa.

Cada novo quadro é criado como um objeto quadrofilme.  Os quadros criados são armazenados no array global quadrosfilme.

Parameters

function gravaQuadro( variavel, valor )

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

Parameters

function avancaQuadro()

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

function filmef( o )

Mostra a imagem armazenada em um quadro no lugar do corpo do mapa.

Parameters

function rebobinaf()

Rebobina as imagens dos quadros, limpando os parâmetros armazenados.

function filmezf( o )

Muda a extensão geográfica do mapa conforme o valor armazenado em um quado de animação.

Parameters

function filmeanimaf()

Carrega as imagens armazenadas nos quadros de animação.

function filmeanimarodaf( janima )

Roda a animacao usando as imagens armazenadas nos quadros de animação quadros.

function quadrofilme()

Cria um objeto quadro de animação.  Cada quadro é utilizado para armazenar parâmetros de um mapa que foi visto na tela.  É utilizado pela função que lista as imagens já vistas no mapa e pela função que retorna a um determinado zoom do mapa.

Methods

function calculadistancia( lga, lta, lgb, ltb ) //0ms

Calcula a distância entre dois pontos.

Parameters

function convdmsddf( cd, cm, cs )

Converte dms em dd.

Parameters

Returns

Coordenada em dd.

function calcddf( xfign, yfign, g_celula, imgext )

Converte o x,y de unidades de tela para décimo de grau.

Parameters

Returns

Coordena em dd.

function convdmsf( x, y )

Converte dd em dms.

Parameters

Returns

Array com o valor de x [0] e y [1] no formato dd mm ss

function convddtela( vx, vy, docmapa )

Converte coordenadas dd em coordenadas de tela.

Parameters

Returns

Array com o valor de x [0] e y [1]

function posicaomouse()

Cria um objeto que guarda a posição do mouse na tela.  A posição é medida em relação a janela do navegador.

Methods

function posicaocursor()

Cria um objeto que guarda a posição do mouse no corpo do mapa.  A posição é medida em relação à posição do mapa no navegador.

Methods

function pontosdist()

Cria o objeto que irá armazenaa as coordenadas para calculo de distancia

Parameters

function desenhoRichdraw( tipo, objeto, n )

Desenha elementos na tela usando a biblioteca richdraw

Parameters

function i3geo_pegaElementoPai( e )

Pega o elemento pai de um elemento clicado para identificar o código do tema.

Parameters

function inseremarcaf( xi, yi, funcaoOnclick )

Insere um ponto no mapa.

Os pontos são inseridos em um contaier de pontos e mostrados temporáriamente como uma imagem.  Utilizado pela função de medição de distâncias.

Parameters

function limpacontainerf()

Limpa o container de pontos.

function criaboxg()

Cria o div boxg utilizado nas operações de navegação, google, etc.

O boxg é utilizado para o desenho de retângulos na tela.

function ativaDragDrop()

Ativa a funcionalidade de arrastar e soltar para alteração da ordem de desenho dos temas e para excluir um tema do mapa.

function removeAcentos( palavra )

Remove acentos de uma palavra ou frase

Parameters

palavra -

function pegaPosicaoObjeto( obj )

Retorna a posição x,y de um objeto em relação a tela do navegador

function recuperamapa()

Tenta recuperar o último mapa, caso tenha ocorrido algum erro.

function protocolo()

Retorna o protocolo utilizado na url.