mirror of
https://github.com/motajs/template.git
synced 2026-11-17 01:24:30 +08:00
feat: 将 HumanBreak 新内容移植入该样板
This commit is contained in:
1 parent
6bf32174d8
commit
bea2725d6a
128 files changed
+11984
-573
No files matched your search
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"name": "@motajs/render-assets",
|
||||
"dependencies": {
|
||||
"@motajs/client-base": "workspace:*"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,134 @@
|
||||
import { ITexture, ITextureAnimater, ITextureRenderable } from './types';
|
||||
|
||||
/**
|
||||
* 行动画控制器,将贴图按照从上到下的顺序依次组成帧动画,动画传入的参数代表帧数
|
||||
*/
|
||||
export class TextureRowAnimater implements ITextureAnimater<number> {
|
||||
*once(texture: ITexture, frames: number): Generator<ITextureRenderable> {
|
||||
if (frames <= 0) return;
|
||||
const renderable = texture.render();
|
||||
const { x: ox, y: oy } = renderable.rect;
|
||||
const { width: w, height } = texture!;
|
||||
const h = height / frames;
|
||||
for (let i = 0; i < frames; i++) {
|
||||
const renderable: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect({ x: i * w + ox, y: oy, w, h })
|
||||
};
|
||||
yield renderable;
|
||||
}
|
||||
}
|
||||
|
||||
*cycled(texture: ITexture, frames: number): Generator<ITextureRenderable> {
|
||||
if (frames <= 0) return;
|
||||
const renderable = texture.render();
|
||||
const { x: ox, y: oy } = renderable.rect;
|
||||
const { width: w, height } = texture;
|
||||
const h = height / frames;
|
||||
let i = 0;
|
||||
while (true) {
|
||||
const renderable: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect({ x: i * w + ox, y: oy, w, h })
|
||||
};
|
||||
yield renderable;
|
||||
i++;
|
||||
if (i === frames) i = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 列动画控制器,将贴图按照从左到右的顺序依次组成帧动画,动画传入的参数代表帧数
|
||||
*/
|
||||
export class TextureColumnAnimater implements ITextureAnimater<number> {
|
||||
*once(texture: ITexture, frames: number): Generator<ITextureRenderable> {
|
||||
if (frames <= 0) return;
|
||||
const renderable = texture.render();
|
||||
const { x: ox, y: oy, w: width, h } = renderable.rect;
|
||||
const w = width / frames;
|
||||
for (let i = 0; i < frames; i++) {
|
||||
const renderable: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect({ x: i * w + ox, y: oy, w, h })
|
||||
};
|
||||
yield renderable;
|
||||
}
|
||||
}
|
||||
|
||||
*cycled(texture: ITexture, frames: number): Generator<ITextureRenderable> {
|
||||
if (frames <= 0) return null;
|
||||
const renderable = texture.render();
|
||||
const { x: ox, y: oy } = renderable.rect;
|
||||
const { width, height: h } = texture;
|
||||
const w = width / frames;
|
||||
let i = 0;
|
||||
while (true) {
|
||||
const renderable: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect({ x: i * w + ox, y: oy, w, h })
|
||||
};
|
||||
yield renderable;
|
||||
i++;
|
||||
if (i === frames) i = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export interface IScanAnimaterData {
|
||||
/** 每帧的宽度 */
|
||||
readonly width: number;
|
||||
/** 每帧的高度 */
|
||||
readonly height: number;
|
||||
/** 总帧数 */
|
||||
readonly frames: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* 扫描动画控制器,会按照先从左到右,再从上到下的顺序依次输出,可以用于动画精灵图等
|
||||
*/
|
||||
export class TextureScanAnimater
|
||||
implements ITextureAnimater<IScanAnimaterData>
|
||||
{
|
||||
*once(
|
||||
texture: ITexture,
|
||||
data: IScanAnimaterData
|
||||
): Generator<ITextureRenderable, void> {
|
||||
const w = texture.width;
|
||||
const h = texture.height;
|
||||
|
||||
let frame = 0;
|
||||
for (let y = 0; y < data.width; y++) {
|
||||
for (let x = 0; x < data.height; x++) {
|
||||
const renderable: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect({ x: x * w, y: y * h, w, h })
|
||||
};
|
||||
yield renderable;
|
||||
frame++;
|
||||
if (frame === data.frames) break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
*cycled(
|
||||
texture: ITexture,
|
||||
data: IScanAnimaterData
|
||||
): Generator<ITextureRenderable, void> {
|
||||
const w = texture.width;
|
||||
const h = texture.height;
|
||||
|
||||
let index = 0;
|
||||
while (true) {
|
||||
const x = index % data.width;
|
||||
const y = Math.floor(index / data.height);
|
||||
const renderable: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect({ x: x * w, y: y * h, w, h })
|
||||
};
|
||||
yield renderable;
|
||||
index++;
|
||||
if (index === data.frames) index = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,451 @@
|
||||
import {
|
||||
IOption,
|
||||
IRectangle,
|
||||
MaxRectsPacker,
|
||||
Rectangle
|
||||
} from 'maxrects-packer';
|
||||
import { Texture } from './texture';
|
||||
import {
|
||||
IRect,
|
||||
ITexture,
|
||||
ITextureComposedData,
|
||||
ITextureComposer,
|
||||
SizedCanvasImageSource
|
||||
} from './types';
|
||||
import vert from './shader/pack.vert?raw';
|
||||
import frag from './shader/pack.frag?raw';
|
||||
import { logger } from '@motajs/common';
|
||||
import { isNil } from 'lodash-es';
|
||||
import { compileProgramWith } from '@motajs/client-base';
|
||||
|
||||
interface IndexMarkedComposedData {
|
||||
/** 组合数据 */
|
||||
readonly asset: ITextureComposedData;
|
||||
/** 组合时最后一个用到的贴图的索引 */
|
||||
readonly index: number;
|
||||
}
|
||||
|
||||
export interface IGridComposerData {
|
||||
/** 单个贴图的宽度,与之不同的贴图将会被剔除并警告 */
|
||||
readonly width: number;
|
||||
/** 单个贴图的宽度,与之不同的贴图将会被剔除并警告 */
|
||||
readonly height: number;
|
||||
}
|
||||
|
||||
export class TextureGridComposer
|
||||
implements ITextureComposer<IGridComposerData>
|
||||
{
|
||||
/**
|
||||
* 网格组合器,将等大小的贴图组合成图集,要求每个贴图的尺寸一致。
|
||||
* 组合时按照先从左到右,再从上到下的顺序组合。
|
||||
* @param maxWidth 图集最大宽度,也是输出纹理的宽度
|
||||
* @param maxHeight 图集最大高度,也是输出纹理的高度
|
||||
*/
|
||||
constructor(
|
||||
readonly maxWidth: number,
|
||||
readonly maxHeight: number
|
||||
) {}
|
||||
|
||||
private nextAsset(
|
||||
tex: ITexture[],
|
||||
start: number,
|
||||
data: IGridComposerData,
|
||||
rows: number,
|
||||
cols: number,
|
||||
index: number
|
||||
): IndexMarkedComposedData {
|
||||
const canvas = document.createElement('canvas');
|
||||
const ctx = canvas.getContext('2d')!;
|
||||
canvas.width = this.maxWidth;
|
||||
canvas.height = this.maxHeight;
|
||||
|
||||
const count = Math.min(rows * cols, tex.length - start);
|
||||
const map = new Map<ITexture, IRect>();
|
||||
|
||||
let x = 0;
|
||||
let y = 0;
|
||||
for (let i = 0; i < count; i++) {
|
||||
const dx = x * data.width;
|
||||
const dy = y * data.height;
|
||||
const texture = tex[i + start];
|
||||
const renderable = texture.render();
|
||||
const { x: sx, y: sy, w: sw, h: sh } = renderable.rect;
|
||||
ctx.drawImage(renderable.source, sx, sy, sw, sh, dx, dy, sw, sh);
|
||||
map.set(texture, { x: dx, y: dy, w: sw, h: sh });
|
||||
x++;
|
||||
if (x === cols) {
|
||||
y++;
|
||||
x = 0;
|
||||
}
|
||||
}
|
||||
|
||||
const texture = new Texture(canvas);
|
||||
const composed: ITextureComposedData = {
|
||||
index,
|
||||
texture,
|
||||
assetMap: map
|
||||
};
|
||||
|
||||
return { asset: composed, index: start + count };
|
||||
}
|
||||
|
||||
*compose(
|
||||
input: Iterable<ITexture>,
|
||||
data: IGridComposerData
|
||||
): Generator<ITextureComposedData, void> {
|
||||
const arr = [...input];
|
||||
|
||||
const rows = Math.floor(this.maxWidth / data.width);
|
||||
const cols = Math.floor(this.maxHeight / data.height);
|
||||
|
||||
let arrindex = 0;
|
||||
let i = 0;
|
||||
|
||||
while (arrindex < arr.length) {
|
||||
const res = this.nextAsset(arr, arrindex, data, rows, cols, i);
|
||||
arrindex = res.index + 1;
|
||||
i++;
|
||||
yield res.asset;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export interface IMaxRectsComposerData extends IOption {
|
||||
/** 贴图之间的间距 */
|
||||
readonly padding: number;
|
||||
}
|
||||
|
||||
interface MaxRectsRectangle extends IRectangle {
|
||||
/** 这个矩形对应的贴图对象 */
|
||||
readonly data: ITexture;
|
||||
}
|
||||
|
||||
export class TextureMaxRectsComposer
|
||||
implements ITextureComposer<IMaxRectsComposerData>
|
||||
{
|
||||
/**
|
||||
* 使用 Max Rects 算法执行贴图整合,输入数据参考 {@link IMaxRectsComposerData},
|
||||
* 输出的纹理的图像源将会是不同的画布,注意与 {@link TextureMaxRectsWebGL2Composer} 区分
|
||||
* @param maxWidth 图集最大宽度,也是输出纹理的宽度
|
||||
* @param maxHeight 图集最大高度,也是输出纹理的高度
|
||||
*/
|
||||
constructor(
|
||||
public readonly maxWidth: number,
|
||||
public readonly maxHeight: number
|
||||
) {}
|
||||
|
||||
*compose(
|
||||
input: Iterable<ITexture>,
|
||||
data: IMaxRectsComposerData
|
||||
): Generator<ITextureComposedData, void> {
|
||||
const packer = new MaxRectsPacker<MaxRectsRectangle>(
|
||||
this.maxWidth,
|
||||
this.maxHeight,
|
||||
data.padding,
|
||||
data
|
||||
);
|
||||
const arr = [...input];
|
||||
const rects = arr.map<MaxRectsRectangle>(v => {
|
||||
const rect = v.render().rect;
|
||||
const toPack = new Rectangle(rect.w, rect.h);
|
||||
toPack.data = v;
|
||||
return toPack;
|
||||
});
|
||||
packer.addArray(rects);
|
||||
|
||||
let index = 0;
|
||||
for (const bin of packer.bins) {
|
||||
const map = new Map<ITexture, IRect>();
|
||||
const canvas = document.createElement('canvas');
|
||||
const ctx = canvas.getContext('2d')!;
|
||||
canvas.width = this.maxWidth;
|
||||
canvas.height = this.maxHeight;
|
||||
ctx.imageSmoothingEnabled = false;
|
||||
bin.rects.forEach(v => {
|
||||
const rect: IRect = { x: v.x, y: v.y, w: v.width, h: v.height };
|
||||
map.set(v.data, rect);
|
||||
const renderable = v.data.render();
|
||||
const { x, y, w, h } = renderable.rect;
|
||||
const source = renderable.source;
|
||||
ctx.drawImage(source, x, y, w, h, v.x, v.y, v.width, v.height);
|
||||
});
|
||||
const texture = new Texture(canvas);
|
||||
const data: ITextureComposedData = {
|
||||
index: index++,
|
||||
texture,
|
||||
assetMap: map
|
||||
};
|
||||
yield data;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
interface RectProcessed {
|
||||
/** 贴图位置映射 */
|
||||
readonly texMap: Map<ITexture, Readonly<IRect>>;
|
||||
/** 顶点数组 */
|
||||
readonly attrib: Float32Array;
|
||||
}
|
||||
|
||||
export class TextureMaxRectsWebGL2Composer
|
||||
implements ITextureComposer<IMaxRectsComposerData>
|
||||
{
|
||||
/** 使用的画布 */
|
||||
readonly canvas: HTMLCanvasElement;
|
||||
/** 画布上下文 */
|
||||
readonly gl: WebGL2RenderingContext;
|
||||
/** WebGL2 程序 */
|
||||
readonly program: WebGLProgram;
|
||||
/** 顶点数组缓冲区 */
|
||||
readonly vertBuffer: WebGLBuffer;
|
||||
/** 纹理数组对象 */
|
||||
readonly texArray: WebGLTexture;
|
||||
/** 纹理数组对象的位置 */
|
||||
readonly texArrayPos: WebGLUniformLocation;
|
||||
/** `a_position` 的索引 */
|
||||
readonly posPos: number;
|
||||
/** `a_texCoord` 的索引 */
|
||||
readonly texPos: number;
|
||||
|
||||
/** 本次处理的贴图宽度 */
|
||||
private opWidth: number = 0;
|
||||
/** 本次处理的贴图高度 */
|
||||
private opHeight: number = 0;
|
||||
|
||||
/**
|
||||
* 使用 Max Rects 算法执行贴图整合,使用 WebGL2 执行组合操作。
|
||||
* 输入数据参考 {@link IMaxRectsComposerData},要求每个贴图的图像源尺寸一致,贴图大小可以不同。
|
||||
* 注意,本组合器同时只能处理一个组合操作,上一个没执行完的时候再次调用 `compose` 会出现问题。
|
||||
* 所有输出的内容中,贴图对象的图像源都是同一个画布,因此获取后要么直接使用,要么立刻调用 `toBitmap`,
|
||||
* 否则在下一次调用 `next` 时,图像源将会被覆盖。
|
||||
* @param maxWidth 图集最大宽度,也是输出纹理的宽度
|
||||
* @param maxHeight 图集最大高度,也是输出纹理的高度
|
||||
*/
|
||||
constructor(
|
||||
public readonly maxWidth: number,
|
||||
public readonly maxHeight: number
|
||||
) {
|
||||
this.canvas = document.createElement('canvas');
|
||||
this.canvas.width = maxWidth;
|
||||
this.canvas.height = maxHeight;
|
||||
this.gl = this.canvas.getContext('webgl2')!;
|
||||
const { program } = compileProgramWith(this.gl, vert, frag)!;
|
||||
this.program = program;
|
||||
|
||||
// 初始化画布数据
|
||||
|
||||
const texture = this.gl.createTexture();
|
||||
this.texArray = texture;
|
||||
const location = this.gl.getUniformLocation(program, 'u_textArray')!;
|
||||
this.texArrayPos = location;
|
||||
|
||||
this.posPos = this.gl.getAttribLocation(program, 'a_position');
|
||||
this.texPos = this.gl.getAttribLocation(program, 'a_texCoord');
|
||||
|
||||
this.vertBuffer = this.gl.createBuffer();
|
||||
|
||||
this.gl.useProgram(program);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对贴图进行索引
|
||||
* @param textures 贴图数组
|
||||
*/
|
||||
private mapTextures(
|
||||
textures: ITexture[]
|
||||
): Map<SizedCanvasImageSource, number> {
|
||||
const map = new Map<SizedCanvasImageSource, number>();
|
||||
const { width, height } = textures[0].source;
|
||||
|
||||
textures.forEach(v => {
|
||||
const source = v.source;
|
||||
if (map.has(source)) return;
|
||||
if (source.width !== width || source.height !== height) {
|
||||
logger.warn(73);
|
||||
return;
|
||||
}
|
||||
map.set(source, map.size);
|
||||
});
|
||||
|
||||
this.opWidth = width;
|
||||
this.opHeight = height;
|
||||
|
||||
return map;
|
||||
}
|
||||
|
||||
/**
|
||||
* 传递贴图
|
||||
* @param texMap 纹理映射
|
||||
*/
|
||||
private setTexture(texMap: Map<SizedCanvasImageSource, number>) {
|
||||
const gl = this.gl;
|
||||
gl.bindTexture(gl.TEXTURE_2D_ARRAY, this.texArray);
|
||||
|
||||
gl.texStorage3D(
|
||||
gl.TEXTURE_2D_ARRAY,
|
||||
1,
|
||||
gl.RGBA8,
|
||||
this.opWidth,
|
||||
this.opHeight,
|
||||
texMap.size
|
||||
);
|
||||
texMap.forEach((index, source) => {
|
||||
gl.texSubImage3D(
|
||||
gl.TEXTURE_2D_ARRAY,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
index,
|
||||
this.opWidth,
|
||||
this.opHeight,
|
||||
1,
|
||||
gl.RGBA,
|
||||
gl.UNSIGNED_BYTE,
|
||||
source
|
||||
);
|
||||
});
|
||||
|
||||
gl.texParameteri(
|
||||
gl.TEXTURE_2D_ARRAY,
|
||||
gl.TEXTURE_MAG_FILTER,
|
||||
gl.NEAREST
|
||||
);
|
||||
gl.texParameteri(
|
||||
gl.TEXTURE_2D_ARRAY,
|
||||
gl.TEXTURE_MIN_FILTER,
|
||||
gl.NEAREST
|
||||
);
|
||||
gl.texParameteri(
|
||||
gl.TEXTURE_2D_ARRAY,
|
||||
gl.TEXTURE_WRAP_S,
|
||||
gl.CLAMP_TO_EDGE
|
||||
);
|
||||
gl.texParameteri(
|
||||
gl.TEXTURE_2D_ARRAY,
|
||||
gl.TEXTURE_WRAP_T,
|
||||
gl.CLAMP_TO_EDGE
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 处理矩形数组,生成 WebGL2 顶点数据
|
||||
* @param rects 要处理的矩形数组
|
||||
* @param texMap 贴图到贴图数组索引的映射
|
||||
*/
|
||||
private processRects(
|
||||
rects: MaxRectsRectangle[],
|
||||
texMap: Map<SizedCanvasImageSource, number>
|
||||
): RectProcessed {
|
||||
const { width: ow, height: oh } = this.canvas;
|
||||
const map = new Map<ITexture, IRect>();
|
||||
const attrib = new Float32Array(rects.length * 5 * 6);
|
||||
rects.forEach((v, i) => {
|
||||
const rect: IRect = { x: v.x, y: v.y, w: v.width, h: v.height };
|
||||
map.set(v.data, rect);
|
||||
const renderable = v.data.render();
|
||||
const { width: tw, height: th } = v.data.source;
|
||||
const { x, y, w, h } = renderable.rect;
|
||||
// 画到目标画布上的位置
|
||||
const ol = (v.x / ow) * 2 - 1;
|
||||
const ob = (v.y / oh) * 2 - 1;
|
||||
const or = ((v.x + v.width) / ow) * 2 - 1;
|
||||
const ot = ((v.y + v.height) / oh) * 2 - 1;
|
||||
// 原始贴图位置
|
||||
const tl = x / tw;
|
||||
const tt = y / tw;
|
||||
const tr = (x + w) / tw;
|
||||
const tb = (y + h) / th;
|
||||
// 贴图索引
|
||||
const ti = texMap.get(v.data.source);
|
||||
|
||||
if (isNil(ti)) return;
|
||||
|
||||
// Benchmark https://www.measurethat.net/Benchmarks/Show/35246/2/different-method-to-write-a-typedarray
|
||||
|
||||
// prettier-ignore
|
||||
const data = [
|
||||
// x y u v i
|
||||
ol, -ot, tl, tt, ti, // 左上角
|
||||
ol, -ob, tl, tb, ti, // 左下角
|
||||
or, -ot, tr, tt, ti, // 右上角
|
||||
or, -ot, tr, tt, ti, // 右上角
|
||||
ol, -ob, tl, tb, ti, // 左下角
|
||||
or, -ob, tr, tb, ti // 右下角
|
||||
];
|
||||
|
||||
attrib.set(data, i * 30);
|
||||
});
|
||||
|
||||
const data: RectProcessed = {
|
||||
texMap: map,
|
||||
attrib
|
||||
};
|
||||
return data;
|
||||
}
|
||||
|
||||
/**
|
||||
* 执行渲染操作
|
||||
* @param attrib 顶点数组
|
||||
*/
|
||||
private renderAtlas(attrib: Float32Array) {
|
||||
const gl = this.gl;
|
||||
|
||||
gl.clearColor(0, 0, 0, 0);
|
||||
gl.clearDepth(1);
|
||||
gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);
|
||||
|
||||
gl.bindBuffer(gl.ARRAY_BUFFER, this.vertBuffer);
|
||||
gl.bufferData(gl.ARRAY_BUFFER, attrib, gl.DYNAMIC_DRAW);
|
||||
|
||||
gl.vertexAttribPointer(this.posPos, 2, gl.FLOAT, false, 5 * 4, 0);
|
||||
gl.vertexAttribPointer(this.texPos, 3, gl.FLOAT, false, 5 * 4, 2 * 4);
|
||||
gl.enableVertexAttribArray(this.posPos);
|
||||
gl.enableVertexAttribArray(this.texPos);
|
||||
|
||||
gl.uniform1i(this.texArrayPos, 0);
|
||||
|
||||
gl.drawArrays(gl.TRIANGLES, 0, attrib.length / 5);
|
||||
}
|
||||
|
||||
*compose(
|
||||
input: Iterable<ITexture>,
|
||||
data: IMaxRectsComposerData
|
||||
): Generator<ITextureComposedData, void> {
|
||||
this.opWidth = 0;
|
||||
this.opHeight = 0;
|
||||
|
||||
const packer = new MaxRectsPacker<MaxRectsRectangle>(
|
||||
this.maxWidth,
|
||||
this.maxHeight,
|
||||
data.padding,
|
||||
data
|
||||
);
|
||||
const arr = [...input];
|
||||
const rects = arr.map<MaxRectsRectangle>(v => {
|
||||
const rect = v.render().rect;
|
||||
const toPack = new Rectangle(rect.w, rect.h);
|
||||
toPack.data = v;
|
||||
return toPack;
|
||||
});
|
||||
packer.addArray(rects);
|
||||
|
||||
const indexMap = this.mapTextures(arr);
|
||||
this.setTexture(indexMap);
|
||||
|
||||
let index = 0;
|
||||
for (const bin of packer.bins) {
|
||||
const { texMap, attrib } = this.processRects(bin.rects, indexMap);
|
||||
this.renderAtlas(attrib);
|
||||
const texture = new Texture(this.canvas);
|
||||
const data: ITextureComposedData = {
|
||||
index: index++,
|
||||
texture,
|
||||
assetMap: texMap
|
||||
};
|
||||
yield data;
|
||||
}
|
||||
|
||||
this.gl.disableVertexAttribArray(this.posPos);
|
||||
this.gl.disableVertexAttribArray(this.texPos);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
export * from './animater';
|
||||
export * from './composer';
|
||||
export * from './splitter';
|
||||
export * from './store';
|
||||
export * from './streamComposer';
|
||||
export * from './texture';
|
||||
export * from './types';
|
||||
@@ -0,0 +1,12 @@
|
||||
#version 300 es
|
||||
precision highp float;
|
||||
precision highp sampler2DArray;
|
||||
|
||||
in vec3 v_texCoord;
|
||||
out vec4 outColor;
|
||||
|
||||
uniform sampler2DArray u_texArray;
|
||||
|
||||
void main() {
|
||||
outColor = texture(u_texArray, v_texCoord);
|
||||
}
|
||||
@@ -0,0 +1,12 @@
|
||||
#version 300 es
|
||||
precision highp float;
|
||||
|
||||
in vec2 a_position;
|
||||
in vec3 a_texCoord;
|
||||
|
||||
out vec3 v_texCoord;
|
||||
|
||||
void main() {
|
||||
v_texCoord = a_texCoord;
|
||||
gl_Position = vec4(a_position, 0.0, 1.0);
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
import { Texture } from './texture';
|
||||
import { ITexture, ITextureSplitter, IRect } from './types';
|
||||
|
||||
/**
|
||||
* 按行分割贴图,即分割成一行行的贴图,按从上到下的顺序输出
|
||||
* 输入参数代表每一行的高度
|
||||
*/
|
||||
export class TextureRowSplitter implements ITextureSplitter<number> {
|
||||
*split(texture: ITexture, data: number): Generator<ITexture> {
|
||||
const lines = Math.ceil(texture.height / data);
|
||||
const { x, y } = texture.render().rect;
|
||||
for (let i = 0; i < lines; i++) {
|
||||
const tex = new Texture(texture.source);
|
||||
tex.clip(x, y + i * data, texture.width, data);
|
||||
yield tex;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 按列分割贴图,即分割成一列列的贴图,按从左到右的顺序输出
|
||||
* 输入参数代表每一列的宽度
|
||||
*/
|
||||
export class TextureColumnSplitter implements ITextureSplitter<number> {
|
||||
*split(texture: ITexture, data: number): Generator<ITexture> {
|
||||
const lines = Math.ceil(texture.width / data);
|
||||
const { x, y } = texture.render().rect;
|
||||
for (let i = 0; i < lines; i++) {
|
||||
const tex = new Texture(texture.source);
|
||||
tex.clip(x + i * data, y, data, texture.height);
|
||||
yield tex;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 按照网格分割贴图,按照先从左到右,再从上到下的顺序输出
|
||||
* 输入参数代表每一列的宽度和高度
|
||||
*/
|
||||
export class TextureGridSplitter implements ITextureSplitter<[number, number]> {
|
||||
*split(texture: ITexture, data: [number, number]): Generator<ITexture> {
|
||||
const [w, h] = data;
|
||||
const rows = Math.ceil(texture.width / w);
|
||||
const lines = Math.ceil(texture.height / h);
|
||||
const { x, y } = texture.render().rect;
|
||||
for (let ny = 0; ny < lines; ny++) {
|
||||
for (let nx = 0; nx < rows; nx++) {
|
||||
const tex = new Texture(texture.source);
|
||||
tex.clip(x + nx * w, y + ny * h, w, h);
|
||||
yield tex;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据图集信息分割贴图,按照传入的矩形数组的顺序输出
|
||||
* 输入参数代表每个贴图对应到图集上的矩形位置
|
||||
*/
|
||||
export class TextureAssetSplitter implements ITextureSplitter<IRect[]> {
|
||||
*split(texture: ITexture, data: IRect[]): Generator<ITexture> {
|
||||
for (const { x, y, w, h } of data) {
|
||||
const tex = new Texture(texture.source);
|
||||
tex.clip(x, y, w, h);
|
||||
yield tex;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,107 @@
|
||||
import { isNil } from 'lodash-es';
|
||||
import { ITexture, ITextureStore } from './types';
|
||||
import { logger } from '@motajs/common';
|
||||
|
||||
export class TextureStore<T extends ITexture = ITexture>
|
||||
implements ITextureStore<T>
|
||||
{
|
||||
private readonly texMap: Map<number, T> = new Map();
|
||||
private readonly invMap: Map<T, number> = new Map();
|
||||
private readonly aliasMap: Map<string, number> = new Map();
|
||||
private readonly aliasInvMap: Map<number, string> = new Map();
|
||||
|
||||
[Symbol.iterator](): Iterator<[key: number, tex: T]> {
|
||||
return this.texMap.entries();
|
||||
}
|
||||
|
||||
entries(): Iterable<[key: number, tex: T]> {
|
||||
return this.texMap.entries();
|
||||
}
|
||||
|
||||
keys(): Iterable<number> {
|
||||
return this.texMap.keys();
|
||||
}
|
||||
|
||||
values(): Iterable<T> {
|
||||
return this.texMap.values();
|
||||
}
|
||||
|
||||
addTexture(identifier: number, texture: T): void {
|
||||
if (this.texMap.has(identifier)) {
|
||||
logger.warn(66, identifier.toString());
|
||||
return;
|
||||
}
|
||||
this.texMap.set(identifier, texture);
|
||||
this.invMap.set(texture, identifier);
|
||||
}
|
||||
|
||||
private removeBy(id: number, tex: T, alias?: string) {
|
||||
this.texMap.delete(id);
|
||||
this.invMap.delete(tex);
|
||||
if (alias) {
|
||||
this.aliasMap.delete(alias);
|
||||
this.aliasInvMap.delete(id);
|
||||
}
|
||||
}
|
||||
|
||||
removeTexture(identifier: number | string | T): void {
|
||||
if (typeof identifier === 'string') {
|
||||
const id = this.aliasMap.get(identifier);
|
||||
if (isNil(id)) return;
|
||||
const tex = this.texMap.get(id);
|
||||
if (isNil(tex)) return;
|
||||
this.removeBy(id, tex, identifier);
|
||||
} else if (typeof identifier === 'number') {
|
||||
const tex = this.texMap.get(identifier);
|
||||
if (isNil(tex)) return;
|
||||
const alias = this.aliasInvMap.get(identifier);
|
||||
this.removeBy(identifier, tex, alias);
|
||||
} else {
|
||||
const id = this.invMap.get(identifier);
|
||||
if (isNil(id)) return;
|
||||
const alias = this.aliasInvMap.get(id);
|
||||
this.removeBy(id, identifier, alias);
|
||||
}
|
||||
}
|
||||
|
||||
hasTexture(identifier: number): boolean {
|
||||
return this.texMap.has(identifier);
|
||||
}
|
||||
|
||||
getTexture(identifier: number): T | null {
|
||||
return this.texMap.get(identifier) ?? null;
|
||||
}
|
||||
|
||||
alias(identifier: number, alias: string): void {
|
||||
const id = this.aliasMap.get(alias);
|
||||
const al = this.aliasInvMap.get(identifier);
|
||||
if (!isNil(al)) {
|
||||
logger.warn(67, alias, identifier.toString(), al);
|
||||
return;
|
||||
}
|
||||
if (!isNil(id)) {
|
||||
logger.warn(68, alias, identifier.toString(), id.toString());
|
||||
return;
|
||||
}
|
||||
this.aliasMap.set(alias, identifier);
|
||||
this.aliasInvMap.set(identifier, alias);
|
||||
}
|
||||
|
||||
fromAlias(alias: string): ITexture | null {
|
||||
const id = this.aliasMap.get(alias);
|
||||
if (isNil(id)) return null;
|
||||
return this.texMap.get(id) ?? null;
|
||||
}
|
||||
|
||||
idOf(texture: T): number | undefined {
|
||||
return this.invMap.get(texture);
|
||||
}
|
||||
|
||||
aliasOf(identifier: number): string | undefined {
|
||||
return this.aliasInvMap.get(identifier);
|
||||
}
|
||||
|
||||
identifierOf(alias: string): number | undefined {
|
||||
return this.aliasMap.get(alias);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,201 @@
|
||||
import {
|
||||
Bin,
|
||||
IOption,
|
||||
IRectangle,
|
||||
MaxRectsPacker,
|
||||
Rectangle
|
||||
} from 'maxrects-packer';
|
||||
import { Texture } from './texture';
|
||||
import {
|
||||
IRect,
|
||||
ITexture,
|
||||
ITextureComposedData,
|
||||
ITextureStreamComposer
|
||||
} from './types';
|
||||
|
||||
export class TextureGridStreamComposer implements ITextureStreamComposer<void> {
|
||||
readonly rows: number;
|
||||
readonly cols: number;
|
||||
|
||||
private nowIndex: number = 0;
|
||||
private outputIndex: number = -1;
|
||||
|
||||
private nowTexture: ITexture;
|
||||
private nowCanvas: HTMLCanvasElement;
|
||||
private nowCtx: CanvasRenderingContext2D;
|
||||
private nowMap: Map<ITexture, Readonly<IRect>>;
|
||||
|
||||
/**
|
||||
* 网格流式贴图组合器,将等大小的贴图组合成图集,要求每个贴图的尺寸一致。
|
||||
* 组合时按照先从左到右,再从上到下的顺序组合。
|
||||
* @param width 单个贴图的宽度
|
||||
* @param height 单个贴图的高度
|
||||
* @param maxWidth 图集的最大宽度,也是输出贴图对象的宽度
|
||||
* @param maxHeight 图集的最大高度,也是输出贴图对象的高度
|
||||
*/
|
||||
constructor(
|
||||
readonly width: number,
|
||||
readonly height: number,
|
||||
readonly maxWidth: number,
|
||||
readonly maxHeight: number
|
||||
) {
|
||||
this.rows = Math.floor(maxHeight / height);
|
||||
this.cols = Math.floor(maxWidth / width);
|
||||
|
||||
this.nowCanvas = document.createElement('canvas');
|
||||
this.nowCtx = this.nowCanvas.getContext('2d')!;
|
||||
this.nowMap = new Map();
|
||||
this.nowTexture = new Texture(this.nowCanvas);
|
||||
}
|
||||
|
||||
private nextCanvas() {
|
||||
this.nowCanvas = document.createElement('canvas');
|
||||
this.nowCtx = this.nowCanvas.getContext('2d')!;
|
||||
this.nowMap = new Map();
|
||||
this.nowIndex = 0;
|
||||
this.nowTexture = new Texture(this.nowCanvas);
|
||||
this.outputIndex++;
|
||||
}
|
||||
|
||||
*add(textures: Iterable<ITexture>): Generator<ITextureComposedData, void> {
|
||||
let index = this.nowIndex;
|
||||
const max = this.cols * this.rows;
|
||||
|
||||
for (const tex of textures) {
|
||||
const nowRow = Math.floor(index / this.cols);
|
||||
const nowCol = index % this.cols;
|
||||
|
||||
const { source, rect } = tex.render();
|
||||
const { x: cx, y: cy, w: cw, h: ch } = rect;
|
||||
const x = nowRow * this.width;
|
||||
const y = nowCol * this.height;
|
||||
this.nowCtx.drawImage(source, cx, cy, cw, ch, x, y, cw, ch);
|
||||
this.nowMap.set(tex, { x, y, w: cw, h: ch });
|
||||
|
||||
if (++index === max) {
|
||||
const data: ITextureComposedData = {
|
||||
index: this.outputIndex,
|
||||
texture: this.nowTexture,
|
||||
assetMap: this.nowMap
|
||||
};
|
||||
yield data;
|
||||
this.nextCanvas();
|
||||
}
|
||||
}
|
||||
|
||||
const data: ITextureComposedData = {
|
||||
index: this.outputIndex,
|
||||
texture: this.nowTexture,
|
||||
assetMap: this.nowMap
|
||||
};
|
||||
yield data;
|
||||
}
|
||||
|
||||
close(): void {
|
||||
// We need to do nothing.
|
||||
}
|
||||
}
|
||||
|
||||
interface MaxRectsRectangle extends IRectangle {
|
||||
/** 这个矩形对应的贴图对象 */
|
||||
readonly data: ITexture;
|
||||
}
|
||||
|
||||
export class TextureMaxRectsStreamComposer
|
||||
implements ITextureStreamComposer<void>
|
||||
{
|
||||
/** Max Rects 打包器 */
|
||||
readonly packer: MaxRectsPacker<MaxRectsRectangle>;
|
||||
|
||||
private outputIndex: number = -1;
|
||||
private nowTexture!: ITexture;
|
||||
|
||||
private nowCanvas!: HTMLCanvasElement;
|
||||
private nowCtx!: CanvasRenderingContext2D;
|
||||
private nowMap!: Map<ITexture, Readonly<IRect>>;
|
||||
private nowBin: number = 0;
|
||||
|
||||
/**
|
||||
* 使用 Max Rects 算法执行贴图整合。输出的纹理的图像源将会是不同的画布。
|
||||
* @param maxWidth 图集最大宽度,也是输出贴图对象的宽度
|
||||
* @param maxHeight 图集最大高度,也是输出贴图对象的高度
|
||||
* @param padding 每个贴图之间的间距
|
||||
* @param options 传递给打包器对象的参数
|
||||
*/
|
||||
constructor(
|
||||
readonly maxWidth: number,
|
||||
readonly maxHeight: number,
|
||||
readonly padding: number,
|
||||
options?: IOption
|
||||
) {
|
||||
this.packer = new MaxRectsPacker<MaxRectsRectangle>(
|
||||
this.maxWidth,
|
||||
this.maxHeight,
|
||||
padding,
|
||||
options
|
||||
);
|
||||
|
||||
this.nextCanvas();
|
||||
}
|
||||
|
||||
private nextCanvas() {
|
||||
this.nowCanvas = document.createElement('canvas');
|
||||
this.nowCtx = this.nowCanvas.getContext('2d')!;
|
||||
this.nowCanvas.width = this.maxWidth;
|
||||
this.nowCanvas.height = this.maxHeight;
|
||||
this.nowMap = new Map();
|
||||
this.outputIndex++;
|
||||
this.nowTexture = new Texture(this.nowCanvas);
|
||||
}
|
||||
|
||||
*add(textures: Iterable<ITexture>): Generator<ITextureComposedData, void> {
|
||||
const arr = [...textures];
|
||||
const rects = arr.map<MaxRectsRectangle>(v => {
|
||||
const rect = v.render().rect;
|
||||
const toPack = new Rectangle(rect.w, rect.h);
|
||||
toPack.data = v;
|
||||
return toPack;
|
||||
});
|
||||
this.packer.addArray(rects);
|
||||
|
||||
const bins = this.packer.bins;
|
||||
if (bins.length === 0) return;
|
||||
const toYield: Bin<MaxRectsRectangle>[] = [bins[bins.length - 1]];
|
||||
if (bins.length > this.nowBin) {
|
||||
toYield.push(...bins.slice(this.nowBin));
|
||||
}
|
||||
|
||||
for (let i = this.nowBin; i < bins.length; i++) {
|
||||
const rects = bins[i].rects;
|
||||
rects.forEach(v => {
|
||||
if (this.nowMap.has(v.data)) return;
|
||||
const target: IRect = {
|
||||
x: v.x,
|
||||
y: v.y,
|
||||
w: v.width,
|
||||
h: v.height
|
||||
};
|
||||
this.nowMap.set(v.data, target);
|
||||
const { source, rect } = v.data.render();
|
||||
const { x: cx, y: cy, w: cw, h: ch } = rect;
|
||||
this.nowCtx.drawImage(source, cx, cy, cw, ch, v.x, v.y, cw, ch);
|
||||
});
|
||||
|
||||
const data: ITextureComposedData = {
|
||||
index: this.outputIndex,
|
||||
texture: this.nowTexture,
|
||||
assetMap: this.nowMap
|
||||
};
|
||||
yield data;
|
||||
if (i < bins.length - 1) {
|
||||
this.nextCanvas();
|
||||
}
|
||||
}
|
||||
|
||||
this.nowBin = bins.length - 1;
|
||||
}
|
||||
|
||||
close(): void {
|
||||
// We need to do nothing.
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,193 @@
|
||||
import { logger } from '@motajs/common';
|
||||
import {
|
||||
IRect,
|
||||
ITexture,
|
||||
ITextureComposedData,
|
||||
ITextureRenderable,
|
||||
ITextureSplitter,
|
||||
SizedCanvasImageSource
|
||||
} from './types';
|
||||
import { clamp } from 'lodash-es';
|
||||
|
||||
export class Texture implements ITexture {
|
||||
source: SizedCanvasImageSource;
|
||||
width: number;
|
||||
height: number;
|
||||
isBitmap: boolean = false;
|
||||
|
||||
/** 裁剪矩形的左边框位置 */
|
||||
private cl: number;
|
||||
/** 裁剪矩形的上边框位置 */
|
||||
private ct: number;
|
||||
/** 裁剪矩形的右边框位置 */
|
||||
private cr: number;
|
||||
/** 裁剪矩形的下边框位置 */
|
||||
private cb: number;
|
||||
|
||||
constructor(source: SizedCanvasImageSource) {
|
||||
this.source = source;
|
||||
this.width = source.width;
|
||||
this.height = source.height;
|
||||
this.cl = 0;
|
||||
this.ct = 0;
|
||||
this.cr = source.width;
|
||||
this.cb = source.height;
|
||||
}
|
||||
|
||||
/**
|
||||
* 对纹理进行裁剪操作,不会改变图像源
|
||||
* @param x 裁剪左上角横坐标
|
||||
* @param y 裁剪左上角纵坐标
|
||||
* @param w 裁剪宽度
|
||||
* @param h 裁剪高度
|
||||
*/
|
||||
clip(x: number, y: number, w: number, h: number) {
|
||||
const left = clamp(this.cl + x, this.cl, this.cr);
|
||||
const top = clamp(this.ct + y, this.ct, this.cb);
|
||||
const right = clamp(this.cl + x + w, this.cl, this.cr);
|
||||
const bottom = clamp(this.ct + y + h, this.ct, this.cb);
|
||||
if (left === right || top === bottom) {
|
||||
logger.warn(69);
|
||||
return;
|
||||
}
|
||||
const width = right - left;
|
||||
const height = bottom - top;
|
||||
if (width <= 0 || height <= 0) {
|
||||
logger.warn(77);
|
||||
return;
|
||||
}
|
||||
this.cl = left;
|
||||
this.ct = top;
|
||||
this.cr = right;
|
||||
this.cb = bottom;
|
||||
this.width = right - left;
|
||||
this.height = bottom - top;
|
||||
}
|
||||
|
||||
async toBitmap(): Promise<void> {
|
||||
if (this.source instanceof ImageBitmap) return;
|
||||
this.source = await createImageBitmap(
|
||||
this.source,
|
||||
this.cl,
|
||||
this.ct,
|
||||
this.width,
|
||||
this.height
|
||||
);
|
||||
this.cl = 0;
|
||||
this.ct = 0;
|
||||
this.cr = this.width;
|
||||
this.cb = this.height;
|
||||
this.isBitmap = true;
|
||||
}
|
||||
|
||||
split<U>(splitter: ITextureSplitter<U>, data: U): Generator<ITexture> {
|
||||
return splitter.split(this, data);
|
||||
}
|
||||
|
||||
render(): ITextureRenderable {
|
||||
return {
|
||||
source: this.source,
|
||||
rect: { x: this.cl, y: this.ct, w: this.width, h: this.height }
|
||||
};
|
||||
}
|
||||
|
||||
clampRect(rect: Readonly<IRect>): Readonly<IRect> {
|
||||
const l = clamp(rect.x, this.cl, this.cr);
|
||||
const t = clamp(rect.y, this.ct, this.cb);
|
||||
const r = clamp(rect.x + rect.w, this.cl, this.cr);
|
||||
const b = clamp(rect.y + rect.h, this.ct, this.cb);
|
||||
return { x: l, y: t, w: r - l, h: b - t };
|
||||
}
|
||||
|
||||
clipped(rect: Readonly<IRect>): ITextureRenderable {
|
||||
return {
|
||||
source: this.source,
|
||||
rect: this.clampRect(rect)
|
||||
};
|
||||
}
|
||||
|
||||
dispose(): void {
|
||||
if (this.source instanceof ImageBitmap) {
|
||||
this.source.close();
|
||||
}
|
||||
}
|
||||
|
||||
toAsset(asset: ITextureComposedData): boolean {
|
||||
const rect = asset.assetMap.get(this);
|
||||
if (!rect) return false;
|
||||
if (this.isBitmap && this.source instanceof ImageBitmap) {
|
||||
this.source.close();
|
||||
}
|
||||
this.isBitmap = false;
|
||||
this.source = asset.texture.source;
|
||||
this.cl = rect.x;
|
||||
this.ct = rect.y;
|
||||
this.width = rect.w;
|
||||
this.height = rect.h;
|
||||
this.cr = rect.x + rect.w;
|
||||
this.cb = rect.y + rect.h;
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* 对贴图的动画执行偏移效果。动画效果可以不来自传入的贴图对象,
|
||||
* 输出结果的图像源会是传入的贴图对象的图像源而非动画效果对应的图像源
|
||||
* @param texture 贴图对象
|
||||
* @param animate 动画效果
|
||||
* @param ox 偏移横坐标
|
||||
* @param oy 偏移纵坐标
|
||||
*/
|
||||
static *translated(
|
||||
texture: ITexture,
|
||||
animate: Generator<ITextureRenderable, void> | null,
|
||||
ox: number,
|
||||
oy: number
|
||||
): Generator<ITextureRenderable, void> | null {
|
||||
if (!animate) return null;
|
||||
|
||||
while (true) {
|
||||
const next = animate.next();
|
||||
if (next.done) break;
|
||||
const renderable = next.value;
|
||||
const { x, y, w, h } = renderable.rect;
|
||||
const translated: IRect = { x: x + ox, y: y + oy, w, h };
|
||||
const res: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect(translated)
|
||||
};
|
||||
yield res;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 对贴图的动画重定位。最终输出的动画会以传入的 `fx` `fy` 为左上角坐标计算
|
||||
* @param texture 贴图对象
|
||||
* @param origin 动画效果来自的贴图对象
|
||||
* @param animate 动画效果
|
||||
* @param fx 左上角横坐标
|
||||
* @param fy 左上角纵坐标
|
||||
*/
|
||||
static *fixed(
|
||||
texture: ITexture,
|
||||
origin: ITexture,
|
||||
animate: Generator<ITextureRenderable, void> | null,
|
||||
fx: number,
|
||||
fy: number
|
||||
): Generator<ITextureRenderable, void> | null {
|
||||
if (!animate) return null;
|
||||
const { x: ox, y: oy } = origin.render().rect;
|
||||
|
||||
while (true) {
|
||||
const next = animate.next();
|
||||
if (next.done) break;
|
||||
const renderable = next.value;
|
||||
const { x, y, w, h } = renderable.rect;
|
||||
const translated: IRect = { x: x - ox + fx, y: y - oy + fy, w, h };
|
||||
const res: ITextureRenderable = {
|
||||
source: texture.source,
|
||||
rect: texture.clampRect(translated)
|
||||
};
|
||||
yield res;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,218 @@
|
||||
export type SizedCanvasImageSource = Exclude<
|
||||
CanvasImageSource,
|
||||
VideoFrame | SVGElement
|
||||
>;
|
||||
|
||||
export type CanvasStyle = string | CanvasGradient | CanvasPattern;
|
||||
|
||||
export interface IRect {
|
||||
x: number;
|
||||
y: number;
|
||||
w: number;
|
||||
h: number;
|
||||
}
|
||||
|
||||
export interface ITextureRenderable {
|
||||
/** 可渲染贴图对象的图像源 */
|
||||
readonly source: SizedCanvasImageSource;
|
||||
/** 贴图裁剪区域 */
|
||||
readonly rect: Readonly<IRect>;
|
||||
}
|
||||
|
||||
export interface ITextureComposedData {
|
||||
/** 这个纹理图集的贴图对象 */
|
||||
readonly texture: ITexture;
|
||||
/** 这个纹理图集的索引 */
|
||||
readonly index: number;
|
||||
/** 每个参与组合的贴图对应到图集对象的矩形范围 */
|
||||
readonly assetMap: Map<ITexture, Readonly<IRect>>;
|
||||
}
|
||||
|
||||
export interface ITextureComposer<T> {
|
||||
/**
|
||||
* 将一系列纹理组合成为一系列纹理图集
|
||||
* @param input 输入纹理
|
||||
* @param data 输入给组合器的参数
|
||||
*/
|
||||
compose(
|
||||
input: Iterable<ITexture>,
|
||||
data: T
|
||||
): Generator<ITextureComposedData, void>;
|
||||
}
|
||||
|
||||
export interface ITextureStreamComposer<T> {
|
||||
/**
|
||||
* 将一系列纹理添加到当前流式组合器中,并将这部分纹理的组合结果输出
|
||||
* @param textures 输入纹理
|
||||
* @param data 输入给组合器的参数
|
||||
*/
|
||||
add(
|
||||
textures: Iterable<ITexture>,
|
||||
data: T
|
||||
): Generator<ITextureComposedData, void>;
|
||||
|
||||
/**
|
||||
* 结束此组合器的使用,释放相关资源
|
||||
*/
|
||||
close(): void;
|
||||
}
|
||||
|
||||
export interface ITextureSplitter<T> {
|
||||
/**
|
||||
* 对一个贴图对象执行拆分操作
|
||||
* @param texture 要拆分的贴图
|
||||
* @param data 传给拆分器的参数
|
||||
*/
|
||||
split(texture: ITexture, data: T): Generator<ITexture, void>;
|
||||
}
|
||||
|
||||
export interface ITextureAnimater<T> {
|
||||
/**
|
||||
* 开始动画序列
|
||||
* @param texture 贴图对象
|
||||
* @param data 动画初始化参数
|
||||
*/
|
||||
once(texture: ITexture, data: T): Generator<ITextureRenderable, void>;
|
||||
|
||||
/**
|
||||
* 开始循环动画序列
|
||||
* @param texture 贴图对象
|
||||
* @param data 动画初始化参数
|
||||
*/
|
||||
cycled(texture: ITexture, data: T): Generator<ITextureRenderable, void>;
|
||||
}
|
||||
|
||||
export interface ITexture {
|
||||
/** 贴图的图像源 */
|
||||
readonly source: SizedCanvasImageSource;
|
||||
/** 贴图宽度 */
|
||||
readonly width: number;
|
||||
/** 贴图高度 */
|
||||
readonly height: number;
|
||||
/** 当前贴图是否是完整 bitmap 图像 */
|
||||
readonly isBitmap: boolean;
|
||||
|
||||
/**
|
||||
* 将此贴图转换为 bitmap 图像,图像源也会转变成 ImageBitmap
|
||||
*/
|
||||
toBitmap(): Promise<void>;
|
||||
|
||||
/**
|
||||
* 使用指定贴图切分器切分贴图
|
||||
* @param splitter 贴图切分器
|
||||
* @param data 传递给切分器的参数
|
||||
* @returns 切分出的贴图所组成的可迭代对象
|
||||
*/
|
||||
split<T>(splitter: ITextureSplitter<T>, data: T): Generator<ITexture>;
|
||||
|
||||
/**
|
||||
* 获取整张图的可渲染对象
|
||||
*/
|
||||
render(): ITextureRenderable;
|
||||
|
||||
/**
|
||||
* 限制矩形范围至当前贴图对象范围
|
||||
* @param rect 矩形范围
|
||||
*/
|
||||
clampRect(rect: Readonly<IRect>): Readonly<IRect>;
|
||||
|
||||
/**
|
||||
* 获取贴图经过指定矩形裁剪后的可渲染对象,并不是简单地对图像源裁剪,还会处理其他情况
|
||||
* @param rect 裁剪矩形
|
||||
*/
|
||||
clipped(rect: Readonly<IRect>): ITextureRenderable;
|
||||
|
||||
/**
|
||||
* 释放此贴图的资源,将不能再被使用
|
||||
*/
|
||||
dispose(): void;
|
||||
|
||||
/**
|
||||
* 将贴图的图像源转换为指定图集的图像源,并将范围限定至图集中对应到此贴图的矩形范围。
|
||||
* @param asset 图集信息
|
||||
* @returns 是否转换成功,如果图集信息中不包含当前贴图,那么返回 `false`
|
||||
*/
|
||||
toAsset(asset: ITextureComposedData): boolean;
|
||||
}
|
||||
|
||||
export const enum TextureOffsetDirection {
|
||||
LeftToRight,
|
||||
RightToLeft,
|
||||
TopToBottom,
|
||||
BottomToTop
|
||||
}
|
||||
|
||||
export interface ITextureStore<T extends ITexture = ITexture> {
|
||||
[Symbol.iterator](): Iterator<[key: number, tex: T]>;
|
||||
|
||||
/**
|
||||
* 获取纹理对象键值对的可迭代对象
|
||||
*/
|
||||
entries(): Iterable<[key: number, tex: T]>;
|
||||
|
||||
/**
|
||||
* 获取纹理对象的键的可迭代对象
|
||||
*/
|
||||
keys(): Iterable<number>;
|
||||
|
||||
/**
|
||||
* 获取纹理对象的值的可迭代对象
|
||||
*/
|
||||
values(): Iterable<T>;
|
||||
|
||||
/**
|
||||
* 添加一个贴图
|
||||
* @param identifier 贴图 id
|
||||
* @param texture 贴图对象
|
||||
*/
|
||||
addTexture(identifier: number, texture: T): void;
|
||||
|
||||
/**
|
||||
* 移除一个贴图
|
||||
* @param identifier 要移除的贴图对象 id 或 别名 或 贴图对象
|
||||
*/
|
||||
removeTexture(identifier: number | string | T): void;
|
||||
|
||||
/**
|
||||
* 判断当前贴图存储对象是否包含指定贴图 id
|
||||
* @param identifier 贴图对象 id
|
||||
*/
|
||||
hasTexture(identifier: number): boolean;
|
||||
|
||||
/**
|
||||
* 根据贴图对象 id 获取贴图
|
||||
* @param identifier 贴图对象 id
|
||||
*/
|
||||
getTexture(identifier: number): T | null;
|
||||
|
||||
/**
|
||||
* 给贴图对象命名一个别名,如果贴图对象不存在也可以设置
|
||||
* @param identifier 贴图对象 id
|
||||
* @param alias 要命名的别名
|
||||
*/
|
||||
alias(identifier: number, alias: string): void;
|
||||
|
||||
/**
|
||||
* 根据贴图对象别名获取贴图
|
||||
* @param alias 贴图对象别名
|
||||
*/
|
||||
fromAlias(alias: string): ITexture | null;
|
||||
|
||||
/**
|
||||
* 根据贴图对象别名获取贴图对象 id
|
||||
* @param alias 贴图对象别名
|
||||
*/
|
||||
identifierOf(alias: string): number | undefined;
|
||||
|
||||
/**
|
||||
* 根据贴图对象获取此贴图对象在此控制器中的 id,如果贴图不在此控制器,返回 `undefined`
|
||||
* @param texture 贴图对象
|
||||
*/
|
||||
idOf(texture: ITexture): number | undefined;
|
||||
|
||||
/**
|
||||
* 根据贴图对象获取此贴图对象在此控制器中的别名,如果不存在此 id,返回 `undefined`
|
||||
* @param identifier 贴图 id
|
||||
*/
|
||||
aliasOf(identifier: number): string | undefined;
|
||||
}
|
||||
Reference in new issue
Block a user