Inheritance diagram for plSurfaceResource:

[legend]

Public Member Functions
const plSurfaceResourceDescriptor &	GetDescriptor () const

bool	InteractWithSurface (plWorld pWorld, plGameObjectHandle hObject, const plVec3 &vPosition, const plVec3 &vSurfaceNormal, const plVec3 &vIncomingDirection, const plTempHashedString &sInteraction, const plUInt16 pOverrideTeamID, float fImpulseSqr=0.0f) const
	Spawns the prefab that was defined for the given interaction at the given position and using the configured orientation. Returns false, if the interaction type was not defined in this surface or any of its base surfaces.

bool	IsBasedOn (const plSurfaceResource *pThisOrBaseSurface) const

bool	IsBasedOn (const plSurfaceResourceHandle hThisOrBaseSurface) const

Public Member Functions inherited from plResource
PL_ALWAYS_INLINE const plString &	GetResourceID () const
	Returns the unique ID that identifies this resource. On a file resource this might be a path. Can also be a GUID or any other scheme that uniquely identifies the resource.

PL_ALWAYS_INLINE plUInt64	GetResourceIDHash () const
	Returns the hash of the unique ID.

void	SetResourceDescription (plStringView sDescription)
	The resource description allows to store an additional string that might be more descriptive during debugging, than the unique ID.

const plString &	GetResourceDescription () const
	The resource description allows to store an additional string that might be more descriptive during debugging, than the unique ID.

const plString &	GetResourceIdOrDescription () const
	The returns the resource description, if available, otherwise the resource ID.

PL_ALWAYS_INLINE plResourceState	GetLoadingState () const
	Returns the current state in which this resource is in.

PL_ALWAYS_INLINE plUInt8	GetNumQualityLevelsDiscardable () const
	Returns the current maximum quality level that the resource could have.

PL_ALWAYS_INLINE plUInt8	GetNumQualityLevelsLoadable () const
	Returns how many quality levels the resource may additionally load.

float	GetLoadingPriority (plTime now) const
	Returns the priority that is used by the resource manager to determine which resource to load next.

plResourcePriority	GetPriority () const
	Returns the current resource priority.

void	SetPriority (plResourcePriority priority)
	Changes the current resource priority.

PL_ALWAYS_INLINE const plBitflags< plResourceFlags > &	GetBaseResourceFlags () const
	Returns the basic flags for the resource type. Mostly used the resource manager.

PL_ALWAYS_INLINE const MemoryUsage &	GetMemoryUsage () const
	Returns the information about the current memory usage of the resource.

PL_ALWAYS_INLINE plTime	GetLastAcquireTime () const
	Returns the time at which the resource was (tried to be) acquired last. If a resource is acquired using plResourceAcquireMode::PointerOnly, this does not update the last acquired time, since the resource is not acquired for full use.

PL_ALWAYS_INLINE plInt32	GetReferenceCount () const
	Returns the reference count of this resource.

PL_ALWAYS_INLINE const plTimestamp &	GetLoadedFileModificationTime () const
	Returns the modification date of the file from which this resource was loaded.

PL_ALWAYS_INLINE plUInt32	GetCurrentResourceChangeCounter () const
	Returns the current value of the resource change counter. Can be used to detect whether the resource has changed since using it last time.

PL_ALWAYS_INLINE void	IncResourceChangeCounter ()
	Allows to manually increase the resource change counter to signal that dependent code might need to update.

virtual void	ResetResource ()
	If the resource has modifications from the original state, it should reset itself to that state now (or force a reload on itself).

void	PrintHandleStackTraces ()
	Prints the stack-traces for all handles that currently reference this resource.

Public Member Functions inherited from plReflectedClass
virtual const plRTTI *	GetDynamicRTTI () const

bool	IsInstanceOf (const plRTTI *pType) const
	Returns whether the type of this instance is of the given type or derived from it.

