el4cteo/blender-skills

blender-rendering

Render with Blender 5.3 Cycles/EEVEE/Workbench - quality presets, GPU setup, adaptive sampling, denoising, light paths, color management (AgX, Khronos PBR Neutral, ACES), PNG/EXR/MP4 output, passes, the 5.0 compositor API, CLI and multi-camera batch rendering.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/el4cteo/blender-skills --skill blender-rendering

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Rendering

The execution model is in blender-core. Scene lighting and cameras are in blender-lighting-lookdev.

One call

scripts/render_batch.py -- --engine CYCLES --preset final --res 1920 1080 --out //render/hero_#### --frames 1
scripts/render_batch.py -- --preset preview --frames 1-120 --format MP4 --out //render/turntable
scripts/render_batch.py -- --cameras CamA CamB CamC --format EXR_MULTI --out //render/shots/

Presets: preview (Cycles 64 spp, threshold 0.05, 50% res; EEVEE 16), final (512 spp, 0.01; EEVEE 128 + raytracing), product (1024 spp, transparent background). GPU is picked automatically (OptiX > CUDA > HIP > Metal > oneAPI), and the denoiser matches (OptiX or OpenImageDenoise).

Engine choice

EngineUseNotes
Cyclesfinal quality, product, archviz, glass/SSS/caustics, bakingpath tracer; set the GPU; adaptive sampling + denoise
EEVEE (5.x, ex-"Next")fast look-dev, stylized, motion graphics, previewsray-traced reflections/GI (use_raytracing), virtual shadow maps; needs a GPU even headless
Workbenchplayblasts, clay/matcap reviews, QA sheetsinstant, no lighting accuracy

Engine ids: CYCLES, BLENDER_EEVEE, BLENDER_WORKBENCH.

Cycles quality levers (ordered by impact)

  1. Adaptive sampling (adaptive_threshold 0.01 final / 0.05 preview) + denoise (OIDN with albedo+normal passes, denoising_input_passes="RGB_ALBEDO_NORMAL"). Raising samples alone is the least efficient fix.
  2. Light paths: interiors need diffuse bounces ≥ 4. Product shots: total 12, glossy 4, transmission 8–12 for glass. Clamp indirect 5–10 kills fireflies at a small energy cost.
  3. Light tree (use_light_tree, on) for many lights. Path guiding (CPU only) for difficult indirect light.
  4. Fewer, larger lights beat many small ones. Emissive meshes are noisier than area lights.
  5. Persistent data (render.use_persistent_data) speeds up animations and turntables. Use simplify (max subdivision, texture limit) for previews.
  6. 5.2: texture cache (render.use_texture_cache, use_auto_generate_texture_cache) cuts memory in texture-heavy scenes by generating .tx mip tiles.

Color management (decide once per project)

  • AgX (default): photographic, handles bright highlights. Looks: AgX - Punchy, - Base Contrast...
  • Khronos PBR Neutral: shows albedo faithfully. Use it for product/e-commerce and asset reviews, and to match three.js NeutralToneMapping.
  • Standard: graphics/UI/texture output that must match pixel values.
  • ACES 1.3 / 2.0: VFX pipelines (plates, other DCCs).
  • Use exposure (view_settings.exposure), not light power, for global brightness tweaks. Display device sRGB, or Display P3 / Rec.2100 for HDR delivery.

Output formats

  • Stills: PNG 8/16-bit (RGBA when the film is transparent) or JPEG for web previews.
  • Comp/VFX: EXR multilayer (EXR_MULTI, DWAA 16-bit) with passes (Denoising Data, Cryptomatte, AO, Mist, Z). 5.0 renamed passes: Diffuse Color, Depth, etc.
  • Video: render frames first (PNG/EXR), then encode (FFmpeg or the VSE), because a crash mid-MP4 loses everything. Direct MP4 is fine for previews. Set image_settings.media_type before file_format (5.0+).
  • Transparent: film_transparent=True + PNG/EXR. A glass-only alpha needs film_transparent_glass.

