2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2022-08-05 18:51:38 +02:00
<class name= "EditorResourcePreview" inherits= "Node" version= "3.6" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-12 22:42:36 +02:00
<brief_description >
2017-10-14 12:45:26 +02:00
Helper to generate previews of resources or files.
2017-09-12 22:42:36 +02:00
</brief_description>
<description >
This object is used to generate previews for resources of files.
2020-04-14 22:09:21 +02:00
[b]Note:[/b] This class shouldn't be instantiated directly. Instead, access the singleton using [method EditorInterface.get_resource_previewer].
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
</tutorials>
<methods >
<method name= "add_preview_generator" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "generator" type= "EditorResourcePreviewGenerator" />
2017-09-12 22:42:36 +02:00
<description >
Create an own, custom preview generator.
</description>
</method>
<method name= "check_for_invalidation" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Check if the resource changed, if so, it will be invalidated and the corresponding signal emitted.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "queue_edited_resource_preview" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "resource" type= "Resource" />
<argument index= "1" name= "receiver" type= "Object" />
<argument index= "2" name= "receiver_func" type= "String" />
<argument index= "3" name= "userdata" type= "Variant" />
2017-09-12 22:42:36 +02:00
<description >
2021-05-26 09:29:12 +02:00
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, [Texture] preview, [Texture] thumbnail_preview, [Variant] userdata. [code]userdata[/code] can be anything, and will be returned when [code]receiver_func[/code] is called.
2021-10-05 14:24:34 +02:00
[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.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "queue_resource_preview" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "path" type= "String" />
<argument index= "1" name= "receiver" type= "Object" />
<argument index= "2" name= "receiver_func" type= "String" />
<argument index= "3" name= "userdata" type= "Variant" />
2017-09-12 22:42:36 +02:00
<description >
2021-05-26 09:29:12 +02:00
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, [Texture] preview, [Texture] thumbnail_preview, [Variant] userdata. [code]userdata[/code] can be anything, and will be returned when [code]receiver_func[/code] is called.
2021-10-05 14:24:34 +02:00
[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.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "remove_preview_generator" >
2021-07-30 15:28:05 +02:00
<return type= "void" />
<argument index= "0" name= "generator" type= "EditorResourcePreviewGenerator" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Removes a custom preview generator.
2017-09-12 22:42:36 +02:00
</description>
</method>
</methods>
<signals >
<signal name= "preview_invalidated" >
2021-07-30 15:28:05 +02:00
<argument index= "0" name= "path" type= "String" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Emitted if a preview was invalidated (changed). [code]path[/code] corresponds to the path of the preview.
2017-09-12 22:42:36 +02:00
</description>
</signal>
</signals>
<constants >
</constants>
</class>