groupdocs viewer dwg – Java Kullanarak GroupDocs.Viewer ile Belirli CAD Çizimlerini Render Etme

DWG dosyasından belirli düzenleri render’lamak, tek bir tasarım görünümüne odaklanmanız, hafif HTML ön izlemeleri oluşturmanız veya belirli bir çizim katmanını bir web sayfasına yerleştirmeniz gerektiğinde yaygın bir gereksinimdir. Bu öğreticide GroupDocs.Viewer for Java‘ın seçilen bir düzeni render’lamayı, CAD’i HTML’e dönüştürmeyi ve sadece birkaç satır kodla düzen DWG’sini çıkarmayı ne kadar basitleştirdiğini keşfedeceksiniz.

Render Specific CAD Drawings with GroupDocs.Viewer for Java

Hızlı Yanıtlar

  • DWG’yi HTML’e render’layan kütüphane hangisidir? GroupDocs.Viewer for Java.
  • Bir DWG’den yalnızca bir düzen render’layabilir miyim? Evet – düzen adını HtmlViewOptions içinde belirtin.
  • Geliştirme için lisansa ihtiyacım var mı? Test için ücretsiz deneme çalışır; üretim için kalıcı bir lisans gereklidir.
  • Hangi Java sürümü gereklidir? JDK 8 veya daha yenisi.
  • Büyük CAD dosyalarında bellek kullanımı bir sorun mu? Akış seçeneklerini kullanın ve Viewer örneğini hemen kapatın.

groupdocs viewer dwg nedir?

GroupDocs.Viewer, HTML, PNG veya JPEG gibi web‑dostu temsillere dönüştüren 50’den fazla belge ve CAD formatını (DWG dahil) işleyen bir Java kütüphanesidir. Yerel CAD yazılımı gerektirmeden dosyaları işler ve platformlar arasında tutarlı render sağlar.

DWG render’ı için neden GroupDocs.Viewer kullanılmalı?

GroupDocs.Viewer, 50+ CAD giriş formatını destekler ve talep üzerine sayfaları akışlayarak bellek tüketimini 200 MB’nin altında tutarken çok sayfalı çizimleri render’layabilir. Yerleşik düzen çıkarma özelliği, tek bir görünümü izole etmenizi sağlar; bu da tüm çizimi render’lamaya kıyasla sayfa yükleme süresini %70 kadar azaltır.

Önkoşullar

  • GroupDocs.Viewer for Java ≥ 25.2.
  • Bağımlılık yönetimi için Maven.
  • Yerel olarak kurulu JDK 8+.
  • DWG dosya yapısı (düzenler, model alanı, kağıt alanı) hakkında temel bilgi.

DWG dosyasından belirli bir düzeni nasıl render’lamak gerekir?

İstenen DWG dosyasını yükleyin, HTML render seçeneklerini yapılandırın ve çıkarmak istediğiniz düzeni belirtin. HtmlViewOptions içinde düzen adını ayarlayarak, görüntüleyici yalnızca o görünümü çıkarır ve ilgili HTML dosyalarını üretir. Bu yaklaşım ön izleme oluşturmayı basitleştirir ve işlem süresini azaltır; tüm iş akışı üç kısa adımdan oluşur.

Adım 1: Çıktı dizinini tanımlayın

Üretilen HTML dosyalarının kaydedileceği bir klasör oluşturun.

Utils yardımcı sınıfı, render edilen dosyalar için platform bağımsız bir çıktı klasörü oluşturur.

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

Açıklama: Utils.getOutputDirectoryPath platform bağımsız bir yol oluşturur ve klasör mevcut değilse oluşturur.

Adım 2: Render edilen sayfalar için adlandırma ayarlayın

Sayfa numarası için bir yer tutucu içeren bir adlandırma deseni belirtin.

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

Açıklama: {0} sayfa indeksiyle değiştirilir, böylece dosya adı çakışması olmadan birden fazla düzen render’layabilirsiniz.

Adım 3: HtmlViewOptions’ı yapılandırın

Görüntüleyiciye kaynakları gömmesini ve tek bir düzeni hedeflemesini söyleyin.

HtmlViewOptions, çıktı HTML’nin nasıl üretileceğini, kaynak gömme ve düzen seçimini içerir.

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

Açıklama: forEmbeddedResources görüntüleri ve CSS’i doğrudan HTML içine paketler, her düzen için tek bir taşınabilir dosya üretir.

Adım 4: Renderlamak istediğiniz düzeni seçin

DWG dosyasında göründüğü gibi tam düzen adını sağlayın.

layoutName özelliği, görüntüleyicinin hangi çizim düzenini render’layacağını belirtir.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Açıklama: layoutName‘i "Model" (veya herhangi bir özel düzen) olarak ayarlamak, GroupDocs.Viewer’ın diğer tüm görünümleri yok saymasını sağlar.

