Dgs3DInterfaceSetFaceTo: Difference between revisions

Revision as of 10:23, 11 February 2023

This function sets the position that the DGS 3D interface faces to.

>>>Note: If the DGS 3D interface is attached to an element, please use dgs3DInterfaceSetAttachedOffsets instead<<<

Syntax

bool dgs3DInterfaceSetFaceTo ( element dgsElement [, float x, float y, float z, string relativeTo = "self" ]  )

Required Arguments

dgsElement: The DGS 3D interface of which you wish to change.

Optional Arguments

x: A float of the x position that the DGS 3D interface faces to (Depends on relativeTo). If x, y,z are nil, DGS 3D interface will always face to camera.
y: A float of the y position that the DGS 3D interface faces to (Depends on relativeTo). If x, y,z are nil, DGS 3D interface will always face to camera.
z: A float of the z position that the DGS 3D interface faces to (Depends on relativeTo). If x, y,z are nil, DGS 3D interface will always face to camera.
relativeTo: A string of the relativity options:
- self: Default state, relative to 3D Interface itself, faceTo = selfPosition+faceTo.
- world: Default state, relative to the world, faceTo = absoluteWorldPosition.

Returns

Returns true if successful, false otherwise

Example

DGS = exports.dgs

function panelPosition()
	dgs3dPanel1 = DGS:dgsCreate3DInterface(0,0,3,2,2,400,400,tocolor(255,255,255,255),0,1,0)
	DGS:dgsCreateImage(0,0,1,1,_,true,dgs3dPanel1) -- Background
	DGS:dgs3DInterfaceSetFaceTo(dgs3dPanel1,1,0,0,"self")	--relative to itself
	
	dgs3dPanel2 = DGS:dgsCreate3DInterface(0,0,3,2,2,400,400,tocolor(255,255,255,255),0,1,0)
	DGS:dgsCreateImage(0,0,1,1,_,true,dgs3dPanel2) -- Background
	DGS:dgs3DInterfaceSetFaceTo(dgs3dPanel2,1,0,0,"world")	--relative to the world
end

Custom Cursor Functions

Multi Language Supports

Animation

3D Element

3D Interface

3D Line

3D Image

3D Text

Browser

dgsCreateBrowser

Button

Check Box

Combo Box

Custom Renderer

Edit

Detect Area

Drag'N Drop

Grid List

Image

Memo

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

dgsCreateCanvas

Chart

Color Picker

Effect 3D

Gradient

Mask

Media Browser

Nine Slice

Object Preview Supports

Paste Handler

QRCode

Remote Image

Screen Source

SVG

Tooltips

@@ Line 14: / Line 14: @@
 ===Optional Arguments===
-*'''x:''' A float of the x position that the DGS 3D interface faces to (Depends on ''relativeTo'').
+*'''x:''' A float of the x position that the DGS 3D interface faces to (Depends on ''relativeTo''). If '''x''', '''y''','''z''' are nil, DGS 3D interface will always face to camera.
-*'''y:''' A float of the y position that the DGS 3D interface faces to (Depends on ''relativeTo'').
+*'''y:''' A float of the y position that the DGS 3D interface faces to (Depends on ''relativeTo''). If '''x''', '''y''','''z''' are nil, DGS 3D interface will always face to camera.
-*'''z:''' A float of the z position that the DGS 3D interface faces to (Depends on ''relativeTo'').
+*'''z:''' A float of the z position that the DGS 3D interface faces to (Depends on ''relativeTo''). If '''x''', '''y''','''z''' are nil, DGS 3D interface will always face to camera.
 *'''relativeTo:''' A string of the relativity options:
 **'''self:''' Default state, relative to 3D Interface itself, '''faceTo = selfPosition+faceTo'''.