文本

类型标识：TEXT

属性

`angle`

旋转角度（度），顺时针为正。类型 float，默认 0。

`bold`

粗体。类型 bool，默认 False。

`collision_enabled`

是否参与碰撞检测。类型 bool，默认 False。

`collision_offset_x`、`collision_offset_y`

形状相对对象中心的偏移（bbox 不适用）。类型 float，默认 0。

`collision_points`

polygon 形状的顶点列表。类型 list，默认 []。

`collision_type`

碰撞形状：'bbox'、'rect'、'ellipse' 或 'polygon'。类型 str，默认 'rect'。

`collision_width`、`collision_height`

rect 与 ellipse 形状的尺寸。类型 float，默认为对象尺寸。

`color`

文字颜色。类型 (r, g, b, a)，默认 (255, 255, 255, 255)。

`font_path`

相对于工程目录的字体文件（缺失时使用内置字体）。类型 str，默认 './font/SIMHEI.ttf'。

`font_size`

字号（像素）。类型 int，默认 30。

`italic`

斜体。类型 bool，默认 False。

`name`

层级面板中显示的名称。运行时只读。类型 str。

`physics_angular_damping`

角速度阻尼。类型 float，默认 0。

`physics_elasticity`

弹性系数（0 为完全非弹性，1 为完全弹性）。类型 float，默认 0.2。

`physics_enabled`

是否启用刚体物理。类型 bool，默认 False。

`physics_fixed_rotation`

是否固定旋转（碰撞也不会让它转动）。类型 bool，默认 False。

`physics_friction`

摩擦系数。类型 float，默认 0.6。

`physics_gravity_scale`

重力缩放（0 表示不受重力影响）。类型 float，默认 1。

`physics_linear_damping`

线速度阻尼。类型 float，默认 0。

`physics_mass`

质量。类型 float，默认 1。

`physics_shape_height`、`physics_shape_width`

刚体形状 rect、ellipse 的尺寸（0 表示使用对象自身尺寸）。类型 float，默认 0。

`physics_shape_offset_x`、`physics_shape_offset_y`

刚体形状相对对象中心的偏移。类型 float，默认 0。

`physics_shape_points`

刚体形状 polygon 的顶点列表。类型 list，默认 []。

`physics_shape_type`

刚体形状：'rect'、'ellipse' 或 'polygon'。类型 str，默认 'rect'。

`physics_type`

刚体类型：'static'、'dynamic' 或 'kinematic'。类型 str，默认 'dynamic'。

`pivot`

变换基准点模式，可选值见 set_pivot()。类型 str，默认 'center'。

`pivot_x`、`pivot_y`

'custom' 基准点的坐标（对象自身的像素网格，原点在对象左上角）。类型 float，默认 0。

`pos`

即 (x, y)，赋值时会同步更新 x 和 y。类型 (int, int)，默认 (20, 20)。

`scale`

即 (scale_x, scale_y)。类型 (float, float)，默认 (1, 1)。

`scale_x`、`scale_y`

缩放系数（1 为原始大小）。类型 float，默认 1。

`script_path`

已挂载脚本的路径（相对于工程目录）。类型 str，默认 ''。

`size`

文字显示在对象的 size 内，具体位置由 text_align 与 text_valign 决定。类型 (int, int)。

`strikethrough`

删除线。类型 bool，默认 False。

`text`

绘制的内容。类型 str，默认 'Text'。

`text_align`

'left'、'center' 或 'right'。类型 str，默认 'center'。

`text_valign`

'top'、'middle' 或 'bottom'。类型 str，默认 'middle'。

`type`

类型标识，如 RECT、TEXT_INPUT。运行时只读。类型 str。

`underline`

下划线。类型 bool，默认 False。

`uuid`

唯一标识，供 get_object_by_uuid() 使用。运行时只读。类型 str。

`visible`

隐藏的对象不会绘制，也无法被点击。类型 bool，默认 True。

`width`、`height`

像素尺寸。类型 int，默认随对象类型而定。

`x`、`y`

相对于父对象的位置。类型 int，默认 20。

方法

`collides_with_object(other)`

is_colliding_with_object 的别名。

other（object）：另一个对象。

`collides_with_point(x, y)`

点（场景坐标）是否落在碰撞形状内。

x（int）：点的 x（场景坐标）。
y（int）：点的 y（场景坐标）。

`collides_with_rect(rect)`

形状是否与 pygame.Rect 或 (x, y, w, h) 元组重叠。

rect（pygame.Rect | (int, int, int, int)）：矩形（场景坐标）。

`distance_to(x, y)`

对象中心到某个点的距离。

x（int）：点的 x（场景坐标）。
y（int）：点的 y（场景坐标）。

`distance_to_object(other)`

两个对象中心之间的距离。

other（object）：另一个对象。

`get_angle()`

旋转角度（度）。

`get_bold_state()`

是否为粗体。

`get_center()`

对象中心（场景坐标）。

`get_collision_center()`

碰撞形状的中心（场景坐标）。

`get_collision_offset()`

形状相对对象中心的偏移。

`get_collision_polygon()`

