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, StringName receiver_func, Variant userdata )

void

queue_resource_preview ( String path, Object receiver, StringName 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

void add_preview_generator ( EditorResourcePreviewGenerator generator )

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.


void queue_edited_resource_preview ( Resource resource, Object receiver, StringName receiver_func, Variant userdata )

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, Texture2D preview, Texture2D 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.


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

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, Texture2D preview, Texture2D 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.


void remove_preview_generator ( EditorResourcePreviewGenerator generator )

Removes a custom preview generator.