Tcl式を使用したメタデータへのアクセス

次の方法で、Tcl式を介してメタデータにアクセスできます。

• 受信メタデータ内のすべてのキーのリストを取得するには、式を使用します[metadata]。たとえば、画像の後にテキストノードを追加して次のように入力した場合[metadata]の中にmessageフィールドでは、着信メタデータのすべてのキーのリストが画像に表示されます。キーの値は表示されません。

すべてのキーと値のリストを取得するには、式を使用します[metadata values]。

• 受信メタデータの特定のキーの値を取得するには、式を使用します[metadata キー]。交換キー値を使用するキーの名前。たとえば、画像上の画像ファイルの名前と場所を表示するには、画像の後にテキストノードを追加し、次のように入力します。 [metadata input/filename]の中にmessageフィールド。

• 受信メタデータ内のキーのフィルターされたリストを取得するには、次の式を使用します[metadata keys フィルタ]。交換フィルタリストのフィルタリングに使用するものは何でも。アスタリスクを使用できます（*）フィルターのワイルドカードとして、キー名の0個以上の文字に置き換えます。たとえば、文字を持つすべてのキーのリストを取得するにはfそれらでは、式を使用します[metadata keys *f*]。で始まるすべてのキーのリストを取得するにはinput/、式を使用します[metadata keys input/*]。

デフォルトでは、キーは別々の行にリストされます。これを変更するには、使用することができます-s "区切り"に 選択したセパレータでキーを区切ってください。交換区切り異なるキーの間に表示するものを何でも使用します。たとえば、次で始まるすべてのキーのリストを取得するにはinput/ スペースで区切って、使用できます[metadata -s " " keys input/*]。カンマで区切られた同じリストを取得するには、使用します[metadata -s ", " keys input/*].

デフォルトでは、ストリームに存在しないメタデータにアクセスしようとすると、 Nuke空の文字列を返します。代わりにこのエラーを作成するには、 -e他のパラメーターの前にフラグを立てます。

式の使用の詳細については、 表現章。