groupdocs viewer dwg – Jak vykreslit konkrétní CAD výkresy v Javě pomocí GroupDocs.Viewer

Rendering specific layouts from a DWG file is a common requirement when you need to focus on a single design view, generate lightweight HTML previews, or embed a particular drawing layer into a web page. In this tutorial you’ll discover how GroupDocs.Viewer for Java makes it straightforward to render a chosen layout, convert CAD to HTML, and extract layout DWG with just a few lines of code.

Render Specific CAD Drawings with GroupDocs.Viewer for Java

Rychlé odpovědi

  • Která knihovna vykresluje DWG do HTML? GroupDocs.Viewer for Java.
  • Mohu vykreslit jen jedno rozvržení z DWG? Ano – specifikujte název rozvržení v HtmlViewOptions.
  • Potřebuji licenci pro vývoj? Bezplatná zkušební verze funguje pro testování; pro produkci je vyžadována trvalá licence.
  • Jaká verze Javy je vyžadována? JDK 8 nebo novější.
  • Je spotřeba paměti problémem u velkých CAD souborů? Použijte možnosti streamování a rychle uzavřete instanci Viewer.

Co je groupdocs viewer dwg?

GroupDocs.Viewer je Java knihovna, která převádí více než 50 formátů dokumentů a CAD — včetně DWG — do web‑přátelských reprezentací, jako jsou HTML, PNG nebo JPEG. Zpracovává soubory bez nutnosti nativního CAD softwaru a poskytuje konzistentní vykreslování napříč platformami.

Proč použít GroupDocs.Viewer pro vykreslování DWG?

GroupDocs.Viewer podporuje více než 50 CAD vstupních formátů a dokáže vykreslit vícesetstránkové výkresy při zachování spotřeby paměti pod 200 MB díky streamování stránek na požádání. Vestavěná extrakce rozvržení vám umožní izolovat jediný pohled, což snižuje dobu načítání stránky až o 70 % ve srovnání s vykreslením celého výkresu.

Požadavky

  • GroupDocs.Viewer for Java ≥ 25.2.
  • Maven pro správu závislostí.
  • JDK 8+ nainstalovaný lokálně.
  • Základní znalost struktury DWG souboru (rozvržení, modelový prostor, papírový prostor).

Jak vykreslit konkrétní rozvržení z DWG souboru?

Načtěte požadovaný DWG soubor, nakonfigurujte možnosti HTML vykreslování a specifikujte rozvržení, které chcete výstup. Nastavením názvu rozvržení v HtmlViewOptions viewer extrahuje pouze tento pohled a vygeneruje odpovídající HTML soubory. Tento přístup zjednodušuje generování náhledů a snižuje dobu zpracování a celý pracovní postup se skládá ze tří stručných kroků.

Krok 1: Definujte výstupní adresář

Vytvořte složku, kam budou uloženy vygenerované HTML soubory.

Pomocník Utils vytváří platformově nezávislý výstupní adresář pro vykreslené soubory.

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Vysvětlení: Utils.getOutputDirectoryPath vytváří platformově nezávislou cestu a vytvoří složku, pokud neexistuje.

Krok 2: Nastavte pojmenování vykreslených stránek

Zadejte vzor pojmenování, který obsahuje zástupný znak pro číslo stránky.

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Vysvětlení: {0} je nahrazeno indexem stránky, což vám umožní vykreslit více rozvržení bez kolizí názvů souborů.

Krok 3: Nakonfigurujte HtmlViewOptions

Řekněte vieweru, aby vkládal zdroje a zaměřil se na jedno rozvržení.

HtmlViewOptions konfiguruje, jak je generováno výstupní HTML, včetně vkládání zdrojů a výběru rozvržení.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

Vysvětlení: forEmbeddedResources zabaluje obrázky a CSS přímo do HTML, čímž vytváří jeden přenosný soubor na rozvržení.

Krok 4: Vyberte rozvržení, které chcete vykreslit

Zadejte přesný název rozvržení tak, jak se objevuje v DWG souboru.

Vlastnost layoutName určuje, které rozvržení výkresu má viewer vykreslit.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Vysvětlení: Nastavením layoutName na "Model" (nebo jakékoli vlastní rozvržení) instruujete GroupDocs.Viewer, aby ignoroval všechny ostatní pohledy.

Krok 5: Vykreslete rozvržení a vyčistěte

