إضافة وسيلة شرح للصورة في C# | وسائل شرح للصور | وسائل شرح الصورة

وسيلة شرح الصورة هي عنصر رسومي يساعد في جذب الانتباه إلى أجزاء معينة من الصورة أو الصورة. تُعد وسائل الشرح سلاحًا سريًا لجعل أي محتوى مرئي أكثر وضوحًا وتأثيرًا. فكر فيها كأضواء كاشفة صغيرة تسلط على الأجزاء الأكثر أهمية في صورتك. في هذه المقالة، سوف نتعلم كيفية إضافة وسائل شرح للصور في لغة #C.

تتناول هذه المقالة المواضيع التالية:

  1. ما هي وسائل شرح الصور
  2. واجهة برمجة تطبيقات #C لإضافة وسائل شرح للصور
  3. كيفية إضافة وسائل الشرح إلى الصور في لغة #C
  4. مصادر مجانية

ما هي وسائل شرح الصور؟

وسائل شرح الصور هي تسميات إعلامية يتم تركيبها على الصورة لجذب الانتباه إلى أجزاء معينة وشرح أهميتها. يمكن أن تكون وسائل شرح الصور على شكل خطوط أو أسهم بادئة، تربط نص وسيلة الشرح بشكل مرئي بالمناطق المميزة في الصور. ويمكن أن تكون عبارة عن مربعات نصية لوسائل الشرح، تحتوي على شرح موجز أو تعريف للعناصر المشار إليها.

تُستخدم وسائل شرح الصور بشكل شائع في:

  • المستندات الفنية والبرامج التعليمية: للإشارة إلى ميزات أو وظائف محددة في لقطات الشاشة أو الرسوم البيانية.
  • العروض التقديمية: للتأكيد على العناصر الأساسية داخل الصورة.
  • المواد التعليمية: لتسمية أجزاء من الرسم التوضيحي أو الرسم البياني.

C# API لإضافة وسائل شرح الصور

لإضافة وسائل شرح الصور برمجيًا في لغة #C، سنستخدم واجهة برمجة التطبيقات Aspose.Drawing for .NET. إنها مكتبة رسومات ثنائية الأبعاد عبر الأنظمة الأساسية لرسم النصوص والأشكال الهندسية والصور برمجيًا. يوفر وظيفة إنشاء وسائل الشرح وإضافتها إلى صورك.

يرجى إما تنزيل ملف DLL الخاص بواجهة برمجة التطبيقات (API) أو تثبيته باستخدام NuGet.

PM> Install-Package Aspose.Drawing

كيفية إضافة وسائل الشرح إلى الصور في C#

يمكننا بسهولة إضافة وسائل الشرح إلى الصور برمجياً باتباع الخطوات التالية:

  1. قم بتحميل الصورة باستخدام طريقة Image.FromFile().
  2. قم بإنشاء كائن رسومات جديد باستخدام أسلوب FromImage().
  3. قم بتهيئة كائن فئة القلم باللون والحجم المحددين لرسم وسائل الشرح.
  4. حدد موضع عنصر وسيلة الشرح باللون والحجم المحددين.
  5. بعد ذلك، قم بكتابة النص باستخدام طريقة DrawString().
  6. وأخيرًا، احفظ الصورة الناتجة باستخدام طريقة Save().

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة وسائل الشرح إلى الصورة في #C.

using System.Drawing;
using System.Drawing.AsposeDrawing;
using System.Drawing.Imaging;
using System.Drawing.Text;

using (var image = Image.FromFile("gears.png"))
{
    var graphics = Graphics.FromImage(image);

    graphics.TextRenderingHint = TextRenderingHint.AntiAliasGridFit;
    graphics.PageUnit = GraphicsUnit.Pixel;

    DrawCallOut(graphics, new PointF(107, 55), new PointF(179, 5), 74, "mm");

    DrawCallOut(graphics, new PointF(111, 146), new PointF(29, 180), 28, "mm");

    image.Save("gears_with_callout.jpg");
}


void DrawCallOut(Graphics graphic, PointF startAnchor, PointF endAnchor, int value, string unit)
{
    Pen pen = new Pen(Color.Red, 1);

    Font font = new Font("Arial", 10, FontStyle.Bold);

    string outputValue = $"{value} {unit}";

    var textSize = graphic.MeasureString(outputValue, font);

    int diameterSymbolSize = 12;
    int spaceSize = 3;

    textSize.Width += diameterSymbolSize + spaceSize;

    float callOutMiddleX = endAnchor.X > startAnchor.X ? endAnchor.X - textSize.Width : endAnchor.X + textSize.Width;
    float callOutMiddleY = endAnchor.Y > startAnchor.Y ? endAnchor.Y - textSize.Height : endAnchor.Y + textSize.Height;

    graphic.DrawLine(pen, startAnchor.X, startAnchor.Y, callOutMiddleX, callOutMiddleY);

    float textAnchorX = Math.Min(callOutMiddleX, endAnchor.X);
    float textAnchorY = callOutMiddleY;
    graphic.DrawLine(pen, callOutMiddleX, callOutMiddleY,
                        textAnchorX == callOutMiddleX ? textAnchorX + textSize.Width : textAnchorX,
                        callOutMiddleY);

    graphic.DrawEllipse(pen, new Rectangle((int)textAnchorX + spaceSize,
                                            (int)(textAnchorY - textSize.Height) + spaceSize, 10, 10));

    graphic.DrawLine(pen, (int)textAnchorX + 1, (int)textAnchorY - 1,
                            (int)textAnchorX + diameterSymbolSize + 2,
                            (int)textAnchorY - diameterSymbolSize - 2);

    SolidBrush brush = new SolidBrush(Color.Blue);

    graphic.DrawString(outputValue, font, brush, (int)textAnchorX + diameterSymbolSize + spaceSize,
                                                    (int)(textAnchorY - textSize.Height));
}
إضافة وسائل الشرح إلى الصور في C#

إضافة وسائل الشرح إلى الصور في C#

احصل على ترخيص مجاني

يمكنك الحصول على ترخيص مؤقت مجاني لتجربة Aspose.Drawing for .NET دون قيود التقييم.

وسائل شرح للصور – موارد مجانية

إلى جانب إضافة وسائل الشرح إلى الصور والصور، يمكنك استكشاف العديد من الميزات الأخرى للمكتبة باستخدام الموارد أدناه:

خاتمة

في هذا المنشور، تعلمنا كيفية إضافة وسائل شرح للصور والصور برمجياً في لغة #C. يمكن أن تكون إضافة وسائل الشرح إلى الصور طريقة بسيطة ولكنها فعالة لتحسين المظهر المرئي وسهولة الاستخدام للمحتوى الخاص بك. باتباع الخطوات الموضحة واستخدام مثال التعليمات البرمجية المقدم، يمكنك بسهولة جذب الانتباه إلى العناصر الأساسية داخل صورك. في حالة وجود أي غموض، فلا تتردد في الاتصال بنا على منتدى الدعم المجاني.

أنظر أيضا