LibGDX_3.3: 内存中的图片（Pixmap）

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

LibGDX 基础教程（总目录）

1. 概述

一个 Pixmap 代表内存中的一张图片，它支持加载现有的图片，有以像素为单位表示的宽高，并且每一个像素点有指定的颜色值。Pixmap 支持点、线、圆、矩形、三角形，以及将另一 Pixmap 绘制到当前 Pixmap 等基本图形图像的绘制操作，最后 Pixmap 需要加载为 Texture （纹理）才能绘制到屏幕上。Pixmap 的数据存储在本地堆内存中，一个 Pixmap 对象不再需要使用到时需要调用其 dispose() 方法释放资源的占用。

在 Pixmap 上绘制图形时的坐标原点为 Pixmap 的左上角，X轴正方向水平向左，Y轴正方向竖直向下。SpriteBatch 与 Pixmap 坐标关系如下所示：

2. 根据现有的一张图片创建 Pixmap 步骤

// 根据给定的图片创建一个 Pixmap 实例，创建后 图片“贴”在 pixmap 上， pixmap 宽高为图片的宽高
Pixmap pixmap = new Pixmap(Gdx.files.internal("badlogic.jpg"));

// 设置 pixmap 绘图颜色
pixmap.setColor(1, 0, 0, 1);

// 在 Pixmap 的 (128, 128) 坐标位置填充一个半径为 64 的圆
pixmap.fillCircle(128, 128, 64);

// 需要将 pixmap 绘制到屏幕上，需要将 pixmap 加载为纹理
Texture texture = new Texture(pixmap);

// pixmap 不再需要使用到时，释放占用的资源
pixmap.dispose();

3. 代码示例

游戏主程序的启动入口类, 创建空白的 Pixmap 并在上面绘制图片：

package com.libgdx.test;

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

/** * 游戏主程序的启动入口类, 创建空白的 Pixmap 并在上面绘制图片 */
public class MainGame extends ApplicationAdapter {

    private SpriteBatch batch;

    private Texture texture;

    private Pixmap pixmap;

    @Override
    public void create() {
        batch = new SpriteBatch();

        // 创建一个宽高都为 256, 像素点颜色值格式为 RGBA8888(每个像素颜色值占 4 个字节) 的 Pixmap
        pixmap = new Pixmap(256, 256, Pixmap.Format.RGBA8888);

        // 设置绘图颜色为白色
        pixmap.setColor(1, 1, 1, 1);
        // 将整个 pixmap 填充为当前设置的颜色
        pixmap.fill();

        // 设置绘图颜色为红色
        pixmap.setColor(1, 0, 0, 1);
        // 画一个空心圆
        pixmap.drawCircle(64, 64, 32);

        // 设置绘图颜色为绿色
        pixmap.setColor(Color.GREEN);
        // 画一条线段, 线段两点为 (0, 0) 到 (256, 128)
        pixmap.drawLine(0, 0, 256, 128);

        // 设置绘图颜色为蓝色
        pixmap.setColor(Color.BLUE);
        // 画一个矩形, 矩形左上角坐标(128, 128), 宽高均为64
        pixmap.drawRectangle(128, 128, 64, 64);

        // 设置绘图颜色为黄色
        pixmap.setColor(Color.YELLOW);
        // 填充一个三角形, 三点(0, 256), (0, 128), (128, 128)
        pixmap.fillTriangle(0, 256, 0, 128, 128, 128);

        // pixmap 处理完成后转换成纹理
        texture = new Texture(pixmap);

        // pixmap 已不再需要用到, 释放资源
        pixmap.dispose();
    }

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

        batch.begin();

        // 在屏幕左下角绘制纹理
        batch.draw(texture, 0, 0);

        batch.end();
    }

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

}

创建平台启动器，并运行：