Iinstall / info
I've made this scripting utility for people who want to show a point relative to an origin/entity on-screen. This is also useful on making objective points.
It only works with the reborn patch.
============================================
How to install (you might know it already) :
put huddraw_3d.pk3 in your mohaa installation/main.
============================================
Here is the documentation on how it works :
=============================================================================================================================================================================
/*
* global/huddraw_3d.scr::worldtoscreen : convert a vector (origin) to a screen rectangle
* a player must be specified when calling it (like local.player thread global/huddraw_3d.scr::worldtoscreen)
* parameters :
* local.origin : the vector to convert to a screen rectangle
* result :
* return an array : [0] is the screenX, [1] is the screenY and [2] specify whether if the origin can be shown or not from the player's view
* example :
* local.rect = $player thread global/huddraw_3d.scr::worldtoscreen ( 0 0 0 )
* local.sizeX = local.rect[0]
* local.sizeY = local.rect[1]
* local.shown = local.rect[2]
\*
=============================================================================================================================================================================
/*
* global/huddraw_3d.scr::add3dpoint : show a 3D icon in-game for a player
* a player must be specified when calling it (like local.player thread global/huddraw_3d.scr::add3dpoint)
* parameters :
* local.id : identifier of the huddraw element
* local.origin : point origin. If local.entity is specified local.origin will be the vector offset for the point from the specified entity
* local.string : like the (not working) print3d, it show a string in this location (but is forced to ignore the distance)
* local.font [OPTIONAL] : Font to use if local.string is specified. This parameter will be ignored if local.string is not specified. The default font is "facfont-20".
* local.shader : shader to show at the origin
* local.ignoredistance : if set to 1, the shader will not be auto-sized from the player relative to the point's and local.sizeX and local.sizeY must be specified
* local.sizeX : width size of the shader (default 32)
* local.sizeY : height size of the shader (default 32)
* local.refreshdelay : a number that specify how much to wait before refreshing. Setting "frame" will refresh each server frame. (default "frame")
* local.entity [OPTIONAL] : entity to follow. If this parameter is specified, local.origin will be the vector offset for the point from the specified entity
* remarks :
* local.string and local.shader mustn't be specified both
* local.sizeX and local.sizeY can be specified only if local.ignoredistance isn't set to 0
* example:
* $player thread global/huddraw_3d.scr::add3dpoint 200 ( 0 0 0 ) NIL "textures/hud/allies.tga" 1 32 32 "frame"
* $player thread global/huddraw_3d.scr::add3dpoint 180 ( 0 0 0 ) "ENTITY#1" NIL 0 NIL NIL "frame" $entity_1
\*
=============================================================================================================================================================================
/*
* change3dpoint_X : change a 3D point property for a player
*
* available functions :
*
* change3dpoint_followent -> params : ( Integer ID, Entity entity )
* change3dpoint_font -> params : ( Integer ID, String font )
* change3dpoint_ignoredistance -> params : ( Integer ID, Boolean ignore_distance )
* change3dpoint_origin -> params : ( Integer ID, Vector origin )
* change3dpoint_refreshdelay -> params : ( Integer ID, Integer refreshdelay )
* change3dpoint_shader -> params : ( Integer ID, String shader )
* change3dpoint_size -> params : ( Integer ID, Integer sizeX, Integer sizeY )
* change3dpoint_string -> params : ( Integer ID, String string )
*
* See add3dpoint documentation for more informations on what these functions can do
*
* returns 1 on success, 0 otherwise
\*
=============================================================================================================================================================================
/*
* change3dpoint_followent
* see add3dpoint documentation for more
* parameters :
* local.id : identifier of the huddraw element
* local.entity : entity to follow. If local.entity is NULL/NIL, then it will make the point stop following the entity
* example :
* $player thread global/huddraw_3d.scr::change3dpoint_followent 180 $entity_2
* $player thread global/huddraw_3d.scr::change3dpoint_followent 180 NIL
\*
=============================================================================================================================================================================
/*
* remove3dpoint : remove a 3D point from a player
* parameters :
* local.id : 3D point id to remove from the player
\*/
|
moh_huddraw_3d.zip (249)