A - Funções compartilhadas

Contém um conjunto de funções que são compartilhadas por outros programas do I3Geo.

Summary
A - Funções compartilhadasContém um conjunto de funções que são compartilhadas por outros programas do I3Geo.
LicençaI3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet
Files
i3geo/ classesphp/ funcoes_gerais.php19/6/2007
Imagens
Functions
classesRasterIGera parâmetros para classificação de imagens.
fusaoGraficoFaz a fusao de uma imagem com outra grafico+imagem.
R
Functions
executaRExecuta comandos do R.
criaImagemRCria uma imagem png a partir de dados armazenados em disco.
cor
Functions
corRGBObtém os valores em RGB de um objeto cor do Mapscript.
corEAplica uma cor a um elemento de um objeto label de um layer.
colorHexAloca uma cor a um objeto imagem (GD).
colorRGBAloca uma cor a um objeto imagem (GD).
colorRGBshadowAloca uma cor de sombra a um objeto imagem (GD).
colorHexshadowAloca uma cor de sombra a um objeto imagem (GD).
RGB2hexConverte uma cor rgb em hex.
arquivos
Functions
nomeRandomicoGera um nome randômico.
listaEpsgLê o arquivo com os códigos de projeção epsg e retorna um array com os dados.
copiaSegurancaCria cópia de segurança do map_file.
criaDirMapaCria os diretórios temporários para a aplicação.
listaDiretoriosRetorna lista de diretórios.
listaArquivosRetorna lista de arquivos.
gravaDadosGrava as linhas de um array em um arquivo.
listaTrueTypeLista as fontes true type.
mapa
Functions
substituiConSubstituí a string de conexão com o banco postgis pela string definida na inicialização (ms_configura.php)
restauraConEsconde a string de conexão com o banco, caso necessário
retornaReferenciaRetorna uma string com as variaveis de um novo mapa de referencia.
retornaReferenciaDinamicaRetorna uma string com as variaveis de um novo mapa de referencia gerado de forma dinamica.
testaMapaTesta se um mapa está íntegro.
desligamargemDesliga o mapa de referência e a barra de escala de um mapa.
desligaTemasDesliga todos os temas de um mapa.
extPadraoAplica o valor da extensao geográfica padrao a um objeto map.
atributos
Functions
pegaValoresPega os valores de um item de um tema.
pegaValoresMPega os valores de múltiplos itens de um tema.
agrupaValoresAgrupa os valores de um array por um método de cálculo.
pegaItensPega os itens de um tema e armazena em cache.
buscaRapidaAcessa um web service RPC de busca de nomes e retorna os resultados.
coordenadas
Functions
ip2geoLocaliza a coordenada geográfica de um endereço IP.
xy2imagemConverte coordenadas geograficas em coordenadas de imagem e retorna um ponto.
xy2wktConverte coordenadas em wkt.
web services
Functions
reSLDRegera o SLD de um tema WMS.
georssCanaisLista os canais de um GeoRss.
tema
Functions
pegaNomeRetorna o nome correto de um layer
criaLayerCria um objeto layer
criaSHPCria um arquivo shape file de um tema.
downloadTemaFaz o download dos dados de um tema.
Outros
Functions
calculaAreaPixelCalcula a área em m2 de um pixel do mapa
pegaIPclientePega o IP do cliente
pegaIPcliente2Pega o IP do cliente sem REMOTE_ADDR

Licença

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; 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.

Files

i3geo/ classesphp/ funcoes_gerais.php

19/6/2007

Imagens

Summary
Functions
classesRasterIGera parâmetros para classificação de imagens.
fusaoGraficoFaz a fusao de uma imagem com outra grafico+imagem.

Functions

classesRasterI

function classesRasterI($minvalor,
$maxvalor,
$nclasses,
$cores)

Gera parâmetros para classificação de imagens.

Gera a expressão e as cores para uso em classes com intervalos iguais para representação de imagens raster.

Parameters

minvalorMenor valor existente na série
maxvalorMaior valor
nclassesNúmero de classes
coresCores.  Array de array de cores cores[0] = array(r,g,b)

return

arrayarray(“nomeclasse”=>$nomeclasse,”expressao”=>$expressao,”cores”=>$cores[$i])

fusaoGrafico

function fusaoGrafico()

Faz a fusao de uma imagem com outra grafico+imagem.

parameters

imagemimagem do mapa
graficoimagem do grafico
dir_tmpdiretorio onde estao as imagens
cpObjeto CPAINT

Return

Objeto cpaint com o nome da nova imagem criada.

