Penampil

Viewer (namespace Doconut) adalah titik masuk publik untuk membuka dokumen dari halaman Razor, kontroler MVC, komponen Blazor, atau API minimal. Kelas ini sealed, terdaftar sebagai layanan transient oleh AddDoconut(), dan di‑resolve melalui injeksi konstruktor — jangan pernah membuatnya secara langsung.

Viewer tidak menyimpan keadaan per‑permintaan dan dengan sengaja tidak mengimplementasikan IDisposable: sesi dokumen hidup secara independen di cache sesi, sehingga membuang layanan tidak akan pernah menutup dokumen yang terbuka (lihat Konsep Inti → Cara Kerja Penampil).

OpenDocumentAsync

Membuka sebuah dokumen dan mengembalikan token sesi yang digunakan widget klien untuk semua permintaan berikutnya.

// Simple open
string token = await viewer.OpenDocumentAsync(path);

// With per-format config and options
token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig { AllowSearch = true, AllowCopy = true },
    new DocOptions { TimeOut = 30 });

// From an upload
await using var ms = new MemoryStream();
await file.CopyToAsync(ms);
ms.Position = 0;
token = await viewer.OpenDocumentAsync(ms, new FileInfo(file.FileName));

Pengecualian yang harus ditangani:

• LicenseException — lisensi yang ditemukan ditolak (pesan berisi alasan penolakan), atau format memerlukan kemampuan plugin yang tidak lagi diberikan. Kedaluwarsa kalender tanpa pesan penolakan beralih ke rendering ber‑watermark alih‑alih melempar pengecualian.
• FormatNotSupportedException — Document format '<extension>' is not supported.
• InvalidDataException — konten file rusak atau tidak cocok dengan ekstensi nya.

CloseDocument

void CloseDocument(string token)

Menghapus sesi dari cache (menyelesaikan mesin dokumen secara langsung), menghapus penanda keamanan, dan mencabut hak akses. Opsional — kedaluwarsa bergulir melakukan pembersihan yang sama — tetapi disarankan untuk dokumen berukuran besar.

GetPageCount

int GetPageCount(string token)

Jumlah total halaman dari sesi yang terbuka. Melempar pengecualian jika token tidak dikenal atau kedaluwarsa.

DocOptions

Opsi independen format per‑buka (namespace Doconut):

Kelas ini juga mengekspos properti khusus yang sengaja berada di luar alur tampilan satu‑host standar:

Watermark Kustom

DocOptions.Watermark menggunakan enam bidang yang dipisahkan tilde. Awalan opsional ^ meminta tata letak semua sudut:

^Text~Color~FontSize~FontName~Opacity~Angle

string token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig(),
    new DocOptions
    {
        Watermark = "^Confidential~Red~24~Verdana~80~-45",
        TimeOut = 30
    });

Parser mengharapkan tepat enam bidang setelah ^ opsional. Definisi yang tidak valid diganti dengan fallback Invalid Watermark yang terlihat dari SDK alih‑alih menghilang secara diam‑diam.

Keputusan Lisensi

Keputusan yang sama diterapkan pada gambar halaman yang disajikan dan ekspor anotasi. Output GIF animasi ditandai frame per frame. Watermark khusus oleh karena itu merupakan fitur aplikasi berlisensi, bukan cara untuk mengganti atau menekan watermark evaluasi.

API Anotasi

Pemuatan dan ekspor anotasi sisi‑server. Panduan lengkap ada di Panduan → Anotasi; antarmukanya adalah:

Metadata DICOM

Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default)

Mengembalikan metadata tag DICOM untuk sesi yang dibuka melalui plugin DICOM; null untuk dokumen non‑DICOM.

Pembantu Sumber Daya — ReferenceCss / ReferenceScripts

Menghasilkan tag <link>/<script> untuk sumber daya tersemat yang disajikan oleh UseDoconutResources(), dalam urutan ketergantungan yang tepat. Paket untuk fitur yang dibatasi lisensi seperti pencarian dan anotasi dihasilkan hanya ketika lisensi mengaktifkannya, menjaga UI klien konsisten dengan perilaku server.

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + viewer + search + annotation
string ReferenceScripts(ScriptConfig? config = null)

Flag CssConfig: IncludeBootstrapCss, IncludeViewerCss, IncludeSearchCss (dibatasi pencarian), IncludeAnnotationCss (dibatasi anotasi).

Flag ScriptConfig: IncludeJQuery (dibutuhkan oleh semua yang lain), IncludeBootstrap, IncludeViewerScripts (inti: docViewer.js + splitter + links), IncludeSearchScripts dan IncludeSearchBar (dibatasi pencarian), IncludeAnnotationScripts dan IncludeAnnotationBar (dibatasi anotasi).

@inject Doconut.Viewer Viewer

@Html.Raw(Viewer.ReferenceCss(new CssConfig { IncludeBootstrapCss = true, IncludeViewerCss = true }))
@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig { IncludeJQuery = true, IncludeViewerScripts = true }))