VoxPlane 2.7.0

VoxPlane 2.7.0

发布日期：2026-11-13 · 用可见预览配置初始显示、截图和报告。

更新摘要

• 新增影像初始显示、截图与报告预设，设置时可实时预览效果。
• 截图保存前可核对实际输出；报告支持版式、内容、署名与隐私选项。
• 默认使用影像自带窗值，窗模板同时显示具体 WW / WL；旋转与镜像支持菜单内快捷键。
• 修复镜像、旋转和重置组合下的测量位置，以及 QA 撤销后的自动计算与圆形尺寸显示。
• 重整应用内与在线操作手册，增加按任务导航和步骤搜索。

Update summary

• Added live-preview presets for initial image display, screenshots, and reports.
• Review the actual screenshot before saving; configure report layout, content, attribution, and privacy.
• Source window values are the default; templates show WW / WL, with menu-scoped rotation and mirror shortcuts.
• Fixed measurement alignment during transforms and reset, plus QA automatic calculation after undo and ROI diameter display.
• Reorganized the in-app and online manuals with task navigation and step search.

中文说明

升级须知

VoxPlane 2.6.0 可通过应用内更新入口获取本版。Voxenra 2.5.0 及更早版本仍需手动安装一次 VoxPlane，见 更名升级说明。本版沿用现有工作区格式，已有设置保留；新的初始显示偏好用于随后打开的影像，不覆盖正在查看的视口。

主要改进

• 初始显示：选择适应窗口或实际比例、影像自带窗值或指定模板。默认采用源影像提供的显示窗；MR 缺少有效窗值时仍采用自动范围。模板名称旁显示 WW / WL，便于确认。
• 截图：单独设置导出范围、PNG / JPEG、图像大小、叠加内容与隐私选项。先预览最终编码图像，再保存相同内容。没有保存过预设时不显示空的预设选择列表。
• 报告：分别设置纸张、方向、内容、署名和隐私，预览后保存 PDF。设置面板缩窄，页面按宽度放大，可纵向滚动及翻页；水模与空气 QA 保留各自报告内容。
• 教程：应用内与网站仍使用同一内容源；按任务查找操作，搜索可定位到步骤，既有章节地址保持可访问。

行为变化与问题修复

• 测量与标注随图像镜像和旋转正确定位；组合操作及重置后的显示与交互保持一致。
• 旋转菜单使用 H / V 水平与垂直镜像，J / K 逆时针与顺时针旋转 90°，R 重置；快捷键仅在当前菜单生效，输入框及弹窗优先。
• QA 撤销后继续自动计算；组尺寸读取圆形实际几何，混合尺寸不会显示成统一大小。
• 修复轴对齐 MPR 半层位置的分割画笔显示，保留倾斜切面的原有采样约定。
• 无可用原生 OpenGL 驱动时，3D 视图显示错误提示，避免误用离屏后端导致崩溃。
• 关闭 3D 视口后忽略迟到的失焦和尺寸事件，避免影响随后打开的视图。
• 修复设置和 PACS 页签分离时的界面警告，返回影像后操作栏正常恢复。
• 修复多窗口切换页签时的视口状态混用；退出中的旧页面不再使用新页签数据重建。
• 修复 Windows 打开预设设置页时可能出现的弹窗状态异常及崩溃。
• 修复 Windows 报告预览关闭后临时 PDF 文件仍被占用的问题。
• 导出默认目录应用于保存对话框。匿名导出隐藏受支持的身份叠加，不清除原始像素中已烧录的文字。

安装兼容性与已知限制

提供 macOS Apple Silicon DMG、Windows x64 安装版和单文件便携版。macOS 使用 ad-hoc 签名，未公证；Windows 未做 Authenticode 签名，系统可能提示未知发布者。Windows 验收在 GitHub Actions 的 Windows 环境执行，不代表所有显卡、驱动或医院 PACS 均已验证。外部服务、额外影像样本及未覆盖硬件的测试边界见验收记录。

相关资料

操作手册 · 本版教程源 · 完整差异

English details

Released 2026-11-13. Configure image display and exports with visible previews.

Upgrade notes

VoxPlane 2.6.0 can obtain this version through the in-app updater. Voxenra 2.5.0 and earlier still require a one-time manual installation; see the rename migration notes. Existing settings and the workspace format are retained. Initial display preferences apply to newly opened images without overwriting current viewports.

Improvements

• Initial display: choose fit or actual scale and source window values or a template. Source windows are the default; MR data without valid source values retains automatic windowing. Templates display exact WW / WL values.
• Screenshots: configure scope, PNG / JPEG, image size, overlays, and privacy. Review the final encoded image and save that same content. An empty preset selector is hidden until a preset is saved.
• Reports: configure paper, orientation, content, attribution, and privacy before reviewing and saving the PDF. Narrower controls leave more space for a width-fitted, scrollable page preview. Water and air QA retain distinct report content.
• Manuals: shared in-app and web content now offers task navigation and step search while preserving existing chapter addresses.

Behavior changes and fixes

• Measurements and annotations remain aligned through mirroring, rotation, and reset.
• The rotation menu provides H / V for horizontal / vertical mirroring, J / K for 90° counterclockwise / clockwise rotation, and R for reset. Keys are scoped to the active menu; text fields and dialogs take priority.
• QA resumes automatic calculation after undo. Diameter fields reflect actual ROI geometry and distinguish mixed sizes.
• Fixed segmentation brush visibility at axis-aligned MPR half-slice positions while retaining oblique sampling behavior.
• When native OpenGL is unavailable, 3D views report the problem instead of attempting an incompatible headless backend.
• Closed 3D viewports ignore late focus and resize events instead of affecting views opened afterward.
• Fixed UI warnings when detaching Settings or PACS tabs; reading tools recover when returning to images.
• Fixed mixed viewport state during multi-window tab switches; retiring pages no longer rebuild with the next tab’s data.
• Fixed popup state errors and crashes that could occur when opening preset settings on Windows.
• Fixed temporary PDF files remaining locked after closing a report preview on Windows.
• Save dialogs use the configured export directory. Anonymous export hides supported identity overlays; it does not remove text burned into source pixels.

