معالج ملفات Aspose.Words SVG لـ .NET

Aspose.Words SVG File Processor for .NET يسمح لك بإنشاء وتعديل وتخزين SVG الرسومات من تطبيقات .NET الخاصة بك. لأن Aspose.Words لا تحميل SVG كشكل من أشكال الوثيقة، ويهدف هذا المكون الإضافي لاستخدامها مع ملحقات التحويل (على سبيل المثال، DOCX/HTML/PDF/SVG) أو أي استيراد أعلى التي تنتج علامة SVg.

تثبيت وإعداد

  • إضافة حزمة Aspose.Words for .NET NuGet إلى مشروعك التثبيت الدليل.
  • إعداد الترخيص المقياس مرة واحدة في تطبيق بدء التشغيل ترخيص مقيد .

ملاحظة: يوفر هذا المكون الإضافي سطح API يركز على SVG الذي يكمل، وليس يحل محل، ميزات Aspose.Words الأساسية.

الخصائص والقدرات

إنشاء وثيقة SVG

  • تثبيت SVG الجديد في الرمز، إعداد width, height, و viewBox.
  • اختر الوحدات المطلقة (px،mm،in) أو الاعتماد على viewBox للخروج الاستجابة.

أشكال وطرق

  • قم بإنشاء وتعديل العناصر rect ، circle و ellipse ، line , polyline واللون البوليغوني.
  • دعم القيادة الكاملة الطريق (M/L/H/V/C/S/Q/T/A/Z) مع خيارات إدخال / إزالة ، التحويلات ، وإدراج / ملء.

الكتابة والنصوص

  • إضافة <text> و <tspan> الأقواس مع عائلة الخط، الحجم، الوزن، تغيير الخط الأساسي، حرف/كلمة الفضاء، والتوجيهات (بدء/متوسط/نهاية).
  • تطبيق CSS-like styling inline أو من خلال تعريفات الفئة قابلة للاستخدام.

المجموعات & Layering

  • تنظيم المحتوى مع <g> المجموعات؛ تطبيق التحويلات على مستوى المجموعة (ترجمة / مقياس / دورة / سكو).
  • مجموعات النعناع لتجسيد الهرمات على الطراز الطبقة.

الكلمات الدلالية, النماذج, الفلاتر

  • حدد **الدرجات الخطية / الإشعاعية ** ، النماذج ، وإشارتها بـ ID.
  • ضع ** الفلاتر** (اللون، الظل، المصفوفة الملونة) للتأثيرات البصرية المتقدمة.

صورة إدراج

  • إدخال صور راستر عبر <image> باستخدام URIs الخارجية أو Base64 البيانات.
  • وضع التحكم، الحجم (مع الحفاظ على AspectRatio)، والغموض.

تحويل التكامل

  • التدفق النموذجي: Import (على سبيل المثال، DOCX→SVG) → Refine مع معالج ملفات SVG (تعديل الألوان، وإضافة علامات المياه، وتحسين المسارات) • Save.
  • الحفاظ على أو إعادة كتابة الهوية والفصول الدراسية والملفات أثناء ما بعد المعالجة.

التصنيف والتصدير

  • قم بتخزين SVG المدمج أو المطبوع.
  • اختياريًا إدراج الموارد (المصادر / الصور) أو الحفاظ عليها خارجية.
  • توفير علامة تتوافق مع المعايير المتوافقة مع العلامات التجارية الحديثة.

البدء السريع: إنشاء وثيقة SVG 

// Pseudocode for the plugin’s SVG API surface

var svg = new SvgDocument(width: 800, height: 400, viewBox: "0 0 800 400");

// Background rectangle
var bg = svg.AddRect(x: 0, y: 0, width: 800, height: 400);
bg.Fill = "#ffffff";

// Title text
var title = svg.AddText("Quarterly Sales", x: 400, y: 40);
title.FontFamily = "Segoe UI";
title.FontSize = 24;
title.TextAnchor = SvgTextAnchor.Middle;

// A sample path (rounded shape)
var path = svg.AddPath("M40,120 C120,20 280,20 360,120 S600,220 720,120");
path.Stroke = "#0066cc";
path.StrokeWidth = 3;
path.Fill = "none";

// Group with transform
var g = svg.AddGroup();
g.Transform = "translate(60, 220) scale(1.2)";
g.AddCircle(cx: 0, cy: 0, r: 8).Fill = "#ff6a00";
g.AddText("Marker", x: 16, y: 4).FontSize = 12;

// Save to file/stream
using var fs = File.Create(@"C:\out\diagram.svg");
svg.Save(fs, prettyPrint: true);

ما بعد العملية SVG المستورد (DOCX → SvG → tweak → save) 

// Assume 'svgMarkup' comes from a converter plugin (e.g., Document → Save as SVG)
var svg = SvgDocument.LoadFromString(svgMarkup);

// Example: recolor all elements with class="accent"
foreach (var el in svg.Query(".accent"))
    el.Fill = "#1abc9c";

// Add a watermark group
var wm = svg.AddGroup();
wm.Opacity = 0.08;
wm.Transform = "rotate(-20 400 200)";
var wText = wm.AddText("CONFIDENTIAL", x: 400, y: 220);
wText.TextAnchor = SvgTextAnchor.Middle;
wText.FontFamily = "Segoe UI";
wText.FontSize = 64;
wText.Fill = "#000000";

svg.Save(@"C:\out\refined.svg");

نصائح وأفضل الممارسات

  • استخدام viewBox مع إحداثيات نسبية للرسومات الاستجابة.
  • مجموعة بحكمة : تطبيق التحويلات على المجموعات بدلا من العنصر الواحد لتبسيط التسمية.
  • ضع defs (الجراديين ، النماذج ، الرموز ، الفلاتر) في الجزء العلوي والمرجع بواسطة ID.
  • الحفاظ على خرائط البيت الأبيض الكبيرة ** الخارجية** لأصغر SVGs ؛ إدراج الأصول الصغيرة فقط.
  • يفضل **الطباعة الجميلة ** أثناء التطوير؛ minify في الإنتاج.
  • ابدأ الترخيص المقياس في وقت مبكر لتجنب الانقطاع.

خطأ التعامل والتصديق

  • يقوم المعالج بتأكيد الخصائص والهوية والمرجعية المطلوبة.
  • استثناءات واضحة للمسارات المكسورة أو التحولات غير المشروعة أو المفقودة defs الهدف.
  • الوضع الاختياري “الخفيف” يمكن التغلب على القضايا غير الحرجة ومواصلة التسلسل.

Performance

  • تحميل / حفظ للوثائق الكبيرة.
  • إعادة استخدام تعريفات الجرادين / الفلتر لتجنب ضمائر مزدوجة.
  • استعلام من خلال اختياري الوزن الخفيف (على معرف / فئة / اسم) للتحرير السريع.
 عربي