Otevřete viewer v bloku try‑with‑resources, zavolejte view a nechte Javu automaticky uzavřít instanci.

Třída Viewer je hlavním vstupním bodem pro vykreslování dokumentů pomocí GroupDocs.Viewer.

viewOptions.getCadOptions().setLayoutName("Model");

Vysvětlení: Volání view streamuje vybrané rozvržení do HTML souborů ve výstupním adresáři; viewer je uvolněn okamžitě po vykreslení.

Časté problémy a řešení

  • Rozvržení nenalezeno – Ověřte název rozvržení otevřením DWG v CAD editoru; pravopis a velikost písmen musí přesně odpovídat.
  • Chyby nedostatku paměti – Povolením Viewer.setMemoryLimit nebo zpracováním souboru v menších částech.
  • Chybějící obrázky – Ujistěte se, že je nastaveno forEmbeddedResources; jinak mohou být externí soubory obrázků generovány samostatně.

Často kladené otázky

Q: Co je GroupDocs.Viewer pro Javu?
A: Jedná se o server‑side knihovnu, která převádí více než 50 formátů dokumentů a CAD — včetně DWG — do HTML, PNG nebo JPEG bez nutnosti instalovaného Office nebo CAD softwaru.

Q: Jak získám dočasnou licenci pro GroupDocs.Viewer?
A: Navštivte stránku nákupu GroupDocs a požádejte o bezplatnou dočasnou licenci pro vývoj a testování.

Q: Dokáže GroupDocs.Viewer efektivně zpracovat velmi velké DWG soubory?
A: Ano, streamuje stránky a může vykreslit vícesetstránkové výkresy při udržení spotřeby paměti pod 200 MB, pokud po každé operaci uzavřete instanci Viewer.

Q: Je možné převést DWG rozvržení přímo do PDF místo HTML?
A: Rozhodně – nahraďte HtmlViewOptions za PdfViewOptions a specifikujte stejný název rozvržení pro získání PDF výstupu.

Q: Kde najdu více příkladů extrakce rozvržení?
A: Oficiální dokumentace a reference API obsahují další úryvky kódu pro dávkové zpracování a vlastní vykreslovací pipeline.

Praktické aplikace

  1. Architektonické prezentace – Zobrazte pouze rozvržení půdorysu potřebné pro schůzku s klientem.
  2. Výrobní revize – Izolujte pohled komponenty pro diskuzi o tolerancích bez načítání celé sestavy.
  3. E‑learningové moduly – Vložte jediný CAD pohled do webového tutoriálu pro jasnější výuku.
  4. Integrace správy dokumentů – Automaticky extrahujte specifické náhledy rozvržení při nahrávání DWG souborů do úložiště obsahu.
  5. Vlastní reportování – Generujte HTML reporty zaměřené na jediný pohled výkresu, čímž snížíte velikost souboru a dobu načítání.

Tipy pro výkon

  • Znovu použijte instanci Viewer pro více souborů, pokud je to možné; kešuje interní zdroje a urychluje následná vykreslení.
  • Povolte streamování voláním Viewer.setRenderMode(RenderMode.Stream), aby byla paměťová stopa nízká.
  • Komprimujte výstupní HTML pomocí gzip na webovém serveru pro další zlepšení načítání na straně klienta.

Závěr

Nyní máte kompletní, připravený přístup pro produkční nasazení k vykreslení konkrétního rozvržení z DWG souboru pomocí GroupDocs.Viewer for Java. Zaměřením se na jedno rozvržení snížíte dobu vykreslování, spotřebu paměti a vytvoříte čisté HTML, které lze vložit kamkoli – od webových portálů po interní dashboardy.

Další kroky

  • Vyzkoušejte vykreslení různých názvů rozvržení, jako jsou "Top View" nebo "Section A", a podívejte se, jak se výstup mění.
  • Prozkoumejte PdfViewOptions, pokud potřebujete PDF verzi stejného rozvržení.
  • Kombinujte tuto techniku s GroupDocs.Annotation pro přidání vodoznaků nebo komentářů do vykresleného HTML.

Poslední aktualizace: 2026-06-20
Testováno s: GroupDocs.Viewer for Java 25.2
Autor: GroupDocs

Zdroje

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_DWG_WITH_LAYOUTS_AND_LAYERS)) {
    viewer.view(viewOptions);
}

Související tutoriály