图形编辑器开发:属性显示与格式转换

开发 前端
图形编辑器中的数据,通过 UI 层进行展示时,可能不会直接将数据源的原始值展示出来,而是会额外进行单位的转换,变成另一种格式。

大家好,我是前端西瓜哥。

今天简单讲讲图形编辑器的显示属性值时,会遇到的格式转换问题。

编辑器 github 地址:

https://github.com/F-star/suika

线上体验:

https://blog.fstars.wang/app/suika/

单位转换

图形编辑器中的数据,通过 UI 层进行展示时,可能不会直接将数据源的原始值展示出来,而是会额外进行单位的转换,变成另一种格式。

这里以简单而常见的弧度为例。

图形的旋转在数据源中,会用弧度(radian)表示。因为弧度更适合进行数学计算,且很多 API 比如 Math.sin(x) 都需要你提供弧度。

但在面向用户的 UI 层,我们通常会提供角度(degree),因为日常生活中人们更常使用,它更直观。

但数据中我们还是要保存弧度的。

转换算法

我们需要明确的点是:

  • 数据源要用唯一格式,这样可以确保运算逻辑的一致性。比如旋转不建议即可以保存弧度,也可以保存角度。另外,尽量选择精度高的。
  • 如果有显示另一种格式的需求,你需要实现源格式转其他格式算法。比如弧度转角度显示到用户界面上;
  • 如果有修改其他格式然后修改源数据的需求,你需要实现其他格式转源数据的算法。
/**
 * 弧度转角度
 */
export function radian2Degree(radian: number) {
  return (radian * 180) / Math.PI;
}

/**
 * 角度转弧度
 */
export function degree2Radian(degree: number) {
  return (degree * Math.PI) / 180;
}

需要注意,格式的转换通常会丢失一些精度的。

这里弧度和角度的转换就是一个例子。

圆周率是一个无限不循环小数,计算的时候,会对其丢掉一些精度再参与计算,最后的结果自然也丢失了精度。

这里给一下 UI 层实现思路,以 React 组件为例,核心实现大致如下:

const [radian, setRadian] = useState(0);

useEffect(() => {
  rect.onRotationChange((val) => {
    // 从编辑器内核同步过来的状态
    setRadian(val);
  })
});

<NumberInput
  label="旋转"
  value={remainDecimal(radian2Degree(radian))}
  onBlur={(e) => {
    const degree =  e.target.value;
    const radian = normalizeRadian(degree2Radian(degree));
    rect.setRotation(radian);
  }}
/>

题外话,UI 层会直接更新编辑器中的状态,成功更新后通过事件订阅通知回 UI 层,同步状态。

弧度还是比较简单的场景。

像是复杂一点的属性,比如颜色值,通常要实现一个比较完善的拾色器,要支持多种格式,如RGBA、HSL、CMYK 等等,要实现的方法就更复杂也更多。

降低显示精度

UI 层不会显示全精度,意义不大。

比如 x 坐标的真实值是 52.24621202458749,但用户是不希望看到这么长的值的,他只是想知道这个点大概在什么位置。

所以我们最好做一个四舍五入,比如保留有限的有效位显示为 52.25。

需要注意的是,修改属性值时不用做降低精度再转为源格式,我们的数据源精度越高越好。

只在显示时做降低精度。

检验和补正

因为涉及到用户修改属性值,所以我们需要对用户的输入值进行处理,尝试得到一个合法值去修改属性。

简单的做法是 严格校验,比如对于数字类型,出现非数字字符,就直接认为非法值。

稍微好一点的是从字符串中提取符合格式的部分。

更人性化的是猜测用户想干嘛,做补全。比如对于 hex 格式的颜色值,用户只输入一个 3,我们给他补全为 33333。

最后

画一张图总结一下。

展示层可能和数据源的格式不同,显示时要做格式转换,然后降低精度,比如对于数字通常保留 1 到 5 个小数位就够了。

修改非源格式要做校验和补正,然后转回数据源格式保存起来。保存成功后再把新值传递到 UI 层。

责任编辑:姜华 来源: 前端西瓜哥
相关推荐

2023-10-19 10:12:34

图形编辑器开发缩放图形

2023-08-31 11:32:57

图形编辑器contain

2023-09-07 08:24:35

图形编辑器开发绘制图形工具

2023-09-26 07:39:21

2023-09-11 09:02:31

图形编辑器模块间的通信

2024-01-08 08:30:05

光标图形编辑器开发游标

2023-08-28 08:10:50

Hex图形编辑器

2023-10-08 08:11:40

图形编辑器快捷键操作

2024-01-03 08:43:17

图形编辑器旋转控制点缩放控制点

2023-07-07 13:56:01

图形编辑器画布缩放

2023-07-31 08:46:07

图形编辑器图形自动对齐

2023-01-18 08:30:40

图形编辑器元素

2023-02-01 09:21:59

图形编辑器标尺

2023-02-06 16:59:57

Canvas编辑器

2023-04-07 08:02:30

图形编辑器对齐功能

2023-06-12 08:22:56

图形编辑器工具

2023-01-17 09:16:57

视口坐标图形编辑器

2023-04-10 08:45:44

图形编辑器排列移动功能

2023-05-09 08:15:32

图形编辑器撤销重做功能

2023-02-09 07:02:30

图形编辑器修改图形
点赞
收藏

51CTO技术栈公众号