גרפיקה וציור

גרפיקה וציור

גרפיקה וציור

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 של העמוד — אל תוסיף אותו להערות.

בעיות נפוצות

IssueCauseFix
הצורה אינה נראיתמימדי הגרף קטנים מדי עבור קואורדינטות הצורההגדל את הרוחב/גובה של 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)

ראה גם

 עברית