HarmonyOS鸿蒙Next中优化建议-ArkUI的Path2D文档需要优化

HarmonyOS鸿蒙Next中优化建议-ArkUI的Path2D文档需要优化【问题描述】：Path2D的arcTo方法参数描述存在错误，将“控制点”错写为“圆弧经过的点”。

【原文链接】：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-components-canvas-path2d

【原文片段】：圆弧经过的第一个点的x坐标值

【问题现象】：在所有标准的Canvas 2D与Path2D几何规范中，arcTo(x1, y1, x2, y2, radius)里的(x1, y1)和(x2, y2)都是用来与当前点构成夹角的控制点，最终绘制的是与这两条切线相切的圆弧。除特殊情况外，圆弧根本不可能经过这两个控制点。

【版本信息】：不涉及

【复现代码】：不涉及

更多关于HarmonyOS鸿蒙Next中优化建议-ArkUI的Path2D文档需要优化的实战教程也可以访问 https://www.itying.com/category-93-b0.html

zlyuanteng 1楼

开发者您好，文档已修复，请打开文档进行查验。感谢您的理解与支持。

更多关于HarmonyOS鸿蒙Next中优化建议-ArkUI的Path2D文档需要优化的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

vueper 2楼

尊敬的开发者，您好！感谢您的反馈，问题正在加速处理中，还请关注后续版本，感谢您的理解与支持。

sinazl 3楼

这个反馈是对的。Canvas/Path2D 的 arcTo(x1, y1, x2, y2, radius) 语义不是“圆弧经过两个点”，而是以当前点、控制点1、控制点2形成的两条切线为约束，绘制与两条线相切的圆弧；(x1, y1) 和 (x2, y2) 更准确地说是控制点/切线参考点，圆弧通常不会经过这两个点。

建议文档把“圆弧经过的第一个点/第二个点”改成“用于构造圆弧切线的第一个控制点/第二个控制点”，并在方法总说明中补一句“该接口根据当前点、两个控制点和半径生成与两条线段相切的圆弧”。这样和通用 Canvas 2D 的 arcTo 语义更一致。

eggper 4楼

caililin 5楼

ArkUI的Path2D文档当前存在参数说明不完整、示例代码覆盖率低及API边界条件缺失等问题。建议补充路径构造方法的重载细节、每个方法的返回值类型、异常处理场景，并增加复杂图形绘制示例及性能参数说明。

itying888 6楼

您指出的问题准确。在Canvas 2D标准中，arcTo(x1, y1, x2, y2, radius) 的 (x1, y1) 和 (x2, y2) 均为控制点，用于与当前点构造两条切线，最终绘制的是与这两条切线相切的圆弧，圆弧在绝大多数情况下并不会经过这两个点。文档中将其描述为“圆弧经过的第一个点”属于明显的定义错误，应将参数说明修正为“第一个控制点的x坐标值”和“第二个控制点的x坐标值”等表述，以符合通用规范，避免开发者误解。