RenderQueue.hpp

Go to the documentation of this file.

/*
 *  Copyright (C) 2010 - 2016 Leonid Kostrykin
 *
 *  Chair of Medical Engineering (mediTEC)
 *  RWTH Aachen University
 *  Pauwelsstr. 20
 *  52074 Aachen
 *  Germany
 * 
 * 
 *  Copyright (C) 2021 - 2025 Leonid Kostrykin
 * 
 */
 
#ifndef RENDERQUEUE_H_6014714286
#define RENDERQUEUE_H_6014714286
 
#include <LibCarna/LibCarna.hpp>
#include <LibCarna/base/Node.hpp>
#include <LibCarna/base/Geometry.hpp>
#include <LibCarna/base/Renderable.hpp>
#include <LibCarna/base/math.hpp>
#include <LibCarna/base/LibCarnaException.hpp>
#include <LibCarna/base/noncopyable.hpp>
#include <vector>
#include <algorithm>
#include <climits>
 
namespace LibCarna
{
 
namespace base
{
 
 
 
// ----------------------------------------------------------------------------------
// RenderQueue
// ----------------------------------------------------------------------------------
 
template< typename RenderableCompare >
class RenderQueue
{
 
    NON_COPYABLE
 
    std::vector< Renderable > renderables;
    std::size_t nextRenderableIndex;
 
public:
 
    const unsigned int geometryType;
 
    const unsigned int geometryTypeMask;
 
    const static unsigned int EXACT_MATCH_GEOMETRY_TYPE_MASK;
 
    RenderQueue( unsigned int geometryType, unsigned int geometryTypeMask = EXACT_MATCH_GEOMETRY_TYPE_MASK );
    
    void build( const Node& root, const math::Matrix4f& viewTransform );
    
    void rewind();
    
    void updateModelViewTransforms( const math::Matrix4f& viewTransform );
    
    bool isEmpty() const;
    
    const Renderable& poll();
 
    const Renderable& first() const;
    
    const Renderable& last() const;
 
}; // RenderQueue
 
 
template< typename RenderableCompare >
const unsigned int RenderQueue< RenderableCompare >::EXACT_MATCH_GEOMETRY_TYPE_MASK = std::numeric_limits< unsigned int >::max();
 
 
template< typename RenderableCompare >
RenderQueue< RenderableCompare >::RenderQueue( unsigned int geometryType, unsigned int geometryTypeMask )
    : geometryType( geometryType )
    , geometryTypeMask( geometryTypeMask )
{
}
 
 
template< typename RenderableCompare >
struct RenderableSort
{
    static void sort( std::vector< Renderable >& renderables, bool skipIfViewDependent )
    {
        if( renderables.size() >= 2 && ( RenderableCompare::isViewDependent || !skipIfViewDependent ) )
        {
            std::sort( renderables.begin(), renderables.end(), RenderableCompare() );
        }
    }
};
 
 
template< >
struct RenderableSort< void >
{
    static void sort( std::vector< Renderable >& renderables, bool skipIfViewDependent )
    {
    }
};
 
 
template< typename RenderableCompare >
void RenderQueue< RenderableCompare >::build( const Node& root, const math::Matrix4f& viewTransform )
{
    renderables.clear();
    nextRenderableIndex = 0;
    
    /* Collect all geometries.
     */
    root.visitChildren( true, [&]( const Spatial& spatial )
        {
            const Geometry* const geom = dynamic_cast< const Geometry* >( &spatial );
            if( geom != nullptr && ( geom->geometryType & geometryTypeMask ) == geometryType )
            {
                const math::Matrix4f modelViewTransform = viewTransform * geom->worldTransform();
                renderables.push_back( Renderable( *geom, modelViewTransform ) );
            }
        }
    );
    
    /* Order geometries as required. Do not skip anything.
     */
    RenderableSort< RenderableCompare >::sort( renderables, false );
}
 
 
template< typename RenderableCompare >
void RenderQueue< RenderableCompare >::rewind()
{
    nextRenderableIndex = 0;
}
 
 
template< typename RenderableCompare >
void RenderQueue< RenderableCompare >::updateModelViewTransforms( const math::Matrix4f& viewTransform )
{
    /* Recompute the model-view transforms.
     */
    std::for_each( renderables.begin(), renderables.end(),
        [&viewTransform]( Renderable& r )
        {
            r.setModelViewTransform( viewTransform * r.geometry().worldTransform() );
        }
    );
    
    /* Order geometries as required. Skip if the order is not view-dependent.
     */
    RenderableSort< RenderableCompare >::sort( renderables, true );
}
 
 
template< typename RenderableCompare >
bool RenderQueue< RenderableCompare >::isEmpty() const
{
    return nextRenderableIndex >= renderables.size();
}
 
 
template< typename RenderableCompare >
const Renderable& RenderQueue< RenderableCompare >::poll()
{
    LIBCARNA_ASSERT( !isEmpty() );
    return renderables[ nextRenderableIndex++ ];
}
 
 
template< typename RenderableCompare >
const Renderable& RenderQueue< RenderableCompare >::first() const
{
    LIBCARNA_ASSERT( !isEmpty() );
    return renderables.front();
}
 
 
template< typename RenderableCompare >
const Renderable& RenderQueue< RenderableCompare >::last() const
{
    LIBCARNA_ASSERT( !isEmpty() );
    return renderables.back();
}
 
 
 
}  // namespace LibCarna :: base
 
}  // namespace LibCarna
 
#endif // RENDERQUEUE_H_6014714286