GraphiteEditor / GraphiteEditor/Graphite
Tangent on Path node unclear output
- 主要言語
- Rust
- スター
- 27.3k
- フォーク
- 1.3k
- 平均マージ
- 20時間 5分
- マージ済み PR(30日)
- 57
説明
The « Tangent on Path » node returns an angle in degrees clockwise from the +X axis. However this is really not clear. The tooltip states:
> Determines the angle of the tangent at a point on the path, given by its progression from 0 to 1 along the path.
> If multiple subpaths make up the path, the whole number part of the progression value selects the subpath and the decimal part determines the position along it.
The angle of the tangent of a bézier curve is often expressed as a unit vector [such as on Pomax's bezierinfo](https://pomax.github.io/bezierinfo/#pointvectors). It is very easy for a user to assume that this might be the case (I did). This is especially true since non connected nodes do not get type hints about the output type. It is also possible that they do not know from where the angle is measured since it is never stated. Also why clockwise? I generally see anticlockwise from +X in e.g. argument of complex number.
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
調査の方向性
Tangent on Path ノードとその tooltip のテキストを見つけ、次にそのノードが角度出力をどのように公開しているかを確認します。結果が度単位の角度であること、+X 軸から時計回りに測定されることを明確にし、単位ベクトル出力とは異なることを示します。ノードの動作を変更せずに tooltip がこれらの曖昧さを解消できれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- rust
- 領域
- documentation
- issue の種類
- ドキュメント
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 活発さ
- 静か
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 68/100