Bekerja dengan Grafik Vektor

Dalam bab ini, kita akan menjelajahi cara menggunakan kelas GraphicsAbsorber yang kuat untuk berinteraksi dengan grafik vektor dalam dokumen PDF. Apakah Anda perlu memindahkan, menghapus, atau menambahkan grafik, panduan ini akan menunjukkan cara melakukan tugas-tugas tersebut dengan efektif. Mari kita mulai!

Pendahuluan

Grafik vektor adalah komponen penting dari banyak dokumen PDF, digunakan untuk merepresentasikan gambar, bentuk, dan elemen grafis lainnya. Aspose.PDF menyediakan kelas GraphicsAbsorber, yang memungkinkan pengembang untuk mengakses dan memanipulasi grafik ini secara programatik. Dengan menggunakan metode Visit dari GraphicsAbsorber, Anda dapat mengekstrak grafik vektor dari halaman yang ditentukan dan melakukan berbagai operasi, seperti memindahkan, menghapus, atau menyalinnya ke halaman lain.

1. Mengekstrak Grafik dengan GraphicsAbsorber

Langkah pertama dalam bekerja dengan grafik vektor adalah mengekstraknya dari dokumen PDF. Berikut cara melakukannya menggunakan kelas GraphicsAbsorber:

public static void UsingGraphicsAbsorber()
{
    // Langkah 1: Buat objek Document.
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");

    // Langkah 2: Buat instance dari GraphicsAbsorber.
    var graphicsAbsorber = new GraphicsAbsorber();

    // Pilih halaman pertama dari dokumen.
    var page = document.Pages[1];

    // Langkah 3: Gunakan metode `Visit` untuk mengekstrak grafik dari halaman.
    graphicsAbsorber.Visit(page);

    // Tampilkan informasi tentang elemen yang diekstrak.
    foreach (var element in graphicsAbsorber.Elements)
    {
        Console.WriteLine($"Nomor Halaman: {element.SourcePage.Number}");
        Console.WriteLine($"Posisi: ({element.Position.X}, {element.Position.Y})");
        Console.WriteLine($"Jumlah Operator: {element.Operators.Count}");
    }
}

Penjelasan:

  1. Membuat Objek Dokumen: Sebuah objek Document baru diinstansiasi dengan jalur ke file PDF target.
  2. Membuat Instansi dari GraphicsAbsorber: Kelas ini menangkap semua elemen grafis dari halaman yang ditentukan.
  3. Metode Visit: Metode Visit dipanggil di halaman pertama, memungkinkan GraphicsAbsorber untuk menyerap grafis vektor.
  4. Mengulang Melalui Elemen yang Diekstrak: Kode melakukan looping melalui setiap elemen yang diekstrak, mencetak informasi seperti nomor halaman, posisi, dan jumlah operator gambar yang terlibat.

2. Memindahkan Grafis

Setelah Anda mengekstrak grafis, Anda dapat memindahkannya ke posisi yang berbeda di halaman yang sama. Berikut cara Anda dapat mencapainya:

public static void MoveGraphics()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page = document.Pages[1];
    graphicsAbsorber.Visit(page);

    // Sementara menangguhkan pembaruan untuk meningkatkan kinerja.
    graphicsAbsorber.SuppressUpdate();

    foreach (var element in graphicsAbsorber.Elements)
    {
        var position = element.Position;
        // Memindahkan grafis dengan menggeser koordinat X dan Y-nya.
        element.Position = new Point(position.X + 150, position.Y - 10);
    }

    // Melanjutkan pembaruan dan menerapkan perubahan.
    graphicsAbsorber.ResumeUpdate();
    document.Save("test.pdf");
}

Poin Kunci:

  • SuppressUpdate: Metode ini sementara menangguhkan pembaruan untuk meningkatkan kinerja saat membuat banyak perubahan.
  • ResumeUpdate: Metode ini melanjutkan pembaruan dan menerapkan perubahan yang dibuat pada posisi grafis.
  • Penempatan Elemen: Posisi setiap grafis disesuaikan dengan mengubah koordinat X dan Ynya.

