Multi Theft Auto: Wiki - User contributions [en]

DE/engineReplaceModel

2013-08-19T18:00:38Z

PLASMA:

__NOTOC__
{{Client function}}
{{Note box|Please note the loading order that is used in the examples as other orders can cause textures, collisions or the DFF not to load due to technical limitations}}

Diese Funktion ersetz ein vorhandes Model mit einer neuen DFF Datei. Es werden momentan Fahrzeuge und Objekte unterstütz.

Seit 1.1.1 unterstütz diese Funktion Peds und Waffenmodelle. Um Waffenmodelle ersetzen zu können, kannst du nicht die Waffen ID's benutzen, sondern die Objekt ID's. Alle Waffenmodelle sind hier zu sehen: [[Weapons]].

Achtung: Wenn man ein Objekt mit einer eingebauten Collision (Fahrzeuge) ersetz, kann es vorkommen dass die Collision nicht richtig ersetz wurde. Man arbeitet daran die DFF Datei noch einmal zu laden und sie kurz danach zu ersetzen.

==Syntax==
<syntaxhighlight lang="lua">
bool engineReplaceModel ( dff theModel, int modelID [, bool alphaTransparency = false ] )
</syntaxhighlight>

===Required Arguments===
*'''theModel:''' Das neue Model, welches ein Anderes ersetzen soll.
*'''modelID:''' Die Model ID welche ersetz werden soll

===Optional Arguments===
*'''alphaTransparency:''' Set to true to enable special thing

===Returns===
Returns ''true'' if the model was successfully replaced, ''false'' if it failed for some reason, ie. the DFF or the model ID is not valid.

==Example==
'''Example 1:'''
<section name="Client" class="client" show="true">
Client-Side example for replacing vehicle model and texture with custom ones.
<syntaxhighlight lang="lua">
function ReplaceVehicle ( )
outputChatBox ( "> replacing the euros vehicle" )

txd = engineLoadTXD ( "data/euros.txd" )
engineImportTXD ( txd, 587 )
dff = engineLoadDFF ( "data/euros.dff", 587 )
engineReplaceModel ( dff, 587 )
end

addEvent ( "replaceVeh", true )
addEventHandler ( "replaceVeh", getRootElement(), ReplaceVehicle )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
Server-side example function for triggering the replace.
<syntaxhighlight lang="lua">
function ReplaceCommand ( )
triggerClientEvent( "replaceVeh", getRootElement(), replaceVeh )
end
addCommandHandler( "replace", ReplaceCommand )
</syntaxhighlight>
</section>

'''Example 2:'''
<section name="Client" class="client" show="true">
Client-Side example for replacing object model, collision and texture with custom ones.
<syntaxhighlight lang="lua">
function ReplaceObject ( )

txd = engineLoadTXD( "MyModel.txd" )
col = engineLoadCOL( "MyModel.col" )
dff = engineLoadDFF( "MyModel.dff", 0 ) --modelid is everytime 0, when you replace no vehicle

engineImportTXD( txd, 1234 )
engineReplaceCOL( col, 1234 )
engineReplaceModel( dff, 1234 )-- replace the model at least

end

addEvent ( "replaceObj", true )
addEventHandler ( "replaceObj", getRootElement(), ReplaceObject )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
Server-side example function for triggering the replace.
<syntaxhighlight lang="lua">
function ReplaceCommand ( )
triggerClientEvent( "replaceObj", getRootElement(), replaceObj )
end
addCommandHandler( "replace", ReplaceCommand )
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

DE/engineReplaceModel

2013-08-19T17:59:44Z

PLASMA: Created page with "__NOTOC__ {{Client function}} {{Note box|Please note the loading order that is used in the examples as other orders can cause textures, collisions or the DFF not to load due to ..."

__NOTOC__
{{Client function}}
{{Note box|Please note the loading order that is used in the examples as other orders can cause textures, collisions or the DFF not to load due to technical limitations}}

