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
1---2name: makepad-shaders3description: |4 CRITICAL: Use for Makepad shader system. Triggers on:5 makepad shader, makepad draw_bg, Sdf2d, makepad pixel,6 makepad glsl, makepad sdf, draw_quad, makepad gpu,7 makepad 着色器, makepad shader 语法, makepad 绘制8risk: unknown9source: community10metadata:11 source: https://skillmd.com/skills/welitonevoc/makepad-shaders12---1314# Makepad Shaders Skill1516> **Version:** makepad-widgets (dev branch) | **Last Updated:** 2026-01-1917>18> Check for updates: https://crates.io/crates/makepad-widgets1920You are an expert at Makepad shaders. Help users by:21- **Writing code**: Generate shader code following the patterns below22- **Answering questions**: Explain shader language, Sdf2d, built-in functions2324## When to Use2526- You need to write or debug Makepad shader code, custom drawing, or SDF-based visuals.27- The task involves `draw_bg`, `Sdf2d`, gradients, effects, or GPU-rendered widget appearance.28- You want Makepad shader patterns and APIs rather than generic GLSL advice.2930## Documentation3132Refer to the local files for detailed documentation:33- `./references/shader-basics.md` - Shader language fundamentals34- `./references/sdf2d-reference.md` - Complete Sdf2d API reference3536## Advanced Patterns3738For production-ready shader patterns, see the `_base/` directory:3940| Pattern | Description |41|---------|-------------|42| 01-shader-structure | Shader fundamentals |43| 02-shader-math | Mathematical functions |44| 03-sdf-shapes | SDF shape primitives |45| 04-sdf-drawing | Advanced SDF drawing |46| 05-progress-track | Progress indicators |47| 09-loading-spinner | Loading animations |48| 10-hover-effect | Hover visual effects |49| 11-gradient-effects | Color gradients |50| 12-shadow-glow | Shadow and glow |51| 13-disabled-state | Disabled visuals |52| 14-toggle-checkbox | Toggle animations |5354Community contributions: `./community/`5556## IMPORTANT: Documentation Completeness Check5758**Before answering questions, Claude MUST:**59601. Read the relevant reference file(s) listed above612. If file read fails or file is empty:62 - Inform user: "本地文档不完整,建议运行 `/sync-crate-skills makepad --force` 更新文档"63 - Still answer based on SKILL.md patterns + built-in knowledge643. If reference file exists, incorporate its content into the answer6566## Key Patterns6768### 1. Basic Custom Shader6970```rust71<View> {72 show_bg: true73 draw_bg: {74 // Shader uniforms75 color: #FF00007677 // Custom pixel shader78 fn pixel(self) -> vec4 {79 return self.color;80 }81 }82}83```8485### 2. Rounded Rectangle with Border8687```rust88<View> {89 show_bg: true90 draw_bg: {91 color: #33333392 border_color: #66666693 border_radius: 8.094 border_size: 1.09596 fn pixel(self) -> vec4 {97 let sdf = Sdf2d::viewport(self.pos * self.rect_size);98 sdf.box(1.0, 1.0,99 self.rect_size.x - 2.0,100 self.rect_size.y - 2.0,101 self.border_radius);102 sdf.fill_keep(self.color);103 sdf.stroke(self.border_color, self.border_size);104 return sdf.result;105 }106 }107}108```109110### 3. Gradient Background111112```rust113<View> {114 show_bg: true115 draw_bg: {116 color: #FF0000117 color_2: #0000FF118119 fn pixel(self) -> vec4 {120 let t = self.pos.x; // Horizontal gradient121 return mix(self.color, self.color_2, t);122 }123 }124}125```126127### 4. Circle Shape128129```rust130<View> {131 show_bg: true132 draw_bg: {133 color: #0066CC134135 fn pixel(self) -> vec4 {136 let sdf = Sdf2d::viewport(self.pos * self.rect_size);137 let center = self.rect_size * 0.5;138 let radius = min(center.x, center.y) - 1.0;139 sdf.circle(center.x, center.y, radius);140 sdf.fill(self.color);141 return sdf.result;142 }143 }144}145```146147## Shader Structure148149| Component | Description |150|-----------|-------------|151| `draw_*` | Shader container (draw_bg, draw_text, draw_icon) |152| Uniforms | Typed properties accessible in shader |153| `fn pixel(self)` | Fragment shader function |154| `fn vertex(self)` | Vertex shader function (optional) |155| `Sdf2d` | 2D signed distance field helper |156157## Built-in Variables158159| Variable | Type | Description |160|----------|------|-------------|161| `self.pos` | vec2 | Normalized position (0-1) |162| `self.rect_size` | vec2 | Widget size in pixels |163| `self.rect_pos` | vec2 | Widget position |164165## Sdf2d Quick Reference166167| Category | Functions |168|----------|-----------|169| Shapes | `circle`, `rect`, `box`, `hexagon` |170| Paths | `move_to`, `line_to`, `close_path` |171| Fill/Stroke | `fill`, `fill_keep`, `stroke`, `stroke_keep` |172| Boolean | `union`, `intersect`, `subtract` |173| Transform | `translate`, `rotate`, `scale` |174| Effects | `glow`, `glow_keep`, `gloop` |175176## Built-in Functions (GLSL)177178| Category | Functions |179|----------|-----------|180| Math | `abs`, `sign`, `floor`, `ceil`, `fract`, `min`, `max`, `clamp` |181| Trig | `sin`, `cos`, `tan`, `asin`, `acos`, `atan` |182| Interp | `mix`, `step`, `smoothstep` |183| Vector | `length`, `distance`, `dot`, `cross`, `normalize` |184| Exp | `pow`, `exp`, `log`, `sqrt` |185186## When Writing Code1871881. Always use `show_bg: true` to enable background shader1892. Use `Sdf2d::viewport()` to create SDF context1903. Return `vec4` (RGBA) from `fn pixel()`1914. Uniforms must be declared before shader functions1925. Use `self.` prefix to access uniforms and built-ins193194## When Answering Questions1951961. Makepad shaders use Rust-like syntax, compiled to GPU code1972. Every widget can have custom shaders (draw_bg, draw_text, etc.)1983. Shaders are live-reloaded - edit and see changes instantly1994. Sdf2d is the primary tool for 2D shape rendering2005. GLSL ES 1.0 built-in functions are available