hlsdk-xash3d/cl_dll
Roman Chistokhodov f2f83cd035 Allow hud messages or arbitrary length 2019-04-11 20:07:41 +03:00
..
hl Always update gHUD.m_iFOV on SetFOV message. Fix #53 2018-04-01 20:38:56 +03:00
Android.mk Fix Android buil 2018-03-23 23:46:05 +03:00
CMakeLists.txt Made library functions hidden by default on Mac/Linux 2018-08-07 08:24:04 +01:00
GameStudioModelRenderer.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
GameStudioModelRenderer.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
GameStudioModelRenderer_Sample.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
GameStudioModelRenderer_Sample.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
MOTD.cpp Use line height from screen info in motd and scoreboard 2019-04-11 16:04:52 +03:00
Makefile Update README.md, update makefiles, add .bat scripts for msvc 2017-12-09 00:16:29 +03:00
StudioModelRenderer.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
StudioModelRenderer.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
ammo.cpp Fix compatibility with MSVC 6. 2017-10-15 00:12:26 +05:00
ammo.h Do not reorganize variables in classes. Add missing #pragma once directives and more #include guards. 2017-12-11 02:44:30 +05:00
ammo_secondary.cpp Reformat some strings yet. 2016-08-02 18:36:48 +05:00
ammohistory.cpp Client format. 2016-07-03 18:39:55 +05:00
ammohistory.h Do not reorganize variables in classes. Add missing #pragma once directives and more #include guards. 2017-12-11 02:44:30 +05:00
battery.cpp Client format. 2016-07-03 18:39:55 +05:00
camera.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
cdll_int.cpp Fix for goldsource running in fullscreen with resolution lower than screen's one (#67) 2018-11-29 15:22:17 +03:00
cl_dll.dsp Some cleanup. Add false_vgui include path to makefiles 2017-12-07 00:07:05 +03:00
cl_dll.h Do not reorganize variables in classes. Add missing #pragma once directives and more #include guards. 2017-12-11 02:44:30 +05:00
cl_util.h Add HUD_MessageBox. Rename isXashFWGS to IsXashFWGS 2018-04-02 23:57:09 +03:00
com_weapons.cpp Fix client build 2017-07-14 13:15:17 +00:00
com_weapons.h Do not reorganize variables in classes. Add missing #pragma once directives and more #include guards. 2017-12-11 02:44:30 +05:00
compile.bat Update README.md, update makefiles, add .bat scripts for msvc 2017-12-09 00:16:29 +03:00
death.cpp Apply some @AlliedModders's patches. 2017-06-29 18:56:03 +05:00
demo.cpp Client format. 2016-07-03 18:39:55 +05:00
demo.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
entity.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
ev_common.cpp Client format. 2016-07-03 18:39:55 +05:00
ev_hldm.cpp Some fixes for FoV, HUD, egon flare and new compilers. (#52) 2018-03-31 15:09:13 +03:00
ev_hldm.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
events.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
eventscripts.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
flashlight.cpp Do not show flashlight sprite in spectator mode. 2018-04-08 03:32:13 +05:00
geiger.cpp Apply some @AlliedModders's patches. 2017-06-29 18:56:03 +05:00
health.cpp Some fixes for FoV, HUD, egon flare and new compilers. (#52) 2018-03-31 15:09:13 +03:00
health.h Do not reorganize variables in classes. Add missing #pragma once directives and more #include guards. 2017-12-11 02:44:30 +05:00
hud.cpp Check for bad game data(missing or invalid hud.txt) 2018-04-02 23:57:09 +03:00
hud.h Some fixes for FoV, HUD, egon flare and new compilers. (#52) 2018-03-31 15:09:13 +03:00
hud_iface.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
hud_msg.cpp Always update gHUD.m_iFOV on SetFOV message. Fix #53 2018-04-01 20:38:56 +03:00
hud_redraw.cpp Add HUD_MessageBox. Rename isXashFWGS to IsXashFWGS 2018-04-02 23:57:09 +03:00
hud_servers.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
hud_servers.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
hud_servers_priv.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
hud_spectator.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
hud_spectator.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
hud_update.cpp Client format. 2016-07-03 18:39:55 +05:00
in_camera.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
in_defs.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
input.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
input_goldsource.cpp Reformat spaces to tabs in input_goldsource.cpp 2018-12-04 07:06:30 +03:00
input_mouse.cpp Add HUD_MessageBox. Rename isXashFWGS to IsXashFWGS 2018-04-02 23:57:09 +03:00
input_mouse.h Merge pull request #37 from nekonomicon/string_t 2017-12-11 17:53:08 +03:00
input_xash3d.cpp Use mouse input backend depending on the current engine 2017-12-03 23:52:35 +03:00
kbutton.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
menu.cpp Merge 136de25b61 2017-07-06 00:10:06 +05:00
message.cpp Allow hud messages or arbitrary length 2019-04-11 20:07:41 +03:00
overview.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
overview.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
parsemsg.cpp Client format. 2016-07-03 18:39:55 +05:00
parsemsg.h Do not reorganize variables in classes. Add missing #pragma once directives and more #include guards. 2017-12-11 02:44:30 +05:00
readme.txt Upload first port 2016-02-24 21:26:16 +00:00
saytext.cpp Client format. 2016-07-03 18:39:55 +05:00
scoreboard.cpp Use line height from screen info in motd and scoreboard 2019-04-11 16:04:52 +03:00
soundsystem.cpp Client format. 2016-07-03 18:39:55 +05:00
status_icons.cpp Apply some @AlliedModders's patches. 2017-06-29 18:56:03 +05:00
statusbar.cpp Rework initialization. 2016-08-02 16:59:22 +05:00
studio_util.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
studio_util.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
text_message.cpp Replace snprintf by _snprintf, for MSVC 2018-03-04 00:24:54 +03:00
tf_defs.h Revert some changes from PR 2016-08-08 15:01:16 +06:00
train.cpp Client format. 2016-07-03 18:39:55 +05:00
tri.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
util.cpp Fix client visual studio build 2017-01-10 16:45:52 +07:00
util_vector.h Do not reorganize variables in classes. Add missing #pragma once directives and more #include guards. 2017-12-11 02:44:30 +05:00
view.cpp All copyright symbols to (c) 2018-01-19 20:00:32 +03:00
view.h All copyright symbols to (c) 2018-01-19 20:00:32 +03:00

readme.txt

  client dll readme.txt
-------------------------

This file details the structure of the half-life client dll,  and
how it communicates with the half-life game engine.


Engine callback functions:

Drawing functions:
	HSPRITE SPR_Load( char *picname );
		Loads a sprite into memory, and returns a handle to it.

	int  SPR_Frames( HSPRITE sprite );
		Returns the number of frames stored in the specified sprite.

	int  SPR_Height( HSPRITE x, int frame )
		Returns the height, in pixels, of a sprite at the specified frame.  
		Returns 0 is the frame number or the sprite handle is invalid.

	int  SPR_Width( HSPRITE x, int f )
		Returns the width, in pixels, of a sprite at the specified frame.  
		Returns 0 is the frame number or the sprite handle is invalid.

	int  SPR_Set( HSPRITE sprite, int r, int g, int b );
		Prepares a sprite about to be drawn.  RBG color values are applied to the sprite at this time.


	void  SPR_Draw( int frame, int x, int y );
		Precondition:  SPR_Set has already been called for a sprite.
		Draws the currently active sprite to the screen,  at position (x,y), where (0,0) is
		the top left-hand corner of the screen.


	void  SPR_DrawHoles( int frame, int x, int y );
		Precondition:  SPR_Set has already been called for a sprite.
		Draws the currently active sprite to the screen.  Color index #255 is treated as transparent.

	void  SPR_DrawAdditive( int frame, int x, int y );
		Precondition:  SPR_Set has already been called for a sprite.
		Draws the currently active sprite to the screen,  adding it's color values to the background.

	void  SPR_EnableScissor( int x, int y, int width, int height );
		Creates a clipping rectangle.  No pixels will be drawn outside the specified area.  Will
		stay in effect until either the next frame,  or SPR_DisableScissor is called.

	void  SPR_DisableScissor( void );
		Disables the effect of an SPR_EnableScissor call.

	int	 IsHighRes( void );
		returns 1 if the res mode is 640x480 or higher;  0 otherwise.

	int	 ScreenWidth( void );
		returns the screen width, in pixels.

	int	 ScreenHeight( void );
		returns the screen height, in pixels.

// Sound functions
	void PlaySound( char *szSound, int volume )
		plays the sound 'szSound' at the specified volume.  Loads the sound if it hasn't been cached.
		If it can't find the sound,  it displays an error message and plays no sound.

	void PlaySound( int iSound, int volume )
		Precondition:  iSound has been precached.
		Plays the sound, from the precache list.


// Communication functions
	void  SendClientCmd( char *szCmdString );
		sends a command to the server,  just as if the client had typed the szCmdString at the console.

	char *GetPlayerName( int entity_number );
		returns a pointer to a string, that contains the name of the specified client.  
		Returns NULL if the entity_number is not a client.
		

	DECLARE_MESSAGE(),  HOOK_MESSAGE()
		These two macros bind the message sending between the entity DLL and the client DLL to
		the CHud object.

		HOOK_MESSAGE( message_name )
			 This is used inside CHud::Init().  It calls into the engine to hook that message
			 from the incoming message stream.
			 Precondition:  There must be a function of name UserMsg_message_name declared
			 for CHud.  Eg,  CHud::UserMsg_Health() must be declared if you want to 
			 use HOOK_MESSAGE( Health );

		DECLARE_MESSAGE( message_name )
			For each HOOK_MESSAGE you must have an equivalent DECLARE_MESSAGE.  This creates
			a function which passes the hooked messages into the CHud object.


	HOOK_COMMAND(),  DECLARE_COMMAND()
		These two functions declare and hook console commands into the client dll.
		
		HOOK_COMMAND( char *command, command_name )
			Whenever the user types the 'command' at the console,  the function 'command_name'
			will be called.
			Precondition: There must be a function of the name UserCmd_command_name declared
			for CHud. Eg,  CHud::UserMsg_ShowScores() must be declared if you want to
			use HOOK_COMMAND( "+showscores", ShowScores );

		DECLARE_COMMAND( command_name )
			For each HOOK_COMMAND you must have an equivelant DECLARE_COMMAND.  This creates
			a function which passes the hooked commands into the CHud object.