Skip to content

Releases

OODD.Charts 1.1.2

Choose a tag to compare

@github-actions github-actions released this 02 Nov 07:01

Full Changelog: v1.1.1...v1.1.2

OODD.Charts 1.1.0

Choose a tag to compare

@wanggenji1 wanggenji1 released this 02 Nov 05:38

复杂文种支持 / Complex-script support

1.1.0 起 Core 的文字排版接入 HarfBuzzSharp(MIT)做 OpenType 整形。阿拉伯文、希伯来文、天城文、孟加拉文、泰文、藏文、缅甸文等不再靠 Skia 的码位直映射硬排。模板和文档 API 不变,旧调用无需改一行代码。

  • 整形:阿拉伯文按词内位置连写;天城文辅音簇合成单字形(“नमस्ते” → 4 个字形);拉丁文、中文、希腊文、西里尔文仍走原直排路径,量宽与落墨与 1.0 逐位一致。
  • 方向:RTL 文本的 CellAlign.Near 是起始边(右缘)、Far 是结束边(左缘);夹在 RTL 里的数字单独成 LTR 段,“مرحبا 123” 不会画成 “321”。
  • 缺字回退:基础字族没有该文种码位时,按脚本候选表 + SKFontManager.MatchCharacter 换字体,不会落成豆腐块。
  • SVG:复杂文种输出字形轮廓 <path>(Skia 反查 Unicode 会丢掉辅音簇,实测 “नमस्ते” 变 “नमे”),视觉与位图一致但不可检索;拉丁文与中文仍是 <text>。PNG / JPEG / PDF 不受影响。
  • Linux:需系统字体(如 fonts-noto-arabic、fonts-noto-devanagari)并额外引用 HarfBuzzSharp.NativeAssets.Linux;库本身不分发任何字体。

验证 / Verification

  • 483 项测试在 net8.0 与 net462 上各跑一遍,全绿;其中新增 10 项复杂文种验收(量宽与独立 HarfBuzz 计算对账、脚本回退、RTL 对齐、数字不反向、SVG 轮廓化)。
  • 机制对照:清空脚本表后 6 项转红,关掉数字切段后 2 项转红;恢复后 10/10 通过。
  • 40 张样例与宿主适配器的像素基线不变。

资产 / Assets

  • 14 个 1.1.0 NuGet 包(Core / Medical / Radar / Engineering / Transit / Geoscience / Tickets + 7 个适配器)。
  • OODD.Charts.Demo.Wpf-1.1.0-win-x64.zip:自包含 WPF 演示,Windows x64 解压双击即用,无需安装 .NET。
mkdir packages && cd packages
# 下载本页 nupkg 到当前目录后:
dotnet nuget add source . -n oodd-local
dotnet add package OODD.Charts.Medical --version 1.1.0

用法与完整文档:https://github.com/OODD-DevNet/OODD.Charts#复杂文种(English)

OODD.Charts 1.0.0

Choose a tag to compare

@wanggenji1 wanggenji1 released this 30 Oct 02:18

OODD.Charts 1.0.0

基于 SkiaSharp 的 .NET 跨平台表单图表库。体温单、产程图、测井图、列车运行图这类"排版不规则、只能靠坐标画出来"的行业表单,在这里被拆成文档对象 + 模板 + 一个 Chart 门面:同一份文档导出 PNG / JPEG / SVG / PDF,也可以直接画进 WinForms、WPF、Avalonia、Eto、WinUI、Uno、MAUI 的控件里。

这个版本包含

  • 14 个包:1 个核心引擎、7 个领域包、7 个宿主适配器
  • 40 张表单与图表:21 张医疗单据、5 张工程图、5 张交通单证、2 张地学图、5 张医疗扩展单据、3 张票据
  • 雷达态势图:360° 全向盘面与 180° 扇区盘面,扫描动画、目标选中、信息面板
  • 两套通用表单引擎:TimelineFormTemplate(时刻 + 指标)与 FormSheetTemplate(任意表格),新增单据基本只填数据
  • 多页、多联、分组表头、横竖混排、跨页续接这些排版问题都在模板层解决,业务侧不碰绘图 API

安装

NuGet.org 尚未上传,包以本 Release 附件提供。下载 .nupkg 后:

dotnet nuget add source <下载目录> -n oodd-local
dotnet add package OODD.Charts.Medical --version 1.0.0

核心包是 OODD.Charts.Core,领域包按需引用:OODD.Charts.Medical、OODD.Charts.Radar、OODD.Charts.Engineering、OODD.Charts.Transit、OODD.Charts.Geoscience、OODD.Charts.Tickets。

演示程序

OODD.Charts.Demo.Wpf-1.0.0-win-x64.zip 是自包含的 WPF 程序,解压双击 exe 即可运行,不需要预装 .NET。下拉框可切换全部 40 张表单,支持贴合窗口与原尺寸缩放,能把当前表单导出成 PNG(300dpi)、PDF 或 SVG。

最小示例

using OODD.Charts;
using OODD.Charts.Medical.Temperature;

TemperatureChartDocument doc = new TemperatureChartDocument { FormTitle = "体温单" };
doc.Patient.Name = "刘敏";
doc.Days.Add(new ChartGroup(new DateTime(2025, 12, 28)));
using Chart chart = new Chart(doc, new TemperatureChartTemplate());
chart.WritePng("temperature.png", 96f);

验证情况

  • 473 个单元 / 集成测试在 net8.0 与 net462 两个框架上全部通过
  • 40 个样例分别导出 PNG / JPEG / SVG / PDF,逐项取证通过
  • 7 个宿主适配器的渲染结果与 Core 逐字节一致
  • 跨目标框架(net462 / netstandard2.0 / net8.0)编译无警告

组件清单、每张表单的用法与效果图见仓库 README(中文 / English)。


English

OODD.Charts is a cross-platform .NET form-and-chart library built on SkiaSharp. Irregular, coordinate-drawn documents — temperature charts, partograms, well logs, train graphs — become a document object plus a template plus one Chart facade. The same document exports to PNG / JPEG / SVG / PDF, or renders directly inside WinForms, WPF, Avalonia, Eto, WinUI, Uno and MAUI controls.

What's in 1.0.0

  • 14 packages: one core engine, seven domain packages, seven host adapters
  • 40 forms and charts: 21 medical records, 5 engineering charts, 5 transit documents, 2 geoscience charts, 5 extended medical forms, 3 ticket forms
  • Radar situation display: full 360° and 180° sector scopes, sweep animation, target selection, info panel
  • Two generic form engines — TimelineFormTemplate (time plus one metric) and FormSheetTemplate (arbitrary grid)
  • Multipage, multi-part (联次), grouped headers, mixed orientations and page continuation are handled by templates

Install — the packages ship as release assets (NuGet.org publication pending):

dotnet nuget add source <download-dir> -n oodd-local
dotnet add package OODD.Charts.Medical --version 1.0.0

Demo — OODD.Charts.Demo.Wpf-1.0.0-win-x64.zip is a self-contained WPF app; unzip and run the exe. It browses all 40 forms and exports PNG (300dpi), PDF or SVG.

Verification — 473 tests pass on both net8.0 and net462, all 40 samples were exported and forensically checked in four formats, and all seven adapters render byte-identical to Core.

Licensed under Apache-2.0.