Add CanvasNet.Pptx Phases 1a-1d: OOXML package layer, presentation model, geometry/paint, and text layout/rendering

.cspell.yaml

@@ -65,6 +65,7 @@ words:
   - combinators
   - CSUM
   - Decodability
+  - DOTLESS
   - dequantize
   - dequantizes
   - Deflate
@@ -97,6 +98,19 @@ words:
   - gAMA
   - Grayscale
   - grayscale
+  - gridline
+  - gridlines
+  - horz
+  - Horz
+  - Dmnd
+  - patt
+  - pythonpptx
+  - slidenum
+  - xfrm
+  - drawingml
+  - Calibri
+  - unoverridden
+  - subtable
   - IDAT
   - IDCT
   - IEND
@@ -114,8 +128,10 @@ words:
   - mcus
   - microarchitecture
   - misdecoded
+  - misrender
   - nameof
   - nonzero
+  - paintable
   - NOTAFONT
   - NOTAGIF
   - Outliner
@@ -309,6 +325,41 @@ words:
   - thinspace
   - Thinspace
   - subsetted
+  - rels
+  - Rels
+  - Linq
+  - OOXML
+  - openxmlformats
+  - officedocument
+  - presentationml
+  - pptx
+  - Pptx
+  - autofit
+  - Autofit
+  - unrotated
+  - unflipped
+  - unshifted
+  - autoshape
+  - Autoshape
+  - autoshapes
+  - Autonumber
+  - srgb
+  - MCMXCIV
+  - hlink
+  - Hlink
+  - clrmap
+  - clrmapovr
+  - colormap
+  - openxml
+  - textless
+  - aiden
+  - misrouting
+  - parameterless
+  - Lbls
+  - texel
+  - precomputes
+  - uncontained
+  - prst
 
 # Exclude common build artifacts, dependencies, and vendored third-party code
 ignorePaths:

CanvasNet.slnx

@@ -3,10 +3,14 @@
     <Project Path="src/DemaConsulting.CanvasNet/DemaConsulting.CanvasNet.csproj" />
     <Project Path="src/DemaConsulting.CanvasNet.Svg/DemaConsulting.CanvasNet.Svg.csproj" />
     <Project Path="src/DemaConsulting.CanvasNet.Pdf/DemaConsulting.CanvasNet.Pdf.csproj" />
+    <Project Path="src/DemaConsulting.CanvasNet.Pptx/DemaConsulting.CanvasNet.Pptx.csproj" />
+    <Project Path="src/DemaConsulting.CanvasNet.Charts/DemaConsulting.CanvasNet.Charts.csproj" />
   </Folder>
   <Folder Name="/test/">
     <Project Path="test/DemaConsulting.CanvasNet.Tests/DemaConsulting.CanvasNet.Tests.csproj" />
     <Project Path="test/DemaConsulting.CanvasNet.Svg.Tests/DemaConsulting.CanvasNet.Svg.Tests.csproj" />
     <Project Path="test/DemaConsulting.CanvasNet.Pdf.Tests/DemaConsulting.CanvasNet.Pdf.Tests.csproj" />
+    <Project Path="test/DemaConsulting.CanvasNet.Pptx.Tests/DemaConsulting.CanvasNet.Pptx.Tests.csproj" />
+    <Project Path="test/DemaConsulting.CanvasNet.Charts.Tests/DemaConsulting.CanvasNet.Charts.Tests.csproj" />
   </Folder>
 </Solution>

README.md

@@ -39,6 +39,17 @@ image operations using `Span<T>`, and supports independent-copy cropping for loa
   TrueType text to a surface, automatically substituting a matching system font (or a bundled
   Liberation Sans/Serif/Mono font) for text using a non-embedded font (ships as the separate
   `DemaConsulting.CanvasNet.Pdf` package)
