DownloadFile - Revision history

Ccw at 00:41, 3 February 2017

2017-02-03T00:41:00Z

← Older revision		Revision as of 00:41, 3 February 2017
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	{{New items\|3.0140\|1.4\|		{{New items\|3.0140\|1.4\|
	This function ~~downloads a~~ file ~~from the HTTP server~~. ~~This can only be used on files on~~ the ~~HTTP server associated with the MTA server~~ and ~~will only download files from within~~ the ~~folder of~~ the ~~resource that is calling it~~. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details~~. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run~~.		This function ensures the requested resource file is correct and then triggers [[onClientFileDownloadComplete]]. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run. The '''file''' should also be included in the resource meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details.
	}}		}}
	{{Tip\|If you are only using [[downloadFile]] to download mod files after other resources, then do not use [[downloadFile]], and instead set<br/> '<download_priority_group>-1</download_priority_group>' in the resource [[meta.xml]]}}		{{Tip\|If you are only using [[downloadFile]] to download mod files after other resources, then do not use [[downloadFile]], and instead set<br/> '<download_priority_group>-1</download_priority_group>' in the resource [[meta.xml]]}}
	{{Note\|This function may cause performance issues with client and/or server.}}		{{Note\|This function may cause performance issues with client and/or server.}}
			{{Tip\|Avoid using fileExists before calling [[downloadFile]]. Always call [[downloadFile]] and handle the result in [[onClientFileDownloadComplete]]}}
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Ccw at 12:05, 28 July 2016

2016-07-28T12:05:27Z

← Older revision		Revision as of 12:05, 28 July 2016
Line 5:		Line 5:
	}}		}}
	{{Tip\|If you are only using [[downloadFile]] to download mod files after other resources, then do not use [[downloadFile]], and instead set<br/> '<download_priority_group>-1</download_priority_group>' in the resource [[meta.xml]]}}		{{Tip\|If you are only using [[downloadFile]] to download mod files after other resources, then do not use [[downloadFile]], and instead set<br/> '<download_priority_group>-1</download_priority_group>' in the resource [[meta.xml]]}}
			{{Note\|This function may cause performance issues with client and/or server.}}
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Ccw at 21:12, 8 March 2016

2016-03-08T21:12:45Z

← Older revision		Revision as of 21:12, 8 March 2016
Line 4:		Line 4:
	This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.		This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.
	}}		}}
			{{Tip\|If you are only using [[downloadFile]] to download mod files after other resources, then do not use [[downloadFile]], and instead set<br/> '<download_priority_group>-1</download_priority_group>' in the resource [[meta.xml]]}}
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

NukeMTA: /* Example */

2014-12-17T16:53:12Z

Example

← Older revision		Revision as of 16:53, 17 December 2014
Line 21:		Line 21:
	-- the function is called on resource start		-- the function is called on resource start
	function onThisResourceStart ( )		function onThisResourceStart ( )
	downloadFile ( "test.~~txt~~" )		downloadFile ( "test.xml" )
	end		end
	addEventHandler ( "onClientResourceStart", resourceRoot, onThisResourceStart )		addEventHandler ( "onClientResourceStart", resourceRoot, onThisResourceStart )

X86dev at 08:39, 7 June 2013

2013-06-07T08:39:21Z

← Older revision		Revision as of 08:39, 7 June 2013
Line 1:		Line 1:
	{{Client function}}		{{Client function}}
	__NOTOC__		__NOTOC__
	{{New items\|3.~~0141~~\|1.4\|		{{New items\|3.0140\|1.4\|
	This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.		This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.
	}}		}}

X86dev at 08:38, 7 June 2013

2013-06-07T08:38:09Z

← Older revision		Revision as of 08:38, 7 June 2013
Line 1:		Line 1:
	{{Client function}}		{{Client function}}
	__NOTOC__		__NOTOC__
	{{New items\|3.~~0151~~\|1.4\|		{{New items\|3.0141\|1.4\|
	This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.		This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.
	}}		}}

FabioGNR: /* Example */

2012-09-22T23:34:10Z

Example

← Older revision		Revision as of 23:34, 22 September 2012
Line 17:		Line 17:

	==Example==		==Example==
	'''Example 1:''' This client side event downloads a file when the resource has started.		'''Example 1:''' This client side event downloads a file when the current resource has started.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- the function is called~~, since the local player never changes)~~		-- the function is called on resource start
	function ~~onStart~~ ( )		function onThisResourceStart ( )
	downloadFile ( "test.txt" )		downloadFile ( "test.txt" )
	end		end
	addEventHandler ( "onClientResourceStart", ~~getRootElement()~~, ~~onStart~~ )		addEventHandler ( "onClientResourceStart", resourceRoot, onThisResourceStart )
	</syntaxhighlight>		</syntaxhighlight>

	==See Also==		==See Also==
	{{Client_utility_functions}}		{{Client_utility_functions}}

X86dev at 17:40, 13 May 2012

2012-05-13T17:40:57Z

← Older revision		Revision as of 17:40, 13 May 2012
Line 3:		Line 3:
	{{New items\|3.0151\|1.4\|		{{New items\|3.0151\|1.4\|
	This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.		This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.
			}}

	==Syntax==		==Syntax==
Line 24:		Line 25:
	addEventHandler ( "onClientResourceStart", getRootElement(), onStart )		addEventHandler ( "onClientResourceStart", getRootElement(), onStart )
	</syntaxhighlight>		</syntaxhighlight>
	}}
	==See Also==		==See Also==
	{{Client_utility_functions}}		{{Client_utility_functions}}

Ccw at 06:08, 9 May 2012

2012-05-09T06:08:20Z

← Older revision		Revision as of 06:08, 9 May 2012
Line 1:		Line 1:
	{{Client function}}		{{Client function}}
	__NOTOC__		__NOTOC__
			{{New items\|3.0151\|1.4\|
	This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.		This function downloads a file from the HTTP server. This can only be used on files on the HTTP server associated with the MTA server and will only download files from within the folder of the resource that is calling it. The '''file''' should also be included in meta.xml with the '''download''' attribute set to "false", see [[meta.xml]] for more details. If the file has been previously downloaded and the CRC matches, the file will not be downloaded again but [[onClientFileDownloadComplete]] will still run.

Line 23:		Line 24:
	addEventHandler ( "onClientResourceStart", getRootElement(), onStart )		addEventHandler ( "onClientResourceStart", getRootElement(), onStart )
	</syntaxhighlight>		</syntaxhighlight>
			}}
	==See Also==		==See Also==
	{{Client_utility_functions}}		{{Client_utility_functions}}

Johan van Tiel: Undo revision 29959 by Erdem kilic (talk)

2012-04-15T10:12:02Z

Undo revision 29959 by Erdem kilic (talk)

← Older revision		Revision as of 10:12, 15 April 2012
Line 9:		Line 9:

	===Required Arguments===		===Required Arguments===
	* '''fileName''': ~~Indirmek için dosyanın adını başvuran bir dize~~		* '''fileName''': A string referencing the name of the file to download

	===Returns===		===Returns===