メインコンテンツまでスキップ
バージョン: 開発中

GET PICTURE METADATA

GET PICTURE METADATA ( picture ; metaName ; metaContents {; metaName2 ; metaContents2 ; ... ; metaNameN ; metaContentsN} )

引数型説明
picturePicture→メタデータを読むピクチャ
metaNameText→取得するブロックの名前またはパス
metaContentsVariable←メタデータの内容

説明​

GET PICTURE METADATAコマンドを使用して picture で指定したピクチャ (4Dのピクチャフィールドや変数) 内のメタデータ (またはメタタグ) の内容を読みだすことができます。 メタデータに関する詳細はSET PICTURE METADATAコマンドの説明を参照してください。

metaName引数には取り出すメタデータのタイプを指定する文字列を渡します。以下を渡すことができます:

  • タグパスが含まれる Picture Metadata Names テーマの定数
  • メタデータの完全ブロック名 ("TIFF", "EXIF", "GPS" あるいは"IPTC")。
  • 空の文字列 ("")。

metaContents 引数にはメタデータを受け取る変数を渡します。

  • metaNameにタグパスを渡した場合、metaContents 引数は直接取得した値を含みます。値は変数の型に合わせて変換されます(変数の型が定義されていない場合、デフォルトでテキスト型が使用されます)。テキスト型の変数ではXML (XMP標準) でフォーマットされます。(特にIPTC Keywordsタグのように) メタデータに一つ以上の値が含まれる場合、配列を渡すことができます。
  • metaNameにブロック名か空の文字列を渡すとき、metaContents 引数は有効なXML DOM要素参照でなければなりません。この場合、指定されたブロック (あるいはmetaNameに空の文字列を渡した場合はすべてのブロック) の内容は参照された要素に再コピーされます。

例題 1​

DOMツリーストラクチャを使用する

 $xml:=DOM Create XML Ref("Root") // XML DOMツリーの作成
 
  // TIFFメタデータの読み出し
 $_Xml_TIFF:=DOM Create XML element($xml;"/Root/TIFF")
 GET PICTURE METADATA(vPicture;"TIFF";$_Xml_TIFF)
 
  // GPSメタデータの読み出し
 $_Xml_GPS:=DOM Create XML element($xml;"/Root/GPS")
 GET PICTURE METADATA(vPicture;"GPS";$_Xml_GPS)

例題 2​

変数の使用

 var $dateAsDate : Date
 GET PICTURE METADATA(vPicture;TIFF date time;$dateAsDate)
  // $dateAsDateが日付型のため、日付のみが返される
 
 var $dateAsText : Text
 GET PICTURE METADATA(vPicture;TIFF date time;$dateAsText)
  // 日付のみがXMLフォーマットで返される
 
 C_INTEGER($urgency)
 GET PICTURE METADATA(vPicture;IPTC urgency;$urgency)

例題 3​

タグの複数の値が配列に返される

 ARRAY TEXT($tTkeywords;0)
 GET PICTURE METADATA(vPicture;IPTC keywords;$tTkeywords)

コマンドの実行後、$arrTkeywordsは例えば以下のようになります:

 $arrTkeywords{1}="France"
 $arrTkeywords{2}="Europe"

例題 4​

テキスト変数に複数の値を持つタグを受信する

 var $vTwords;0 : Text
 GET PICTURE METADATA(vPicture;IPTC keywords;$vTwords)

コマンド実行後、$vTwordsは例えば"France;Europe"のようになります。

システム変数およびセット​

メタデータの取得が正しく行われると、OKシステム変数に1が設定され、エラーが発生したり1つ以上のタグが見つからない場合は0が設定されます。どのような場合でも、読みだされた値は返されます。

参照​

GET PICTURE KEYWORDS
Picture Metadata Names
Picture Metadata Values
SET PICTURE METADATA