+- 📊 **Chart Rendering** - Build a validated Bar/Column/Line/Area/Pie/Doughnut chart (with axes,
+  legend, title, and data labels) via a fluent builder and paint it onto a surface with documented
+  default styling and a categorical color palette (ships as the separate
+  `DemaConsulting.CanvasNet.Charts` package)
+- 📈 **OOXML Chart Parsing** - Parse a raw ECMA-376 DrawingML-Charts `c:chartSpace`/`c:chart` XML
+  element (for example, a `chart1.xml` OPC part) into a validated chart, reading only cached
+  values, with no OPC/ZIP packaging or host document-format knowledge (ships as part of the same
+  `DemaConsulting.CanvasNet.Charts` package). When rendering a `.pptx` presentation via the
+  separate `DemaConsulting.CanvasNet.Pptx` package's `PptxDocument.Render`, an embedded
+  `<p:graphicFrame>` chart is automatically parsed and painted using this same package, with no
+  extra caller code required.
 - 🔍 **Header-Only Probing** - `GetInfo` reads headers without decoding pixels (GIF excepted)
 - 🖌️ **Path Filling** - Antialiased nonzero/even-odd fill of vector paths
 - 🖊️ **Stroke-to-Fill** - Convert stroked paths into fillable outlines
@@ -92,6 +103,31 @@ Or via Package Manager Console:
 Install-Package DemaConsulting.CanvasNet.Pdf
 ```
 
+Chart rendering requires the separate `DemaConsulting.CanvasNet.Charts` package:
+
+```bash
+dotnet add package DemaConsulting.CanvasNet.Charts
+```
+
+Or via Package Manager Console:
+
+```powershell
+Install-Package DemaConsulting.CanvasNet.Charts
+```
+
+PowerPoint (`.pptx`) document parsing and rendering requires the separate
+`DemaConsulting.CanvasNet.Pptx` package:
+
+```bash
+dotnet add package DemaConsulting.CanvasNet.Pptx
+```
+
+Or via Package Manager Console:
+
+```powershell
+Install-Package DemaConsulting.CanvasNet.Pptx
+```
+
 ## Usage
 
 ```csharp
@@ -163,6 +199,44 @@ if (!info.CanDecode)
 using var safeSurface = PngCodec.Load("untrusted.png");
 ```
 
+Building and rendering a chart:
+
+```csharp
+using DemaConsulting.CanvasNet.Canvas;
+using DemaConsulting.CanvasNet.Charts;
+
+// Build a validated Chart fluently
+var chart = new ChartBuilder()
+    .OfType(ChartType.Column)
+    .WithCategoryAxis(["Q1", "Q2"])
+    .WithValueAxis(minimum: 0f, maximum: 10f)
+    .AddSeries("Revenue", [4.0, 9.0], color: new Rgba32(31, 119, 180, 255))
+    .WithTitle("Quarterly Revenue")
+    .WithLegend(ChartLegendPosition.Bottom)
+    .Build();
+
+// Render it onto a new surface using every rendering default
+using var chartSurface = ChartRenderer.Render(chart, 400, 300);
+```
+
+Parsing a raw OOXML chart part and rendering it:
+
+```csharp
+using DemaConsulting.CanvasNet.Canvas;
+using DemaConsulting.CanvasNet.Charts;
+using DemaConsulting.CanvasNet.Charts.OpenXml;
+using System.Xml.Linq;
+
+// Parse a c:chartSpace/c:chart XML document (for example, a chart1.xml OPC part a host
+// document-format library - such as CanvasNetPptx - has already located and opened)
+var chartDocument = XDocument.Load("chart1.xml");
+var parsedChart = OpenXmlChartParser.Parse(chartDocument);
+
+// The parsed Chart is directly consumable by ChartRenderer, exactly like a Chart built via
+// ChartBuilder
+using var parsedChartSurface = ChartRenderer.Render(parsedChart, 400, 300);
+```
+
 Filling a vector path onto a surface:
 
 ```csharp