Struct godot_core::classes::Image

#[repr(C)]
pub struct Image { /* private fields */ }

Godot class Image.

Inherits Resource.

Related symbols:

• image: sidecar module with related enum/flag types
• IImage: virtual methods

See also Godot docs for Image.

Construction

This class is reference-counted. You can create a new instance using Image::new_gd().

Implementations

impl Image

pub fn get_width(&self) -> i32

pub fn get_height(&self) -> i32

pub fn get_size(&self) -> Vector2i

pub fn has_mipmaps(&self) -> bool

pub fn get_format(&self) -> Format

pub fn get_data(&self) -> PackedByteArray

pub fn convert(&mut self, format: Format)

pub fn get_mipmap_count(&self) -> i32

pub fn get_mipmap_offset(&self, mipmap: i32) -> i32

pub fn resize_to_po2(&mut self)

pub fn resize_to_po2_ex(&mut self) -> ExResizeToPo2<'_>

pub fn resize(&mut self, width: i32, height: i32)

pub fn resize_ex(&mut self, width: i32, height: i32) -> ExResize<'_>

pub fn shrink_x2(&mut self)

pub fn crop(&mut self, width: i32, height: i32)

pub fn flip_x(&mut self)

pub fn flip_y(&mut self)

pub fn generate_mipmaps(&mut self) -> Error

pub fn generate_mipmaps_ex(&mut self) -> ExGenerateMipmaps<'_>

pub fn clear_mipmaps(&mut self)

pub fn create( width: i32, height: i32, use_mipmaps: bool, format: Format, ) -> Option<Gd<Image>>

pub fn create_from_data( width: i32, height: i32, use_mipmaps: bool, format: Format, data: PackedByteArray, ) -> Option<Gd<Image>>

pub fn set_data( &mut self, width: i32, height: i32, use_mipmaps: bool, format: Format, data: PackedByteArray, )

pub fn is_empty(&self) -> bool

pub fn load(&mut self, path: GString) -> Error

pub fn load_from_file(path: GString) -> Option<Gd<Image>>

pub fn save_png(&self, path: GString) -> Error

pub fn save_png_to_buffer(&self) -> PackedByteArray

pub fn save_jpg(&self, path: GString) -> Error

pub fn save_jpg_ex(&self, path: GString) -> ExSaveJpg<'_>

pub fn save_jpg_to_buffer(&self) -> PackedByteArray

pub fn save_jpg_to_buffer_ex(&self) -> ExSaveJpgToBuffer<'_>

pub fn save_exr(&self, path: GString) -> Error

pub fn save_exr_ex(&self, path: GString) -> ExSaveExr<'_>

pub fn save_exr_to_buffer(&self) -> PackedByteArray

pub fn save_exr_to_buffer_ex(&self) -> ExSaveExrToBuffer<'_>

pub fn save_webp(&self, path: GString) -> Error

pub fn save_webp_ex(&self, path: GString) -> ExSaveWebp<'_>

pub fn save_webp_to_buffer(&self) -> PackedByteArray

pub fn save_webp_to_buffer_ex(&self) -> ExSaveWebpToBuffer<'_>

pub fn detect_alpha(&self) -> AlphaMode

pub fn is_invisible(&self) -> bool

pub fn detect_used_channels(&self) -> UsedChannels

pub fn detect_used_channels_ex(&self) -> ExDetectUsedChannels<'_>

pub fn compress(&mut self, mode: CompressMode) -> Error

pub fn compress_ex(&mut self, mode: CompressMode) -> ExCompress<'_>

pub fn compress_from_channels( &mut self, mode: CompressMode, channels: UsedChannels, ) -> Error

pub fn compress_from_channels_ex( &mut self, mode: CompressMode, channels: UsedChannels, ) -> ExCompressFromChannels<'_>

pub fn decompress(&mut self) -> Error

pub fn is_compressed(&self) -> bool

pub fn rotate_90(&mut self, direction: ClockDirection)

pub fn rotate_180(&mut self)

pub fn fix_alpha_edges(&mut self)

pub fn premultiply_alpha(&mut self)

pub fn srgb_to_linear(&mut self)

pub fn normal_map_to_xy(&mut self)

pub fn rgbe_to_srgb(&mut self) -> Option<Gd<Image>>

pub fn bump_map_to_normal_map(&mut self)

pub fn bump_map_to_normal_map_ex(&mut self) -> ExBumpMapToNormalMap<'_>

pub fn compute_image_metrics( &mut self, compared_image: Gd<Image>, use_luma: bool, ) -> Dictionary