Compositor (5.0+ API)

python
ng = bpy.data.node_groups.new("Comp", "CompositorNodeTree"); scene.compositing_node_group = ng
ng.interface.new_socket("Image", in_out="OUTPUT", socket_type="NodeSocketColor")
rl, glare, out = ng.nodes.new("CompositorNodeRLayers"), ng.nodes.new("CompositorNodeGlare"), ng.nodes.new("NodeGroupOutput")
ng.links.new(rl.outputs["Image"], glare.inputs["Image"]); ng.links.new(glare.outputs["Image"], out.inputs[0])

There's no Composite node anymore: the group output is the final image. Many node options are now input sockets (Glare Type, Threshold, Strength), so --describe them with blender-geometry-nodes/scripts/gn_builder.py. File Output node: directory, file_name, file_output_items. 5.3: the compositor is an effects stack (scene.compositor_effects, each with its own node_group, enable_for_render/enable_for_preview). scene.compositing_node_group still gets/sets the active effect's group. The Essentials Bloom node group restores the old EEVEE bloom.

CLI rendering (render farms, CI)

  • blender -b scene.blend -E CYCLES -o //out/frame_#### -F PNG -s 1 -e 120 -a renders an animation. -f 10 renders a single frame. Python args go after --.
  • -- --cycles-device OPTIX (or CUDA/HIP/METAL/ONEAPI) selects the device without Python.
  • Split frames across machines with -s/-e, or with Placeholders + No Overwrite (render.use_placeholder, use_overwrite=False) on shared storage.

Gotchas

  • scene.render.engine enum under-reports (add-on engines). Assign in try/except (the script does).
  • EEVEE in background still needs a GPU context. In CI without a GPU, use Cycles CPU or Workbench.
  • bpy.ops.render.render(write_still=True) writes render.filepath. Without write_still, the result only lives in Render Result.
  • Noise in glass/caustics: enable caustics only if needed (caustics_refractive), raise transmission bounces, or fake it with Thin Wall (5.2) for windows.
  • Fireflies: clamp indirect, a filter glossy / blur glossy (blur_glossy 0.5–1), and bigger light sources.
来自同一仓库

更多 Skills

全部 Skills
el4cteo
社区

blender-environment-kits

Game environments in Blender 5.3 - terrain from noise or heightmaps (erosion, terraces, play areas, slope/height materials, 16-bit heightmaps + splat maps for UE/Unity), biome scatter by slope/height/mask with Poisson spacing, modular kit metrics and validation (grid, pivots, seams, texel density). Use for levels, landscapes, forests, modular buildings, dungeons.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日
el4cteo
社区

blender-geometry-nodes

Geometry Nodes in Blender 5.3 - fields, domains, attributes, instancing, zones (simulation/repeat/for-each), closures/bundles, lists, SDF grids, node tools, baking, plus a JSON-to-node-tree builder and socket inspector. Use for scattering, procedural assets/environments, parametric tools and modifier inputs.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日
el4cteo
社区

blender-lighting-lookdev

Lighting, cameras and look-dev in Blender 5.3 - studio 3-point and product lighting, HDRI environments, sun/sky exteriors, interiors, light linking, physically based light units, camera focal lengths/composition/DOF, cyclorama backdrops, looping turntables for asset presentation. Use when presenting assets, setting up scenes for rendering, or judging materials under consistent light.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日
el4cteo
社区

blender-time-of-day

Time of day and atmosphere in Blender 5.3 - measured sky + sun for dawn, morning, noon, golden hour, sunset, blue hour, overcast, night/moonlight with stars and city glow, exposure balance, height fog from visibility, god rays, Cycles vs EEVEE volumes, compositor grade, stylized moods (cyberpunk neon, horror, underwater, desert). Use for any day/night, sunset, foggy or mood lighting scene.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日