IES updates

cmake/common.cmake

@@ -1206,13 +1206,14 @@ struct DeviceConfigCaps
 		-enable-16bit-types 
 		-Zpr 
 		-spirv 
+		-Wno-local-type-template-args
 		-fspv-target-env=vulkan1.3 
 		-Wshadow 
 		-Wconversion 
 		-Wno-local-type-template-args 
 		$<$<CONFIG:Debug>:-O0> 
 		$<$<CONFIG:Release>:-O3> 
-		$<$<CONFIG:RelWithDebInfo>:-O3> 
+		$<$<CONFIG:RelWithDebInfo>:-O3>
 	)
 
 	if(NSC_DEBUG_EDIF_FILE_BIT)
@@ -1599,7 +1600,6 @@ namespace @IMPL_NAMESPACE@ {
 					NBL_SPIRV_BINARY_DIR "${IMPL_BINARY_DIR}"
 					NBL_SPIRV_ACCESS_KEY "${FINAL_KEY_REL_PATH}"
 				)
-
 				set_property(TARGET ${IMPL_TARGET} APPEND PROPERTY NBL_SPIRV_OUTPUTS "${TARGET_OUTPUT}")
 				return()
 			endif()

include/nbl/asset/asset.h

@@ -68,6 +68,6 @@
 #include "nbl/asset/metadata/CMTLMetadata.h"
 #include "nbl/asset/metadata/CPLYMetadata.h"
 #include "nbl/asset/metadata/CSTLMetadata.h"
-//#include "nbl/asset/metadata/CIESProfileMetadata.h"
+#include "nbl/asset/metadata/CIESProfileMetadata.h"
 
 #endif

include/nbl/asset/utils/CGeometryCreator.h

@@ -115,9 +115,15 @@ class NBL_API2 CGeometryCreator final : public core::IReferenceCounted
 			\param subdivision Specifies subdivision level of the icosphere.
 			\param smooth Specifies whether vertecies should be built for smooth or flat shading.
 		*/
-
 		core::smart_refctd_ptr<ICPUPolygonGeometry> createIcoSphere(float radius=1.f, uint32_t subdivision=1, bool smooth=false) const;
 
+		//! Create a grid geometry
+		/**
+			No vertex buffer, only index in triangle strip topology without reset, "snake" with degenerates
+			\param "resolution" Specifies resolution of grid
+		*/
+		core::smart_refctd_ptr<ICPUPolygonGeometry> createGrid(const hlsl::uint16_t2 resolution = { 128u, 128u }) const;
+
 	private:
 		SCreationParams m_params;
 };

include/nbl/builtin/glsl/ies/functions.glsl

@@ -6,25 +6,33 @@
 
 #include <nbl/builtin/glsl/math/constants.glsl>
 
