SimdSkia.Pdf 0.1.2-preview.3

This is a prerelease version of SimdSkia.Pdf.
There is a newer version of this package available.
See the version list below for details.
dotnet add package SimdSkia.Pdf --version 0.1.2-preview.3
                    
NuGet\Install-Package SimdSkia.Pdf -Version 0.1.2-preview.3
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SimdSkia.Pdf" Version="0.1.2-preview.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SimdSkia.Pdf" Version="0.1.2-preview.3" />
                    
Directory.Packages.props
<PackageReference Include="SimdSkia.Pdf" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SimdSkia.Pdf --version 0.1.2-preview.3
                    
#r "nuget: SimdSkia.Pdf, 0.1.2-preview.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SimdSkia.Pdf@0.1.2-preview.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SimdSkia.Pdf&version=0.1.2-preview.3&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=SimdSkia.Pdf&version=0.1.2-preview.3&prerelease
                    
Install as a Cake Tool

0.1.2-preview.3 更新

本版修复连续MoveTo点序列和特殊混合模式的SaveLayer范围;原版几何300组/4636值、464组图层/2,375,680字节精确对照通过。PDF依赖说明与项目保持一致,固定使用 PdfPig 0.1.16。

3230/3235项固定基线,保留5项原生合同缺口;实际SVG/XPS/SKP、Alpha8、浮点颜色与GPU资源互操作。Vulkan合批/设备复制/完成读回优化;Metal无Mac GPU,尚未实机验证。Avalonia接受>=12.1.0且<13.0.0,已验证宿主12.1.0–12.1.5。JPEG、文字/曲线/整页画质及性能/内存仍有差距。Sdcb.SimdCodecs保持1.4.0;.NET系统压缩与macOS官方窗口宿主是已允许的原生例外。完整测试、CPU/GPU/内存性能及兼容限制见包内CHANGELOG.md和本版报告。

SimdSkia.Pdf 0.1.2-preview.3

Requires .NET 10.

Optional C# PDF parsing and page rendering, using PdfPig 0.1.16 (Apache-2.0) for PDF structure/fonts and SimdSkia for rasterization. No Skia, PDFium, MuPDF, native font library is used for PDF rendering. PDF Flate streams use the managed implementation; image codecs may use the explicitly permitted .NET native compression.

The optional parser is not pulled in by ordinary Avalonia or compatibility users. Keep all direct SimdSkia package versions aligned.

dotnet add package SimdSkia.Pdf --version 0.1.2-preview.3

Every package includes CHANGELOG.md and NuGet release notes. This release is a supported subset, not complete SkiaSharp or general PDF compatibility; see the release notes.

using SimdSkia.Pdf;
using SkiaSharp;

using var document = PdfReader.Open("input.pdf");
using var page = document.RenderPage(1, dpi: 144); // one-based page number
using var output = File.Create("page-1.png");
using var png = page.Bitmap.Encode(SKEncodedImageFormat.Png, 100);
png.SaveTo(output);
// Display the same bitmap in an existing SimdSkia canvas:
// canvas.DrawBitmap(page.Bitmap, 0, 0);

RenderedPdfPage owns its bitmap; dispose it after use. Returned pages outlive the reader. Operations on a reader are serialized; avoid disposing page pixels while another thread is drawing them. Input is limited to 256 MiB, each expanded Flate stream to 64 MiB, each raster page/image to 16 megapixels.

Supported and tested: multi-page PDF, ordered vector paths/fills, basic strokes, RGB/Gray images, JPEG, image soft masks, clipping, opacity, embedded TrueType/CFF outlines, page crop/rotation and managed compressed streams. Fonts without available outlines are rejected; system substitution is not automatic.

This is a subset renderer, not a general-purpose Acrobat/PDFium replacement. Annotations/form appearances, optional layers, PDF shadings/patterns, page/form transparency groups, graphics soft masks, non-normal blends, CMYK/ICC painting, dash/unsupported stroke styles, non-default UserUnit, vertical fonts, Matte soft-mask unmatting and text clipping are explicitly rejected. A PDF containing unsupported visible content fails instead of returning a falsely successful blank/partial page.

PDF generation is separately available through SKDocument.CreatePdf in SimdSkia.Compatibility: multiple raster pages, configurable DPI, metadata, lossless RGB or JPEG. It does not produce searchable text/vector content and does not implement PDF/A. SkiaSharp itself supplies PDF generation, not PDF input.

Examples from the repository root:

dotnet run -c Release --project examples/Documents -- artifacts/documents
dotnet run -c Release --project examples/PdfViewer -- tests/Pdf/Fixtures/external.pdf
dotnet run -c Release --project tests/Pdf

See docs/STANDALONE-COMPATIBILITY-2026-10-27.md for source API coverage, original comparisons, AOT verification and remaining differences. Windows was tested in this change; Linux/macOS execution of the new reader/viewer is not yet validated.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.12 51 11/20/2026
0.1.10 54 11/19/2026
0.1.9 48 11/19/2026
0.1.8 50 11/18/2026
0.1.6 56 11/18/2026
0.1.5 88 11/17/2026
0.1.4 96 11/9/2026
0.1.3 105 11/7/2026
0.1.2 95 11/7/2026
0.1.2-preview.3 64 11/6/2026
0.1.1 98 11/4/2026
0.1.0 96 11/4/2026
0.1.0-preview.10 70 11/1/2026
0.1.0-preview.9 82 10/27/2026

0.1.2-preview.3:固定SkiaSharp 3.119.4基线匹配3230/3235项;5项原生句柄/版本合同按约定保留。补充RuntimeEffect子集、Picture/Lattice/网格/滤镜、真实Alpha8、浮点颜色/Blender/抖动、LCD/中文嵌入点阵、SVG/XPS与原生v103 SKP子集。新增系统GL/GLES、D3D12及外部GPU纹理互操作;Vulkan矩形合批、设备复制、直接完成读回和去分配优化;Metal实现尚无Mac GPU验证。Avalonia接受>=12.1.0且<13.0.0,已验证宿主为12.1.0–12.1.5。Sdcb.SimdCodecs 1.4.0保持。仍有JPEG、曲线/文字/整页画质及GPU性能差距,不代表全面行为或二进制兼容。修复连续MoveTo与特殊混合SaveLayer范围回归;修正文档依赖版本更新脚本,PdfPig保持0.1.16。完整测试、性能、CPU/内存及限制见CHANGELOG.md和README.md。