fix(examples): resolve --output against the working directory in three render paths (#223)

* fix(examples): resolve --output against the working directory in three render paths

damped-track-aim, gn-sdf-remesh and turntable passed --output straight to
scene.render.filepath. Blender resolves a relative filepath against the
blend-file directory, which for a --background run with no .blend is the
drive root, so the documented `-- --output aim.png` wrote to C:\ and the
script exited with its "no file" code (10, 4, 4). Every other example
already applies os.path.abspath.

Closes #222

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>

* fix(examples): regenerate the three affected gallery pages (they inline the source)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>

---------

Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: TMHSDigital

docs/gallery/damped-track-aim/index.html

@@ -672,6 +672,9 @@ <h2>Source</h2>
     scene.view_settings.view_transform = <span class="s">&quot;Filmic&quot;</span>
     scene.view_settings.look = <span class="s">&quot;Medium High Contrast&quot;</span>
     scene.render.image_settings.file_format = <span class="s">&quot;PNG&quot;</span>
+    <span class="c"># Blender resolves a relative filepath against the blend-file directory, which</span>
+    <span class="c"># for a --background run with no .blend is the drive root, not the cwd.</span>
+    path = os.path.abspath(path)
     scene.render.filepath = path
     bpy.ops.render.render(write_still=<span class="k">True</span>)
     <span class="k">return</span> os.path.exists(path) <span class="k">and</span> os.path.getsize(path) &gt; <span class="n">0</span>

docs/gallery/gn-sdf-remesh/index.html

@@ -402,6 +402,9 @@ <h2>Source</h2>
         <span class="k">try</span>: sc.eevee.taa_render_samples = <span class="n">64</span>
         <span class="k">except</span> Exception: <span class="k">pass</span>
     sc.render.resolution_x = <span class="n">1280</span>; sc.render.resolution_y = <span class="n">720</span>
+    <span class="c"># Blender resolves a relative filepath against the blend-file directory, which</span>
+    <span class="c"># for a --background run with no .blend is the drive root, not the cwd.</span>
+    path = os.path.abspath(path)
     sc.render.image_settings.file_format = <span class="s">&#x27;PNG&#x27;</span>; sc.render.filepath = path
     <span class="c"># AgX would wash the crimson toward brick (docs/VISUAL-STYLE.md)</span>
     sc.view_settings.view_transform = <span class="s">&#x27;Standard&#x27;</span>

docs/gallery/turntable/index.html

@@ -421,6 +421,9 @@ <h2>Source</h2>
     <span class="c"># arbitrary turntable frame can land face-away and read as broken geometry.</span>
     sc.frame_set(<span class="n">4</span>)
     sc.render.resolution_x = <span class="n">1280</span>; sc.render.resolution_y = <span class="n">720</span>
+    <span class="c"># Blender resolves a relative filepath against the blend-file directory, which</span>
+    <span class="c"># for a --background run with no .blend is the drive root, not the cwd.</span>
+    path = os.path.abspath(path)
     sc.render.image_settings.file_format = <span class="s">&#x27;PNG&#x27;</span>; sc.render.filepath = path
     <span class="c"># AgX would wash the copper toward beige (docs/VISUAL-STYLE.md)</span>
     sc.view_settings.view_transform = <span class="s">&#x27;Standard&#x27;</span>

examples/damped-track-aim/damped_track_aim.py

@@ -367,6 +367,9 @@ def light(name, loc, energy, size, col):
     scene.view_settings.view_transform = "Filmic"
     scene.view_settings.look = "Medium High Contrast"
     scene.render.image_settings.file_format = "PNG"
+    # Blender resolves a relative filepath against the blend-file directory, which
+    # for a --background run with no .blend is the drive root, not the cwd.
+    path = os.path.abspath(path)
     scene.render.filepath = path
     bpy.ops.render.render(write_still=True)
     return os.path.exists(path) and os.path.getsize(path) > 0

examples/gn-sdf-remesh/gn_sdf_remesh.py

@@ -98,6 +98,9 @@ def render_still(obj, path, engine):
         try: sc.eevee.taa_render_samples = 64
         except Exception: pass
     sc.render.resolution_x = 1280; sc.render.resolution_y = 720
+    # Blender resolves a relative filepath against the blend-file directory, which
+    # for a --background run with no .blend is the drive root, not the cwd.
+    path = os.path.abspath(path)
     sc.render.image_settings.file_format = 'PNG'; sc.render.filepath = path
     # AgX would wash the crimson toward brick (docs/VISUAL-STYLE.md)
     sc.view_settings.view_transform = 'Standard'

examples/turntable/turntable.py

@@ -117,6 +117,9 @@ def render_still(obj, path, engine):
     # arbitrary turntable frame can land face-away and read as broken geometry.
     sc.frame_set(4)
     sc.render.resolution_x = 1280; sc.render.resolution_y = 720
+    # Blender resolves a relative filepath against the blend-file directory, which
+    # for a --background run with no .blend is the drive root, not the cwd.
+    path = os.path.abspath(path)
     sc.render.image_settings.file_format = 'PNG'; sc.render.filepath = path
     # AgX would wash the copper toward beige (docs/VISUAL-STYLE.md)
     sc.view_settings.view_transform = 'Standard'