类 LargeTexManager

En

Large texture manager class (general)

Zh

大图合集类（通用）

层级 (查看完整内容)

构造函数

constructor

属性

active autoExtend backColor checkDup COLOR_ITEM_SIZE delay destroyed EXTEND_SIZE gammaCorrection gpuMemory id immediately LARGE_TEX_H LARGE_TEX_N LARGE_TEX_W largeTexs mipMap name sRGB TEX_SIZE_MAX TEX_SIZE_MIN texAnisoLevel texFormat texMode texWrap totalCapacity updateHook usedCapacity

方法

addColor addDummySideTexture addPlaceholder addTexture addTexturesToLargeTexture adjustLtn areAllTexturesIncluded areTextureMerged calculateGpuMemory clear createLargeTex destroy fillWithColor findAvailableLargeTextureCode getBase64 getColor getLargeTex getLoadUsageRate getReserve getTexture getTextureByRef hasEnoughSpace onUpdate removeAllTextures removeTexture setReserve updateTexture calcFitTexSize calcTexSize

构造函数

constructor

属性

active

active: boolean = true

autoExtend

autoExtend: boolean = false

En

Whether to automatically extend the number of large textures

Zh

是否自动扩展大图数量

backColor

backColor: Vector4 = ...

En

Background color

Zh

背景色

checkDup

checkDup: boolean = true

En

Whether to check duplicates

Zh

是否查重

COLOR_ITEM_SIZE

COLOR_ITEM_SIZE: number = 4

delay

delay: number = 30

En

Delay time 30ms

Zh

延迟时间 30ms

destroyed

destroyed: boolean = false

En

Whether destroyed

Zh

是否已销毁

EXTEND_SIZE

EXTEND_SIZE: number = 0

En

The texture expansion size (can reduce black edges)

Zh

纹理扩边量（可减少黑边）

gammaCorrection

gammaCorrection: number = 1.0

En

The gamma correction value of the texture. If set to 1.0, texture sampling will be linear without any correction.

Zh

纹理的伽马校正值。如果设置为1.0，则纹理采样将为线性，不进行任何校正。

gpuMemory

gpuMemory: number = 0

En

GPU memory usage

Zh

显存使用量

id

id: number

immediately

immediately: boolean = false

En

Whether to immediately execute merging

Zh

是否立即执行合并

LARGE_TEX_H

LARGE_TEX_H: number = 2048

En

Large texture height

Zh

大纹理高度

LARGE_TEX_N

LARGE_TEX_N: number = 32

En

Large texture maximum number

Zh

大纹理最大数量

LARGE_TEX_W

LARGE_TEX_W: number = 2048

En

Large texture width

Zh

大纹理宽度

largeTexs

largeTexs: LargeTex[] = []

En

Merged large texture objects

Zh

合并的大纹理对象

mipMap

mipMap: boolean = true

En

Whether to enable MipMap

Zh

是否启用MipMap

name

name: string

En

Large texture set name

Zh

大图合集名称

sRGB

sRGB: boolean = false

En

Whether sRGB space

Zh

是否sRGB空间

TEX_SIZE_MAX

TEX_SIZE_MAX: number = 1024

En

The maximum allowed size of small textures that can be merged, beyond which they will not be merged

Zh

参与合并的小纹理最大允许尺寸，超过这个尺寸将不参与合并

TEX_SIZE_MIN

TEX_SIZE_MIN: number = 16

En

The minimum size of small textures that can be merged, beyond which they will not be merged

Zh

参与合并的小纹理最小允许尺寸，超过这个尺寸将不参与合并

texAnisoLevel

texAnisoLevel: number = 1

En

Anisotropic value

Zh

各向异性值

texFormat

texFormat: RenderTargetFormat = RenderTargetFormat.R8G8B8A8

En

Large texture pixel format

Zh

大纹理像素格式

texMode

texMode: FilterMode = FilterMode.Trilinear

En

Texture sampling mode

Zh

纹理采样模式

texWrap

texWrap: WrapMode = WrapMode.Clamp

En

Texture repeat mode

Zh

纹理重复模式

totalCapacity

totalCapacity: number = 0

En

Total capacity

Zh

总容量

updateHook

updateHook: ((index: number, completedIds: number[]) => void) = null

En

Update hook

Zh

更新钩子

usedCapacity

usedCapacity: number = 0

En

Used capacity

Zh

已经使用的容量

方法

addColor

addDummySideTexture

addPlaceholder

  • addPlaceholder(url, w, h, scale?, largeTextureIndex?): number

  • 添加纹理占位符

    参数

    • url: string

      纹理资源

    • w: number

      纹理宽度

    • h: number

      纹理高度

    • scale: number = 1

      放缩系数（0.1~10.0）

    • largeTextureIndex: number = -1

      指定大图纹理编号（-1：不指定）

    返回 number

addTexture

  • addTexture(tex, scale?, largeTextureIndex?, url?, needRemove?): number

  • 添加小纹理

    参数

    • tex: Texture2D

      纹理对象

    • scale: number = 1

      放缩系数（0.1~10.0）

    • largeTextureIndex: number = -1

      指定大图纹理编号（-1：不指定）

    • url: string = null

      纹理URL

    • needRemove: boolean = false

      小纹理用完后是否需要删除

    返回 number

    成功大纹理编号，失败-1

addTexturesToLargeTexture

  • addTexturesToLargeTexture(texs, scale, largeTextureIndex, needRemove?): boolean

  • 将一组小纹理合并到指定的大纹理中

    参数

    • texs: Texture2D[]

      小纹理数组

    • scale: number

      放缩系数

    • largeTextureIndex: number

      大纹理编号

    • needRemove: boolean = false

      小纹理用完后是否需要删除

    返回 boolean

    成功true，失败false，如果失败，所有的小纹理都没有合并进大纹理中

adjustLtn

areAllTexturesIncluded

areTextureMerged

calculateGpuMemory

clear

createLargeTex

destroy

fillWithColor

  • fillWithColor(largeTextureIndex, x, y, w, h, r, g, b, a?): void

  • 大图指定位置用颜色填充

    参数

    • largeTextureIndex: number

      大纹理序号

    • x: number

      位置x

    • y: number

      位置y

    • w: number

      宽度

    • h: number

      高度

    • r: number

      红色成分（0~255）

    • g: number

      绿色成分（0~255）

    • b: number

      蓝色成分（0~255）

    • a: number = 255

      Alpha（0~255）

    返回 void

findAvailableLargeTextureCode

getBase64

getColor

getLargeTex

getLoadUsageRate

getReserve

getTexture

getTextureByRef

hasEnoughSpace

onUpdate

removeAllTextures

removeTexture

setReserve

updateTexture

  • updateTexture(tex, scale?, largeTextureIndex?, url?, needRemove?): number

  • 更新小纹理

    参数

    • tex: Texture2D

      纹理对象

    • scale: number = 1

      放缩系数（0.1~10.0）

    • largeTextureIndex: number = -1

      指定大图纹理编号（-1：不指定）

    • 可选url: string

      纹理URL

    • needRemove: boolean = false

      小纹理用完后是否需要删除

    返回 number

    成功大纹理编号，失败-1

静态calcFitTexSize

静态calcTexSize

  • calcTexSize(tw, th, scale, tsm, exs): number[]

  • 计算纹理分块尺寸

    参数

    • tw: number

      纹理宽度

    • th: number

      纹理高度

    • scale: number

      放缩系数

    • tsm: number

      最小尺寸

    • exs: number

      边缘扩展

    返回 number[]

    [宽，高，水平块数，垂直块数]

显示设置

成员可见性

目录

构造函数
属性
方法