gobo-spotlight

Adds a projected-texture spotlight with cone falloff and shadow mapping to SDL GPU projects.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/RosyGameStudio/forge-gpu --skill gobo-spotlight
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gobo-spotlight
Source: https://github.com/RosyGameStudio/forge-gpu/tree/main/.claude/skills/gobo-spotlight
Command: npx skills add https://github.com/RosyGameStudio/forge-gpu --skill gobo-spotlight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables the creation of sophisticated spotlight lighting effects in 3D graphics, allowing for projected patterns and controlled falloff, enhancing visual realism and artistic direction.

Core Features & Use Cases

  • Projected Textures (Gobos): Apply custom patterns (like window frames or foliage) through a spotlight.
  • Cone Falloff: Control the light's intensity based on inner and outer cone angles.
  • Shadow Mapping: Generate shadows from the spotlight's perspective.
  • Use Case: In a game or architectural visualization, use this to simulate stage lighting with a specific logo projected onto a surface, or to create dappled light effects from trees.

Quick Start

Add a spotlight with a gobo texture and shadow map to your scene.

Frequently Asked Questions about gobo-spotlight

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I project a texture through a spotlight in an SDL GPU project?▼

To project a texture through a spotlight in an SDL GPU project, you apply a gobo pattern using a focused light source with cone falloff. This involves creating textures and graphics pipelines to project custom patterns like window frames or foliage onto surfaces.

Can I generate shadow maps for spotlights using the SDL GPU API?▼

Yes, you can generate shadow maps for spotlights using the SDL GPU API. The process implements a depth-only shadow pass rendered from the spotlight's perspective, followed by a scene pass with multiple texture bindings to produce accurate shadows within the cone angles.

What is a gobo and how does it work with 3D graphics spotlight cone falloff?▼

A gobo is a projected texture pattern used in 3D graphics to simulate theatrical or cinematic stage lighting. It works with spotlight cone falloff by controlling light intensity based on inner and outer cone angles, casting patterns like foliage or logos onto surfaces.

Does the SDL GPU API support depth-only render passes for shadow mapping?▼

Yes, the SDL GPU API supports depth-only render passes for shadow mapping. The implementation utilizes SDL GPU samplers and graphics pipelines to execute a dedicated depth pass from the spotlight's view before rendering the final scene with shadow integration.

What's the best way to simulate stage lighting with pattern projection in 3D graphics?▼

The best way to simulate stage lighting with pattern projection in 3D graphics is using a gobo spotlight system. This approach projects custom textures through a focused light source with defined cone angles and shadow mapping to achieve realistic theatrical or architectural visualization effects.

When do I need projected texture spotlights with cone falloff for architectural visualization?▼

You need projected texture spotlights with cone falloff for architectural visualization when simulating realistic focused light sources. This technique is essential for creating effects like dappled light from trees or projecting specific logos and window frame patterns onto surfaces in a scene.