feat: JPEG 2000 codec and PDF JPXDecode support

.cspell.yaml

@@ -14,6 +14,70 @@ language: en
 
 # Project-specific technical terms and tool names
 words:
+  - dctdecode
+  - Lsiz
+  - smaskindata
+  - psnr
+  - bitplanes
+  - bitstream
+  - Cdef
+  - codestreams
+  - coef
+  - Colr
+  - CPRL
+  - csiz
+  - dequantization
+  - Dmax
+  - Dmin
+  - dplanes
+  - EBCOT
+  - fplane
+  - INITDEC
+  - INITENC
+  - Ippm
+  - Irrev
+  - isot
+  - Lblock
+  - LRCP
+  - lsot
+  - luts
+  - Mallat
+  - mant
+  - Memberwise
+  - NLPS
+  - NMPS
+  - Nppm
+  - Osiz
+  - Pclr
+  - Pcoc
+  - PCRL
+  - Prec
+  - Psot
+  - TNsot
+  - TPsot
+  - pterm
+  - Renorm
+  - RLCP
+  - RPCL
+  - rsiz
+  - scoc
+  - scod
+  - segsym
+  - signedness
+  - smask
+  - ssiz
+  - subband
+  - Sycc
+  - Termall
+  - Tsiz
+  - vcausal
+  - vsum
+  - xmap
+  - xmaps
+  - Xsiz
+  - ymaps
+  - ysiz
+  - Zppm
   - Aabb
   - functiontype
   - Poppler
@@ -235,6 +299,10 @@ words:
   - Argb
   - cmap
   - Cmap
+  - Lsop
+  - ftyp
+  - bpcc
+  - superbox
   - codepoint
   - Dzik
   - glyf

.reviewmark.yaml

@@ -254,6 +254,31 @@ reviews:
       - "test/DemaConsulting.CanvasNet.Tests/Codecs/GifCodecTests.cs"  # unit tests
       - "test/DemaConsulting.CanvasNet.Tests/Codecs/GifFixtureTests.cs"  # fixture conformance tests
 
+  # CanvasNet-Codecs-Jpeg2000Codec Review (one per unit)
+  - id: CanvasNet-Codecs-Jpeg2000Codec
+    title: Review that CanvasNet Codecs Jpeg2000Codec Implementation is Correct
+    context:
+      - "docs/design/canvas-net.md"
+      - "docs/reqstream/canvas-net.yaml"
+      - "docs/design/canvas-net/codecs.md"
+      - "docs/reqstream/canvas-net/codecs.yaml"
+    paths:
+      - "docs/reqstream/canvas-net/codecs/jpeg2000-codec.yaml"    # unit requirements
+      - "docs/design/canvas-net/codecs/jpeg2000-codec.md"        # unit design
+      - "docs/verification/canvas-net/codecs/jpeg2000-codec.md"  # unit verification
+      - "src/DemaConsulting.CanvasNet/Codecs/Jpeg2000Codec.cs"       # unit source (public API entry point)
+      - "src/DemaConsulting.CanvasNet/Codecs/Jpeg2000Image.cs"       # unit source (public decoded-image result type)
+      - "src/DemaConsulting.CanvasNet/Codecs/Jpeg2000ColorSpace.cs"  # unit source (public color-space enum)
+      - "src/DemaConsulting.CanvasNet/Codecs/Jpeg2000DecoderLimits.cs"  # unit source (public decoder resource limits)
+      - "src/DemaConsulting.CanvasNet/Codecs/Jpeg2000/**/*.cs"       # unit source (partial-class implementation files)
+      - "src/DemaConsulting.CanvasNet/Codecs/ImageInfo.cs"           # shared header-only probe result type
+      - "src/DemaConsulting.CanvasNet/Codecs/NamespaceDoc.cs"        # Codecs namespace documentation
+      - "test/DemaConsulting.CanvasNet.Tests/Codecs/Jpeg2000CodecTests.cs"      # unit tests
+      - "test/DemaConsulting.CanvasNet.Tests/Codecs/Jpeg2000ValidationTests.cs"  # fail-closed validation tests
+      - "test/DemaConsulting.CanvasNet.Tests/Codecs/Jpeg2000TestEncoder*.cs"    # test-only JPEG 2000 encoder
+      - "test/DemaConsulting.CanvasNet.Tests/Codecs/Jpeg2000FixtureTests.cs"    # real-encoder fixture tests
+      - "test/DemaConsulting.CanvasNet.Tests/Jpeg2000Fixtures/**"               # real-encoder fixture corpus + README
+
   # CanvasNet-Geometry Review (one per subsystem)
   - id: CanvasNet-Geometry
     title: Review that CanvasNet Geometry Subsystem Implementation is Correct
