Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

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 ( 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.