Blender V5.3
gpu_shader_material_axes_to_rotation.bsl.hh
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2026 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
5#pragma once
6
10
11[[node]]
12void axes_to_rotation(float3 primary_in,
13 float3 secondary_in,
14 float primary_idx_f,
15 float secondary_idx_f,
16 float tertiary_idx_f,
17 float tertiary_factor,
18 float4 &rotation)
19{
20 float3 primary = normalize(primary_in);
21 float3 secondary = secondary_in;
22 float3 tertiary;
23
24 const bool primary_is_non_zero = !is_zero(primary);
25 const bool secondary_is_non_zero = !is_zero(secondary);
26
27 if (primary_is_non_zero && secondary_is_non_zero) {
28 tertiary = cross(primary, secondary);
29 if (is_zero(tertiary)) {
30 tertiary = orthogonal<float3>(primary);
31 }
32 tertiary = normalize(tertiary);
33 secondary = cross(tertiary, primary);
34 }
35 else if (primary_is_non_zero) {
36 secondary = orthogonal<float3>(primary);
37 secondary = normalize(secondary);
38 tertiary = cross(primary, secondary);
39 }
40 else if (secondary_is_non_zero) {
41 secondary = normalize(secondary);
42 primary = orthogonal<float3>(secondary);
43 primary = normalize(primary);
44 tertiary = cross(primary, secondary);
45 }
46 else {
47 rotation = float4(1.0f, 0.0f, 0.0f, 0.0f);
48 return;
49 }
50
51 const int primary_axis = int(primary_idx_f);
52 const int secondary_axis = int(secondary_idx_f);
53 const int tertiary_axis = int(tertiary_idx_f);
54
55 float3x3 mat;
56 mat[primary_axis] = primary;
57 mat[secondary_axis] = secondary;
58 mat[tertiary_axis] = tertiary_factor * tertiary;
59
60 rotation = to_quaternion(mat).as_float4();
61}
62
63[[node]]
64void axes_to_rotation_identity(float3 /*primary_in*/, float3 /*secondary_in*/, float4 &rotation)
65{
66 rotation = float4(1.0f, 0.0f, 0.0f, 0.0f);
67}
VecBase< float, D > normalize(VecOp< float, D >) RET
VecBase< float, 3 > cross(VecOp< float, 3 >, VecOp< float, 3 >) RET
void axes_to_rotation_identity(float3, float3, float4 &rotation)
void axes_to_rotation(float3 primary_in, float3 secondary_in, float primary_idx_f, float secondary_idx_f, float tertiary_idx_f, float tertiary_factor, float4 &rotation)
bool is_zero(float3x3 a)
Quaternion to_quaternion(EulerXYZ eul)
VecT orthogonal(VecT v)