blender-grease-pencil

Blender Grease Pencil Skill

Version: 2.0.1 Last Updated: 2026-06-10 Dependencies: Blender 5.1+

---

API Stability (5.1+)

Core Grease Pencil API is stable across 4.x -> 5.1:

• bpy.data.grease_pencils - data creation
• gpencil.layers - layer management
• layer.frames - frame management
• frame.strokes - stroke data
• Material slots and properties

---

QUICK START

Create Basic 2D Animation

import bpy

# Create new Grease Pencil data
gpencil = bpy.data.grease_pencils.new("Animation_GP")

# Create object and link to scene
obj = bpy.data.objects.new("Animation_Object", gpencil)
bpy.context.scene.collection.objects.link(obj)
bpy.context.view_layer.objects.active = obj

# Add drawing layer
layer = gpencil.layers.new("DrawingLayer")

# Create frame at frame 1
frame = layer.frames.new(1)

# Create stroke
stroke = frame.strokes.new()
stroke.points.add(count=3)

# Set point coordinates
stroke.points[0].co = (0, 0, 0)
stroke.points[1].co = (1, 1, 0)
stroke.points[2].co = (2, 0, 0)

stroke.line_width = 10

print(f"Created GP object with {len(frame.strokes)} stroke(s)")

---

STANDARD WORKFLOWS

Workflow 1: Frame-by-Frame Animation

import bpy

gpencil = bpy.data.grease_pencils.new("Anim_GP")
obj = bpy.data.objects.new("Anim_Object", gpencil)
bpy.context.scene.collection.objects.link(obj)

layer = gpencil.layers.new("DrawingLayer")
layer.use_onion_skinning = True  # Enable onion skinning

# Frame 1 - starting position
f1 = layer.frames.new(1)
s1 = f1.strokes.new()
s1.points.add(count=2)
s1.points[0].co = (0, 0, 0)
s1.points[1].co = (1, 0, 0)
s1.line_width = 10

# Frame 12 - midpoint
f12 = layer.frames.new(12)
s12 = f12.strokes.new()
s12.points.add(count=2)
s12.points[0].co = (0, 0.5, 0)
s12.points[1].co = (1, 0.5, 0)
s12.line_width = 10

# Frame 24 - end position
f24 = layer.frames.new(24)
s24 = f24.strokes.new()
s24.points.add(count=2)
s24.points[0].co = (0, 1, 0)
s24.points[1].co = (1, 1, 0)
s24.line_width = 10

# Set scene frame range
bpy.context.scene.frame_start = 1
bpy.context.scene.frame_end = 24

print(f"Frame-by-frame animation: {len(layer.frames)} frames created")