GET PICTURE METADATA
GET PICTURE METADATA ( imagem ; nomeMeta ; conteudoMeta {; nomeMeta2 ; conteudoMeta2 ; ... ; nomeMetaN ; conteudoMetaN} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| imagem | Picture | → | Imagem cujos metadados você deseja conseguir |
| nomeMeta | Text | → | Nome ou caminho do bloco a ser lido |
| conteudoMeta | Variable | ← | Conteúdo do Metadado |
Descrição
O comando GET PICTURE METADATA permite ler o conteúdo dos metadados (ou meta-tags) presentes em imagem (campo ou variável imagem 4D). Para maior informação sobre metadados, consulte a descrição do comando SET PICTURE METADATA.
No parâmetro nomMeta, passe uma string especificando o tipo de metadado a recuperar. Pode passar:
- uma constante do tema Picture Metadata Names com uma rota de etiqueta,
- Ou nome de um bloco completo de metadados ("TIFF", "EXIF", "GPS" ou "IPTC"),
- Uma cadeia vazia ("").
Passe no parâmetro ConteudoMeta a variável destinada a receber os metadados.
- Se passa uma rota de etiqueta em nomMeta, o parâmetro ConteudoMeta contém diretamente o valor a ser lido. O valor será convertido no tipo da variável. As variáveis de tipo texto serão formatadas em XML (padrão XMP). Pode passar um array quando o metadado contiver mais de um valor (este é o caso, particularmente, para as etiquetas IPTC Keywords).
- Se passa um nome de bloco ou uma string vazia em nomMeta, o parâmetro ConteudoMeta deve ser uma referência válida do elemento DOM XML. Neste caso, o conteúdo do bloco designado (ou de todos os blocos se passou uma string vazia em nomMeta) se copia novamente no elemento de referência.
Exemplo 1
Uso de estruturas da árvore DOM
$xml:=DOM Create XML Ref("Root") //Criação de uma árvore XML DOM
\Recepção dos metadados TIFF
$_Xml_TIFF:=DOM Create XML element($xml;"/Root/TIFF")
GET PICTURE METADATA(vImagem;"TIFF";$_Xml_TIFF)
//Recepção dos metadados GPS
$_Xml_GPS:=DOM Create XML element($xml;"/Root/GPS")
GET PICTURE METADATA(vImagem;"GPS";$_Xml_GPS)
Exemplo 2
Uso de variáveis
var $dataComoData : Date
GET PICTURE METADATA(vImagem;TIFF DateTime;$dataComoData)
//devolve unicamente a data já que $dataComoData é de tipo Data
var $dataComoTexto : Text
GET PICTURE METADATA(vImagem;TIFF/DateTime;$DataComoTexto)
//devolve unicamente a data em formato XML
C_INTEGER($urgency)
GET PICTURE METADATA(vImagem;IPTC urgency;$urgência)
Exemplo 3
Recepção de etiquetas com valores múltiplos em arrays
ARRAY TEXT($tTkeywords;0)
GET PICTURE METADATA(vImagem;IPTC keywords;$tTkeywords)
Depois da execução do comando, arrTkeywords contém por exemplo:
$arrTkeywords{1}="França"
$arrTkeywords{2}="Europa"
Exemplo 4
Recepção de etiquetas com valores múltiplos em uma variável Texto
var $vTwords;0 : Text
GET PICTURE METADATA(vImagem;IPTC keywords;$vTwords)
Depois da execução do comando, vTwords contém por exemplo "França;Europa".
Variáveis e conjuntos do sistema
La variable sistema OK devolve 1 se a recuperación dos metadados es correta e 0 se for produzido um erro ou se não se encontra ao menos uma das etiquetas. Em todos os casos, se devolvem os valores legíveis.
Ver também
GET PICTURE KEYWORDS
Picture Metadata Names
Picture Metadata Values
SET PICTURE METADATA
Propriedades
| Número do comando | 1122 |
| Thread-seguro | ✓ |
| Modificar variáveis | OK |