فراورنده پرونده SVG Aspose.Words برای .NET
Aspose.Words SVG File Processor برای .NET به شما اجازه می دهد تا به صورت برنامه نویسی، ویرایش و ذخیره کنید SVG گرافیک از برنامه های .NET شما. به این دلیل که Aspose.Words به صورت بومی نیست بار SVG به عنوان یک فرمت اسناد، این پلاگین طراحی شده است برای استفاده ** همراه با افزونه های تبدیل** (به عنوان مثال، DOCX/HTML/PDF/SVG) و یا هر واردات در حال حرکت که تولید برچسب سوئیچ.
نصب و نصب
- Aspose.Words for .NET بسته NuGet را به پروژه خود اضافه کنید نصب راهنمای.
- تنظیم مجوز اندازه گیری شده یک بار در اپل استارتاپ مجوز متریکی .
نکته: این پلاگین یک سطح API متمرکز SVG را فراهم می کند که ویژگی های هسته ای Aspose.Words را تکمیل و جایگزین نمی کند.
ویژگی ها و توانایی ها
ایجاد اسناد SVG
- نصب یک SVG جدید در کد، تنظیم
width,height, وviewBox. - واحد های مطلق (px، mm، in) را انتخاب کنید یا به ViewBox برای خروجی پاسخگو تکیه کنید.
شکل ها و مسیرها
- ایجاد و ویرایش ** مستقیم ** ، ** دایره ** , ** ellipse ** ، ** خط ** , ** پلیلین ** و ** polygon** عناصر.
- پشتیبانی کامل از دستورالعمل (M/L/H/V/C/S/Q/T/A/Z) با گزینه های بخش ورودی / حذف، تبدیل و پر کردن.
متن و تایپوگرافی
- اضافه کردن
<text>و<tspan>گره ها با خانواده فونت، اندازه، وزن، تغییر خط پایه، محدوده نامه / کلمه و انکورها (شروع / نیمه / پایان). - استفاده از CSS-like styling inline یا از طریق تعاریف کلاس قابل استفاده مجدد.
جمع آوری و لایه برداری
- محتوا را با
<g>گروه ها؛ تحولات را در سطح گروه اعمال کنید (ترجمه / مقیاس / چرخش / اسکو). - گروه های ناخن برای نشان دادن سلسله مراتب سبک.
گرادین ها، الگوهای، فیلترها
- گرادین های خطی / رادیال ، نمونه ها را تعریف کنید و آنها را با ID ارجاع دهید.
- فیلترها را برای اثرات بصری پیشرفته قرار دهید (بلور، سایه رعد و برق، ماتریکس رنگ.
تصویر ادغام
- تصاویری از راستر را از طریق
<image>با استفاده از URI های خارجی یا داده های Base64. - قرار دادن کنترل، اندازه گیری (با ذخیره AspectRatio) و نابرابری.
انضمام تبدیل
- جریان معمولی: Import (به عنوان مثال، DOCX→SVG) → Refine با پردازنده فایل SVG (نمایش رنگ ها، اضافه کردن علائم آب، بهینه سازی مسیرها.
- نگهداری یا نوشتن مجدد شناسه ها، کلاس ها و دیف ها در طول پس از پردازش.
سریالی سازی و صادرات
- ذخیره 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 قرار دهید.
- بیت مپ های بزرگ را ** خارجی** برای SVG های کوچکتر نگه دارید؛ فقط دارایی های کوچک را وارد کنید.
- ترجیح می دهم Pretty-print در طول توسعه؛Minify در تولید.
- برای جلوگیری از وقفه، مجوز ** اندازه گیری شده** را زود شروع کنید.
خطای مدیریت و اعتباربخشی
- پردازنده ویژگی های مورد نیاز، شناسه ها و ارجاعات را تأیید می کند.
- استثناهای آشکار برای مسیرهای نادرست، تحولات نامناسب یا ناپدید شدن
defsاهداف. - حالت اختیاری «نور» می تواند مسائل غیر انتقادی را از بین ببرد و سریالی سازی را ادامه دهد.
Performance
- پخش بار / ذخیره برای اسناد بزرگ.
- استفاده مجدد از تعریف های گرادین / فیلتر برای جلوگیری از گره های دوگانه.
- جستجو از طریق انتخاب کننده های سبک (با ID / کلاس / نام) برای ویرایش سریع.
