bpy.ops.gpencil.primitive_line

简介

使用此操作可以在当前工作区创建新的草图（Grease Pencil）线条图元。

语法

bpy.ops.gpencil.primitive_line(
    mode='VIEW', 
    location=(0,0,0), 
    gpencil_layer='', 
    stroke=None, 
    press_i=0.5, 
    wait_for_input=True,
    disable_straight_line=False)

参数

• mode：字符串，显示模式，可选值为 'VIEW' 或 'EDIT'，默认值为 'VIEW'。
• location：元组，指定图元的世界坐标系下的位置，其包含三个浮点型元素，分别代表X、Y、Z轴坐标，如 (0,0,0)。
• gpencil_layer：字符串，设置图元所在的草图层名称，如果未指定，则默认为活动草图层。
• stroke：对象，草图线条对象。
• press_i：浮点型，指定画笔笔压的百分比，默认值为0.5。
• wait_for_input：布尔型，指定是否等待用户输入，默认为 True。
• disable_straight_line：布尔型，禁用笔直（直线）模式，当此参数为 True 时，创建的线条将不会是笔直的，而是需要手动创建。默认值为 False。

返回值

该操作没有返回值。

示例

import bpy

# 在默认位置创建新草图线条
bpy.ops.gpencil.primitive_line()

# 在指定位置创建新草图线条
bpy.ops.gpencil.primitive_line(location=(2,4,0))

# 禁用笔直模式，手动创建新草图线条
bpy.ops.gpencil.primitive_line(disable_straight_line=True)