HU/dxDrawLine3D

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

Ez a function 3D-s vonalat rajzol a 3D-s világ két pontja között - egy képkocka erejéig van kirajzolva. Ezt a onClientRender segítségével együtt kell használni annak érdekében, hogy folyamatosan jelenjen meg.

Szintaxis

bool dxDrawLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ [, int color = 0xFFFFFFFF, float width = 1.0, bool postGUI = false ] )

Kötelező paraméterek

  • startX: A 3D-s vonal kezdetének X pozíciója, amely egy koordinátát képvisel a GTA világában.
  • startY: A 3D-s vonal kezdetének Y pozíciója, amely egy koordinátát képvisel a GTA világában.
  • startZ: A 3D-s vonal kezdetének Z pozíciója, amely egy koordinátát képvisel a GTA világában.
  • endX: A 3D-s vonal végének X pozíciója, amely egy koordinátát képvisel a GTA világában.
  • endY: A 3D-s vonal végének Y pozíciója, amely egy koordinátát képvisel a GTA világában.
  • endZ: A 3D-s vonal végének Z pozíciója, amely egy koordinátát képvisel a GTA világában.

Tetszőleges paraméterek

Megjegyzés: Amikor tetszőleges paramétereket használ, előfordulhat, hogy az összes paramétert meg kell adnia, mielőtt egyet is használna. További információkért látogassa meg a tetszőleges paraméterek oldalt.

  • color: A hexadecimális szín, melyet a tocolor-al vagy az 0xAARRGGBB fügvénnyel tudunk megadni (AA = átlászóság, RR = piros, GG = zöld, BB = kék).
  • width: A vonal szélessége/vastagsága
  • postGUI: Egy igaz/hamis érték, mely azt képviseli, hogy a vonal bármelyik ingame GUI mögött, vagy fölött legyen-e (CEGUI által rajzolt).

Visszatérési érték

Visszatérési értéke true, ha a művelet sikeres, egyébként false.

Example

Ez a példa létrehoz egy 3D-s vonalat / "kötelet" egy játékos és egy jármű között.

function makeLineAppear()
	testVehicle = createVehicle ( 411, 0, 0, 5 ) -- Create our test vehicle.
	addEventHandler("onClientRender", root, createLine)        -- onClientRender keeps the 3D Line visible.
end
function createLine ( )
	x1, y1, z1 = getElementPosition ( testVehicle )                       -- Get test vehicles position.
	x2, y2, z2 = getElementPosition ( localPlayer )                  -- Get local players position.
	dxDrawLine3D ( x1, y1, z1, x2, y2, z2, tocolor ( 0, 255, 0, 230 ), 2) -- Create 3D Line between test vehicle and local player.
end
addCommandHandler("test", makeLineAppear)

Lásd még

FROM VERSION 1.5.6 r14203 ONWARDS

Fordította