多边形顶点列表。

`get_collision_radius()`

椭圆形状的半径（较短边的一半）。

`get_collision_rect(x, y, width, height)`

与矩形的重叠区域，没有重叠时为 None。

x（int）：矩形的 x（场景坐标）。
y（int）：矩形的 y（场景坐标）。
width（int）：矩形宽度。
height（int）：矩形高度。

`get_collision_size()`

rect 与 ellipse 形状的尺寸。

`get_collision_type()`

当前碰撞形状。

`get_color()`

文字颜色 (r, g, b, a)。

`get_direction_to(x, y)`

从对象指向某点的单位向量 (dx, dy)。

x（int）：点的 x（场景坐标）。
y（int）：点的 y（场景坐标）。

`get_font_path()`

字体文件路径。

`get_font_size()`

字号（像素）。

`get_height()`

高度（像素）。

`get_italic_state()`

是否为斜体。

`get_name()`

对象名称。

`get_pivot()`

变换基准点模式（如 'center'、'top_left'、'custom'）。

`get_pivot_point()`

基准点解析到对象内容像素后的坐标 (x, y)。

`get_pos()`

相对父对象的本地坐标 (x, y)。

`get_rect()`

对象的本地 pygame.Rect。

`get_scale()`

缩放系数 (scale_x, scale_y)。

`get_scale_x()`

x 方向缩放系数。

`get_scale_y()`

y 方向缩放系数。

`get_size()`

尺寸 (宽, 高)（像素）。

`get_strikethrough_state()`

是否带删除线。

`get_text()`

当前绘制的文字。

`get_text_align()`

水平对齐方式。

`get_text_size()`

当前文字所需的 (宽, 高)，便于把外框调整到合适大小。

`get_text_valign()`

垂直对齐方式。

`get_type()`

对象类型标识。

`get_underline_state()`

是否带下划线。

`get_uuid()`

对象 uuid。

`get_visible_state()`

读取 visible 状态。

`get_width()`

宽度（像素）。

`get_world_pos()`

叠加父对象偏移后的场景坐标。

`get_world_rect()`

场景坐标下的 pygame.Rect。

`get_x()`

本地坐标的 x 分量。

`get_y()`

本地坐标的 y 分量。

`hide()`

隐藏对象，等同于设置 obj.visible = False。

`is_colliding_with_object(other)`

两个对象都开启碰撞且形状重叠时为 True。

other（object）：另一个对象。

`is_colliding_with_rect(x, y, width, height)`

形状是否与给定矩形重叠。

x（int）：矩形的 x（场景坐标）。
y（int）：矩形的 y（场景坐标）。
width（int）：矩形宽度。
height（int）：矩形高度。

`is_collision_enabled()`

该对象是否开启了碰撞检测。

`is_hidden()`

对象是否被隐藏。

`is_point_inside(x, y)`

轻量检测：点落在对象的外接矩形内即为 True。

x（int）：点的 x（场景坐标）。
y（int）：点的 y（场景坐标）。

`is_pressed(x, y)`

逐像素检测：只有落在非透明像素上才是 True。适合处理点击，不适合每帧调用。

x（int）：点的 x（场景坐标）。
y（int）：点的 y（场景坐标）。

`is_shown()`

同 is_visible()。

`is_visible()`

对象是否可见。

`move(dx, dy)`

在当前位置上移动 (dx, dy) 像素。

dx（int）：水平位移。
dy（int）：垂直位移。

`reset_collision_shape()`

把形状字段重置为对象自身尺寸。

`set_angle(degrees)`

设置旋转角度。

degrees（float）：角度（度），顺时针为正。

`set_bold_state(bold)`

设置粗体。

bold（bool）：True / False。

`set_center(x, y)`

设置对象中心（场景坐标）。

x（int）：新的中心 x。
y（int）：新的中心 y。

`set_collision_ellipse(radius_x, radius_y)`

便捷方法：用两个半径设置椭圆。

radius_x（float）：水平半径。
radius_y（float）：垂直半径。

`set_collision_enabled(enabled)`

开启 / 关闭碰撞检测。关闭时所有 collides_with_* / is_colliding_* 都返回 False。

enabled（bool）：True / False。

`set_collision_offset(x, y)`

让形状相对对象中心偏移（会跟随缩放与旋转）。

x（float）：水平偏移。
y（float）：垂直偏移。

`set_collision_polygon(points)`

设置多边形顶点。

points（list）：顶点列表，例如 [(0, 0), (50, 0), (25, 40)]。

`set_collision_size(width, height)`

设置 rect 与 ellipse 的尺寸。

width（int）：形状宽度。
height（int）：形状高度。

`set_collision_type(type)`

设置碰撞形状。

type（str）：'bbox'、'rect'、'ellipse' 或 'polygon'。

`set_color(color)`

设置文字颜色。

color（(r, g, b, a)）：新的颜色元组。

`set_font(font_path, font_size)`

一次设置字体文件与字号。

font_path（str）：字体文件（相对于工程目录）。
font_size（int）：字号（像素）。

`set_font_path(path)`

设置字体文件。

