Java で EPS/PS ドキュメントの XMP メタデータを読み取り、追加する
Aspose.Page for Java を使用して、EPS および PostScript (PS) ドキュメントの XMP (Extensible Metadata Platform) メタデータを抽出、検査、追加、更新します。標準の Dublin Core プロパティ、ドキュメント作成統計、著作権情報、カスタムメタデータ構造を、基盤となるベクターグラフィックの視覚的なコンテンツを変更することなく、PostScript ファイルストリームに直接埋め込むことができます。
Aspose.Page for Java は、高性能な XmpHeaderConverter および XmpMetadata オブジェクトモデルを提供し、既存の XMP メタデータを抽出したり、EPS/PS ファイルに新しいプロパティを挿入したりできます。
- EPS ファイルから作成者情報、作成日、著作権表示、カスタム属性などの情報を読み取るには、
XmpMetadata.get()メソッドを使用します。 - ドキュメントのタイトルや変更履歴などの既存のメタデータフィールドを編集するには、
XmpMetadata.set()メソッドを使用します。 - グラフィックファイルに独自の企業固有のメタデータ属性を追加するには、
XmpMetadata.registerNamespace()メソッドを使用します。
EPS ファイルから既存の XMP メタデータを読み取る
EPS ドキュメントから標準およびユーザー定義の XMP プロパティを抽出して解析し、dc:title、xmp:CreatorTool、xmp:CreateDate などのメタデータフィールドを検査します。
// Get XMP metadata from EPS document.
// Learn more: https://docs.aspose.com/page/java/working-with-xm-metadata-in-eps/
// Create PsDocument instance from file
PsDocument document = new PsDocument(getDataDir() + "get_input.eps");
// Get XMP metadata. If EPS file doesn't contain XMP metadata we get new one filled with values from PS metadata comments (%%Creator, %%CreateDate, %%Title etc)
XmpMetadata xmp = document.getXmpMetadata();
// Get "CreatorTool" value
if (xmp.containsKey("xmp:CreatorTool"))
System.out.println("CreatorTool: " + xmp.get("xmp:CreatorTool").toStringValue());
// Get "CreateDate" value
if (xmp.containsKey("xmp:CreateDate"))
System.out.println("CreateDate: " + xmp.get("xmp:CreateDate").toStringValue());
// Get a width of a thumbnail image if exists
if (xmp.containsKey("xmp:Thumbnails") && xmp.get("xmp:Thumbnails").isArray()) {
XmpValue val = xmp.get("xmp:Thumbnails").toArray()[0];
if (val.isNamedValues() && val.toDictionary().containsKey("xmpGImg:width"))
System.out.println("Thumbnail Width: " + val.toDictionary().get("xmpGImg:width").toInteger());
}
// Get "format" value
if (xmp.containsKey("dc:format"))
System.out.println("Format: " + xmp.get("dc:format").toStringValue());
// Get "DocumentID" value
if (xmp.containsKey("xmpMM:DocumentID"))
System.out.println("DocumentID: " + xmp.get("xmpMM:DocumentID").toStringValue());EPS ファイルへの新しい XMP メタデータの追加と挿入
標準のメタデータプロパティ(Dublin Core や XMP Basic スキーマなど)を EPS ドキュメントに挿入し、更新されたファイル出力を保存します。
// Add XMP metadata to EPS document.
// Learn more: https://docs.aspose.com/page/java/working-with-xm-metadata-in-eps/
// Initialize EPS file input stream
try (FileInputStream psStream = new FileInputStream(getDataDir() + "add_input.eps")) {
// Create PsDocument instance from stream. Given EPS file doesn't contain XMP metadata, but usual metadata does contain.
PsDocument document = new PsDocument(psStream);
String outputFileName = "add_xmp_metadata_out.eps";
XmpMetadata xmp = null;
try {
// Get XMP metadata. If EPS file doesn't contain XMP metadata we get new one filled with values from PS metadata comments (%%Creator, %%CreateDate, %%Title etc)
xmp = document.getXmpMetadata();
// Check metadata values extracted from PS metadata comments and set up in new XMP metadata
// Get "CreatorTool" value
if (xmp.containsKey("xmp:CreatorTool"))
System.out.println("CreatorTool: " + xmp.get("xmp:CreatorTool").toStringValue());
// Get "CreateDate" value
if (xmp.containsKey("xmp:CreateDate"))
System.out.println("CreateDate: " + xmp.get("xmp:CreateDate").toStringValue());
// Get "format" value
if (xmp.containsKey("dc:format"))
System.out.println("Format: " + xmp.get("dc:format").toStringValue());
// Get "title" value
if (xmp.containsKey("dc:title"))
System.out.println("Title: " + xmp.get("dc:title").toArray()[0].toStringValue());
// Get "creator" value
if (xmp.containsKey("dc:creator"))
System.out.println("Creator: " + xmp.get("dc:creator").toArray()[0].toStringValue());
// Get "MetadataDate" value
if (xmp.containsKey("xmp:MetadataDate"))
System.out.println("MetadataDate: " + xmp.get("xmp:MetadataDate").toStringValue());
// Update MetadataDate value
Date metadataDate = xmp.get("xmp:MetadataDate").toDateTime();
// Save EPS file with new XMP metadata
// Create ouput stream
try (FileOutputStream outPsStream = new FileOutputStream(getOutputDir() + outputFileName)) {
// Save EPS file
document.save(outPsStream);
}
} catch (IOException ex) {
}カスタム名前空間と配列メタデータの追加
企業固有の XML 名前空間を登録し、配列リストなどの複雑なデータ型をドキュメントの XMP 構造内に格納します。
// Add namespace in XMP metadata in EPS document.
// Learn more: https://docs.aspose.com/page/java/working-with-xm-metadata-in-eps/
// Initialize EPS file input stream
try (FileInputStream psStream = new FileInputStream(getDataDir() + "add_simple_props_input.eps")) {
// Create PsDocument instance from stream
PsDocument document = new PsDocument(psStream);
String outputFileName = "add_xmp_namespace_out.eps";
try {
// Get XMP metadata. If EPS file doesn't contain XMP metadata we get new one filled with values from PS metadata comments (%%Creator, %%CreateDate, %%Title etc)
XmpMetadata xmp = document.getXmpMetadata();
//Change XMP metadata values
// Add new XML namespace "tmp".
xmp.registerNamespaceURI("tmp", "http://www.some.org/schema/tmp#");
// Add new string property in new namespace.
xmp.put("tmp:newKey", new XmpValue("NewValue"));
// Save EPS file with changed XMP metadata
// Create ouput stream
try (FileOutputStream outPsStream = new FileOutputStream(getOutputDir() + outputFileName)) {
// Save EPS file
document.save(outPsStream);
}
} catch (IOException ex) {
}インストールとセットアップ
Aspose.Page for Java を Maven に追加します:
Package Manager Console Command
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-page</artifactId>
<version>Latest</version>
</dependency>
FAQ
1. 標準の XMP ヘッダーを含まない EPS ファイルから XMP メタデータを抽出できますか?
EPS ファイルに既存の XMP ヘッダー パケットがない場合、PsDocument.getXmpMetadata() は空の XmpMetadata 構造を返します。プロパティを設定して document.save() を呼び出すことで、新しい有効な XMP パケットをファイルに書き込むことができます。
2. Aspose.Page for Java ではどの標準 XMP スキーマがサポートされていますか?
Aspose.Page は、Dublin Core (dc:)、XMP Basic (xmp:)、XMP Rights Management (xmpRights:)、XMP Media Management (xmpMM:) および Adobe PDF スキーマ (pdf:) を含む、すべての標準 XMP スキーマをネイティブにサポートしています。
3. XMP メタデータを更新すると、EPS のビジュアル グラフィックが再エンコードされたり劣化したりしますか?
いいえ。Aspose.Page は、ドキュメントのプリアンブルにある XMP ヘッダー メタデータ ブロックを変更または挿入しますが、ベクター図形、ラスター グラフィック、PostScript コードを変更または再圧縮することはありません。