groupdocs viewer dwg – Comment rendre des dessins CAD spécifiques en Java avec GroupDocs.Viewer

Rendre des mises en page spécifiques à partir d’un fichier DWG est une exigence courante lorsque vous devez vous concentrer sur une vue de conception unique, générer des aperçus HTML légers ou intégrer une couche de dessin particulière dans une page Web. Dans ce tutoriel, vous découvrirez comment GroupDocs.Viewer for Java simplifie le rendu d’une mise en page choisie, la conversion CAD en HTML et l’extraction de la mise en page DWG en quelques lignes de code seulement.

Rendre des dessins CAD spécifiques avec GroupDocs.Viewer pour Java

Réponses rapides

  • Quelle bibliothèque rend le DWG en HTML ? GroupDocs.Viewer for Java.
  • Puis-je rendre un seul layout d’un DWG ? Oui – spécifiez le nom du layout dans HtmlViewOptions.
  • Ai-je besoin d’une licence pour le développement ? Un essai gratuit suffit pour les tests ; une licence permanente est requise pour la production.
  • Quelle version de Java est requise ? JDK 8 ou ultérieure.
  • L’utilisation de la mémoire est‑elle un problème avec les gros fichiers CAD ? Utilisez les options de streaming et fermez rapidement l’instance Viewer.

Qu’est-ce que groupdocs viewer dwg ?

GroupDocs.Viewer est une bibliothèque Java qui convertit plus de 50 formats de documents et CAD — y compris le DWG — en représentations compatibles Web telles que HTML, PNG ou JPEG. Elle traite les fichiers sans nécessiter de logiciel CAD natif, offrant un rendu cohérent sur toutes les plateformes.

Pourquoi utiliser GroupDocs.Viewer pour le rendu DWG ?

GroupDocs.Viewer prend en charge plus de 50 formats d’entrée CAD et peut rendre des dessins de plusieurs centaines de pages tout en maintenant la consommation de mémoire sous 200 Mo grâce au streaming des pages à la demande. Son extraction de mise en page intégrée vous permet d’isoler une seule vue, ce qui réduit le temps de chargement de la page jusqu’à 70 % comparé au rendu du dessin complet.

Prérequis

  • GroupDocs.Viewer for Java ≥ 25.2.
  • Maven pour la gestion des dépendances.
  • JDK 8+ installé localement.
  • Familiarité de base avec la structure des fichiers DWG (layouts, model space, paper space).

Comment rendre un layout spécifique d’un fichier DWG ?

Chargez le fichier DWG souhaité, configurez les options de rendu HTML et spécifiez la mise en page que vous voulez produire. En définissant le nom du layout dans HtmlViewOptions, le visualiseur extrait uniquement cette vue et génère les fichiers HTML correspondants. Cette approche simplifie la génération d’aperçus et réduit le temps de traitement, le flux complet se compose de trois étapes concises.

Étape 1 : Définir le répertoire de sortie

Créez un dossier où les fichiers HTML générés seront enregistrés.

L’aide Utils crée un dossier de sortie indépendant de la plateforme pour les fichiers rendus.

<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>

Explication : Utils.getOutputDirectoryPath construit un chemin indépendant de la plateforme et crée le dossier s’il n’existe pas.

Étape 2 : Configurer la nomenclature des pages rendues

Spécifiez un modèle de nommage incluant un espace réservé pour le numéro de page.

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

Explication : {0} est remplacé par l’indice de la page, vous permettant de rendre plusieurs layouts sans collisions de noms de fichiers.

Étape 3 : Configurer HtmlViewOptions

Indiquez au visualiseur d’intégrer les ressources et de cibler un seul layout.

HtmlViewOptions configure la façon dont le HTML de sortie est généré, y compris l’intégration des ressources et la sélection du layout.

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

Explication : forEmbeddedResources regroupe les images et le CSS directement dans le HTML, produisant un seul fichier portable par layout.

Étape 4 : Choisir le layout à rendre

Fournissez le nom exact du layout tel qu’il apparaît dans le fichier DWG.

La propriété layoutName indique quel layout de dessin le visualiseur doit rendre.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Explication : Définir layoutName sur "Model" (ou tout autre layout personnalisé) indique à GroupDocs.Viewer d’ignorer toutes les autres vues.