3. Menghapus Grafis

Ada skenario di mana Anda mungkin ingin menghapus grafis tertentu dari halaman. Aspose.PDF menawarkan dua metode untuk melakukan ini:

Metode 1: Menggunakan Batas Rectangle

public static void RemoveGraphicsMethod1()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page = document.Pages[1];
    graphicsAbsorber.Visit(page);
    var rectangle = new Rectangle(70, 248, 170, 252);

    graphicsAbsorber.SuppressUpdate();
    foreach (var element in graphicsAbsorber.Elements)
    {
        // Periksa jika posisi grafik berada dalam batas rectangle.
        if (rectangle.Contains(element.Position))
        {
            element.Remove(); // Hapus elemen grafik.
        }
    }
    graphicsAbsorber.ResumeUpdate();
    document.Save("test.pdf");
}

Metode 2: Menggunakan Kumpulan Elemen yang Dihapus

public static void RemoveGraphicsMethod2()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page = document.Pages[1];
    var rectangle = new Rectangle(70, 248, 170, 252);

    graphicsAbsorber.Visit(page);
    var removedElementsCollection = new GraphicElementCollection();
    foreach (var item in graphicsAbsorber.Elements.Where(el => rectangle.Contains(el.Position)))
    {
        removedElementsCollection.Add(item);
    }

    page.Contents.SuppressUpdate();
    page.DeleteGraphics(removedElementsCollection);
    page.Contents.ResumeUpdate();
    document.Save("test.pdf");
}

Penjelasan:

  • Batas Persegi Panjang: Tentukan area persegi panjang untuk menentukan grafik mana yang akan dihapus.
  • Menekan dan Melanjutkan Pembaruan: Memastikan penghapusan yang efisien tanpa rendering antara.

4. Menambahkan Grafik ke Halaman Lain

Grafik yang diserap dari satu halaman dapat ditambahkan ke halaman lain dalam dokumen yang sama. Grafik yang diserap dari satu halaman dapat ditambahkan ke halaman lain dalam dokumen yang sama.

Metode 1: Menambahkan Grafik Secara Individual

public static void AddToAnotherPageMethod1()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page1 = document.Pages[1];
    var page2 = document.Pages[2];

    graphicsAbsorber.Visit(page1);
    page2.Contents.SuppressUpdate();
    foreach (var element in graphicsAbsorber.Elements)
    {
        element.AddOnPage(page2); // Tambahkan setiap elemen grafis ke halaman kedua.
    }
    page2.Contents.ResumeUpdate();
    document.Save("test.pdf");
}

Metode 2: Menambahkan Grafik sebagai Koleksi

public static void AddToAnotherPageMethod2()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page1 = document.Pages[1];
    var page2 = document.Pages[2];

    graphicsAbsorber.Visit(page1);
    page2.Contents.SuppressUpdate();
    page2.AddGraphics(graphicsAbsorber.Elements); // Tambahkan semua grafik sekaligus.
    page2.Contents.ResumeUpdate();
    document.Save("test.pdf");
}

Poin Utama:

  • SuppressUpdate dan ResumeUpdate: Metode ini membantu dalam menjaga kinerja saat melakukan perubahan massal.
  • AddOnPage vs. AddGraphics: Gunakan AddOnPage untuk penambahan individu dan AddGraphics untuk penambahan massal.

Kesimpulan

Dalam bab ini, kita telah mengeksplorasi bagaimana menggunakan kelas GraphicsAbsorber untuk mengekstrak, memindahkan, menghapus, dan menambahkan grafik vektor dalam dokumen PDF menggunakan Aspose.PDF. Dengan menguasai teknik-teknik ini, Anda dapat secara signifikan meningkatkan presentasi visual PDF Anda dan menciptakan dokumen yang dinamis dan menarik secara visual.

Jangan ragu untuk bereksperimen dengan contoh kode dan menyesuaikannya dengan kasus penggunaan spesifik Anda. Selamat coding!

Bekerja dengan JavaScript Bekerja dengan Lampiran dalam PDF