{"record":{"id":"58f3b6c7fc1e9cda","repo":"bevyengine/bevy","slug":"can-not-evenly-divide-height-height-by-layers","errorCode":null,"errorMessage":"can not evenly divide height = {height} by layers = {layers}","messagePattern":"can not evenly divide height = (.+?) by layers = (.+?)","errorType":"exception","errorClass":"TextureReinterpretationError","httpStatus":null,"severity":"error","filePath":"crates/bevy_image/src/image.rs","lineNumber":2237,"sourceCode":"    /// The stacked image could not be evenly divided into the desired number of image layers.\n    #[error(\"can not evenly divide height = {height} by layers = {layers}\")]\n    HeightNotDivisibleByLayers {\n        /// The total image height in pixels.\n        height: u32,\n        /// The desired number of image layers.\n        layers: u32,\n    },\n    /// The grid height is not divisible by the number of tiles in the height.\n    #[error(\"can not evenly divide grid with height = {height} by tiles = {tile_count_y}\")]\n    GridHeightNotDivisibleByTileHeight {\n        /// The total image height in pixels.\n        height: u32,\n        /// The desired number of image layers.\n        tile_count_y: u32,\n    },\n    /// The grid width is not divisible by the number of tiles in the width.\n    #[error(\"can not evenly divide grid with width = {width} by tiles = {tile_count_x}\")]\n    GridWidthNotDivisibleByTileWidth {\n        /// The total image height in pixels.\n        width: u32,\n        /// The desired number of image layers.\n        tile_count_x: u32,\n    },\n    /// The texture format is not supported.\n    #[error(\"Cannot process texture in its current format. Is it compressed?\")]\n    InvalidTextureFormat,\n}\n\n/// An error that occurs when accessing specific pixels in a texture.\n#[derive(Error, Debug)]\npub enum TextureAccessError {\n    /// Attempted to access a pixel outside the texture bounds.\n    #[error(\"out of bounds (x: {x}, y: {y}, z: {z})\")]\n    OutOfBounds {\n        /// The pixel x-coordinate.\n        x: u32,","sourceCodeStart":2219,"sourceCodeEnd":2255,"githubUrl":"https://github.com/bevyengine/bevy/blob/8d743eb7dc7fcff57a7d5744d0bbf89620b1b145/crates/bevy_image/src/image.rs#L2219-L2255","documentation":"Returned by ImageError::HeightNotDivisibleByLayers when converting a stacked sprite sheet into a texture array: the total image height is not an exact multiple of the requested layer count, so the image cannot be split into equal-height layers.","triggerScenarios":"Thrown at crates/bevy_image/src/image.rs:2220 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Adjust the number of layers so it evenly divides the image height","Resize or crop the source image so its height is a multiple of the layer count","Fix the wrong image asset being used for the intended layer count"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"8d743eb7dc7fcff57a7d5744d0bbf89620b1b145","analyzedAt":"2026-08-20T16:12:39.808Z","contentChangedAt":"2026-08-20T16:12:39.808Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}