Multi Theft Auto: Wiki - User contributions [en]

GetPedBonePosition

2012-07-15T12:06:52Z

Dre -+-: /* Example */

__NOTOC__
{{Client function}}
Returns the 3D world coordinates of a specific bone of a given ped.

==Syntax==
<syntaxhighlight lang="lua">
float float float getPedBonePosition ( ped thePed, int bone )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' the ped you want to inspect.
*'''bone:''' the number of the bone to get the position of.

[[Image:Bones.jpg|thumb|Bone numbers]]

<div style="border: 3px red solid; margin-bottom:3px; padding-left:5px;">
*'''1:''' BONE_PELVIS1
*'''2:''' BONE_PELVIS
*'''3:''' BONE_SPINE1
*'''4:''' BONE_UPPERTORSO
*'''5:''' BONE_NECK
*'''6:''' BONE_HEAD2
*'''7:''' BONE_HEAD1
*'''8:''' BONE_HEAD
*'''21:''' BONE_RIGHTUPPERTORSO
*'''22:''' BONE_RIGHTSHOULDER
*'''23:''' BONE_RIGHTELBOW
*'''24:''' BONE_RIGHTWRIST
*'''25:''' BONE_RIGHTHAND
*'''26:''' BONE_RIGHTTHUMB
*'''31:''' BONE_LEFTUPPERTORSO
*'''32:''' BONE_LEFTSHOULDER
*'''33:''' BONE_LEFTELBOW
*'''34:''' BONE_LEFTWRIST
*'''35:''' BONE_LEFTHAND
*'''36:''' BONE_LEFTTHUMB
*'''41:''' BONE_LEFTHIP
*'''42:''' BONE_LEFTKNEE
*'''43:''' BONE_LEFTANKLE
*'''44:''' BONE_LEFTFOOT
*'''51:''' BONE_RIGHTHIP
*'''52:''' BONE_RIGHTKNEE
*'''53:''' BONE_RIGHTANKLE
*'''54:''' BONE_RIGHTFOOT
</div>

===Returns===
Returns the x, y, z world position of the bone.

==Example==
This example renders name tags above a player's head bone.
<syntaxhighlight lang="lua">
addEventHandler( "onClientRender",root,
function( )
local px, py, pz, tx, ty, tz, dist
px, py, pz = getCameraMatrix( )
for _, v in ipairs( getElementsByType 'player' ) do
tx, ty, tz = getElementPosition( v )
dist = math.sqrt( ( px - tx ) ^ 2 + ( py - ty ) ^ 2 + ( pz - tz ) ^ 2 )
if dist < 30.0 then
if isLineOfSightClear( px, py, pz, tx, ty, tz, true, false, false, true, false, false, false,localPlayer ) then
local sx, sy, sz = getPedBonePosition( v, 5 )
local x,y = getScreenFromWorldPosition( sx, sy, sz + 0.3 )
if x then -- getScreenFromWorldPosition returns false if the point isn't on screen
dxDrawText( getPlayerName( v ), x, y, x, y, tocolor(150, 50, 0), 0.85 + ( 15 - dist ) * 0.02, "bankgothic" )
end
end
end
end
end
)
</syntaxhighlight>

==Example 2==
This one draw all local player's bones
<syntaxhighlight lang="lua">
addEventHandler('onClientRender', root, function()
for bone = 1, 54 do
local bonePos = {getPedBonePosition(localPlayer, bone)}
if bonePos[1] then
local screen = {getScreenFromWorldPosition(unpack(bonePos))}
if screen[1] then
dxDrawText(''..bone, screen[1], screen[2])
end
end
end
end)
</syntaxhighlight>

==See Also==
{{Client_ped_functions}}

[[ru:GetPedBonePosition]]

GetScreenFromWorldPosition

2011-12-02T17:00:38Z

Dre -+-:

__NOTOC__
{{Client function}}
This function gets the screen position of a point in the world. This is useful for attaching 2D gui elements to parts of the world (e.g. players) or detecting if a point is on the screen (though it does not check if it is actually visible, you should use [[processLineOfSight]] for that).

==Syntax==
<syntaxhighlight lang="lua">
float float float getScreenFromWorldPosition ( float x, float y, float z, [ float edgeTolerance=0, bool relative=true ] )
</syntaxhighlight>

===Required Arguments===
*'''x:''' A float value indicating the x position in the world.
*'''y:''' A float value indicating the y position in the world.
*'''z:''' A float value indicating the z position in the world.