@@ -770,6 +795,10 @@ reviews:
       - "src/DemaConsulting.CanvasNet.Pdf/NamespaceDoc.cs"             # Pdf namespace documentation
       - "test/DemaConsulting.CanvasNet.Pdf.Tests/PdfDocumentTests.cs"  # unit tests
       - "test/DemaConsulting.CanvasNet.Pdf.Tests/PdfDocumentMeshShadingTests.cs"  # mesh shading unit tests
+      - "test/DemaConsulting.CanvasNet.Pdf.Tests/PdfDocumentJpxTests.cs"  # JPXDecode/SMask unit tests
+      - "test/DemaConsulting.CanvasNet.Tests/Jpeg2000Fixtures/gray.jp2"  # gray JPX fixture
+      - "test/DemaConsulting.CanvasNet.Tests/Jpeg2000Fixtures/source_gray.png"  # source pixels of gray.jp2
+      - "test/DemaConsulting.CanvasNet.Tests/JpegFixtures/grayscale_baseline.jpg"  # gray DCT fixture
       - "test/DemaConsulting.CanvasNet.Pdf.Tests/PdfSystemIntegrationTests.cs"  # integration tests
       - "test/DemaConsulting.CanvasNet.Pdf.Tests/PdfFixtureTests.cs"   # fixture conformance tests
 

README.md

@@ -31,6 +31,7 @@ image operations using `Span<T>`, and supports independent-copy cropping for loa
 - 🖨️ **TIFF Codec** - Load/save 8-bit RGB/RGBA/Grayscale TIFF files
 - 🗜️ **JPEG Codec** - Load baseline/progressive; save baseline JPEG
 - 🎞️ **GIF Codec** - Decode-only load of first GIF frame; `GetInfo` reports the true frame count
+- 🖼️ **JPEG 2000 Codec** - Decode-only load of JP2 files and raw codestreams (Decode also exposes color space and alpha)
 - 📐 **SVG Codec** - Rasterize a common SVG subset to a surface (`DemaConsulting.CanvasNet.Svg`)
 - 📄 **PDF Document** - Open, inspect, and rasterize PDF pages with font substitution (`DemaConsulting.CanvasNet.Pdf`)
 - 📊 **Chart Rendering** - Build and paint Bar/Column/Line/Area/Pie/Doughnut charts (`DemaConsulting.CanvasNet.Charts`)
@@ -88,7 +89,7 @@ PngCodec.Save(surface, "surface.png");
 using var reloaded = PngCodec.Load("surface.png");
 ```
 
-Open a PDF and render a page (BMP/TIFF/JPEG/GIF/SVG codecs, header-only probing, and
+Open a PDF and render a page (BMP/TIFF/JPEG/GIF/JPEG 2000/SVG codecs, header-only probing, and
 feature-detection all follow the same pattern):
 
 ```csharp

docs/design/canvas-net-pdf.md