Include

<classe_imagem.php>

R

Summary
Functions
executaRExecuta comandos do R.
criaImagemRCria uma imagem png a partir de dados armazenados em disco.

Functions

executaR

function executaR($rcode,
$dir_tmp,
$R_path,
$gfile_name)

Executa comandos do R.

parameters

$rcodeCódigo que será executado.
$dir_tmpDiretório temporário onde ficarão os arquivos para processamento.
$R_pathExecutável do R.
$gfile_namenome da imagem que será criada

Include

<classe_imagem.php>

criaImagemR

function criaImagemR($nomearq)

Cria uma imagem png a partir de dados armazenados em disco.

Utilizado para gerar uma imagem com base nos resultados de comandos R.

parameters

$nomearqNome do arquivo no servidor que será utilizado para gerar a imagem.

cor

Summary
Functions
corRGBObtém os valores em RGB de um objeto cor do Mapscript.
corEAplica uma cor a um elemento de um objeto label de um layer.
colorHexAloca uma cor a um objeto imagem (GD).
colorRGBAloca uma cor a um objeto imagem (GD).
colorRGBshadowAloca uma cor de sombra a um objeto imagem (GD).
colorHexshadowAloca uma cor de sombra a um objeto imagem (GD).
RGB2hexConverte uma cor rgb em hex.

Functions

corRGB

function corRGB($cor)

Obtém os valores em RGB de um objeto cor do Mapscript.

parameter

$corobjeto cor do mapscript.

return

stringCor em RGB separados por vírgula.

corE

function corE($label,
$cor,
$elemento)

Aplica uma cor a um elemento de um objeto label de um layer.

parameter

labelObjeto do tipo label.
corRGB separado por espacos, se for um array, aplica diretamente ao objeto cor.
elementoNome do elemento que receberá a cor.

colorHex

function colorHex($img,
$HexColorString)

Aloca uma cor a um objeto imagem (GD).

A origem é uma cor definida em hexadecimal.

parameters

$imgobjeto imagem
$HexColorStringcor hexadecimal

colorRGB

function colorRGB($img,
$ColorString)

Aloca uma cor a um objeto imagem (GD).

A origem é uma cor definida em rgb.

parameter

$imgobjeto imagem
$ColorStringcor r,g,b

colorRGBshadow

function colorRGBshadow($img,
$ColorString,
$mork)

Aloca uma cor de sombra a um objeto imagem (GD).

A origem é uma cor definida em rgb.

parameters

$imgobjeto imagem
$ColorStringcor r,g,b

colorHexshadow

function colorHexshadow($img,
$HexColorString,
$mork)

Aloca uma cor de sombra a um objeto imagem (GD).

A origem é uma cor definida em hexadecimal.

parameters

$imgobjeto imagem
$ColorStringcor hexadecimal

RGB2hex

function RGB2hex($rgb)

Converte uma cor rgb em hex.

parameters

$rgbcor RGB

arquivos

Summary
Functions
nomeRandomicoGera um nome randômico.
listaEpsgLê o arquivo com os códigos de projeção epsg e retorna um array com os dados.
copiaSegurancaCria cópia de segurança do map_file.
criaDirMapaCria os diretórios temporários para a aplicação.
listaDiretoriosRetorna lista de diretórios.
listaArquivosRetorna lista de arquivos.
gravaDadosGrava as linhas de um array em um arquivo.
listaTrueTypeLista as fontes true type.

Functions

nomeRandomico

function nomeRandomico($n = 10)

Gera um nome randômico.

parameter

Número de dígitos.

return

stringNome aleatório.

listaEpsg

function listaEpsg()

Lê o arquivo com os códigos de projeção epsg e retorna um array com os dados.

copiaSeguranca

function copiaSeguranca($map_file)

Cria cópia de segurança do map_file.

Salva o mapfile atual incluindo no nome, a string “seguranca”.

parameter

map_fileArquivo map file.

criaDirMapa

function criaDirMapa($dir_tmp)

Cria os diretórios temporários para a aplicação. parameters:

$dir_tmpDiretório temporário (no servidor) utilizado pelo mapserver.

listaDiretorios

function listaDiretorios($diretorio)

Retorna lista de diretórios.

parameters

$diretorioRaiz onde será feita a busca.

return

array com a lista de diretórios.

listaArquivos

function listaArquivos($diretorio)

Retorna lista de arquivos.

parameters

$diretorioRaiz onde será feita a busca.

return

array com a lista de arquivos e diretórios.

gravaDados

function gravaDados($dados,
$arq)

