simvx.graphics.cli

Graphics subcommands for the simvx CLI, registered via the simvx.commands entry point (the sanctioned no-upward-import mechanism: core discovers this module, never imports graphics).

simvx build-textures compiles the native basis_universal UASTC transcoder extension. Required once after uv pip install -e packages/graphics because uv_build does not run C-extension build hooks, mirroring core’s simvx build-audio. Subsequent runs reuse the .so.

simvx cook pre-transcodes UASTC .ktx2 textures (standalone or referenced by a .gltf scene) to an explicit GPU block format with their mip chains baked in, so shipped assets load with zero runtime transcode work. See simvx.graphics.cook.

Module Contents

Functions

register

Attach the graphics subcommands to the simvx CLI.

API

simvx.graphics.cli.register(subparsers: argparse._SubParsersAction) → None

Attach the graphics subcommands to the simvx CLI.