Aspose.Words SVG -tiedostojen käsittelijä .NET

Aspose.Words SVG File Processor for .NET antaa sinulle mahdollisuuden rakentaa, muokata ja tallentaa ohjelmattisesti SVG grafiikat .NET-sovelluksistasi. Koska Aspose.Words ei ole alkuperäinen kuorma SVG asiakirja-muodossa, tämä plugin on tarkoitettu käytettäväksi ** yhdessä muunnin laajennukset** (esim. DOCX/HTML/PDF/SVG) tai mikä tahansa upstream tuonti, joka tuottaa SVg merkintä.

Asennus ja asennus

  • Lisää hankkeeseesi Aspose.Words for .NET NuGet -paketti asennuksen Ja opas.
  • Määritä mitattu lisenssi kerran app startupissa. seuraa mitattu lisenssi .

Huomautus: Tämä plugin tarjoaa SVG-pohjaisen API-alustan, joka täydentää, ei korvaa, ydin Aspose.Words ominaisuuksia.

Ominaisuudet ja valmiudet

SVG asiakirjan luominen

  • Aseta uusi SVG koodissa, asettaa width, height, ja viewBox.
  • Valitse absoluuttiset yksiköt (px, mm, in) tai luota viewBoxin reaktiiviseen tulokseen.

Muodot ja reitit

  • Luo ja muokkaa reaktio , kiertokierroksia, ellipse ja linja sekä polyyliini elementtejä.
  • Täydellinen piste komento tuki (M/L/H/V/C/S/Q/T/A/Z) segmentin sisällön / poistamisen, muuntamisen ja virtauksen / täyttämisen vaihtoehdon kanssa.

Teksti ja typografia

  • Lisää <text> ja <tspan> kulmat, joilla on kirjainperhe, koko, paino, peruslinjan muutos, kirjaimen/sanan tilavuus ja ankkurit (start/middle/end).
  • Soveltaa CSS-kaltaista tyyliä inline tai uudelleenkäytettävien luokan määritelmien kautta.

Ryhmittäminen & Layering

  • Sisällön järjestäminen <g> ryhmät; soveltaa muunnelmia ryhmän tasolla (käännös / mittakaava / pyörä/skew).
  • Nestryhmät peilataan kerroksen tyylisiä hierarkioita.

Gradientit, mallit ja suodattimet

  • Määritä **lineariset/radialiset gradientit ** , tyypit ja viitata niihin ID:llä.
  • Liity suodattimia (blur, drop varjo, väri matriisi) edistyneille visuaalisille vaikutuksille.

Kuvia sisällytetään

  • Sisällytä raster kuvia kautta <image> käyttämällä ulkoisia URI- tai Base64-tietoja.
  • Valvonta sijoittaminen, mittaaminen (varmistamalla AspectRatio) ja epätasaisuus.

Integraatio Converter

  • Tyypillinen virtaus: Import (esim. DOCX→SVG) → Refine SVG File Processorilla (muodostetaan värejä, lisätään vesimerkkejä, optimoidaan reittejä.
  • Säilytä tai kirjoita uudelleen tunnit, luokat ja talletukset jälkeisen käsittelyn aikana.

Seriointi ja vienti

  • Tallenna kompakti tai melko painettu SVG.
  • Vaihtoehtoisesti sisällytetään resurssit (lähteet/kuvat) tai pidetään ne ulkoisina.
  • Varmista standardin mukainen merkintä, joka on yhteensopiva nykyaikaisten renderien kanssa.

Nopea käynnistys: SVG-asiakirjan luominen 

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

Vinkkejä ja parhaita käytäntöjä

  • Käytä viewBox , jossa on suhteelliset koordinaatit reaktiiviseen grafiikkaan.
  • Ryhmä viisaasti : soveltaa muutoksia ryhmille per-elementin sijaan yksinkertaistamaan merkintöjä.
  • Aseta defs (gradientit, malleja, symboleja, suodattimia) yläosassa ja viittaus ID:llä.
  • Pidä suuria bitmappeja ** ulkoisia** pienemmille SVG:ille; sisällytä vain pieniä varoja.
  • Mieluummin **pretty-print ** kehityksen aikana; minify tuotannossa.
  • Aloita mitroitu lisenssi aikaisin keskeytysten välttämiseksi.

Virheiden käsittely ja validointi

  • Prosessori vahvistaa vaaditut ominaisuudet, tunnisteet ja viittaukset.
  • Selkeät poikkeukset vääristyneille reiteille, puutteellisille muutoksille tai puuttuville defs ja tavoitteet.
  • Valinnainen “lenentti” -tila voi ratkaista ei-kriittiset ongelmat ja jatkaa sarjakuvausta.

Performance

  • Liitetty kuormitus / säästää suurille asiakirjoille.
  • Käytä gradientti / suodattimen määritelmiä uudelleen, jotta vältetään kaksinkertaiset solmut.
  • Kysy kevyen painon valintayksiköiden kautta (ID/luokan/nimen mukaan) nopeille muokkauksille.
 Suomi