Function ParseScreenshotQueryParams

Modules/RESTAPI/src/mitkRenderingController.cpp:855–904

* \brief Parse `format` / `width` / `height` query parameters. * * \throws InvalidScreenshotRequest if any parameter is malformed. */

   * \throws InvalidScreenshotRequest if any parameter is malformed.
   */
  ScreenshotQueryParams ParseScreenshotQueryParams(const httplib::Request& req)
  {
    ScreenshotQueryParams p;

    if (req.has_param("format"))
    {
      const auto formatStr = req.get_param_value("format");
      if (formatStr == "png")
        p.format = mitk::ScreenshotFormat::Png;
      else if (formatStr == "jpeg")
        p.format = mitk::ScreenshotFormat::Jpeg;
      else
        throw InvalidScreenshotRequest{
          "Invalid format '" + formatStr + "'. Must be 'png' or 'jpeg'."};
    }

    const bool hasWidth = req.has_param("width");
    const bool hasHeight = req.has_param("height");
    if (hasWidth != hasHeight)
      throw InvalidScreenshotRequest{
        "Both 'width' and 'height' must be provided together."};

    if (hasWidth)
    {
      int width = 0;
      int height = 0;
      try
      {
        width = std::stoi(req.get_param_value("width"));
        height = std::stoi(req.get_param_value("height"));
      }
      catch (const std::exception&)
      {
        throw InvalidScreenshotRequest{"'width' and 'height' must be integers."};
      }

      if (width <= 0 || height <= 0)
        throw InvalidScreenshotRequest{
          "'width' and 'height' must be positive integers."};

      static constexpr int maxDimension = 8192;
      if (width > maxDimension || height > maxDimension)
        throw InvalidScreenshotRequest{
          "'width' and 'height' must not exceed " + std::to_string(maxDimension) + "."};

      p.size = {width, height};
    }

    return p;
  }

  // SerializeSelectedPositionInfoToJson and ParsePositionFromBody live in the
  // earlier anonymous namespace (top of this file) so they are visible to the