mirror of
https://github.com/cocos/cocos4.git
synced 2026-11-19 14:52:40 +08:00
32598c25cb
* switch to eslint * eslint: extends airbnb
230 lines
5.2 KiB
TypeScript
230 lines
5.2 KiB
TypeScript
/**
|
|
* @packageDocumentation
|
|
* @module gfx
|
|
*/
|
|
|
|
import { Buffer } from './buffer';
|
|
import { Device } from './device';
|
|
import { murmurhash2_32_gc } from '../utils/murmurhash2_gc';
|
|
import { Format, Obj, ObjectType } from './define';
|
|
|
|
export interface IAttribute {
|
|
name: string;
|
|
format: Format;
|
|
isNormalized: boolean;
|
|
tream: number;
|
|
isInstanced: boolean;
|
|
location: number;
|
|
}
|
|
|
|
export class Attribute {
|
|
declare private _token: never; // to make sure all usages must be an instance of this exact class, not assembled from plain object
|
|
|
|
constructor (
|
|
public name: string = '',
|
|
public format: Format = Format.UNKNOWN,
|
|
public isNormalized: boolean = false,
|
|
public stream: number = 0,
|
|
public isInstanced: boolean = false,
|
|
public location: number = 0,
|
|
) {}
|
|
}
|
|
|
|
export class InputAssemblerInfo {
|
|
declare private _token: never; // to make sure all usages must be an instance of this exact class, not assembled from plain object
|
|
|
|
constructor (
|
|
public attributes: Attribute[] = [],
|
|
public vertexBuffers: Buffer[] = [],
|
|
public indexBuffer: Buffer | null = null,
|
|
public indirectBuffer: Buffer | null = null,
|
|
) {}
|
|
}
|
|
|
|
/**
|
|
* @en GFX input assembler.
|
|
* @zh GFX 输入汇集器。
|
|
*/
|
|
export abstract class InputAssembler extends Obj {
|
|
|
|
/**
|
|
* @en Get current vertex buffers.
|
|
* @zh 顶点缓冲数组。
|
|
*/
|
|
get vertexBuffers (): Buffer[] {
|
|
return this._vertexBuffers;
|
|
}
|
|
|
|
/**
|
|
* @en Get current index buffer.
|
|
* @zh 索引缓冲。
|
|
*/
|
|
get indexBuffer (): Buffer | null {
|
|
return this._indexBuffer;
|
|
}
|
|
|
|
/**
|
|
* @en Get current attributes.
|
|
* @zh 顶点属性数组。
|
|
*/
|
|
get attributes (): Attribute[] {
|
|
return this._attributes;
|
|
}
|
|
|
|
/**
|
|
* @en Get hash of current attributes.
|
|
* @zh 获取顶点属性数组的哈希值。
|
|
*/
|
|
get attributesHash (): number {
|
|
return this._attributesHash;
|
|
}
|
|
|
|
/**
|
|
* @en Get current vertex count.
|
|
* @zh 顶点数量。
|
|
*/
|
|
get vertexCount (): number {
|
|
return this._vertexCount;
|
|
}
|
|
|
|
set vertexCount (count: number) {
|
|
this._vertexCount = count;
|
|
}
|
|
|
|
/**
|
|
* @en Get starting vertex.
|
|
* @zh 起始顶点。
|
|
*/
|
|
get firstVertex (): number {
|
|
return this._firstVertex;
|
|
}
|
|
|
|
set firstVertex (first: number) {
|
|
this._firstVertex = first;
|
|
}
|
|
|
|
/**
|
|
* @en Get current index count.
|
|
* @zh 索引数量。
|
|
*/
|
|
get indexCount (): number {
|
|
return this._indexCount;
|
|
}
|
|
|
|
set indexCount (count: number) {
|
|
this._indexCount = count;
|
|
}
|
|
|
|
/**
|
|
* @en Get starting index.
|
|
* @zh 起始索引。
|
|
*/
|
|
get firstIndex (): number {
|
|
return this._firstIndex;
|
|
}
|
|
|
|
set firstIndex (first: number) {
|
|
this._firstIndex = first;
|
|
}
|
|
|
|
/**
|
|
* @en Get current vertex offset.
|
|
* @zh 顶点偏移量。
|
|
*/
|
|
get vertexOffset (): number {
|
|
return this._vertexOffset;
|
|
}
|
|
|
|
set vertexOffset (offset: number) {
|
|
this._vertexOffset = offset;
|
|
}
|
|
|
|
/**
|
|
* @en Get current instance count.
|
|
* @zh 实例数量。
|
|
*/
|
|
get instanceCount (): number {
|
|
return this._instanceCount;
|
|
}
|
|
|
|
set instanceCount (count: number) {
|
|
this._instanceCount = count;
|
|
}
|
|
|
|
/**
|
|
* @en Get starting instance.
|
|
* @zh 起始实例。
|
|
*/
|
|
get firstInstance (): number {
|
|
return this._firstInstance;
|
|
}
|
|
|
|
set firstInstance (first: number) {
|
|
this._firstInstance = first;
|
|
}
|
|
|
|
/**
|
|
* @en Get the indirect buffer, if present.
|
|
* @zh 间接绘制缓冲。
|
|
*/
|
|
get indirectBuffer (): Buffer | null {
|
|
return this._indirectBuffer;
|
|
}
|
|
|
|
protected _device: Device;
|
|
|
|
protected _attributes: Attribute[] = [];
|
|
|
|
protected _vertexBuffers: Buffer[] = [];
|
|
|
|
protected _indexBuffer: Buffer | null = null;
|
|
|
|
protected _vertexCount = 0;
|
|
|
|
protected _firstVertex = 0;
|
|
|
|
protected _indexCount = 0;
|
|
|
|
protected _firstIndex = 0;
|
|
|
|
protected _vertexOffset = 0;
|
|
|
|
protected _instanceCount = 0;
|
|
|
|
protected _firstInstance = 0;
|
|
|
|
protected _attributesHash = 0;
|
|
|
|
protected _indirectBuffer: Buffer | null = null;
|
|
|
|
constructor (device: Device) {
|
|
super(ObjectType.INPUT_ASSEMBLER);
|
|
this._device = device;
|
|
}
|
|
|
|
/**
|
|
* @en Get the specified vertex buffer.
|
|
* @zh 获取顶点缓冲。
|
|
* @param stream The stream index of the vertex buffer.
|
|
*/
|
|
public getVertexBuffer (stream = 0): Buffer | null {
|
|
if (stream < this._vertexBuffers.length) {
|
|
return this._vertexBuffers[stream];
|
|
} else {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
protected computeAttributesHash (): number {
|
|
let res = 'attrs';
|
|
for (let i = 0; i < this.attributes.length; ++i) {
|
|
const at = this.attributes[i];
|
|
res += `,${at.name},${at.format},${at.isNormalized},${at.stream},${at.isInstanced}`;
|
|
}
|
|
return murmurhash2_32_gc(res, 666);
|
|
}
|
|
|
|
public abstract initialize (info: InputAssemblerInfo): boolean;
|
|
public abstract destroy (): void;
|
|
}
|