LibGdx----scene2d

scene2d

  scene2d package是一个2D场景图结构,用来管理场景中的actors组。它能处理用户输入,并在相对于父actor的坐标系统中进行旋转和缩放。它还提供一个刷新actors的框架。scene2d.ui package对建立GUI很有用。

Important classes

  Stage类有一个名为"root"的group(组),可以向其中添加actors。Stage有一个camera和一个SpriteBatch。camera的viewport尺寸与屏幕相同。当需要绘制Stage时,SpriteBatch就作为参数传递给root组。

  Group类派生自Actor类,其实就是一个包含其他actors的Actor。对Group的旋转和缩放操作同时影响它的chidren。Group负责把绘制操作和用户输入分配给合适的children。

  Actor类提供场景结点(node)所需的全部基本函数,包含position, size, scale, rotation, origin, color这些属性,有一个可选的name,可以在debug模式下显示整个actor树形结构。

Stage setup

  Stage类有一个viewport size的属性,该属性可以在构造函数里初始化,但最好还是在程序的resized事件中设置该属性。构造函数中还有一个名为"stretch"的参数,如果它为true,就算Stage的viewportsize和屏幕分辨率不同,stage也会被拉伸到屏幕分辨率。如果为false,stage的viewportsize中较大的那个维度会放大到和屏幕分辨率一样。如果在resized事件中把viewport size设置成和屏幕一样,则stretch值就无关紧要了。

  Stage有一个"act"函数,输入参数包括两帧的间隔时间,可以使场景中所有actor都调用各自的act()函数。

private Stage stage;

public void create () {
        stage = new Stage(0, 0, true);
}

public void resize (int width, int height) {
        stage.setViewport(width, height, true);
}

public void render () {
        Gdx.gl.glClear(GL10.GL_COLOR_BUFFER_BIT);
        stage.act(Gdx.graphics.getDeltaTime());
        stage.draw();
}

public void dispose() {
        stage.dispose();
}

Actor

  请创建Actor的派生类来实现绘制、碰撞检测、处理用户输入等工作。

Drawing

  当Stage::draw()函数被调用时,它会调用root group,然后root再调用它的所有children。要绘制actor,需要实现它的draw函数:

TextureRegion region;

public void draw (SpriteBatch batch, float parentAlpha) {
        batch.setColor(1, 1, 1, parentAlpha);
        batch.draw(region, x, y, width, height);
}
  actor::draw函数里收到的SpriteBatch已经被转换过了,所以actor的position, size, rotation, scale属性都是相对于父group的左下角的。这使绘制操作变得很简单。在上面的代码中,x,y,width,height都是Actor类的public属性。

  如果actor的visible属性被设置为false,Group就不会调用该actor的draw()函数。

  draw()函数里的parentAlpha参数是该actor的parent的alpha值。如果draw函数使用了透明度,那么整个group和它的所有children都会变得透明。

  SpriteBatch::begin()在actor::draw()函数被调用前就已经调用过了。如果一个actor需要用其他方式来绘制,比如使用ShapeRenderer,好么batch应该先end()并在绘制结束后再begin()。当然,这样会使得batch被重置,所以应该谨慎使用,具体使用方法如下:

private ShapeRenderer renderer;

public void draw (SpriteBatch batch, float parentAlpha) {
        batch.end();

        renderer.setProjectionMatrix(batch.getProjectionMatrix());
        renderer.setTransformMatrix(batch.getTransformMatrix());
        renderer.translate(x, y, 0);

        renderer.begin(ShapeType.Rectangle);
        renderer.rect(0, 0, width, height);
        renderer.end();

        batch.begin();
}

Hit detection

  当Stage::hit()被调用时,它会调用root group,然后root再调用所有children。第一个返回非null值的actor将被stage返回。要进行碰撞检测,需要实现下面的函数:

public Actor hit (float x, float y) {
        return x > 0 && x < width && y > 0 && y < height ? this : null;
}
  函数中用到的坐标都是actor的局部坐标系的。

Input handling

  要想触发手机屏幕的用户输入,需要实现touchDown, touchDragged, touchUp函数。

public boolean touchDown (float x, float y, int pointer) {
        return true;
}

public void touchDragged (float x, float y, int pointer) {
}

public void touchUp (float x, float y, int pointer) {
}
  当stage::touchDown被触发时,它调用root group。root group会先调用所有children的hit()函数,然后由第一个被hit()函数返回的actor调用touchDown函数。如果touchDown返回false,表示该actor忽略touch down事件,所以group会继续调用hit(),并由被hit到的actor调用touchDown。如果touchDown()返回true,则该actor成为group的focused actor(焦点),这意味着该actor可以接收到touchDragged和touchUp事件,即使它们并没有在该actor上发生(它们会接收到事件,但如果不在它们身上发生,就可以选择忽略)。如果touchUp被调用(一旦touchDown已经触发,touchUp就一定会触发),该actor就失去焦点。

  如果actor的touchable属性设置为false,则Group不会触发它的touch事件。

Actions

  当前的action系统马上就会进行重构,到时候再写。


你可能感兴趣的:(null,buffer,input,action,float,actor)