src/utils/logging/logScene.ts - dev - githubmirror/pixijs

src/utils/logging/logScene.ts
110 строк3 KB
Zyie
chore: documentation overhaul with typedoc (#11423)
19 май 2025, 11:44
19 май 2025, 11:4434926f0
/* eslint-disable no-console */

import { Sprite } from '../../scene/sprite/Sprite';

import type { Container } from '../../scene/container/Container';
import type { RenderGroup } from '../../scene/container/RenderGroup';

const colors = [
    '#000080', // Navy Blue
    '#228B22', // Forest Green
    '#8B0000', // Dark Red
    '#4169E1', // Royal Blue
    '#008080', // Teal
    '#800000', // Maroon
    '#9400D3', // Dark Violet
    '#FF8C00', // Dark Orange
    '#556B2F', // Olive Green
    '#8B008B' // Dark Magenta
];

let colorTick = 0;

/**
 * @param container
 * @param depth
 * @param data
 * @param data.color
 * @internal
 */
export function logScene(container: Container, depth = 0, data: {color?: string} = { color: '#000000' })
{
    if (container.renderGroup)
    {
        data.color = colors[colorTick++];
    }

    //    turn depth into number of spaces:
    let spaces = '';

    for (let i = 0; i < depth; i++)
    {
        spaces += '    ';
    }

    let label = container.label;

    if (!label && container instanceof Sprite)
    {
        label = `sprite:${container.texture.label}`;
    }

    // eslint-disable-next-line max-len
    let output = `%c ${spaces}|- ${label} (worldX:${container.worldTransform.tx}, relativeRenderX:${container.relativeGroupTransform.tx}, renderX:${container.groupTransform.tx}, localX:${container.x})`;

    if (container.renderGroup)
    {
        output += ' (RenderGroup)';
    }

    if (container.filters)
    {
        output += '(*filters)';
    }

    console.log(output, `color:${data.color}; font-weight:bold;`);

    depth++;

    for (let i = 0; i < container.children.length; i++)
    {
        const child = container.children[i];

        logScene(child, depth, { ...data });
    }
}

/**
 * @param renderGroup
 * @param depth
 * @param data
 * @param data.index
 * @param data.color
 * @internal
 */
export function logRenderGroupScene(
    renderGroup: RenderGroup, depth = 0,
    data: {index: number, color?: string} = { index: 0, color: '#000000' }
)
{
    // turn depth into number of spaces:
    let spaces = '';

    for (let i = 0; i < depth; i++)
    {
        spaces += '    ';
    }

    const output = `%c ${spaces}- ${data.index}: ${renderGroup.root.label} worldX:${renderGroup.worldTransform.tx}`;

    console.log(output, `color:${data.color}; font-weight:bold;`);

    depth++;

    for (let i = 0; i < renderGroup.renderGroupChildren.length; i++)
    {
        const child = renderGroup.renderGroupChildren[i];

        logRenderGroupScene(child, depth, { ...data, index: i });
    }
}