{"record":{"id":"d1ce74b7fac1f0f4","repo":"bevyengine/bevy","slug":"must-not-already-be-a-layered-image","errorCode":null,"errorMessage":"must not already be a layered image","messagePattern":"must not already be a layered image","errorType":"exception","errorClass":"TextureReinterpretationError","httpStatus":null,"severity":"error","filePath":"crates/bevy_image/src/image.rs","lineNumber":2234,"sourceCode":"    /// The image was expected to have a single layer.\n    #[error(\"must not already be a layered image\")]\n    InvalidLayerCount,\n    /// 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})\")]","sourceCodeStart":2216,"sourceCodeEnd":2252,"githubUrl":"https://github.com/bevyengine/bevy/blob/8d743eb7dc7fcff57a7d5744d0bbf89620b1b145/crates/bevy_image/src/image.rs#L2216-L2252","documentation":"TextureReinterpretationError (already-layered guard): the image is already a layered/array texture, so it cannot be reinterpreted from a plain 2D image into a layered layout again.","triggerScenarios":"Thrown at crates/bevy_image/src/image.rs:2217 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Only reinterpret images that are not already layered (single-layer 2D)","Skip reinterpretation when the image already has array layers"],"exampleFix":null,"handlingStrategy":"type-guard","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"}