Dgs3DLineGetItemPosition: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
float, float, float dgs3DLineGetItemPosition( element line3D, int index )
float/nil, float/nil, float/nil, float, float, float dgs3DLineGetItemPosition( element line3D, int index )
</syntaxhighlight>  
</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''line3D''': The DGS 3D Line element.
*'''line3D''': The DGS 3D Line.
*'''index''': The item index of DGS 3D Line.
*'''index''': The item index.


===Returns===
===Returns===
Returns 3 ''float''s indicates x, y and z coordinates of the item, ''false'' otherwise.
Returns 6 ''float''s indicates start position x, y, z and end position x, y, z of the item. Or 3 ''nil''s and 3 ''float''s if using end position of previous item as start position of current item, ''false'' otherwise.


==Example==  
==Example==  
Line 25: Line 25:
DGS:dgs3DLineAddItem(line,_,_,_,math.cos(i/200*math.pi*2)*4,math.sin(i/200*math.pi*2)*4,0,4,tocolor(i/200*255,255-i/200*255,0,255),true)
DGS:dgs3DLineAddItem(line,_,_,_,math.cos(i/200*math.pi*2)*4,math.sin(i/200*math.pi*2)*4,0,4,tocolor(i/200*255,255-i/200*255,0,255),true)
end
end
local x,y,z = DGS:dgs3DLineGetItemPosition(line,1)
local sx,sy,sz,ex,ey,ez = DGS:dgs3DLineGetItemPosition(line,1)
outputChatBox("X:"..x..";Y:"..y..";Z:"..z)
outputChatBox("startX:"..sx..";startY:"..sy..";startZ:"..sz..";endX:"..ex..";endY:"..ey..";endZ:"..ez)
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{DGSFUNCTIONS}}
{{DGSFUNCTIONS}}

Latest revision as of 12:11, 10 January 2023

This function gets the position of the specified item of DGS 3D Line.

Syntax

float/nil, float/nil, float/nil, float, float, float dgs3DLineGetItemPosition( element line3D, int index )

Required Arguments

  • line3D: The DGS 3D Line.
  • index: The item index.

Returns

Returns 6 floats indicates start position x, y, z and end position x, y, z of the item. Or 3 nils and 3 floats if using end position of previous item as start position of current item, false otherwise.

Example

DGS = exports.dgs

line = DGS:dgsCreate3DLine(0,0,4,0,0,45,tocolor(255,255,255,255),2,100)
local i = 1
DGS:dgs3DLineAddItem(line,4,0,0,math.cos(i/200*math.pi*2)*4,math.sin(i/200*math.pi*2)*4,0,4,tocolor(i/200*255,255-i/200*255,0,255),true)
for i=2,200 do
	DGS:dgs3DLineAddItem(line,_,_,_,math.cos(i/200*math.pi*2)*4,math.sin(i/200*math.pi*2)*4,0,4,tocolor(i/200*255,255-i/200*255,0,255),true)
end
local sx,sy,sz,ex,ey,ez = DGS:dgs3DLineGetItemPosition(line,1)
outputChatBox("startX:"..sx..";startY:"..sy..";startZ:"..sz..";endX:"..ex..";endY:"..ey..";endZ:"..ez)

See Also

Custom Cursor Functions

Multi Language Supports

Animation

3D Element

3D Interface

3D Line

3D Image

3D Text

Browser

Button

Check Box

Combo Box

Custom Renderer

Edit

Detect Area

Drag'N Drop

Grid List

Image

Memo

Menu

Label

Layout

Line

Progress Bar

Radio Button

Scale Pane

Scroll Bar

Scroll Pane

Selector

Style

Switch Button

Tab Panel

Window

Basic Shape Plugins

Circle

Quadrilateral

Rounded Rectangle

Other Plugins

Blur Box

Canvas

Chart

Color Picker

Effect 3D

Gradient

Mask

Media Browser

Nine Slice

Object Preview Supports

Paste Handler

QRCode

Remote Image

Screen Source

SVG

Tooltips