Şekilleri Belgeden Ayrı Olarak Oluşturma
Belgeleri işlerken ortak bir görev, belgede bulunan tüm görüntüleri çıkarmak ve bunları harici bir konuma aktarmaktır. Bu görev, halihazırda görüntü verilerinin çıkarılması ve kaydedilmesi işlevselliğini sağlayan Aspose.Words API ile basitleşiyor. Ancak bazen, paragraflar, ok şekilleri ve küçük bir resim içeren bir metin kutusu gibi, farklı türde bir çizim nesnesi tarafından temsil edilen diğer grafik içeriğini de benzer şekilde çıkarmak isteyebilirsiniz. Bireysel içerik öğelerinin birleşimi olduğundan bu nesneyi oluşturmanın doğrudan bir yolu yoktur. İçeriklerin tek bir görüntü gibi görünen nesne halinde gruplandığı bir durumla da karşılaşabilirsiniz.
Aspose.Words, bir şekilden basit bir görüntüyü oluşturulmuş içerik olarak çıkarabildiğiniz şekilde, bu tür içeriği ayıklamak için işlevsellik sağlar. Bu makalede, şekilleri belgeden bağımsız olarak oluşturmak için bu işlevin nasıl kullanılacağı açıklanmaktadır.
Aspose.Words’teki Şekil Türleri
Bir belge çizim katmanındaki tüm içerik, Aspose.Words Belge Nesnesi Modülünde (DOM) Shape veya GroupShape düğümü tarafından temsil edilir. Bu tür içerikler metin kutuları, resimler, Otomatik Şekiller, OLE nesneleri vb. olabilir. INCLUDEPICTURE alanı gibi bazı alanlar da şekil olarak içe aktarılır.
Basit bir görüntü, ShapeType.Image‘nin Shape düğümü ile temsil edilir. Bu şekil düğümünün alt düğümleri yoktur ancak bu şekil düğümünün içerdiği görüntü verilerine Shape.ImageData özelliği tarafından erişilebilir. Öte yandan bir şekil birçok alt düğümden de oluşabilir. Örneğin, ShapeType.TextBox özelliğiyle temsil edilen bir metin kutusu şekli, Paragraph ve Table gibi birçok düğümden oluşabilir. Çoğu şekil Paragraph ve Table blok düzeyi düğümlerini içerebilir. Bunlar ana gövdede görünenlerle aynı düğümlerdir. Şekiller her zaman bir paragrafın parçalarıdır; ya doğrudan satır içi olarak eklenir ya da Paragraf,‘ye sabitlenir, ancak belge sayfasının herhangi bir yerinde “yüzer”.
Bir belge aynı zamanda birlikte gruplandırılmış şekiller de içerebilir. Grouping, Microsoft Word’de birden fazla nesne seçilerek ve sağ tıklama menüsünde “Group” tıklatılarak etkinleştirilebilir.
Aspose.Words’te bu şekil grupları GroupShape düğümü tarafından temsil edilir. Bunlar aynı zamanda tüm grubun görüntüye dönüştürülmesi için aynı şekilde çağrılabilir.
DOCX formatı diyagramlar veya çizelgeler gibi özel türde görüntüler içerebilir. Bu şekiller aynı zamanda Aspose.Words’deki Shape düğümü aracılığıyla da temsil edilir; bu da onları görüntü olarak oluşturmak için benzer bir yöntem sağlar. Tasarım gereği, bir şekil, bir resim (ShapeType.Image) olmadığı sürece, çocuk olarak başka bir şekil içeremez. Örneğin Microsoft Word, başka bir metin kutusunun içine metin kutusu eklemenize izin vermez.
Yukarıda açıklanan şekil türleri, şekilleri ShapeRenderer sınıfı aracılığıyla oluşturmak için özel bir yöntem sağlar. ShapeRenderer sınıfının bir örneği, bir Shape veya GroupShape için GetShapeRenderer yöntemi aracılığıyla veya Shape‘in ShapeRenderer sınıfının yapıcısına iletilmesiyle alınır. Bu sınıf, aşağıdakilere şekil oluşturmaya izin veren üyelere erişim sağlar:
- Save yöntemini aşırı yüklemeyi kullanarak diskteki dosya
- Save yöntemi aşırı yüklemesini kullanarak akış yapın
- RenderToSize ve RenderToScale yöntemlerini kullanarak .NET Grafik Nesnesi
Dosyaya veya Akışa İşleme
Save yöntemi, bir şekli doğrudan bir dosyaya veya akışa aktaran aşırı yüklemeler sağlar. Her iki aşırı yükleme de şeklin oluşturulmasına yönelik seçeneklerin tanımlanmasına izin veren ImageSaveOptions sınıfının bir örneğini kabul eder. Bu, Document.Save yöntemiyle aynı şekilde çalışır. Bu parametre gerekli olmasına rağmen, özel seçenek olmadığını belirterek boş bir değer iletebilirsiniz.
Şekil, SaveFormat numaralandırmasında belirtilen herhangi bir görüntü formatında dışa aktarılabilir. Örneğin görüntü, SaveFormat.Jpeg numaralandırması belirtilerek JPEG gibi bir raster görüntü olarak veya SaveFormat.Emf belirtilerek EMF gibi bir vektör görüntüsü olarak oluşturulabilir.
Aşağıdaki kod örneği, bir şeklin EMF görüntüsüne belgeden ayrı olarak işlenmesini ve diske kaydedilmesini gösterir:
Aşağıdaki kod örneği, bir şeklin belgeden ayrı olarak bir JPEG görüntüsüne işlenmesini ve bir akışa kaydedilmesini gösterir:
ImageSaveOptions sınıfı, görüntünün nasıl oluşturulacağını kontrol eden çeşitli seçenekleri belirtmenize olanak tanır. Yukarıda açıklanan işlevsellik aynı şekilde GroupShape ve Shape düğümlerine de uygulanabilir.
.NET Grafik Nesnesine İşleme
Doğrudan bir Graphics nesnesine dönüştürmek, kendi ayarlarınızı ve Graphics nesnesinin durumunu tanımlamanıza olanak tanır. Yaygın bir senaryo, bir şeklin doğrudan bir Windows Formu veya Bitmap’ten alınan bir Graphics nesnesine dönüştürülmesini içerir. Shape düğümü oluşturulduğunda ayarlar şeklin görünümünü etkileyecektir. Örneğin, Graphics nesnesi için RotateTransform veya ScaleTransform yöntemlerini kullanarak şekli döndürebilir veya ölçeklendirebilirsiniz.
Aşağıdaki örnek, belgeden ayrı olarak bir .NET Graphics nesnesine nasıl şekil oluşturulacağını ve oluşturulan görüntüye döndürmenin nasıl uygulanacağını gösterir:
RenderToSize yöntemine benzer şekilde, NodeRendererBase‘den devralınan RenderToSize yöntemi, belge içeriğinin küçük resimlerini oluşturmak için kullanışlıdır. Şekil boyutu yapıcı aracılığıyla belirtilir. RenderToSize yöntemi, Graphics nesnesini, görüntünün konumunun X ve Y koordinatlarını ve Graphics nesnesi üzerine çizilecek görüntünün boyutunu (genişlik ve yükseklik) kabul eder.
Shape, NodeRendererBase sınıfından devralınan ShapeRenderer.RenderToScale yöntemini kullanarak belirli bir ölçeğe dönüştürülebilir. Bu, aynı ana parametreleri kabul eden Document.RenderToScale yöntemine benzer. Bu iki yöntem arasındaki fark, ShapeRenderer.RenderToScale yönteminde gerçek boyut yerine şeklin oluşturulması sırasında şekli ölçeklendiren bir kayan nokta değeri seçmenizdir. Float değeri 1,0’a eşitse, şeklin orijinal boyutunun %100’ünde oluşturulmasına neden olur. 0,5’lik bir kayan değer, görüntü boyutunu yarı yarıya azaltır.
Şekil Görüntüsü Oluşturma
Shape sınıfı, çizim katmanındaki Otomatik Şekil, metin kutusu, serbest biçim, OLE nesnesi, ActiveX denetimi veya resim gibi nesneleri temsil eder. Shape sınıfını kullanarak bir Microsoft Word belgesinde şekiller oluşturabilir veya değiştirebilirsiniz. Bir şeklin önemli bir özelliği ShapeType‘sidir. Farklı türlerdeki şekiller, bir Word belgesinde farklı yeteneklere sahip olabilir. Örneğin, yalnızca görüntü ve OLE şekillerinin içlerinde görüntüler bulunabilirken, şekillerin çoğunda yalnızca metin bulunabilir.
Aşağıdaki örnek, Shape görüntüsünün belgeden ayrı olarak JPEG görüntüsüne nasıl dönüştürüleceğini ve diske nasıl kaydedileceğini gösterir:
Şekil Boyutunu Alma
ShapeRenderer sınıfı ayrıca GetSizeInPixels yöntemi aracılığıyla şeklin boyutunu piksel cinsinden alma işlevselliği de sağlar. Bu yöntem, şekil oluşturulduğunda şekil boyutunun hesaplanmasında kullanılan ölçek ve DPI olmak üzere iki kayan (Tek) parametreyi kabul eder. Yöntem, hesaplanan boyutun genişliğini ve yüksekliğini içeren Size nesnesini döndürür. Bu, örneğin işlenmiş çıktıdan yeni bir Bitmap oluştururken, işlenmiş şeklin boyutunun önceden bilinmesi gerektiğinde kullanışlıdır.
Aşağıdaki örnek, oluşturulacak şeklin genişliği ve yüksekliğiyle yeni bir Bitmap ve Graphics nesnesinin nasıl oluşturulacağını gösterir:
RenderToSize veya RenderToScale yöntemlerini kullanırken, oluşturulan görüntünün boyutu da SizeF nesnesinde döndürülür. Bu bir değişkene atanabilir ve gerekirse kullanılabilir.
SizeInPoints özelliği, nokta cinsinden ölçülen Şekil boyutunu döndürür (bkz. ShapeRenderer. Sonuç, genişlik ve yüksekliği içeren bir SizeF nesnesidir.