Function ProcessCommandLine

tools/cli/NtcCommandLine.cpp:84–481

    float maxBcPsnr = INFINITY;
    float bcPsnrOffset = 0.f;
    float bcPsnrThreshold = 0.2f;
    std::optional<int> customWidth;
    std::optional<int> customHeight;
    ntc::CompressionSettings compressionSettings;
    ntc::LosslessCompressionSettings losslessCompression;
} g_options;

bool ProcessCommandLine(int argc, const char** argv)
{
    const char* bcFormatString = nullptr;
    const char* imageFormatString = nullptr;
    const char* dimensionsString = nullptr;
    const char* gdeflateString = nullptr;

    struct argparse_option options[] = {
        OPT_GROUP("Actions:"),
        OPT_BOOLEAN('c', "compress", &g_options.compress, "Perform NTC compression"),
        OPT_BOOLEAN('D', "decompress", &g_options.decompress, "Perform NTC decompression (implied when needed)"),
        OPT_BOOLEAN('d', "describe", &g_options.describe, "Describe the contents of a compressed texture set"),
        OPT_BOOLEAN('g', "generateMips", &g_options.generateMips, "Generate MIP level images before compression"),
        OPT_STRING (0,   "loadCompressed", &g_options.loadCompressedFileName, "Load compressed texture set from the specified file"),
        OPT_STRING (0,   "loadImages", &g_options.loadImagesPath, "Load channel images from the specified folder"),
        OPT_STRING (0,   "loadManifest", &g_options.loadManifestFileName, "Load channel images and their parameters using the specified JSON manifest file"),
        OPT_BOOLEAN(0,   "loadMips", &g_options.loadMips, "Load MIP level images from <loadImages>/mips/<texture>.<mip>.<ext> before compression"),
        OPT_BOOLEAN(0,   "optimizeBC", &g_options.optimizeBC, "Run slow BC compression and store acceleration info in the NTC package"),
        OPT_BOOLEAN(0,   "readManifestFromStdin", &g_options.readManifestFromStdin, "Load channel images using a JSON manifest passed through standard input (stdin)"),
        OPT_STRING ('o', "saveCompressed", &g_options.saveCompressedFileName, "Save compressed texture set into the specified file"),
        OPT_STRING ('i', "saveImages", &g_options.saveImagesPath, "Save channel images into the specified folder"),
        OPT_STRING (0,   "saveManifest", &g_options.saveManifestFileName, "Save a manifest JSON file (only for image inputs)"),
        OPT_STRING (0,   "writeManifestSemanticsJson", &g_options.writeManifestSemanticsJson,
            "With --saveManifest, use this semantics.json for per-slot channel strings (R/RGB/...); if omitted, "
            "semantics.json beside the manifest path is used when present"),
        OPT_BOOLEAN(0,   "saveMips", &g_options.saveMips, "Save MIP level images into <saveImages>/mips/ after decompression"),
        OPT_BOOLEAN(0,   "version", &g_options.printVersion, "Print version information and exit"),
        OPT_HELP(),
        
        OPT_GROUP("Basic compression options:"),
        OPT_FLOAT  ('b', "bitsPerPixel", &g_options.bitsPerPixel, "Request an optimal compression configuration for the provided BPP value"),
        OPT_FLOAT  (0,   "maxBitsPerPixel", &g_options.maxBitsPerPixel, "Maximum BPP value to use in the compression parameter search"),
        OPT_FLOAT  ('p', "targetPsnr", &g_options.targetPsnr, "Perform compression parameter search to reach at least the provided PSNR value"),
        
        OPT_GROUP("Custom latent shape selection:"),
        OPT_INTEGER(0, "gridSizeScale", &g_options.gridSizeScale, "Ratio of source image size to high-resolution feature grid size"),
        OPT_INTEGER(0, "numFeatures", &g_options.numFeatures, "Number of features"),
        
        OPT_GROUP("Training process controls:"),
        OPT_FLOAT  (0,   "gridLearningRate", &g_options.compressionSettings.gridLearningRate, "Maximum learning rate for the feature grid"),
        OPT_INTEGER(0,   "kPixelsPerBatch", &g_options.compressionSettings.kPixelsPerBatch, "Number of kilopixels from the image to process in one training step"),
        OPT_FLOAT  (0,   "networkLearningRate", &g_options.compressionSettings.networkLearningRate, "Maximum learning rate for the MLP weights"),
        OPT_INTEGER(0,   "randomSeed", &g_options.compressionSettings.randomSeed, "Random seed, set to a nonzero value to get more stable compression results"),
        OPT_BOOLEAN(0,   "stableTraining", &g_options.compressionSettings.stableTraining, "Use a more expensive but more numerically stable training algorithm for reproducible results"),
        OPT_INTEGER(0,   "stepsPerIteration", &g_options.compressionSettings.stepsPerIteration, "Training steps between progress reports"),
        OPT_INTEGER('S', "trainingSteps", &g_options.compressionSettings.trainingSteps, "Total training step count"),
        
        OPT_GROUP("Output settings:"),
        OPT_STRING ('B', "bcFormat", &bcFormatString, "Set or override the BCn encoding format, BC1-BC7"),
        OPT_STRING ('F', "imageFormat", &imageFormatString, "Set the output file format for color images: Auto (default), BMP, JPG, TGA, PNG, PNG16, EXR"),
        OPT_STRING (0,   "dimensions", &dimensionsString, "Set the dimensions of the NTC texture set before compression, in the 'WxH' format"),