RenderDevice::maxAnisotropy

Author: jdolan

Sources/ObjectivelyGPU/RenderDevice.c

@@ -262,10 +262,10 @@ static Sampler *createSampler(RenderDevice *self, const SDL_GPUSamplerCreateInfo
 }
 
 /**
- * @fn Sampler *RenderDevice::createSamplerLinearRepeat(RenderDevice *self, float maxAnisotropy)
+ * @fn Sampler *RenderDevice::createSamplerLinearRepeat(RenderDevice *self)
  * @memberof RenderDevice
  */
-static Sampler *createSamplerLinearRepeat(RenderDevice *self, float maxAnisotropy) {
+static Sampler *createSamplerLinearRepeat(RenderDevice *self) {
 
   return $(self, createSampler, &(const SDL_GPUSamplerCreateInfo) {
     .min_filter = SDL_GPU_FILTER_LINEAR,
@@ -274,8 +274,8 @@ static Sampler *createSamplerLinearRepeat(RenderDevice *self, float maxAnisotrop
     .address_mode_u = SDL_GPU_SAMPLERADDRESSMODE_REPEAT,
     .address_mode_v = SDL_GPU_SAMPLERADDRESSMODE_REPEAT,
     .address_mode_w = SDL_GPU_SAMPLERADDRESSMODE_REPEAT,
-    .enable_anisotropy = maxAnisotropy > 0.f,
-    .max_anisotropy = maxAnisotropy,
+    .enable_anisotropy = self->maxAnisotropy > 0.f,
+    .max_anisotropy = self->maxAnisotropy,
   });
 }
 
@@ -292,6 +292,8 @@ static Sampler *createSamplerLinearClamp(RenderDevice *self) {
     .address_mode_u = SDL_GPU_SAMPLERADDRESSMODE_CLAMP_TO_EDGE,
     .address_mode_v = SDL_GPU_SAMPLERADDRESSMODE_CLAMP_TO_EDGE,
     .address_mode_w = SDL_GPU_SAMPLERADDRESSMODE_CLAMP_TO_EDGE,
+    .enable_anisotropy = self->maxAnisotropy > 0.f,
+    .max_anisotropy = self->maxAnisotropy,
   });
 }
 
@@ -424,6 +426,8 @@ static RenderDevice *init(RenderDevice *self) {
 
     self->shaderFormats = SDL_GetGPUShaderFormats(self->device);
     GPU_Assert(self->shaderFormats, "SDL_GetGPUShaderFormats");
+
+    self->maxAnisotropy = 0.f;
   }
 
   return self;

Sources/ObjectivelyGPU/RenderDevice.h

@@ -85,6 +85,14 @@ struct RenderDevice {
    */
   SDL_GPUShaderFormat shaderFormats;
 
+  /**
+   * @brief The anisotropic filtering level applied by `createSamplerLinearRepeat`
+   * and `createSamplerLinearClamp`. Defaults to `0` (anisotropic filtering
+   * disabled). Assign directly; only affects Samplers created afterward, since
+   * SDL_gpu Samplers are immutable once created.
+   */
+  float maxAnisotropy;
+
   /**
    * @brief The present-target Framebuffer driven by `beginFrame`/`endFrame`, or `NULL`.
    * @details Set via `setFramebuffer` (retained). `beginFrame` resizes it to the
@@ -241,25 +249,25 @@ struct RenderDeviceInterface {
   Sampler *(*createSampler)(RenderDevice *self, const SDL_GPUSamplerCreateInfo *info);
 
   /**
-   * @fn Sampler *RenderDevice::createSamplerLinearRepeat(RenderDevice *self, float maxAnisotropy)
+   * @fn Sampler *RenderDevice::createSamplerLinearRepeat(RenderDevice *self)
    * @brief Creates a trilinear, wrapping Sampler -- the common preset for tiled surface textures.
    * @details Linear min/mag filter, linear mipmap mode, `REPEAT` addressing on all
-   *   three axes. Anisotropic filtering is enabled when @p maxAnisotropy is greater
-   *   than zero.
+   *   three axes. Anisotropic filtering is enabled when `self->maxAnisotropy` is
+   *   greater than `0`.
    * @param self The RenderDevice.
-   * @param maxAnisotropy The maximum anisotropy level, or `0` to disable anisotropic filtering.
    * @return A new, retained Sampler. GPU_Asserts on failure. Free with `release`.
    * @memberof RenderDevice
    */
-  Sampler *(*createSamplerLinearRepeat)(RenderDevice *self, float maxAnisotropy);
+  Sampler *(*createSamplerLinearRepeat)(RenderDevice *self);
 
   /**
    * @fn Sampler *RenderDevice::createSamplerLinearClamp(RenderDevice *self)
    * @brief Creates a trilinear, edge-clamped Sampler -- the common preset for
    *   continuously-sampled volumes and non-tiling images (ambient/voxel volumes,
    *   cubemaps, post-process targets, UI images).
    * @details Linear min/mag filter, linear mipmap mode, `CLAMP_TO_EDGE` addressing
-   *   on all three axes, no anisotropic filtering.
+   *   on all three axes. Anisotropic filtering is enabled when `self->maxAnisotropy`
+   *   is greater than `0`.
    * @param self The RenderDevice.
    * @return A new, retained Sampler. GPU_Asserts on failure. Free with `release`.
    * @memberof RenderDevice