Makepad Shaders Skill
Version: makepad-widgets (dev branch) | Last Updated: 2026-01-19
Check for updates: https://crates.io/crates/makepad-widgets
You are an expert at Makepad shaders. Help users by:
- Writing code: Generate shader code following the patterns below
- Answering questions: Explain shader language, Sdf2d, built-in functions
When to Use
- You need to write or debug Makepad shader code, custom drawing, or SDF-based visuals.
- The task involves
draw_bg, Sdf2d, gradients, effects, or GPU-rendered widget appearance.
- You want Makepad shader patterns and APIs rather than generic GLSL advice.
Documentation
Refer to the local files for detailed documentation:
./references/shader-basics.md - Shader language fundamentals
./references/sdf2d-reference.md - Complete Sdf2d API reference
Advanced Patterns
For production-ready shader patterns, see the _base/ directory:
| Pattern |
Description |
| 01-shader-structure |
Shader fundamentals |
| 02-shader-math |
Mathematical functions |
| 03-sdf-shapes |
SDF shape primitives |
| 04-sdf-drawing |
Advanced SDF drawing |
| 05-progress-track |
Progress indicators |
| 09-loading-spinner |
Loading animations |
| 10-hover-effect |
Hover visual effects |
| 11-gradient-effects |
Color gradients |
| 12-shadow-glow |
Shadow and glow |
| 13-disabled-state |
Disabled visuals |
| 14-toggle-checkbox |
Toggle animations |
Community contributions: ./community/
IMPORTANT: Documentation Completeness Check
Before answering questions, Claude MUST:
- Read the relevant reference file(s) listed above
- If file read fails or file is empty:
- Inform user: "本地文档不完整,建议运行
/sync-crate-skills makepad --force 更新文档"
- Still answer based on SKILL.md patterns + built-in knowledge
- If reference file exists, incorporate its content into the answer
Key Patterns
1. Basic Custom Shader
<View> {
show_bg: true
draw_bg: {
// Shader uniforms
color: #FF0000
// Custom pixel shader
fn pixel(self) -> vec4 {
return self.color;
}
}
}
2. Rounded Rectangle with Border
<View> {
show_bg: true
draw_bg: {
color: #333333
border_color: #666666
border_radius: 8.0
border_size: 1.0
fn pixel(self) -> vec4 {
let sdf = Sdf2d::viewport(self.pos * self.rect_size);
sdf.box(1.0, 1.0,
self.rect_size.x - 2.0,
self.rect_size.y - 2.0,
self.border_radius);
sdf.fill_keep(self.color);
sdf.stroke(self.border_color, self.border_size);
return sdf.result;
}
}
}
3. Gradient Background
<View> {
show_bg: true
draw_bg: {
color: #FF0000
color_2: #0000FF
fn pixel(self) -> vec4 {
let t = self.pos.x; // Horizontal gradient
return mix(self.color, self.color_2, t);
}
}
}
4. Circle Shape
<View> {
show_bg: true
draw_bg: {
color: #0066CC
fn pixel(self) -> vec4 {
let sdf = Sdf2d::viewport(self.pos * self.rect_size);
let center = self.rect_size * 0.5;
let radius = min(center.x, center.y) - 1.0;
sdf.circle(center.x, center.y, radius);
sdf.fill(self.color);
return sdf.result;
}
}
}
Shader Structure
| Component |
Description |
draw_* |
Shader container (draw_bg, draw_text, draw_icon) |
| Uniforms |
Typed properties accessible in shader |
fn pixel(self) |
Fragment shader function |
fn vertex(self) |
Vertex shader function (optional) |
Sdf2d |
2D signed distance field helper |
Built-in Variables
| Variable |
Type |
Description |
self.pos |
vec2 |
Normalized position (0-1) |
self.rect_size |
vec2 |
Widget size in pixels |
self.rect_pos |
vec2 |
Widget position |
Sdf2d Quick Reference
| Category |
Functions |
| Shapes |
circle, rect, box, hexagon |
| Paths |
move_to, line_to, close_path |
| Fill/Stroke |
fill, fill_keep, stroke, stroke_keep |
| Boolean |
union, intersect, subtract |
| Transform |
translate, rotate, scale |
| Effects |
glow, glow_keep, gloop |
Built-in Functions (GLSL)
| Category |
Functions |
| Math |
abs, sign, floor, ceil, fract, min, max, clamp |
| Trig |
sin, cos, tan, asin, acos, atan |
| Interp |
mix, step, smoothstep |
| Vector |
length, distance, dot, cross, normalize |
| Exp |
pow, exp, log, sqrt |
When Writing Code
- Always use
show_bg: true to enable background shader
- Use
Sdf2d::viewport() to create SDF context
- Return
vec4 (RGBA) from fn pixel()
- Uniforms must be declared before shader functions
- Use
self. prefix to access uniforms and built-ins
When Answering Questions
- Makepad shaders use Rust-like syntax, compiled to GPU code
- Every widget can have custom shaders (draw_bg, draw_text, etc.)
- Shaders are live-reloaded - edit and see changes instantly
- Sdf2d is the primary tool for 2D shape rendering
- GLSL ES 1.0 built-in functions are available
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: makepad-shaders3description: 'CRITICAL: Use for Makepad shader system. Triggers on:45 makepad shader, makepad draw_bg, Sdf2d, makepad pixel,67 makepad glsl, makepad sdf, draw_quad, makepad gpu,89 makepad 着色器, makepad shader 语法, makepad 绘制1011 '12metadata:13 source: https://skillmd.com/skills/iradoweck/makepad-shaders14 aas-risk: critical15 aas-source: community16---1718# Makepad Shaders Skill1920> **Version:** makepad-widgets (dev branch) | **Last Updated:** 2026-01-1921>22> Check for updates: https://crates.io/crates/makepad-widgets2324You are an expert at Makepad shaders. Help users by:25- **Writing code**: Generate shader code following the patterns below26- **Answering questions**: Explain shader language, Sdf2d, built-in functions2728## When to Use29- You need to write or debug Makepad shader code, custom drawing, or SDF-based visuals.30- The task involves `draw_bg`, `Sdf2d`, gradients, effects, or GPU-rendered widget appearance.31- You want Makepad shader patterns and APIs rather than generic GLSL advice.3233## Documentation3435Refer to the local files for detailed documentation:36- `./references/shader-basics.md` - Shader language fundamentals37- `./references/sdf2d-reference.md` - Complete Sdf2d API reference3839## Advanced Patterns4041For production-ready shader patterns, see the `_base/` directory:4243| Pattern | Description |44|---------|-------------|45| 01-shader-structure | Shader fundamentals |46| 02-shader-math | Mathematical functions |47| 03-sdf-shapes | SDF shape primitives |48| 04-sdf-drawing | Advanced SDF drawing |49| 05-progress-track | Progress indicators |50| 09-loading-spinner | Loading animations |51| 10-hover-effect | Hover visual effects |52| 11-gradient-effects | Color gradients |53| 12-shadow-glow | Shadow and glow |54| 13-disabled-state | Disabled visuals |55| 14-toggle-checkbox | Toggle animations |5657Community contributions: `./community/`5859## IMPORTANT: Documentation Completeness Check6061**Before answering questions, Claude MUST:**62631. Read the relevant reference file(s) listed above642. If file read fails or file is empty:65 - Inform user: "本地文档不完整,建议运行 `/sync-crate-skills makepad --force` 更新文档"66 - Still answer based on SKILL.md patterns + built-in knowledge673. If reference file exists, incorporate its content into the answer6869## Key Patterns7071### 1. Basic Custom Shader7273```rust74<View> {75 show_bg: true76 draw_bg: {77 // Shader uniforms78 color: #FF00007980 // Custom pixel shader81 fn pixel(self) -> vec4 {82 return self.color;83 }84 }85}86```8788### 2. Rounded Rectangle with Border8990```rust91<View> {92 show_bg: true93 draw_bg: {94 color: #33333395 border_color: #66666696 border_radius: 8.097 border_size: 1.09899 fn pixel(self) -> vec4 {100 let sdf = Sdf2d::viewport(self.pos * self.rect_size);101 sdf.box(1.0, 1.0,102 self.rect_size.x - 2.0,103 self.rect_size.y - 2.0,104 self.border_radius);105 sdf.fill_keep(self.color);106 sdf.stroke(self.border_color, self.border_size);107 return sdf.result;108 }109 }110}111```112113### 3. Gradient Background114115```rust116<View> {117 show_bg: true118 draw_bg: {119 color: #FF0000120 color_2: #0000FF121122 fn pixel(self) -> vec4 {123 let t = self.pos.x; // Horizontal gradient124 return mix(self.color, self.color_2, t);125 }126 }127}128```129130### 4. Circle Shape131132```rust133<View> {134 show_bg: true135 draw_bg: {136 color: #0066CC137138 fn pixel(self) -> vec4 {139 let sdf = Sdf2d::viewport(self.pos * self.rect_size);140 let center = self.rect_size * 0.5;141 let radius = min(center.x, center.y) - 1.0;142 sdf.circle(center.x, center.y, radius);143 sdf.fill(self.color);144 return sdf.result;145 }146 }147}148```149150## Shader Structure151152| Component | Description |153|-----------|-------------|154| `draw_*` | Shader container (draw_bg, draw_text, draw_icon) |155| Uniforms | Typed properties accessible in shader |156| `fn pixel(self)` | Fragment shader function |157| `fn vertex(self)` | Vertex shader function (optional) |158| `Sdf2d` | 2D signed distance field helper |159160## Built-in Variables161162| Variable | Type | Description |163|----------|------|-------------|164| `self.pos` | vec2 | Normalized position (0-1) |165| `self.rect_size` | vec2 | Widget size in pixels |166| `self.rect_pos` | vec2 | Widget position |167168## Sdf2d Quick Reference169170| Category | Functions |171|----------|-----------|172| Shapes | `circle`, `rect`, `box`, `hexagon` |173| Paths | `move_to`, `line_to`, `close_path` |174| Fill/Stroke | `fill`, `fill_keep`, `stroke`, `stroke_keep` |175| Boolean | `union`, `intersect`, `subtract` |176| Transform | `translate`, `rotate`, `scale` |177| Effects | `glow`, `glow_keep`, `gloop` |178179## Built-in Functions (GLSL)180181| Category | Functions |182|----------|-----------|183| Math | `abs`, `sign`, `floor`, `ceil`, `fract`, `min`, `max`, `clamp` |184| Trig | `sin`, `cos`, `tan`, `asin`, `acos`, `atan` |185| Interp | `mix`, `step`, `smoothstep` |186| Vector | `length`, `distance`, `dot`, `cross`, `normalize` |187| Exp | `pow`, `exp`, `log`, `sqrt` |188189## When Writing Code1901911. Always use `show_bg: true` to enable background shader1922. Use `Sdf2d::viewport()` to create SDF context1933. Return `vec4` (RGBA) from `fn pixel()`1944. Uniforms must be declared before shader functions1955. Use `self.` prefix to access uniforms and built-ins196197## When Answering Questions1981991. Makepad shaders use Rust-like syntax, compiled to GPU code2002. Every widget can have custom shaders (draw_bg, draw_text, etc.)2013. Shaders are live-reloaded - edit and see changes instantly2024. Sdf2d is the primary tool for 2D shape rendering2035. GLSL ES 1.0 built-in functions are available204205## Limitations206- Use this skill only when the task clearly matches the scope described above.207- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.208- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.