4D v15.4
GET PICTURE METADATA
GET PICTURE METADATA
| GET PICTURE METADATA ( imagem ; nomeMeta ; conteudoMeta {; nomeMeta2 ; conteudoMeta2 ; ... ; nomeMetaN ; conteudoMetaN} ) | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| imagem | Imagem |
|
Imagem cujos metadados você deseja conseguir | |||||
| nomeMeta | Texto |
|
Nome ou caminho do bloco a ser lido | |||||
| conteudoMeta | Variável |
|
Conteúdo do Metadado | |||||
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.
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)Uso de variáveis
C_DATE($dateAsDate)
GET PICTURE METADATA(vPicture;TIFF date time;$dateAsDate)
//devolve unicamente a data já que $dataComoData é de tipo Data
C_TEXT($dateAsText)
GET PICTURE METADATA(vPicture;TIFF date time;$dateAsText)
//devolve unicamente a data em formato XML
C_LONGINT($urgency)
GET PICTURE METADATA(vPicture;IPTC urgency;$urgency)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"Recepção de etiquetas com valores múltiplos em uma variável Texto
C_TEXT($vTwords;0)
GET PICTURE METADATA(vImagem;IPTC keywords;$vTwords)Depois da execução do comando, vTwords contém por exemplo "França;Europa".
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.
GET PICTURE KEYWORDS
Picture Metadata Names
Picture Metadata Values
SET PICTURE METADATA
