pixi.js

Version:

pixijs.com

pixijs/pixijs

1 lines • 9.11 kB

Source Map (JSON)

View Raw

{"version":3,"file":"TextureMatrix.mjs","sources":["../../../../../src/rendering/renderers/shared/texture/TextureMatrix.ts"],"sourcesContent":["import { Matrix } from '../../../../maths/matrix/Matrix';\n\nimport type { Texture } from './Texture';\n\nconst tempMat = new Matrix();\n\n/**\n * Class controls uv mapping from Texture normal space to BaseTexture normal space.\n *\n * Takes `trim` and `rotate` into account. May contain clamp settings for Meshes and TilingSprite.\n *\n * Can be used in Texture `uvMatrix` field, or separately, you can use different clamp settings on the same texture.\n * If you want to add support for texture region of certain feature or filter, that's what you're looking for.\n *\n * Takes track of Texture changes through `_lastTextureID` private field.\n * Use `update()` method call to track it from outside.\n * @see Texture\n * @see Mesh\n * @see TilingSprite\n * @category rendering\n * @advanced\n */\nexport class TextureMatrix\n{\n /**\n * Matrix operation that converts texture region coords to texture coords\n * @readonly\n */\n public mapCoord: Matrix;\n\n /**\n * Changes frame clamping\n * Works with TilingSprite and Mesh\n * Change to 1.5 if you texture has repeated right and bottom lines, that leads to smoother borders\n * @default 0\n */\n public clampOffset: number;\n\n /**\n * Changes frame clamping\n * Works with TilingSprite and Mesh\n * Change to -0.5 to add a pixel to the edge, recommended for transparent trimmed textures in atlas\n * @default 0.5\n */\n public clampMargin: number;\n\n /**\n * Clamp region for normalized coords, left-top pixel center in xy , bottom-right in zw.\n * Calculated based on clampOffset.\n */\n public readonly uClampFrame: Float32Array;\n\n /** Normalized clamp offset. Calculated based on clampOffset. */\n public readonly uClampOffset: Float32Array;\n\n /**\n * Tracks Texture frame changes.\n * @ignore\n */\n public _updateID: number;\n\n /**\n * Tracks Texture frame changes.\n * @protected\n */\n protected _textureID: number;\n\n protected _texture: Texture;\n\n /**\n * If texture size is the same as baseTexture.\n * @default false\n * @readonly\n */\n public isSimple: boolean;\n\n /**\n * @param texture - observed texture\n * @param clampMargin - Changes frame clamping, 0.5 by default. Use -0.5 for extra border.\n */\n constructor(texture: Texture, clampMargin?: number)\n {\n this.mapCoord = new Matrix();\n this.uClampFrame = new Float32Array(4);\n this.uClampOffset = new Float32Array(2);\n this._textureID = -1;\n this._updateID = 0;\n\n this.clampOffset = 0;\n\n if ((typeof clampMargin === 'undefined'))\n {\n this.clampMargin = (texture.width < 10) ? 0 : 0.5;\n }\n else\n {\n this.clampMargin = clampMargin;\n }\n\n this.isSimple = false;\n\n this.texture = texture;\n }\n\n /** Texture property. */\n get texture(): Texture\n {\n return this._texture;\n }\n\n set texture(value: Texture)\n {\n if (this.texture === value) return;\n\n this._texture?.removeListener('update', this.update, this);\n this._texture = value;\n this._texture.addListener('update', this.update, this);\n\n this.update();\n }\n\n /**\n * Multiplies uvs array to transform\n * @param uvs - mesh uvs\n * @param [out=uvs] - output\n * @returns - output\n */\n public multiplyUvs(uvs: Float32Array, out?: Float32Array): Float32Array\n {\n if (out === undefined)\n {\n out = uvs;\n }\n\n const mat = this.mapCoord;\n\n for (let i = 0; i < uvs.length; i += 2)\n {\n const x = uvs[i];\n const y = uvs[i + 1];\n\n out[i] = (x * mat.a) + (y * mat.c) + mat.tx;\n out[i + 1] = (x * mat.b) + (y * mat.d) + mat.ty;\n }\n\n return out;\n }\n\n /**\n * Updates matrices if texture was changed\n * @returns - whether or not it was updated\n */\n public update(): boolean\n {\n const tex = this._texture;\n\n this._updateID++;\n\n const uvs = tex.uvs;\n\n this.mapCoord.set(uvs.x1 - uvs.x0, uvs.y1 - uvs.y0, uvs.x3 - uvs.x0, uvs.y3 - uvs.y0, uvs.x0, uvs.y0);\n\n const orig = tex.orig;\n const trim = tex.trim;\n\n if (trim)\n {\n tempMat.set(\n orig.width / trim.width,\n 0, 0, orig.height / trim.height,\n -trim.x / trim.width,\n -trim.y / trim.height\n );\n\n this.mapCoord.append(tempMat);\n }\n\n const texBase = tex.source;\n const frame = this.uClampFrame;\n const margin = this.clampMargin / texBase._resolution;\n const offset = this.clampOffset / texBase._resolution;\n\n frame[0] = (tex.frame.x + margin + offset) / texBase.width;\n frame[1] = (tex.frame.y + margin + offset) / texBase.height;\n frame[2] = (tex.frame.x + tex.frame.width - margin + offset) / texBase.width;\n frame[3] = (tex.frame.y + tex.frame.height - margin + offset) / texBase.height;\n\n this.uClampOffset[0] = this.clampOffset / texBase.pixelWidth;\n this.uClampOffset[1] = this.clampOffset / texBase.pixelHeight;\n\n this.isSimple = tex.frame.width === texBase.width\n && tex.frame.height === texBase.height\n && tex.rotate === 0;\n\n return true;\n }\n}\n"],"names":[],"mappings":"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"}