SilkyNvg.Rendering.OpenGL 1.2.0

SilkyNvg

NanoVectorGraphicsExceptItUsesSilkNETNowWooHoo (感谢 KoziLord 提供的描述) (将 memononen/nanovg 端口到 .NET8.0)

SilkyNvg 是一个小型库，提供基本的二维绘图功能，非常适合 UI 和其他此类应用程序。它提供基本的形状功能，如矩形或圆形，以及构建自定义路径的能力，这些路径可以是填充的或描边的（线条）。颜色可以是颜色（SilkyNvg.Colour）、画笔（SilkyNvg.Paint）或图像（SilkyNvg.Paint）。除此之外，还提供了一个简单的文本绘图 API。有关详细信息，请参阅 FontStash.NET。

使用/例子

在 'samples' 目录中可以找到 NanoVG 例子。

初始化和渲染

要创建一个新的 Nvg 实例，必须指定 SilkyNvg.Rendering.INvgRenderer 的实现，然后可以像这样创建实例：Nvg nvg = Nvg.Create(renderer);。

所有对渲染 API 的调用都必须在 Nvg.BeginFrame(width, height, pixelRatio); 和 Nvg.EndFrame(); 之间。要将像素坐标系转换为任何其他坐标系，宽度和高度可以有任意值，与实际窗口大小无关。

实现分为不同的组件，这些组件包括

• SilkyNvg.Blending 用于全局混合
• SilkyNvg.Graphics 用于渲染样式
• SilkyNvg.Images 用于图像
• SilkyNvg.Paths 用于创建和绘制路径
• SilkyNvg.Scissoring 用于自定义剪刀
• SilkyNvg.Text 用于文本
• SilkyNvg.Transforms 用于创建和修改变换
• SilkyNvg 包括核心方法，例如 BeginFrame、DebugDumpCache、颜色和绘制 所有组件都通过其各自命名空间中的扩展方法链接到 SilkyNvg.Nvg。

渲染器

在创建 Nvg 实例时指定渲染器，使用 Nvg.Create。SilkyNvg 默认提供 Vulkan 和 OpenGL 渲染器，但可以通过使用 SilkyNvg.Rendering.INvgRenderer 接口轻松构建自定义渲染器。渲染器在其构造函数中通常接受 CreateFlags 标记集，用于指定特定于渲染器的设置。

抗锯齿

如果将 SilkyNvg.Rendering.INvgRenderer.EdgeAntiAlias 设置为 true，SilkyNvg 会自动计算抗锯齿顶点。这是因为某些渲染器可能不支持抗锯齿。在自定义渲染器中，通过 CreateFlags 指定是否执行抗锯齿。

OpenGL 渲染器

OpenGL 渲染器 的构造函数接受两个参数；SilkyNvg.Rendering.OpenGL.CreateFlags 和 Silk.NET.OpenGL.GL。第二个参数是 OpenGL 的 API 实例，CreateFlags 标记集有以下选项

• CreateFlags.Antialias 表明渲染器应该绘制抗锯齿或原始网格。
• CreateFlags.StencilStrokes 表明渲染器在绘制 strokes（线条）时应该使用模板缓冲区。
• CreateFlags.Debug 表明渲染器应该打印错误。

Vulkan 渲染器

Vulkan 渲染器 的构造函数接受三个参数：SilkyNvg.Rendering.Vulkan.CreateFlags、SilkyNvg.Rendering.Vulkan.VulkanRendererParams 和 Silk.NET.Vulkan.VK。最后一个参数是 Vulkan 的 API 实例。

SilkyNvg.Rendering.Vulkan.CreateFlags 标记集有以下选项

• CreateFlags.Antialias 表明渲染器应该绘制抗锯齿或原始网格。
• CreateFlags.StencilStrokes 表明渲染器在绘制 strokes（线条）时应该使用模板缓冲区。
• CreateFlags.TriangleListFill 不使用 VK_PRIMITIVE_TOPOLOGY_TRIANGLE_FAN，因为它并非普遍支持。这可能会降低性能。
• CreateFlags.Debug 表明渲染器应该打印错误。