@@ -47,9 +47,10 @@ size — but every filled/stroked path painted in solid opaque black, since no c
 implemented yet. Phase 3 added real device color (`g`/`G`/`rg`/`RG`/`k`/`K`/`cs`/
 `CS`/`sc`/`SC`/`scn`/`SCN`), a generalized `/Filter`/`/DecodeParms` stream-decoding pipeline
 (`FlateDecode` plus PNG/TIFF predictor reversal), and image XObjects (`Do`: `DCTDecode` via the
-`CanvasNet` system's `Codecs.JpegCodec`, or raw `DeviceGray`/`DeviceRGB`/`DeviceCMYK` 8-bit
-samples, composited through the current transformation matrix). Phase 4 added real text/font
-rendering: `BT`/`ET`/`Tc`/`Tw`/`Tz`/`TL`/`Tf`/`Tr`/`Ts`/`Td`/`TD`/`Tm`/`T*`/`Tj`/`'`/`"`/
+`CanvasNet` system's `Codecs.JpegCodec`, `JPXDecode` via `Codecs.Jpeg2000Codec`, or raw
+`DeviceGray`/`DeviceRGB`/`DeviceCMYK`/`Indexed` samples of 1/2/4/8/16 bits, composited through the
+current transformation matrix).
+Phase 4 added real text/font rendering: `BT`/`ET`/`Tc`/`Tw`/`Tz`/`TL`/`Tf`/`Tr`/`Ts`/`Td`/`TD`/`Tm`/`T*`/`Tj`/`'`/`"`/
 `TJ` resolve a simple `/Subtype /TrueType` font from the current page's `/Resources/Font`
 dictionary (requiring an embedded `/FontDescriptor/FontFile2`, loaded via the `CanvasNet`
 system's `Fonts.TrueTypeFont`), map each shown byte through its `/WinAnsiEncoding`/
@@ -106,9 +107,9 @@ Form XObject's `/BBox` is never used to clip its content and its `/Group` (trans
 entry is never consulted, though the Form itself renders; `/ShadingType` values outside `2`-`7`
 and `/FunctionType 4` (PostScript calculator) functions fail closed; the `sh` operator and general
 path clipping (`W`/`W*`) are supported; no
-`/SMask`/alpha compositing or transparency groups (every decoded image is treated as fully
-opaque); no `JPXDecode` filter decoding (fails closed; `CCITTFaxDecode` - Group 4 (T.6 MMR) only -
-is supported); `/Separation`/`/DeviceN`/`/CalGray`/`/Lab` color spaces remain unsupported and fail
+`/Mask`/`/Matte` image masks or transparency groups (an explicit `/SMask` and JPEG 2000
+alpha are applied); `CCITTFaxDecode` - Group 4 (T.6 MMR) only - is supported and `JPXDecode`
+is decoded; `/Separation`/`/DeviceN`/`/CalGray`/`/Lab` color spaces remain unsupported and fail
 closed; and an encrypted document using any security handler, crypt-filter method, `/V`/`/R`
 combination other than the ones listed above, or whose correct password is not supplied, fails
 closed rather than being decrypted. These remain out of scope and are planned for later phases
@@ -335,8 +336,13 @@ crypt filter), `pdf-encrypted-r-{revision}`,
 non-empty one is genuinely required), `pdf-encrypted-incorrect-password`,
 `pdf-encrypted-password-non-ascii` (an R2-R4 password outside ASCII 0-127),
 `pdf-colorspace-{name}` (`Separation`/`DeviceN`/`CalGray`/`Lab`), `pdf-colorspace-Pattern`,
-`pdf-colorspace-ICCBased`, `pdf-filter-{name}` (`JPXDecode` and any other unrecognized filter),
-`pdf-tiff-predictor-bitdepth-{n}`, `pdf-image-bitdepth-{n}`, `pdf-pattern-not-declared`,
+`pdf-colorspace-ICCBased`, `pdf-filter-{name}` (any unrecognized filter),
+`pdf-tiff-predictor-bitdepth-{n}`, `pdf-image-bitdepth-{n}` (a depth other than 1/2/4/8/16, or a 16-bit `/Indexed` image),
+`pdf-jpx-colorspace` (a JPX image of a channel count with no device color space without `/ColorSpace`),
+`pdf-jpx-palette-colorspace` (a `/ColorSpace` override on JP2 data with its own palette),
+`pdf-jpx-indexed-bit-depth` (an `/Indexed` space over non-8-bit JPX samples),
+`pdf-jpx-smaskindata-indexed` (`/SMaskInData 2` over an `/Indexed` space),
+`pdf-pattern-not-declared`,
 `pdf-pattern-type-{n}`, `pdf-pattern-tile-too-large`, `pdf-shading-type-{n}`,
 `pdf-shading-colorspace-{family}`, `pdf-functiontype-{n}`, `pdf-function-multiinput`,
 `pdf-function-bitspersample-{n}`, `pdf-font-subtype-{subtype}` (`MMType1` only),