Installation, compatibility, and known limitations

Packages cover macOS Apple Silicon, Windows x64 installer, and Windows x64 single-file portable. macOS uses ad-hoc signing without notarization. Windows packages lack Authenticode signing, so operating-system trust warnings may appear. Windows acceptance runs on GitHub Actions Windows hosts; this does not verify every graphics driver or external PACS. Validation records distinguish optional external-service, data, and hardware checks.

Related resources

Manual · Versioned tutorial source · Full comparison

VoxPlane 2.6.0

VoxPlane 2.6.0

分组进行 CT 质量分析，编辑取样区域并导出带图报告；改善影像显示和视口控制。

更新摘要

• 应用更名为 VoxPlane；2.5.0 及更早版本需手动安装一次，已有设置和工作区保留。
• QA 分组显示 CT 值与均匀性、水中噪声及模体外空气，圆形区域支持控制点缩放。
• 调整 QA 区域后自动计算，保留“计算”按钮重试；改进指标显示、撤销重做和旧结果恢复。
• QA 可导出带影像截图和统计表的 PDF，区分水模与空气报告，并支持可选软件署名。
• 四角信息支持全局默认与视口独立覆盖；正方形视口可自动调整应用窗口。
• 改善灰度插值显示，原始像素与测量统计不变；修复操作栏焦点下测量与标注的复制粘贴。

Update summary

• Renamed to VoxPlane. Version 2.5.0 and earlier require a one-time manual installation; settings and workspaces are preserved.
• QA separates CT number/uniformity, water noise, and external air, with control handles for resizing circular regions.
• QA recalculates after edits and keeps Calculate for retries; improved metrics, undo/redo, and historical result restoration.
• Export QA PDFs with images and tables, separate water/air report titles, and an optional software name.
• Corner overlays support global defaults and viewport overrides; Square viewport adjusts the application window.
• Improved grayscale interpolation without changing source pixels or statistics; fixed measurement/annotation clipboard actions when toolbar buttons have focus.

中文说明

升级须知

升级前保存工作区并保留原始影像。已有设置、测量及 QA 记录继续保留，不自动重新计算。旧版噪声使用中心小圆的结果仍显示旧值；主动点击 计算 后，才使用本版独立的噪声大圆重新取样，数值可能变化。请保留旧工作区副本再比较。

应用从 Voxenra 更名为 VoxPlane，Logo 保持不变，项目迁移至 junforge-dev/voxplane。2.5.0 及更早版本的更新器不能安装改名后的附件，请从 2.6.0 下载页手动安装一次，之后可继续应用内更新。

• macOS：退出旧应用，将 DMG 中的 VoxPlane 拖入“应用程序”。首次启动并确认设置、工作区正常后，可以移除旧 Voxenra.app。
• Windows 安装版：退出旧应用，运行新安装器；沿用原安装位置和卸载记录，替换程序及快捷方式。
• Windows 便携版：退出旧程序，保存新 VoxPlane.exe，运行并核对后移除旧可执行文件。

首次启动会复制旧版显示设置、窗模板、PACS、收藏目录、最近影像及对话框路径、最近/恢复工作区和自定义语言文件，不覆盖已有 VoxPlane 设置，也不删除旧数据。工作区格式及影像引用保持兼容；影像、日志和自选文件夹不移动。

主要改进

• 分组 QA：CT 值与均匀性使用中心和四周小圆，水中噪声使用独立大圆；模体外空气单独取样。画布只显示当前组，切换组保留位置和结果。可靠识别到模体外空气时可自动添加一个圆，无法确定时手动放置；主动删除后不会自动补回。
• 圆形编辑：单击选中后显示四个控制点，拖动调整大小，圆内拖动改变位置。直径上限随剩余区域及边界变化；删除外围圆后可扩大中心圆。松开后自动计算，Esc 取消；底部固定撤销、重做、导出和清除。
• 计算与恢复：失败显示原因，保留 计算 按钮重试；切换组不抹掉错误。表格位置在计算期间保持稳定，旧数值暂以“—”显示。缺少必要 ROI 时只展示可计算指标。切片往返和工作区保存保留区域与已完成结果。
• 带图报告：PDF 包含当前影像截图、取样条件和统计表，长表可分页。水模报告包含水模各组，空气报告仅包含空气取样；标题与文件名区分。默认不添加软件名称，可在 设置 → 导出 → 报告软件名称 中设置。
• 视口控制：四角信息默认继承全局设置，可在当前视口独立覆盖并恢复跟随；2D 切面选择入口也随四角信息显隐。开启 正方形视口 调整应用窗口，使当前 2D 画布为正方形，手动调整窗口或侧栏使其变形后自动取消。

行为变化与问题修复

• 灰度显示先插值再应用窗值，改善重建影像缩放时的显示；提供软件回退。此调整不修改源像素、MTF、测量或 QA 的统计输入。
• 测量和标注复制粘贴在操作栏按钮获得焦点后仍可使用；输入框、弹窗保留各自按键行为。QA 圆不新增剪贴板快捷键。
• 统一更新应用内教程和由其生成的在线手册。保留原有章节链接与搜索入口，修复首页截图宽度变化后高度不跟随的问题。

安装兼容性与已知限制

• macOS：Apple Silicon DMG，ad-hoc 签名，未经 Apple 公证。
• Windows：x64 安装版及单文件便携版，未配置 Authenticode 签名。
• QA 自动识别针对完整、近圆形的均质水模；无法识别时提供普通圆形取样，不自动判定合格。空气自动定位不能代替人工核查。
• 旧记录保持原值；主动重新计算后采用当前取样规则。工作区仍引用原始文件，不内嵌影像像素，也不保存撤销历史。
• 平台验收以发布验收记录中的实际执行范围为准；不代表所有显卡、触控设备或干净物理 Windows 设备均已测试。