SilkyNvg.Rendering.Vulkan.VulkanRendererParams 结构体

• VulkanRendererParams.PhysicalDevice 物理设备。
• VulkanRendererParams.Device 设备，与指定的物理设备相匹配。
• VulkanRendererParams.AllocationCallbacks 一个指向潜在的 AllocationCallbacks 的安全 IntPtr。如果没有使用，则使用 IntPtr.Zero 或为空。
• VulkanRendererParams.InitialCommandBuffer 可以指定要绘制的命令缓冲区。如果设置了该值，则不需要每帧更新命令缓冲区。
• VulkanRendererParams.FrameCount 可以同时绘制的帧数。（不允许多线程！）
• VulkanRendererParams.AdvanceFrameIndexAutomatically 指定在绘制一帧后是否应自动递增使用的帧索引。 返回到 0。
• VulkanRendererParams.RenderPass 渲染通道。
• VulkanRendererParams.SubpassIndex 要使用的子通道索引。
• VulkanRendererParams.ImageQueueFamily 用于图像布局转换和缓冲区复制的队列族。必须支持 VK__QUEUE_GRAPHICS_BIT。
• VulkanRendererParams.ImageQueueFamilyIndex 应创建执行上述操作队列的索引。

其他细节

有关更多信息，请参阅 NanoVG 文档，因为 API 和实现有意识地保持相似。

自定义渲染器实现

要创建自定义渲染器实现，渲染器类必须实现 SilkyNvg.Rendering.INvgRenderer。此接口包含以下方法和属性

INvgRenderer

• bool EdgeAntiAlias 当创建渲染器时是否启用了抗锯齿。取决于是否支持抗锯齿以及实例化时是否指定了其使用。
• bool Create() 当 NanoVG 初始化时被调用。在这里初始化渲染器。如果初始化失败，则返回 false，否则返回 true。
• int CreateTexture(Texture type, Vector2D<uint> size, ImageFlags imageFlags, ReadOnlySpan<byte> data) 被调用以创建新的图像。参数 type 用于指定 data 是否应被解释为 RGBA 或 Alpha 值。返回新图像的句柄。
• bool DeleteTexture(int image) 被调用以删除图像。如果图像未找到，则返回 false，否则返回 true。
• bool UpdateTexture(int image, Rectangle<uint> bounds, ReadOnlySpan<byte> data) 更新图像的特定部分到新的 data。如果图像未找到，则返回 false，否则返回 true。
• bool GetTextureSize(int image, out Vector2D<uint> size) 返回指定图像的大小。如果图像未找到，则返回 false，否则返回 true。
• void Viewport(Vector2D<float> size, float devicePxRatio) 在 Nvg.BeginFrame 每帧调用一次，用于设置视口大小和像素比。
• void Cancel() 停止绘制帧。清除所有缓存数据。
• void Flush() 绘制帧。渲染此处的一切。
• void Fill(Paint paint, CompositeOperationState compositeOperation, Scissor scissor, float fringe, Box2D<float> bounds, IReadOnlyList<Path> paths) 在 Nvg.Fill() 上被调用。表示当刷新时，paths 中包含的数据应被添加到渲染中。
• Stroke(Paint paint, CompositeOperationState compositeOperation, Scissor scissor, float fringe, float strokeWidth, IReadOnlyList<Path> paths) 在 Nvg.Stroke() 上被调用。表示当刷新时，paths 中包含的数据应被添加到渲染中。
• Triangles(Paint paint, CompositeOperationState compositeOperation, Scissor scissor, ICollection<Vertex> vertices, float fringeWidth) 在渲染文本时被调用。表示当刷新时，应添加的 vertices 应被添加到渲染中。
• void Dispose() 删除并关闭渲染器。