Aspose.Words SVG failų procesorius .NET

Aspose.Words SVG failų tvarkyklė .NET leidžia jums programuojamai kurti, modifikuoti ir išsaugoti SVG Grafika iš jūsų .NET programų. nes Aspose.Words nėra natūralus Įkrovos SVG kaip dokumentų formatas, šis priedas yra skirtas naudoti ** kartu su konverterio priedai** (pavyzdžiui, DOCX/HTML/PDF/SVG) arba bet kokį upstream importo, kuris gamina SVg žymėjimą.

Įdiegimas ir nustatymas

  • Pridėti Aspose.Words for .NET NuGet paketą į savo projektą Installation ir vadovas.
  • Nustatykite matuotą licenciją vieną kartą „App Startup Išmatuota licencija .

Pastaba: Šis priedas suteikia SVG orientuotą API paviršių, kuri papildo, o ne pakeičia pagrindines Aspose.Words funkcijas.

Savybės ir pajėgumai

SVG dokumentų kūrimas

  • Įdiegti naują SVG kodą, nustatyti width, height, ir viewBox.
  • Pasirinkite absoliutus vienetus (px, mm, in) arba pasikliauti „viewBox“ reaguojant į išleidimą.

Formos ir keliai

  • Sukurkite ir redaguokite rect, circle ir ellipse elementus.
  • Visiškas path komandos palaikymas (M/L/H/V/C/S/Q/T/A/Z) su segmentų įvedimo / pašalinimo, transformacijų ir srauto / užpildymo galimybėmis.

Tekstas ir tipografija

  • Add <text> ir <tspan> mazgai su fontų šeima, dydis, svoris, bazinės linijos keitimas, raidės / žodžio erdvėlaivis ir anchors (start / middle / end).
  • Taikykite CSS panašią stilių liniją arba per pakartotinai naudojamas klasės apibrėžtis.

Grupavimas ir sluoksnis

  • Organizuokite turinį su <g> grupės; taikyti transformacijas grupėje lygmeniu (versti / skalė / rotacija / svoris).
  • Nest grupės veidrodį sluoksnio stiliaus hierarchija.

Gradientai, Šablonai, Filtrai

  • Apibrėžkite linearinius / radijinius gradientus, patternius ir nurodykite juos ID.
  • Įdėkite filterį (blurą, atspalvį, spalvų matriką) pažangiems vizualiniams efektams.

Vaizdo įkrovimas

  • Įveskite rasterinius vaizdus per <image> naudojant išorinius URI arba Base64 duomenis.
  • Kontrolės padėties, dydžio (su išsaugotiAspectRatio) ir neaktyvumo.

Konverterinė integracija

  • Tipiškas srautas: Import (pavyzdžiui, DOCX→SVG) → Refine su SVG failų procesoriumi (sustabdykite spalvas, pridėkite vandens ženklus, optimizuokite maršrutus) • Save.
  • Išsaugokite arba perskaitykite ID, klases ir defsą po apdorojimo.

Serializavimas ir eksportas

  • Išsaugokite kompaktišką arba gana spausdintą SVG.
  • Pasirinktinai įveskite išteklius (šaltus / vaizdus) arba laikykite juos išoriniu.
  • Įsitikinkite, kad standartinis ženklinimas yra suderinamas su šiuolaikiniais renderėjais.

Greitas pradžia: sukurti SVG dokumentą 

// 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);

Post-procesas importuotas 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");

Patarimai ir geriausios praktikos

  • Naudokite „viewBox“ su santykiniais koordinatais reaguojant grafikai.
  • Grupė protingai: taikykite transformacijas grupėms, o ne per elementą, kad supaprastintumėte žymėjimą.
  • Įdėkite defs (gradientai, modeliai, simbolius, filtrus) viršuje ir nuoroda ID.
  • Laikykite didelius bitmapius ** išoriniu** mažesniems SVG; įveskite tik mažus turtus.
  • Rekomenduojama pretty-print vystymosi metu; minify gamyboje.
  • Pradėkite metruotą licenciją anksti, kad išvengtumėte pertraukų.

Klaidų tvarkymas ir patvirtinimas

  • Procesorius patvirtina reikalingus atributus, ID ir nuorodas.
  • Aiškios išimties pažeidžiamiems keliams, negaliojančioms transformacijoms ar trūkstamoms defs ir tikslų.
  • Pasirinktinai „šviesus“ režimas gali atsikratyti ne kritinių problemų ir tęsti serializavimą.

Performance

  • Įkrovimas / išsaugojimas dideliems dokumentams.
  • Pakartotinai naudokite gradiento / filtro apibrėžtis, kad išvengtumėte dubliavimo mazgų.
  • Ieškoti per lengvą svorį atrankos (pagal ID / klasės / vardą) greitai redaguoti.
 Lietuvių