LibGDX_3.4: 纹理区域（TextureRegion）

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

LibGDX 基础教程（总目录）

1. 概述

TextureRegion（纹理区域） 表示 Texture（纹理）的一部分矩形区域（当然也可以表示整个 Texture 区域），可以用来绘制纹理中的一部分显示在屏幕上。TextureRegion 可以通过记录 Texture 中的一个 坐标起点 和 从这个起点开始截取的宽高 来表示 Texture 的一部分。

TextureRegion 描述 Texture 区域时的 坐标点 是相对于 Texture 的左上角原点，关系如下图所示：

2. 代码示例

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

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 TextureRegion region;
	
	@Override
	public void create() {
		batch = new SpriteBatch();
		
		// 创建纹理, badlogic.jpg 图片的宽高为 256 * 256
		texture = new Texture(Gdx.files.internal("badlogic.jpg"));
		
		// 创建纹理区域, region 表示在 texture 中 坐标 (0, 0) 为起点, 宽高均为 128 的矩形区域（即为图片 1/4 的左上角部分）
		region = new TextureRegion(texture, 0, 0, 128, 128);
	}

	@Override
	public void render() {
		// 黑色清屏
		Gdx.gl.glClearColor(0, 0, 0, 1);
		Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
		
		batch.begin();
		
		/*
		 * 这次在屏幕左上角绘制纹理区域,
		 * SpriteBatch 绘制时参考屏幕左下角为原点, Texture 左下角为绘制起点,
		 * 所以让 region 刚好出现在左上角, 则 batch 绘制开始坐标为 (0, 屏幕高度 - region 高度),
		 * Gdx.graphics.getHeight()表示屏幕的原始像素高度。
		 */
		batch.draw(
				region, 		// 需要绘制的 region
				0, 				// region 左下角在屏幕中的 X 轴坐标
				Gdx.graphics.getHeight() - region.getRegionHeight()	// region 左下角在屏幕中的 Y 轴坐标
		);
		
		batch.end();
	}

	@Override
	public void dispose() {
		// 当应用退出时释放资源
		if (batch != null) {
			batch.dispose();
		}

		/*
		 * 这里只需要释放 texture 资源, region 没有 dispose() 方法, 不需要销毁 region,
		 * 因为 region 只是通过参数描述了 texture 的一部分区域, texture 才是最终真正实体资源,
		 * texture 销毁后, region 不能再使用, 因为 region 是依赖 texture 存在的。
		 */
		if (texture != null) {
			texture.dispose();
		}
	}

}

运行结果：

---