操作手册 · 版本差异 · 发布验收记录

English details

Upgrade notes

Save your workspace and retain its source images before upgrading. Existing settings, measurements, and QA records remain available without automatic recalculation. Historical noise values measured with the small central ROI remain unchanged until you choose Calculate, which uses the independent large noise circle. Keep a copy of the old workspace when comparing results.

Voxenra is now VoxPlane, retaining its logo. The repository is junforge-dev/voxplane. Updaters in version 2.5.0 and earlier cannot accept renamed assets: install once from the 2.6.0 release, then use in-app updates again.

• macOS: quit the old app and drag VoxPlane from the DMG into Applications. Verify settings and workspaces before removing the old Voxenra.app.
• Windows installer: quit the old app and run the new installer. It retains the registered directory and uninstall entry while replacing the executable and shortcuts.
• Windows portable: quit the old executable, save and run VoxPlane.exe, then remove the old executable after verification.

On first launch, display settings, window presets, PACS, favorite folders, recent image/dialog paths, recent/recovery workspaces and custom languages are copied without overwriting existing VoxPlane data or deleting old files. Workspace format and image references stay compatible. Images, logs and custom folders are not relocated.

Main improvements

• QA groups: central/peripheral circles measure CT number and uniformity, a separate large circle measures water noise, and external air uses its own sampling group. Only the current group is drawn. Reliable external-air detection can add a circle automatically; otherwise place it manually. Deleted air circles are not recreated automatically.
• Circle editing: select a circle to reveal four resize handles, or drag its interior to move it. Diameter limits reflect remaining circles and boundaries. Releasing the mouse recalculates; Esc cancels. Undo, redo, export, and clear stay in the footer.
• Calculation and recovery: errors retain a visible reason and a Calculate retry action. Switching groups does not hide errors. Table geometry remains stable during calculation, with dashes replacing stale values. Summaries appear only when required ROIs exist. Slice navigation and workspaces retain completed results.
• Reports: PDFs include the image, sampling conditions, and paginated ROI tables. Water reports include water sampling groups; air reports contain only air statistics, with distinct titles and filenames. No software name appears by default; set an optional name under Settings → Export.
• Viewport controls: corner information follows a global default until locally overridden, with an action to restore inheritance. The 2D plane selector follows corner visibility. Square viewport resizes the window for the current 2D canvas; manual window or sidebar changes that alter its shape turn it off.

Behavior changes and fixes

• Grayscale interpolation precedes windowing, improving the appearance of zoomed reconstructed images, with a software fallback. Source pixels and measurement, MTF, and QA statistics are unchanged.
• Measurement and annotation clipboard actions work when a toolbar button has focus. Text inputs and dialogs retain their own shortcuts. QA circles do not gain clipboard shortcuts.
• Updated offline tutorials feed the online manual, preserving chapter addresses and search. Refreshed images and fixed manual-home screenshot proportions.

Compatibility and limitations

• macOS Apple Silicon DMG: ad-hoc signed, not Apple-notarized.
• Windows x64 installer and portable executable: no Authenticode signature.
• Automatic QA detection targets complete, near-circular homogeneous water phantoms. Otherwise use ordinary circular sampling; no automatic acceptance decision is made. Inspect automatically placed air ROIs.
• Historical values change only on explicit recalculation. Workspaces reference source images and do not embed pixels or retain undo history.
• See the release verification record for actual platform coverage; it does not imply testing on every GPU, touch device, or clean physical Windows computer.

Manual · Changes · Verification

Voxenra 2.5.0

Voxenra 2.5.0

发布日期：2026-11-10 · 更便捷的影像导入与页签切换，改进 MTF 取样和测量反馈。

更新摘要

• Windows 2.2.0 用户需手动下载安装；升级前请保存工作区并保留原始影像。
• 重构影像来源窗口，分区显示收藏与最近打开，支持清除单项或全部最近记录。
• MTF 支持矩形选区、实际取样范围显示，日常仅计算 110% 积分结果，简化结果与计算详情。
• 同一序列重复打开同类视图会切换到已有页签；撤销关闭入口统一保留在页签栏。
• 影像视图支持双指缩放，并增加打开视图、标注、导出和重置快捷键。
• ROI 越界时仅统计有效像素；改善绘制与标签反馈，修复切换后的确认键和缩放高亮边框。

Update summary

• Windows 2.2.0 users need a manual installation. Save your workspace and retain its source images before upgrading.
• Redesigned image-source dialog separates favorites and recent paths, with controls to remove one or all recent records.
• MTF accepts rectangular ROIs, shows actual sampling bounds, and computes only the 110% integration result, with simpler result details.
• Reopening the same series and view type activates its existing tab. Undo close is available from the tab bar.
• Image views support pinch zoom, with new shortcuts for opening views, annotations, export, and reset.
• Out-of-image ROIs use valid pixels for statistics. Improved drawing and labels; fixed confirmation keys and zoom-obscured highlight frames.

中文说明

升级须知

从 2.5.0 下载页选择对应平台安装包。Windows 2.2.0 用户仍需手动下载安装，该旧版本的更新器可能在开始安装前退出。

升级前保存工作区并保留副本，继续保留工作区引用的原始影像。已有自定义快捷键优先保留；若占用了新增的默认按键，新动作不会覆盖旧绑定，可在设置中重新分配。

已有 MTF 记录保留原数值与参数，不会自动重算。新计算采用更新后的取样规则，数值可能与旧版本不同；需要对比时请保留旧工作区副本，再主动重新计算。

主要改进

