Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

EditorResourcePreview

Inherits: Node < Object

A node used to generate previews of resources or files.

Description

This node is used to generate previews for resources or files.

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

Methods

void

add_preview_generator(generator: EditorResourcePreviewGenerator)

void

check_for_invalidation(path: String)

void

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

void

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

void

remove_preview_generator(generator: EditorResourcePreviewGenerator)


Signals

preview_invalidated(path: String)

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


Method Descriptions

void add_preview_generator(generator: EditorResourcePreviewGenerator)

Create an own, custom preview generator.


void check_for_invalidation(path: String)

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


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

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(path: String, receiver: Object, receiver_func: StringName, userdata: Variant)

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(generator: EditorResourcePreviewGenerator)

Removes a custom preview generator.


User-contributed notes

Please read the User-contributed notes policy before submitting a comment.