Grava as linhas de um array em um arquivo.

parameters

$dadosDados que serão gravados.
$arqNome do arquivo que será gravado

listaTrueType

function listaTrueType()

Lista as fontes true type.

Lê o arquivo fontes.txt existente no diretório symbols da instalação do I3Geo.  O resultado é gravado em um arquivo temporário para include, o que torna mais rápida a carga futura.  O arquivo para include armazena a variável res que contém a lista de fontes separadas por vírgula.

parameters

$cpObjeto CPAINT.
$locaplicLocalização da aplicação no servidor.
$imgdirDiretório das imagens.
$dir_tmpDiretório temporário.

mapa

Summary
Functions
substituiConSubstituí a string de conexão com o banco postgis pela string definida na inicialização (ms_configura.php)
restauraConEsconde a string de conexão com o banco, caso necessário
retornaReferenciaRetorna uma string com as variaveis de um novo mapa de referencia.
retornaReferenciaDinamicaRetorna uma string com as variaveis de um novo mapa de referencia gerado de forma dinamica.
testaMapaTesta se um mapa está íntegro.
desligamargemDesliga o mapa de referência e a barra de escala de um mapa.
desligaTemasDesliga todos os temas de um mapa.
extPadraoAplica o valor da extensao geográfica padrao a um objeto map.

Functions

substituiCon

function substituiCon($map_file,
$postgis_mapa)

Substituí a string de conexão com o banco postgis pela string definida na inicialização (ms_configura.php)

Parameters

map_filearquivo mapfile
postgis_mapastring de conexão com o banco

restauraCon

function restauraCon($map_file,
$postgis_mapa)

Esconde a string de conexão com o banco, caso necessário

Parameters

map_filearquivo mapfile
postgis_mapastring de conexão com o banco

retornaReferencia

function retornaReferencia()

Retorna uma string com as variaveis de um novo mapa de referencia.

parameter

cpObjeto CPAINT.
nomeImagemNome da imagem do corpo do mapa.
objMapaObjeto map.

return

Objeto cpaint com uma string contendo variáveis no formato javascript

retornaReferenciaDinamica

function retornaReferenciaDinamica()

Retorna uma string com as variaveis de um novo mapa de referencia gerado de forma dinamica.

O mapa de referência é baseado no mapfile aplicmap/referenciadinamica.map

parameter

cpObjeto CPAINT.
nomeImagemNome da imagem do corpo do mapa.
objMapaObjeto map.
zoomfator de zoom

return

Objeto cpaint com uma string contendo variáveis no formato javascript

testaMapa

function testaMapa($map_file,
$postgis_mapa)

Testa se um mapa está íntegro.

Se o mapfile apresentar problemas, a cópia de segurança é restaurada.

parameter

map_fileArquivo map file.
postgis_mapastring de conexão com o banco de dados definida em ms_configura.php

desligamargem

function desligamargem($objmapa)

Desliga o mapa de referência e a barra de escala de um mapa.

parameter

objmapaObjeto map.

return

Objeto map alterado.

desligaTemas

function desligaTemas($objMapa)

Desliga todos os temas de um mapa.

parameter

objMapaObjeto map.

return

Objeto map alterado.

extPadrao

function extPadrao($oMap)

Aplica o valor da extensao geográfica padrao a um objeto map.

parameter

$oMapMapa.

atributos

Summary
Functions
pegaValoresPega os valores de um item de um tema.
pegaValoresMPega os valores de múltiplos itens de um tema.
agrupaValoresAgrupa os valores de um array por um método de cálculo.
pegaItensPega os itens de um tema e armazena em cache.
buscaRapidaAcessa um web service RPC de busca de nomes e retorna os resultados.

Functions

pegaValores

function pegaValores($mapa,  
$layer,  
$item,  
$numerico = false,
$ignorar = "")

Pega os valores de um item de um tema.

parameters

$layerLayer que será processado.
$itemItem que será processado.
$numericoO item e numerico (true ou false).
$ignorarvalor que será ignorado na listagem final

pegaValoresM

function pegaValoresM($mapa,  
$layer,  
$itens,  
$exclui = "nulo",
$selecionados = "nao")

Pega os valores de múltiplos itens de um tema.

Se for passado apenas um item, o array de retorno será unidimensional.

parameters

$layerLayer que será processado.
$itensItens que serão processados.
$excluiO registro não será considerado se um dos valores for igual a esse valor.
$selecionadosUtiliza apenas os selecionados ou todos

agrupaValores

function agrupaValores($lista,
$indiceChave,
$indiceValor,
$tipo)

