DE/engineReplaceModel - Revision history

Qaisjp: prefer normal note

2019-09-07T08:43:32Z

prefer normal note

← Older revision		Revision as of 08:43, 7 September 2019
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Client function}}		{{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}}		{{Note\|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.		Diese Funktion ersetz ein vorhandes Model mit einer neuen DFF Datei. Es werden momentan Fahrzeuge und Objekte unterstütz.

PLASMA at 18:00, 19 August 2013

2013-08-19T18:00:38Z

← Older revision		Revision as of 18:00, 19 August 2013
Line 3:		Line 3:
	{{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}}		{{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.		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]].		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]].

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 ..."

2013-08-19T17:59:44Z

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 ..."

New page

__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/engineReplaceModel - Revision history

Qaisjp: prefer normal note

PLASMA at 18:00, 19 August 2013

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 ..."

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 ..."