• 双指缩放：支持 2D、MPR、CPR、融合、对比、蒙太奇、3D 与 4D，无需切换当前工具。触屏以双指中心为锚点，触控板以鼠标所在视图中的位置为锚点；没有有效位置时使用视图中心。倍率范围为 0.1×–20×，已有缩放联动继续生效。
• 影像来源：扩大默认窗口，左侧分区显示收藏目录和最近打开，右侧浏览文件。最近记录支持单击打开、选中行末尾清除及删除全部；清除只影响记录，不删除文件或收藏。成功导入后记住最近 10 个来源和上次目录。
• MTF 取样：点源支持任意长宽的矩形选择框，由程序定位目标并确定积分和背景区域。可在影像上显示实际取样边界。日常加权 FFT 采用自适应基准的 110% 积分范围，不再重复执行 90% / 100% 对照；详情保留计算方式、取样尺寸、版本和时间。
• 快速打开视图：选中序列后，D 打开 2D、X 打开 MPR、T 打开 3D、Y 打开 CPR、O 打开蒙太奇、U 打开 4D、I 打开 DICOM 标签。右键菜单中的快捷键作用于右击的序列，仅允许打开该序列支持的视图。同一序列已存在同类页签时直接切换，保留其阅片状态。
• 常用操作按键：A 打开标注、E 打开导出、Q 整体重置当前视图；标注菜单中 A 选择箭头、T 选择文字。当前二级菜单优先处理自己的按键，退出后恢复通用按键；输入文字、打开弹窗或拖动时不会触发底层操作。
• 更清晰的测量反馈：长度、角度和 ROI 在满足最少有效点数及几何条件后显示指标。未选中的 ROI 显示名称和面积，选中后展开灰度统计；自动标签尽量避让轮廓、其他标签、方向文字和比例尺，仍可手动调整。

行为变化与问题修复

• MTF 改善目标定位、背景取样和积分范围确定，修复切换计算方式时未继续获取背景像素的问题。结果标签不再显示敏感性警告和来源分类；绘制新 MTF/FWHM 选区时，旧选区标签保持原有结果。
• “撤销关闭页签”入口从首页和工作区窗口移至页签栏右键菜单；关闭最后一页后仍可操作，Ctrl+Shift+T／⇧⌘T 保持有效。
• ROI 部分超出有效影像范围时，平均值、标准差、最小值、最大值和像素数只依据有效像素计算；绘制面积和尺寸不裁减。完全没有有效像素时明确提示，不显示伪造的灰度数值。
• Q 沿用“全部重置”的行为，包括清除当前视图相应的测量和标注；需要保留结果时请先保存工作区。当前工具的局部重置仍使用 R。CPR 整体重置补齐图像显示状态的恢复，不删除已有路径。
• 修复切换页签或关闭工作区弹窗后，曲线与 CPR 的 Enter / Esc 不能确认或取消绘制的问题。
• 修复开始拖动时丢失第一段位移，改善平移和测量编辑的跟手反馈。
• 修复 CPR 绘制新路径时结果状态文字重复、窗模板命名时 Esc 无法取消，以及伪彩影响影像外留白的问题。
• 修复蒙太奇缩放、平移后悬停边框被影像覆盖，以及底部边框偶发裁切。

安装兼容性与已知限制

• macOS：Apple Silicon DMG，ad-hoc 签名，未经 Apple 公证。
• Windows：x64 安装版及单文件便携版，未配置 Authenticode 签名。
• 手势识别依赖操作系统和设备提供的触控事件；自动化事件验证不等于所有实体触控屏和触控板均完成验收。
• 标签空间不足时仍可能重叠，可手动移动。CPR 仍为手动路径，不提供自动血管追踪。
• MTF 的 110% 是内部自适应积分范围系数，不是选区尺寸或背景取样范围的比例，也不保证比其他系数更准确。曲面背景、弱尾部及噪声仍会影响结果；未做有限目标尺寸修正，不自动判定合格。
• 未在干净物理 Windows 设备或另一台 Mac 上完成人工安装及阅片验收；具体完成与未覆盖范围见发布验收记录。

相关资料

本版操作手册 · 完整版本差异 · 发布验收记录

English details

Released 2026-11-10. Easier image import and tab navigation, with improved MTF sampling and measurement feedback.

Upgrade notes

Choose your platform package from the 2.5.0 release. Windows 2.2.0 users still need a manual installation because that older updater may exit before installation begins.

Save a copy of your workspace before upgrading and retain its source images. Existing custom shortcuts take priority: a new action will not overwrite an occupied binding. Reassign it in Settings if needed.

Existing MTF records retain their values and parameters without automatic recalculation. New calculations use revised sampling rules and may differ from older versions. Keep an old workspace copy before recalculating for comparison.

Improvements

• Pinch zoom: Supported in 2D, MPR, CPR, fusion, comparison, montage, 3D, and 4D views without switching tools. Touchscreens use the finger midpoint; trackpads use the pointer position in the viewport, falling back to the viewport center when unavailable. The range is 0.1×–20×, and existing zoom links remain effective.
• Image sources: A wider dialog separates favorites and recent paths on the left from file browsing on the right. Open recent sources with one click, remove the selected record, or clear all history. Source files and favorites remain intact. Successful imports retain the last 10 sources and the last directory.
• MTF sampling: Rectangular selections locate a point target; the application determines integration and background regions and can overlay their actual bounds. Weighted FFT calculations use 110% of the adaptive integration baseline without repeated 90% / 100% comparisons. Details retain the method, sampling dimensions, version, and time.
• Open views quickly: With a series selected, D opens 2D, X MPR, T 3D, Y CPR, O montage, U 4D, and I DICOM tags. Context-menu shortcuts target the right-clicked series. Supported views reuse an existing tab for the same series and view type, preserving its reading state.
• Common actions: A opens annotations, E export, and Q resets the current view. Within annotations, A selects arrows and T text. Active tool menus take priority over general bindings; dialogs, text entry, and dragging isolate their input.
• Measurement feedback: Metrics appear after enough valid points and geometry are available. Unselected ROIs show compact name-and-area labels; selection expands intensity statistics. Automatic placement avoids nearby shapes, labels, orientation text, and scale bars when space permits, with manual adjustment available.

Behavior changes and fixes

