import Plane from './Plane'; import CanvasTinter from '../core/sprites/canvas/CanvasTinter'; const DEFAULT_BORDER_SIZE = 10; /** * The NineSlicePlane allows you to stretch a texture using 9-slice scaling. The corners will remain unscaled (useful * for buttons with rounded corners for example) and the other areas will be scaled horizontally and or vertically * *```js * let Plane9 = new PIXI.NineSlicePlane(PIXI.Texture.fromImage('BoxWithRoundedCorners.png'), 15, 15, 15, 15); * ``` * <pre> * A B * +---+----------------------+---+ * C | 1 | 2 | 3 | * +---+----------------------+---+ * | | | | * | 4 | 5 | 6 | * | | | | * +---+----------------------+---+ * D | 7 | 8 | 9 | * +---+----------------------+---+ * When changing this objects width and/or height: * areas 1 3 7 and 9 will remain unscaled. * areas 2 and 8 will be stretched horizontally * areas 4 and 6 will be stretched vertically * area 5 will be stretched both horizontally and vertically * </pre> * * @class * @extends PIXI.mesh.Plane * @memberof PIXI.mesh * */ export default class NineSlicePlane extends Plane { /** * @param {PIXI.Texture} texture - The texture to use on the NineSlicePlane. * @param {int} [leftWidth=10] size of the left vertical bar (A) * @param {int} [topHeight=10] size of the top horizontal bar (C) * @param {int} [rightWidth=10] size of the right vertical bar (B) * @param {int} [bottomHeight=10] size of the bottom horizontal bar (D) */ constructor(texture, leftWidth, topHeight, rightWidth, bottomHeight) { super(texture, 4, 4); this._origWidth = texture.orig.width; this._origHeight = texture.orig.height; /** * The width of the NineSlicePlane, setting this will actually modify the vertices and UV's of this plane * * @member {number} * @memberof PIXI.NineSlicePlane# * @override */ this._width = this._origWidth; /** * The height of the NineSlicePlane, setting this will actually modify the vertices and UV's of this plane * * @member {number} * @memberof PIXI.NineSlicePlane# * @override */ this._height = this._origHeight; /** * The width of the left column (a) * * @member {number} * @memberof PIXI.NineSlicePlane# * @override */ this._leftWidth = typeof leftWidth !== 'undefined' ? leftWidth : DEFAULT_BORDER_SIZE; /** * The width of the right column (b) * * @member {number} * @memberof PIXI.NineSlicePlane# * @override */ this._rightWidth = typeof rightWidth !== 'undefined' ? rightWidth : DEFAULT_BORDER_SIZE; /** * The height of the top row (c) * * @member {number} * @memberof PIXI.NineSlicePlane# * @override */ this._topHeight = typeof topHeight !== 'undefined' ? topHeight : DEFAULT_BORDER_SIZE; /** * The height of the bottom row (d) * * @member {number} * @memberof PIXI.NineSlicePlane# * @override */ this._bottomHeight = typeof bottomHeight !== 'undefined' ? bottomHeight : DEFAULT_BORDER_SIZE; /** * Cached tint value so we can tell when the tint is changed. * * @member {number} * @memberof PIXI.NineSlicePlane# */ this._cachedTint = 0xFFFFFF; /** * Cached tinted texture. * * @member {undefined|PIXI.Texture} * @memberof PIXI.NineSlicePlane# */ this._tintedTexture = undefined; /** * Cache a copy of premultiplied UV coords for the canvas renderer * * @member {Float32Array} * @memberof PIXI.NineSlicePlane * @private */ this._canvasPreMultUvs = undefined; /** * Cache a copy of non-premultiplied UV coords for the canvas renderer * * @member {Float32Array} * @memberof PIXI.NineSlicePlane * @private */ this._canvasNonPreMultUvs = undefined; this.refresh(true); } /** * Updates the horizontal vertices. * */ updateHorizontalVertices() { const vertices = this.vertices; const h = this._topHeight + this._bottomHeight; const scale = this._height > h ? 1.0 : this._height / h; vertices[9] = vertices[11] = vertices[13] = vertices[15] = this._topHeight * scale; vertices[17] = vertices[19] = vertices[21] = vertices[23] = this._height - (this._bottomHeight * scale); vertices[25] = vertices[27] = vertices[29] = vertices[31] = this._height; } /** * Updates the vertical vertices. * */ updateVerticalVertices() { const vertices = this.vertices; const w = this._leftWidth + this._rightWidth; const scale = this._width > w ? 1.0 : this._width / w; vertices[2] = vertices[10] = vertices[18] = vertices[26] = this._leftWidth * scale; vertices[4] = vertices[12] = vertices[20] = vertices[28] = this._width - (this._rightWidth * scale); vertices[6] = vertices[14] = vertices[22] = vertices[30] = this._width; } /** * Renders the object using the Canvas renderer * * @private * @param {PIXI.CanvasRenderer} renderer - The canvas renderer to render with. */ _renderCanvas(renderer) { const context = renderer.context; // Work out tinting if (this.tint !== 0xFFFFFF) { if (this.tint !== this._cachedTint) { // Tint has changed, need to update the tinted texture and use that instead this._cachedTint = this.tint; this._tintedTexture = CanvasTinter.getTintedTexture(this, this.tint); this._refresh(); } } context.globalAlpha = this.worldAlpha; renderer.setBlendMode(this.blendMode); const transform = this.worldTransform; const res = renderer.resolution; if (renderer.roundPixels) { context.setTransform( transform.a * res, transform.b * res, transform.c * res, transform.d * res, (transform.tx * res) | 0, (transform.ty * res) | 0 ); } else { context.setTransform( transform.a * res, transform.b * res, transform.c * res, transform.d * res, transform.tx * res, transform.ty * res ); } const isTinted = this.tint !== 0xFFFFFF; const base = this._texture.baseTexture; const textureSource = !isTinted ? base.source : this._tintedTexture; const w = (!isTinted ? base.width : this._tintedTexture.width) * base.resolution; const h = (!isTinted ? base.height : this._tintedTexture.height) * base.resolution; this.drawSegment(context, textureSource, w, h, 0, 1, 10, 11); this.drawSegment(context, textureSource, w, h, 2, 3, 12, 13); this.drawSegment(context, textureSource, w, h, 4, 5, 14, 15); this.drawSegment(context, textureSource, w, h, 8, 9, 18, 19); this.drawSegment(context, textureSource, w, h, 10, 11, 20, 21); this.drawSegment(context, textureSource, w, h, 12, 13, 22, 23); this.drawSegment(context, textureSource, w, h, 16, 17, 26, 27); this.drawSegment(context, textureSource, w, h, 18, 19, 28, 29); this.drawSegment(context, textureSource, w, h, 20, 21, 30, 31); } /** * Renders one segment of the plane. * to mimic the exact drawing behavior of stretching the image like WebGL does, we need to make sure * that the source area is at least 1 pixel in size, otherwise nothing gets drawn when a slice size of 0 is used. * * @private * @param {CanvasRenderingContext2D} context - The context to draw with. * @param {CanvasImageSource} textureSource - The source to draw. * @param {number} w - width of the texture * @param {number} h - height of the texture * @param {number} x1 - x index 1 * @param {number} y1 - y index 1 * @param {number} x2 - x index 2 * @param {number} y2 - y index 2 */ drawSegment(context, textureSource, w, h, x1, y1, x2, y2) { // Pick pre-mult or non-premult based on if we're currently tinted // Tinted will use a canvas containing just that texture, so uses non-premult UVs const uvs = this.tint === 0xFFFFFF ? this._canvasPreMultUvs : this._canvasNonPreMultUvs; const vertices = this.vertices; let sw = (uvs[x2] - uvs[x1]) * w; let sh = (uvs[y2] - uvs[y1]) * h; let dw = vertices[x2] - vertices[x1]; let dh = vertices[y2] - vertices[y1]; // make sure the source is at least 1 pixel wide and high, otherwise nothing will be drawn. if (sw < 1) { sw = 1; } if (sh < 1) { sh = 1; } // make sure destination is at least 1 pixel wide and high, otherwise you get // lines when rendering close to original size. if (dw < 1) { dw = 1; } if (dh < 1) { dh = 1; } context.drawImage(textureSource, uvs[x1] * w, uvs[y1] * h, sw, sh, vertices[x1], vertices[y1], dw, dh); } /** * The width of the NineSlicePlane, setting this will actually modify the vertices and UV's of this plane * * @member {number} */ get width() { return this._width; } set width(value) // eslint-disable-line require-jsdoc { this._width = value; this._refresh(); } /** * The height of the NineSlicePlane, setting this will actually modify the vertices and UV's of this plane * * @member {number} */ get height() { return this._height; } set height(value) // eslint-disable-line require-jsdoc { this._height = value; this._refresh(); } /** * The width of the left column * * @member {number} */ get leftWidth() { return this._leftWidth; } set leftWidth(value) // eslint-disable-line require-jsdoc { this._leftWidth = value; this._refresh(); } /** * The width of the right column * * @member {number} */ get rightWidth() { return this._rightWidth; } set rightWidth(value) // eslint-disable-line require-jsdoc { this._rightWidth = value; this._refresh(); } /** * The height of the top row * * @member {number} */ get topHeight() { return this._topHeight; } set topHeight(value) // eslint-disable-line require-jsdoc { this._topHeight = value; this._refresh(); } /** * The height of the bottom row * * @member {number} */ get bottomHeight() { return this._bottomHeight; } set bottomHeight(value) // eslint-disable-line require-jsdoc { this._bottomHeight = value; this._refresh(); } /** * Refreshes NineSlicePlane coords. All of them. */ _refresh() { super._refresh(); const uvs = this.uvs; const texture = this._texture; this._origWidth = texture.orig.width; this._origHeight = texture.orig.height; const _uvw = 1.0 / this._origWidth; const _uvh = 1.0 / this._origHeight; uvs[0] = uvs[8] = uvs[16] = uvs[24] = 0; uvs[1] = uvs[3] = uvs[5] = uvs[7] = 0; uvs[6] = uvs[14] = uvs[22] = uvs[30] = 1; uvs[25] = uvs[27] = uvs[29] = uvs[31] = 1; uvs[2] = uvs[10] = uvs[18] = uvs[26] = _uvw * this._leftWidth; uvs[4] = uvs[12] = uvs[20] = uvs[28] = 1 - (_uvw * this._rightWidth); uvs[9] = uvs[11] = uvs[13] = uvs[15] = _uvh * this._topHeight; uvs[17] = uvs[19] = uvs[21] = uvs[23] = 1 - (_uvh * this._bottomHeight); this.updateHorizontalVertices(); this.updateVerticalVertices(); this.dirty++; // Get copies of the UVs for the canvas renderer before we do any premult this._canvasPreMultUvs = Float32Array.from(this.uvs); this._canvasNonPreMultUvs = Float32Array.from(this.uvs); // Normal mult UVs behaviour for WebGL renderer this.multiplyUvs(); // Manually apply uvs for stored canvas premults this._uvTransform.multiplyUvs(this._canvasPreMultUvs); } }