PAYATHON 2026

iOS 如何获取真实屏幕 PPI/DPI,并在 Delphi FMX 中按厘米绘图?

数据小许

结论

iOS 没有通用的公开 API 能直接返回当前屏幕的真实物理 PPI。仅凭 scale、bounds、nativeBounds 或 nativeScale,无法确定屏幕上 1 cm 对应多少绘图单位。

绘制接近 3 cm × 3 cm 的矩形需要物理尺寸依据:可以使用已知设备的 PPI,也可以让用户用尺子或已知长度的实物校准。设备型号查询表只是其中一种方案。如果尺寸精度是核心要求,建议提供校准入口,并在真机上验证误差。

这些屏幕参数分别表示什么?

参数含义能否单独用于厘米换算
bounds屏幕在逻辑坐标中的尺寸,单位为 points不能
scale逻辑 points 到渲染像素的缩放系数不能
nativeBounds物理屏幕的原生像素范围不能
nativeScale逻辑 points 到屏幕原生像素的缩放系数不能

这些参数描述了坐标与像素之间的关系,但没有提供屏幕的厘米或英寸尺寸。Apple 对 scale 和 nativeScale 的说明也区分了逻辑坐标、渲染像素和屏幕原生像素。

scale 与 nativeScale 可能不同:系统可以先按 UIKit 的比例渲染,再缩放到面板的原生分辨率。因此,即使已知面板 PPI,也不能一律使用 scale 换算物理长度。Apple 的屏幕兼容性文档说明了这一处理过程。

另外,iOS 的 point 不应直接按印刷排版中的 1/72 英寸计算。

已知真实 PPI 时,如何计算尺寸?

先将厘米换算成屏幕原生像素:

nativePixels = lengthCm / 2.54 × PPI

如果绘图坐标使用 UIKit points,且没有额外缩放,继续换算:

lengthInPoints = lengthCm / 2.54 × PPI / nativeScale

3 cm 对应的逻辑长度为:

sideInPoints = 3.0 / 2.54 × PPI / nativeScale

这里的 PPI 必须来自与实际屏幕匹配的可靠资料或测量,不能通过 scale × 某个固定 DPI 推算。仅有 nativeBounds 也不够,因为它没有给出面板的实际宽度或高度。

Delphi FMX 换算示例

在 FMX 中,还需要确认控件坐标到屏幕原生像素的实际映射。下面的函数将该映射作为参数传入,避免把渲染缩放系数误当成物理密度:

uses
  System.SysUtils,
  FMX.Objects;

function CmToFmxUnits(const ACm, APpi,
  ANativePixelsPerFmxUnit: Double): Single;
begin
  if ACm < 0 then
    raise EArgumentException.Create('Length must not be negative');

  if (APpi <= 0) or (ANativePixelsPerFmxUnit <= 0) then
    raise EArgumentException.Create('Invalid display metrics');

  Result := ACm / 2.54 * APpi / ANativePixelsPerFmxUnit;
end;

procedure SetSquare3Cm(const ARectangle: TRectangle;
  const APpi, ANativePixelsPerFmxUnit: Double);
var
  Side: Single;
begin
  Side := CmToFmxUnits(3.0, APpi, ANativePixelsPerFmxUnit);
  ARectangle.Width := Side;
  ARectangle.Height := Side;
end;

如果已确认当前 FMX 场景中,1 个控件坐标单位对应 1 个 UIKit point,且控件和父容器没有附加缩放,就可以将目标屏幕的 nativeScale 作为 ANativePixelsPerFmxUnit 传入。否则,需要把额外变换计入这个参数。

Width、Height 不一定等于最终可见尺寸:父容器缩放会影响显示结果,自动布局也可能重新设置大小。FMX 的坐标与布局文档有具体说明。示例只展示换算和赋值,不包含设备 PPI 查询及平台绑定代码。

不维护设备表,可以怎样实现?

可以直接校准每厘米对应多少 FMX 坐标单位,无需先获得 PPI。

操作过程如下:

  1. 在屏幕上显示一条可以调节长度的线段。
  2. 让用户用实体尺将线段调整到已知长度,例如 5 cm。
  3. 记录线段在当前绘图坐标中的长度 L。
  4. 计算每厘米的坐标单位数,再用于绘图。
fmxUnitsPerCm = L / 5.0
squareSide = 3.0 × fmxUnitsPerCm

校准应在最终显示矩形的坐标环境中完成。校准值只适用于对应的屏幕和缩放配置;更换屏幕、改变显示模式或调整应用内缩放后,需要重新确认,必要时重新校准。

设备型号查询表适合什么情况?

查询表可以为已知设备提供初始尺寸,无需用户操作,但需要处理几个实际问题:

  • 使用能够区分硬件的型号标识,不能依赖用户设置的设备名称。
  • 为新设备和未知型号准备校准或手动设置入口,不能默认套用某个固定 PPI。
  • 内置屏幕的 PPI 不能直接用于外接显示器,应以实际承载窗口的屏幕为准。
  • 资料中的标称 PPI 可能经过取整,不能据此承诺测量级精度。

如果业务要求较高,可以用查询表提供初值,再通过实物校准修正。

专业应用应如何选择?

专业 iOS 应用可以根据需求选择方案:普通界面布局使用逻辑坐标;需要展示近似实物大小时,使用已知 PPI 配合正确的坐标换算;需要充当尺子或展示尺寸基准时,增加用户校准,并定义可接受的误差范围。

“恰好 3 cm”也需要明确测量边界。矩形填充区域、描边中心线和描边外缘并不相同。验证时宜先关闭描边,避免把线宽算入尺寸。像素离散和重采样也会限制边缘定位精度,不能保证任意物理长度都恰好落在像素边界上。

Android 的 densityDpi 也不能直接视为精确的物理 PPI。它用于表示界面缩放密度;xdpi、ydpi 是 API 中描述水平、垂直物理像素密度的字段。涉及实际测量时,同样应进行真机验证。参见 Android DisplayMetrics 文档。

备注:内容仅供参考。