• Improved MTF target localization, background sampling, and integration bounds; fixed missing background-context sampling after a calculation-method change. Result labels omit sensitivity warnings and source categories. Drawing a new MTF/FWHM ROI keeps previous ROI labels unchanged.
• Undo close moved from the home screen and workspace dialog to the tab-bar context menu, including when no tabs remain. Ctrl+Shift+T / ⇧⌘T remains available.
• Partially out-of-image ROIs calculate mean, standard deviation, minimum, maximum, and pixel count from valid pixels only. Drawn area and dimensions remain unchanged. Empty intersections explicitly report no valid pixels.
• Q retains the existing Reset all behavior, including clearing the corresponding measurements and annotations in the current view. Save results first. R remains the local tool reset. CPR now restores image display state through the shared reset action while retaining its paths.
• Fixed Enter / Esc failing to finish or cancel curve and CPR drawing after switching tabs or closing workspace dialogs.
• Fixed lost initial drag movement when panning or editing measurements.
• Fixed duplicate CPR result-status labels during new-path drawing, Esc failing to cancel window-preset naming, and pseudocolor tinting the canvas outside the image.
• Fixed montage hover frames being covered by zoomed or panned images and occasional clipping of their bottom edge.

Installation, compatibility, and known limitations

• macOS: Apple Silicon DMG with ad-hoc signing, without Apple notarization.
• Windows: x64 installer and single-file portable EXE, without Authenticode signing.
• Gesture availability depends on events supplied by the operating system and device. Automated event checks do not certify every physical touchscreen or trackpad.
• Dense labels may still overlap and can be moved manually. CPR uses manually drawn paths, without automatic vessel tracking.
• MTF's 110% scales an internal adaptive integration baseline, not the selection or background region. It does not guarantee greater accuracy. Curved backgrounds, weak tails, and noise still affect results; finite target size is not corrected and results are not automatically graded.
• Manual installation and reading workflows on a clean physical Windows device or another Mac remain unverified. See the acceptance record for completed checks and remaining limits.

Related resources

Versioned manual · Full comparison · Release acceptance

Voxenra 2.4.0

Voxenra 2.4.0

发布日期：2026-11-05 · 统一测量与 CPR 操作，改善四图定位和右侧工具栏。

更新摘要

• 从序列打开视图统一新建独立页签；误关阅片页签可用「撤销关闭页签」找回。
• 长度、角度、矩形和椭圆按下即定点，点数足够自动完成；曲线、勾画和 CPR 双击结束。
• CPR 四图联动显示青色取样标记，区分层内、端视与投影；路径可直接点选编辑和删除。
• 重整右侧操作栏与测量结果层级，底部操作固定，长列表独立滚动。
• 统一测量与 CPR 的绘制状态样式，标注可使用独立颜色；完善工具快捷键和悬停提示。
• 改进导入反馈、DICOM 标签浏览状态恢复，以及测量结果定位、分割转换和图像导出。

Update summary

• Opening a view from a series creates an independent tab. Use Undo close tab to recover an accidentally closed reading tab.
• Length, angle, rectangle, and ellipse tools place points on press and finish at the required count. Curves, freehand ROIs, and CPR finish on double-click.
• Cyan CPR guides link all four views and distinguish in-plane, end-on, and projected samples. Click paths to edit or select them for deletion.
• Reorganized the right sidebar and measurement results, with fixed footer actions and independently scrolling lists.
• Unified drawing-state styles for measurements and CPR, with separate annotation colors and clearer tool shortcuts and hints.
• Improved import feedback, DICOM tag-state restoration, result navigation, segmentation conversion, and image export.

中文说明

升级须知

从 2.4.0 下载页选择对应平台安装包。Windows 2.2.0 用户仍需手动下载安装；该旧版本的更新器可能在开始安装前退出。

升级前保存工作区，并在覆盖保存前保留一份副本。新版读取旧工作区时保留已有标注颜色；新增的标注样式与标签浏览状态不保证被旧版本完整读取。工作区仍引用原始影像，请保留源文件。

主要改进

• 测量与标注：固定点数工具按下即确认点位，满足点数后自动完成，减少等待双击判定带来的延迟。曲线、勾画和 CPR 保留双击完成，结束手势不会额外添加末端点。完成后再次双击可放大或还原视口。
• CPR 定位：青色标记关联参考图、曲面图和横截面；层内取样线显示实线，端视显示点，离层或倾斜投影显示虚线与说明。横截面取样线使用端帽或延伸尖角区分实际端点和超出显示范围的部分。完成或切换路径时，参考切片对齐起点 s=0，避免首次微移位置线才发生大幅重定位。
• CPR 路径操作：点击路径进入编辑，拖动控制点调整，点击空白处开始下一条路径。绘制新路径时保留历史路径参考。删除已选路径后继续使用 CPR 工具；草稿状态支持逐点撤回。
• 操作栏与结果列表：工具入口、当前工具内容及底部操作分层展示。测量结果按来源视图分组，名称、数值与操作更易区分。长列表独立滚动，重置和清除等底部操作保持可见。
• 显示与快捷键：测量和 CPR 使用一致的绘制、编辑与完成状态样式；标注可独立设色或跟随完成色。补齐测量工具快捷键，重置操作使用统一的菜单作用范围，悬停提示说明用途。
• 导入与工作区：影像导入入口简化结果反馈；工作区保存 DICOM 标签页的搜索、页码、展开及滚动状态。

行为变化与问题修复

• 从序列列表打开同类型视图时，每次都会新建独立页签。继续已有工作请切换原页签；误关时使用 撤销关闭页签。没有已完成编辑的已就绪阅片页签在本次会话中保留最近关闭的 20 个，含编辑结果的页签随工作区保存。
• 完成 CPR 路径后保留参考布局，但参考切片会对齐路径起点。绘制过程中不自动翻层。独立翻阅参考切片后，单纯激活结果视图不会重新定位；主动沿路径导航才更新参考位置。
• 修复 CPR 选中后 Delete 无效、近距离点选行为不一致，以及工具切换后错误回到调窗的问题。
• 修复窗口失焦后悬停提示残留、列表挤占底部操作区及部分按钮文字截断。
• 改善测量结果定位和自由形状 ROI 转分割时的对象、切面判定；图像导出不再带入操作光标，导出完成后恢复显示状态。
• 修复手册加载期间快速切换页签时，文本选择菜单产生的界面警告。
• 修复对比视图和角度绘制提示在切换语言后未及时更新的问题。

