/* * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * Copyright: * 2016-2017, Danny Robson */ #ifndef CRUFT_VK_OBJECT_HPP #define CRUFT_VK_OBJECT_HPP #include "./traits.hpp" #include "./except.hpp" #include #include namespace cruft::vk { /// the base class for all non-trivial vulkan objects requiring lifetime /// management. template struct object { using native_type = native_t; object (const native_t &_native): m_native (_native) { CHECK_NEQ (m_native, VK_NULL_HANDLE); } object (object &&rhs): m_native (VK_NULL_HANDLE) { std::swap (m_native, rhs.m_native); } object (const object&) = delete; const auto& native (void) const& { return m_native; } auto& native (void)& { return m_native; } protected: native_t m_native; }; /////////////////////////////////////////////////////////////////////////// template struct root : public object { template root (Args &&...args): object ( cruft::vk::error::try_query ( wrapper_traits::create, std::forward (args)... ) ) { ; } ~root () { wrapper_traits::destroy (this->native (), nullptr); } }; /////////////////////////////////////////////////////////////////////////// /// a vulkan object that must be directly instantiated through /// constructor arguments, rather than being enumerated and owned by /// another object. template struct descendant : public object { template descendant (ParentT &parent, Args &&...args): object ( cruft::vk::error::try_query( wrapper_traits::create, parent.native (), std::forward (args)... ) ) { ; } //--------------------------------------------------------------------- ~descendant () { wrapper_traits::destroy (this->native (), nullptr); } }; /////////////////////////////////////////////////////////////////////////// /// a vulkan object that is obtained by listings from a parent object. template struct enumerated : public object { using object::object; static std::vector find (const ParentT &parent) { return error::try_handles ( enum_traits>::enumerate, parent.native () ); } }; /////////////////////////////////////////////////////////////////////////// /// a vulkan object that is directly owned by a parent object. /// /// typically implies that this object must be freed using a reference to /// the parent object. template struct owned : public object { using owner_t = OwnerT; using object::object; /////////////////////////////////////////////////////////////////////// template owned (OwnerT &owner, Args &&...args): object ( error::try_query ( wrapper_traits::create, owner.native (), std::forward (args)... ) ) { ; } //--------------------------------------------------------------------- owned (owned &&rhs): object (std::move (rhs)) { ; } //--------------------------------------------------------------------- ~owned () { CHECK_EQ (this->native (), VK_NULL_HANDLE); } //--------------------------------------------------------------------- void destroy (OwnerT &owner) { wrapper_traits::destroy (owner.native (), this->native (), nullptr); this->m_native = VK_NULL_HANDLE; } }; /////////////////////////////////////////////////////////////////////////// template class owned_ptr { public: owned_ptr (SelfT &&_self, owner_t &_owner): m_self (std::move (_self)), m_owner (_owner) { ; } owned_ptr (owned_ptr &&rhs): m_self (std::move (rhs.m_self)), m_owner (rhs.m_owner) { ; } ~owned_ptr () { m_self.destroy (m_owner); } // it's unclear whether we want to work around reseating m_owner, // or if this operation just isn't sufficiently prevalent to // justify the work. owned_ptr& operator= (owned_ptr &&rhs) = delete; const SelfT& get (void) const& { return m_self; } SelfT& get (void)& { return m_self; } SelfT& operator* ()& noexcept { return m_self; } const SelfT* operator-> () const& noexcept { return &m_self; } SelfT* operator-> ()& noexcept { return &m_self; } auto& owner (void)& noexcept { return m_owner; } const auto& owner (void) const& noexcept { return m_owner; } private: SelfT m_self; owner_t &m_owner; }; //------------------------------------------------------------------------- template auto make_owned (native_t _native, OwnerT &_owner) { return owned_ptr { SelfT (_native), _owner }; } //------------------------------------------------------------------------- template auto make_owned (OwnerT &owner, Args &&...args) { return owned_ptr { SelfT { owner, std::forward (args)... }, owner }; }; /////////////////////////////////////////////////////////////////////////// template struct function_wrapper { using value_type = ReturnT(*)(Args...) noexcept; constexpr function_wrapper (value_type _value): m_function {_value} { ; } constexpr function_wrapper (): m_function { nullptr } { ; } value_type reset (value_type _value) { value_type old = std::move (m_function); m_function = _value; return old; } template auto operator () (const owned_ptr &owned, Tail &&...tail) const { return dispatch (owned.owner (), owned.get (), std::forward (tail)...); } template auto operator () (Tail &&...tail) const { return dispatch (std::forward (tail)...); } private: template auto dispatch (Tail &&...tail) const { if constexpr (is_values_function_v) return error::try_values (m_function, std::forward (tail)...); else if constexpr (is_query_function_v) return error::try_query (m_function, std::forward (tail)...); else return error::try_func (m_function, std::forward (tail)...); } value_type m_function; }; #define WRAP_FUNCTION(NAME,FUNC) \ namespace detail { const function_wrapper __##NAME {FUNC}; } \ template \ auto NAME (Args &&...args) \ { \ return detail::__##NAME (std::forward (args)... ); \ }; }; #endif