类 LargeTexBase

constructor

• new LargeTexBase(largeTexsize, ltn, tsm?, exs?, texFormat?): LargeTexBase

• 参数

  • largeTexsize: number[]

    large texture size(size must be a power of 2)
  • ltn: number

    large texture number limit
  • tsm: number = 16

    small texture unit size (small texture minimum size)
  • exs: number = 0

    small texture extend size
  • texFormat: RenderTargetFormat = RenderTargetFormat.R8G8B8A8

  返回 LargeTexBase

  En

  Zh

autoExtend

backColor

checkDup

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

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

• adjustLtn(add?): void

• 参数

  • add: number = 1

    add amount

  返回 void

  En

  Adjust the maximum number of large textures

  Zh

  调整大纹理数量上限

areAllTexturesIncluded

• areAllTexturesIncluded(texs): boolean

• 指定的贴图是否都已经在大图合集上

  参数

  • texs: Texture2D[]

    贴图组

  返回 boolean

areTextureMerged

• areTextureMerged(ui, largeTextureIndex?): boolean

• 指定的贴图是否都已经在大图合集上

  参数

  • ui: string | number

    贴图id或url
  • largeTextureIndex: number = -1

    大纹理序号

  返回 boolean

  是否都已经在大图合集上

calculateGpuMemory

• calculateGpuMemory(): number

• 返回 number

  En

  Calculate the GPU memory usage

  Zh

  统计显存使用量

clear

• clear(): void

• 清空，重用对象

  返回 void

createLargeTex

• createLargeTex(largeTextureIndex, sRGB?, gammaCorrection?): void

• 创建大纹理

  参数

  • largeTextureIndex: number

    大纹理编号
  • 可选sRGB: boolean

    大图是否sRGB格式
  • 可选gammaCorrection: number

  返回 void

destroy

• destroy(keepRes?): void

• 销毁对象，清理内存

  参数

  • keepRes: boolean = false

  返回 void

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

• findAvailableLargeTextureCode(tex, scale): number

• 获取具有足够空间的大纹理编号

  参数

  • tex: Texture2D[]

    小纹理数组
  • scale: number

    放缩系数

  返回 number

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

getLargeTex

• getLargeTex(largeTextureIndex): LargeTex

• 根据大图纹理序号获取大纹理

  参数

  • largeTextureIndex: number

    大纹理编号

  返回 LargeTex

  大纹理或null

getLoadUsageRate

• getLoadUsageRate(): number

• 返回 number

  En

  Get the current usage rate (percentage)

  Zh

  获取当前使用率（百分比）

getTexture

• getTexture(iu, largeTextureIndex?): TextureOut

• 获取纹理和UV

  参数

  • iu: string | number

    小纹理id或url
  • largeTextureIndex: number = -1

    大纹理编号

  返回 TextureOut

  纹理对象

getTextureByRef

• getTextureByRef(tex, largeTextureIndex?): TextureOut

• 获取纹理和UV

  参数

  • tex: Texture2D

    纹理对象
  • largeTextureIndex: number = -1

    大纹理编号

  返回 TextureOut

  纹理对象

hasEnoughSpace

• hasEnoughSpace(tex, scale, largeTextureIndex): boolean

• 大图合集指定纹理空间是否够用

  参数

  • tex: Texture2D[]

    小纹理数组
  • scale: number

    放缩系数
  • largeTextureIndex: number

    大纹理序号

  返回 boolean

  够用true，不够用false

onUpdate

• onUpdate(force?): boolean

• 参数

  • force: boolean = false

    force update

  返回 boolean

  En

  Response update

  Zh

  响应更新

removeAllTextures

• removeAllTextures(): void

• 清除所有纹理

  返回 void

removeTexture

• removeTexture(iu, largeTextureIndex?): void

• 删除小纹理

  参数

  • iu: string | number

    小纹理id或url
  • largeTextureIndex: number = -1

    大纹理编号(-1: 不指定)

  返回 void

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

• calcFitTexSize(tex, scale, tsm, exs, tp?): number[]

• 根据一批小纹理计算大纹理尺寸和高宽

  参数

  • tex: Texture2D[]
  • scale: number
  • tsm: number
  • exs: number
  • 可选tp: any

    合并情况

  返回 number[]

  [宽，高，利用率]

静态calcTexSize

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

• 计算纹理分块尺寸

  参数

  • tw: number

    纹理宽度
  • th: number

    纹理高度
  • scale: number

    放缩系数
  • tsm: number

    最小尺寸
  • exs: number

    边缘扩展

  返回 number[]

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