Adım 5: Düzeni render’layın ve temizleyin

Görüntüleyiciyi bir try‑with‑resources bloğunda açın, view metodunu çağırın ve Java’nın örneği otomatik olarak kapatmasına izin verin.

Viewer sınıfı, GroupDocs.Viewer ile belgeleri render’lamak için ana giriş noktasıdır.

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

Açıklama: view çağrısı seçilen düzeni çıktı klasöründeki HTML dosyalarına akışlar; render’lamadan hemen sonra görüntüleyici serbest bırakılır.

Yaygın Sorunlar ve Çözümler

  • Düzen bulunamadı – DWG’yi bir CAD editöründe açarak düzen adını doğrulayın; yazım ve büyük/küçük harf tam olarak eşleşmelidir.
  • Bellek yetersizliği hataları – Viewer.setMemoryLimit‘i etkinleştirin veya dosyayı daha küçük parçalar halinde işleyin.
  • Eksik görüntüler – forEmbeddedResources‘in ayarlandığından emin olun; aksi takdirde dış görüntü dosyaları ayrı ayrı oluşturulabilir.

Sıkça Sorulan Sorular

S: GroupDocs.Viewer for Java nedir?
C: “Office veya CAD yazılımı kurulu olmadan, DWG dahil 50’den fazla belge ve CAD formatını HTML, PNG veya JPEG’e dönüştüren bir sunucu‑tarafı kütüphanedir.”

S: GroupDocs.Viewer için geçici bir lisans nasıl elde ederim?
C: “GroupDocs’ purchase page adresini ziyaret edin ve geliştirme ve test için ücretsiz geçici bir lisans isteyin.”

S: GroupDocs.Viewer çok büyük DWG dosyalarını verimli bir şekilde işleyebilir mi?
C: “Evet, sayfaları akışlayarak çok sayfalı çizimleri render’layabilir ve bellek kullanımını 200 MB’nin altında tutar; her işlemden sonra Viewer örneğini kapattığınız sürece.”

S: DWG düzenini doğrudan PDF’ye, HTML yerine dönüştürmek mümkün mü?
C: “Kesinlikle – HtmlViewOptions yerine PdfViewOptions kullanın ve aynı düzen adını belirterek PDF çıktısı alın.”

S: Düzen çıkarma ile ilgili daha fazla örnek nerede bulunabilir?
C: “Resmi dokümantasyon ve API referansı, toplu işleme ve özel render hatları için ek kod parçacıkları içerir.”

Pratik Uygulamalar

  1. Mimari sunumlar – Müşteri toplantısı için gereken sadece kat planı düzenini gösterin.
  2. Üretim incelemeleri – Tam montajı yüklemeden toleransları tartışmak için bir bileşen görünümünü izole edin.
  3. E‑öğrenme modülleri – Daha net öğretim için web tabanlı bir öğreticide tek bir CAD görünümünü gömün.
  4. Belge yönetimi entegrasyonu – DWG dosyalarını bir içerik deposuna yüklerken düzen‑özel ön izlemeleri otomatik çıkarın.
  5. Özel raporlama – Tek bir çizim görünümüne odaklanan HTML raporları oluşturun, dosya boyutunu ve yükleme süresini azaltın.

Performans İpuçları

  • Viewer örneğini yeniden kullanın mümkün olduğunda birden fazla dosya için; dahili kaynakları önbelleğe alır ve sonraki render’ları hızlandırır.
  • Akışı etkinleştirin Viewer.setRenderMode(RenderMode.Stream) çağırarak bellek ayak izini düşük tutun.
  • Çıktı HTML’yi web sunucusunda gzip ile sıkıştırarak istemci tarafı yükleme sürelerini daha da iyileştirin.

Sonuç

Artık GroupDocs.Viewer for Java kullanarak bir DWG dosyasından belirli bir düzeni render’lamak için eksiksiz, üretime hazır bir yaklaşıma sahipsiniz. Tek bir düzeni hedefleyerek render süresini azaltır, bellek tüketimini düşürür ve web portallarından iç panellere kadar her yere gömülebilen temiz HTML üretirsiniz.

Sonraki adımlar

  • Farklı düzen adlarını, örneğin "Top View" veya "Section A" deneyerek çıktının nasıl değiştiğini görün.
  • Aynı düzenin PDF sürümüne ihtiyacınız varsa PdfViewOptions‘ı keşfedin.
  • Bu tekniği GroupDocs.Annotation ile birleştirerek render edilen HTML’e filigranlar veya yorumlar ekleyin.

Son Güncelleme: 2026-06-20
Test Edilen Versiyon: GroupDocs.Viewer for Java 25.2
Yazar: GroupDocs

Kaynaklar

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

İlgili Eğitimler