EditorResourcePreviewGenerator

继承: RefCounted < Object

自定义的预览生成器。

描述

自定义代码来生成预览。请查看 EditorSettings 中的 file_dialog/thumbnail_size,找出适合做预览的尺寸。

方法

bool

_can_generate_small_preview() virtual const

Texture2D

_generate(resource: Resource, size: Vector2i, metadata: Dictionary) virtual const

Texture2D

_generate_from_path(path: String, size: Vector2i, metadata: Dictionary) virtual const

bool

_generate_small_preview_automatically() virtual const

bool

_handles(type: String) virtual const


方法说明

bool _can_generate_small_preview() virtual const 🔗

如果该函数返回 true,则该生成器也会为小型预览调用 _generate_generate_from_path

默认情况下,它返回 false


Texture2D _generate(resource: Resource, size: Vector2i, metadata: Dictionary) virtual const 🔗

根据给定的资源生成指定大小的预览。必须始终实现。

失败时允许返回空纹理,会由其他生成器接手。

必须保持谨慎,因为这个函数始终是从(主线程以外的)线程中调用的。

可以修改 metadata 字典,从而保存能够在 EditorResourceTooltipPlugin._make_tooltip_for_path 中使用的文件相关的源数据(例如图片大小、采样长度等)。


Texture2D _generate_from_path(path: String, size: Vector2i, metadata: Dictionary) virtual const 🔗

根据路径直接生成指定大小的预览。可选实现,默认代码会在加载后调用 _generate

失败时允许返回空纹理,会由其他生成器接手。

必须保持谨慎,因为这个函数始终是从(主线程以外的)线程中调用的。

可以修改 metadata 字典,从而保存能够在 EditorResourceTooltipPlugin._make_tooltip_for_path 中使用的文件相关的源数据(例如图片大小、采样长度等)。


bool _generate_small_preview_automatically() virtual const 🔗

如果该函数返回 true,则该生成器将自动从通过方法 _generate_generate_from_path 生成的普通预览纹理生成小型预览。

默认情况下,它返回 false


bool _handles(type: String) virtual const 🔗

如果你的生成器支持类型为 type 的资源,则返回 true