Diese Funktion ersetz ein vorhandes Model mit einer neuen DFF Datei. Es werden unterstütz momentan Fahrzeuge und Objekte.

Seit 1.1.1 unterstütz diese Funktion Peds und Waffenmodelle. Um Waffenmodelle ersetzen zu können, kannst du nicht die Waffen ID's benutzen, sondern die Objekt ID's. Alle Waffenmodelle sind hier zu sehen: [[Weapons]].

Achtung: Wenn man ein Objekt mit einer eingebauten Collision (Fahrzeuge) ersetz, kann es vorkommen dass die Collision nicht richtig ersetz wurde. Man arbeitet daran die DFF Datei noch einmal zu laden und sie kurz danach zu ersetzen.

==Syntax==
<syntaxhighlight lang="lua">
bool engineReplaceModel ( dff theModel, int modelID [, bool alphaTransparency = false ] )
</syntaxhighlight>

===Required Arguments===
*'''theModel:''' Das neue Model, welches ein Anderes ersetzen soll.
*'''modelID:''' Die Model ID welche ersetz werden soll

===Optional Arguments===
*'''alphaTransparency:''' Set to true to enable special thing

===Returns===
Returns ''true'' if the model was successfully replaced, ''false'' if it failed for some reason, ie. the DFF or the model ID is not valid.

==Example==
'''Example 1:'''
<section name="Client" class="client" show="true">
Client-Side example for replacing vehicle model and texture with custom ones.
<syntaxhighlight lang="lua">
function ReplaceVehicle ( )
outputChatBox ( "> replacing the euros vehicle" )

txd = engineLoadTXD ( "data/euros.txd" )
engineImportTXD ( txd, 587 )
dff = engineLoadDFF ( "data/euros.dff", 587 )
engineReplaceModel ( dff, 587 )
end

addEvent ( "replaceVeh", true )
addEventHandler ( "replaceVeh", getRootElement(), ReplaceVehicle )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
Server-side example function for triggering the replace.
<syntaxhighlight lang="lua">
function ReplaceCommand ( )
triggerClientEvent( "replaceVeh", getRootElement(), replaceVeh )
end
addCommandHandler( "replace", ReplaceCommand )
</syntaxhighlight>
</section>

'''Example 2:'''
<section name="Client" class="client" show="true">
Client-Side example for replacing object model, collision and texture with custom ones.
<syntaxhighlight lang="lua">
function ReplaceObject ( )

txd = engineLoadTXD( "MyModel.txd" )
col = engineLoadCOL( "MyModel.col" )
dff = engineLoadDFF( "MyModel.dff", 0 ) --modelid is everytime 0, when you replace no vehicle

engineImportTXD( txd, 1234 )
engineReplaceCOL( col, 1234 )
engineReplaceModel( dff, 1234 )-- replace the model at least

end

addEvent ( "replaceObj", true )
addEventHandler ( "replaceObj", getRootElement(), ReplaceObject )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
Server-side example function for triggering the replace.
<syntaxhighlight lang="lua">
function ReplaceCommand ( )
triggerClientEvent( "replaceObj", getRootElement(), replaceObj )
end
addCommandHandler( "replace", ReplaceCommand )
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

DE/CreateWater

2013-02-19T18:45:58Z

PLASMA:

__NOTOC__
{{Server Client Funktion}}

Erstellen eines Feldes aus [[Wasser]].

Die höchst mögliche Größe eines Wasserfeldes beträgt 5996x5996. Vorsicht, die Funktion wird wohlmöglich alle x und y Koordinaten in ganzställige Zahlen verändern, da San Andreas eine Begrenzung hat.

==Syntax==
<syntaxhighlight lang="lua">water createWater ( float x1, float y1, float z1, float x2, float y2, float z2, float x3, float y3, float z3 [, float x4, float y4, float z4 ] [, bool bShallow = false ] )</syntaxhighlight>
[[Image:WaterAreas.jpg|thumb|Beispiel eines quadratischen Wasserfeld.|284x230px]]