安装兼容性与已知限制

• macOS：Apple Silicon DMG，ad-hoc 签名，未经 Apple 公证。
• Windows：x64 安装版及单文件便携版，未配置 Authenticode 签名。
• CPR 仍使用手动三维折线路径，不提供自动血管追踪；曲面图提供沿线距离，普通物理测量用于参考平面和垂直横截面。
• 自动化检查不能替代 Windows 物理机人工阅片、干净设备安装及实际部署环境验收。最终完成与未覆盖的检查见发布验收记录。

相关资料

本版操作手册 · 完整版本差异 · 发布验收记录

English details

Released 2026-11-05. This version unifies measurement and CPR interactions and improves linked positioning and the right sidebar.

Upgrade notes

Choose the appropriate package from the 2.4.0 release. Windows 2.2.0 users still need a manual installation because that older updater may exit before installation begins.

Save your workspace and keep a copy before overwriting it. Existing annotation colors are retained when loading older workspaces. Older versions may not fully read the newly saved annotation styles and DICOM tag-browser state. Keep the original images referenced by your workspace.

Improvements

• Measurements and annotations: Fixed-point tools place each point on press and complete at the required count, avoiding double-click recognition delays. Curves, freehand ROIs, and CPR retain double-click completion without adding a final point. A subsequent double-click maximizes or restores the viewport.
• CPR positioning: Cyan guides connect reference images, the curved view, and the cross-section. In-plane lines are solid, end-on lines appear as points, and oblique or off-plane projections use labeled dashes. End caps and continuation chevrons distinguish actual sampling-line endpoints from ranges extending outside the display. Completing or selecting a path aligns reference slices to s=0 before the first small navigation step.
• CPR paths: Click a path to edit, drag control points, or click an empty area to begin another path. Earlier paths remain visible as references while drawing. Deleting a selected path keeps the CPR tool active; draft points can be removed one at a time.
• Sidebar and results: Tool selection, tool content, and footer actions have distinct areas. Measurement results are grouped by source view, with clearer names, values, and actions. Long lists scroll independently while reset and clear actions remain visible.
• Styles and shortcuts: Measurements and CPR share drawing, editing, and completion styles. Annotations can use a separate color or follow the completion color. Measurement shortcuts, scoped reset actions, and explanatory tooltips are more consistent.
• Import and workspaces: Simplified image-import feedback. Workspaces now retain DICOM tag search, page, expansion, and scroll state.

Behavior changes and fixes

• Opening a view from the series list creates an independent tab each time. Select the original tab to continue existing work, or use Undo close tab after an accidental close. The session retains the last 20 ready reading tabs without completed edits; tabs with editing results are retained in saved workspaces.
• Completing CPR keeps the reference layout open while aligning its slices to the path start. Drawing does not automatically scroll reference images. After independently browsing references, activating a result view alone does not relocate them; deliberate path navigation does.
• Fixed ineffective Delete actions on selected CPR paths, inconsistent placement of nearby points, and unintended switches back to windowing.
• Fixed tooltips remaining after window deactivation, lists overlapping footer actions, and truncated button text.
• Improved result navigation and object/plane checks when converting a freehand ROI to segmentation. Image exports omit the tool cursor and restore the display state afterward.
• Fixed text-selection menu warnings when switching tabs while the manual was loading.
• Fixed comparison-view and angle-drawing hints not refreshing when the interface language changes.

Installation, compatibility, and known limitations

• macOS: Apple Silicon DMG, ad-hoc signed and not Apple-notarized.
• Windows: x64 installer and single-file portable executable, without Authenticode signatures.
• CPR still uses manual 3D polylines, without automatic vessel tracking. Curved views provide centerline distances; ordinary physical measurements use reference planes and perpendicular cross-sections.
• Automated checks do not replace physical Windows image review, clean-device installation, or validation in the actual deployment environment. The release validation record lists completed checks and remaining gaps.

Related resources

Versioned manual · Full comparison · Release validation record

Voxenra 2.3.0

Voxenra 2.3.0

发布日期：2026-11-03 · CPR 操作、阅片快捷键与界面主题更新。

更新摘要

• Windows 2.2.0 用户需手动下载安装本版；修复 Windows 更新程序未启动安装的问题。
• 改进 CPR 路径绘制，支持采样示意、沿线区间标记和结果视图大小调整。
• CPR 页签关闭后，从序列打开会新建空白路径；通过「重新打开页签」恢复原结果。
• 新增菜单数字快捷键、色表收藏和「跟随系统」主题。
• 修复曲线与自由手绘 ROI 完成时的交互问题，保留已有控制点和分屏布局。
• 完善对话框 Enter / Esc 操作；首次本地导入自动选中首个序列。

Update summary

• Windows 2.2.0 users must download and install this release manually. Fixed the Windows updater failing to start installation.
• Improved CPR path drawing with sampling guides, centerline interval markers, and resizable result views.
• Opening CPR from a series after closing its tab starts a blank path. Use Reopen tab to restore earlier results.
• Added number-key menu shortcuts, favorite color maps, and a Follow system theme.
• Fixed curve and freehand ROI completion so existing control points and the split layout are preserved.
• Improved Enter and Esc actions in dialogs. The first local import automatically selects the first series.

中文说明

升级须知

Windows 2.2.0 用户需要手动升级。 请从本版下载页下载安装版或便携版。旧版更新程序可能在开始安装前退出，本版已修复该问题。

主要改进

