GrpcPrint/PrintS/external/vl/include/vlGraphics/RenderingAbstract.hpp
2024-03-19 17:45:12 +08:00

102 lines
5.5 KiB
C++

/**************************************************************************************/
/* */
/* Visualization Library */
/* http://visualizationlibrary.org */
/* */
/* Copyright (c) 2005-2020, Michele Bosi */
/* All rights reserved. */
/* */
/* Redistribution and use in source and binary forms, with or without modification, */
/* are permitted provided that the following conditions are met: */
/* */
/* - Redistributions of source code must retain the above copyright notice, this */
/* list of conditions and the following disclaimer. */
/* */
/* - Redistributions in binary form must reproduce the above copyright notice, this */
/* list of conditions and the following disclaimer in the documentation and/or */
/* other materials provided with the distribution. */
/* */
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND */
/* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED */
/* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE */
/* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR */
/* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES */
/* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; */
/* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON */
/* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT */
/* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS */
/* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
/* */
/**************************************************************************************/
#ifndef RenderingAbstract_INCLUDE_ONCE
#define RenderingAbstract_INCLUDE_ONCE
#include <vlGraphics/link_config.hpp>
#include <vlCore/Collection.hpp>
#include <vlGraphics/Actor.hpp>
#include <vlCore/vlnamespace.hpp>
namespace vl
{
class RenderEventCallback;
//! The RenderingAbstract class is the base of all the rendering related sub-classes.
class VLGRAPHICS_EXPORT RenderingAbstract: public Object
{
VL_INSTRUMENT_ABSTRACT_CLASS(vl::RenderingAbstract, Object)
public:
//! Constructor.
RenderingAbstract();
/** Executes the rendering. */
virtual void render() = 0;
RenderingAbstract& operator=(const RenderingAbstract& other);
/** Calls the RenderEventCallback::onRenderingStarted() method of all the active callback objects.*/
void dispatchOnRenderingStarted();
/** Calls the RenderEventCallback::onRenderingFinished() method of all the active callback objects.*/
void dispatchOnRenderingFinished();
//! Returns the list of RenderEventCallback objects registered to the onRenderingStarted() event notification.
Collection<RenderEventCallback>* onStartedCallbacks() { return mOnStartedCallbacks.get(); }
//! Returns the list of RenderEventCallback objects registered to the onRenderingStarted() event notification.
const Collection<RenderEventCallback>* onStartedCallbacks() const { return mOnStartedCallbacks.get(); }
//! Returns the list of RenderEventCallback objects registered to the onRenderingFinished() event notification.
Collection<RenderEventCallback>* onFinishedCallbacks() { return mOnFinishedCallbacks.get(); }
//! Returns the list of RenderEventCallback objects registered to the onRenderingFinished() event notification.
const Collection<RenderEventCallback>* onFinishedCallbacks() const { return mOnFinishedCallbacks.get(); }
//! The enable mask of the Rendering, used to define wheter the rendering is enabled or not, and which objects should be rendered.
//! @sa
//! vl::Actor::setEnableMask()
void setEnableMask(unsigned int mask) { mEnableMask = mask; }
//! The enable mask of the Rendering, used to define wheter the rendering is enabled or not, and which objects should be rendered.
unsigned int enableMask() const { return mEnableMask; }
bool isEnabled(unsigned int mask) { return (mask & mEnableMask) != 0; }
bool isEnabled(const Actor* actor) { return actor->isEnabled() && (actor->enableMask() & mEnableMask) != 0; }
//! The update time of the current rendering frame.
void setFrameClock(real cur_time) { mFrameClock = cur_time; }
//! The update time of the current rendering frame.
real frameClock() const { return mFrameClock; }
protected:
ref< Collection<RenderEventCallback> > mOnStartedCallbacks;
ref< Collection<RenderEventCallback> > mOnFinishedCallbacks;
real mFrameClock;
unsigned int mEnableMask;
};
}
#endif