-// TODO: implement proper mirroing
-// MIRROR_180_BITS = 0b001, Last Angle is 180, so map V slightly differently
-// MIRROR_90_BITS = 0b010, Last Angle is 90, so map both U and V slightly differently
-// ISOTROPIC_BITS = 0b011, texture to sample is Nx1, pretend v=middle always  
-// FULL_THETA_BIT = 0b100, handle extended domain and rotate by 45 degrees for anisotropic
-
-vec2 nbl_glsl_IES_convert_dir_to_uv(vec3 dir) {
-    float sum = dot(vec3(1.0f), abs(dir));        
+// TODO: when rewriting to HLSL this is not IES namespace or folder, this should be octahedral mapping sitting somewhere where the spherical/polar sits
+// NOTE: I changed it to return NDC [-1,1]^2 instead of UV coords [0,1]^2
+vec2 nbl_glsl_TODOnamespace_octahedral_mapping(vec3 dir)
+{
+    float sum = dot(vec3(1.0f), abs(dir));
     vec3 s = dir / sum;    
 
-    if(s.z < 0.0f) {
-        s.xy = sign(s.xy) * (1.0f - abs(s.yx));
+    if(s.z < 0.0f)
+    {
+        const uvec2 flipSignMask = floatBitsToUint(s.xy)&0x80000000u;
+        s.xy = uintBitsToFloat(floatBitsToUint(1.0f - abs(s.yx))^flipSignMask);
     }
 
-    return s.xy * 0.5f + 0.5f;
+    return s.xy;
 }
 
-// vec2 nbl_glsl_IES_convert_dir_to_uv(vec3 dir) {
-// 	return vec2((atan(dir.x, dir.y) + nbl_glsl_PI) / (2.0*nbl_glsl_PI), acos(dir.z) / nbl_glsl_PI);
-// }
+// TODO: implement proper mirroing
+// MIRROR_180_BITS = 0b001, Last Angle is 180, so map V with MIRROR and corner sampling off
+// MIRROR_90_BITS = 0b010, Last Angle is 90, so map both U and V with MIRROR and corner sampling off
+// ISOTROPIC_BITS = 0b011, texture to sample is Nx1, pretend v=middle always , and make u REPEAT or CLAMP_TO_BORDER
+// FULL_THETA_BIT = 0b100, handle truncated domain and rotate by 45 degrees for anisotropic
+// (certain combos wont work like 90 degree 2 symmetry domain & half theta), it really needs to be an 8 case label thing explicitly enumerated
+vec2 nbl_glsl_IES_convert_dir_to_uv(vec3 dir, vec2 halfMinusHalfPixel)
+{
+    // halfMinusHalfPixel = 0.5-0.5/texSize
+    // believe it or not, cornerSampled(NDC*0.5+0.5) = NDC*0.5*(1-1/texSize)+0.5
+    return nbl_glsl_TODOnamespace_octahedral_mapping(dir)*halfMinusHalfPixel+0.5;
+}
 
 #endif

include/nbl/builtin/glsl/material_compiler/common.glsl

@@ -215,6 +215,7 @@ bool nbl_glsl_MC_op_isDelta(in uint op)
 #ifdef TEX_PREFETCH_STREAM
 #include <nbl/builtin/glsl/bump_mapping/utils.glsl>
 #endif
+// TODO: once rewritten to HLSL, shall use new API
 #include <nbl/builtin/glsl/ies/functions.glsl>
 
 // OptiX likes this one better
@@ -601,7 +602,8 @@ vec3 nbl_glsl_MC_oriented_material_t_getEmissive(in nbl_glsl_MC_oriented_materia
 		if ((floatBitsToInt(emitter.orientation[0])&1u) != 1u) {
 			right *= -1;
 		}
-		return emissive * nbl_glsl_vTextureGrad(emitter.emissionProfile, nbl_glsl_IES_convert_dir_to_uv(mat3(right, up, view)*dir), mat2(0.0)).r;
+		vec2 halfMinusHalfPixel = vec2(0.5)-vec2(0.5)/vec2(nbl_glsl_unpackSize(emitter.emissionProfile));
+		return emissive * nbl_glsl_vTextureGrad(emitter.emissionProfile, nbl_glsl_IES_convert_dir_to_uv(mat3(right, up, view)*dir,halfMinusHalfPixel), mat2(0.0)).r;
 	}
 #endif
 	return emissive;
@@ -1498,4 +1500,4 @@ nbl_glsl_MC_quot_pdf_aov_t nbl_glsl_MC_runGenerateAndRemainderStream(
 }
 #endif //GEN_CHOICE_STREAM
 
-#endif
+#endif

include/nbl/builtin/hlsl/array_accessors.hlsl

@@ -24,7 +24,8 @@ struct array_set
         arr[index] = val;
     }
 };
+
 }
 }
 
-#endif
+#endif

include/nbl/builtin/hlsl/cpp_compat/basic.h

@@ -84,6 +84,8 @@ struct add_pointer
 
 #endif
 
