src/rendering/renderers/gl/texture/uploaders/glUploadImageResource.ts - dev - githubmirror/pixijs

src/rendering/renderers/gl/texture/uploaders/glUploadImageResource.ts
199 строк5 KB
Mat Groves
feat: add cube texture (#11800)
30 янв 2026, 13:29
30 янв 2026, 13:29b794958
import type { CanvasSource } from '../../../shared/texture/sources/CanvasSource';
import type { ImageSource } from '../../../shared/texture/sources/ImageSource';
import type { GlRenderingContext } from '../../context/GlRenderingContext';
import type { GlTexture } from '../GlTexture';
import type { GLTextureUploader } from './GLTextureUploader';

/** @internal */
export const glUploadImageResource = {

    id: 'image',

    upload(
        source: ImageSource | CanvasSource,
        glTexture: GlTexture,
        gl: GlRenderingContext,
        webGLVersion: number,
        targetOverride?: number,
        forceAllocation = false
    )
    {
        const target = targetOverride || glTexture.target;

        const textureWidth = source.pixelWidth;
        const textureHeight = source.pixelHeight;

        const resourceWidth = source.resourceWidth;
        const resourceHeight = source.resourceHeight;

        const isWebGL2 = webGLVersion === 2;
        const needsAllocation = forceAllocation || glTexture.width !== textureWidth || glTexture.height !== textureHeight;
        const resourceFitsTexture = resourceWidth >= textureWidth && resourceHeight >= textureHeight;
        const resource = source.resource as TexImageSource;

        const uploadFunction = isWebGL2 ? uploadImageWebGL2 : uploadImageWebGL1;

        uploadFunction(
            gl,
            target,
            glTexture,
            textureWidth,
            textureHeight,
            resourceWidth,
            resourceHeight,
            resource,
            needsAllocation,
            resourceFitsTexture
        );

        glTexture.width = textureWidth;
        glTexture.height = textureHeight;
    }
} as GLTextureUploader;

function uploadImageWebGL2(
    gl: GlRenderingContext,
    target: number,
    glTexture: GlTexture,
    textureWidth: number,
    textureHeight: number,
    resourceWidth: number,
    resourceHeight: number,
    resource: TexImageSource,
    needsAllocation: boolean,
    resourceFitsTexture: boolean
): void
{
    if (!resourceFitsTexture)
    {
        // Allocate the full texture and upload the (smaller) resource into it.
        if (needsAllocation)
        {
            gl.texImage2D(
                target,
                0,
                glTexture.internalFormat,
                textureWidth,
                textureHeight,
                0,
                glTexture.format,
                glTexture.type,
                null
            );
        }

        gl.texSubImage2D(
            target,
            0,
            0,
            0,
            resourceWidth,
            resourceHeight,
            glTexture.format,
            glTexture.type,
            resource
        );

        return;
    }

    if (!needsAllocation)
    {
        // Texture already allocated at the correct size; update in-place.
        gl.texSubImage2D(
            target,
            0,
            0,
            0,
            glTexture.format,
            glTexture.type,
            resource
        );

        return;
    }

    // WebGL2 supports the sized texImage2D overload with TexImageSource.
    gl.texImage2D(
        target,
        0,
        glTexture.internalFormat,
        textureWidth,
        textureHeight,
        0,
        glTexture.format,
        glTexture.type,
        resource
    );
}

function uploadImageWebGL1(
    gl: GlRenderingContext,
    target: number,
    glTexture: GlTexture,
    textureWidth: number,
    textureHeight: number,
    _resourceWidth: number,
    _resourceHeight: number,
    resource: TexImageSource,
    needsAllocation: boolean,
    resourceFitsTexture: boolean
): void
{
    if (!resourceFitsTexture)
    {
        // Allocate the full texture and upload the (smaller) resource into it.
        if (needsAllocation)
        {
            gl.texImage2D(
                target,
                0,
                glTexture.internalFormat,
                textureWidth,
                textureHeight,
                0,
                glTexture.format,
                glTexture.type,
                null
            );
        }

        gl.texSubImage2D(
            target,
            0,
            0,
            0,
            glTexture.format,
            glTexture.type,
            resource
        );

        return;
    }

    if (!needsAllocation)
    {
        // Texture already allocated at the correct size; update in-place.
        gl.texSubImage2D(
            target,
            0,
            0,
            0,
            glTexture.format,
            glTexture.type,
            resource
        );

        return;
    }

    // WebGL1 uses the unsized TexImageSource overload.
    gl.texImage2D(
        target,
        0,
        glTexture.internalFormat,
        glTexture.format,
        glTexture.type,
        resource
    );
}