Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Matrix layout is only partially documented

未关闭
#1,895 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
45/100
Issue 类型
文档
描述清晰度
基本清楚
活跃度
停滞

调研方向

查找 matrix() 的文档,包括其 16-float 构造函数和 [][] 运算符。说明基向量是行还是列,并明确由此产生的矩阵乘法和变换顺序;当两处歧义都得到明确解决时即完成。

由索引模型根据 Issue 内容生成。

描述

The documentation of matrix() points out that the 16-float constructor form accepts values in row major order, and the [][] operator accepts first a row and then a column. However that by itself is not meaningful, it also needs to specify if matrices have basis vectors in rows or columns. Depending on that choice:

  • A translation matrix may be either matrix(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, tx, ty, tz, 1), or
    matrix(1, 0, 0, tx, 0, 1, 0, ty, 0, 0, 1, tz, 0, 0, 0, 1).
  • The expression point p3 = transform(M1 * M2, p1) may be equivalent to either
    point p2 = transform(M1, p1) ; point p3 = transform(M2, p2);, or
    point p2 = transform(M2, p1) ; point p3 = transform(M1, p2);

In algebraic terms, that matrix multiplication would look like $\mathbf{p}\mathbf{M}_1\mathbf{M}_2$ (if vectors are rows), or $\mathbf{M}_2\mathbf{M}_1\mathbf{p}$ (if vectors are columns).

主要语言
C++
星标
2.3k
派生
414
平均合并
2 天 14 小时
30 天内合并 PR
13

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

AcademySoftwareFoundation/OpenShadingLanguage 的其他 Issue

查看 AcademySoftwareFoundation/OpenShadingLanguage 的全部 Issue

相似的 Issue

更多 C++ Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。