גרפיקה וציור
גרפיקה וציור
Aspose.PDF FOSS for .NET כולל תת‑מערכת ציור להוספת גרפיקה וקטורית
לעמודי PDF. המכולה Graph מכילה אלמנטים של צורה (Line,
Arc, Circle) והיא מתווספת לאוסף Paragraphs של העמוד.
יצירת מכולת גרף
Graph מגדיר אזור ציור עם רוחב וגובה מוגדרים.
using var doc = new Document();
var page = doc.Pages.Add();
var graph = new Graph(400, 200);
page.Paragraphs.Add(graph);ציור קווים
var line = new Line(new float[] { 0, 0, 300, 100 });
graph.Shapes.Add(line);ציור קשתות ומעגלים
var arc = new Arc(150, 100, 80, 0, 180);
graph.Shapes.Add(arc);
var circle = new Circle(150, 100, 50);
graph.Shapes.Add(circle);עבודה עם צבעים
המחלקה Color מספקת שיטות ייצור עבור RGB, ARGB, וצבעים בשם.
var red = Color.FromRgb(1.0, 0.0, 0.0);
var semiTransparent = Color.FromArgb(128, 0, 0, 255);ציור נתיבים
DrawingPath תומך ב-MoveTo, LineTo, CurveTo ו-Close לצורות וקטור חופשיות.
var path = new DrawingPath();
path.MoveTo(10, 10);
path.LineTo(100, 10);
path.CurveTo(150, 50, 150, 100, 100, 100);
path.Close();פורמטים של תמונה
ImageFormat מספק ערכי מונה עבור פורמטים רסטריים המשמשים בעת המרת דפים לתמונות: Bmp, Jpeg, Png, Tiff, Gif.
טיפים ושיטות מומלצות
- הגדר את ממדי הגרף כך שיתאימו לאזור שבו אתה רוצה לצייר — הקואורדינטות בתוך
Graphהן יחסיות לגבולות שלו. - השתמש ב
Color.FromArgbלמילויים חצי‑שקופים (תמיכה בערוץ אלפא). - שלב צורות מרובות ב
Graphיחיד לצורך רינדור יעיל. DrawingPathאידיאלי לעקומות בזייה מורכבות וצורות פוליגון שרירותיות.- הוסף את
GraphלאוסףParagraphsשל העמוד — אל תוסיף אותו להערות.
בעיות נפוצות
| Issue | Cause | Fix |
|---|---|---|
| הצורה אינה נראית | מימדי הגרף קטנים מדי עבור קואורדינטות הצורה | הגדל את הרוחב/גובה של Graph או שנה קנה מידה של קואורדינטות הצורה |
| הצבעים מופיעים שונים בתצוגה | אי התאמה של מרחב הצבע | השתמש ב-Color.FromRgb עם ערכים בטווח 0.0-1.0 |
| הציור חופף טקסט | הגרף ממוקם במיקום שגוי בזרימת הפסקה | התאם את סדר הפסקאות או השתמש ב-FloatingBox למיקום מוחלט |
שאלות נפוצות
האם אני יכול לצייר צורות ממולאות?
כן. הגדר את המאפיין GraphInfo.FillColor של הצורה למילוי בצבע אחיד.
איך למקם גרף בקואורדינטות דף ספציפיות?
עטוף את Graph בFloatingBox והגדר את המאפיינים Left וTop שלו למיקום מוחלט.
האם הספרייה תומכת במעברים?
המחלקות Shading תומכות בתבניות הצללה בסיסיות. השתמש ב-DrawingPath עם הצללה למילויים גרדיאנטיים.
סיכום הפניות API
| מחלקה / שיטה | תיאור |
|---|---|
Graph | מכולה לצורות שניתן לצייר, מתווספת לפסקאות העמוד |
Line | קו ישר בין שניים או יותר נקודות |
Arc | קשת מעגלית המוגדרת על ידי מרכז, רדיוס וזוויות |
Circle | צורת עיגול המוגדרת על ידי מרכז ורדיוס |
DrawingPath | נתיב חופשי עם MoveTo, LineTo, CurveTo, Close |
Color | ערך צבע עם RGB, ARGB ושיטות ייצור |
Color.FromRgb | יצירת צבע מרכיבי RGB |
Color.FromArgb | יצירת צבע עם שקיפות אלפא |
GraphicElementCollection | אוסף של אלמנטים גרפיים בעמוד |
ImageFormat | מנייה של פורמטים של תמונות רסטר (Bmp, Jpeg, Png, Tiff, Gif) |