Lib.rs

Cargo Features

[dependencies]
bevy_image = { version = "0.17.1", default-features = false, features = ["bevy_reflect", "basis-universal", "bmp", "dds", "exr", "ff", "gif", "hdr", "ktx2", "ico", "jpeg", "png", "pnm", "qoi", "tga", "tiff", "webp", "serialize", "zlib", "zstd", "zstd_rust", "zstd_c", "compressed_image_saver"] }

default = bevy_reflect

The bevy_reflect feature is set by default whenever bevy_image is added without default-features = false somewhere in the dependency tree.

bevy_reflect default serialize?

bevy_reflect can't optional as it's needed for TypePath this feature only control reflection in bevy_image

Enables bevy_reflect of bevy_math

basis-universal compressed_image_saver?

Image formats

Enables basis-universal

For transcoding of UASTC/ETC1S universal formats, and for .basis file support

Affects ktx2::get_transcoded_formats…

bmp

Enables bmp of image

rendering

dds = ddsfile

Affects dds::dds_buffer_to_image, dds::dds_format_to_texture_format…

exr

Enables exr of image

Affects exr_texture_loader::ExrTextureLoader, exr_texture_loader::ExrTextureLoaderSettings, exr_texture_loader::ExrTextureLoaderError…

ff

Enables ff of image

gif

Enables gif of image

hdr

Enables hdr of image

ktx2

Enables ktx2

Affects ktx2::ktx2_buffer_to_image, ktx2::ktx2_get_texture_format, ktx2::ktx2_dfd_header_to_texture_format, ktx2::ktx2_format_to_texture_format…

ico

Enables ico of image

jpeg

Enables jpeg of image

png

Enables png of image

pnm

Enables pnm of image

qoi

Enables qoi of image

tga

Enables tga of image

tiff

Enables tiff of image

webp

Enables webp of image

serialize = bevy_reflect

Enables serde of wgpu-types ^26 and serialize of bevy_platform

bevy_platform:

Functionality

Adds serialization support through serde.

zlib = flate2

For ktx2 supercompression

zstd zstd_c? zstd_rust?

A marker feature indicating zstd support is required for a particular feature.
A backend must be chosen by enabling either the "zstd_rust" or the "zstd_c" feature.

zstd_rust = zstd

Pure-rust zstd implementation (safer)

Enables ruzstd

zstd_c = zstd

Binding to zstd C implementation (faster)

Enables zstd

compressed_image_saver = basis-universal

Enables compressed KTX2 UASTC texture output on the asset processor

Features from optional dependencies

In crates that don't use the dep: syntax, optional dependencies automatically become Cargo features. These features may have been created by mistake, and this functionality may be removed in the future.

ddsfile dds?

flate2 zlib?

Enables flate2

For ktx2 supercompression