Agrupa os valores de um array por um método de cálculo.

No caso de soma e média, será considerado apenas um item e uma chave.

parameters

$listaLista com os arrays contendo os dados que serão processados.
$indiceChaveÍndice do array da lista que será considerado como a chave do array.
$indiceValorÍndice do array da lista que será considerado como o valor.
$tipoTipo de processamento soma|media|contagem|nenhum.

pegaItens

function pegaItens($layer)

Pega os itens de um tema e armazena em cache.

parameter

$layerobjeto layer

buscaRapida

function buscaRapida($servico,
$palavra)

Acessa um web service RPC de busca de nomes e retorna os resultados.

parameters

servicoEndereco do web service.
palavrapalavra de busca

return

array com o resultado.

coordenadas

Summary
Functions
ip2geoLocaliza a coordenada geográfica de um endereço IP.
xy2imagemConverte coordenadas geograficas em coordenadas de imagem e retorna um ponto.
xy2wktConverte coordenadas em wkt.

Functions

ip2geo

function ip2geo($ip,  
$locaplic = "..")

Localiza a coordenada geográfica de um endereço IP.

Essa função baseia-se no pacote geoIP, que deve estar instalado em pacotes/geoip.

parameters

$ipNúmero do IP.

xy2imagem

function xy2imagem($map_file,
$xy)

Converte coordenadas geograficas em coordenadas de imagem e retorna um ponto.

parameters

$map_fileArquivo map file.
$xyXY com as coordenadas (separado por espaço no caso de string)

xy2wkt

function xy2wkt($xy)

Converte coordenadas em wkt.

parameters

$xyLista de pares de coordenadas xy separadas por espaço.

web services

Summary
Functions
reSLDRegera o SLD de um tema WMS.
georssCanaisLista os canais de um GeoRss.

Functions

reSLD

function reSLD($map_file,
$tema,
$sld)

Regera o SLD de um tema WMS.

parameters

$map_filearquivo map_file
$temacódigo do tema
$sldstring sld

georssCanais

function georssCanais($servico,
$map_file,
$dir_tmp,
$locaplic)

Lista os canais de um GeoRss.

parameters

$servicoEndereço do RSS.
$map_fileNome do arquivo map file.  Inclua o caminho completo no servidor.
$dir_tmpDiretório onde o arquivo será criado.
$locaplicLocalização do I3geo

tema

Summary
Functions
pegaNomeRetorna o nome correto de um layer
criaLayerCria um objeto layer
criaSHPCria um arquivo shape file de um tema.
downloadTemaFaz o download dos dados de um tema.

Functions

pegaNome

function pegaNome($layer,  
$enc = "AUTO")

Retorna o nome correto de um layer

parameters

$layerObjeto layer
$encCódigo de página para conversão de caracteres

criaLayer

function criaLayer($oMapa,  
$ms_tipo,  
$ms_status,  
$metaTema,  
$metaClasse = "SIM")

Cria um objeto layer

parameters

$oMapaobjeto mapa
$ms_tipotipo de layer
$ms_statusstatus de visibilidade
$metaTemametadado com o nome do tema
$metaClassemetadado indicando se a classe é visível ou não na legenda

criaSHP

function criaSHP($tema,
$map_file,
$locaplic,
$dir_tmp)

Cria um arquivo shape file de um tema.

parameters

$temaTema que será processado.

$map_file -Nome do arquivo map file.  Inclua o caminho completo no servidor.

$locaplicDiretório onde está a aplicação no servidor.
$dir_tmpDiretório temporário

downloadTema

function downloadTema($map_file,
$tema,
$locaplic,
$dir_tmp)

Faz o download dos dados de um tema.

parameters

$map_fileNome do arquivo map file.  Inclua o caminho completo no servidor.
$temaTema que será processado.
$locaplicDiretório da aplicação.
$dir_tmpDiretório temporário

return

Array com o nome do diretório e nome do arquivo

Include

<ms_configura.php>

Outros

Summary
Functions
calculaAreaPixelCalcula a área em m2 de um pixel do mapa
pegaIPclientePega o IP do cliente
pegaIPcliente2Pega o IP do cliente sem REMOTE_ADDR

Functions

calculaAreaPixel

function calculaAreaPixel($map_file,
$celsize)

Calcula a área em m2 de um pixel do mapa

Parameters

map_filearquivo do mapa
celsizetamanho do pixel em dd

pegaIPcliente

function pegaIPcliente()

Pega o IP do cliente

pegaIPcliente2

function pegaIPcliente2()