Étape 5 : Rendre le layout et nettoyer

Ouvrez le visualiseur dans un bloc try‑with‑resources, invoquez view, et laissez Java fermer automatiquement l’instance.

La classe Viewer est le point d’entrée principal pour le rendu de documents avec GroupDocs.Viewer.

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

Explication : L’appel view diffuse le layout sélectionné vers des fichiers HTML dans le dossier de sortie ; le visualiseur est immédiatement libéré après le rendu.

Problèmes courants et solutions

  • Layout non trouvé – Vérifiez le nom du layout en ouvrant le DWG dans un éditeur CAD ; l’orthographe et la casse doivent correspondre exactement.
  • Erreurs de mémoire insuffisante – Activez Viewer.setMemoryLimit ou traitez le fichier par morceaux plus petits.
  • Images manquantes – Assurez‑vous que forEmbeddedResources est activé ; sinon des fichiers image externes peuvent être générés séparément.

Questions fréquemment posées

Q : Qu’est‑ce que GroupDocs.Viewer pour Java ?
R : C’est une bibliothèque côté serveur qui convertit plus de 50 formats de documents et CAD — y compris le DWG — en HTML, PNG ou JPEG sans nécessiter l’installation d’Office ou d’un logiciel CAD.

Q : Comment obtenir une licence temporaire pour GroupDocs.Viewer ?
R : Visitez la page d’achat de GroupDocs et demandez une licence temporaire gratuite pour le développement et les tests.

Q : GroupDocs.Viewer peut‑il gérer efficacement des fichiers DWG très volumineux ?
R : Oui, il diffuse les pages et peut rendre des dessins de plusieurs centaines de pages tout en maintenant la consommation de mémoire en dessous de 200 Mo, à condition de fermer l’instance Viewer après chaque opération.

Q : Est‑il possible de convertir directement un layout DWG en PDF au lieu de HTML ?
R : Absolument – remplacez HtmlViewOptions par PdfViewOptions et spécifiez le même nom de layout pour obtenir une sortie PDF.

Q : Où puis‑je trouver plus d’exemples d’extraction de layout ?
R : La documentation officielle et la référence API contiennent des extraits de code supplémentaires pour le traitement par lots et les pipelines de rendu personnalisés.

Applications pratiques

  1. Présentations architecturales – Afficher uniquement le layout du plan d’étage nécessaire pour une réunion client.
  2. Revues de fabrication – Isoler une vue de composant pour discuter des tolérances sans charger l’assemblage complet.
  3. Modules d’e‑learning – Intégrer une seule vue CAD dans un tutoriel web pour une instruction plus claire.
  4. Intégration de gestion documentaire – Extraire automatiquement des aperçus spécifiques à un layout lors du téléchargement de fichiers DWG dans un référentiel de contenu.
  5. Rapports personnalisés – Générer des rapports HTML qui se concentrent sur une seule vue de dessin, réduisant la taille du fichier et le temps de chargement.

Conseils de performance

  • Réutiliser l’instance Viewer pour plusieurs fichiers lorsque c’est possible ; elle met en cache les ressources internes et accélère les rendus suivants.
  • Activer le streaming en appelant Viewer.setRenderMode(RenderMode.Stream) pour garder une faible empreinte mémoire.
  • Compresser le HTML de sortie avec gzip sur le serveur web pour améliorer davantage les temps de chargement côté client.

Conclusion

Vous disposez désormais d’une approche complète, prête pour la production, pour rendre un layout spécifique d’un fichier DWG en utilisant GroupDocs.Viewer for Java. En ciblant un seul layout, vous réduisez le temps de rendu, diminuez la consommation de mémoire et produisez un HTML propre qui peut être intégré partout — des portails web aux tableaux de bord internes.

Étapes suivantes

  • Essayez de rendre différents noms de layout tels que “Top View” ou “Section A” pour voir comment la sortie change.
  • Explorez PdfViewOptions si vous avez besoin d’une version PDF du même layout.
  • Combinez cette technique avec GroupDocs.Annotation pour ajouter des filigranes ou des commentaires au HTML rendu.

Dernière mise à jour : 2026-06-20
Testé avec : GroupDocs.Viewer for Java 25.2
Auteur : GroupDocs

Ressources

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

Tutoriels associés