pub fn blit_rect(&mut self, src: Gd<Image>, src_rect: Rect2i, dst: Vector2i)

pub fn blit_rect_mask( &mut self, src: Gd<Image>, mask: Gd<Image>, src_rect: Rect2i, dst: Vector2i, )

pub fn blend_rect(&mut self, src: Gd<Image>, src_rect: Rect2i, dst: Vector2i)

pub fn blend_rect_mask( &mut self, src: Gd<Image>, mask: Gd<Image>, src_rect: Rect2i, dst: Vector2i, )

pub fn fill(&mut self, color: Color)

pub fn fill_rect(&mut self, rect: Rect2i, color: Color)

pub fn get_used_rect(&self) -> Rect2i

pub fn get_region(&self, region: Rect2i) -> Option<Gd<Image>>

pub fn copy_from(&mut self, src: Gd<Image>)

pub fn get_pixelv(&self, point: Vector2i) -> Color

pub fn get_pixel(&self, x: i32, y: i32) -> Color

pub fn set_pixelv(&mut self, point: Vector2i, color: Color)

pub fn set_pixel(&mut self, x: i32, y: i32, color: Color)

pub fn adjust_bcs(&mut self, brightness: f32, contrast: f32, saturation: f32)

pub fn load_png_from_buffer(&mut self, buffer: PackedByteArray) -> Error

pub fn load_jpg_from_buffer(&mut self, buffer: PackedByteArray) -> Error

pub fn load_webp_from_buffer(&mut self, buffer: PackedByteArray) -> Error

pub fn load_tga_from_buffer(&mut self, buffer: PackedByteArray) -> Error

pub fn load_bmp_from_buffer(&mut self, buffer: PackedByteArray) -> Error

pub fn load_ktx_from_buffer(&mut self, buffer: PackedByteArray) -> Error

pub fn load_svg_from_buffer(&mut self, buffer: PackedByteArray) -> Error

pub fn load_svg_from_buffer_ex( &mut self, buffer: PackedByteArray, ) -> ExLoadSvgFromBuffer<'_>

pub fn load_svg_from_string(&mut self, svg_str: GString) -> Error

pub fn load_svg_from_string_ex( &mut self, svg_str: GString, ) -> ExLoadSvgFromString<'_>

pub const MAX_WIDTH: i32 = 16_777_216i32

pub const MAX_HEIGHT: i32 = 16_777_216i32

Methods from Deref<Target = Resource>

pub fn set_path(&mut self, path: GString)

pub fn take_over_path(&mut self, path: GString)

pub fn get_path(&self) -> GString

pub fn set_name(&mut self, name: GString)

pub fn get_name(&self) -> GString

pub fn get_rid(&self) -> Rid

pub fn set_local_to_scene(&mut self, enable: bool)

pub fn is_local_to_scene(&self) -> bool

pub fn get_local_scene(&self) -> Option<Gd<Node>>

pub fn setup_local_to_scene(&mut self)

pub fn emit_changed(&mut self)

pub fn duplicate(&self) -> Option<Gd<Resource>>

pub fn duplicate_ex(&self) -> ExDuplicate<'_>

Methods from Deref<Target = RefCounted>

pub fn get_reference_count(&self) -> i32

Methods from Deref<Target = Object>

pub fn get_class(&self) -> GString

pub fn is_class(&self, class: GString) -> bool

pub fn set(&mut self, property: StringName, value: Variant)

pub fn get(&self, property: StringName) -> Variant

pub fn set_indexed(&mut self, property_path: NodePath, value: Variant)

pub fn get_indexed(&self, property_path: NodePath) -> Variant

pub fn get_property_list(&self) -> Array<Dictionary>

pub fn get_method_list(&self) -> Array<Dictionary>

pub fn property_can_revert(&self, property: StringName) -> bool

pub fn property_get_revert(&self, property: StringName) -> Variant

pub fn set_script(&mut self, script: Variant)

pub fn get_script(&self) -> Variant

pub fn set_meta(&mut self, name: StringName, value: Variant)

pub fn remove_meta(&mut self, name: StringName)

pub fn get_meta(&self, name: StringName) -> Variant

pub fn get_meta_ex(&self, name: StringName) -> ExGetMeta<'_>

pub fn has_meta(&self, name: StringName) -> bool

pub fn get_meta_list(&self) -> Array<StringName>

pub fn add_user_signal(&mut self, signal: GString)

pub fn add_user_signal_ex(&mut self, signal: GString) -> ExAddUserSignal<'_>

