summaryrefslogtreecommitdiff
path: root/doc/classes/ResourceInteractiveLoader.xml
blob: df552d36562846019950d06925da433e06b327d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<?xml version="1.0" encoding="UTF-8" ?>
<class name="ResourceInteractiveLoader" inherits="Reference" category="Core" version="3.2">
	<brief_description>
		Interactive [Resource] loader.
	</brief_description>
	<description>
		Interactive [Resource] loader. This object is returned by [ResourceLoader] when performing an interactive load. It allows loading resources with high granularity, which makes it mainly useful for displaying loading bars or percentages.
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="get_resource">
			<return type="Resource">
			</return>
			<description>
				Returns the loaded resource if the load operation completed successfully, [code]null[/code] otherwise.
			</description>
		</method>
		<method name="get_stage" qualifiers="const">
			<return type="int">
			</return>
			<description>
				Returns the load stage. The total amount of stages can be queried with [method get_stage_count].
			</description>
		</method>
		<method name="get_stage_count" qualifiers="const">
			<return type="int">
			</return>
			<description>
				Returns the total amount of stages (calls to [method poll]) needed to completely load this resource.
			</description>
		</method>
		<method name="poll">
			<return type="int" enum="Error">
			</return>
			<description>
				Polls the loading operation, i.e. loads a data chunk up to the next stage.
				Returns [constant OK] if the poll is successful but the load operation has not finished yet (intermediate stage). This means [method poll] will have to be called again until the last stage is completed.
				Returns [constant ERR_FILE_EOF] if the load operation has completed successfully. The loaded resource can be obtained by calling [method get_resource].
				Returns another [enum Error] code if the poll has failed.
			</description>
		</method>
		<method name="wait">
			<return type="int" enum="Error">
			</return>
			<description>
				Polls the loading operation successively until the resource is completely loaded or a [method poll] fails.
				Returns [constant ERR_FILE_EOF] if the load operation has completed successfully. The loaded resource can be obtained by calling [method get_resource].
				Returns another [enum Error] code if a poll has failed, aborting the operation.
			</description>
		</method>
	</methods>
	<constants>
	</constants>
</class>