Blender V5.3
types_dual.h
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2025 Blender Foundation
2 *
3 * SPDX-License-Identifier: Apache-2.0 */
4
5#pragma once
6
7#include "util/types_float2.h"
8#include "util/types_float3.h"
9#include "util/types_float4.h"
10
12
13template<class T> struct dual {
14 T val = T(), dx = T(), dy = T();
15 dual() = default;
16 ccl_device_inline_method explicit dual(const T val) : val(val) {}
17 ccl_device_inline_method dual(const T val, const T dx, const T dy) : val(val), dx(dx), dy(dy) {}
18};
19
20template<> struct dual<float> {
21 float val = 0.0f;
22 float dx = 0.0f;
23 float dy = 0.0f;
24 dual() = default;
25 ccl_device_inline_method explicit dual(const float val) : val(val) {}
26 ccl_device_inline_method dual(const float val, const float dx, const float dy)
27 : val(val), dx(dx), dy(dy)
28 {
29 }
30};
31
32template<> struct dual<float2> {
36 dual() = default;
39 : val(val), dx(dx), dy(dy)
40 {
41 }
43 {
44 return {val.x, dx.x, dy.x};
45 }
47 {
48 return {val.y, dx.y, dy.y};
49 }
50};
51
52template<> struct dual<float3> {
56 dual() = default;
59 : val(val), dx(dx), dy(dy)
60 {
61 }
63 {
64 return {val.x, dx.x, dy.x};
65 }
67 {
68 return {val.y, dx.y, dy.y};
69 }
71 {
72 return {val.z, dx.z, dy.z};
73 }
74};
75
76template<> struct dual<float4> {
80 dual() = default;
83 : val(val), dx(dx), dy(dy)
84 {
85 }
87 {
88 return {val.x, dx.x, dy.x};
89 }
91 {
92 return {val.y, dx.y, dy.y};
93 }
95 {
96 return {val.z, dx.z, dy.z};
97 }
99 {
100 return {val.w, dx.w, dy.w};
101 }
102};
103
108
109/* Dual type traits. */
110
111template<typename T> struct is_dual {
113};
114template<typename U> struct is_dual<dual<U>> {
116};
117
119
120/* Base (non-dual) type. E.g. dual_base_t<dual3> = float3, dual_base_t<float3> = float3. */
121
122template<typename T> struct dual_base_type {
123 using type = T;
124};
125template<typename U> struct dual_base_type<dual<U>> {
126 using type = U;
127};
128template<typename T> using dual_base_t = typename dual_base_type<T>::type;
129
130/* Scalar type corresponding to a vector type. */
131
132template<typename T> struct dual_scalar_type {
133 using type = T;
134};
135template<> struct dual_scalar_type<float3> {
136 using type = float;
137};
138template<> struct dual_scalar_type<dual3> {
139 using type = dual1;
140};
141template<typename T> using dual_scalar_t = typename dual_scalar_type<T>::type;
142
147
149{
150 return {make_float2(a.val, b.val), make_float2(a.dx, b.dx), make_float2(a.dy, b.dy)};
151}
152
154{
155 return {make_float3(a.val, b.val, c.val),
156 make_float3(a.dx, b.dx, c.dx),
157 make_float3(a.dy, b.dy, c.dy)};
158}
159
161{
162 return {make_float3(a.val), make_float3(a.dx), make_float3(a.dy)};
163}
164
165ccl_device_inline dual4 make_float4(const dual1 a, const dual1 b, const dual1 c, const dual1 d)
166{
167 return {make_float4(a.val, b.val, c.val, d.val),
168 make_float4(a.dx, b.dx, c.dx, d.dx),
169 make_float4(a.dy, b.dy, c.dy, d.dy)};
170}
171
173{
174 return {make_float4(a.val), make_float4(a.dx, 0.0f), make_float4(a.dy, 0.0f)};
175}
176
178{
179 return {make_float4(a.val, 1.0f), make_float4(a.dx, 0.0f), make_float4(a.dy, 0.0f)};
180}
181
182ccl_device_inline void print_dual1(const ccl_private char *label, const dual1 a)
183{
184#ifdef __KERNEL_PRINTF__
185 printf("%s: {\nval = %.8f\n dx = %.8f\n dy = %.8f\n}\n",
186 label,
187 (double)a.val,
188 (double)a.dx,
189 (double)a.dy);
190#else
191 (void)label;
192 (void)a;
193#endif
194}
195
196ccl_device_inline void print_dual2(const ccl_private char *label, const dual2 a)
197{
198#ifdef __KERNEL_PRINTF__
199 printf("%s: {\nval = %.8f %.8f\n dx = %.8f %.8f\n dy = %.8f %.8f\n}\n",
200 label,
201 (double)a.val.x,
202 (double)a.val.y,
203 (double)a.dx.x,
204 (double)a.dx.y,
205 (double)a.dy.x,
206 (double)a.dy.y);
207#else
208 (void)label;
209 (void)a;
210#endif
211}
212
213ccl_device_inline void print_dual3(const ccl_private char *label, const dual3 a)
214{
215#ifdef __KERNEL_PRINTF__
216 printf("%s: {\nval = %.8f %.8f %.8f\n dx = %.8f %.8f %.8f\n dy = %.8f %.8f %.8f\n}\n",
217 label,
218 (double)a.val.x,
219 (double)a.val.y,
220 (double)a.val.z,
221 (double)a.dx.x,
222 (double)a.dx.y,
223 (double)a.dx.z,
224 (double)a.dy.x,
225 (double)a.dy.y,
226 (double)a.dy.z);
227#else
228 (void)label;
229 (void)a;
230#endif
231}
232
#define U
#define printf
#define ccl_private
#define ccl_device_inline
#define ccl_static_constexpr
#define ccl_device_inline_method
#define CCL_NAMESPACE_END
ccl_device_forceinline float3 make_float3(const float x, const float y, const float z)
#define T
#define make_float2
#define make_float4
KERNEL_FEATURE_LIGHT_PASSES KERNEL_FEATURE_PATH_GUIDING float
ccl_device_inline_method dual(const float2 val)
Definition types_dual.h:37
ccl_device_inline_method dual< float > y() const
Definition types_dual.h:46
ccl_device_inline_method dual(const float2 val, const float2 dx, const float2 dy)
Definition types_dual.h:38
dual()=default
ccl_device_inline_method dual< float > x() const
Definition types_dual.h:42
dual()=default
ccl_device_inline_method dual< float > x() const
Definition types_dual.h:62
ccl_device_inline_method dual(const float3 val)
Definition types_dual.h:57
ccl_device_inline_method dual< float > y() const
Definition types_dual.h:66
ccl_device_inline_method dual< float > z() const
Definition types_dual.h:70
ccl_device_inline_method dual(const float3 val, const float3 dx, const float3 dy)
Definition types_dual.h:58
ccl_device_inline_method dual< float > w() const
Definition types_dual.h:98
ccl_device_inline_method dual< float > x() const
Definition types_dual.h:86
ccl_device_inline_method dual(const float4 val)
Definition types_dual.h:81
ccl_device_inline_method dual< float > y() const
Definition types_dual.h:90
dual()=default
ccl_device_inline_method dual< float > z() const
Definition types_dual.h:94
ccl_device_inline_method dual(const float4 val, const float4 dx, const float4 dy)
Definition types_dual.h:82
ccl_device_inline_method dual(const float val, const float dx, const float dy)
Definition types_dual.h:26
dual()=default
ccl_device_inline_method dual(const float val)
Definition types_dual.h:25
dual()=default
ccl_device_inline_method dual(const T val, const T dx, const T dy)
Definition types_dual.h:17
ccl_device_inline_method dual(const T val)
Definition types_dual.h:16
T val
Definition types_dual.h:14
float x
float y
float z
Definition sky_math.h:136
float y
Definition sky_math.h:136
float x
Definition sky_math.h:136
float y
Definition sky_math.h:225
float z
Definition sky_math.h:225
float x
Definition sky_math.h:225
float w
Definition sky_math.h:225
ccl_static_constexpr bool value
Definition types_dual.h:115
ccl_static_constexpr bool value
Definition types_dual.h:112
ccl_static_constexpr bool is_dual_v
Definition types_dual.h:118
dual< float4 > dual4
Definition types_dual.h:107
ccl_device_inline void print_dual2(const ccl_private char *label, const dual2 a)
Definition types_dual.h:196
ccl_device_inline dual4 make_float4(const dual1 a, const dual1 b, const dual1 c, const dual1 d)
Definition types_dual.h:165
ccl_device_inline void print_dual1(const ccl_private char *label, const dual1 a)
Definition types_dual.h:182
ccl_device_inline dual2 make_float2(const dual3 a)
Definition types_dual.h:143
typename dual_scalar_type< T >::type dual_scalar_t
Definition types_dual.h:141
ccl_device_inline dual3 make_float3(const dual1 a, const dual1 b, const dual1 c)
Definition types_dual.h:153
ccl_device_inline void print_dual3(const ccl_private char *label, const dual3 a)
Definition types_dual.h:213
dual< float3 > dual3
Definition types_dual.h:106
typename dual_base_type< T >::type dual_base_t
Definition types_dual.h:128
dual< float2 > dual2
Definition types_dual.h:105
ccl_device_inline dual4 make_homogeneous(const dual3 a)
Definition types_dual.h:177
dual< float > dual1
Definition types_dual.h:104