pub fn has_user_signal(&self, signal: StringName) -> bool

pub fn emit_signal(&mut self, signal: StringName, varargs: &[Variant]) -> Error

Panics

This is a varcall method, meaning parameters and return values are passed as Variant. It can detect call failures and will panic in such a case.

pub fn try_emit_signal( &mut self, signal: StringName, varargs: &[Variant], ) -> Result<Error, CallError>

Return type

This is a varcall method, meaning parameters and return values are passed as Variant. It can detect call failures and will return Err in such a case.

pub fn call(&mut self, method: StringName, varargs: &[Variant]) -> Variant

Panics

This is a varcall method, meaning parameters and return values are passed as Variant. It can detect call failures and will panic in such a case.

pub fn try_call( &mut self, method: StringName, varargs: &[Variant], ) -> Result<Variant, CallError>

Return type

This is a varcall method, meaning parameters and return values are passed as Variant. It can detect call failures and will return Err in such a case.

pub fn call_deferred( &mut self, method: StringName, varargs: &[Variant], ) -> Variant

Panics

This is a varcall method, meaning parameters and return values are passed as Variant. It can detect call failures and will panic in such a case.

pub fn try_call_deferred( &mut self, method: StringName, varargs: &[Variant], ) -> Result<Variant, CallError>

Return type

This is a varcall method, meaning parameters and return values are passed as Variant. It can detect call failures and will return Err in such a case.

pub fn set_deferred(&mut self, property: StringName, value: Variant)

pub fn callv(&mut self, method: StringName, arg_array: VariantArray) -> Variant

pub fn has_method(&self, method: StringName) -> bool

pub fn has_signal(&self, signal: StringName) -> bool

pub fn get_signal_list(&self) -> Array<Dictionary>

pub fn get_signal_connection_list( &self, signal: StringName, ) -> Array<Dictionary>

pub fn get_incoming_connections(&self) -> Array<Dictionary>

pub fn connect(&mut self, signal: StringName, callable: Callable) -> Error

pub fn connect_ex( &mut self, signal: StringName, callable: Callable, ) -> ExConnect<'_>

pub fn disconnect(&mut self, signal: StringName, callable: Callable)

pub fn is_connected(&self, signal: StringName, callable: Callable) -> bool

pub fn set_block_signals(&mut self, enable: bool)

pub fn is_blocking_signals(&self) -> bool

pub fn notify_property_list_changed(&mut self)

pub fn set_message_translation(&mut self, enable: bool)

pub fn can_translate_messages(&self) -> bool

pub fn tr(&self, message: StringName) -> GString

pub fn tr_ex(&self, message: StringName) -> ExTr<'_>

pub fn tr_n( &self, message: StringName, plural_message: StringName, n: i32, ) -> GString

pub fn tr_n_ex( &self, message: StringName, plural_message: StringName, n: i32, ) -> ExTrN<'_>

pub fn is_queued_for_deletion(&self) -> bool

pub fn cancel_free(&mut self)

pub fn notify(&mut self, what: ObjectNotification)

⚠️ Sends a Godot notification to all classes inherited by the object.

Triggers calls to on_notification(), and depending on the notification, also to Godot’s lifecycle callbacks such as ready().

Starts from the highest ancestor (the Object class) and goes down the hierarchy. See also Godot docs for Object::notification().

Panics

If you call this method on a user-defined object while holding a GdRef or GdMut guard on the instance, you will encounter a panic. The reason is that the receiving virtual method on_notification() acquires a GdMut lock dynamically, which must be exclusive.

pub fn notify_reversed(&mut self, what: ObjectNotification)

⚠️ Like Self::notify(), but starts at the most-derived class and goes up the hierarchy.

See docs of that method, including the panics.

Trait Implementations

impl Bounds for Image

type Memory = MemRefCounted

Defines the memory strategy of the static type.

type Declarer = DeclEngine

Whether this class is a core Godot class provided by the engine, or declared by the user as a Rust struct.

impl Debug for Image

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for Image

type Target = Resource

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Image

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl GodotClass for Image

type Base = Resource

The immediate superclass of T. This is always a Godot engine class.

fn class_name() -> ClassName

The name of the class, under which it is registered in Godot.

const INIT_LEVEL: InitLevel = crate::init::InitLevel::Scene

Initialization level, during which this class should be initialized with Godot.

fn inherits<U: GodotClass>() -> bool

Returns whether Self inherits from U.

impl GodotDefault for Image

impl Inherits<Object> for Image

impl Inherits<RefCounted> for Image

impl Inherits<Resource> for Image