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