ASPOSE.Words SVG fájlfeldolgozó .NET

Aspose.Words SVG File Processor for .NET lehetővé teszi, hogy programozottan építsen, módosítsa és mentse SVG A .NET alkalmazásokból származó grafika. Mivel az Aspose.Words nem terhelés SVG mint dokumentum formátum, ez a plugin célja, hogy használják konverter plugins (például DOCX/HTML/PDF→SVG) vagy bármilyen upstream import, amely előállítja a svg megjelölés.

Telepítés és telepítés

  • Adja meg a Aspose.Words for .NET NuGet csomagot a projekthez telepítés Az útmutató.
  • Állítsa be a mért licencet egyszer az app startup-on Mérett licenc .

Megjegyzés: Ez a plugin egy SVG-fókuszált API felületet biztosít, amely kiegészíti, nem helyettesíti a Core Aspose.Words funkciókat.

Jellemzők és képességek

SVG dokumentum létrehozása

  • Az új SVG beállítása a kódban, a beállítás width, height, és viewBox.
  • Válassza ki az abszolút egységeket (px, mm, in) vagy támaszkodjon a viewBoxra a reagáló kimenetelhez.

Formák és útvonalak

  • Hozzon létre és szerkesztse a rect , circle és ellipse elemeket.
  • Teljes path parancstámogatás (M/L/H/V/C/S/Q/T/A/Z) a szegmens beillesztése / eltávolítása, átalakítása és kitöltés/teljesítése lehetőségekkel.

Szöveg és tipográfia

  • Add hozzá <text> és <tspan> csomópontok betűtípus, méret, súlya, alapvonal áthelyezése, bet/szó spacing, és anchors (start/middle/end).
  • Helyezze be a CSS-szerű stílust inline vagy újrafelhasználható osztálymeghatározásokon keresztül.

Csoportozás & Layering

  • Tartalom szervezésével <g> csoportok; transzformációk alkalmazása a csoport szintjén (átdolgozás / skála / forgatás / kerítés).
  • A Nest csoportok tükrözik a réteg stílusú hierarchiákat.

Gradiensek, minták, szűrők

  • A **lineáris / radiális gradienseket ** , a mintákat meghatározza, és az ID-vel hivatkozik rájuk.
  • Csatlakoztassa a szűrőket (blur, drop árnyék, szín matrix) a fejlett vizuális hatásokhoz.

Kép beépítése

  • Helyezze be a raster képeket a <image> Külső URI-k vagy Base64 adatok használata.
  • Ellenőrző elhelyezkedés, mérés (AspectRatio megőrzésével) és átláthatóság.

konverter integráció

  • Tipikus áramlás: **Import ** (például DOCX→SVG) → **Refine ** a SVG Fájlfeldolgozóval (színei beállítása, vízjelzők hozzáadása, útvonalak optimalizálása) • Save SvG.
  • Tartsa vagy írjon újra azonosítókat, osztályokat és adatokat a feldolgozás utáni időszakban.

Serializáció és export

  • A kompakt vagy meglehetősen nyomtatott SVG-t mentse.
  • Opcionálisan inline források (forrás / képek) vagy tartsa őket külső.
  • Győződjön meg arról, hogy a standard-megfelelő markup kompatibilis a modern renderekkel.

Gyors indítás: SVG dokumentum létrehozása 

// 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 egy importált 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");

Tippek és legjobb gyakorlatok

  • A viewBox használata relatív koordinátákkal a reagáló grafika használatához.
  • Group wisely : alkalmazza a transzformációkat csoportok helyett elemenként, hogy egyszerűsítse a megjelölést.
  • Helyezze a defs (gradiensek, minták, szimbólumok és szűrők) a tetejére és az ID-vel.
  • Tartsa a nagy bitmappákat ** külső** kisebb SVG-k esetében; csak kis eszközöket tartalmaz.
  • Előnyben részesíthető **pretty-print ** fejlesztés közben; minify termelés során.
  • Indítsa el a méretezett engedélyezést korán, hogy elkerülje a megszakításokat.

Hiba kezelése és validálása

  • A processzor megerősíti a szükséges attribútumokat, azonosítókat és referenciákat.
  • Nyilvánvaló kivételek a megsértett útvonalakra, a hibás átalakításokra vagy a hiányzó utakon defs A célok.
  • Az opcionális „világos” mód képes leküzdeni a nem kritikus problémákat és folytatni a serializációt.

Performance

  • Áramlási terhelés/megtakarítás nagy dokumentumokra.
  • A gradiens/szűrő definíciók újrafelhasználása a duplikált csomópontok elkerülése érdekében.
  • Keresés könnyű választókkal (az ID/osztály/név szerint) a gyors szerkesztésekhez.
 Magyar