+
+
 namespace nbl
 {
 namespace hlsl

include/nbl/builtin/hlsl/ies/profile.hlsl

@@ -0,0 +1,105 @@
+// Copyright (C) 2018-2025 - DevSH Graphics Programming Sp. z O.O.
+// This file is part of the "Nabla Engine".
+// For conditions of distribution and use, see copyright notice in nabla.h
+
+#ifndef _NBL_BUILTIN_HLSL_IES_PROFILE_INCLUDED_
+#define _NBL_BUILTIN_HLSL_IES_PROFILE_INCLUDED_
+
+#include "nbl/builtin/hlsl/cpp_compat.hlsl"
+#include "nbl/builtin/hlsl/cpp_compat/basic.h"
+
+namespace nbl 
+{
+namespace hlsl 
+{
+namespace ies 
+{
+
+struct ProfileProperties
+{
+    NBL_CONSTEXPR_STATIC_INLINE float32_t MaxVAngleDegrees = 180.f;
+    NBL_CONSTEXPR_STATIC_INLINE float32_t MaxHAngleDegrees = 360.f;
+
+	// TODO: could change to uint8_t once we get implemented
+    // https://github.com/microsoft/hlsl-specs/pull/538
+	using packed_flags_t = uint32_t;
+
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t VersionBits  = 2u;
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t TypeBits     = 2u;
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t SymmetryBits = 3u;
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t VersionMask  = (packed_flags_t(1u) << VersionBits) - packed_flags_t(1u);
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t TypeMask     = (packed_flags_t(1u) << TypeBits) - packed_flags_t(1u);
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t SymmetryMask = (packed_flags_t(1u) << SymmetryBits) - packed_flags_t(1u);
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t TypeShift    = VersionBits;
+    NBL_CONSTEXPR_STATIC_INLINE packed_flags_t SymmetryShift = VersionBits + TypeBits;
+
+    enum Version : packed_flags_t
+    {
+        V_1995,
+        V_2002,
+        V_SIZE
+    };
+
+    enum PhotometricType : packed_flags_t
+    {
+        TYPE_NONE,
+        TYPE_C,
+        TYPE_B,
+        TYPE_A
+    };
+
+    enum LuminairePlanesSymmetry : packed_flags_t
+    {
+        ISOTROPIC,                  //! Only one horizontal angle present and a luminaire is assumed to be laterally axial symmetric
+        QUAD_SYMETRIC,              //! The luminaire is assumed to be symmetric in each quadrant
+        HALF_SYMETRIC,              //! The luminaire is assumed to be symmetric about the 0 to 180 degree plane
+        OTHER_HALF_SYMMETRIC,       //! HALF_SYMETRIC case for legacy V_1995 version where horizontal angles are in range [90, 270], in that case the parser patches horizontal angles to be HALF_SYMETRIC
+        NO_LATERAL_SYMMET           //! The luminaire is assumed to exhibit no lateral symmet
+    };
+
+    Version getVersion() NBL_CONST_MEMBER_FUNC
+    {
+        return (Version)(packed & VersionMask);
+    }
+
+    PhotometricType getType() NBL_CONST_MEMBER_FUNC
+    {
+        return (PhotometricType)((packed >> TypeShift) & TypeMask);
+    }
+
+    LuminairePlanesSymmetry getSymmetry() NBL_CONST_MEMBER_FUNC
+    {
+        return (LuminairePlanesSymmetry)((packed >> SymmetryShift) & SymmetryMask);
+    }
+
+    void setVersion(Version v)
+    {
+        packed_flags_t vBits = (packed_flags_t)(v) & VersionMask;
+        packed = (packed & ~VersionMask) | vBits;
+    }
+
+    void setType(PhotometricType t)
+    {
+        packed_flags_t tBits = ((packed_flags_t)(t) & TypeMask) << TypeShift;
+        packed = (packed & ~(TypeMask << TypeShift)) | tBits;
+    }
+
+    void setSymmetry(LuminairePlanesSymmetry s)
+    {
+        packed_flags_t sBits = ((packed_flags_t)(s) & SymmetryMask) << SymmetryShift;
+        packed = (packed & ~(SymmetryMask << SymmetryShift)) | sBits;
+    }
+
+	float32_t maxCandelaValue;        //! Max candela sample value
+	float32_t totalEmissionIntegral;  //! Total emitted intensity (integral over full angular domain)
+	float32_t fullDomainAvgEmission;  //! Mean intensity over full angular domain (including I == 0)
+	float32_t avgEmmision;            //! Mean intensity over emitting solid angle (I > 0)
+	packed_flags_t packed;			  //! Packed version, type and symmetry flags
+};
+
+}
+
+}
+}
+
+#endif // _NBL_BUILTIN_HLSL_IES_PROFILE_INCLUDED_