summaryrefslogtreecommitdiff
path: root/doc/classes/EditorResourcePreview.xml
blob: 4dc46945cfdd63e0d6559cb4da329b5af0d6e360 (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
56
57
58
59
60
61
62
63
64
65
<?xml version="1.0" encoding="UTF-8" ?>
<class name="EditorResourcePreview" inherits="Node" version="4.0">
	<brief_description>
		Helper to generate previews of resources or files.
	</brief_description>
	<description>
		This object is used to generate previews for resources of files.
		[b]Note:[/b] This class shouldn't be instantiated directly. Instead, access the singleton using [method EditorInterface.get_resource_previewer].
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="add_preview_generator">
			<return type="void" />
			<argument index="0" name="generator" type="EditorResourcePreviewGenerator" />
			<description>
				Create an own, custom preview generator.
			</description>
		</method>
		<method name="check_for_invalidation">
			<return type="void" />
			<argument index="0" name="path" type="String" />
			<description>
				Check if the resource changed, if so, it will be invalidated and the corresponding signal emitted.
			</description>
		</method>
		<method name="queue_edited_resource_preview">
			<return type="void" />
			<argument index="0" name="resource" type="Resource" />
			<argument index="1" name="receiver" type="Object" />
			<argument index="2" name="receiver_func" type="StringName" />
			<argument index="3" name="userdata" type="Variant" />
			<description>
				Queue the [code]resource[/code] being edited for preview. Once the preview is ready, the [code]receiver[/code]'s [code]receiver_func[/code] will be called. The [code]receiver_func[/code] must take the following four arguments: [String] path, [Texture2D] preview, [Texture2D] thumbnail_preview, [Variant] userdata. [code]userdata[/code] can be anything, and will be returned when [code]receiver_func[/code] is called.
				[b]Note[/b]: If it was not possible to create the preview the [code]receiver_func[/code] will still be called, but the preview will be null.
			</description>
		</method>
		<method name="queue_resource_preview">
			<return type="void" />
			<argument index="0" name="path" type="String" />
			<argument index="1" name="receiver" type="Object" />
			<argument index="2" name="receiver_func" type="StringName" />
			<argument index="3" name="userdata" type="Variant" />
			<description>
				Queue a resource file located at [code]path[/code] for preview. Once the preview is ready, the [code]receiver[/code]'s [code]receiver_func[/code] will be called. The [code]receiver_func[/code] must take the following four arguments: [String] path, [Texture2D] preview, [Texture2D] thumbnail_preview, [Variant] userdata. [code]userdata[/code] can be anything, and will be returned when [code]receiver_func[/code] is called.
				[b]Note[/b]: If it was not possible to create the preview the [code]receiver_func[/code] will still be called, but the preview will be null.
			</description>
		</method>
		<method name="remove_preview_generator">
			<return type="void" />
			<argument index="0" name="generator" type="EditorResourcePreviewGenerator" />
			<description>
				Removes a custom preview generator.
			</description>
		</method>
	</methods>
	<signals>
		<signal name="preview_invalidated">
			<argument index="0" name="path" type="String" />
			<description>
				Emitted if a preview was invalidated (changed). [code]path[/code] corresponds to the path of the preview.
			</description>
		</signal>
	</signals>
</class>