4D v14.3

GET PICTURE METADATA

ホーム

 
4D v14.3
GET PICTURE METADATA

GET PICTURE METADATA 


 

GET PICTURE METADATA ( picture ; metaName ; metaContents {; metaName2 ; metaContents2 ; ... ; metaNameN ; metaContentsN} ) 
引数   説明
picture  ピクチャー in メタデータを読むピクチャ
metaName  テキスト in 取得するブロックの名前またはパス
metaContents  変数 in メタデータの内容

説明   

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に空の文字列を渡した場合はすべてのブロック) の内容は参照された要素に再コピーされます。

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)

変数の使用

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

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

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

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

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

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

 C_TEXT($vTwords;0)
 GET PICTURE METADATA(vPicture;IPTC keywords;$vTwords)

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

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

 
プロパティ 

プロダクト: 4D
テーマ: ピクチャ
番号: 1122

このコマンドはOKシステム変数を更新します

 
履歴 

初出: 4D v12

 
参照 

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

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v12.4)
ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v13.5)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)