Multi Theft Auto: Wiki - User contributions [en]

Table

2012-04-11T15:29:55Z

AwwYou:

A table is an array-like data storage type. They are mostly used for bigger data storage.
Tables can be indexed not only with numbers but also with other data types, for example with strings and MTA [[elements]]. 
Here is a list of every default table manipulation function present in Lua.

* [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.insert table.insert]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.maxn table.maxn]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.remove table.remove]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.sort table.sort]
* [http://www.lua.org/manual/5.1/manual.html#pdf-unpack unpack]

==See also==
[http://www.lua.org/pil/2.5.html Tables at lua.org]

[[Category:Scripting Concepts]]

Table

2012-04-11T15:27:57Z

AwwYou: poo?

A table is an array-like data storage type. They are mostly used for bigger data storage.
Tables can be indexed not only with numbers but also with other data types, for example with strings and MTA [[elements]]. 
Here is a list of every default table manipulation function present in Lua.

* [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.insert table.insert]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.maxn table.maxn]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.remove table.remove]
* [http://www.lua.org/manual/5.1/manual.html#pdf-table.sort table.sort]
* [http://www.lua.org/manual/5.2/manual.html#pdf-table.unpack table.unpack]

==See also==
[http://www.lua.org/pil/2.5.html Tables at lua.org]

[[Category:Scripting Concepts]]

String

2012-04-11T15:23:43Z

AwwYou: poo

A string is a sequence of characters, for example "Hello, World!" is a string. 
Here is a list of every default string manipulation function present in Lua.

* [http://www.lua.org/manual/5.1/manual.html#pdf-string.byte string.byte]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.char string.char]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.dump string.dump]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.find string.find]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.format string.format]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.gmatch string.gmatch]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.gsub string.gsub]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.len string.len]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.lower string.lower]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.match string.match]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.rep string.rep]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.reverse string.reverse]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.sub string.sub]
* [http://www.lua.org/manual/5.1/manual.html#pdf-string.upper string.upper]

[[Category:Scripting Concepts]]

Math

2012-04-11T15:23:15Z

AwwYou: poo

Math is a built-in Lua library which contains mathematical functions and constants that you can use in scripts.

* [http://www.lua.org/manual/5.1/manual.html#pdf-math.abs math.abs]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.acos math.acos]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.asin math.asin]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.atan math.atan]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.atan2 math.atan2]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.ceil math.ceil]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.cos math.cos]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.cosh math.cosh]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.deg math.deg]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.exp math.exp]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.floor math.floor]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.fmod math.fmod]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.frexp math.frexp]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.huge math.huge] (constant)
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.ldexp math.ldexp]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.log math.log]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.log10 math.log10]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.max math.max]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.min math.min]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.modf math.modf]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.pi math.pi] (constant)
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.pow math.pow]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.rad math.rad]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.random math.random]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.randomseed math.randomseed]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.sin math.sin]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.sinh math.sinh]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.sqrt math.sqrt]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.tanh math.tanh]
* [http://www.lua.org/manual/5.1/manual.html#pdf-math.tan math.tan]

==See Also==
* [http://lua-users.org/wiki/MathLibraryTutorial Math examples on the LUA Wiki]

[[Category:Scripting Concepts]]

Math

2012-04-10T18:19:33Z

AwwYou:

Math is a built-in Lua library which contains mathematical functions and constants that you can use in scripts.

* [http://www.lua.org/manual/5.2/manual.html#pdf-math.abs math.abs]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.acos math.acos]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.asin math.asin]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.atan math.atan]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.atan2 math.atan2]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.ceil math.ceil]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.cos math.cos]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.cosh math.cosh]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.deg math.deg]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.exp math.exp]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.floor math.floor]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.fmod math.fmod]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.frexp math.frexp]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.huge math.huge] (constant)
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.ldexp math.ldexp]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.log math.log]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.log10 math.log10]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.max math.max]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.min math.min]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.modf math.modf]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.pi math.pi] (constant)
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.pow math.pow]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.rad math.rad]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.random math.random]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.randomseed math.randomseed]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.sin math.sin]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.sinh math.sinh]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.sqrt math.sqrt]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.tanh math.tanh]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.tan math.tan]

