Java ile EPS/PS belgelerinde XMP meta verilerini okuma ve ekleme

Aspose.Page for Java kullanarak EPS ve PostScript (PS) belgelerindeki XMP (Extensible Metadata Platform) meta verilerini çıkarın, inceleyin, ekleyin ve güncelleyin. Standart Dublin Core özelliklerini, belge oluşturma istatistiklerini, telif hakkı bilgilerini ve özel meta veri yapılarını, temel vektör grafik içeriğini değiştirmeden doğrudan PostScript dosya akışlarına ekleyin.

 

Aspose.Page for Java, mevcut XMP meta verilerini çıkarmak veya EPS/PS dosyalarına yeni özellikler eklemek için yüksek performanslı bir XmpHeaderConverter ve XmpMetadata nesne modeli sağlar.

  • EPS dosyalarından yazar bilgileri, oluşturulma tarihleri, telif hakkı bildirimleri ve özel öznitelikler gibi bilgileri okumak için XmpMetadata.get() yöntemini kullanın.
  • Belge başlıkları veya değişiklik geçmişi gibi mevcut meta veri alanlarını düzenlemek için XmpMetadata.set() yöntemini kullanın.
  • Grafik dosyalarına özel, kuruluşa özgü meta veri öznitelikleri eklemek için XmpMetadata.registerNamespace() yöntemini kullanın.

Bir EPS Dosyasından mevcut XMP meta verilerini okuma

dc:title, xmp:CreatorTool ve xmp:CreateDate gibi meta veri alanlarını incelemek için bir EPS belgesinden standart ve kullanıcı tanımlı XMP özelliklerini çıkarın ve ayrıştırın.

// 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());

Bir EPS Dosyasına yeni XMP meta verileri ekleme ve yerleştirme

Standart meta veri özelliklerini (Dublin Core veya XMP Basic şemaları gibi) bir EPS belgesine ekleyin ve güncellenmiş dosya çıktısını kaydedin.

// 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) {
    }

Özel adlandırılmış ad alanları ve dizi meta verileri ekleme

Kuruluşa özgü XML ad alanlarını kaydedin ve dizi listeleri gibi karmaşık veri türlerini belgenin XMP yapısında depolayın.

// 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) {
    }

Kurulum ve Ayarlar

Aspose.Page for Java’yı Maven’ınıza ekleyin:

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. Standart bir XMP başlığı içermeyen bir EPS dosyasından XMP meta verilerini çıkarabilir miyim?

Bir EPS dosyasında mevcut bir XMP başlık paketi yoksa PsDocument.getXmpMetadata(), boş bir XmpMetadata yapısı döndürür. Bu yapıyı özelliklerle doldurabilir ve dosyaya yeni, geçerli bir XMP paketi yazmak için document.save() çağrısını kullanabilirsiniz.

2. Aspose.Page for Java tarafından hangi standart XMP şemaları destekleniyor?

Aspose.Page; Dublin Core (dc:), XMP Basic (xmp:), XMP Rights Management (xmpRights:), XMP Media Management (xmpMM:) ve Adobe PDF şeması (pdf:) dahil olmak üzere tüm standart XMP şemalarını yerel olarak destekler.

3. XMP meta verilerini güncellemek, görsel EPS grafiklerini yeniden kodlar veya kalitesini düşürür mü?

Hayır. Aspose.Page, belgenin giriş bölümünde bulunan XMP başlık meta verileri bloğunu değiştirir veya ekler; vektör şekillerini, raster grafikleri veya PostScript kodunu değiştirmez ya da yeniden sıkıştırmaz.