// This file is part of OpenCV project. // It is subject to the license terms in the LICENSE file found in the top-level directory // of this distribution and at http://opencv.org/license.html. // // Copyright (C) 2020-2021 Intel Corporation #ifndef OPENCV_GAPI_S11N_HPP #define OPENCV_GAPI_S11N_HPP #include #include #include #include #include #include #include #include // FIXME: caused by deserialize_runarg #if (defined _WIN32 || defined _WIN64) && defined _MSC_VER #pragma warning(disable: 4702) #endif namespace cv { namespace gapi { /** * \addtogroup gapi_serialization * @{ */ namespace detail { GAPI_EXPORTS cv::GComputation getGraph(const std::vector &bytes); GAPI_EXPORTS cv::GMetaArgs getMetaArgs(const std::vector &bytes); GAPI_EXPORTS cv::GRunArgs getRunArgs(const std::vector &bytes); GAPI_EXPORTS std::vector getVectorOfStrings(const std::vector &bytes); template cv::GCompileArgs getCompileArgs(const std::vector &bytes); template cv::GRunArgs getRunArgsWithAdapters(const std::vector &bytes); } // namespace detail /** @brief Serialize a graph represented by GComputation into an array of bytes. * * Check different overloads for more examples. * @param c GComputation to serialize. * @return serialized vector of bytes. */ GAPI_EXPORTS std::vector serialize(const cv::GComputation &c); /** @overload * @param ca GCompileArgs to serialize. */ GAPI_EXPORTS std::vector serialize(const cv::GCompileArgs& ca); /** @overload * @param ma GMetaArgs to serialize. */ GAPI_EXPORTS std::vector serialize(const cv::GMetaArgs& ma); /** @overload * @param ra GRunArgs to serialize. */ GAPI_EXPORTS std::vector serialize(const cv::GRunArgs& ra); /** @overload * @param vs std::vector to serialize. */ GAPI_EXPORTS std::vector serialize(const std::vector& vs); /** * @private */ template static inline T deserialize(const std::vector &bytes); /** @brief Deserialize GComputation from a byte array. * * Check different overloads for more examples. * @param bytes serialized vector of bytes. * @return deserialized GComputation object. */ template<> inline cv::GComputation deserialize(const std::vector &bytes) { return detail::getGraph(bytes); } /** @brief Deserialize GMetaArgs from a byte array. * * Check different overloads for more examples. * @param bytes serialized vector of bytes. * @return deserialized GMetaArgs object. */ template<> inline cv::GMetaArgs deserialize(const std::vector &bytes) { return detail::getMetaArgs(bytes); } /** @brief Deserialize GRunArgs from a byte array. * * Check different overloads for more examples. * @param bytes serialized vector of bytes. * @return deserialized GRunArgs object. */ template<> inline cv::GRunArgs deserialize(const std::vector &bytes) { return detail::getRunArgs(bytes); } /** @brief Deserialize std::vector from a byte array. * * Check different overloads for more examples. * @param bytes serialized vector of bytes. * @return deserialized std::vector object. */ template<> inline std::vector deserialize(const std::vector &bytes) { return detail::getVectorOfStrings(bytes); } /** * @brief Deserialize GCompileArgs which types were specified in the template from a byte array. * * @note cv::gapi::s11n::detail::S11N template specialization must be provided to make a custom type * in GCompileArgs deserializable. * * @param bytes vector of bytes to deserialize GCompileArgs object from. * @return GCompileArgs object. * @see GCompileArgs cv::gapi::s11n::detail::S11N */ template inline typename std::enable_if::value, GCompileArgs>:: type deserialize(const std::vector &bytes) { return detail::getCompileArgs(bytes); } /** * @brief Deserialize GRunArgs including RMat and MediaFrame objects if any from a byte array. * * Adapter types are specified in the template. * @note To be used properly specified adapter types must overload their deserialize() method. * @param bytes vector of bytes to deserialize GRunArgs object from. * @return GRunArgs including RMat and MediaFrame objects if any. * @see RMat MediaFrame */ template inline typename std::enable_if::value, GRunArgs>:: type deserialize(const std::vector &bytes) { return detail::getRunArgsWithAdapters(bytes); } } // namespace gapi } // namespace cv namespace cv { namespace gapi { namespace s11n { /** @brief This structure is an interface for serialization routines. * * It's main purpose is to provide multiple overloads for operator<<() * with basic C++ in addition to OpenCV/G-API types. * * This sctructure can be inherited and further extended with additional types. * * For example, it is utilized in cv::gapi::s11n::detail::S11N as input parameter * in serialize() method. */ struct GAPI_EXPORTS IOStream { virtual ~IOStream() = default; // Define the native support for basic C++ types at the API level: virtual IOStream& operator<< (bool) = 0; virtual IOStream& operator<< (char) = 0; virtual IOStream& operator<< (unsigned char) = 0; virtual IOStream& operator<< (short) = 0; virtual IOStream& operator<< (unsigned short) = 0; virtual IOStream& operator<< (int) = 0; virtual IOStream& operator<< (uint32_t) = 0; virtual IOStream& operator<< (uint64_t) = 0; virtual IOStream& operator<< (float) = 0; virtual IOStream& operator<< (double) = 0; virtual IOStream& operator<< (const std::string&) = 0; }; /** @brief This structure is an interface for deserialization routines. * * It's main purpose is to provide multiple overloads for operator>>() * with basic C++ in addition to OpenCV/G-API types. * * This structure can be inherited and further extended with additional types. * * For example, it is utilized in cv::gapi::s11n::detail::S11N as input parameter * in deserialize() method. */ struct GAPI_EXPORTS IIStream { virtual ~IIStream() = default; virtual IIStream& operator>> (bool &) = 0; virtual IIStream& operator>> (std::vector::reference) = 0; virtual IIStream& operator>> (char &) = 0; virtual IIStream& operator>> (unsigned char &) = 0; virtual IIStream& operator>> (short &) = 0; virtual IIStream& operator>> (unsigned short &) = 0; virtual IIStream& operator>> (int &) = 0; virtual IIStream& operator>> (float &) = 0; virtual IIStream& operator>> (double &) = 0; virtual IIStream& operator >> (uint32_t &) = 0; virtual IIStream& operator >> (uint64_t &) = 0; virtual IIStream& operator>> (std::string &) = 0; }; namespace detail { GAPI_EXPORTS std::unique_ptr getInStream(const std::vector &bytes); } // namespace detail //////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////// // S11N operators // Note: operators for basic types are defined in IIStream/IOStream // OpenCV types //////////////////////////////////////////////////////////////// GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::Point &pt); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::Point &pt); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::Point2f &pt); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::Point2f &pt); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::Size &sz); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::Size &sz); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::Rect &rc); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::Rect &rc); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::Scalar &s); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::Scalar &s); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::Mat &m); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::Mat &m); // FIXME: for GRunArgs serailization #if !defined(GAPI_STANDALONE) GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::UMat & um); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::UMat & um); #endif // !defined(GAPI_STANDALONE) GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::RMat &r); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::RMat &r); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::gapi::wip::IStreamSource::Ptr &issptr); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::gapi::wip::IStreamSource::Ptr &issptr); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::detail::VectorRef &vr); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::detail::VectorRef &vr); GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::detail::OpaqueRef &opr); GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::detail::OpaqueRef &opr); /// @private -- Exclude this function from OpenCV documentation GAPI_EXPORTS IOStream& operator<< (IOStream& os, const cv::MediaFrame &mf); /// @private -- Exclude this function from OpenCV documentation GAPI_EXPORTS IIStream& operator>> (IIStream& is, cv::MediaFrame &mf); // Generic STL types //////////////////////////////////////////////////////////////// template IOStream& operator<< (IOStream& os, const std::map &m) { const uint32_t sz = static_cast(m.size()); os << sz; for (const auto& it : m) os << it.first << it.second; return os; } template IIStream& operator>> (IIStream& is, std::map &m) { m.clear(); uint32_t sz = 0u; is >> sz; for (std::size_t i = 0; i < sz; ++i) { K k{}; V v{}; is >> k >> v; m[k] = v; } return is; } template IOStream& operator<< (IOStream& os, const std::unordered_map &m) { const uint32_t sz = static_cast(m.size()); os << sz; for (auto &&it : m) os << it.first << it.second; return os; } template IIStream& operator>> (IIStream& is, std::unordered_map &m) { m.clear(); uint32_t sz = 0u; is >> sz; for (std::size_t i = 0; i < sz; ++i) { K k{}; V v{}; is >> k >> v; m[k] = v; } return is; } template IOStream& operator<< (IOStream& os, const std::vector &ts) { const uint32_t sz = static_cast(ts.size()); os << sz; for (auto &&v : ts) os << v; return os; } template IIStream& operator>> (IIStream& is, std::vector &ts) { uint32_t sz = 0u; is >> sz; if (sz == 0u) { ts.clear(); } else { ts.resize(sz); for (std::size_t i = 0; i < sz; ++i) is >> ts[i]; } return is; } // Generic: variant serialization namespace detail { template IOStream& put_v(IOStream&, const V&, std::size_t) { GAPI_Assert(false && "variant>>: requested index is invalid"); }; template IOStream& put_v(IOStream& os, const V& v, std::size_t x) { return (x == 0u) ? os << cv::util::get(v) : put_v(os, v, x-1); } template IIStream& get_v(IIStream&, V&, std::size_t, std::size_t) { GAPI_Assert(false && "variant<<: requested index is invalid"); } template IIStream& get_v(IIStream& is, V& v, std::size_t i, std::size_t gi) { if (i == gi) { X x{}; is >> x; v = V{std::move(x)}; return is; } else return get_v(is, v, i+1, gi); } } // namespace detail //! @overload template IOStream& operator<< (IOStream& os, const cv::util::variant &v) { os << static_cast(v.index()); return detail::put_v, Ts...>(os, v, v.index()); } //! @overload template IIStream& operator>> (IIStream& is, cv::util::variant &v) { int idx = -1; is >> idx; GAPI_Assert(idx >= 0 && idx < (int)sizeof...(Ts)); return detail::get_v, Ts...>(is, v, 0u, idx); } // FIXME: consider a better solution /// @private -- Exclude this function from OpenCV documentation template void getRunArgByIdx (IIStream& is, cv::util::variant &v, uint32_t idx) { is = detail::get_v, Ts...>(is, v, 0u, idx); } } // namespace s11n namespace detail { template struct try_deserialize_comparg; template<> struct try_deserialize_comparg> { static cv::util::optional exec(const std::string&, cv::gapi::s11n::IIStream&) { return { }; } }; template struct try_deserialize_comparg> { static cv::util::optional exec(const std::string& tag, cv::gapi::s11n::IIStream& is) { if (tag == cv::detail::CompileArgTag::tag()) { static_assert(cv::gapi::s11n::detail::has_S11N_spec::value, "cv::gapi::deserialize expects Types to have S11N " "specializations with deserialization callbacks!"); return cv::util::optional( GCompileArg { cv::gapi::s11n::detail::S11N::deserialize(is) }); } return try_deserialize_comparg>::exec(tag, is); } }; template struct deserialize_arg_with_adapter; template struct deserialize_arg_with_adapter { static GRunArg exec(cv::gapi::s11n::IIStream& is) { std::unique_ptr ptr(new TA); ptr->deserialize(is); return GRunArg { RA(std::move(ptr)) }; } }; template struct deserialize_arg_with_adapter { static GRunArg exec(cv::gapi::s11n::IIStream&) { GAPI_Assert(false && "No suitable adapter class found during RMat/MediaFrame deserialization. " "Please, make sure you've passed them in cv::gapi::deserialize() template"); return GRunArg{}; } }; template struct deserialize_runarg { static GRunArg exec(cv::gapi::s11n::IIStream& is, uint32_t idx) { if (idx == GRunArg::index_of()) { // Type or void (if not found) using TA = typename cv::util::find_adapter_impl::type; return deserialize_arg_with_adapter::exec(is); } else if (idx == GRunArg::index_of()) { // Type or void (if not found) using TA = typename cv::util::find_adapter_impl::type; return deserialize_arg_with_adapter::exec(is); } else { // not an adapter holding type runarg - use default deserialization GRunArg arg; getRunArgByIdx(is, arg, idx); return arg; } } }; template inline cv::util::optional tryDeserializeCompArg(const std::string& tag, const std::vector& sArg) { std::unique_ptr pArgIs = cv::gapi::s11n::detail::getInStream(sArg); return try_deserialize_comparg>::exec(tag, *pArgIs); } template cv::GCompileArgs getCompileArgs(const std::vector &sArgs) { cv::GCompileArgs args; std::unique_ptr pIs = cv::gapi::s11n::detail::getInStream(sArgs); cv::gapi::s11n::IIStream& is = *pIs; uint32_t sz = 0; is >> sz; for (uint32_t i = 0; i < sz; ++i) { std::string tag; is >> tag; std::vector sArg; is >> sArg; cv::util::optional dArg = cv::gapi::detail::tryDeserializeCompArg(tag, sArg); if (dArg.has_value()) { args.push_back(dArg.value()); } } return args; } template cv::GRunArgs getRunArgsWithAdapters(const std::vector &bytes) { std::unique_ptr pIs = cv::gapi::s11n::detail::getInStream(bytes); cv::gapi::s11n::IIStream& is = *pIs; cv::GRunArgs args; uint32_t sz = 0; is >> sz; for (uint32_t i = 0; i < sz; ++i) { uint32_t idx = 0; is >> idx; args.push_back(cv::gapi::detail::deserialize_runarg::exec(is, idx)); } return args; } } // namespace detail /** @} */ } // namespace gapi } // namespace cv #endif // OPENCV_GAPI_S11N_HPP