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.
Checking the stable version of the documentation...
EditorResourcePreviewGenerator¶
继承： RefCounted < Object
自定义的预览生成器。
描述¶
自定义代码来生成预览。请查看 EditorSettings 中的 file_dialog/thumbnail_size，找出适合做预览的尺寸。
方法¶
_can_generate_small_preview() virtual const |
|
_generate(resource: Resource, size: Vector2i, metadata: Dictionary) virtual const |
|
_generate_from_path(path: String, size: Vector2i, metadata: Dictionary) virtual const |
|
_generate_small_preview_automatically() 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。