游戏对象组件

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

混合系统

Phaser 使用 Phaser.Class 和 Mixins 数组从可重用的组件对象组成游戏对象。每个组件都是一个普通的 JS 对象,其属性和方法被复制到类原型上。这不是原型继承——它是类定义时的属性复制。

关键规则

组件在类创建时混合,而不是在每个实例中混合。大多数 setter 方法返回 this 进行链接:sprite.setAlpha(0.5).setDepth(10).setPosition(100, 200)。许多属性在内部使用 getter/setter(例如,alpha、depth、visible、scale、rotation)。设置 alpha = 0 或 scale = 0 会清除渲染标志,跳过渲染。 renderFlags 是一个位掩码:位 0 = 可见,位 1 = Alpha,位 2 = 缩放,位 3 = 纹理。必须设置所有位才能渲染对象。

阿尔法

提供每个角的透明度。由 Sprite、图像、文本和大多数可渲染对象使用。成员·类型·描述alpha·数字(获取/设置)·全局alpha 0-1。设置此项也会设置所有四个角。设置为 0 将禁用渲染。默认值: 1 alphaTopLeft · 数字(获取/设置) · 左上角 alpha。仅限 WebGL。 alphaTopRight · 数字(获取/设置) · 右上角 alpha。仅限 WebGL。

阿尔法单机

简化的 alpha,没有每个角的支持。由容器使用。成员·类型·描述alpha·数字(获取/设置)·Alpha 0-1。默认值:1``setAlpha(value?)·方法·设置alpha。返回this。 clearAlpha() · 方法 · 将 alpha 重置为 1。返回 this。

混合模式

控制渲染期间像素的合成方式。成员·类型·描述blendMode·数字/字符串(获取/设置)·当前混合模式。接受 Phaser.BlendModes const、字符串或整数。 setBlendMode(value) · 方法 · 设置混合模式。返回this。 WebGL 混合模式:NORMAL、ADD、MULTIPLY、SCREEN、ERASE。 Canvas 支持其他依赖于浏览器的模式。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@phaserjs · 未声明许可证
上下文用量评级
中等消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 game-object-components.preview
// Every Game Object gets its component methods via mixins.
// Just call them directly on any game object:
const sprite = this.add.sprite(400, 300, 'hero');

sprite.setAlpha(0.5);                          // Alpha
sprite.setBlendMode(Phaser.BlendModes.ADD);    // BlendMode
sprite.setDepth(10);                           // Depth
sprite.setFlip(true, false);                   // Flip
sprite.setOrigin(0, 0);                        // Origin
sprite.setScrollFactor(0);                     // ScrollFactor (HUD)
sprite.setDisplaySize(64, 64);                 // Size
sprite.setTexture('hero', 'walk-1');           // Texture
sprite.setTint(0xff0000);                      // Tint
sprite.setPosition(100, 200);                  // Transform
sprite.setVisible(false);                      // Visible
sprite.setScale(2);                            // Transform
sprite.setAngle(45);                           // Transform

// Per-corner alpha (WebGL only)
sprite.setAlpha(1, 0.5, 0.5, 1);

// Crop a texture region
sprite.setCrop(0, 0, 32, 32);

// Enable WebGL filters (post-processing)
sprite.enableFilters();
sprite.filters.internal.addBlur(1, 2, 2, 1);

// Lighting (WebGL only, v4 feature)
sprite.setLighting(true);

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。