===Optional Arguments===
{{OptionalArg}}
{{New feature/item|3|1.0||
*'''edgeTolerance:''' A [[float]] value indicating the distance the position can be off screen before the function returns false.
*'''relative:''' A [[boolean]] value that indicates if edgeTolerance is in pixels [false], or relative to the screen size [true].
}}

===Returns===
Returns two ''x'', ''y'' [[float]]s indicating the screen position and [[float]] distane betwen screen and given position if successful, ''false'' otherwise.

==See Also==
{{Client_world_functions}}

File:Dvision.png

2011-10-17T15:51:15Z

Dre -+-:

Resource:Detective vision

2011-10-17T15:44:46Z

Dre -+-: Created page with "{{Resource page}} This resource able players to see other ped/players below walls and check theys info. You can download it [http://community.multitheftauto.com/index.php?p=resou..."

{{Resource page}}
This resource able players to see other ped/players below walls and check theys info.
You can download it [http://community.multitheftauto.com/index.php?p=resources&s=details&id=2074 here]. <br><br>
[[Image:Dvision.png|thumb|How its looks]]

==Exported Functions==

===addWindowInfo===
<section name="Client" class="client" show="true">
By this function you can add custom values in info window.

==Syntax==
<syntaxhighlight lang="lua">
bool [string] addWindowInfo ( { string valueName, string elementData, string/nil element, [ { table childValue1, table childValue2, ...} ] } )
</syntaxhighlight>

==Required Arguments==
*'''valueName''': Name of value what will shows in window
*'''elementData''': Name of element data from what it will get values
*'''element''': Type of element for what will shows this value, can be "player", "ped" or nil for both

==Returns==
Returns true or false and error message if otherwise.
</section>

===removeWindowInfo===
<section name="Client" class="client" show="true">
By this function you can add remove values from info window.

==Syntax==
<syntaxhighlight lang="lua">
bool [string] removeWindowInfo ( string valueName [, string elementData, string element ] )
</syntaxhighlight>

==Required Arguments==
*'''valueName''': Name of value what shows in window

==Optimal Arguments==
*'''elementData''': Name of element data from what it get values
*'''element''': Type of element for what shows this value, can be "player" or "ped"

==Returns==
Returns true or false if otherwise.
</section>

==See also==
[http://forum.mtasa.com/viewtopic.php?f=108&t=32886&p=345513#p345513 MTA Forum topic]

EngineReplaceModel

2011-10-01T06:45:07Z

Dre -+-:

__NOTOC__
{{Client function}}
This function replaces the given model in the given model ID with the DFF file passed. This function supports vehicles and objects at the moment.

As of 1.1.1 This supports Ped and Weapon models. For replace weapon models you can't use weapon ID's, you should use object ID's. All weapon model ID's here: [[Weapons]].

Note: Due to a bug, when replacing models with built in collisions (i.e. vehicles), the collision may not get replaced correctly. The current work around is to load the dff again and do another replace after a short delay.

==Syntax==
<syntaxhighlight lang="lua">
bool engineReplaceModel ( dff theModel, int modelID )
</syntaxhighlight>

===Required Arguments===
*'''theModel:''' The model to replace the given model ID with
*'''modelID:''' The model it to replace the model of

===Returns===
Returns ''true'' if the model was successfully replaced, ''false'' if it failed for some reason, ie. the DFF or the model ID is not valid.

==Example==
'''Example 1:'''
<section name="Client" class="client" show="true">
Client-Side example for replacing vehicle model and texture with custom ones.
<syntaxhighlight lang="lua">
function ReplaceVehicle ( )
outputChatBox ( "> replacing the euros vehicle" )

txd = engineLoadTXD ( "data/euros.txd" )
engineImportTXD ( txd, 587 )
dff = engineLoadDFF ( "data/euros.dff", 587 )
engineReplaceModel ( dff, 587 )
end

addEvent ( "replaceVeh", true )
addEventHandler ( "replaceVeh", getRootElement(), ReplaceVehicle )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
Server-side example function for triggering the replace.
<syntaxhighlight lang="lua">
function ReplaceCommand ( )
triggerClientEvent( "replaceVeh", getRootElement(), replaceVeh )
end
addCommandHandler( "replace", ReplaceCommand )
</syntaxhighlight>
</section>

'''Example 2:'''
<section name="Client" class="client" show="true">
Client-Side example for replacing object model, collision and texture with custom ones.
<syntaxhighlight lang="lua">
function ReplaceObject ( )

txd = engineLoadTXD( "MyModel.txd" )
col = engineLoadCOL( "MyModel.col" )
dff = engineLoadDFF( "MyModel.dff", 0 ) --modelid is everytime 0, when you replace no vehicle

engineImportTXD( txd, 1234 )
engineReplaceCOL( col, 1234 )
engineReplaceModel( dff, 1234 )-- replace the model at least

end

addEvent ( "replaceObj", true )
addEventHandler ( "replaceObj", getRootElement(), ReplaceObject )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
Server-side example function for triggering the replace.
<syntaxhighlight lang="lua">
function ReplaceCommand ( )
triggerClientEvent( "replaceObj", getRootElement(), replaceObj )
end
addCommandHandler( "replace", ReplaceCommand )
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

GetKeyBoundToCommand

2011-08-20T09:52:44Z

Dre -+-:

{{Client function}}
This function allow you get first key binded to command.

==Syntax==
<syntaxhighlight lang="lua">
string getKeyBoundToCommand( string command )
</syntaxhighlight>

===Required Arguments===
*'''command:''' command what you need check.

===Returns===
Returns a string of first key binded to current command.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function yourFunction()
--your function here
end

addCommandHandler("bindedcommand",yourFunction)
function bindHandler()
local bindedKey = getKeyBoundToCommand("bindedcommand") --get binded key
if not bindedKey then
bindedKey = "z"
bindKey(bindedKey,"down","bindedcommand") --if key is not exist then bind it by syntax 2
end
outputChatBox("Press '"..bindedKey.."' for do yourFunction",255,255,0,true) --after all done output it in chatbox
end
addEventHandler("onClientResourceStart", bindHandler)
</syntaxhighlight>
</section>

==See Also==
{{Input_functions}}

Template:Input functions

2011-08-20T08:53:30Z

Dre -+-:

*[[bindKey]]
*[[getControlState]]
*[[getFunctionsBoundToKey]]
*[[getKeyBoundToFunction]]
*[[getKeyBoundToCommand]]
*[[isControlEnabled]]
*[[isKeyBound]]
*[[setControlState]]
*[[toggleAllControls]]
*[[toggleControl]]
*[[unbindKey]]

GetKeyBoundToCommand

2011-08-20T08:52:29Z

Dre -+-:

{{Server client function}}
This function allow you get first key binded to command.

==Syntax==
<syntaxhighlight lang="lua">
string getKeyBoundToCommand( string command )
</syntaxhighlight>

===Required Arguments===
*'''command:''' command what you need check.

===Returns===
Returns a string of first key binded to current command.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function yourFunction()
--your function here
end

addCommandHandler("bindedcommand",yourFunction)
function bindHandler()
local bindedKey = getKeyBoundToCommand("bindedcommand") --get binded key
if not bindedKey then
bindedKey = "z"
bindKey(bindedKey,"down","bindedcommand") --if key is not exist then bind it by syntax 2
end
outputChatBox("Press '"..bindedKey.."' for do yourFunction",255,255,0,true) --after all done output it in chatbox
end
addEventHandler("onClientResourceStart", bindHandler)
</syntaxhighlight>
</section>

==See Also==
{{Input_functions}}

GetKeyBoundToCommand

2011-08-20T08:52:11Z

Dre -+-: Created page with "{{Server client function}} This function allow you get first key binded to command. ==Syntax== <syntaxhighlight lang="lua"> string getKeyBoundToCommand( string command ) </syntaxhighlight> ===Required Ar..."

{{Server client function}}
This function allow you get first key binded to command.

==Syntax==
<syntaxhighlight lang="lua">
string getKeyBoundToCommand( string command )
</syntaxhighlight>

===Required Arguments===
*'''command:''' command what you need check.

===Returns===
Returns a string of first key binded to current command.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function yourFunction()
--your function here
end

addCommandHandler("bindedcommand",yourFunction)

function bindHandler()
local bindedKey = getKeyBoundToCommand("bindedcommand") --get binded key
if not bindedKey then
bindedKey = "z"
bindKey(bindedKey,"down","bindedcommand") --if key is not exist then bind it by syntax 2
end
outputChatBox("Press '"..bindedKey.."' for do yourFunction",255,255,0,true) --after all done output it in chatbox
end
addEventHandler("onClientResourceStart", bindHandler)
</syntaxhighlight>
</section>

==See Also==
{{Input_functions}}

Category:Объект

2011-08-16T08:31:02Z

Dre -+-:

__NOTOC__
Класс "объект" является статической 3-D моделью в мире GTA. Ими являются только созданные на сервере модели. Модели, входящие в GTA по умолчанию, объектами не являются.
Примеры объектов включают создание моделей, дорог и местностей.

Тип элемента этого класса '''"object"'''.

==XML-синтаксис==
<syntaxhighlight lang="xml">
<object model="" posX="" posY="" posZ="" rotX="" rotY="" rotZ=""/>
</syntaxhighlight>

===Обязательные аргументы===
* '''model''': ID обьекта - используется для упрощения поиска объектов используя getElementByID() функцию или object browser в редакторе карт.
* '''posX''': Переменная типа float координата X обьекта.
* '''posY''': Переменная типа float координата Y обьекта.
* '''posZ''': Переменная типа float координата Z обьекта.

===Дополнительные аргументы===
* '''rotX''': Переменная типа float угол поворота X в градусах.
* '''rotY''': Переменная типа float угол поворота Y в градусах.
* '''rotZ''': Переменная типа float угол поворота Z в градусах.

==Связанные функции==
{{Object functions}}
[[Category:Element Types]]
[[Category:Incomplete]]
[[en:Element/Object]]
[[it:Elemento/Oggetto]]

Template:Client player functions

2011-08-15T09:42:02Z

Dre -+-:

* [[getLocalPlayer]]
* [[getPlayerName]]
* [[getPlayerNametagColor]]
* [[getPlayerNametagText]]
* [[getPlayerPing]]
* [[getPlayerTeam]]
* [[getPlayerWantedLevel]]
* [[isPlayerDead]]
* [[isPlayerMapForced]]
* [[isPlayerMapVisible]]
* [[showPlayerHudComponent]]
{{New feature|3|1.0|
* [[getPlayerMapBoundingBox]]
* [[getPlayerMoney]]
* [[givePlayerMoney]]
* [[setPlayerMoney]]
* [[setPlayerNametagColor]]
* [[setPlayerNametagShowing]]
* [[setPlayerNametagText]]
* [[takePlayerMoney]]
}}
{{Deprecated_feature|3|1.0|
* [[canPlayerBeKnockedOffBike]]
* [[doesPlayerHaveJetPack]]
* [[getPlayerAmmoInClip]]
* [[getPlayerArmor]]
* [[getPlayerContactElement]]
* [[getPlayerOccupiedVehicle]]
* [[getPlayerRotation]]
* [[getPlayerSimplestTask]]
* [[getPlayerSkin]]
* [[getPlayerStat]]
* [[getPlayerTarget]]
* [[getPlayerTargetCollision]]
* [[getPlayerTargetEnd]]
* [[getPlayerTargetRange]]
* [[getPlayerTargetStart]]
* [[getPlayerTask]]
* [[getPlayerTotalAmmo]]
* [[getPlayerWeapon]]
* [[getPlayerWeaponSlot]]
* [[isPlayerChoking]]
* [[isPlayerDoingTask]]
* [[isPlayerDucked]]
* [[isPlayerInVehicle]]
* [[isPlayerInWater]]
* [[isPlayerOnGround]]
* [[setPlayerCanBeKnockedOffBike]]
* [[setPlayerRotation]]
* [[setPlayerSkin]]
* [[setPlayerWeaponSlot]]
}}

GetPlayerWantedLevel

2011-08-15T07:22:59Z

Dre -+-:

__NOTOC__
{{Server client function}}
This function gets a player's current wanted level. The wanted level is indicated by the amount of stars a player has on the GTA HUD.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
int getPlayerWantedLevel ( player thePlayer )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player whose wanted level you wish to get
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
int getPlayerWantedLevel ( )
</syntaxhighlight>
</section>

===Returns===
Returns an ''int'' from 0 to 6 representing the player's wanted level, ''false'' if the player does not exist.

==Example==
<section name="Example 1: Server" class="server" show="true">
This example finds which players in the server have a wanted level:
<syntaxhighlight lang="lua">
local players = getElementsByType ( "player" ) -- get a table of all the players in the server
for theKey,thePlayer in ipairs(players) do -- use a generic for loop to step through each player
local level = getPlayerWantedLevel ( thePlayer ) -- get the wanted level of the player
if ( level > 0 ) then -- if the player has any stars, announce it in the chat:
outputChatBox ( getPlayerName ( thePlayer ) .. " has a wanted level of " .. level .. " stars!" )
end
end
</syntaxhighlight>
</section>
<section name="Example 2: Client" class="client" show="true">
This script output your wanted level when you type /wanted.
<syntaxhighlight lang="lua">
function outputWantedLevel ()
local wantedLvl = getPlayerWantedLevel ( )
if wantedLvl == 0 then
outputChatBox ( "You clean", 0, 255, 0)
else
outputChatBox ( "You have "..wantedLvl.." wanted stars!", 255, 0, 0)
end
end
addCommandHandler ( "wanted", outputWantedLevel )
</syntaxhighlight>
</section>

==See Also==
{{Player functions}}