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)

annotation_hide#

Set annotation Visibility

Type:

boolean, default False

annotation_onion_after_color#

Base color for ghosts after the active frame

Type:

mathutils.Color of 3 items in [0, 1], default (0.25, 0.1, 1.0)

annotation_onion_after_range#

Maximum number of frames to show after current frame

Type:

int in [-1, 120], default 0

annotation_onion_before_color#

Base color for ghosts before the active frame

Type:

mathutils.Color of 3 items in [0, 1], default (0.302, 0.851, 0.302)

annotation_onion_before_range#

Maximum number of frames to show before current frame

Type:

int in [-1, 120], default 0

annotation_opacity#

Annotation Layer Opacity

Type:

float in [0, 1], default 0.0

blend_mode#

Blend mode

Type:

enum in [‘REGULAR’, ‘HARDLIGHT’, ‘ADD’, ‘SUBTRACT’, ‘MULTIPLY’, ‘DIVIDE’], default ‘REGULAR’

channel_color#

Custom color for animation channel in Dopesheet

Type:

mathutils.Color of 3 items in [0, 1], default (0.0, 0.0, 0.0)

color#

Color for all strokes in this layer

Type:

mathutils.Color 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)

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)

is_ruler#

This is a special ruler layer

Type:

boolean, default False, (readonly)

line_change#

Thickness change to apply to current strokes (in pixels)

Type:

int in [-300, 300], default 0

location#

Values for change location

Type:

mathutils.Vector of 3 items in [-inf, inf], default (0.0, 0.0, 0.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

lock_material#

Avoids editing locked materials in the layer

Type:

boolean, default False

mask_layers#

List of Masking Layers

Type:

GreasePencilMaskLayers bpy_prop_collection of GPencilLayerMask, (readonly)

matrix_inverse#

Parent inverse transformation matrix

Type:

mathutils.Matrix of 4 * 4 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))

matrix_inverse_layer#

Local Layer transformation inverse matrix

Type:

mathutils.Matrix of 4 * 4 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)), (readonly)

matrix_layer#

Local Layer transformation matrix

Type:

mathutils.Matrix of 4 * 4 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)), (readonly)

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’

pass_index#

Index number for the “Layer Index” pass

Type:

int in [0, 32767], default 0

rotation#

Values for changes in rotation

Type:

mathutils.Euler rotation of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

scale#

Values for changes in scale

Type:

mathutils.Vector of 3 items in [-inf, inf], default (1.0, 1.0, 1.0)

select#

Layer is selected for editing in the Dope Sheet

Type:

boolean, default False

show_in_front#

Make the layer display in front of objects

Type:

boolean, default False

show_points#

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

Type:

boolean, default False

thickness#

Thickness of annotation strokes

Type:

int in [1, 10], default 0

tint_color#

Color for tinting stroke colors

Type:

mathutils.Color 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

use_annotation_onion_skinning#

Display annotation onion skins before and after the current frame

Type:

boolean, default False

use_lights#

Enable the use of lights on stroke and fill materials

Type:

boolean, default False

use_mask_layer#

The visibility of drawings on this layer is affected by the layers in its masks list

Type:

boolean, default False

use_onion_skinning#

Display onion skins before and after the current frame

Type:

boolean, default False

use_solo_mode#

In Draw Mode only display layers with keyframe in current frame

Type:

boolean, default False

use_viewlayer_masks#

Include the mask layers when rendering the view-layer

Type:

boolean, default False

vertex_paint_opacity#

Vertex Paint mix factor

Type:

float in [0, 1], default 1.0

viewlayer_render#

Only include Layer in this View Layer render output (leave blank to include always)

Type:

string, default “”, (never None)

clear()#

Remove all the grease pencil layer data

classmethod bl_rna_get_subclass(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties#

Inherited Functions#

References#