GroupDocs.Annotation הוא בלתי תלוי בממשק משתמש. הוא קורא וכותב סימונים בתוך מסמכים ולא מצייר דבר על המסך. עבור ספרייה צד‑שרת זהו הפיצול הנכון — וזה משאיר שאלה אחת לכל מי שמאמץ אותה: איך בפועל מציירים את הסימון?
התשובות הרגילות כבדות: לשלב מציג מסחרי, או לאמץ את הדוגמה ב‑Angular ואז לנסות להרחיב אותה. ישנה אפשרות קלה יותר. תמונות דפים, קנבס ושישה נקודות קצה — ללא רכיב מציג, ללא מסגרת קידום, ללא שלב בנייה, ללא CDN. היא גם פועלת ללא גישה לרשת חיצונית כלל, מה שהופך אותה לחשובה יותר מבעבר.
הדוגמה זמינה ב‑GitHub:
browser-annotation-ui-net —
dotnet run וגררו ריבוע על העמוד.
הרעיון בפסקה אחת
מייצרים תמונת PNG של כל דף פעם אחת בלי סימונים ושומרים במטמון. שולחים את רשימת הסימונים לדפדפן כנתונים. הקנבס מצייר את הסימון מעל התמונה. הוספת תגובה היא כתיבה קטנה למסמך בתוספת רענון של הרשימה — לא רינדור מחדש של הדף — והסימון נשאר נבחר, ניתן ללחיצה ולתשובה במקום להיות משולב בתמונה.
נקודות הקצה
| שיטה | נתיב | מטרה |
|---|---|---|
GET |
/api/documents/{name}/info |
מספר העמודים והגודל של כל עמוד, בנקודות |
GET |
/api/documents/{name}/pages/{n}/image |
PNG של עמוד n |
GET |
/api/documents/{name}/annotations |
כל סימון כריבוע אחד ביחידות דף |
POST |
/api/documents/{name}/annotations |
הוספת אחד |
PUT |
/api/documents/{name}/annotations/{id} |
שינוי ההודעה או הוספת תגובה |
DELETE |
/api/documents/{name}/annotations/{id} |
הסרת אחד |
כל כתיבה מחזירה את הרשימה המלאה, כך שהדפדפן לעולם לא צריך להסיק מה השרת מחזיק כעת.
רינדור
PreviewOptions previewOptions = new(page => File.Create(CachePath(name, page)))
{
PreviewFormat = PreviewFormats.PNG,
PageNumbers = new[] { pageNumber }, // 1‑based
RenderAnnotations = false, // הקנבס מצייר את הסימון
Resolution = 144
};
annotator.Document.GeneratePreview(previewOptions);
השוו את חותמת הזמן של התמונה במטמון מול חותמת הזמן של המסמך ורינדרו מחדש רק כאשר המסמך השתנה בפועל.
פיקסלים נכנסים, יחידות דף יוצאות
הקנבס שומר את הריבוע שלו בפיקסלים של התמונה ושולח את גודל התמונה שעליה הוא צייר — לא גורם קנה מידה:
body: JSON.stringify({
page: currentPage,
x, y, width, height,
imageWidth: img.clientWidth,
imageHeight: img.clientHeight,
message: window.prompt('Comment'),
user: 'Reviewer'
})
ההחלטה הזאת היא מה ששומרת על הממשק נכון כאשר רזולוציית התצוגה משתנה, כאשר CSS משנה את גודל התמונה, או כאשר מישהו פותח זאת בטלפון. השרת מבצע את החישוב:
double scaleX = page.Width / request.ImageWidth;
double scaleY = page.Height / request.ImageHeight;
annotator.Add(new AreaAnnotation
{
PageNumber = page.PageNumber - 1, // PageInfo הוא 1‑based, סימונים הם 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 נמדד מזווית העליונה‑שמאלית של העמוד — באותו כיוון שהדפדפן מודד — ולכן ריבוע מצויר ממופה עם קנה מידה וללא הפיכה.
שליחת צורת ריבוע אחת לדפדפן
סימון טקסט אינו חולק את המקור הזה. HighlightAnnotation.Points והקשרים שלו נמדדים מזווית תחתונה‑שמאלית. המירו בשרת, כך שהקצה הקדמי רואה רק ריבועים עליונים‑שמאליים:
x = minX;
y = page.Height - maxY; // הפיכה ל‑top‑left
width = maxX - minX;
height = maxY - minY;
עשו זאת וסימון היילייט שהתווסף ב‑Word, ב‑Acrobat, או על‑ידי מעבר ביקורת אוטומטי יופיע במיקום הנכון בממשק שלכם מבלי שה‑JavaScript ידע דבר על גאומטריית PDF.
כתיבות מחליפות קבצים
ה‑annotator מחזיק את המקור פתוח ולא יכול לשמור מעל הקובץ שהוא קורא:
using (Annotator annotator = new Annotator(path))
{
annotator.Add(annotation);
annotator.Save(path + ".tmp");
}
File.Move(path + ".tmp", path, overwrite: true);
InvalidatePreviewCache(name);
קחו נעילה לכל מסמך סביב כל הרצף. שני בקשות שקוראות, משנות ושומרות את אותו קובץ בו‑זמנית יאבדו אחת מהשינויים.
מה העיצוב הזה לא פותר
כדאי לומר זאת בגלוי, מכיוון שזה מחליט אם אפשר לשחרר אותו כפי שהוא:
- מזהי סימון משתנים אחרי כתיבה. הם מוקצים בזמן קריאת המסמך, ולא נשמרים בו. ממשק שמרענן את הרשימה אחרי כל שינוי הוא בסדר. מערכת מרובת משתמשים צריכה לשמור סימונים בטבלה משלה ולבצע ייבוא וייצוא כדי להעביר אותם פנימה והחוצה מהקובץ — כך גם מתקבל יומן ביקורת ונראות לפי משתמש.
- המסמך כולו נכתב מחדש בכל שינוי. זה מתאים לחוזה של 30 עמודים, אך לא לארכיון של 2,000 עמודים.
- אין אימות זהות. כל קורא בדוגמה הוא “Reviewer”.
הרצת הדוגמה
git clone https://github.com/groupdocs-annotation/browser-annotation-ui-net.git
cd browser-annotation-ui-net
dotnet run --project src/AnnotationUi
או במכולה, עם --network none אם ברצונכם לצפות בו פועל ללא יציאה לרשת כלל:
docker build -t annotation-ui .
docker run --rm -p 8080:8080 annotation-ui
הגרסה הצעד‑אחר‑צעד נמצאת בתיעוד:
בנו ממשק סימון לאפליקציית האינטרנט שלכם.
אם כבר משולב מציג PDF ב‑JavaScript, שמרו אותו לתצוגה והשתמשו בנקודות הקצה האלה רק לאחסון — אף אחד מכללי הגאומטריה לא משתנה.