PDF 構文 メタデータ

XMPパケットラッパ

PDF文書に関するドキュメントメタデータを記載する場合は、多くの場合で、以下のようにrdf:RDF要素をXMPパケットラッパで囲みます。
このラッパはXML processing instructions(PIs)で以下のように記述されます。

<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
   <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
      ...
   </rdf:RDF>
   ... パディング用の空白文字 ...
<?xpacket end="w"?>

begin要素のにはバイトオーダーマーク（BOM）が入ります。
XMPデータはUnicodeテキスト（UTF-8、UTF-16、UTF-32エンコード）で記載されることが求められています。
PDF文書はバイトデータで記載されていますのでUTF-8エンコードとなり、バイトオーダーマークは0xEFBBBFです。

XMPパケットに空白文字を追加することは有意義であるとXMP規格にあります。
空白文字(U+0020)は見た目に優しくするため100バイトごとに改行文字(U+000A)を追加します。
パディングには空白文字を2000バイト程度記述しておきます。
これによって、少々の変更であれば、PDF文書(の全体サイズ)を変更することなくメタデータだけを変更できます。

x:xmpmeta要素

以下のように、rdf:RDF要素の外側にx:xmpmeta要素が配置される場合があります。
この場合、x:xmpmeta要素には名前空間属性"adobe:ns:meta/"を指定し、この属性だけが有効な属性となり、他の属性は読み取り時に無視されます。
x:xmpmetaの目的は、一般的なXMLテキスト(非XMP)が含まれたXMPメタデータを識別することです。

<x:xmpmeta xmlns:x="adobe:ns:meta/">
   <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
      ...
   </rdf:RDF>
</x:xmpmeta>

rdf:RDF、rdf:Description要素

単一のXMPパケットは、単一のrdf:RDF要素によってシリアル化されます。
rdf:RDF要素の内容は０個以上のrdf:Description要素によって構成されます。

最上位のrdf:Description要素の内容は０個以上のXMPプロパティのためのXML要素によって構成されます。
XMPプロパティは任意のrdf:Description要素に配置できます。
XMP規格では以下のいずれかを推奨しています。

最上位rdf:Description要素にはXMPデータモデルにあるAboutURLを値としたrdf:about属性を指定できます。
rdf:about属性値は全ての最上位rdf:Description要素で同一でなければなりませんが、空の値を持つrdf:about属性がある場合にそれ同値のrdf:about属性とすることができます。
このAboutURLが無い場合はrdf:about属性値を空にしなければなりません。
最上位より深くネストされたrdf:Description要素にはrdf:about属性を使えません。

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:xmp="http://ns.adobe.com/xap/1.0/">
   <rdf:Description rdf:about="">
      <xmp:Rating>3</xmp:Rating>
   </rdf:Description>
</rdf:RDF>

XMPプロパティ要素はシリアル化されるXMP値の形式（Simple、Structure、またはArray）、およびXMP値にqualifier（修飾子）があるかどうかによって決定されます。

Simple(単純)値 XMPプロパティ

Simple(単純)値は Unicode標準で定義されているUnicodeテキストの文字列です。
Simple値を持つXMPプロパティの要素コンテンツは値を提供するテキストでなければなりません。
テキストには文字データ、エンティティ参照、文字参照、およびCDATAセクションのみを含めることができます。
要素にはネストされたXML要素を含めることはできません。

上記のXMPを解析するPDF Imager-LP（無償版）のソースコード

//初期化
if (0 > MlpInitialize("0-0334-E1310715W082")){
    printf("ライセンスキーが不正です\n");
    exit(100);
}

//オープン
if (0 <= MlpOpenDoc("HelloWorld.pdf", "", "")){

    //XMPインターフェース
    XMP_HANDLE h = MlpGetXmpInterface();

    //プロパティ
    char *prop = "Rating";
    if (XmpDoesSimplePropertyExist(h, kXMP_NS_XMP, prop)) {
        char *val;
        XmpGetSimpleProperty(h, kXMP_NS_XMP, prop, &val);
        printf("%s = %s\n", prop, val);
    }

    //クローズ
    MlpCloseDoc();
}

//後始末
MlpUninitialize();

using (var mlp = new PdfImager()){
    //ライセンスキー
    mlp.Initialize("0-0334-E1310715W082");

    //オープン
    if (0 <= mlp.OpenDoc("HelloWorld.pdf"))
    {

        //XMPインターフェース
        XmpInterface xmp = mlp.GetXmpInterface();

        //プロパティ
        const string XMP_NS_XMP = "http://ns.adobe.com/xap/1.0/";
        string prop = "Rating";
        Console.WriteLine("{0} = {1}", prop, xmp.GetSimpleProperty(XMP_NS_XMP, prop));

        //クローズ
        mlp.CloseDoc();
    }
}

