Vykreslování obrazců odděleně od dokumentu

Při zpracování dokumentů je běžným úkolem extrahovat všechny obrázky nalezené v dokumentu a exportovat je do externího umístění. Tento úkol se stává jednoduchým pomocí Aspose.Words API, který již poskytuje funkce pro extrahování a ukládání obrazových dat. Někdy však můžete chtít podobně extrahovat jiné typy grafického obsahu, který je reprezentován jiným typem objektu výkresu, například textové pole obsahující odstavce, tvary šipek a malý obrázek. Neexistuje žádný přímý způsob vykreslení tohoto objektu, protože se jedná o kombinaci jednotlivých prvků obsahu. Můžete se také setkat s případem, kdy byl obsah seskupen do objektu, který vypadá jako jeden obrázek.

Aspose.Words poskytuje funkce pro extrahování tohoto typu obsahu stejným způsobem, jakým můžete extrahovat jednoduchý obrázek z tvaru jako vykreslený obsah. Tento článek popisuje, jak využít tuto funkci k vykreslení obrazců nezávisle na dokumentu.

Typy tvarů v Aspose.Words

Veškerý obsah ve vrstvě výkresu dokumentu je reprezentován uzlem Shape nebo GroupShape v modulu Aspose.Words Document Object (DOM). Takovým obsahem mohou být textová pole, obrázky, objekty AutoShapes, OLE atd. Některá pole jsou také importována jako tvary, například pole INCLUDEPICTURE.

Jednoduchý obrázek je reprezentován Shape uzlem ShapeType.Image. Tento uzel obrazce nemá žádné podřízené uzly, ale k obrazovým datům obsaženým v tomto uzlu obrazce lze přistupovat pomocí vlastnosti Shape.ImageData. Na druhou stranu může být tvar také tvořen mnoha podřízenými uzly. Například tvar textového pole, který je reprezentován vlastností ShapeType.TextBox, může být tvořen mnoha uzly, například Paragraph a Table. Většina tvarů může zahrnovat uzly na úrovni bloku Paragraph a Table. Jedná se o stejné uzly jako ty, které se objevují v hlavním těle. Tvary jsou vždy součástí nějakého odstavce, buď přímo Vložené nebo ukotvené k Paragraph,, ale “plovoucí” kdekoli na stránce dokumentu.

Dokument může také obsahovat tvary, které jsou seskupeny. Seskupení lze povolit v Microsoft Word výběrem více objektů a kliknutím na" skupina " v nabídce pravým tlačítkem.

V Aspose.Words jsou tyto skupiny tvarů reprezentovány uzlem GroupShape. Ty lze také vyvolat stejným způsobem, aby se do obrázku vykreslila celá skupina.

Formát DOCX může obsahovat speciální typy obrázků, jako jsou diagramy nebo grafy. Tyto tvary jsou také reprezentovány prostřednictvím uzlu Shape v Aspose.Words, který také poskytuje podobnou metodu pro jejich vykreslení jako obrázků. Podle návrhu nemůže tvar obsahovat jiný tvar jako dítě, pokud tento tvar není obrázek (ShapeType.Image). Například Microsoft Word neumožňuje vložit textové pole do jiného textového pole.

Výše popsané typy tvarů poskytují speciální metodu pro vykreslení tvarů pomocí třídy ShapeRenderer. Instance třídy ShapeRenderer se načte pro Shape nebo GroupShape metodou GetShapeRenderer nebo předáním Shape konstruktoru třídy ShapeRenderer. Tato třída poskytuje přístup k členům, které umožňují vykreslení obrazce na následující:

• Soubor na disku pomocí metody Save přetížení
• Stream pomocí metody Save přetížení
• Objekt Graphics pomocí metod RenderToSize a RenderToScale

Při vykreslování Shape musí být součástí hierarchie dokumentů. Pokud Shape není součástí stromu dokumentů, vykreslený výstup bude po vyvolání ShapeRenderer metod prázdný.

Vykreslování do souboru nebo streamu

Metoda Save poskytuje přetížení, které vykreslí tvar přímo do souboru nebo streamu. Obě přetížení přijímají instanci třídy ImageSaveOptions, která umožňuje definovat možnosti pro vykreslení tvaru. Funguje to stejným způsobem jako metoda Document.Save. I když je tento parametr vyžadován, můžete předat hodnotu null s uvedením, že neexistují žádné vlastní možnosti.

