# Image Management > Images are a crucial type of objects in the SDK, especially concerning scene appearance, since they are used to define textures for model materials. **API functions:** * [`material.blurImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#blurimage) * [`material.clearImageRoI`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#clearimageroi) * [`material.convertFloat32To8BitsImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertfloat32to8bitsimage) * [`material.convertImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertimage) * [`material.createCheckerboardImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createcheckerboardimage) * [`material.createImageFromData`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createimagefromdata) * [`material.createImageFromDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createimagefromdefinition) * [`material.createImagesFromDefinitions`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createimagesfromdefinitions) * [`material.exportImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#exportimage) * [`material.extractImageChannels`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#extractimagechannels) * [`material.extractImageComponents`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#extractimagecomponents) * [`material.fillImageWithColor`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#fillimagewithcolor) * [`material.fillUnusedPixels`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#fillunusedpixels) * [`material.flipImageY`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#flipimagey) * [`material.getAllImages`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getallimages) * [`material.getExportImageFormats`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getexportimageformats) * [`material.getImageColorRange`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecolorrange) * [`material.getImageComponentType`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecomponenttype) * [`material.getImageComponentTypeName`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecomponenttypename) * [`material.getImageDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagedefinition) * [`material.getImageDefinitions`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagedefinitions) * [`material.getImageLayout`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagelayout) * [`material.getImagePixelColor`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelcolor) * [`material.getImagePixelInfo`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfo) * [`material.getImagePixelInfoFromDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfofromdefinition) * [`material.getImagePixelInfoFromLayoutAndType`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfofromlayoutandtype) * [`material.getImageSize`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagesize) * [`material.getImagesSizes`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagessizes) * [`material.getImportImageFormats`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimportimageformats) * [`material.getSubImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getsubimage) * [`material.importImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#importimage) * [`material.invertImageColor`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#invertimagecolor) * [`material.overrideImageFormat`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#overrideimageformat) * [`material.resizeImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#resizeimage) * [`material.rotateImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#rotateimage) * [`material.setImageRoI`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#setimageroi) * [`material.setSubImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#setsubimage) * [`material.stretchImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#stretchimage) * [`material.transformImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#transformimage) * [`material.translateImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#translateimage) * [`material.updateImageFromDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#updateimagefromdefinition) * [`material.updateImagesFromDefinitions`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#updateimagesfromdefinitions) Images are a crucial type of objects in the SDK, especially concerning scene appearance, since they are used to define textures for model materials. Additionally to the pixel data themselves, each image comes with a description of how these data are encoded and interpreted as well as a toolset of useful functions for processing and manipulation. ## Image formats The pixel format of an image describes how its binary data must be interpreted in order to produce a color. A format is defined by: * a **layout**, saying how many channels the image is made of and which component is stored in each of them, * a **component type**, describing how values of image components are encoded. ### Layout The layout describes which component is stored in each image channel. Each component can be either **R** (red), **G** (green), **B** (blue), **A** (alpha) or **Lum** (luminance, for gray scale images), and the layout is a combination of these values. It can be recovered by the functions [material.getImageLayout](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagelayout) and [material.getImageDefinition](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagedefinition). Note that the layout corresponds to the internal arrangement of the image data, but accessing image pixels via the [material.getImagePixelColor](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelcolor) function is agnostic to the internal representation and always returns a consistent color. The set of supported image layouts is listed in the following table: | Layout`material.ImageLayout.`... | Number ofchannels | Color returned by[material.getImagePixelColor](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelcolor) | | | | | -------------------------------- | :---------------: | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------- | | `R` | 1 | `(R, 0, 0, 1)` | ------------------------------------- | :--------------------: | ------------------------------------------------------------------------------------- | | `R` | 1 | `(R, 0, 0, 1)` | | | | | `G` | 1 | `(0, G, 0, 1)` | | | | | `B` | 1 | `(0, 0, B, 1)` | | | | | `A` | 1 | `(0, 0, 0, A)` | | | | | `RG` | 2 | `(R, G, 0, 1)` | | | | | `RGB` | 3 | `(R, G, B, 1)` | | | | | `RGBA` | 4 | `(R, G, B, A)` | | | | | `BGR` | 3 | `(R, G, B, 1)` | | | | | `BGRA` | 4 | `(R, G, B, A)` | | | | | `ABGR` | 4 | `(R, G, B, A)` | | | | | `Lum` | 1 | `(Lum, Lum, Lum, 1)` | | | | | `LumA` | 2 | `(Lum, Lum, Lum, A)` | | | | ### Component type A component type is defined by four attributes: * a size (number of bits), which implicitely defines the numerical precision of the type, * an internal representation (floating point or integer), * a signedness flag, defining whether negative values are allowed or not, * a normalization flag, indicating whether integers must be interpreted as reals or not. The list of supported component types is defined by combinations of these attributes: | Type`material.ImageComponentType.`... | Size(in bytes) | Internalrepresentation | Signed | Normalized | | ------------------------------------- | :------------: | :--------------------: | :----: | :--------: | | `UInt8_Norm` | 1 | integer | | ✔ | | `UInt8_Int` | 1 | integer | | | | `SInt8_Norm` | 1 | integer | ✔ | ✔ | | `SInt8_Int` | 1 | integer | ✔ | | | `UInt16_Norm` | 2 | integer | | ✔ | | `UInt16_Int` | 2 | integer | | | | `SInt16_Norm` | 2 | integer | ✔ | ✔ | | `SInt16_Int` | 2 | integer | ✔ | | | `Float16` | 2 | floating point | ✔ | | | `UInt32_Norm` | 4 | integer | | ✔ | | `UInt32_Int` | 4 | integer | | | | `SInt32_Norm` | 4 | integer | ✔ | ✔ | | `SInt32_Int` | 4 | integer | ✔ | | | `Float32` | 4 | floating point | ✔ | | | `UInt64_Norm` | 8 | integer | | ✔ | | `UInt64_Int` | 8 | integer | | | | `SInt64_Norm` | 8 | integer | ✔ | ✔ | | `SInt64_Int` | 8 | integer | ✔ | | | `Float64` | 8 | floating point | ✔ | | The component type of a given image can be recovered by the functions [material.getImageComponentType](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecomponenttype) and [material.getImageDefinition](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagedefinition). The values of the aforementionned attributes for a given type can be queried via functions [material.getImagePixelInfo](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfo), [material.getImagePixelInfoFromDefinition](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfofromdefinition) and [material.getImagePixelInfoFromLayoutAndType](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfofromlayoutandtype), which provide useful details about image formats. The internal floating point representation follows the IEEE754 norm, meaning that **Float16**, **Float32** and **Float64** respectively correspond to half, single and double precision floats, and their ranges of valid values are as defined by the norm. Non normalized integers are interpreted as they are, with a range of possible values depending on the type size `N` in bits: `[0, 2^N-1]` for unsigned integers, and `[-2^{N-1}, 2^{N-1}-1]` for signed integers. Normalized integers are interpreted as reals in the range `[0, 1]` for unsigned integers and `[-1, 1]` for signed integers. The corresponding real value `x_r` is obtained by dividing the integer `x_i` by the maximum value allowed by the type size `N`: `x_r = \frac{x_i}{2^N - 1}` for unsigned integers, and `x_r = \frac{x_i}{2^{N-1} - 1}` for signed integers. Note that, according to these conversion rules, the valid signed integer `x_i = -2^{N-1}` is expected to be lower than `-1`. To avoid issues, this particular value is simply clamped to `-1` so as to not exceed the normalized range boundaries. ### Format conversion rules The API provides functions for image conversions between different formats ([`material.convertImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertimage), [`material.convertImageToDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertimagetodefinition) and [`material.convertFloat32To8BitsImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertfloat32to8bitsimage)). Since each format has its own constraints in terms of supported components, value range and precision, some rules apply when switching from one to another: * a component that exists in both source and destination layouts is transferred by converting the data type: * out-of-bound values are clamped to the validity range of the destination type, if needed, * reals are converted to integers by rounding them to the closest one. * if a component in the destination does not exist in the source, a default value is assigned to it: * default **R**, **G**, **B** or **Lum** *= 0.0*, * default **A** *= 1.0*. * the **Lum** component in the source is transferred to any of the destination component of type **R**, **G** or **B**. * the **R**, **G** and **B** components in the source are converted to the **Lum** component in the destination by: `Lum = (R + G + B) / 3`. * if only the layout is modified and not the component type, channels are rearranged so as to match the destination format but their contents are left unchanged. According to these rules, converting from layout `material.ImageLayout.R` to layout `material.ImageLayout.B`, for instance, does not result to converting image colors from `(**R**, 0, 0, 1)` to `(0, 0, **B = R**, 1`), but to `(0, 0, 0, 1)`. If you want to change the way image channels are interpreted, use the function [`material.overrideImageFormat`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#overrideimageformat) instead. ## Image operations ### Import / export The list of image file formats and extensions available for [`material.importImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#importimage) and [`material.exportImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#exportimage) can be recovered thanks to the following functions: * [`material.getImportImageFormats`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimportimageformats) * [`material.getExportImageFormats`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getexportimageformats) During export, image data are converted to be compliant with the selected export format requirements (eg. HDR images are converted to 8 bits when exported to PNG). ### Creation * [`material.createImageFromData`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createimagefromdata) can be used to create an image from the raw data corresponding to a valid image file format. * [`material.createImageFromDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createimagefromdefinition) / [`material.createImagesFromDefinitions`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createimagesfromdefinitions) * [`material.updateImageFromDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#updateimagefromdefinition) / [`material.updateImagesFromDefinitions`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#updateimagesfromdefinitions) have the same behaviour as [`createImageFromDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createimagefromdefinition), except that they replace existing images instead of creating a new ones. * [`material.createCheckerboardImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#createcheckerboardimage) creates a bicolor checkerboard. Mainly useful for tests or debugging purposes. ### Accessors The two main structures that contain information about images are: * [`material.ImageDefinition`](/asset-transformer-sdk/2026.4/api/python/material_types.md#imagedefinition), which allows to access raw image pixel data, as well as image dimension and format, * [`material.PixelInfo`](/asset-transformer-sdk/2026.4/api/python/material_types.md#pixelinfo), which gives additional details about the pixel format, like component count and size, and type attributes (internal representation, normalization, signedness). Access to image format details (see [above](#image-formats) for more details): * [`material.getImageComponentType`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecomponenttype) * [`material.getImageComponentTypeName`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecomponenttypename) * [`material.getImageFormatName`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimageformatname) * [`material.getImageLayout`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagelayout) * [`material.getImagePixelInfo`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfo) / [`material.getImagePixelInfoFromDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfofromdefinition) / [`material.getImagePixelInfoFromLayoutAndType`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelinfofromlayoutandtype) Access to image attributes and content: * [`material.getAllImages`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getallimages) returns the list of all images available in the current session. * [`material.getImageDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagedefinition) / [`material.getImageDefinitions`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagedefinitions) returns the definition (as described above) of one or multiple images. * [`material.getImageSize`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagesize) / [`material.getImagesSizes`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagessizes) return the dimensions (width and height) of one or multiple images. * [`material.getImagePixelColor`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagepixelcolor) returns the color quadruplet (R,G,B,A) of a single image pixel, converted from the raw data according to the image format. * [`material.getImageColorBilinear`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecolorbilinear) returns a bi-linearly interpolated color from image coordinates expressed as real numbers. * [`material.getImageColorRange`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getimagecolorrange) returns, for each color component, the min and max values of the whole image. This can be provided, for instance, to the function [`convertFloat32To8BitsImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertfloat32to8bitsimage) in order to remap from an unbound range to a valid 8bits range. ### Modifiers Conversion and component manipulation: * [`material.overrideImageFormat`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#overrideimageformat) enables to change the image format of an image without modifying its data, in order to change the way data are interpreted. * [`material.convertImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertimage) / [`material.convertImageToDefinition`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertimagetodefinition) / [`material.convertFloat32To8BitsImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#convertfloat32to8bitsimage) provide a way to convert the image from one format to another. * [`material.extractImageChannels`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#extractimagechannels) / [`material.extractImageComponents`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#extractimagecomponents) allow to decompose the different components the image is made of. Transformation: * [`material.resizeImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#resizeimage) changes the image dimensions and rescales its content accordingly. * [`material.rotateImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#rotateimage) applies a rotation to the image content. * [`material.stretchImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#stretchimage) applies a non-uniform scaling to the image content. * [`material.translateImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#translateimage) applies a translation to the image content. * [`material.transformImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#transformimage) applies a generic 3x3 matrix to the image content. Processing: * [`material.fillImageWithColor`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#fillimagewithcolor) fills a sub-part or a whole image with a single color. * [`material.invertImageColor`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#invertimagecolor) replaces, for each pixel, the value **V** by **1 - V**. This function is not expected to produce relevant results for images with non-normalized component types. * [`material.setSubImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#setsubimage) / [`material.getSubImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#getsubimage) specifies or extracts the sub-part of an image. * [`material.blurImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#blurimage) applies a box or a Gaussian filter to the image. * [`material.fillUnusedPixels`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#fillunusedpixels) allows to fill pixels in areas considered as "invalid" by dilation of valid areas. The pixel validity state can be specified either by a background color or by a validity mask. * [`material.flipImageY`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#flipimagey) reverts the order of scanlines along the image Y axis. ## Edge filters Some of the image modifiers listed above accept an edge filter as argument ([`material.blurImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#blurimage) for instance). The edge filter describes how to manage coordinates that exceed the image boundaries. There are four possible ways to assign colors to these out-of-bound locations: | `material.EdgeFilter.Clamp` | `material.EdgeFilter.Extend` | `material.EdgeFilter.Repeat` | `material.EdgeFilter.Mirror` | | :---------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------: | | ![clamp](/api/media?file=/asset-transformer-sdk/media/images/edge-filter_clamp.png) | ![extend](/api/media?file=/asset-transformer-sdk/media/images/edge-filter_extend.png) | ![repeat](/api/media?file=/asset-transformer-sdk/media/images/edge-filter_repeat.png) | ![mirror](/api/media?file=/asset-transformer-sdk/media/images/edge-filter_mirror.png) | | *The default color `(0,0,0,1)` is returned* | *The color of the closest valid boundary pixel is returned* | *The image is repeated by taking coordinates modulus* | *The image is repeated in a mirrored way* | ## Regions of interest Sometimes, it may be desired to apply a modifier to only a sub-part of an image. This can be achieved by the mean of regions of interest (RoI). The function [`material.setImageRoI`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#setimageroi) enables to specify a rectangular window inside the image frame which defines the pixels that will be affected by the subsequent processes. The following example illustrates the result of the function [`material.rotateImage`](/asset-transformer-sdk/2026.4/api/python/material_functions.md#rotateimage) applied to the whole image, or to only a part of it specified thanks to a RoI: | ![original](/api/media?file=/asset-transformer-sdk/media/images/super.png) | ![rotated](/api/media?file=/asset-transformer-sdk/media/images/super_rotated.png) | ![roi\_rotated](/api/media?file=/asset-transformer-sdk/media/images/super_rotated-ro-i.png) | | :------------------------------------------------------------------------: | :-------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------: | | *Original image* | *Rotation without RoI* | *Rotation with RoI* |