SimdSkia.Pdf 0.1.3

There is a newer version of this package available.
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
                    
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.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.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.3
                    
#r "nuget: SimdSkia.Pdf, 0.1.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.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.3
                    
Install as a Cake Addin
#tool nuget:?package=SimdSkia.Pdf&version=0.1.3
                    
Install as a Cake Tool

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 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.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。