// Copyright 2021 Dolphin Emulator Project // SPDX-License-Identifier: GPL-2.0-or-later #include "DolphinTool/ConvertCommand.h" #include #include #include #include #include #include #include #include #include #include "Common/CommonTypes.h" #include "DiscIO/Blob.h" #include "DiscIO/DiscUtils.h" #include "DiscIO/ScrubbedBlob.h" #include "DiscIO/Volume.h" #include "DiscIO/VolumeDisc.h" #include "DiscIO/WIABlob.h" #include "UICommon/UICommon.h" namespace DolphinTool { static std::optional ParseCompressionTypeString(const std::string& compression_str) { if (compression_str == "none") return DiscIO::WIARVZCompressionType::None; else if (compression_str == "purge") return DiscIO::WIARVZCompressionType::Purge; else if (compression_str == "bzip2") return DiscIO::WIARVZCompressionType::Bzip2; else if (compression_str == "lzma") return DiscIO::WIARVZCompressionType::LZMA; else if (compression_str == "lzma2") return DiscIO::WIARVZCompressionType::LZMA2; else if (compression_str == "zstd") return DiscIO::WIARVZCompressionType::Zstd; return std::nullopt; } static std::optional ParseFormatString(const std::string& format_str) { if (format_str == "iso") return DiscIO::BlobType::PLAIN; else if (format_str == "gcz") return DiscIO::BlobType::GCZ; else if (format_str == "wia") return DiscIO::BlobType::WIA; else if (format_str == "rvz") return DiscIO::BlobType::RVZ; return std::nullopt; } int ConvertCommand(const std::vector& args) { optparse::OptionParser parser; parser.usage("usage: convert [options]... [FILE]..."); parser.add_option("-u", "--user") .type("string") .action("store") .help("User folder path, required for temporary processing files. " "Will be automatically created if this option is not set.") .set_default(""); parser.add_option("-i", "--input") .type("string") .action("store") .help("Path to disc image FILE.") .metavar("FILE"); parser.add_option("-o", "--output") .type("string") .action("store") .help("Path to the destination FILE.") .metavar("FILE"); parser.add_option("-f", "--format") .type("string") .action("store") .help("Container format to use. Default is RVZ. [%choices]") .choices({"iso", "gcz", "wia", "rvz"}); parser.add_option("-s", "--scrub") .action("store_true") .help("Scrub junk data as part of conversion."); parser.add_option("-b", "--block_size") .type("int") .action("store") .help("Block size for GCZ/WIA/RVZ formats, as an integer. Suggested value for RVZ: 131072 " "(128 KiB)"); parser.add_option("-c", "--compression") .type("string") .action("store") .help("Compression method to use when converting to WIA/RVZ. Suggested value for RVZ: zstd " "[%choices]") .choices({"none", "zstd", "bzip2", "lzma", "lzma2"}); parser.add_option("-l", "--compression_level") .type("int") .action("store") .help("Level of compression for the selected method. Ignored if 'none'. Suggested value for " "zstd: 5"); const optparse::Values& options = parser.parse_args(args); // Initialize the dolphin user directory, required for temporary processing files // If this is not set, destructive file operations could occur due to path confusion UICommon::SetUserDirectory(options["user"]); UICommon::Init(); // Validate options // --input if (!options.is_set("input")) { fmt::print(std::cerr, "Error: No input set\n"); return EXIT_FAILURE; } const std::string& input_file_path = options["input"]; // --output if (!options.is_set("output")) { fmt::print(std::cerr, "Error: No output set\n"); return EXIT_FAILURE; } const std::string& output_file_path = options["output"]; // --format const std::optional format_o = ParseFormatString(options["format"]); if (!format_o.has_value()) { fmt::print(std::cerr, "Error: No output format set\n"); return EXIT_FAILURE; } const DiscIO::BlobType format = format_o.value(); // Open the blob reader std::unique_ptr blob_reader = DiscIO::CreateBlobReader(input_file_path); if (!blob_reader) { fmt::print(std::cerr, "Error: The input file could not be opened.\n"); return EXIT_FAILURE; } // --scrub const bool scrub = static_cast(options.get("scrub")); // Open the volume std::unique_ptr volume = DiscIO::CreateDisc(input_file_path); if (!volume) { if (scrub) { fmt::print(std::cerr, "Error: Scrubbing is only supported for GC/Wii disc images.\n"); return EXIT_FAILURE; } fmt::print(std::cerr, "Warning: The input file is not a GC/Wii disc image. Continuing anyway.\n"); } if (scrub) { if (volume->IsDatelDisc()) { fmt::print(std::cerr, "Error: Scrubbing a Datel disc is not supported.\n"); return EXIT_FAILURE; } blob_reader = DiscIO::ScrubbedBlob::Create(input_file_path); if (!blob_reader) { fmt::print(std::cerr, "Error: Unable to process disc image. Try again without --scrub.\n"); return EXIT_FAILURE; } } if (scrub && format == DiscIO::BlobType::RVZ) { fmt::print(std::cerr, "Warning: Scrubbing an RVZ container does not offer significant space " "advantages. Continuing anyway.\n"); } if (scrub && format == DiscIO::BlobType::PLAIN) { fmt::print(std::cerr, "Warning: Scrubbing does not save space when converting to ISO unless " "using external compression. Continuing anyway.\n"); } if (!scrub && format == DiscIO::BlobType::GCZ && volume && volume->GetVolumeType() == DiscIO::Platform::WiiDisc && !volume->IsDatelDisc()) { fmt::print(std::cerr, "Warning: Converting Wii disc images to GCZ without scrubbing may not " "offer space advantages over ISO. Continuing anyway.\n"); } if (volume && volume->IsNKit()) { fmt::print(std::cerr, "Warning: Converting an NKit file, output will still be NKit! Continuing anyway.\n"); } // --block_size std::optional block_size_o; if (options.is_set("block_size")) block_size_o = static_cast(options.get("block_size")); if (format == DiscIO::BlobType::GCZ || format == DiscIO::BlobType::WIA || format == DiscIO::BlobType::RVZ) { if (!block_size_o.has_value()) { fmt::print(std::cerr, "Error: Block size must be set for GCZ/RVZ/WIA\n"); return EXIT_FAILURE; } if (!DiscIO::IsDiscImageBlockSizeValid(block_size_o.value(), format)) { fmt::print(std::cerr, "Error: Block size is not valid for this format\n"); return EXIT_FAILURE; } if (block_size_o.value() < DiscIO::PREFERRED_MIN_BLOCK_SIZE || block_size_o.value() > DiscIO::PREFERRED_MAX_BLOCK_SIZE) { fmt::print(std::cerr, "Warning: Block size is not ideal for performance. Continuing anyway.\n"); } if (format == DiscIO::BlobType::GCZ && volume && !DiscIO::IsGCZBlockSizeLegacyCompatible(block_size_o.value(), volume->GetDataSize())) { fmt::print(std::cerr, "Warning: For GCZs to be compatible with Dolphin < 5.0-11893, the file size " "must be an integer multiple of the block size and must not be an integer " "multiple of the block size multiplied by 32. Continuing anyway.\n"); } } // --compress, --compress_level std::optional compression_o = ParseCompressionTypeString(options["compression"]); std::optional compression_level_o; if (options.is_set("compression_level")) compression_level_o = static_cast(options.get("compression_level")); if (format == DiscIO::BlobType::WIA || format == DiscIO::BlobType::RVZ) { if (!compression_o.has_value()) { fmt::print(std::cerr, "Error: Compression method must be set for WIA or RVZ\n"); return EXIT_FAILURE; } if ((format == DiscIO::BlobType::WIA && compression_o.value() == DiscIO::WIARVZCompressionType::Zstd) || (format == DiscIO::BlobType::RVZ && compression_o.value() == DiscIO::WIARVZCompressionType::Purge)) { fmt::print(std::cerr, "Error: Compression type is not supported for the container format\n"); return EXIT_FAILURE; } if (compression_o.value() == DiscIO::WIARVZCompressionType::None) { compression_level_o = 0; } else { if (!compression_level_o.has_value()) { fmt::print(std::cerr, "Error: Compression level must be set when compression type is not 'none'\n"); return EXIT_FAILURE; } const std::pair range = DiscIO::GetAllowedCompressionLevels(compression_o.value(), false); if (compression_level_o.value() < range.first || compression_level_o.value() > range.second) { fmt::print(std::cerr, "Error: Compression level not in acceptable range\n"); return EXIT_FAILURE; } } } // Perform the conversion const auto NOOP_STATUS_CALLBACK = [](const std::string& text, float percent) { return true; }; bool success = false; switch (format) { case DiscIO::BlobType::PLAIN: { success = DiscIO::ConvertToPlain(blob_reader.get(), input_file_path, output_file_path, NOOP_STATUS_CALLBACK); break; } case DiscIO::BlobType::GCZ: { u32 sub_type = std::numeric_limits::max(); if (volume) { if (volume->GetVolumeType() == DiscIO::Platform::GameCubeDisc) sub_type = 0; else if (volume->GetVolumeType() == DiscIO::Platform::WiiDisc) sub_type = 1; } success = DiscIO::ConvertToGCZ(blob_reader.get(), input_file_path, output_file_path, sub_type, block_size_o.value(), NOOP_STATUS_CALLBACK); break; } case DiscIO::BlobType::WIA: case DiscIO::BlobType::RVZ: { success = DiscIO::ConvertToWIAOrRVZ(blob_reader.get(), input_file_path, output_file_path, format == DiscIO::BlobType::RVZ, compression_o.value(), compression_level_o.value(), block_size_o.value(), NOOP_STATUS_CALLBACK); break; } default: { ASSERT(false); break; } } if (!success) { fmt::print(std::cerr, "Error: Conversion failed\n"); return EXIT_FAILURE; } return EXIT_SUCCESS; } } // namespace DolphinTool