Merender Bentuk Secara Terpisah dari Dokumen
Saat memproses dokumen, tugas umum 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 mengekstrak dan menyimpan data gambar. Namun, terkadang Anda mungkin ingin mengekstrak jenis konten grafik lain yang diwakili oleh jenis objek gambar yang berbeda, misalnya, kotak teks yang berisi paragraf, bentuk panah, dan gambar kecil. Tidak ada cara langsung untuk merender objek ini karena ini adalah kombinasi dari elemen konten individual. Anda juga dapat menemukan kasus ketika konten telah dikelompokkan bersama ke dalam objek yang terlihat seperti satu gambar.
Aspose.Words menyediakan fungsionalitas untuk mengekstrak jenis konten ini dengan cara yang sama seperti Anda dapat mengekstrak gambar sederhana dari bentuk sebagai konten yang dirender. Artikel ini menjelaskan cara memanfaatkan fungsi ini untuk merender bentuk secara terpisah dari dokumen.
Jenis Bentuk dalam Aspose.Words
Semua konten dalam lapisan gambar dokumen diwakili oleh simpul Shape atau GroupShape dalam Modul Objek Dokumen Aspose.Words (DOM). Konten tersebut dapat berupa kotak teks, gambar, objek AutoShapes, OLE, dll. Beberapa bidang juga diimpor sebagai bentuk, misalnya bidang INCLUDEPICTURE.
Sebuah gambar sederhana diwakili oleh simpul Shape dari ShapeType.Image. Simpul bentuk ini tidak memiliki simpul turunan tetapi data gambar yang terkandung di dalam simpul bentuk ini dapat diakses oleh properti Shape.ImageData. Di sisi lain, sebuah bentuk juga dapat terdiri dari banyak simpul turunan. Misalnya, bentuk kotak teks, yang diwakili oleh properti ShapeType.TextBox, dapat terdiri dari banyak simpul, seperti Paragraph dan Table. Sebagian besar bentuk dapat menyertakan simpul tingkat blok Paragraph dan Table. Ini adalah simpul yang sama dengan yang muncul di badan utama. Bentuk selalu merupakan bagian dari beberapa paragraf, baik disertakan langsung sebaris atau ditambatkan ke Paragraph, tetapi “mengambang” di mana saja di halaman dokumen.
Dokumen juga dapat berisi bentuk yang dikelompokkan menjadi satu. Pengelompokan dapat diaktifkan di Microsoft Word dengan memilih beberapa objek dan mengklik “Grup” di menu klik kanan.
Dalam Aspose.Words, kelompok bentuk ini diwakili oleh simpul GroupShape. Ini juga dapat dipanggil dengan cara yang sama untuk merender seluruh grup ke gambar.
Format DOCX dapat berisi jenis gambar khusus, seperti diagram atau bagan. Bentuk-bentuk ini juga direpresentasikan melalui simpul Shape dalam Aspose.Words, yang juga menyediakan metode serupa untuk merendernya sebagai gambar. Secara desain, bentuk tidak dapat berisi bentuk lain sebagai anak, kecuali bentuk tersebut adalah gambar (ShapeType.Image). Misalnya, Microsoft Word tidak mengizinkan Anda menyisipkan kotak teks di dalam kotak teks lain.
Jenis 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 kelebihan beban
- Streaming menggunakan kelebihan metode Save
- Objek Grafik dengan menggunakan metode RenderToSize dan RenderToScale
Merender ke File atau Streaming
Metode Save menyediakan kelebihan beban yang merender bentuk langsung ke file atau aliran. Kedua kelebihan beban menerima instance dari kelas ImageSaveOptions, yang memungkinkan menentukan opsi untuk merender bentuk. Ini bekerja dengan cara yang sama seperti metode Document.Save. Meskipun parameter ini diperlukan, Anda dapat meneruskan nilai nol, dengan menetapkan bahwa tidak ada opsi khusus.
Bentuk dapat diekspor dalam format gambar apa pun yang ditentukan dalam pencacahan SaveFormat. Misalnya, gambar dapat dirender sebagai gambar raster, seperti JPEG dengan menentukan pencacahan SaveFormat.Jpeg, atau sebagai gambar vektor, seperti EMF dengan menentukan SaveFormat.Emf.
Contoh kode di bawah ini mengilustrasikan rendering bentuk ke gambar EMF secara terpisah dari dokumen, dan menyimpannya ke disk:
Contoh kode di bawah ini mengilustrasikan rendering bentuk ke gambar JPEG secara terpisah dari dokumen, dan menyimpannya ke aliran:
Kelas ImageSaveOptions memungkinkan Anda menentukan berbagai opsi yang mengontrol bagaimana gambar dirender. Fungsionalitas yang dijelaskan di atas dapat diterapkan dengan cara yang sama pada simpul GroupShape dan Shape.
Merender ke Objek Graphics
Merender langsung ke objek Graphics memungkinkan Anda menentukan pengaturan dan status Anda sendiri untuk objek Graphics. Skenario umum melibatkan rendering bentuk langsung ke objek Graphics yang diambil dari Bentuk Windows atau Bitmap. Saat simpul Shape dirender, pengaturan akan memengaruhi tampilan bentuk. Misalnya, Anda dapat memutar atau menskalakan bentuk dengan menggunakan metode RotateTransform atau ScaleTransform untuk objek Graphics.
Contoh di bawah ini menunjukkan cara merender bentuk ke objek Graphics secara terpisah dari dokumen dan menerapkan rotasi ke gambar yang dirender:
Demikian pula, untuk metode RenderToSize, metode RenderToSizeyang diwarisi dari NodeRendererBase berguna untuk membuat gambar mini konten dokumen. Ukuran bentuk ditentukan melalui konstruktor. Metode RenderToSize menerima objek Graphics, koordinat X dan Y dari posisi gambar, dan 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. Ini mirip dengan metode Document.RenderToScale yang menerima parameter utama yang sama. Perbedaan antara kedua metode ini adalah bahwa dengan metode ShapeRenderer.RenderToScale, alih-alih ukuran literal, Anda memilih nilai float yang menskalakan bentuk selama perenderannya. Jika nilai float sama dengan 1.0 menyebabkan bentuk dirender 100% dari ukuran aslinya. Nilai float 0.5 akan mengurangi ukuran gambar hingga setengahnya.
Merender Gambar Bentuk
Kelas Shape merepresentasikan objek dalam lapisan gambar, seperti objek AutoShape, kotak teks, bentuk bebas, OLE, kontrol ActiveX, atau gambar. Dengan menggunakan kelas Shape, Anda dapat membuat atau memodifikasi bentuk dalam dokumen Microsoft Word. Properti penting dari suatu bentuk adalah ShapeType. Bentuk dari tipe yang berbeda dapat memiliki kemampuan yang berbeda dalam dokumen Word. Misalnya, hanya gambar dan bentuk OLE yang dapat memiliki gambar di dalamnya sedangkan sebagian besar bentuk hanya dapat memiliki teks.
Contoh berikut menunjukkan cara merender gambar Bentuk ke 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 perhitungan ukuran bentuk saat bentuk dirender. Metode mengembalikan objek Size, yang berisi lebar dan tinggi ukuran yang dihitung. Ini berguna ketika diperlukan untuk mengetahui ukuran bentuk yang dirender sebelumnya, misalnya saat membuat Bitmap baru dari keluaran 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 ditetapkan ke variabel dan digunakan jika perlu.
Properti SizeInPoints mengembalikan ukuran Bentuk yang diukur dalam poin (lihat ShapeRenderer). Hasilnya adalah objek SizeF yang berisi lebar dan tinggi.