SimdSkia.Pdf
0.1.3
See the version list below for details.
dotnet add package SimdSkia.Pdf --version 0.1.3
NuGet\Install-Package SimdSkia.Pdf -Version 0.1.3
<PackageReference Include="SimdSkia.Pdf" Version="0.1.3" />
<PackageVersion Include="SimdSkia.Pdf" Version="0.1.3" />
<PackageReference Include="SimdSkia.Pdf" />
paket add SimdSkia.Pdf --version 0.1.3
#r "nuget: SimdSkia.Pdf, 0.1.3"
#:package SimdSkia.Pdf@0.1.3
#addin nuget:?package=SimdSkia.Pdf&version=0.1.3
#tool nuget:?package=SimdSkia.Pdf&version=0.1.3
SimdSkia 0.1.3 正式版:GPU 优先与文字缓存优化
从0.1.2升级:桌面默认GPU优先,Windows Direct2D原生呈现、Linux Vulkan、诊断后回退CPU;macOS窗口仍CPU。.UseSimdSkiaDesktop(options => options.UseCpu()) 可保留CPU。新增两帧完成队列、状态缓存、跨帧回退像素修复、文字缓存共享计费/不可变遮罩/LRU及Vulkan有序合批。动态中文自身GPU耗时下降81%–93%,分配降至约168–169B/帧,详细CPU/内存和画质限制见0.1.3发行说明及包内CHANGELOG.md。Avalonia仍>=12.1.0且<13.0.0;原版文字/曲线/整页画质、JPEG及部分性能/内存差距保留,整体目标未全部达到。第三方依赖保持可选 PdfPig 0.1.16、Sdcb.SimdCodecs1.4.0与Clipper2 2.0.0,公开状态以发布记录为准。
0.1.2 历史累计功能
固定SkiaSharp3.119.4基线,892→3230/3235项、累计新增2338项公共元数据签名,63→201类型;按约定保留5项原生合同缺口。扩展路径/描边/渐变/采样/滤镜/Blender/RuntimeEffect子集、Picture/网格、真实Alpha8/浮点颜色、LCD/中文点阵、SVG/XPS/SKP与PDF注释。增加GL/GLES/D3D12/Metal核心及GPU资源互操作,优化Vulkan设备复制/矩形合批/完成读回、SIMD/有界缓存/分配;修复MoveTo、SaveLayer混合范围和纹理生命周期。
Avalonia接受>=12.1.0且<13.0.0,已验证宿主12.1.0–12.1.5。默认SK*解码校正为N32/预乘,直接读取像素的应用应检查ColorType/AlphaType/RowBytes。依赖保持Sdcb.SimdCodecs1.4.0/Clipper2 2.0.0/可选 PdfPig 0.1.16。Metal无Mac GPU实机验证;JPEG、曲线/文字/整页画质、内存及部分GPU/API性能仍有差距。正式版按已实现子集发布,不是全面行为或二进制替换保证;GPU对象要求创建线程显式Dispose。
完整累计更新、性能记录、限制与升级方法见包内CHANGELOG.md和0.1.2发行说明。原始测量按快照保留,不以正式版本号改写画质结果。
SimdSkia.Pdf 0.1.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.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 | Versions 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. |
-
net10.0
- PdfPig (= 0.1.16)
- SimdSkia.Compatibility (>= 0.1.3)
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.3正式版:桌面默认GPU优先(Windows Direct2D、Linux Vulkan,诊断后回退CPU;macOS窗口仍CPU);UseCpu可显式保留CPU。Direct2D完成事件、两帧队列、flip呈现、原生状态缓存及跨帧CPU回退像素同步修复。文字缓存共享轮廓计费/不可变遮罩/LRU、重复内容复用;动态中文自身GPU耗时下降81%–93%,分配降至约168–169B/帧。Vulkan有序小面积纯色矩形合批及边数据缓存优化。Avalonia>=12.1.0且<13.0.0,发布矩阵12.1.0–12.1.5;固定3230/3235 API、5个原生合同缺口。小混合仍慢约39%,JPEG/文字/曲线/整页画质及内存仍有差距,Metal未实机;旧滚动异常同一0.1.2未重现,根因未知,不宣称整体同画质持平。依赖保持Sdcb.SimdCodecs1.4.0、Clipper2 2.0.0、PdfPig0.1.16。完整更新和性能记录见CHANGELOG.md与README.md。