[Bug] Stamp annotations imported via importAnnotations are invisible

オープン
#855 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
38/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
javascript, typescript
領域
frontend

調査の方向性

Start by running the reproduction HTML from the issue: place a stamp, export with exportAnnotations, re-init, then importAnnotations, and check whether the stamp renders. The payload names only the annotation plugin API (importAnnotations, exportAnnotations, the stamp tool) and the stamp's ctx.data ArrayBuffer, not specific files. Done means a stamp imported from exported data renders in the same position as before the viewer was destroyed.

索引モデルが issue の本文から書いたものです。

説明

Description

When exporting a stamp annotation and subsequently importing it back into a freshly initialized viewer via importAnnotations, the stamp becomes completely invisible.

The data exported by exportAnnotations contains a valid ArrayBuffer for the stamp's ctx.data, and importAnnotations accepts it without throwing any errors. However, the stamp fails to render visually. It seems the appearance stream (/AP) is being lost or ignored when the stamp is recreated during the import phase.

Steps to Reproduce

We have created a zero-dependency Minimal Reproducible Example (MRE) using the raw @embedpdf/snippet library to prove this is not related to external frameworks or serialization:

  1. Save the HTML file below and open it in a browser.
  2. Click "1. Init & Load PDF".
  3. Place a Stamp anywhere on the document.
  4. Click "2. Export & Destroy" (This saves the raw exportAnnotations() output to an in-memory variable and completely clears the DOM/viewer instance).
  5. Click "3. Re-Init & Import" (This spawns a fresh viewer, loads the PDF, and calls importAnnotations(savedAnnotations) using the raw memory data).
Expected Behavior

The stamp should be fully visible exactly where it was placed before the viewer was destroyed.

Actual Behavior

The import succeeds silently without errors, but the stamp is completely invisible on the document.

Minimal Reproducible Example
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>EmbedPDF Stamp MRE</title>
    <style>
        body, html { margin: 0; padding: 0; height: 100%; font-family: sans-serif; display: flex; flex-direction: column; }
        #controls { padding: 15px; background: #f0f0f0; border-bottom: 1px solid #ccc; display: flex; gap: 10px; align-items: center; }
        button { padding: 8px 16px; cursor: pointer; }
        #status { font-weight: bold; margin-left: 20px; color: #333; }
        #viewer-container { flex: 1; position: relative; background: #888; }
        #pdf-viewer { width: 100%; height: 100%; }
    </style>
</head>
<body>
    <div id="controls">
        <button id="btn-load">1. Init & Load PDF</button>
        <button id="btn-export">2. Export & Destroy</button>
        <button id="btn-import">3. Re-Init & Import</button>
        <span id="status">Ready. Click 'Init & Load PDF'</span>
    </div>
    <div id="viewer-container">
        <div id="pdf-viewer"></div>
    </div>

    <script type="module">
        import EmbedPDF from 'https://cdn.jsdelivr.net/npm/@embedpdf/snippet@2/dist/embedpdf.js';

        const pdfUrl = 'https://raw.githubusercontent.com/mozilla/pdf.js/ba2edeae/web/compressed.tracemonkey-pldi-09.pdf';
        
        let savedAnnotations = null;
        let viewerInstance = null;
        let annotationApi = null;
        
        async function initViewer() {
            const targetId = 'pdf-viewer';
            document.getElementById('viewer-container').innerHTML = `<div id="${targetId}"></div>`;
            
            viewerInstance = EmbedPDF.init({
                type: 'container',
                target: document.getElementById(targetId),
                documentManager: { maxDocuments: 1 }
            });
            
            const registry = await viewerInstance.registry;
            const docManager = registry.getPlugin('document-manager').provides();
            annotationApi = registry.getPlugin('annotation').provides();
            
            await docManager.openDocumentUrl({
                url: pdfUrl,
                documentId: 'test-document',
                autoActivate: true
            });
        }

        document.getElementById('btn-load').onclick = async () => {
            document.getElementById('status').textContent = 'Loading...';
            await initViewer();
            annotationApi.setActiveTool('stamp');
            document.getElementById('status').textContent = 'Loaded! Please place a STAMP, then click step 2.';
        };

        document.getElementById('btn-export').onclick = async () => {
            if (!annotationApi) return;
            document.getElementById('status').textContent = 'Exporting...';
            
            savedAnnotations = await new Promise((resolve) => {
                annotationApi.exportAnnotations().wait(
                    items => resolve(items),
                    err => { console.error(err); resolve([]); }
                );
            });
            
            document.getElementById('viewer-container').innerHTML = ''; 
            viewerInstance = null;
            annotationApi = null;
            document.getElementById('status').textContent = 'Destroyed! Annotations saved to variable. Now click step 3.';
        };

        document.getElementById('btn-import').onclick = async () => {
            if (!savedAnnotations) return alert("Please export first!");
            
            document.getElementById('status').textContent = 'Re-initializing...';
            await initViewer();
            
            const result = annotationApi.importAnnotations(savedAnnotations);
            if (result && typeof result.wait === 'function') {
                await new Promise(resolve => result.wait(resolve, resolve));
            }
            
            document.getElementById('status').textContent = 'Imported! The stamp is now invisible.';
        };
    </script>
</body>
</html>
Environment
  • EmbedPDF Version: @embedpdf/snippet@2
  • Browser: Firefox 156.01
  • OS: Arch Linux
主要言語
TypeScript
スター
4.5k
フォーク
317
平均マージ
10時間 16分
マージ済み PR(30日)
174

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

embedpdf/embed-pdf-viewer のほかの issue

embedpdf/embed-pdf-viewer の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。