/** * PANDA 3D SOFTWARE * Copyright (c) Carnegie Mellon University. All rights reserved. * * All use of this software is subject to the terms of the revised BSD * license. You should have received a copy of this license along * with this source code in a file named "LICENSE." * * @file cycleDataLockedReader.I * @author drose * @date 2006-04-30 */ #ifndef CPPPARSER #ifdef DO_PIPELINING // This is the implementation for full support of pipelining (as well as the // sanity-check only implementation). /** * */ template INLINE CycleDataLockedReader:: CycleDataLockedReader(const PipelineCycler &cycler, Thread *current_thread) : _cycler(&cycler), _current_thread(current_thread) { _pointer = _cycler->read(_current_thread); nassertv(_pointer != nullptr); } /** * */ template INLINE CycleDataLockedReader:: CycleDataLockedReader(const CycleDataLockedReader ©) : _cycler(copy._cycler), _current_thread(copy._current_thread), _pointer(copy._pointer) { nassertv(_pointer != nullptr); _cycler->increment_read(_pointer); } /** * */ template INLINE CycleDataLockedReader:: CycleDataLockedReader(CycleDataLockedReader &&from) noexcept : _cycler(from._cycler), _current_thread(from._current_thread), _pointer(from._pointer) { from._pointer = nullptr; } /** * */ template INLINE void CycleDataLockedReader:: operator = (const CycleDataLockedReader ©) { nassertv(_pointer == nullptr); nassertv(_current_thread == copy._current_thread); _cycler = copy._cycler; _pointer = copy._pointer; nassertv(_pointer != nullptr); _cycler->increment_read(_pointer); } /** * */ template INLINE void CycleDataLockedReader:: operator = (CycleDataLockedReader &&from) noexcept { nassertv(_pointer == nullptr); nassertv(_current_thread == from._current_thread); _cycler = from._cycler; _pointer = from._pointer; from._pointer = nullptr; } /** * */ template INLINE CycleDataLockedReader:: ~CycleDataLockedReader() { if (_pointer != nullptr) { _cycler->release_read(_pointer); } } /** * This provides an indirect member access to the actual CycleData data. */ template INLINE const CycleDataType *CycleDataLockedReader:: operator -> () const { nassertr(_pointer != nullptr, _cycler->cheat()); return _pointer; } /** * This allows the CycleDataLockedReader to be passed to any function that * expects a const CycleDataType pointer. */ template INLINE CycleDataLockedReader:: operator const CycleDataType * () const { nassertr(_pointer != nullptr, _cycler->cheat()); return _pointer; } /** * This is intended to be called only from CycleDataWriter when it elevates * the pointer from read to write status. This function returns the reader's * pointer and relinquishes ownership of the pointer, rendering the reader * invalid for future reads. */ template INLINE const CycleDataType *CycleDataLockedReader:: take_pointer() { const CycleDataType *pointer = _pointer; _pointer = nullptr; nassertr(pointer != nullptr, _cycler->cheat()); return pointer; } /** * Returns the Thread pointer of the currently-executing thread, as passed to * the constructor of this object. */ template INLINE Thread *CycleDataLockedReader:: get_current_thread() const { return _current_thread; } #else // !DO_PIPELINING // This is the trivial, do-nothing implementation. /** * */ template INLINE CycleDataLockedReader:: CycleDataLockedReader(const PipelineCycler &cycler, Thread *) { _pointer = cycler.cheat(); } /** * */ template INLINE CycleDataLockedReader:: CycleDataLockedReader(const CycleDataLockedReader ©) : _pointer(copy._pointer) { } /** * */ template INLINE void CycleDataLockedReader:: operator = (const CycleDataLockedReader ©) { _pointer = copy._pointer; } /** * */ template INLINE void CycleDataLockedReader:: operator = (CycleDataLockedReader &&from) noexcept { nassertv(_pointer == nullptr); _pointer = from._pointer; from._pointer = nullptr; } /** * */ template INLINE CycleDataLockedReader:: ~CycleDataLockedReader() { } /** * This provides an indirect member access to the actual CycleData data. */ template INLINE const CycleDataType *CycleDataLockedReader:: operator -> () const { return _pointer; } /** * This allows the CycleDataLockedReader to be passed to any function that * expects a const CycleDataType pointer. */ template INLINE CycleDataLockedReader:: operator const CycleDataType * () const { return _pointer; } /** * This is intended to be called only from CycleDataWriter when it elevates * the pointer from read to write status. This function returns the reader's * pointer and relinquishes ownership of the pointer, rendering the reader * invalid for future reads. */ template INLINE const CycleDataType *CycleDataLockedReader:: take_pointer() { return _pointer; } /** * Returns the Thread pointer of the currently-executing thread, as passed to * the constructor of this object. */ template INLINE Thread *CycleDataLockedReader:: get_current_thread() const { return Thread::get_current_thread(); } #endif // DO_PIPELINING #endif // CPPPARSER