Dgs3DLineAddItem

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

This function adds an item into 3d line.

Syntax

int dgs3DLineAddItem( element line3D , float startX, float startY, float startZ, float endX, float endY, float endZ [, float lineWidth = dgs3DLineWidth, int lineColor = dgs3DLineColor, bool isRelative = false ] )

Required Arguments

  • line3D: The DGS 3D Line element.
  • startX: The start X position of the 3D line, representing a coordinate in the GTA world, or X position relative to the 3D Line if isRelative if true.
  • startY: The start Y position of the 3D line, representing a coordinate in the GTA world, or Y position relative to the 3D Line if isRelative if true.
  • startZ: The start Z position of the 3D line, representing a coordinate in the GTA world, or Z position relative to the 3D Line if isRelative if true.
  • endX: The end X position of the 3D line, representing a coordinate in the GTA world, or X position relative to the 3D Line if isRelative if true.
  • endY: The end Y position of the 3D line, representing a coordinate in the GTA world, or Y position relative to the 3D Line if isRelative if true.
  • endZ: The end Z position of the 3D line, representing a coordinate in the GTA world, or Z position relative to the 3D Line if isRelative if true.

Optional Arguments

  • lineWidth: A float of the line width of the item.
  • lineColor: An integer of the line color of the item.
  • isRelative: A bool indicates whether the position of the 3D Line item is relative to the 3D Line or absolute coordinate in the GTA world.

Returns

Returns an int indicates the index of the item if successful, 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

See Also

Custom Cursor Functions

Multi Language Supports

Animation

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

Label

Line

Progress Bar

Radio Button

Scale Pane

Scroll Bar

Scroll Pane

Selector

Style

Switch Button

Tab Panel

Window

Plugin

Blur Box

Color Picker

Canvas

Circle

Effect 3D

Media Browser

Mask

Nine Slice

Object Preview Supports

Paste Handler

QRCode

Remote Image

Rounded Rectangle