GroupDocs.Annotation UI‑bağımsızdır. Belgeler içinde işaretlemeyi okur ve yazar ve ekranda hiçbir şey çizmez. Sunucu kütüphanesi için bu doğru bölünmedir — ve bunu benimseyen herkes için bir soru bırakır: bir kişi gerçekten işareti nasıl çizer?
Geleneksel yanıtlar ağırdır: ticari bir görüntüleyici gömmek ya da Angular demosunu benimseyip ardından genişletmeye çalışmak. Daha hafif bir seçenek var. Sayfa görüntüleri, bir canvas ve altı uç nokta — görüntüleyici bileşeni yok, ön‑uç çerçevesi yok, derleme adımı yok, CDN yok. Ayrıca tamamen dış ağa erişim olmadan çalışır, bu da eskisinden daha önemlidir.
Örnek GitHub’da bulunuyor: browser-annotation-ui-net — dotnet run ve sayfada bir kutu sürükleyin.
Tek bir paragrafta fikir
Her sayfayı bir kez işaretleme olmadan PNG olarak oluşturup önbelleğe alın. İşaretleme listesini tarayıcıya veri olarak gönderin. Canvas, işaretlemeyi görüntünün üzerine çizer. Bir yorum eklemek, belgeye küçük bir yazma işlemi ve listenin yeniden yüklenmesi demektir — sayfanın yeniden oluşturulması değil — ve işaretleme seçilebilir, tıklanabilir ve yanıtlanabilir kalır, bir resme gömülmez.
Uç noktalar
| Yöntem | Yol | Amaç |
|---|---|---|
GET |
/api/documents/{name}/info |
sayfa sayısı ve her sayfanın boyutu, puan cinsinden |
GET |
/api/documents/{name}/pages/{n}/image |
n sayfasının PNG’si |
GET |
/api/documents/{name}/annotations |
her işaretleme, sayfa birimlerinde bir dikdörtgen olarak |
POST |
/api/documents/{name}/annotations |
bir tane ekle |
PUT |
/api/documents/{name}/annotations/{id} |
mesajı değiştir veya bir yanıt ekle |
DELETE |
/api/documents/{name}/annotations/{id} |
bir tane kaldır |
Her yazma işlemi tam listeyi döndürür, böylece tarayıcının sunucunun şu anda ne tuttuğu hakkında bir şey düşünmesi gerekmez.
Oluşturma
PreviewOptions previewOptions = new(page => File.Create(CachePath(name, page)))
{
PreviewFormat = PreviewFormats.PNG,
PageNumbers = new[] { pageNumber }, // 1-based
RenderAnnotations = false, // the canvas draws the markup
Resolution = 144
};
annotator.Document.GeneratePreview(previewOptions);
Önbellekteki görüntünün zaman damgasını belgenin zaman damgasıyla karşılaştırın ve belge gerçekten değiştiğinde yalnızca yeniden oluşturun.
Piksel girişi, sayfa birimi çıkışı
Canvas, dikdörtgenini görüntü pikselleriyle tutar ve çizdiği görüntünün boyutunu gönderir — ölçek faktörü değil:
body: JSON.stringify({
page: currentPage,
x, y, width, height,
imageWidth: img.clientWidth,
imageHeight: img.clientHeight,
message: window.prompt('Comment'),
user: 'Reviewer'
})
Bu tek karar, ön izleme çözünürlüğü değiştiğinde, CSS görüntüyü ölçeklendirdiğinde veya birisi telefonu üzerinden açtığında UI’nın doğru kalmasını sağlar. Sunucu aritmetiği yapar:
double scaleX = page.Width / request.ImageWidth;
double scaleY = page.Height / request.ImageHeight;
annotator.Add(new AreaAnnotation
{
PageNumber = page.PageNumber - 1, // PageInfo is 1-based, annotations are 0-based
Box = new Rectangle(
(float)(request.X * scaleX), (float)(request.Y * scaleY),
(float)(request.Width * scaleX), (float)(request.Height * scaleY)),
BackgroundColor = 0xFFE699,
PenColor = 0xE08C00,
Opacity = 0.35,
Message = request.Message,
User = new User { Id = 1, Name = request.User, Role = Role.Editor }
});
AreaAnnotation.Box, sayfanın sol‑üst köşesinden ölçülür — tarayıcının ölçtüğü aynı yönde — böylece çizilen kutu ölçekle eşleşir ve ters çevrilmez.
Tarayıcıya tek bir dikdörtgen şekli gönder
Metin işaretlemesi bu kökeni paylaşmaz. HighlightAnnotation.Points ve akrabaları sol‑alt köşeden ölçülür. Sunucuda dönüştürün, böylece ön uç yalnızca sol‑üst kutuları görür:
x = minX;
y = page.Height - maxY; // flip to top-left
width = maxX - minX;
height = maxY - minY;
Bunu yapın ve Word, Acrobat içinde ya da bir otomatik inceleme geçişi ile eklenen vurgulama, UI’nızda doğru yerde görünür; JavaScript PDF geometrisi hakkında hiçbir şey bilmez.
Yazma işlemi geçici dosyalar oluşturur
Annotator kaynağı açık tutar ve okuduğu dosyanın üzerine kaydedemez:
using (Annotator annotator = new Annotator(path))
{
annotator.Add(annotation);
annotator.Save(path + ".tmp");
}
File.Move(path + ".tmp", path, overwrite: true);
InvalidatePreviewCache(name);
Tüm işlem boyunca belge başına bir kilit alın. Aynı anda aynı dosyayı okuyan, değiştiren ve yeniden yazan iki istek, değişikliklerden birini kaybeder.
Bu tasarımın çözmediği şeyler
Açıkça söylemek gerekir, çünkü bu, mevcut haliyle dağıtıp dağıtamayacağınızı belirler:
- İşaretleme kimlikleri bir yazmadan sonra değişir. Belge okunurken atanırlar, içinde saklanmazlar. Her değişiklikten sonra listeyi yeniden yükleyen bir UI sorun olmaz. Çok‑kullanıcılı bir sistem, işaretlemeleri kendi tablosunda tutmalı ve dosyaya aktarma/ dışa aktarma yoluyla taşımalıdır — bu aynı zamanda bir denetim izi ve kullanıcı‑bazlı görünürlük sağlar.
- Her değişiklikte tüm belge yeniden yazılır. 30 sayfalık bir sözleşme için uygundur, 2 000 sayfalık bir arşiv için yanlıştır.
- Kimlik doğrulama yoktur. Örnekteki her çağırıcı “Reviewer"dır.
Çalıştırma
git clone https://github.com/groupdocs-annotation/browser-annotation-ui-net.git
cd browser-annotation-ui-net
dotnet run --project src/AnnotationUi
Ya da bir konteyner içinde, --network none ile tamamen dışa çıkış olmadan çalışmasını izlemek isterseniz:
docker build -t annotation-ui .
docker run --rm -p 8080:8080 annotation-ui
Adım adım sürüm belgelerde bulunabilir: Web uygulamanız için bir işaretleme UI’si oluşturun. Zaten bir JavaScript PDF görüntüleyici gömülü ise, bunu sadece görüntüleme için tutun ve bu uç noktaları yalnızca depolama için kullanın — geometrik kuralların hiçbiri değişmez.