Method executeExtract

tools/ktx/command_extract.cpp:322–484

}

void CommandExtract::executeExtract() {
    InputStream inputStream(options.inputFilepath, *this);
    validateToolInput(inputStream, fmtInFile(options.inputFilepath), *this);

    KTXTexture2 texture{nullptr};
    StreambufStream<std::streambuf*> ktx2Stream{inputStream->rdbuf(), std::ios::in | std::ios::binary};
    auto ret = ktxTexture2_CreateFromStream(ktx2Stream.stream(), KTX_TEXTURE_CREATE_LOAD_IMAGE_DATA_BIT, texture.pHandle());
    if (ret != KTX_SUCCESS)
        fatal(rc::INVALID_FILE, "Failed to create KTX2 texture: {}", ktxErrorString(ret));

    // CLI request validation
    if (!options.fragmentURI.mip.validate(texture->numLevels))
        fatal(rc::INVALID_FILE, "Requested level index {} is missing. The input file only has {} level(s).",
                options.fragmentURI.mip, texture->numLevels);

    if (((options.uriFlagUsed && !options.fragmentURI.stratal.is_undefined()) || options.layerFlagUsed) && !texture->isArray) {
        if (options.fragmentURI.stratal == all)
            fatal(rc::INVALID_FILE, "Requested all layers from a non-array texture.");
        else
            fatal(rc::INVALID_FILE, "Requested layer index {} from a non-array texture.", options.fragmentURI.stratal);
    }

    if (!options.fragmentURI.stratal.validate(texture->numLayers))
        fatal(rc::INVALID_FILE, "Requested layer index {} is missing. The input file only has {} layer(s).",
                options.fragmentURI.stratal, texture->numLayers);

    if (((options.uriFlagUsed && !options.fragmentURI.facial.is_undefined()) || options.faceFlagUsed) && !texture->isCubemap) {
        if (options.fragmentURI.facial == all)
            fatal(rc::INVALID_FILE, "Requested all faces from a non-cubemap texture.");
        else
            fatal(rc::INVALID_FILE, "Requested face index {} from a non-cubemap texture.", options.fragmentURI.facial);
    }

    if (!options.fragmentURI.facial.validate(texture->numFaces))
        fatal(rc::INVALID_FILE, "Requested face index {} is missing. The input file only has {} face(s).",
                options.fragmentURI.facial, texture->numFaces);

    if (!options.globalAll && options.depthFlagUsed && texture->numDimensions != 3) {
        if (options.depth == all)
            fatal(rc::INVALID_FILE, "Requested all depth slices from a non-3D texture.");
        else
            fatal(rc::INVALID_FILE, "Requested depth slice index {} from a non-3D texture.", options.depth);
    }

    // Transcoding
    if (ktxTexture2_NeedsTranscoding(texture)) {
        texture = transcode(std::move(texture), options, *this);

    } else if (options.transcodeTarget) {
        fatal(rc::INVALID_FILE, "Requested transcode \"{}\" but the KTX file is not transcodable.",
                options.transcodeTargetName);
    }

    const auto format = createFormatDescriptor(texture->pDfd);
    const auto blockSizeZ = format.basic.texelBlockDimension2 + 1u;

    const auto lastExportedLevel = options.fragmentURI.mip == all ? texture->numLevels - 1 : options.fragmentURI.mip.last();
    const auto lastExportedLevelDepthCount = std::max(1u, ceil_div(texture->baseDepth, blockSizeZ) >> lastExportedLevel);