LibGDX_4.2: 演员（Actor）

本文链接: http://blog.csdn.net/xietansheng/article/details/50187069

LibGDX 基础教程（总目录）

1. 概述

演员（Actor）是 2D 场景中的基本图节点（元素）。一个演员实例拥有位置（position），矩形尺寸（rectangular size），缩放和旋转的支点（origin），缩放比（scale），旋转角度（rotation），在舞台中的绘制顺序（origin），颜色 / 透明度（color）等属性。

其中的位置（position）属性表示的是在没有旋转也没有缩放时的左下角（旋转和缩放不改变位置属性和尺寸属性本身的值，只是在最终绘制到屏幕上时才在视觉上表现出来），演员的位置相对于父节点（舞台/演员组），即表示的是在其父节点中的位置（因为演员通常作为子节点添加到舞台/演员组中使用），(0, 0) 点表示在舞台的左下角。

缩放和旋转的支点（origin）相对于位置（position）属性（即相对于演员的左下角），(0, 0) 点表示在演员的左下角。演员在旋转和缩放时以该点为中心旋转和缩放。

PS： 所有坐标或位置属性都是相对属性，没有相对的参考原点，坐标和位置没有任何意义。

position 和 origin 取值相对关系如下图所示：

2. 演员类（Actor）

演员类（Actor）直接继承自 Object 类，Actor 类封装了位置、尺寸、缩放比、旋转角度等属性，但没有纹理（Texture）属性，Actor 作为显示在游戏画面上的最基本节点，而 Texture 作为图片的基本表现形式，因此 Actor 类不能直接拿来使用，我们需要自定义一个 Actor 的子类（LibGDX本身也封装了许多子类，后续再介绍），并封装 Texture，然后在绘制的时候根据 Actor 类封装的各种属性将 Texture 经过变换绘制到屏幕上。

3. 与精灵（Sprite）的区别

Actor 也是代表游戏中最基本显示的元素， 和 Sprite 看似有点相似，两者都封装了位置、尺寸、缩放比、旋转角度等属性，但 Actor 与 Screen（场景），Stage（舞台） 属于整体框架或组成体系中的节点，三者关系紧密。Actor 能够处理动作，事件等复杂的游戏逻辑。Sprite 继承自 TextureRegion 更像是 Texture 的增强封装，更多时候仅表示一张内存中的图片。Actor 和 Sprite 可以相互结合各取其优点进行封装，从而更方便地进行游戏的开发。

4. 代码示例

自定义演员类：

package com.libgdx.test;

import com.badlogic.gdx.graphics.g2d.Batch;
import com.badlogic.gdx.graphics.g2d.TextureRegion;
import com.badlogic.gdx.scenes.scene2d.Actor;

/** * 自定义演员, 重写 act() 和 draw() 这两个方法 */
public class MyActor extends Actor {

    // 用于展示该演员的纹理区域
    private TextureRegion region;

    public MyActor(TextureRegion region) {
        super();
        this.region = region;

        // 将演员的宽高设置为纹理区域的宽高（必须设置, 否则宽高默认都为 0, 绘制后看不到）
        setSize(this.region.getRegionWidth(), this.region.getRegionHeight());

        // 也可以分开设置
        // setWidth(this.region.getRegionWidth());
        // setHeight(this.region.getRegionHeight());
    }

    public TextureRegion getRegion() {
        return region;
    }

    public void setRegion(TextureRegion region) {
        this.region = region;
        // 重新设置纹理区域后, 需要重新设置宽高
        setSize(this.region.getRegionWidth(), this.region.getRegionHeight());
    }

    /** * 演员的逻辑处理 * * @param delta * 表示从渲染上一帧开始到现在渲染当前帧的时间间隔, 或者称为渲染的 时间步 / 时间差。单位: 秒 */
    @Override
    public void act(float delta) {
        super.act(delta);
        // 现在这里一般没有什么逻辑要处理
    }

    /** * 绘制演员 * * @param batch * 纹理画布, 用于绘制演员封装的纹理。SpriteBatch 就是实现了 Batch 接口 * * @param parentAlpha * 父节点的透明度, 处理透明度和演员的颜色属性有关, 稍微复杂, 这里暂时先不处理 */
    @Override
    public void draw(Batch batch, float parentAlpha) {
        super.draw(batch, parentAlpha);

        // 如果 region 为 null 或者 演员不可见, 则直接不绘制
        if (region == null || !isVisible()) {
            return;
        }

        /* 这里选择一个较为复杂的绘制方法进行绘制 batch.draw( region, x, y, originX, originY, width, height, scaleX, scaleY, rotation );*/

        /* * 绘制纹理区域 * 将演员中的 位置(position, 即 X, Y 坐标), 缩放和旋转支点(origin), 宽高尺寸, 缩放比, 旋转角度 应用到绘制中, * 最终 batch 会将综合结果绘制到屏幕上 */
        batch.draw(
                region, 
                getX(), getY(), 
                getOriginX(), getOriginY(), 
                getWidth(), getHeight(), 
                getScaleX(), getScaleY(), 
                getRotation()
        );
    }

}

游戏主程序的启动入口类：

package com.libgdx.test;

import com.badlogic.gdx.ApplicationAdapter;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.graphics.GL20;
import com.badlogic.gdx.graphics.Texture;
import com.badlogic.gdx.graphics.g2d.SpriteBatch;
import com.badlogic.gdx.graphics.g2d.TextureRegion;

/** * 游戏主程序的启动入口类 */
public class MainGame extends ApplicationAdapter {

    // 纹理画布
    private SpriteBatch batch;

    // 纹理
    private Texture texture;

    // 自定义的演员
    private MyActor actor;

    @Override
    public void create() {
        // 创建纹理画布
        batch = new SpriteBatch();

        // 创建纹理, badlogic.jpg 图片的宽高为 256 * 256
        texture = new Texture(Gdx.files.internal("badlogic.jpg"));

        // 创建演员
        actor = new MyActor(new TextureRegion(texture));

        /* 设置演员属性的值 */

        // 设置演员的坐标
        actor.setPosition(50, 100);     // 或者 setX(), setY() 分开设置

        // 设置演员 旋转和缩放支点 为演员的左下角
        actor.setOrigin(0, 0);

        // 设置演员缩放比, X 轴方向缩小到 0.5 倍, Y 轴方向保持不变
        actor.setScale(0.5F, 1.0F);

        // 顺时针旋转 5 度
        actor.setRotation(-5);
    }

    @Override
    public void render() {
        // 黑色清屏
        Gdx.gl.glClearColor(0, 0, 0, 1);
        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);

        // 更新演员逻辑
        actor.act(Gdx.graphics.getDeltaTime());

        batch.begin();

        // 绘制演员（这里暂且先直接绘制, 位置相对于屏幕左下角）
        actor.draw(batch, 1.0F);

        batch.end();
    }

    @Override
    public void dispose() {
        // 当应用退出时释放资源
        if (batch != null) {
            batch.dispose();
        }
        // 应用退出, 纹理不在需要用到, 释放纹理资源
        if (texture != null) {
            texture.dispose();
        }
    }

}

运行结果：