Structure(構造)値 XMPプロパティ

Structure(構造)値は０個以上の名前付きフィールドのコンテナーです。
構造内の各フィールドの順序は重要ではありません。
Structure値を持つXMPプロパティの要素コンテンツはネストされたrdf：Description要素でなければなりません。
ネストされたrdf：Description要素の内容は名前がXMP構造のフィールドの名前である０個以上のXML要素で構成されます。

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:xmpTPg="http://ns.adobe.com/xap/1.0/t/pg/"
         xmlns:stDim="http://ns.adobe.com/xap/1.0/sType/Dimensions#">
   <rdf:Description rdf:about="">
      <xmpTPg:MaxPageSize>
         <rdf:Description>
            <stDim:h>297</stDim:h>
            <stDim:w>210</stDim:w>
            <stDim:unit>mm</stDim:unit>
         </rdf:Description>
      </xmpTPg:MaxPageSize>
   </rdf:Description>
</rdf:RDF>

なお、Structureプロパティのrdf:Description要素は、以下のようにStructure要素のrdf:parseType="Resource"属性に置き換えることができます。
これは、一般的な修飾子の記述形式にも適用されます。

   <xmpTPg:MaxPageSize rdf:parseType="Resource">
      <stDim:h>297</stDim:h>
      <stDim:w>210</stDim:w>
      <stDim:unit>mm</stDim:unit>
   </xmpTPg:MaxPageSize>

さらに、Structureプロパティのすべてのフィールドが単純な非修飾値を持つ場合には、各フィールド値をStructure要素の属性値として以下のように記述することができます

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:xmpTPg="http://ns.adobe.com/xap/1.0/t/pg/"
         xmlns:stDim="http://ns.adobe.com/xap/1.0/sType/Dimensions#">
   <rdf:Description rdf:about="">
      <xmpTPg:MaxPageSize stDim:h="297" stDim:w="210" stDim:unit="mm"/>
   </rdf:Description>
</rdf:RDF>

上のXMPを解析するPDF Imager-LP（無償版）のソースコード

//初期化
if (0 > MlpInitialize("0-0334-E1310715W082")){
    printf("ライセンスキーが不正です\n");
    exit(100);
}

//オープン
if (0 <= MlpOpenDoc("HelloWorld.pdf", "", "")){

    //XMPインターフェース
    XMP_HANDLE h = MlpGetXmpInterface();

    //プロパティ
    char *prop = "MaxPageSize";
    if (XmpDoesStructPropertyExist(h, kXMP_NS_XMP_T_PG, prop)) {
        char *val;
        XmpGetStructField(h, kXMP_NS_XMP_T_PG, prop, kXMP_NS_XMP_Dimensions, "h", &val);
        printf("%s[h] = %s\n", prop, val);
        XmpGetStructField(h, kXMP_NS_XMP_T_PG, prop, kXMP_NS_XMP_Dimensions, "w", &val);
        printf("%s[w] = %s\n", prop, val);
        XmpGetStructField(h, kXMP_NS_XMP_T_PG, prop, kXMP_NS_XMP_Dimensions, "unit", &val);
        printf("%s[unit] = %s\n", prop, val);
    }

    //クローズ
    MlpCloseDoc();
}

//後始末
MlpUninitialize();

using (var mlp = new PdfImager()){
    //ライセンスキー
    mlp.Initialize("0-0334-E1310715W082");

    //オープン
    if (0 <= mlp.OpenDoc("HelloWorld.pdf")) {

        //XMPインターフェース
        XmpInterface xmp = mlp.GetXmpInterface();

        //プロパティ
        const string XMP_NS_XMP_T_PG = "http://ns.adobe.com/xap/1.0/t/pg/";
        const string XMP_NS_XMP_Dimensions = "http://ns.adobe.com/xap/1.0/sType/Dimensions#";
        string prop = "MaxPageSize";
        Console.WriteLine("{0}[h] = {1}", prop, xmp.GetStructField(XMP_NS_XMP_T_PG, prop, XMP_NS_XMP_Dimensions, "h"));
        Console.WriteLine("{0}[w] = {1}", prop, xmp.GetStructField(XMP_NS_XMP_T_PG, prop, XMP_NS_XMP_Dimensions, "w"));
        Console.WriteLine("{0}[unit] = {1}", prop, xmp.GetStructField(XMP_NS_XMP_T_PG, prop, XMP_NS_XMP_Dimensions, "unit"));
    }

    //クローズ
    mlp.CloseDoc();
}

Array(配列)値 XMPプロパティ

Array(配列)値は1から始まる序数で位置付けされた０個以上のアイテムのコンテナです。
Arrayアイテムの形式は任意のXMP値形式にすることができ、配列内のすべてのアイテムは同じデータ型にします。
Arrayには以下の三種類があります。

