My Project
Public Member Functions | Public Attributes | List of all members
ParaEngine::CBlockLightGridServer Class Reference

block grid on server side. More...

#include <BlockLightGridServer.h>

Inheritance diagram for ParaEngine::CBlockLightGridServer:
ParaEngine::CBlockLightGridBase ParaEngine::IAttributeFields ParaEngine::IObject ParaEngine::CRefCounted

Public Member Functions

 CBlockLightGridServer (CBlockWorld *pBlockWorld)
 
virtual void OnEnterWorld ()
 
virtual void OnLeaveWorld ()
 
virtual void OnWorldMove (uint16_t centerChunkX, uint16_t centerChunkZ)
 
virtual void UpdateLighting ()
 
virtual bool GetBrightness (Uint16x3 &blockId, uint8_t *brightness, int nSize=27, int nLightType=-1)
 
virtual void SetLightDirty (Uint16x3 &blockId_ws, bool isSunLight)
 
virtual void AddDirtyColumn (uint16_t chunkX_ws, uint16_t chunkZ_ws)
 update all blocks in the given chunk column. More...
 
virtual int GetDirtyColumnCount ()
 get the number of remaining dirty column
 
- Public Member Functions inherited from ParaEngine::CBlockLightGridBase
 CBlockLightGridBase (CBlockWorld *pBlockWorld)
 
 ATTRIBUTE_DEFINE_CLASS (CBlockLightGridBase)
 
virtual int InstallFields (CAttributeClass *pClass, bool bOverride)
 this class should be implemented if one wants to add new attribute. More...
 
 ATTRIBUTE_METHOD1 (CBlockLightGridBase, GetDirtyColumnCount_s, int *)
 
 ATTRIBUTE_METHOD1 (CBlockLightGridBase, GetDirtyBlockCount_s, int *)
 
 ATTRIBUTE_METHOD1 (CBlockLightGridBase, GetLightGridSize_s, int *)
 
 ATTRIBUTE_METHOD1 (CBlockLightGridBase, GetLightCalculationStep_s, int *)
 
 ATTRIBUTE_METHOD1 (CBlockLightGridBase, SetLightCalculationStep_s, int)
 
virtual void SetLightDirty (Uint16x3 &blockId_ws, bool isSunLight, int8 nUpdateRange=0)
 only call this function from main thread when you have a write lock on block world to ensure thread safety. More...
 
virtual void NotifyBlockHeightChanged (uint16_t blockIdX_ws, uint16_t blockIdZ_ws, ChunkMaxHeight &prevBlockHeight)
 
virtual void SetColumnPreloaded (uint16_t chunkX_ws, uint16_t chunkZ_ws)
 set the given column loaded. More...
 
virtual void SetColumnUnloaded (uint16_t chunkX_ws, uint16_t chunkZ_ws)
 this is called when chunk column is loaded possibly due to region unload. More...
 
virtual int GetDirtyBlockCount ()
 get the number of remaining dirty blocks
 
virtual int GetLightGridSize ()
 get the light grid chunk size
 
virtual void SetLightGridSize (int nSize)
 Set the light grid chunk size.
 
virtual void SetLightCalculationStep (uint32 nTicks)
 how many lighting to calculate per tick for the lighting thread. More...
 
virtual uint32 GetLightCalculationStep () const
 
virtual int ForceAddChunkColumn (int nChunkWX, int nChunkWZ)
 function to refresh the a given chunk column. More...
 
virtual int GetForcedChunkColumnCount ()
 get the number of forced column still in the queue. More...
 
void SuspendLightUpdate ()
 
void ResumeLightUpdate ()
 
bool IsLightUpdateSuspended ()
 
- Public Member Functions inherited from ParaEngine::IAttributeFields
virtual int GetAttributeClassID ()
 attribute class ID should be identical, unless one knows how overriding rules work. More...
 
virtual const char * GetAttributeClassName ()
 a static string, describing the attribute class object's name
 
virtual const char * GetAttributeClassDescription ()
 a static string, describing the attribute class object
 
virtual int GetChildAttributeColumnCount ()
 we support multi-dimensional child object. More...
 
virtual int GetChildAttributeObjectCount (int nColumnIndex=0)
 get the number of child objects (row count) in the given column. More...
 
virtual IAttributeFieldsGetChildAttributeObject (int nRowIndex, int nColumnIndex=0)
 
virtual IAttributeFieldsGetChildAttributeObject (const std::string &sName)
 get attribute by child object. More...
 
 ATTRIBUTE_METHOD1 (IAttributeFields, GetName_s, const char **)
 
 ATTRIBUTE_METHOD1 (IAttributeFields, SetName_s, const char *)
 
 ATTRIBUTE_METHOD (IAttributeFields, PrintObject_s)
 
 ATTRIBUTE_METHOD (IAttributeFields, AddRef_s)
 
 ATTRIBUTE_METHOD1 (IAttributeFields, GetRefCount_s, int *)
 
 ATTRIBUTE_METHOD1 (IAttributeFields, SetTime_s, int)
 
 ATTRIBUTE_METHOD1 (IAttributeFields, GetTime_s, int *)
 
 ATTRIBUTE_METHOD (IAttributeFields, Release_s)
 
virtual const std::string & GetIdentifier ()
 
virtual void SetIdentifier (const std::string &sID)
 
virtual bool IsModified ()
 whether some of the fields are modified.It is up to the implementation class to provide this functionality if necessary. More...
 
virtual void SetModified (bool bModified)
 set whether any field has been modified. More...
 
virtual bool ValidateFields ()
 validate all fields and return true if validation passed. More...
 
virtual string GetValidationMessage ()
 get the recent validation message due to the most recent call to ValidateFields()
 
virtual bool ResetField (int nFieldID)
 Reset the field to its initial or default value. More...
 
virtual bool InvokeEditor (int nFieldID, const std::string &sParameters)
 Invoke an (external) editor for a given field. More...
 
virtual bool AddChildAttributeObject (IAttributeFields *pChild, int nRowIndex=-1, int nColumnIndex=0)
 add child object. More...
 
virtual void * QueryObjectByName (const std::string &sObjectType)
 convert to object of a given type. More...
 
virtual void * QueryObject (int nObjectType)
 convert to object of a given type. More...
 
virtual int GetTime ()
 get the current local time in case it is animated in milli seconds frames. More...
 
virtual void SetTime (int nTime)
 
virtual CDynamicAttributeFieldGetDynamicField (const std::string &sName)
 Get a dynamic field with a given name. More...
 
virtual CDynamicAttributeFieldGetDynamicField (int nIndex)
 Get a dynamic field with a given index. More...
 
virtual const char * GetDynamicFieldNameByIndex (int nIndex)
 get field name by index
 
virtual int GetDynamicFieldCount ()
 how many dynamic field this object currently have. More...
 
virtual int SetDynamicField (const std::string &sName, const CVariable &value)
 set a dynamic field with a given name. More...
 
virtual int AddDynamicField (const std::string &sName, ATTRIBUTE_FIELDTYPE dwType)
 add dynamic field and return field index
 
virtual void RemoveAllDynamicFields ()
 remove all dynamic fields
 
virtual int SaveDynamicFieldsToString (std::string &output)
 save only text dynamic fields to fieldname = value text strings. More...
 
virtual int LoadDynamicFieldsFromString (const std::string &input)
 load only text dynamic fields from string More...
 
CAttributeClassGetAttributeClass ()
 get the main attribute class object. More...
 
void PrintObject ()
 print the content of this object to a text file at temp/doc/[ClassName].txt. More...
 
- Public Member Functions inherited from ParaEngine::IObject
virtual void Clone (IObject *obj) const
 Clone the object's contains to a pointer. More...
 
virtual IObjectClone () const
 Clone the object's contains and return a pointer to the newly created object. More...
 
virtual bool Equals (const IObject *obj) const
 Compare the object with another object. More...
 
virtual const ITypeGetType () const
 
virtual std::string ToString () const
 
WeakPtr_typeGetWeakReference ()
 get weak reference object. More...
 
virtual int ProcessObjectEvent (const ObjectEvent &event)
 this function is only used to backward compatibility of ParaObject:AddEvent() function. More...
 
- Public Member Functions inherited from ParaEngine::CRefCounted
void addref () const
 add reference count of the object. More...
 
bool delref () const
 decrease reference count of the object. More...
 
int GetRefCount () const
 get the reference count
 
virtual int Release ()
 
CRefCountedAddToAutoReleasePool ()
 addref and releases the ownership sometime soon automatically (usually at the end of the current frame). More...
 

Public Attributes

int m_max_cells_per_frame
 max number of cells(blocks) to calculate per frame. More...
 
int m_max_cells_left_per_frame
 max number of cells(blocks) to left un-calculated per frame. More...
 

Additional Inherited Members

- Public Types inherited from ParaEngine::CBlockLightGridBase
enum  CellType { cp_empty, cp_light, cp_obstructure }
 
- Public Types inherited from ParaEngine::IAttributeFields
typedef ParaEngine::weak_ptr< IObject, IAttributeFieldsWeakPtr_type
 
- Public Types inherited from ParaEngine::IObject
typedef ParaEngine::weak_ptr< IObjectWeakPtr_type
 
- Static Public Member Functions inherited from ParaEngine::IAttributeFields
static HRESULT GetAttributeClassID_s (IAttributeFields *cls, int *p1)
 
static HRESULT GetAttributeClassName_s (IAttributeFields *cls, const char **p1)
 
static bool OpenWithDefaultEditor (const char *sFilename, bool bWaitOnReturn=false)
 Open a given file with the default registered editor in the game engine. More...
 
- Protected Member Functions inherited from ParaEngine::CBlockLightGridBase
BlockIndex CalcLightDataIndex (const Uint16x3 &blockId, bool bCreateIfNotExist=true)
 
LightDataGetLightData (const BlockIndex &index)
 
LightDataGetLightData (uint16_t x, uint16_t y, uint16_t z, bool bCreateIfNotExist=true)
 
BlockChunkGetChunk (uint16_t x, uint16_t y, uint16_t z, bool bCreateIfNotExist=true)
 
- Protected Member Functions inherited from ParaEngine::IAttributeFields
virtual CAttributeClassCreateAttributeClass ()
 initialize fields
 
virtual CDynamicAttributesSetGetDynamicAttributes (bool bCreateIfNotExist=false)
 
- Protected Attributes inherited from ParaEngine::CBlockLightGridBase
bool m_suspendLightUpdate
 
CBlockWorldm_pBlockWorld
 
int32 m_nLightGridChunkSize
 
uint32 m_nLightCalculationStep
 
- Protected Attributes inherited from ParaEngine::IObject
WeakPtr_type m_weak_reference
 
- Protected Attributes inherited from ParaEngine::CRefCounted
int m_refcount
 

Detailed Description

block grid on server side.

unlike like Client, it will compute to completion immediately.

Member Function Documentation

§ AddDirtyColumn()

void ParaEngine::CBlockLightGridServer::AddDirtyColumn ( uint16_t  chunkX_ws,
uint16_t  chunkZ_ws 
)
virtual

update all blocks in the given chunk column.

A chunk column is all chunks with same x,z

Reimplemented from ParaEngine::CBlockLightGridBase.

Member Data Documentation

§ m_max_cells_left_per_frame

int ParaEngine::CBlockLightGridServer::m_max_cells_left_per_frame

max number of cells(blocks) to left un-calculated per frame.

When a scene is first loaded, there can be large number of blocks to calculate. and it is better finish loading them at start up time, instead of spreading into many frames. So this value is usually some big value.

§ m_max_cells_per_frame

int ParaEngine::CBlockLightGridServer::m_max_cells_per_frame

max number of cells(blocks) to calculate per frame.

Smaller value gives better frame rate during frame load time.


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