EditorResourcePreview

Inherits: Node < Object

Helper to generate previews of resources or files.

Description

This object is used to generate previews for resources of files.

Note: This class shouldn’t be instantiated directly. Instead, access the singleton using EditorInterface.get_resource_previewer.

Methods

void

add_preview_generator ( EditorResourcePreviewGenerator generator )

void

check_for_invalidation ( String path )

void

queue_edited_resource_preview ( Resource resource, Object receiver, String receiver_func, Variant userdata )

void

queue_resource_preview ( String path, Object receiver, String receiver_func, Variant userdata )

void

remove_preview_generator ( EditorResourcePreviewGenerator generator )

Signals

  • preview_invalidated ( String path )

Emitted if a preview was invalidated (changed). path corresponds to the path of the preview.

Method Descriptions

Create an own, custom preview generator.


  • void check_for_invalidation ( String path )

Check if the resource changed, if so, it will be invalidated and the corresponding signal emitted.


Queue the resource being edited for preview. Once the preview is ready, the receiver‘s receiver_func will be called. The receiver_func must take the following four arguments: String path, Texture preview, Texture thumbnail_preview, Variant userdata. userdata can be anything, and will be returned when receiver_func is called.

Note: If it was not possible to create the preview the receiver_func will still be called, but the preview will be null.


Queue a resource file located at path for preview. Once the preview is ready, the receiver‘s receiver_func will be called. The receiver_func must take the following four arguments: String path, Texture preview, Texture thumbnail_preview, Variant userdata. userdata can be anything, and will be returned when receiver_func is called.

Note: If it was not possible to create the preview the receiver_func will still be called, but the preview will be null.


Removes a custom preview generator.