PythonIDE Docs
中文
简体中文

scene API 索引

按生命周期、节点、Action、Physics、Classic 绘图与常量查 scene 公开名称。

按生命周期、节点、Action、Physics、Classic 绘图与常量快速查找 scene 公开名称。

精确签名以 scene API 参考运行时/scene类型存根 为准。

#最小入口

python
import scene


class DemoScene(scene.Scene):
    def setup(self):
        self.background_color = "black"

    def draw(self):
        scene.fill(1, 1, 1)
        scene.text("scene", x=self.size.w / 2, y=self.size.h / 2, font_size=24)


scene.run(DemoScene())

#先看哪一类

你要做什么先看
启动与关闭场景runScene.setupScene.stop(关闭回调)
每帧逻辑updatedttframe_count
精灵 / 文字 / 形状SpriteNodeLabelNodeShapeNodeTexture
动画Action.move_toAction.sequenceAction.repeat_forever
触摸touch_beganTouch.location
碰撞PhysicsBodycontact_beganContact
Classic 画布backgroundfillrectellipselinetext
屏幕与安全区get_screen_sizeget_safe_area_insets
模态场景present_modal_scenedismiss_modal_scene

#索引

#模块函数

名称说明
run运行 Scene 子类(阻塞至关闭)
get_screen_size屏幕尺寸 → Size
get_screen_scale屏幕缩放因子
get_safe_area_insets安全区 → EdgeInsets
gravity设备重力向量 → Vector3
play_effect播放系统音效
get_image_path解析内置图片路径
get_controllers已连接游戏手柄列表

#Classic 绘图

名称说明
background清屏背景色
fill / no_fill填充色
stroke / no_stroke / stroke_weight描边
tint / no_tint着色
rect / ellipse / line基础图形
image / text图片与文字
translate / rotate / scale变换
push_matrix / pop_matrix矩阵栈
blend_mode / use_shader混合与着色器
load_image / load_image_file / load_pil_image / unload_image图片资源
render_text预渲染文字纹理
image_quad ⚠️未实现
triangle_strip ⚠️未实现

#几何与输入

名称说明
Point / Size / Rect / Vector2 / Vector3几何类型
EdgeInsets安全区内边距
Touchlocationprev_locationtouch_id
Contact物理碰撞回调:node_anode_bcontact_point

#

名称说明
Scene场景基类
SceneView嵌入式场景视图(高级)
Node节点基类
SpriteNode精灵
LabelNode文字
ShapeNode矢量路径
EffectNode特效节点
EmitterNode粒子发射器
Texture纹理
Shader自定义着色器
Action动作工厂
PhysicsWorld / PhysicsBody物理
PinJoint / SpringJoint / RopeJoint关节约束

#Scene 生命周期方法

setupupdatedrawdid_evaluate_actionstouch_begantouch_movedtouch_endeddid_change_sizecontroller_changedcontact_beganpresent_modal_scenedismiss_modal_scenepauseresumestop

#Scene 常用属性

sizeboundsbackground_colorchildrenphysics_worldsafe_area_insetsdttframe_counttoucheseffects_enabledcrop_rectviewpresented_scenepresenting_scene

#Action 静态方法

move_tomove_byrotate_torotate_byscale_toscale_byscale_x_toscale_y_tofade_tofade_bysequencegrouprepeatrepeat_foreverwaitremovecallset_uniform

#常量

分组名称
方向DEFAULT_ORIENTATIONPORTRAITLANDSCAPE
混合BLEND_NORMALBLEND_ADDBLEND_MULTIPLY
纹理过滤FILTERING_LINEARFILTERING_NEAREST
缓动TIMING_LINEARTIMING_EASE_INTIMING_EASE_OUTTIMING_EASE_IN_OUTTIMING_SINODIALTIMING_BOUNCE_*TIMING_ELASTIC_*TIMING_EASE_BACK_*

#相关文档

文档用途
scene 概览教程、可运行示例、常见错误
scene API 参考构造函数与参数详解

#失败路径

情况处理
权限被拒绝在设置中开启权限后,从用户触发的回调重试
设备或能力不可用先检查返回值或 is_available(),再给用户可读提示
用户取消保留当前界面状态,不要当作成功继续流程
参数或 API 名错误对照模块 API 参考与 schema,修正后再运行

#预期效果

运行示例后,界面应出现文档描述的目标结果;若与预期不符,请按「失败路径」排查。