===Notwendige Argumente===
*'''x1, y1, z1:''' Untere linke Ecke (south-west).
*'''x2, y2, z2:''' Untere rechte Ecke (south-east).
*'''x3, y3, z3:''' Obere linke Ecke (north-west).
''Achtung: Nur drei Angaben erstellen ein Dreieck!''

===Optionale Argumente===
*'''x4, y4, z4:''' Obere rechte Ecke (north-east).
*'''bShallow:''' Muss überprüft werden...

===Returns===
Returns a water element if successful, ''false'' otherwise. Das Wasserfeld kann mit [[setElementPosition]] die Postion ändern und mit [[destroyElement]] zerstört werden.

==Beispiel==
<section name="Client" class="client" show="true">
Beispiel, wie man die komplette San Andreas Karte mit Wasserfeldern bedeckt(Überflutet Städte). Es wird auch [[setWaterLevel]] benutzt, um die Höhe der Wasserfelder zu ändern.
<syntaxhighlight lang="lua">
-- Einstellungen.
height = 40
SizeVal = 2998
-- Definierung der Variablen.
southWest_X = -SizeVal
southWest_Y = -SizeVal
southEast_X = SizeVal
southEast_Y = -SizeVal
northWest_X = -SizeVal
northWest_Y = SizeVal
northEast_X = SizeVal
northEast_Y = SizeVal

-- OnClientResourceStart Funktion erstellt das Wasserfeld.
function thaResourceStarting( )
water = createWater ( southWest_X, southWest_Y, height, southEast_X, southEast_Y, height, northWest_X, northWest_Y, height, northEast_X, northEast_Y, height )
setWaterLevel ( height )
end
addEventHandler("onClientResourceStart", resourceRoot, thaResourceStarting)
</syntaxhighlight>
</section>

==Weitere Funktionen==
{{Client water functions}}

DE/CreateWater

2013-02-19T18:39:54Z

PLASMA:

__NOTOC__
{{Server client function}}

{{Muss überprüft werden!|Benutzen von bShallow ist unbekannt. Diese Einstellung kann die Sichtbarkeit des Wasssers verändern.}}

Erstellen eines Feldes aus [[Wasser]].

Die höchst mögliche Größe eines Wasserfeldes beträgt 5996x5996. Vorsicht, die Funktion wird wohlmöglich alle x und y Koordinaten in ganzställige Zahlen verändern, da San Andreas eine Begrenzung hat.

==Syntax==
<syntaxhighlight lang="lua">water createWater ( float x1, float y1, float z1, float x2, float y2, float z2, float x3, float y3, float z3 [, float x4, float y4, float z4 ] [, bool bShallow = false ] )</syntaxhighlight>
[[Image:WaterAreas.jpg|thumb|Beispiel eines quadratischen Wasserfeld.|284x230px]]

===Notwendige Argumente===
*'''x1, y1, z1:''' Untere linke Ecke (south-west).
*'''x2, y2, z2:''' Untere rechte Ecke (south-east).
*'''x3, y3, z3:''' Obere linke Ecke (north-west).
''Achtung: Nur drei Angaben erstellen ein Dreieck!''

===Optionale Argumente===
*'''x4, y4, z4:''' Obere rechte Ecke (north-east).
*'''bShallow:''' Muss überprüft werden...

===Returns===
Returns a water element if successful, ''false'' otherwise. Das Wasserfeld kann die mit [[setElementPosition]] Postion ändern und mit [[destroyElement]] zerstört werden.

