GPencilLayer(bpy_struct)

base class — bpy_struct

class bpy.types.GPencilLayer(bpy_struct)

Collection of related sketches

active_frame

Frame currently being displayed for this layer

Type:GPencilFrame, (readonly)
after_color

Base color for ghosts after the active frame

Type:float array of 3 items in [0, 1], default (0.0, 0.0, 0.0)
before_color

Base color for ghosts before the active frame

Type:float array of 3 items in [0, 1], default (0.0, 0.0, 0.0)
frames

Sketches for this layer on different frames

Type:GPencilFrames bpy_prop_collection of GPencilFrame, (readonly)
ghost_after_range

Maximum number of frames to show after current frame (0 = show only the next sketch, -1 = don’t show any frames after current)

Type:int in [-1, 120], default 0
ghost_before_range

Maximum number of frames to show before current frame (0 = show only the previous sketch, -1 = don’t show any frames before current)

Type:int in [-1, 120], default 0
hide

Set layer Visibility

Type:boolean, default False
info

Layer name

Type:string, default “”, (never None)
is_parented

True when the layer parent object is set

Type:boolean, default False, (readonly)
line_change

Thickness change to apply to current strokes (in pixels)

Type:int in [-32768, 32767], default 0
lock

Protect layer from further editing and/or frame changes

Type:boolean, default False
lock_frame

Lock current frame displayed by layer

Type:boolean, default False
matrix_inverse

Parent inverse transformation matrix

Type:float array of 16 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0)
opacity

Layer Opacity

Type:float in [0, 1], default 0.0
parent

Parent Object

Type:Object
parent_bone

Name of parent bone in case of a bone parenting relation

Type:string, default “”, (never None)
parent_type

Type of parent relation

  • OBJECT Object, The layer is parented to an object.
  • ARMATURE Armature.
  • BONE Bone, The layer is parented to a bone.
Type:enum in [‘OBJECT’, ‘ARMATURE’, ‘BONE’], default ‘OBJECT’
select

Layer is selected for editing in the Dope Sheet

Type:boolean, default False
show_points

Draw the points which make up the strokes (for debugging purposes)

Type:boolean, default False
show_x_ray

Make the layer draw in front of objects

Type:boolean, default False
tint_color

Color for tinting stroke colors

Type:float array of 3 items in [0, 1], default (0.0, 0.0, 0.0)
tint_factor

Factor of tinting color

Type:float in [0, 1], default 0.0
unlock_color

Unprotect selected colors from further editing and/or frame changes

Type:boolean, default False
use_ghost_custom_colors

Use custom colors for ghost frames

Type:boolean, default False
use_ghosts_always

Ghosts are shown in renders and animation playback. Useful for special effects (e.g. motion blur)

Type:boolean, default False
use_onion_skinning

Ghost frames on either side of frame

Type:boolean, default False
use_volumetric_strokes

Draw strokes as a series of circular blobs, resulting in a volumetric effect

Type:boolean, default False
clear()

Remove all the grease pencil layer data

Inherited Properties

Inherited Functions

References