Importing images

Supported image formats

Godot can import the following image formats:

  • BMP (.bmp) - No support for 16-bit per pixel images. Only 1-bit, 4-bit, 8-bit, 24-bit, and 32-bit per pixel images are supported.

  • DirectDraw Surface (.dds) - If mipmaps are present in the texture, they will be loaded directly. This can be used to achieve effects using custom mipmaps.

  • OpenEXR (.exr) - Supports HDR (highly recommended for panorama skies).

  • Radiance HDR (.hdr) - Supports HDR (highly recommended for panorama skies).

  • JPEG (.jpg, .jpeg) - Doesn't support transparency per the format's limitations.

  • PNG (.png) - Precision is limited to 8 bits per channel upon importing (no HDR images).

  • Truevision Targa (.tga)

  • SVG (.svg, .svgz) - SVGs are rasterized using NanoSVG when importing them. Support is limited; complex vectors may not render correctly. For complex vectors, rendering them to PNGs using Inkscape is often a better solution. This can be automated thanks to its command-line interface.

  • WebP (.webp) - WebP files support transparency and can be compressed lossily or losslessly. The precision is limited to 8 bits per channel.


If you've compiled the Godot editor from source with specific modules disabled, some formats may not be available.

Importing textures

Domyślną czynnością w programie Godot jest importowanie obrazów jako tekstur. Tekstury są przechowywane w pamięci karty graficznej i nie można do nich uzyskać bezpośredniego dostępu. To właśnie sprawia, że rysowanie ich jest efektywne.

Możliwości importu są ogromne:


Wykryj 3D

Ta opcja sprawia, że Godot wie, kiedy tekstura (domyślnie importowana dla 2D) jest używana w 3D. W takim przypadku ustawienia są zmieniane tak, aby flagi tekstury były bardziej przyjazne dla 3D (mipmapy, filtry i jej powtarzanie, stają się włączone, a kompresja jest zamieniana na VRAM). Tekstura jest również ponownie importowana.


Obrazy są jednym z największych zasobów gry. Aby je efektywnie obsługiwać, należy je skompresować. Godot oferuje kilka metod kompresji, w zależności od zastosowań.

Rodzaj kompresji

  • VRAM Compression: This is the most common compression mode for 3D assets. Size on disk is reduced and video memory usage is also decreased considerably (usually by a factor between 4 and 6). This mode should be avoided for 2D as it exhibits noticeable artifacts.

  • Lossless Compression: This is the most common compression mode for 2D assets. It shows assets without any kind of artifacting, and disk compression is decent. It will use considerably more amount of video memory than VRAM Compression, though. This is also the recommended setting for pixel art.

  • Lossy Compression: This is a good choice for large 2D assets. It has some artifacts, but less than VRAM and the file size is several times lower compared to Lossless or Uncompressed. Video memory usage isn't decreased by this mode; it's the same as with Lossless Compression or Uncompressed.

  • Uncompressed: Only useful for formats that can't be compressed (such as raw float images).

In this table, each of the four options are described together with their advantages and disadvantages (good = best, bad = worst):


Compress Lossless

Compress Lossy

Kompresja VRAM


Przechowywane jako surowe piksele

Stored as Lossless WebP / PNG

Stored as Lossy WebP

Stored as S3TC/BC or PVRTC/ETC depending on platform

Rozmiar na dysku

|zły| Duży

|zwykły| Mały

|dobry| Bardzo mały

|zwykły| Mały

Użycie pamięci

|zły| Duży

|zły| Duży

|zły| Duży

|dobry| Mały


|zwykły| Normalny

|zwykły| Normalny

|zwykły| Normalny

|dobry| Szybki

Utrata jakości

|dobry| Żaden

|dobry| Żaden

|zwykły| Niewielkie

|zły| Umiarkowany

Czas ładowania

|zwykły| Normalny

|zły| Powolne

|zły| Powolne

|dobry| Szybki

Tryb HDR

