Merender Bentuk Secara Terpisah dari Dokumen
Saat memproses dokumen, tugas umumnya adalah mengekstrak semua gambar yang ditemukan dalam dokumen dan mengekspornya ke lokasi eksternal. Tugas ini menjadi sederhana dengan Aspose.Words API, yang sudah menyediakan fungsionalitas untuk mengekstraksi dan menyimpan data gambar. Namun, terkadang Anda mungkin ingin mengekstrak jenis konten grafis lain yang serupa yang diwakili oleh jenis objek gambar berbeda, misalnya, kotak teks yang berisi paragraf, bentuk panah, dan gambar kecil. Tidak ada cara langsung untuk merender objek ini karena ini merupakan kombinasi elemen konten individual. Anda mungkin juga menjumpai kasus ketika konten telah dikelompokkan menjadi satu objek yang tampak seperti satu gambar.
Aspose.Words menyediakan fungsionalitas untuk mengekstrak konten jenis ini dengan cara yang sama seperti Anda mengekstrak gambar sederhana dari bentuk sebagai konten yang dirender. Artikel ini menjelaskan cara memanfaatkan fungsi ini untuk merender bentuk secara independen dari dokumen.
Jenis Bentuk di Aspose.Words
Semua konten dalam lapisan gambar dokumen diwakili oleh node Shape atau GroupShape di Aspose.Words Document Object Module (DOM). Konten tersebut dapat berupa kotak teks, gambar, BentukOtomatis, objek OLE, dll. Beberapa bidang juga diimpor sebagai bentuk, misalnya bidang INCLUDEPICTURE.
Gambar sederhana diwakili oleh node Shape dari ShapeType.Image. Node bentuk ini tidak memiliki node anak tetapi data gambar yang terdapat dalam node bentuk ini dapat diakses oleh properti Shape.ImageData. Di sisi lain, suatu bentuk juga dapat terdiri dari banyak node anak. Misalnya, bentuk kotak teks, yang diwakili oleh properti ShapeType.TextBox, dapat terdiri dari banyak node, seperti Paragraph dan Table. Sebagian besar bentuk dapat menyertakan node tingkat blok Paragraph dan Table. Ini adalah node yang sama dengan yang muncul di badan utama. Bentuk selalu menjadi bagian dari beberapa paragraf, baik dimasukkan secara langsung sebaris atau ditambatkan ke Gugus kalimat, tetapi “mengambang” di mana saja di halaman dokumen.
Dokumen juga bisa berisi bentuk yang dikelompokkan bersama. Grouping dapat diaktifkan di Microsoft Word dengan memilih beberapa objek dan mengklik “Group” di menu klik kanan.
Di Aspose.Words, kelompok bentuk ini diwakili oleh node GroupShape. Ini juga dapat dipanggil dengan cara yang sama untuk merender seluruh grup menjadi gambar.
Format DOCX dapat berisi jenis gambar khusus, seperti diagram atau bagan. Bentuk-bentuk ini juga direpresentasikan melalui node Shape dalam Aspose.Words, yang juga menyediakan metode serupa untuk merendernya sebagai gambar. Secara desain, suatu bentuk tidak dapat memuat bentuk lain sebagai anak, kecuali bentuk tersebut adalah gambar (ShapeType.Image). Misalnya, Microsoft Word tidak mengizinkan Anda menyisipkan kotak teks ke dalam kotak teks lain.
Tipe bentuk yang dijelaskan di atas menyediakan metode khusus untuk merender bentuk melalui kelas ShapeRenderer. Sebuah instance dari kelas ShapeRenderer diambil untuk Shape atau GroupShape melalui metode GetShapeRenderer atau dengan meneruskan Shape ke konstruktor kelas ShapeRenderer. Kelas ini menyediakan akses ke anggota, yang memungkinkan rendering bentuk sebagai berikut:
- File pada disk menggunakan metode Save yang berlebihan
- Streaming menggunakan metode Save yang berlebihan
- Objek Grafik .NET dengan menggunakan metode RenderToSize dan RenderToScale
Merender ke File atau Stream
Metode Save menyediakan kelebihan beban yang merender bentuk secara langsung ke file atau aliran. Kedua kelebihan tersebut menerima turunan dari kelas ImageSaveOptions, yang memungkinkan untuk menentukan opsi untuk merender bentuk. Ini bekerja dengan cara yang sama seperti metode Document.Save. Meskipun parameter ini diperlukan, Anda dapat memberikan nilai null, yang menentukan bahwa tidak ada opsi khusus.
Bentuknya dapat diekspor dalam format gambar apa pun yang ditentukan dalam enumerasi SaveFormat. Misalnya, gambar dapat dirender sebagai gambar raster, seperti JPEG dengan menentukan enumerasi SaveFormat.Jpeg, atau sebagai gambar vektor, seperti EMF dengan menentukan SaveFormat.Emf.
Contoh kode di bawah mengilustrasikan rendering bentuk ke gambar EMF secara terpisah dari dokumen, dan menyimpannya ke disk:
Contoh kode di bawah mengilustrasikan rendering bentuk ke gambar JPEG secara terpisah dari dokumen, dan menyimpannya ke aliran:
Kelas ImageSaveOptions memungkinkan Anda menentukan berbagai opsi yang mengontrol cara gambar dirender. Fungsionalitas yang dijelaskan di atas dapat diterapkan dengan cara yang sama pada node GroupShape dan Shape.
Merender ke Objek Grafik .NET
Merender langsung ke objek Graphics memungkinkan Anda menentukan pengaturan dan status objek Graphics Anda sendiri. Skenario umum melibatkan rendering bentuk langsung ke objek Graphics yang diambil dari Formulir Windows atau Bitmap. Saat node Shape dirender, pengaturannya akan memengaruhi tampilan bentuk. Misalnya, Anda bisa memutar atau menskalakan bentuk dengan menggunakan metode RotateTransform atau ScaleTransform untuk objek Graphics.
Contoh di bawah ini menunjukkan cara merender bentuk ke objek .NET Graphics secara terpisah dari dokumen dan menerapkan rotasi pada gambar yang dirender:
Sama halnya dengan metode RenderToSize, metode RenderToSize yang diwarisi dari NodeRendererBase berguna untuk membuat thumbnail dari suatu konten dokumen. Ukuran bentuk ditentukan melalui konstruktor. Metode RenderToSize menerima objek Graphics, koordinat X dan Y posisi gambar, serta ukuran gambar (lebar dan tinggi) yang akan digambar ke objek Graphics.
Shape dapat dirender ke skala tertentu menggunakan metode ShapeRenderer.RenderToScale yang diwarisi dari kelas NodeRendererBase. Hal ini mirip dengan metode Document.RenderToScale yang menerima parameter utama yang sama. Perbedaan antara kedua metode ini adalah dengan metode ShapeRenderer.RenderToScale, alih-alih ukuran literal, Anda memilih nilai float yang menskalakan bentuk selama renderingnya. Jika nilai float sama dengan 1.0 menyebabkan bentuk dirender 100% dari ukuran aslinya. Nilai float 0,5 akan memperkecil ukuran gambar hingga setengahnya.
Merender Gambar Bentuk
Kelas Shape mewakili objek di lapisan gambar, seperti BentukOtomatis, kotak teks, bentuk bebas, objek OLE, kontrol ActiveX, atau gambar. Menggunakan kelas Shape, Anda bisa membuat atau memodifikasi bentuk dalam dokumen Microsoft Word. Properti penting dari suatu bentuk adalah ShapeType-nya. Bentuk dari tipe yang berbeda dapat memiliki kemampuan berbeda dalam dokumen Word. Misalnya, hanya bentuk gambar dan OLE yang dapat memiliki gambar di dalamnya, sedangkan sebagian besar bentuk hanya dapat berisi teks.
Contoh berikut menunjukkan cara merender gambar Bentuk menjadi gambar JPEG secara terpisah dari dokumen dan menyimpannya ke disk:
Mengambil Ukuran Bentuk
Kelas ShapeRenderer juga menyediakan fungsionalitas untuk mengambil ukuran bentuk dalam piksel melalui metode GetSizeInPixels. Metode ini menerima dua parameter float (Tunggal) – skala dan DPI, yang digunakan dalam penghitungan ukuran bentuk saat bentuk dirender. Metode ini mengembalikan objek Size, yang berisi lebar dan tinggi ukuran yang dihitung. Hal ini berguna ketika diperlukan untuk mengetahui ukuran bentuk yang dirender terlebih dahulu, misalnya saat membuat Bitmap baru dari output yang dirender.
Contoh di bawah ini menunjukkan cara membuat objek Bitmap dan Grafik baru dengan lebar dan tinggi bentuk yang akan dirender:
Saat menggunakan metode RenderToSize atau RenderToScale, ukuran gambar yang dirender juga dikembalikan dalam objek SizeF. Ini dapat ditugaskan ke variabel dan digunakan jika diperlukan.
Properti SizeInPoints mengembalikan ukuran Bentuk yang diukur dalam poin (lihat ShapeRenderer. Hasilnya adalah objek SizeF yang berisi lebar dan tinggi.