-
Notifications
You must be signed in to change notification settings - Fork 353
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Align GLSL matrix multiply and divide with OSL and C++ #2089
Comments
The MaterialX Specification only states that the constructor values for a matrix are "9 or 16 floats separated by commas, specified in row-major order". It doesn't (and I believe shouldn't) state whether the resulting matrix is row-major or column-major ordering in memory; instead, each shading language should use whatever its native representation for a matrix is. So anything that constructs a matrix (either direct values or the <creatematrix> node) should put the 9 or 16 values in the correct places for an implementation, e.g. the 13th, 14th and 15th values in a matrix contructor tuple should go in the 1st/2nd/3rd spots in the bottom row of the matrix, however that's actually laid out in memory. Similarly for anything that reads or extracts specific values from within a matrix: we should provide nodes to do that in a language-independent way (e.g. there is a proposed <extractrowvector> node, there should also be an <extractcolumnvector> node). |
Good catch, @HardCoreCodin, and we've proposed to address this by updating the GLSL implementations of matrix multiply and divide to align with the OSL behavior. The OSL behavior of the matrix product additionally aligns with our own reference implementation in MaterialX C++, which is defined here: https://github.com/AcademySoftwareFoundation/MaterialX/blob/main/source/MaterialXCore/Types.h#L511 |
Shading languages use different matrix conventions: OSL is row major, GLSL is column major
This determines multiplication order:
M1 * M2
in OSL isM2 * M1
in GLSLMaterialX back-end implementations generate code with the same ordering, consistent with the node inputs.
If it is correct for OSL, it would be incorrect for GLSL (and vice versa)
This makes the same node (and hence any graph that uses it) non-portable across back-ends.
MaterialX specification mentions row major, but only with reference to matrix literal construction component ordering.
However, both OSL and GLSL use the same ordering anyway: ( X.x, X.y, X.z , Y.x, Y.y, Y.z , Z.x, Z.y, Z.z )
So this is not really saying anything meaningful.
The specification should state what the implied matrix convention is in MaterialX - explicitly.
All implementations should then be made to account for that convention.
If it is row major, then the ordering for the
multiply
node types that take a 3x3 or 4x4 matrix, should be reversed in GLSL.There should also be a special handling for
divide
node types, as just flipping the order will not suffice:Matrix division is defined as the first matrix provided multiplied by the inverse of the second.
The correct matrix need to be inverted in column-major implementations.
The text was updated successfully, but these errors were encountered: