hlsdk-xash3d/engine/physint.h

/*
physint.h - Server Physics Interface
Copyright (C) 2011 Uncle Mike

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
*/

#ifndef PHYSINT_H
#define PHYSINT_H

#define SV_PHYSICS_INTERFACE_VERSION		6

#define STRUCT_FROM_LINK( l, t, m )		((t *)((byte *)l - (int)&(((t *)0)->m)))
#define EDICT_FROM_AREA( l )			STRUCT_FROM_LINK( l, edict_t, area )

// values that can be returned with pfnServerState
#define SERVER_DEAD		0
#define SERVER_LOADING	1
#define SERVER_ACTIVE	2

typedef struct areanode_s
{
	int		axis;		// -1 = leaf node
	float		dist;
	struct areanode_s	*children[2];
	link_t		trigger_edicts;
	link_t		solid_edicts;
	link_t		water_edicts;	// func water
} areanode_t;

typedef struct server_physics_api_s
{
	// unlink edict from old position and link onto new
	void		( *pfnLinkEdict) ( edict_t *ent, qboolean touch_triggers );
	double		( *pfnGetServerTime )( void ); // unclamped
	double		( *pfnGetFrameTime )( void );	// unclamped
	void*		( *pfnGetModel )( int modelindex );
	areanode_t*	( *pfnGetHeadnode )( void ); // BSP tree for all physic entities
	int		( *pfnServerState )( void );
	void		( *pfnHost_Error )( const char *error, ... );	// cause Host Error
// ONLY ADD NEW FUNCTIONS TO THE END OF THIS STRUCT.  INTERFACE VERSION IS FROZEN AT 6
	struct triangleapi_s *pTriAPI;	// draw coliisions etc. Only for local system

	// draw debug messages (must be called from DrawOrthoTriangles). Only for local system
	int		( *pfnDrawConsoleString )( int x, int y, char *string );
	void		( *pfnDrawSetTextColor )( float r, float g, float b );
	void		( *pfnDrawConsoleStringLen )( const char *string, int *length, int *height );
	void		( *Con_NPrintf )( int pos, char *fmt, ... );
	void		( *Con_NXPrintf )( struct con_nprint_s *info, char *fmt, ... );
	const char	*( *pfnGetLightStyle )( int style ); // read custom appreance for selected lightstyle
	void		( *pfnUpdateFogSettings )( unsigned int packed_fog );
	char		**(*pfnGetFilesList)( const char *pattern, int *numFiles, int gamedironly );
	struct msurface_s	*(*pfnTraceSurface)( edict_t *pTextureEntity, const float *v1, const float *v2 );
	const byte	*(*pfnGetTextureData)( unsigned int texnum );

	// static allocations
	void		*(*pfnMemAlloc)( size_t cb, const char *filename, const int fileline );
	void		(*pfnMemFree)( void *mem, const char *filename, const int fileline );
} server_physics_api_t;

// physic callbacks
typedef struct physics_interface_s
{
	int		version;
	// passed through pfnCreate (0 is attempt to create, -1 is reject)
	int		( *SV_CreateEntity	)( edict_t *pent, const char *szName );
	// run custom physics for each entity (return 0 to use built-in engine physic)
	int		( *SV_PhysicsEntity	)( edict_t *pEntity );
	// spawn entities with internal mod function e.g. for re-arrange spawn order (0 - use engine parser, 1 - use mod parser)
	int		( *SV_LoadEntities )( const char *mapname, char *entities );
	// update conveyor belt for clients
	void		( *SV_UpdatePlayerBaseVelocity )( edict_t *ent );
	// The game .dll should return 1 if save game should be allowed
	int		( *SV_AllowSaveGame )( void );
// ONLY ADD NEW FUNCTIONS TO THE END OF THIS STRUCT.  INTERFACE VERSION IS FROZEN AT 6
	// override trigger area checking and touching
	int		( *SV_TriggerTouch )( edict_t *pent, edict_t *trigger );
	// some engine features can be enabled only through this function
	unsigned int	( *SV_CheckFeatures )( void );
	// used for draw debug collisions for custom physic engine etc
	void		( *DrawDebugTriangles )( void );
	// used for draw debug overlay (textured)
	void		( *DrawNormalTriangles )( void );
	// used for draw debug messages (2d mode)
	void		( *DrawOrthoTriangles )( void );
	// tracing entities with SOLID_CUSTOM mode on a server (not used by pmove code)
	void		( *ClipMoveToEntity)( edict_t *ent, const float *start, float *mins, float *maxs, const float *end, trace_t *trace );
	// tracing entities with SOLID_CUSTOM mode on a server (only used by pmove code)
	void		( *ClipPMoveToEntity)( struct physent_s *pe, const float *start, float *mins, float *maxs, const float *end, struct pmtrace_s *tr );
	// called at end the frame of SV_Physics call
	void		( *SV_EndFrame )( void );
	// called through save\restore process
	void		(*pfnCreateEntitiesInTransitionList)( SAVERESTOREDATA*, int levelMask );
	// called through save\restore process
	void		(*pfnCreateEntitiesInRestoreList)( SAVERESTOREDATA*, int createPlayers );
	// allocate custom string (e.g. using user implementation of stringtable, not engine strings)
	string_t		(*pfnAllocString)( const char *szValue );
	// make custom string (e.g. using user implementation of stringtable, not engine strings)
	string_t		(*pfnMakeString)( const char *szValue );
	// read custom string (e.g. using user implementation of stringtable, not engine strings)
	const char*	(*pfnGetString)( string_t iString );
	// helper for restore custom decals that have custom message (e.g. Paranoia)
	int		(*pfnRestoreDecal)( struct decallist_s *entry, edict_t *pEdict, qboolean adjacent );
} physics_interface_t;

#endif//PHYSINT_H