Blender V5.3
eevee_ltc_lut_lib.bsl.hh
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2017-2026 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
5#pragma once
6
11
12namespace eevee {
13
14namespace detail {
15
19float2 get_isotropic_coords(float cos_theta, float roughness)
20{
21 return float2(roughness, sqrt(saturate(1.0f - cos_theta)));
22}
23
28{
29 return float3x3(float3(v.x, 0, v.y), float3(0, 1, 0), float3(v.z, 0, v.w));
30}
31
32} // namespace detail
33
39struct LTCData {
40 /* Inverse LTC matrix. */
42 /* LTC lobe attenuation is scaled by 1 minus value. */
44 /* Type of form factor computation applied during LTC evaluation . */
46
51 {
52 LTCData ltc_data;
53
54 /* Unpack matrix values from 9 x fp16. */
55 ltc_data.Minv[0].xy = unpackHalf2x16(cl.ltc_data_packed[0]);
56 ltc_data.Minv[1].xy = unpackHalf2x16(cl.ltc_data_packed[1]);
57 ltc_data.Minv[2].xy = unpackHalf2x16(cl.ltc_data_packed[2]);
60 ltc_data.Minv[0].z = v3.x;
61 ltc_data.Minv[1].z = v3.y;
62 ltc_data.Minv[2].z = v4.y;
63
64 /* Unpack associated values from 16 lsb of [4]. */
66 ltc_data.attenuation_factor = pack.x;
67 ltc_data.form_factor_type = LTCFormFactorType(pack.y);
68
69 return ltc_data;
70 }
71
75 void pack_to(ClosureLight &cl) const
76 {
77 /* Pack associated values in 16 lsb . */
78 uint values_lsb = packUnorm4x8(
79 float4(attenuation_factor, float(form_factor_type), 0.0f, 0.0f));
80
81 /* Pack matrix values as 9 x fp16, plus associated values in 16 lsb of [4]. */
82 cl.ltc_data_packed[0] = packHalf2x16(Minv[0].xy);
83 cl.ltc_data_packed[1] = packHalf2x16(Minv[1].xy);
84 cl.ltc_data_packed[2] = packHalf2x16(Minv[2].xy);
86 cl.ltc_data_packed[4] = packHalf2x16(float2(0.0f, Minv[2].z)) | values_lsb;
87 }
88
93 const UtilityTexture &util_tx, float3 N, float3 V, float cos_theta, float roughness)
94 {
95 /* Sample 4 components from isotropic LTC LUT. */
96 const float2 coords = detail::get_isotropic_coords(cos_theta, roughness);
97 float4 lut_pack = util_tx.sample_lut(coords, UTIL_LTC_MAT_LAYER);
98
99 /* Expand components to full inverse LTC matrix. */
101
102 /* Rotate into orthonormal basis around N. */
104 Minv = Minv * transpose(T);
105
106 LTCData ltc_data;
107 ltc_data.Minv = Minv;
109 /* LTC attenuation linearly disappears from roughness 0.15 to 0.375. */
110 ltc_data.attenuation_factor = saturate((roughness - 0.15f) * 2.5f);
111 return ltc_data;
112 }
113
118 {
119 /* Rotate into orthonormal basis around N. LTC matrix is simply the identity matrix. */
122
123 LTCData ltc_data;
124 ltc_data.Minv = Minv;
125 ltc_data.attenuation_factor = 1.0f;
127 return ltc_data;
128 }
129
133 static void pack_ltc_lut(ClosureLight &cl,
134 const UtilityTexture &util_tx,
135 float3 N,
136 float3 V,
137 float cos_theta,
138 float roughness)
139 {
140 LTCData ltc_data = LTCData::sample_ltc_lut(util_tx, N, V, cos_theta, roughness);
141 ltc_data.pack_to(cl);
142 }
143
148 {
149 LTCData ltc_data = LTCData::identity(N, V);
150 ltc_data.pack_to(cl);
151 }
152};
153
154} // namespace eevee
ccl_device_inline float cos_theta(const float3 w)
SIMD_FORCE_INLINE const btScalar & z() const
Return the z value.
Definition btQuadWord.h:117
#define UTIL_LTC_MAT_LAYER
float4 unpackUnorm4x8(uint) RET
uint packUnorm4x8(float4) RET
#define sqrt
float2 unpackHalf2x16(uint) RET
MatBase< R, C > transpose(MatBase< C, R >) RET
uint packHalf2x16(float2) RET
float3x3 from_incident_vector(float3 up, float3 forward)
#define N
#define T
float3x3 unpack_isotropic_matrix(float4 v)
float2 get_isotropic_coords(float cos_theta, float roughness)
#define saturate(a)
Definition smaa.cc:319
float4 sample_lut(float2 uv, float layer) const
LTCFormFactorType form_factor_type
static LTCData identity(float3 N, float3 V)
static LTCData sample_ltc_lut(const UtilityTexture &util_tx, float3 N, float3 V, float cos_theta, float roughness)
static LTCData unpack_from(ClosureLight cl)
void pack_to(ClosureLight &cl) const
static void pack_ltc_lut(ClosureLight &cl, const UtilityTexture &util_tx, float3 N, float3 V, float cos_theta, float roughness)
static void pack_identity(ClosureLight &cl, float3 N, float3 V)
float x
float y
CCL_NAMESPACE_BEGIN struct Window V