• CPR：参考影像加载完成即可布点。支持直接拖动控制点、在线段上插点、查看采样宽度与投影厚度，以及标记中心线区间。完成路径后继续显示参考布局；结果视图之间的分隔比例可调整，并随工作区保存。
• 阅片操作：布局、窗模板和色表支持按当前列表顺序使用数字快捷键；缩放支持数字键选倍率，常用色表可以收藏置顶。快捷键作用于当前窗口和菜单，数值输入框保持正常输入。
• 对话框与导入：支持 Enter 执行默认操作、Esc 返回或请求取消任务；多行输入框保留换行。首次本地导入选中首个序列，追加导入保留已有选择。
• 外观：新增「跟随系统」主题，系统切换明暗模式时同步更新。深色、中性深灰和浅色仍可单独选择，新安装默认深色。

行为变化与问题修复

• CPR 页签关闭后，从序列再次打开会开始空白路径。原路径与测量可通过 工作区 → 重新打开页签 恢复。
• 双击结束 CPR、曲线或自由手绘 ROI 时，不再把结束手势追加为控制点，也不切换分屏布局。再次选择当前测量工具会保留正在绘制的测量。
• 修复移动、拆出及反复打开页签时出现的加载提示、悬停提示和视口显示异常。

安装兼容性与验证范围

• macOS：Apple Silicon DMG，使用 ad-hoc 签名，未经 Apple 公证。
• Windows：x64 安装版和单文件便携版，未配置 Authenticode 签名。
• Windows 物理机人工阅片，以及从已安装的 2.2.0 客户端点击更新的完整流程，尚未完成验收。已完成的自动化升级与安装检查不能替代这些场景。

2.3.0 操作手册 · 发布验收记录

English details

Released 2026-11-03. This version improves CPR workflows, reading shortcuts, and interface themes.

Upgrade notes

Windows 2.2.0 users must upgrade manually. Download the installer or portable executable from this release. The older updater may exit before installation starts; this version fixes that issue.

Improvements

• CPR: Place points as soon as reference images are ready. Drag control points, insert points on segments, inspect sampling width and projection thickness, and mark centerline intervals. Completing a path keeps the reference layout open. Result-view split ratios are adjustable and saved in the workspace.
• Reading controls: Number keys select layouts, window presets, and color maps in list order, or choose zoom levels. Favorite color maps appear first. Shortcuts follow the active window and menu while numeric fields retain normal typing.
• Dialogs and import: Enter activates the default action; Esc dismisses a dialog or requests task cancellation. Multiline fields retain line breaks. The first local import selects the first series; subsequent imports preserve the current selection.
• Appearance: Follow system tracks the operating system's light or dark mode. Dark, Neutral dark, and Light remain available as fixed themes. New installations default to Dark.

Behavior changes and fixes

• Opening CPR from a series after closing its tab starts a blank path. Recover earlier paths and measurements through Workspace → Reopen tab.
• Double-clicking to finish CPR, a curve, or a freehand ROI no longer adds the finishing gesture as a control point or changes the split layout. Selecting the current measurement tool again preserves the measurement in progress.
• Fixed loading, tooltip, and viewport display errors when moving, detaching, or repeatedly opening tabs.

Installation and validation scope

• macOS: Apple Silicon DMG, ad-hoc signed and not Apple-notarized.
• Windows: x64 installer and single-file portable executable, without Authenticode signatures.
• Manual image review on a physical Windows computer and the complete update flow initiated from an installed 2.2.0 client remain unverified. Automated installation and upgrade checks do not cover those scenarios.

Version 2.3.0 manual · Release validation record

Voxenra 2.2.0

Voxenra 2.2.0

更新摘要

• 新增 CPR 曲面重建，支持手动路径编辑、联动横截面和图像导出。
• 改进重建操作、工作区保存恢复及多语言界面的一致性。
• 修复路径微调、撤销、标注显示和错误提示等问题。
• 4D 影像与导出图保留当前时相，小视口分析标签避开测量目标。
• 改进分屏拖入序列，更新操作手册与 CPR 界面示例。

Update summary

• Added CPR with editable manual paths, linked cross-sections, and image export.
• Improved reconstruction workflows, workspace persistence, and language consistency.
• Fixed fine path adjustments, undo behavior, annotation display, and error messages.
• 4D images and exports show the displayed phase. Compact analysis labels leave the ROI visible.
• Improved drag and drop in split views and updated the manual with CPR screenshots.

完整说明 / Details

CPR 支持单个灰度 CT / MR 体数据和手动三维折线路径。当前不自动提取或平滑血管中心线。普通物理测量用于参考平面和垂直横截面；曲面图提供中心线距离。工作区保留路径、参数与测量，导出格式为 PNG。

CPR supports one grayscale CT / MR volume and manual 3D polylines. Automatic vessel tracking and smoothing are not included. Physical measurements use reference planes and perpendicular cross-sections; curved images provide centerline distances. Workspaces retain paths, parameters, and measurements. Image export uses PNG.

提供 macOS Apple Silicon、Windows x64 安装版与单文件便携版。本次 macOS 包使用 ad-hoc 签名，未经过 Apple 公证；Windows 包未配置 Authenticode 签名。Windows 完整人工阅片和旧客户端自动更新流程仍未完成实机验收。

Packages cover macOS Apple Silicon and Windows x64 (installer and single-file portable). The macOS package is ad-hoc signed and not Apple-notarized; Windows packages are not Authenticode-signed. Full manual Windows viewing and previous-client update workflows have not been verified on a physical Windows computer.

Voxenra 2.1.5

Voxenra 2.1.5

更新摘要

• 新增常用影像目录收藏，支持快捷切换、拖拽排序和取消收藏。
• 改进四角信息设置，支持直接预览、拖拽排序和跨角移动。
• 优化页签、调窗面板及提示样式，减少多余留白和说明。
• 修复收藏切换抖动、拖拽取消及部分界面状态问题，提升操作稳定性。
• 更新操作手册和界面示例。

Update summary

• Added favorite image folders with quick access, drag ordering, and easy removal.
• Improved corner information settings with direct previews, drag ordering, and moves between corners.
• Refined tabs, windowing controls, and tooltips to reduce excess spacing and text.
• Fixed favorite-folder flicker, drag cancellation, and interface state issues for smoother operation.
• Updated the user manual and interface examples.

