Newer
Older
pixi.js / src / extract / canvas / CanvasExtract.js
import core from '../../core';
const tempRect = new core.Rectangle();

/**
 * The extract manager provides functionality to export content from the renderers
 * @class
 * @memberof PIXI
 * @param renderer {PIXI.CanvasRenderer} A reference to the current renderer
 */
class CanvasExtract
{
    constructor(renderer)
    {
        this.renderer = renderer;
        renderer.extract = this;
    }

    /**
     * Will return a HTML Image of the target
     *
     * @param target {PIXI.DisplayObject|PIXI.RenderTexture} A displayObject or renderTexture to convert. If left empty will use use the main renderer
     * @return {HTMLImageElement} HTML Image of the target
     */
    image( target )
    {
        let image = new Image();
        image.src = this.base64( target );
        return image;
    }

    /**
     * Will return a a base64 encoded string of this target. It works by calling CanvasExtract.getCanvas and then running toDataURL on that.
     * @param target {PIXI.DisplayObject|PIXI.RenderTexture} A displayObject or renderTexture to convert. If left empty will use use the main renderer
     * @return {string} A base64 encoded string of the texture.
     */
    base64( target )
    {
        return this.canvas( target ).toDataURL();
    }

    /**
     * Creates a Canvas element, renders this target to it and then returns it.
     * @param target {PIXI.DisplayObject|PIXI.RenderTexture} A displayObject or renderTexture to convert. If left empty will use use the main renderer
     * @return {HTMLCanvasElement} A Canvas element with the texture rendered on.
     */
    canvas( target )
    {
        let renderer = this.renderer;
        let context;
        let resolution;
        let frame;
        let renderTexture;

        if(target)
        {
            if(target instanceof core.RenderTexture)
            {
                renderTexture = target;
            }
            else
            {
                renderTexture = renderer.generateTexture(target);
            }
        }

        if(renderTexture)
        {
            context = renderTexture.baseTexture._canvasRenderTarget.context;
            resolution = renderTexture.baseTexture._canvasRenderTarget.resolution;
            frame = renderTexture.frame;
        }
        else
        {
            context = renderer.rootContext;
            resolution = renderer.rootResolution;

            frame = tempRect;
            frame.width = this.renderer.width;
            frame.height = this.renderer.height;
        }

        let width = frame.width * resolution;
        let height = frame.height * resolution;

           let canvasBuffer = new core.CanvasRenderTarget(width, height);
        let canvasData = context.getImageData(frame.x * resolution, frame.y * resolution, width, height);
        canvasBuffer.context.putImageData(canvasData, 0, 0);


        // send the canvas back..
        return canvasBuffer.canvas;
    }

    /**
     * Will return a one-dimensional array containing the pixel data of the entire texture in RGBA order, with integer values between 0 and 255 (included).
     * @param target {PIXI.DisplayObject|PIXI.RenderTexture} A displayObject or renderTexture to convert. If left empty will use use the main renderer
     * @return {Uint8ClampedArray} One-dimensional array containing the pixel data of the entire texture
     */
    pixels( target )
    {
        let renderer = this.renderer;
        let context;
        let resolution;
        let frame;
        let renderTexture;

        if(target)
        {
            if(target instanceof core.RenderTexture)
            {
                renderTexture = target;
            }
            else
            {
                renderTexture = renderer.generateTexture(target);
            }
        }

        if(renderTexture)
        {
            context = renderTexture.baseTexture._canvasRenderTarget.context;
            resolution = renderTexture.baseTexture._canvasRenderTarget.resolution;
            frame = renderTexture.frame;
        }
        else
        {
            context = renderer.rootContext;
            resolution = renderer.rootResolution;

            frame = tempRect;
            frame.width = renderer.width;
            frame.height = renderer.height;
        }

        return context.getImageData(0, 0, frame.width * resolution, frame.height * resolution).data;
    }

    /**
     * Destroys the extract
     *
     */
    destroy()
    {
        this.renderer.extract = null;
        this.renderer = null;
    }
}

core.CanvasRenderer.registerPlugin('extract', CanvasExtract);

export default CanvasExtract;