path（str）：字体文件（相对于工程目录）。

`set_font_size(size)`

设置字号。

size（int）：字号（像素）。

`set_height(h)`

设置高度。

h（int）：新的高度（像素）。

`set_italic_state(italic)`

设置斜体。

italic（bool）：True / False。

`set_pivot(pivot)`

设置变换基准点模式。

pivot（str）：'center'（默认）、'top_left'、'top_center'、'top_right'、'center_left'、'center_right'、'bottom_left'、'bottom_center'、'bottom_right' 或 'custom'。

`set_pivot_point(x, y)`

把基准点设到对象自身像素网格的任意一点（同时把 pivot 设为 'custom'）。

x（float）：基准点 x（对象自身像素网格）。
y（float）：基准点 y。

`set_pos(x, y)`

设置相对父对象的本地坐标。

x（int）：新的 x，相对父对象（像素）。
y（int）：新的 y，相对父对象（像素）。

`set_scale(sx, sy)`

设置两个缩放系数。

sx（float）：x 方向缩放系数。
sy（float）：y 方向缩放系数。

`set_scale_x(sx)`

设置 x 方向缩放系数。

sx（float）：x 方向缩放系数。

`set_scale_y(sy)`

设置 y 方向缩放系数。

sy（float）：y 方向缩放系数。

`set_size(width, height)`

设置尺寸（像素）。

width（int）：新的宽度。
height（int）：新的高度。

`set_strikethrough_state(strikethrough)`

设置删除线。

strikethrough（bool）：True / False。

`set_text(text)`

修改文字。

text（str）：新的文字内容。

`set_text_align(align)`

设置水平对齐。

align（str）：'left'、'center' 或 'right'。

`set_text_valign(align)`

设置垂直对齐。

align（str）：'top'、'middle' 或 'bottom'。

`set_underline_state(underline)`

设置下划线。

underline（bool）：True / False。

`set_visible_state(visible)`

设置 visible 状态。

visible（bool）：True 显示对象，False 隐藏对象。

`set_width(w)`

设置宽度。

w（int）：新的宽度（像素）。

`set_world_pos(x, y)`

设置场景坐标（已叠加父对象偏移）。

x（int）：新的 x（场景坐标）。
y（int）：新的 y（场景坐标）。

`set_x(x)`

设置本地坐标的 x 分量。

x（int）：新的 x，相对父对象。

`set_y(y)`

设置本地坐标的 y 分量。

y（int）：新的 y，相对父对象。

`show()`

显示对象，等同于设置 obj.visible = True。

事件

`on_clicked()`

在该对象上完成一次按下并释放。

`on_collision_enter(other)`

开始与 other 重叠（双方都需要开启碰撞）。

other（object）：另一个对象。

`on_collision_exit(other)`

与 other 的重叠结束。

other（object）：另一个对象。

`on_destroy()`

场景被替换、对象被 studio.destroy_object() 移除，或游戏退出时执行。

`on_double_clicked()`

双击该对象。

`on_drag(pos)`

拖动过程中鼠标移动。

pos（(int, int)）：指针位置（场景坐标）。

`on_drag_end()`

拖动结束。

`on_drag_start()`

在对象上开始拖动。

`on_mouse_enter()`

鼠标移入对象。

`on_mouse_leave()`

鼠标移出对象。

`on_pressed()`

在该对象上按下鼠标左键。

`on_released()`

在该对象上按下的按键被释放。

`on_right_clicked()`

右键点击该对象。

`on_start()`

场景加载完成后执行一次。

`on_update(dt)`

每帧执行。

dt（float）：距上一帧的秒数。

`on_visible_changed(visible)`

对象被显示或隐藏时。

visible（bool）：显示为 True，隐藏为 False。

文本

属性

angle

bold

collision_enabled

collision_offset_x、collision_offset_y

collision_points

collision_type

collision_width、collision_height

color

font_path

font_size

italic

name

physics_angular_damping

physics_elasticity

physics_enabled

physics_fixed_rotation

physics_friction

physics_gravity_scale

physics_linear_damping

physics_mass

physics_shape_height、physics_shape_width

physics_shape_offset_x、physics_shape_offset_y

physics_shape_points

physics_shape_type

physics_type

pivot

pivot_x、pivot_y

pos

scale

scale_x、scale_y

script_path

size

strikethrough

text

text_align

text_valign

type

underline

uuid

visible

width、height

x、y

方法

collides_with_object(other)

collides_with_point(x, y)

collides_with_rect(rect)

distance_to(x, y)

distance_to_object(other)

get_angle()

get_bold_state()

get_center()

get_collision_center()

get_collision_offset()

get_collision_polygon()

get_collision_radius()

get_collision_rect(x, y, width, height)

get_collision_size()

get_collision_type()

get_color()

get_direction_to(x, y)

get_font_path()

get_font_size()

get_height()

get_italic_state()

get_name()

get_pivot()

get_pivot_point()

get_pos()

get_rect()

get_scale()

get_scale_x()

get_scale_y()

get_size()

get_strikethrough_state()

get_text()

get_text_align()

get_text_size()

get_text_valign()