安装与兼容 / Installation and compatibility

提供 macOS Apple Silicon DMG、Windows x64 安装版和便携版。macOS 使用 ad-hoc 签名，未经过 Apple 公证；Windows 未配置 Authenticode 签名。已有工作区和设置继续兼容，工作区仍需保留原始影像。

Available for macOS Apple Silicon and Windows x64 (installer and portable). macOS packages are ad-hoc signed without Apple notarization; Windows packages are not Authenticode signed. Existing workspaces and settings remain compatible. Keep the original images used by workspaces.

验证范围 / Validation scope

发布检查记录列出本次平台回归及安装包验收结果。Windows/Linux 外部 AI 实际推理、真实崩溃恢复和旧版 Windows 客户端完整点击自动更新流程未完成实机验收。

The release validation report records platform regressions and package checks. External AI inference and real crash recovery on Windows/Linux, and the complete update workflow in older Windows clients, have not been verified on physical target machines.

Voxenra 2.1.4

Voxenra 2.1.4

更新摘要

• 新增传统 DICOM PACS 连接、查询与影像导入。
• 优化工具栏分类与拖拽设置，支持常用工具排序和保存。
• 改进阅片信息、窗模板收藏和视图区最大化操作。
• 修复部分工具栏配置及界面交互问题，提升使用稳定性。
• 补充操作手册、截图与演示动画，优化主页加载速度。

Update summary

• Added traditional DICOM PACS connections, queries, and image import.
• Improved toolbar categories and drag editing, with saved tool ordering.
• Improved reading information, favorite window presets, and image-area maximization.
• Fixed toolbar configuration and interface interaction issues for improved reliability.
• Expanded manuals, screenshots, and tutorials, and improved homepage loading.

安装与兼容 / Installation and compatibility

• 提供 macOS Apple Silicon DMG、Windows x64 安装版和便携版。
• macOS 使用 ad-hoc 签名，未经过 Apple 公证；Windows 未配置 Authenticode 签名。
• 已有工作区与设置继续兼容；工作区仍需保留原始影像。DIMSE 需 PACS 管理员登记接收节点，暂不支持 C-GET 或 DICOM TLS。
• macOS packages are ad-hoc signed without Apple notarization; Windows packages are not Authenticode signed. Existing workspaces and settings remain compatible. Keep the original images. DIMSE requires a registered receiver and does not support C-GET or DICOM TLS.

验证范围 / Validation scope

发布检查记录将列出平台回归与产物验收结果。Windows/Linux 真实 AI 推理、崩溃恢复及旧版 Windows 客户端完整点击更新流程未完成实机验收；本地 DIMSE 演示不等同于所有厂商 PACS 兼容认证。

Platform regression and package checks are documented in the release validation report. Native AI inference and crash recovery on Windows/Linux, and the complete update workflow in older Windows clients, remain unverified. Local DIMSE validation does not certify every PACS vendor.

Voxenra 2.1.3

Voxenra 2.1.3

更新摘要

• 改进工作区新建、保存和页签关闭流程，保留已关闭页签的编辑结果。
• 完善 QA 圆形 ROI 操作，支持自动取样、移动、复制、删除及撤销重做。
• 优化部分界面样式、提示和本地操作手册。
• 修复工作区恢复、分析状态及相关交互问题，提升操作稳定性。

Update summary

• Improved workspace creation, saving, and tab closing while retaining results from closed tabs.
• Improved circular QA ROIs with automatic sampling, moving, copying, deleting, undo, and redo.
• Refined interface styling, messages, and the offline user manual.
• Fixed workspace restoration, analysis state, and related interaction issues to improve reliability.

安装与兼容 / Installation and compatibility

• 提供 macOS Apple Silicon DMG、Windows x64 安装版和便携版。
• macOS 包使用 ad-hoc 签名，未经过 Apple 公证；Windows 包未配置 Authenticode 签名。
• 已有工作区可继续打开；工作区文件仍需配合原始影像使用。
• macOS packages are ad-hoc signed without Apple notarization; Windows packages are not Authenticode signed. Existing workspaces remain supported and require their original images.

验证范围 / Validation scope

平台回归与产物验证结果见发布验证记录。Windows/Linux 的真实 AI 推理、崩溃恢复及 Windows 旧版客户端完整点击更新流程尚未完成实机验收。

Platform regression and package checks are recorded in the release validation report. Native AI inference and crash recovery on Windows/Linux, and the complete update workflow in older Windows clients, remain unverified.

Voxenra 2.1.2

Voxenra 2.1.2

更新摘要

• 完善本地操作手册，增加操作动图和重点提示。
• 优化小屏幕界面、分析工具入口及部分交互细节。
• 修复工作区恢复、播放控制、十字线和触控板翻片问题。
• 修复部分数值输入和界面状态问题，提升操作稳定性。

Update summary

• Improved the offline manual with workflow animations and clearer guidance.
• Improved small-screen layouts, analysis tool access, and interaction details.
• Fixed workspace restoration, playback, crosshair targeting, and touchpad scrolling.
• Fixed numeric input and interface state issues to improve reliability.

安装与兼容 / Installation and compatibility

• 提供 macOS Apple Silicon DMG、Windows x64 安装版和便携版。
• macOS 包为 ad-hoc 签名，未经过 Apple 公证；Windows 包未配置 Authenticode 签名。
• 本地 AI 分割仍需单独配置运行环境和模型；已有工作区可继续打开。
• macOS packages are ad-hoc signed without Apple notarization; Windows packages are not Authenticode signed. Local AI segmentation requires a separately configured runtime and models.

验证范围 / Validation scope

平台测试及产物核验结果见发布验证记录。旧版客户端的完整点击更新流程、Windows/Linux 真实 AI 推理与崩溃恢复尚未完成实机验收。

Platform tests and package checks are recorded in the release validation report. Complete update workflows in previously installed clients, and native AI inference and crash recovery on Windows/Linux, remain unverified.