==See Also==
* [http://lua-users.org/wiki/MathLibraryTutorial Math examples on the LUA Wiki]

[[Category:Scripting Concepts]]

Math

2012-04-10T18:18:40Z

AwwYou:

Math is a built-in Lua library which containts mathematical functions and constants that you can use in scripts.

* [http://www.lua.org/manual/5.2/manual.html#pdf-math.abs math.abs]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.acos math.acos]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.asin math.asin]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.atan math.atan]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.atan2 math.atan2]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.ceil math.ceil]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.cos math.cos]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.cosh math.cosh]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.deg math.deg]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.exp math.exp]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.floor math.floor]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.fmod math.fmod]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.frexp math.frexp]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.huge math.huge] (constant)
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.ldexp math.ldexp]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.log math.log]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.log10 math.log10]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.max math.max]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.min math.min]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.modf math.modf]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.pi math.pi] (constant)
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.pow math.pow]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.rad math.rad]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.random math.random]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.randomseed math.randomseed]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.sin math.sin]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.sinh math.sinh]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.sqrt math.sqrt]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.tanh math.tanh]
* [http://www.lua.org/manual/5.2/manual.html#pdf-math.tan math.tan]

==See Also==
* [http://lua-users.org/wiki/MathLibraryTutorial Math examples on the LUA Wiki]

[[Category:Scripting Concepts]]

String

2012-04-10T18:11:26Z

AwwYou:

A string is a sequence of characters, for example "Hello, World!" is a string. 
Here is a list of every default string manipulation function present in Lua.

* [http://www.lua.org/manual/5.2/manual.html#pdf-string.byte string.byte]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.char string.char]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.dump string.dump]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.find string.find]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.format string.format]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.gmatch string.gmatch]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.gsub string.gsub]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.len string.len]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.lower string.lower]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.match string.match]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.rep string.rep]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.reverse string.reverse]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.sub string.sub]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.upper string.upper]

[[Category:Scripting Concepts]]

Table

2012-04-10T18:11:01Z

AwwYou:

A table is an array-like data storage type. They are mostly used for bigger data storage.
Tables can be indexed not only with numbers but also with other data types, for example with strings and MTA [[elements]]. 
Here is a list of every default table manipulation function present in Lua.

* [http://www.lua.org/manual/5.2/manual.html#pdf-table.concat table.concat]
* [http://www.lua.org/manual/5.2/manual.html#pdf-table.insert table.insert]
* [http://www.lua.org/manual/5.2/manual.html#pdf-table.pack table.pack]
* [http://www.lua.org/manual/5.2/manual.html#pdf-table.remove table.remove]
* [http://www.lua.org/manual/5.2/manual.html#pdf-table.sort table.sort]
* [http://www.lua.org/manual/5.2/manual.html#pdf-table.unpack table.unpack]

==See also==
[http://www.lua.org/pil/2.5.html Tables at lua.org]

[[Category:Scripting Concepts]]

String

2012-04-10T18:04:48Z

AwwYou:

A string is a sequence of characters, for example "Hello, World!" is a string. 
We propose a list of every string functions here.

* [http://www.lua.org/manual/5.2/manual.html#pdf-string.byte string.byte]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.char string.char]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.dump string.dump]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.find string.find]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.format string.format]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.gmatch string.gmatch]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.gsub string.gsub]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.len string.len]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.lower string.lower]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.match string.match]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.rep string.rep]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.reverse string.reverse]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.sub string.sub]
* [http://www.lua.org/manual/5.2/manual.html#pdf-string.upper string.upper]

[[Category:Scripting Concepts]]

ProcessLineOfSight

2012-04-10T17:51:26Z

AwwYou: Undo revision 29939 by Jaysds (talk) durr

{{Needs_Checking|Explain ignoreSomeObjectsForCamera and ignoredElement with examples?
--[[User:Ransom|Ransom]] 07:18, 3 February 2011 (UTC)}}
{{Client function}}
__NOTOC__
This function casts a ray between two points in the world, and tells you information about the point that was hit, if any. The two positions '''must''' be within the local player's draw distance as the collision data is not loaded outside this area, and the call will just fail as if the ray didn't hit.

This function is relatively expensive to call, so over use of this in scripts may have a detrimental effect on performance.

This function is useful for checking for collisions and for editor-style scripts. If you wish to find what element is positioned at a particular point on the screen, use this function combined with [[getWorldFromScreenPosition]]. If you wish to just know if something is hit, and don't care about what or where was hit, use [[isLineOfSightClear]].

==Syntax==
Return values labelled for ease of reference.
<syntaxhighlight lang="lua">
bool -- hit
float float float -- hitX, hitY, hitZ
element -- hitElement
float float float -- normalX, normalY, normalZ
int -- material
int -- lighting
int -- piece
int -- worldModelID
float float float -- worldModelPositionX,Y,Z
float float float -- worldModelRotationX,Y,Z
processLineOfSight ( float startX, float startY, float startZ,
float endX, float endY, float endZ,
[ bool checkBuildings = true,
bool checkVehicles = true,
bool checkPlayers = true,
bool checkObjects = true,
bool checkDummies = true,
bool seeThroughStuff = false,
bool ignoreSomeObjectsForCamera = false,
bool shootThroughStuff = false,
element ignoredElement = nil,
bool includeWorldModelInformation = false ] )
</syntaxhighlight>

===Required Arguments===
*'''startX:''' The start ''x'' position
*'''startY:''' The start ''y'' position
*'''startZ:''' The start ''z'' position
*'''endX:''' The end ''x'' position
*'''endY:''' The end ''y'' position
*'''endZ:''' The end ''z'' position

===Optional Arguments===
{{OptionalArg}}
*'''checkBuildings:''' Allow the line of sight to be blocked by GTA's internally placed buildings, i.e. the world map.
*'''checkVehicles:''' Allow the line of sight to be blocked by [[Vehicle|vehicles]].
*'''checkPlayers:''' Allow the line of sight to be blocked by [[Player|players]].
*'''checkObjects:''' Allow the line of sight to be blocked by [[Object|objects]].
*'''checkDummies:''' Allow the line of sight to be blocked by GTA's internal dummies. These are not used in the current MTA version so this argument can be set to ''false''.
*'''seeThroughStuff:''' Allow the line of sight to be blocked by translucent game objects, e.g. glass.
*'''ignoreSomeObjectsForCamera:''' Allow the line of sight to be blocked by certain objects.
*'''shootThroughStuff:''' Allow the line of sight to be blocked by things that can be shot through
*'''ignoredElement:''' Allow the line of sight to pass through a certain specified element. This is usually set the object you are tracing from.
{{New feature|3.0110|1.1|
*'''includeWorldModelInformation :''' Include the results of hitting a world model.
}}

===Returns===
*'''hit:''' ''true'' if there is a collision, ''false'' otherwise
The other values are only filled if there is a collision, they contain ''nil'' otherwise
*'''hitX, hitY, hitZ:''' collision position
*'''hitElement:''' the MTA element hit if any, ''nil'' otherwise
{{New feature|3.0110|1.1|
*'''normalX, normalY, normalZ:''' the normal of the surface hit
*'''material:''' an integer representing the [[Material IDs|GTASA material ID]] of the surface hit when applicable (world, objects)
*'''lighting:''' an integer between 0 (fully dark) and 255 (bright) representing the lighting intensity of the surface hit. This intensity is related to the lighting intensity the ped gets when standing on this surface (more than 100 in general, less than 20 in dark areas, and 0 to 1 in stealth parts of Madd Dogg's mansion)
*'''piece:''' an integer representing the part of the element hit if hitElement is a vehicle or a ped/player, ''0'' otherwise.
**For a ped/player, piece represents the body part hit:
{{BodyParts}}
**For vehicles, piece represents the vehicle part hit:
{{VehicleParts}}
*'''worldModelID:''' If includeWorldModelInformation was set to ''true'' and a world model was hit, this will contain the model ID.
*'''worldModelPositionX,Y,Z:''' If worldModelID is set, this will contain the world model position.
*'''worldModelRotationX,Y,Z:''' If worldModelID is set, this will contain the world model rotation.
}}

==Example==
This example shows how you can tell what position and element the camera is looking at, up to 50 units away.
<syntaxhighlight lang="lua">
local w, h = guiGetScreenSize ()
local tx, ty, tz = getWorldFromScreenPosition ( w/2, h/2, 50 )
local px, py, pz = getCameraMatrix()
hit, x, y, z, elementHit = processLineOfSight ( px, py, pz, tx, ty, tz )
if hit then
outputChatBox ( "Looking at " .. x .. ", " .. y .. ", " .. z )
if elementHit then
outputChatBox ( "Hit element " .. getElementType(elementHit) )
end
end
</syntaxhighlight>

==See Also==
{{Client world functions}}

User:AwwYou

2011-08-13T19:22:26Z

AwwYou: Created page with "'''HAI DER''' [http://community.mtasa.com/index.php?p=profile&id=1792 MTA Community]"

'''HAI DER'''

[http://community.mtasa.com/index.php?p=profile&id=1792 MTA Community]