Godot supports high dynamic range textures (as .HDR or .EXR). These are mostly useful as high dynamic range equirectangular panorama skies (the internet has plenty if you search for them), which replace Cubemaps in Godot 2.x. Modern PCs support the BC6H VRAM format, but there are still plenty that do not.

If you want Godot to ensure full compatibility in terms of the kind of textures, enable the "Force RGBE" option.

Mapa normalnych

When using a texture as normal map, only the red and green channels are required. Given regular texture compression algorithms produce artifacts that don't look that nice in normal maps, the RGTC compression format is the best fit for this data. Forcing this option to "Enabled" will make Godot import the image as RGTC compressed. By default, it's set to "Detect", which means that if the texture is ever used as a normal map, it will be changed to "Enabled" and reimported automatically.

Note that RGTC compression affects the resulting normal map image. You will have to adjust custom shaders that use the normal map to take this into account.


Godot requires the normal map to use the X+, Y+ and Z+ coordinates, this is known as OpenGL style. If you've imported a material made to be used with another engine it may be DirectX style, in which case the normal map needs to be converted so its Y axis is flipped.

More information about normal maps (including a coordinate order table for popular engines) can be found here.


Istnieje wiele ustawień, które można przełączać podczas importowania obrazu jako tekstury, zależnie od potrzeb.


This setting is most commonly used in 3D, and is therefore generally disabled in 2D. It sets UV coordinates going beyond the 0,0 - 1,1 range to "loop".

Repeating can optionally be set to mirrored mode.


When pixels become larger than the screen pixels, this option enables linear interpolation for them. The result is a smoother (less blocky) texture. This setting can be commonly used in 2D and 3D, but it's usually disabled when making pixel perfect games.


Gdy piksele staną się mniejsze niż ekran, zostaną uruchomione mipmapy. Pomaga to zredukować efekt ziarnistości podczas kurczenia się tekstury. Należy pamiętać, że w starszym sprzęcie (GLES2, głównie mobilnym) istnieją pewne wymagania co do stosowania mipmap:

  • Szerokość i wysokość tekstury muszą być potęgami 2

  • Powtórzenie musi być włączone

Pamiętaj, że gdy podczas tworzenia gier i aplikacji na telefony, zechcesz dążyć do pełnej zgodności to będziesz potrzebował mipmap.

When doing 3D, mipmap should be turned on, as this also improves performance (smaller versions of the texture are used for objects further away).


When textures are near parallel to the view (like floors), this option makes them have more detail by reducing blurriness.


Godot uses Linear colorspace when rendering 3D. Textures mapped to albedo or detail channels need to have this option turned on in order for colors to look correct. When set to Detect mode, the texture will be marked as sRGB when used in albedo channels.


Since the texture will have its data modified when sRGB is enabled, this means using the same texture in both 2D and 3D will make the texture display with incorrect colors in either 2D or 3D.

To work around this, make a copy of the texture on the filesystem and enable sRGB on one of the copies only. Use the copy with sRGB enabled in 3D, and the copy with sRGB disabled in 2D.


Some special processes can be applied to images when imported as textures.

Popraw obramowanie alfa

This puts pixels of the same surrounding color in transition from transparency to non transparency. It helps mitigate the outline effect when exporting images from Photoshop and the like.


Dobrym pomysłem jest pozostawienie go włączonym domyślnie, chyba że potrzebne są określone wartości.

Premultiplied Alpha

An alternative to fix darkened borders is to use premultiplied alpha. By enabling this option, the texture will be converted to this format. Keep in mind that a material will need to be created that uses the PREMULT ALPHA blend mode on canvas items that need it.


A few HDR files are broken and contain sRGB color data. It is advised not to use them, but, in the worst-case scenario, toggling this option on will make them look right.

Odwróć kolor

Reverses the image's color. This is useful, for example, to convert a height map generated by external programs to depth map to use with Materiał przestrzenny.



This option only applies to SVG files. It controls the scale of the SVG image. The default scale (1.0) will make the imported SVG match its original design scale.