Array値を持つXMPプロパティの要素コンテンツはネストされた以下の要素いずれか１つで構成されます。

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:dc="http://purl.org/dc/elements/1.1/">
   <rdf:Description rdf:about="">
      <dc:subject>
         <rdf:Bag>
            <rdf:li>XMP</rdf:li>
            <rdf:li>metadata</rdf:li>
            <rdf:li>ISO Standard</rdf:li>
         </rdf:Bag>
      </dc:subject>
   </rdf:Description>
</rdf:RDF>

上のXMPを解析するPDF Imager-LP（無償版）のソースコード

//初期化
if (0 > MlpInitialize("0-0334-E1310715W082")){
    printf("ライセンスキーが不正です\n");
    exit(100);
}

//オープン
if (0 <= MlpOpenDoc("HelloWorld.pdf", "", "")){

    //XMPインターフェース
    XMP_HANDLE h = MlpGetXmpInterface();

    //プロパティ
    char *prop = "subject";
    if (XmpDoesArrayPropertyExist(h, kXMP_NS_DC, prop)) {
        int cnt = XmpCountArrayItems(h, kXMP_NS_DC, prop);
        for(int i = 1; i <= cnt; i++){
            char *val;
            XmpGetArrayItem(h, kXMP_NS_DC, prop, i, &val);
            printf("%s[%d] = %s\n", prop, i, val);
        }
    }

    //クローズ
    MlpCloseDoc();
}

//後始末
MlpUninitialize();

using (var mlp = new PdfImager()){
    //ライセンスキー
    mlp.Initialize("0-0334-E1310715W082");

    //オープン
    if (0 <= mlp.OpenDoc("HelloWorld.pdf"))
    {
        //XMPインターフェース
        XmpInterface xmp = mlp.GetXmpInterface();

        //プロパティ
        const string XMP_NS_DC = "http://purl.org/dc/elements/1.1/";
        string prop = "subject";
        int cnt = xmp.CountArrayItems(XMP_NS_DC, prop);
        for (int i = 1; i < cnt; i++)
            Console.WriteLine("{0}[{1}] = {2}", prop, i, xmp.GetArrayItem(XMP_NS_DC, prop, i));

        //クローズ
        mlp.CloseDoc();
    }
}

8.2.1 Adobe PDF名前空間

Adobe PDF名前空間は、Adobe PDF文書で使用されるプロパティです(XMPには規定されていません)。

 - 名前空間 URI: "http://ns.adobe.com/pdf/1.3/"
 - プリフィックス： pdf

以下にAdobe PDF名前空間のプロパティの一覧を記します。

8.4.2 Dublin Core 名前空間

ダブリン・コア(Dublin Core)名前空間は、一般的に使用される一連のプロパティを提供します。 名前と使用法は、ダブリン・コア・メタデータ・イニシアティブ(DCMI)によって作成されたダブリン・コア・メタデータ要素セットで定義されているとおりです。

 - 名前空間 URI: "http://purl.org/dc/elements/1.1/"
 - プリフィックス： dc

以下にダブリンコア名前空間のプロパティの一覧を記します。 これらのプロパティを使用する場合は指定された型でなければなりませんし、プロパティの内容は記述されているとおりでなければなりません。

備考：
dc:titleはViewer PreferencesディクショナリのDisplayDocTitle要素をTrueにすると、指定された文字列がアプリケーションウインドウのタイトルバーに表示されます。

8.4.3 XMP 名前空間

XMP基本名前空間には基本的な説明情報を提供するプロパティが含まれています。

 - 名前空間 URI: "http://ns.adobe.com/xap/1.0/"
 - プリフィックス： xmp

以下にXMP名前空間のプロパティの一覧を記します。 これらのプロパティを使用する場合は指定された型でなければなりませんし、プロパティの内容は記述されているとおりでなければなりません。

8.4.4 XMP Rights Management 名前空間

XMP Rights Management 名前空間には、リソースに関連付けられた法的​​制限に関する情報を提供するプロパティが含まれています。

 - 名前空間 URI: "http: //ns .adobe .com/xap/1 .0/rights/"
 - プリフィックス： xmpRights

以下はXMP Rights Managementのプロパティの一覧です。これらのプロパティを使用する場合は、指定された型を使用しなければなりません。

8.4.5 xmpidq 名前空間

xmpidq名前空間にはxmp:識別子配列で使用されるスキームを定義する単一の修飾子が含まれています。

 - 名前空間 URI: "http://ns.adobe.com/xmp/Identifier/qual/1.0/"
 - プリフィックス： xmpidq

以下に単一のxmpidq修飾子を記します。 修飾子は指定された型でなければなりません。修飾子の内容は説明されているとおりです。