Obrazec lze exportovat v libovolném formátu obrázku určeném ve výčtu SaveFormat. Obrázek lze například vykreslit jako rastrový obrázek, například JPEG zadáním výčtu SaveFormat.Jpeg, nebo jako vektorový obrázek, například EMF zadáním SaveFormat.Emf.

Příklad kódu níže ilustruje vykreslení obrazce na obrázek EMF odděleně od dokumentu a uložení na disk:

Příklad kódu níže ilustruje vykreslení obrazce na obrázek JPEG odděleně od dokumentu a uložení do streamu:

Třída ImageSaveOptions umožňuje určit různé možnosti, které určují, jak je obrázek vykreslen. Výše popsaná funkce může být použita stejným způsobem na uzly GroupShape a Shape.

Vykreslování do grafického objektu .NET

Vykreslování přímo do objektu Graphics umožňuje definovat vlastní nastavení a stav objektu Graphics. Běžný scénář zahrnuje vykreslení tvaru přímo do objektu Graphics načteného z formuláře Windows nebo bitmapy. Když je uzel Shape vykreslen, nastavení ovlivní vzhled tvaru. Můžete například otočit nebo změnit měřítko tvaru pomocí metod RotateTransform nebo ScaleTransform pro objekt Graphics.

Níže uvedený příklad ukazuje, jak vykreslit tvar na a .NET Graphics objekt odděleně od dokumentu a použít rotaci na vykreslený obrázek:

Podobně jako u metody RenderToSize je metoda RenderToSize zděděná z NodeRendererBase užitečná pro vytváření miniatur obsahu dokumentu. Velikost tvaru je zadána pomocí konstruktoru. Metoda RenderToSize přijímá objekt Graphics, souřadnice X a Y polohy obrázku a velikost obrázku (šířka a výška), který bude nakreslen na objekt Graphics.

Shape lze vykreslit do určitého měřítka pomocí metody ShapeRenderer.RenderToScale zděděné z třídy NodeRendererBase. To je podobné metodě Document.RenderToScale, která přijímá stejné hlavní parametry. Rozdíl mezi těmito dvěma metodami spočívá v tom, že u metody ShapeRenderer.RenderToScale místo doslovné velikosti zvolíte plovoucí hodnotu, která během Vykreslování změní měřítko tvaru. Pokud se hodnota float rovná 1.0, způsobí vykreslení tvaru na 100% jeho původní velikosti. Hodnota float 0.5 zmenší velikost obrázku o polovinu.

Vykreslení obrazce tvaru

Třída Shape představuje objekty ve vrstvě výkresu, například AutoShape, textové pole, volný tvar, objekt OLE, ovládací prvek ActiveX nebo obrázek. Pomocí třídy Shape můžete vytvářet nebo upravovat tvary v dokumentu Microsoft Word. Důležitou vlastností tvaru je jeho ShapeType. Tvary různých typů mohou mít různé možnosti v Word dokumentu. Například pouze obrázky a tvary OLE mohou mít obrázky uvnitř, zatímco většina tvarů může mít pouze text.

Následující příklad ukazuje, jak vykreslit obrazec do obrázku JPEG odděleně od dokumentu a uložit jej na disk:

Získání velikosti tvaru

Třída ShapeRenderer také poskytuje funkce pro Načtení velikosti tvaru v pixelech pomocí metody GetSizeInPixels. Tato metoda přijímá dva parametry typu float (Single) - měřítko a DPI, které se používají při výpočtu velikosti tvaru při vykreslení tvaru. Metoda vrací objekt Size, který obsahuje šířku a výšku vypočtené velikosti. To je užitečné, když je nutné předem znát velikost vykresleného tvaru, například při vytváření nové bitmapy z vykresleného výstupu.

Níže uvedený příklad ukazuje, jak vytvořit nový Bitmapový a grafický objekt se šířkou a výškou obrazce, který má být vykreslen:

Při použití metod RenderToSize nebo RenderToScale se v objektu SizeF vrátí také vykreslená velikost obrazu. To lze přiřadit proměnné a v případě potřeby použít.

Vlastnost SizeInPoints vrací velikost tvaru měřenou v bodech (viz ShapeRenderer. Výsledkem je objekt SizeF obsahující šířku a výšku.