RenderMeshActor.h

Go to the documentation of this file.

/*
 * Copyright (c) 2008-2017, NVIDIA CORPORATION.  All rights reserved.
 *
 * NVIDIA CORPORATION and its licensors retain all intellectual property
 * and proprietary rights in and to this software, related documentation
 * and any modifications thereto.  Any use, reproduction, disclosure or
 * distribution of this software and related documentation without an express
 * license agreement from NVIDIA CORPORATION is strictly prohibited.
 */


#ifndef RENDER_MESH_ACTOR_H
#define RENDER_MESH_ACTOR_H

#include "Actor.h"
#include "Renderable.h"
#include "UserRenderResourceManager.h"  // For RenderCullMode
#include "foundation/PxVec3.h"

namespace nvidia
{
namespace apex
{

PX_PUSH_PACK_DEFAULT

class UserRenderInstanceBuffer;

struct RenderMeshActorRaycastFlags
{
    enum Enum
    {
        VISIBLE_PARTS = (1 << 0),
        INVISIBLE_PARTS =   (1 << 1),

        ALL_PARTS =         VISIBLE_PARTS | INVISIBLE_PARTS
    };
};

struct RenderMeshActorRaycastHitData
{
    float       time;

    uint32_t    partIndex;

    uint32_t    submeshIndex;

    uint32_t    vertexIndices[3];

    PxVec3      normal;

    PxVec3      tangent;

    PxVec3      binormal;
};


class RenderMeshActor : public Actor, public Renderable
{
public:

    enum
    {
        InvalidInstanceID = 0xFFFFFFFF
    };

    virtual bool                    getVisibilities(uint8_t* visibilityArray, uint32_t visibilityArraySize) const = 0;

    virtual bool                    setVisibility(bool visible, uint16_t partIndex = 0) = 0;

    virtual bool                    isVisible(uint16_t partIndex = 0) const = 0;

    virtual uint32_t                visiblePartCount() const = 0;

    virtual const uint32_t*         getVisibleParts() const = 0;

    virtual uint32_t                getBoneCount() const = 0;

    virtual void                    setTM(const PxMat44& tm, uint32_t boneIndex = 0) = 0;

    virtual void                    setTM(const PxMat44& tm, const PxVec3& scale, uint32_t boneIndex = 0) = 0;

    virtual void                    updateBounds() = 0;

    virtual const PxMat44           getTM(uint32_t boneIndex = 0) const = 0;

    virtual void                    setReleaseResourcesIfNothingToRender(bool value) = 0;

    virtual void                    setBufferVisibility(bool bufferVisibility) = 0;

    virtual void                    setOverrideMaterial(uint32_t submeshIndex, const char* overrideMaterialName) = 0;

    virtual void                    syncVisibility(bool useLock = true) = 0;

    virtual UserRenderInstanceBuffer* getInstanceBuffer() const = 0;
    virtual void                    setInstanceBuffer(UserRenderInstanceBuffer* instBuf) = 0;
    virtual void                    setMaxInstanceCount(uint32_t count) = 0;
    virtual void                    setInstanceBufferRange(uint32_t from, uint32_t count) = 0;

    virtual bool                    rayCast(RenderMeshActorRaycastHitData& hitData,
                                            const PxVec3& worldOrig, const PxVec3& worldDisp,
                                            RenderMeshActorRaycastFlags::Enum flags = RenderMeshActorRaycastFlags::VISIBLE_PARTS,
                                            RenderCullMode::Enum winding = RenderCullMode::CLOCKWISE,
                                            int32_t partIndex = -1) const = 0;

protected:

    virtual                         ~RenderMeshActor() {}
};

PX_POP_PACK

}
} // end namespace nvidia::apex

#endif // RENDER_MESH_ACTOR_H