Pega o IP do cliente sem REMOTE_ADDR

function classesRasterI($minvalor,
$maxvalor,
$nclasses,
$cores)
Gera parâmetros para classificação de imagens.
function fusaoGrafico()
Faz a fusao de uma imagem com outra grafico+imagem.
function executaR($rcode,
$dir_tmp,
$R_path,
$gfile_name)
Executa comandos do R.
function criaImagemR($nomearq)
Cria uma imagem png a partir de dados armazenados em disco.
function corRGB($cor)
Obtém os valores em RGB de um objeto cor do Mapscript.
function corE($label,
$cor,
$elemento)
Aplica uma cor a um elemento de um objeto label de um layer.
function colorHex($img,
$HexColorString)
Aloca uma cor a um objeto imagem (GD).
function colorRGB($img,
$ColorString)
Aloca uma cor a um objeto imagem (GD).
function colorRGBshadow($img,
$ColorString,
$mork)
Aloca uma cor de sombra a um objeto imagem (GD).
function colorHexshadow($img,
$HexColorString,
$mork)
Aloca uma cor de sombra a um objeto imagem (GD).
function RGB2hex($rgb)
Converte uma cor rgb em hex.
function nomeRandomico($n = 10)
Gera um nome randômico.
function listaEpsg()
Lê o arquivo com os códigos de projeção epsg e retorna um array com os dados.
function copiaSeguranca($map_file)
Cria cópia de segurança do map_file.
function criaDirMapa($dir_tmp)
Cria os diretórios temporários para a aplicação.
function listaDiretorios($diretorio)
Retorna lista de diretórios.
function listaArquivos($diretorio)
Retorna lista de arquivos.
function gravaDados($dados,
$arq)
Grava as linhas de um array em um arquivo.
function listaTrueType()
Lista as fontes true type.
function substituiCon($map_file,
$postgis_mapa)
Substituí a string de conexão com o banco postgis pela string definida na inicialização (ms_configura.php)
function restauraCon($map_file,
$postgis_mapa)
Esconde a string de conexão com o banco, caso necessário
function retornaReferencia()
Retorna uma string com as variaveis de um novo mapa de referencia.
function retornaReferenciaDinamica()
Retorna uma string com as variaveis de um novo mapa de referencia gerado de forma dinamica.
function testaMapa($map_file,
$postgis_mapa)
Testa se um mapa está íntegro.
function desligamargem($objmapa)
Desliga o mapa de referência e a barra de escala de um mapa.
function desligaTemas($objMapa)
Desliga todos os temas de um mapa.
function extPadrao($oMap)
Aplica o valor da extensao geográfica padrao a um objeto map.
function pegaValores($mapa,  
$layer,  
$item,  
$numerico = false,
$ignorar = "")
Pega os valores de um item de um tema.
function pegaValoresM($mapa,  
$layer,  
$itens,  
$exclui = "nulo",
$selecionados = "nao")
Pega os valores de múltiplos itens de um tema.
function agrupaValores($lista,
$indiceChave,
$indiceValor,
$tipo)
Agrupa os valores de um array por um método de cálculo.
function pegaItens($layer)
Pega os itens de um tema e armazena em cache.
function buscaRapida($servico,
$palavra)
Acessa um web service RPC de busca de nomes e retorna os resultados.
function ip2geo($ip,  
$locaplic = "..")
Localiza a coordenada geográfica de um endereço IP.
function xy2imagem($map_file,
$xy)
Converte coordenadas geograficas em coordenadas de imagem e retorna um ponto.
function xy2wkt($xy)
Converte coordenadas em wkt.
function reSLD($map_file,
$tema,
$sld)
Regera o SLD de um tema WMS.
function georssCanais($servico,
$map_file,
$dir_tmp,
$locaplic)
Lista os canais de um GeoRss.
function pegaNome($layer,  
$enc = "AUTO")
Retorna o nome correto de um layer
function criaLayer($oMapa,  
$ms_tipo,  
$ms_status,  
$metaTema,  
$metaClasse = "SIM")
Cria um objeto layer
function criaSHP($tema,
$map_file,
$locaplic,
$dir_tmp)
Cria um arquivo shape file de um tema.
function downloadTema($map_file,
$tema,
$locaplic,
$dir_tmp)
Faz o download dos dados de um tema.
function calculaAreaPixel($map_file,
$celsize)
Calcula a área em m2 de um pixel do mapa
function pegaIPcliente()
Pega o IP do cliente
function pegaIPcliente2()
Pega o IP do cliente sem REMOTE_ADDR