==Beispiel==
<section name="Client" class="client" show="true">
Beispiel, wie man die komplette San Andreas Karte mit Wasserfeldern bedeckt(Überflutet Städte). Es wird auch [[setWaterLevel]] benutzt, um die Höhe der Wasserfelder zu ändern.
<syntaxhighlight lang="lua">
-- Setting water properties.
height = 40
SizeVal = 2998
-- Defining variables.
southWest_X = -SizeVal
southWest_Y = -SizeVal
southEast_X = SizeVal
southEast_Y = -SizeVal
northWest_X = -SizeVal
northWest_Y = SizeVal
northEast_X = SizeVal
northEast_Y = SizeVal

-- OnClientResourceStart function that creates the water.
function thaResourceStarting( )
water = createWater ( southWest_X, southWest_Y, height, southEast_X, southEast_Y, height, northWest_X, northWest_Y, height, northEast_X, northEast_Y, height )
setWaterLevel ( height )
end
addEventHandler("onClientResourceStart", resourceRoot, thaResourceStarting)
</syntaxhighlight>
</section>

==Weitere Funktionen==
{{Client water functions}}

DE/CreateWater

2013-02-19T18:36:26Z

PLASMA: Created page with "__NOTOC__ {{Server client function}} {{Muss überprüft werden!|Benutzen von bShallow ist unbekannt. Diese Einstellung kann die Sichtbarkeit des Wasssers verändern.}} Erstelle..."

__NOTOC__
{{Server client function}}

{{Muss überprüft werden!|Benutzen von bShallow ist unbekannt. Diese Einstellung kann die Sichtbarkeit des Wasssers verändern.}}

Erstellen eines Feldes aus [[Wasser]].

Die höchst mögliche Größe eines Wasserfelds ist 5996x5996. Vorsicht, die Funktion wird wohlmöglich alle x und y Koordinaten in ganzställige Zahlen verändern, da San Andreas eine Begrenzung hat.

==Syntax==
<syntaxhighlight lang="lua">water createWater ( float x1, float y1, float z1, float x2, float y2, float z2, float x3, float y3, float z3 [, float x4, float y4, float z4 ] [, bool bShallow = false ] )</syntaxhighlight>
[[Image:WaterAreas.jpg|thumb|Beispiel eines quadratischen Wasserfeld.|284x230px]]

===Notwendige Argumente===
*'''x1, y1, z1:''' Untere linke Ecke (south-west).
*'''x2, y2, z2:''' Untere rechte Ecke (south-east).
*'''x3, y3, z3:''' Obere linke Ecke (north-west).
''Achtung: Nur drei Angaben erstellen ein Dreieck!''

===Optionale Argumente===
*'''x4, y4, z4:''' Obere rechte Ecke (north-east).
*'''bShallow:''' Muss überprüft werden...

===Returns===
Returns a water element if successful, ''false'' otherwise. Das Wasserfeld kann die mit [[setElementPosition]] Postion ändern und mit [[destroyElement]] zerstört werden.

==Beispiel==
<section name="Client" class="client" show="true">
Beispiel, wie man die komplette San Andreas Karte mit Wasserfeldern bedeckt(Überflutet Städte). Es wird auch [[setWaterLevel]] benutzt, um die Höhe der Wasserfelder zu ändern.
<syntaxhighlight lang="lua">
-- Setting water properties.
height = 40
SizeVal = 2998
-- Defining variables.
southWest_X = -SizeVal
southWest_Y = -SizeVal
southEast_X = SizeVal
southEast_Y = -SizeVal
northWest_X = -SizeVal
northWest_Y = SizeVal
northEast_X = SizeVal
northEast_Y = SizeVal

-- OnClientResourceStart function that creates the water.
function thaResourceStarting( )
water = createWater ( southWest_X, southWest_Y, height, southEast_X, southEast_Y, height, northWest_X, northWest_Y, height, northEast_X, northEast_Y, height )
setWaterLevel ( height )
end
addEventHandler("onClientResourceStart", resourceRoot, thaResourceStarting)
</syntaxhighlight>
</section>

==See Also==
{{Client water functions}}