template<typename T >
PL_ALWAYS_INLINE bool	IsInstanceOf () const
	Returns whether the type of this instance is of the given type or derived from it.

Public Attributes
void *	m_pPhysicsMaterialPhysX = nullptr

void *	m_pPhysicsMaterialJolt = nullptr

Public Attributes inherited from plResource
plEvent< const plResourceEvent &, plMutex >	m_ResourceEvents

Static Public Attributes
static plEvent< const plSurfaceResourceEvent &, plMutex >	s_Events

Private Member Functions
virtual plResourceLoadDesc	UnloadData (Unload WhatToUnload) override
	Requests the resource to unload another quality level. If bFullUnload is true, the resource should unload all data, because it is going to be deleted afterwards.

virtual plResourceLoadDesc	UpdateContent (plStreamReader *Stream) override
	Called whenever more data for the resource is available. The resource must read the stream to update it's data.

virtual void	UpdateMemoryUsage (MemoryUsage &out_NewMemoryUsage) override
	This function must be overridden by all resource types.

Additional Inherited Members
Static Public Member Functions inherited from plNoBase
static const plRTTI *	GetStaticRTTI ()

Protected Types inherited from plResource
enum class	DoUpdate { OnMainThread , OnAnyThread }

enum class	Unload { AllQualityLevels , OneQualityLevel }

Protected Member Functions inherited from plResource
	plResource (DoUpdate ResourceUpdateThread, plUInt8 uiQualityLevelsLoadable)
	Default constructor.

virtual	~plResource ()
	virtual destructor.

MemoryUsage &	ModifyMemoryUsage ()
	Non-const version for resources that want to write this variable directly.

void	SetIsReloadable (bool bIsReloadable)
	Call this to specify whether a resource is reloadable.

void	SetHasLoadingFallback (bool bHasLoadingFallback)
	Used internally by the code injection macros.

Member Function Documentation

◆ InteractWithSurface()

bool plSurfaceResource::InteractWithSurface	(	plWorld *	pWorld,
		plGameObjectHandle	hObject,
		const plVec3 &	vPosition,
		const plVec3 &	vSurfaceNormal,
		const plVec3 &	vIncomingDirection,
		const plTempHashedString &	sInteraction,
		const plUInt16 *	pOverrideTeamID,
		float	fImpulseSqr = 0.0f ) const

Spawns the prefab that was defined for the given interaction at the given position and using the configured orientation. Returns false, if the interaction type was not defined in this surface or any of its base surfaces.

Todo: do random deviation, make sure to clamp max deviation angle

◆ UnloadData()

plResourceLoadDesc plSurfaceResource::UnloadData ( Unload WhatToUnload )

overrideprivatevirtual

Requests the resource to unload another quality level. If bFullUnload is true, the resource should unload all data, because it is going to be deleted afterwards.

Implements plResource.

◆ UpdateContent()

plResourceLoadDesc plSurfaceResource::UpdateContent ( plStreamReader * pStream )

overrideprivatevirtual

Called whenever more data for the resource is available. The resource must read the stream to update it's data.

pStream may be nullptr in case the resource data could not be found.

Implements plResource.

◆ UpdateMemoryUsage()

void plSurfaceResource::UpdateMemoryUsage ( MemoryUsage & out_NewMemoryUsage )

overrideprivatevirtual

This function must be overridden by all resource types.

It has to compute the memory used by this resource. It is called by the resource manager whenever the resource's data has been loaded or unloaded.

Implements plResource.

The documentation for this class was generated from the following files:

Code/Engine/Core/Physics/SurfaceResource.h
Code/Engine/Core/Physics/Implementation/SurfaceResource.cpp

Public Member Functions

Public Attributes

Static Public Attributes

Private Member Functions

Additional Inherited Members

Member Function Documentation

◆ InteractWithSurface()

◆ UnloadData()

◆ UpdateContent()

◆ UpdateMemoryUsage()