Aspose.Words SVG failu apstrādātājs .NET

Aspose.Words SVG File Processor for .NET ļauj jums programmatiski izveidot, mainīt un saglabāt SVG grafikas no jūsu .NET lietojumprogrammām. jo Aspose.Words nav nātrija kravas SVG kā dokumentu formāts, šis plugins ir paredzēts, lai izmantotu kopā ar konvertora pluginiem (piemēram, DOCX/HTML/PDF/SVG) vai jebkuru augšējo importu, kas rada SvG marķējumu.

Instalācija un uzstādīšana

Piezīme: Šis plugins nodrošina SVG koncentrētu API virsmu, kas papildina, nevis aizstāj, pamata Aspose.Words funkcijas.

Iezīmes un spējas

SVG dokumentu izveide

  • Instantēt jaunu SVG kodā, iestatīt width, height, un viewBox.
  • Izvēlieties absolūtās vienības (px, mm, in) vai paļauties uz viewBox, lai sniegtu atbildīgu rezultātu.

Formas un ceļi

  • Izveidojiet un rediģējiet rektus, circle un ellipse elementus.
  • Pilna path komandas atbalsts (M/L/H/V/C/S/Q/T/A/Z) ar segmentu ievietošanu/izņemšanu, transformācijām un stroking/fill iespējas.

Teksts un tipogrāfija

  • Add <text> un <tspan> nodus ar burtu ģimeni, izmēru, svaru, bāzes līnijas maiņu, vēstules/vārdu spazēšanu un anchors (start/middle/end).
  • Pielietojiet CSS līdzīgu stilizēšanu inline vai izmantojot atkārtoti izmantojamas klases definīcijas.

Grupēšana & Layering

  • Organizēt saturu ar <g> Grupas; piemēro transformācijas grupas līmenī (pārejas/skala/rotat/skew).
  • Nest grupas uz spoguli slāņa stila hierarhijas.

Gradienti, modeļi, filtri

  • Definējiet ** lineārus/radiālus gradientus**, ** modeļus** un norādiet tos ar ID.
  • Piestipriniet filterus (blur, nokrāsu ēna, krāsu matriču) uzlabotu vizuālo efektu nodrošināšanai.

Attēls iekļauts

  • Ievadiet raster attēlus caur <image> izmantojot ārējos URI vai Base64 datus.
  • Kontroles ievietošana, izmērs (ar saglabāšanuAspectRatio), un opacitāte.

Konverteru integrācija

  • Tipisks plūsma: Import (piemēram, DOCX→SVG) → Refine ar SVG failu procesoru (pielāgo krāsas, pievieno ūdens marķējumus, optimizē maršrutus.
  • Saglabāt vai pārrakstīt ID, klases un defs pēc apstrādes laikā.

Serializācija un eksports

  • Saglabājiet kompaktu vai diezgan drukātu SVG.
  • Opcionāli ievietojiet resursus (fonti / attēli) vai saglabājiet tos ārēji.
  • Nodrošiniet atbilstīgu standartu marķējumu, kas ir saderīgs ar mūsdienu rendereriem.

Ātrs sākums: izveidot SVG dokumentu 

// 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-Process a Imported 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");

Padomi un labākās prakses

  • Use viewBox ar relatīviem koordinatoriem reaģējošai grafikai.
  • Grups gudri: piemēro transformācijas grupām, nevis per-element, lai vienkāršotu marķēšanu.
  • Ievietojiet defs (gradienti, modeļi, simboli, filtri) augšpusē un atsauci pa ID.
  • Saglabājiet lielus bitmaps ** ārējos** mazākajiem SVG; ievietojiet tikai mazus aktīvus.
  • Labāk pretty-print izstrādes laikā; minify ražošanā.
  • Sāciet ** mērenu licencēšanu** agrāk, lai izvairītos no pārtraukumiem.

kļūdu apstrāde un validācija

  • Processors validē nepieciešamos atribūtus, ID un atsauces.
  • Atklāti izņēmumi novirzītiem ceļiem, nevēlamiem pārveidiem vai trūkumiem defs Mērķi.
  • Opcionālais “liens” režīms var izkļūt no nekritiskām problēmām un turpināt serializāciju.

Performance

  • Streamed slodze / ietaupīšana lieliem dokumentiem.
  • Atkārtoti izmanto gradienta/filtera definīcijas, lai izvairītos no dubultu nodus.
  • Meklējiet, izmantojot vieglus izvēlētājus (atkarībā no ID / klases / nosaukuma) ātrām rediģācijām.
 Latviski