bevyengine/bevy · error · TextureReinterpretationError

incompatible sizes: old = {old:?} new = {new:?}

Error message

incompatible sizes: old = {old:?} new = {new:?}

What it means

TextureReinterpretationError::IncompatibleSizes: reinterpreting the image to new dimensions failed because the original and requested extents contain different numbers of pixels — reinterpretation requires identical total pixel volume.

Source

Thrown at crates/bevy_image/src/image.rs:2219

    /// The pixel volumes of the original and reinterpreted extents were different.
    #[error("incompatible sizes: old = {old:?} new = {new:?}")]
    IncompatibleSizes {
        /// The original image extent.
        old: Extent3d,
        /// The desired reinterpreted extent.
        new: Extent3d,
    },
    /// The image was expected to be 2d.
    #[error("must be a 2d image")]
    WrongDimension,
    /// In a texture 2d array, there needs to be at least 2 layers or else a render validation error
    /// will be throw.
    #[error("Rows * Columns must be > 1")]
    NotEnoughLayers,
    /// The image was expected to have a single layer.
    #[error("must not already be a layered image")]
    InvalidLayerCount,
    /// The stacked image could not be evenly divided into the desired number of image layers.
    #[error("can not evenly divide height = {height} by layers = {layers}")]
    HeightNotDivisibleByLayers {
        /// The total image height in pixels.
        height: u32,
        /// The desired number of image layers.
        layers: u32,
    },
    /// The grid height is not divisible by the number of tiles in the height.
    #[error("can not evenly divide grid with height = {height} by tiles = {tile_count_y}")]
    GridHeightNotDivisibleByTileHeight {
        /// The total image height in pixels.
        height: u32,
        /// The desired number of image layers.
        tile_count_y: u32,
    },
    /// The grid width is not divisible by the number of tiles in the width.
    #[error("can not evenly divide grid with width = {width} by tiles = {tile_count_x}")]
    GridWidthNotDivisibleByTileWidth {

View on GitHub (pinned to 8d743eb7dc)

Solutions

1. Choose new dimensions with the same width*height*depth product as the original
2. Resample/resize the image instead of reinterpreting when volume must change
3. Validate extents before calling reinterpret methods

When it happens

Trigger: Thrown at crates/bevy_image/src/image.rs:2202 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of bevyengine/bevy@8d743eb7dc (2026-08-20). Data as JSON: /api/errors/f0d9e08118b4cadd. Report an issue: GitHub.