mirror of
https://github.com/luanti-org/luanti.git
synced 2025-10-30 15:05:32 +01:00
98 lines
3.4 KiB
C++
98 lines
3.4 KiB
C++
// Copyright (C) 2002-2012 Nikolaus Gebhardt
|
|
// This file is part of the "Irrlicht Engine".
|
|
// For conditions of distribution and use, see copyright notice in irrlicht.h
|
|
|
|
#pragma once
|
|
|
|
#include "IReferenceCounted.h"
|
|
#include "SMaterial.h"
|
|
#include "EHardwareBufferFlags.h"
|
|
|
|
namespace scene
|
|
{
|
|
//! Possible types of meshes.
|
|
// Note: Was previously only used in IAnimatedMesh so it still has the "animated" in the name.
|
|
// But can now be used for all mesh-types as we need those casts as well.
|
|
enum E_ANIMATED_MESH_TYPE
|
|
{
|
|
//! Unknown animated mesh type.
|
|
EAMT_UNKNOWN = 0,
|
|
|
|
//! generic skinned mesh
|
|
EAMT_SKINNED,
|
|
|
|
//! generic non-animated mesh
|
|
EAMT_STATIC
|
|
};
|
|
|
|
class IMeshBuffer;
|
|
|
|
//! Class which holds the geometry of an object.
|
|
/** An IMesh is nothing more than a collection of some mesh buffers
|
|
(IMeshBuffer). SMesh is a simple implementation of an IMesh.
|
|
A mesh is usually added to an IMeshSceneNode in order to be rendered.
|
|
*/
|
|
class IMesh : public virtual IReferenceCounted
|
|
{
|
|
public:
|
|
//! Get the amount of mesh buffers.
|
|
/** \return Amount of mesh buffers (IMeshBuffer) in this mesh. */
|
|
virtual u32 getMeshBufferCount() const = 0;
|
|
|
|
//! Get pointer to a mesh buffer.
|
|
/** \param nr: Zero based index of the mesh buffer. The maximum value is
|
|
getMeshBufferCount() - 1;
|
|
\return Pointer to the mesh buffer or 0 if there is no such
|
|
mesh buffer. */
|
|
virtual IMeshBuffer *getMeshBuffer(u32 nr) const = 0;
|
|
|
|
//! Get pointer to a mesh buffer which fits a material
|
|
/** \param material: material to search for
|
|
\return Pointer to the mesh buffer or 0 if there is no such
|
|
mesh buffer. */
|
|
virtual IMeshBuffer *getMeshBuffer(const video::SMaterial &material) const = 0;
|
|
|
|
//! Minetest binds textures (node tiles, object textures) to models.
|
|
// glTF allows multiple primitives (mesh buffers) to reference the same texture.
|
|
// This is reflected here: This function gets the texture slot for a mesh buffer.
|
|
/** \param meshbufNr: Zero based index of the mesh buffer. The maximum value is
|
|
getMeshBufferCount() - 1;
|
|
\return number of texture slot to bind to the given mesh buffer */
|
|
virtual u32 getTextureSlot(u32 meshbufNr) const
|
|
{
|
|
return meshbufNr;
|
|
}
|
|
|
|
//! Get an axis aligned bounding box of the mesh.
|
|
/** \return Bounding box of this mesh. */
|
|
virtual const core::aabbox3d<f32> &getBoundingBox() const = 0;
|
|
|
|
//! Set user-defined axis aligned bounding box
|
|
/** \param box New bounding box to use for the mesh. */
|
|
virtual void setBoundingBox(const core::aabbox3df &box) = 0;
|
|
|
|
//! Set the hardware mapping hint
|
|
/** This methods allows to define optimization hints for the
|
|
hardware. This enables, e.g., the use of hardware buffers on
|
|
platforms that support this feature. This can lead to noticeable
|
|
performance gains. */
|
|
virtual void setHardwareMappingHint(E_HARDWARE_MAPPING newMappingHint, E_BUFFER_TYPE buffer = EBT_VERTEX_AND_INDEX) = 0;
|
|
|
|
//! Flag the meshbuffer as changed, reloads hardware buffers
|
|
/** This method has to be called every time the vertices or
|
|
indices have changed. Otherwise, changes won't be updated
|
|
on the GPU in the next render cycle. */
|
|
virtual void setDirty(E_BUFFER_TYPE buffer = EBT_VERTEX_AND_INDEX) = 0;
|
|
|
|
//! Returns the type of the meshes.
|
|
/** This is useful for making a safe downcast.
|
|
Note: It's no longer just about animated meshes, that name has just historical reasons.
|
|
\returns Type of the mesh */
|
|
virtual E_ANIMATED_MESH_TYPE getMeshType() const
|
|
{
|
|
return EAMT_STATIC;
|
|
}
|
|
};
|
|
|
|
} // end namespace scene
|