Add the wide_lines renderer feature

This feature provides availability of the lineWidth property in
Vulkan pipeline configuration.

include/thallium/core/pipeline.h

@@ -55,6 +55,7 @@ typedef struct TL_PipelineRasterizerDescriptor_t {
     float depth_bias_clamp;
 
     /// @brief The width of all line primitives.
+    /// This value is **silently ignored** and defaults to 1.0 if the `wide_lines` feature is disabled on the relevant renderer.
     float line_width;
 } TL_PipelineRasterizerDescriptor_t;
 

include/thallium/core/renderer.h

@@ -31,6 +31,9 @@
 typedef struct TL_RendererFeatures_t {
     /// @brief The renderer can present images to a swapchain.
     bool presentation;
+
+    /// @brief The renderer can draw line primitives with a variable line width.
+    bool wide_lines;
 } TL_RendererFeatures_t;
 
 /**

src/lib/vulkan/vk_device.c

@@ -67,7 +67,8 @@ static carray_t __ValidateExtensions(const VkPhysicalDevice physical_device, con
 static void __EnumerateRequiredExtensions(const TL_RendererFeatures_t requirements, uint32_t *const out_extension_count,
     const char **out_extension_names);
 
-static void __UpdateRendererFeaturesWithSupported(TL_RendererFeatures_t *const features, carray_t extensions, const TL_Debugger_t *const debugger);
+static void __UpdateRendererFeaturesWithSupported(TL_RendererFeatures_t *const features, carray_t extensions,
+    const VkPhysicalDeviceFeatures *device_feats, const TL_Debugger_t *const debugger);
 
 static VkPhysicalDeviceFeatures __ValidateDeviceFeatures(const VkPhysicalDevice physical_device, VkPhysicalDeviceFeatures features,
     bool *const out_missing_flag, const TL_Debugger_t *const debugger);
@@ -87,7 +88,7 @@ VkDevice TLVK_LogicalDeviceCreate(const VkPhysicalDevice physical_device, const
         return VK_NULL_HANDLE;
     }
 
-    __UpdateRendererFeaturesWithSupported(out_rfeatures, extensions, debugger);
+    __UpdateRendererFeaturesWithSupported(out_rfeatures, extensions, &features, debugger);
 
     VkDeviceCreateInfo device_create_info;
     device_create_info.sType = VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO;
@@ -439,7 +440,9 @@ static void __EnumerateRequiredExtensions(const TL_RendererFeatures_t requiremen
     *out_extension_count = count_ret;
 }
 
-static void __UpdateRendererFeaturesWithSupported(TL_RendererFeatures_t *const features, carray_t extensions, const TL_Debugger_t *const debugger) {
+static void __UpdateRendererFeaturesWithSupported(TL_RendererFeatures_t *const features, carray_t extensions,
+    const VkPhysicalDeviceFeatures *device_feats, const TL_Debugger_t *const debugger)
+{
     // presentation feature availability
     {
         bool pa = false;
@@ -459,6 +462,13 @@ static void __UpdateRendererFeaturesWithSupported(TL_RendererFeatures_t *const f
                 "When creating Vulkan device: RENDERER FEATURE UNAVAILABLE (missing device extensions) - 'presentation' was disabled!");
         }
     }
+
+    // wide_lines feature availability
+    {
+        if (!device_feats->wideLines) {
+            features->wide_lines = false;
+        }
+    }
 }
 
 static VkPhysicalDeviceFeatures __ValidateDeviceFeatures(const VkPhysicalDevice physical_device, VkPhysicalDeviceFeatures features,
@@ -540,6 +550,9 @@ static VkPhysicalDeviceFeatures __ValidateDeviceFeatures(const VkPhysicalDevice
 static VkPhysicalDeviceFeatures __EnumerateRequiredDeviceFeatures(const TL_RendererFeatures_t requirements) {
     VkPhysicalDeviceFeatures feat = { 0 };
 
+    if (requirements.wide_lines)
+        feat.wideLines = true;
+
     return feat;
 }
 

src/lib/vulkan/vk_pipeline_system.c

@@ -31,7 +31,7 @@ typedef struct __GraphicsPipelineConfig {
 } __GraphicsPipelineConfig;
 
 
-static __GraphicsPipelineConfig __ConfigureGraphicsPipeline(const TL_PipelineDescriptor_t descriptor);
+static __GraphicsPipelineConfig __ConfigureGraphicsPipeline(const TL_PipelineDescriptor_t descriptor, const TL_RendererFeatures_t *features);
 
 static VkPipeline __CreateGraphicsPipeline(const TLVK_FuncSet_t *devfs, const VkDevice device, const __GraphicsPipelineConfig config);
 
@@ -45,6 +45,7 @@ TLVK_PipelineSystem_t *TLVK_PipelineSystemCreate(const TLVK_RendererSystem_t *co
 
     const TL_Debugger_t *debugger = renderer_system->renderer->debugger;
     const VkDevice device = renderer_system->vk_logical_device;
+    const TL_RendererFeatures_t *rfeatures = &(renderer_system->renderer->features);
 
     TLVK_PipelineSystem_t *pipeline_system = malloc(sizeof(TLVK_PipelineSystem_t));
     if (!pipeline_system) {
@@ -59,7 +60,7 @@ TLVK_PipelineSystem_t *TLVK_PipelineSystemCreate(const TLVK_RendererSystem_t *co
     VkPipeline pso;
     switch (descriptor.type) {
         case TL_PIPELINE_TYPE_GRAPHICS:
-            pso = __CreateGraphicsPipeline(devfs, device, __ConfigureGraphicsPipeline(descriptor));
+            pso = __CreateGraphicsPipeline(devfs, device, __ConfigureGraphicsPipeline(descriptor, rfeatures));
             break;
         default:
             TL_Error(debugger, "When creating Vulkan pipeline system: pipeline descriptor specified invalid pipeline type %d", descriptor.type);
@@ -92,7 +93,7 @@ void TLVK_PipelineSystemDestroy(TLVK_PipelineSystem_t *const pipeline_system) {
 }
 
 
-static __GraphicsPipelineConfig __ConfigureGraphicsPipeline(const TL_PipelineDescriptor_t descriptor) {
+static __GraphicsPipelineConfig __ConfigureGraphicsPipeline(const TL_PipelineDescriptor_t descriptor, const TL_RendererFeatures_t *features) {
     __GraphicsPipelineConfig config = { 0 };
 
     // TODO: shader modules
@@ -146,7 +147,8 @@ static __GraphicsPipelineConfig __ConfigureGraphicsPipeline(const TL_PipelineDes
     config.rasterizer_info.depthBiasConstantFactor = descriptor.rasterizer.depth_bias_constant_factor;
     config.rasterizer_info.depthBiasClamp = descriptor.rasterizer.depth_bias_clamp;
     config.rasterizer_info.depthBiasSlopeFactor = descriptor.rasterizer.depth_bias_slope_factor;
-    config.rasterizer_info.lineWidth = descriptor.rasterizer.line_width;
+    config.rasterizer_info.lineWidth =
+        (features->wide_lines) ? descriptor.rasterizer.line_width : 1.0f;
 
     // TODO: when render passes are implemented, get the sample count from the render pass and use that
     config.multisample_info.sType = VK_STRUCTURE_TYPE_PIPELINE_MULTISAMPLE_STATE_CREATE_INFO;