Function do_blueprint

plugins/blueprint.cpp:1660–1726

returns whether blueprint generation was successful. populates files with the names of the files that were generated

// returns whether blueprint generation was successful. populates files with the
// names of the files that were generated
static command_result do_blueprint(color_ostream &out,
                                   const vector<string> &parameters,
                                   vector<string> &files) {
    if (parameters.size() >= 1 && parameters[0] == "gui") {
        ostringstream command;
        command << "gui/blueprint";
        for (size_t i = 1; i < parameters.size(); ++i) {
            command << " " << parameters[i];
        }
        string command_str = command.str();
        out.print("launching {}\n", command_str);

        Core::getInstance().getHotkeyManager()->setHotkeyCommand(command_str);
        return CR_OK;
    }

    blueprint_options options;
    if (!Lua::CallLuaModuleFunction(out, "plugins.blueprint", "parse_commandline", std::make_tuple(&options, parameters))
        || options.help)
    {
        return CR_WRONG_USAGE;
    }

    if (!Maps::IsValid()) {
        out.printerr("Map is not available!\n");
        return CR_FAILURE;
    }

    // start coordinates can come from either the commandline or the map cursor
    df::coord start(options.start);
    if (!start.isValid()) {
        if (!Gui::getCursorCoords(start)) {
            out.printerr("Can't get cursor coords! Make sure you specify the"
                    " --cursor parameter or have an active cursor in DF.\n");
            return CR_FAILURE;
        }
    }
    if (!Maps::isValidTilePos(start)) {
        out.printerr("Invalid start position: {},{},{},\n",
                     start.x, start.y, start.z);
        return CR_FAILURE;
    }

    // end coords are one beyond the last processed coordinate. note that
    // options.depth can be negative.
    df::coord end(start.x + options.width, start.y + options.height,
                  start.z + options.depth);

    // crop end coordinate to map bounds. we've already verified that start is
    // a valid coordinate, and width, height, and depth are non-zero, so our
    // final area is always going to be at least 1x1x1.
    df::world::T_map &map = df::global::world->map;
    if (end.x > map.x_count)
        end.x = map.x_count;
    if (end.y > map.y_count)
        end.y = map.y_count;
    if (end.z > map.z_count)
        end.z = map.z_count;