Difference between revisions of "CompressedImageFormat"

m
m
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=enum}}
 
{{newin|[[0.9.0]]|090|type=enum}}
 +
{{deprecatedin|[[11.0]]|110|type=enum|text=It has been superseded by [[PixelFormat]].}}
 
Compressed image data formats. [http://renderingpipeline.com/2012/07/texture-compression/ Here] and [http://www.reedbeta.com/blog/2012/02/12/understanding-bcn-texture-compression-formats/ here] are a couple overviews of many of the formats.
 
Compressed image data formats. [http://renderingpipeline.com/2012/07/texture-compression/ Here] and [http://www.reedbeta.com/blog/2012/02/12/understanding-bcn-texture-compression-formats/ here] are a couple overviews of many of the formats.
  
 
Unlike traditional PNG or jpeg, these formats stay compressed in RAM and in the graphics card's VRAM. This is good for saving memory space as well as improving performance, since the graphics card will be able to keep more of the image's pixels in its fast-access cache when drawing it.
 
Unlike traditional PNG or jpeg, these formats stay compressed in RAM and in the graphics card's VRAM. This is good for saving memory space as well as improving performance, since the graphics card will be able to keep more of the image's pixels in its fast-access cache when drawing it.
 +
 +
{{notice|In LÖVE versions prior to [[0.10.0]], these constants are all lower-case.}}
 
== Constants ==
 
== Constants ==
−
;dxt1: The DXT1 format. RGB data at 4 bits per pixel (compared to 32 bits for [[ImageData]] and regular [[Image]]s.) Suitable for fully opaque images.
+
;DXT1: The DXT1 format. RGB data at 4 bits per pixel (compared to 32 bits for [[ImageData]] and regular [[Image]]s.) Suitable for fully opaque images on desktop systems.
−
;dxt3: The DXT3 format. RGBA data at 8 bits per pixel. Smooth variations in opacity do not mix well with this format.
+
;DXT3: The DXT3 format. RGBA data at 8 bits per pixel. Smooth variations in opacity do not mix well with this format.
−
;dxt5: The DXT5 format. RGBA data at 8 bits per pixel. Recommended for images with varying opacity.
+
;DXT5: The DXT5 format. RGBA data at 8 bits per pixel. Recommended for images with varying opacity on desktop systems.
−
;bc4: The BC4 format (also known as 3Dc+ or ATI1.) Stores just the red channel, at 4 bits per pixel.
+
;BC4: The BC4 format (also known as 3Dc+ or ATI1.) Stores just the red channel, at 4 bits per pixel.
−
;bc4s: The signed variant of the BC4 format. Same as above but the pixel values in the texture are in the range of [-1, 1] instead of [0, 1] in shaders.
+
;BC4s: The signed variant of the BC4 format. Same as above but pixel values in the texture are in the range of [-1, 1] instead of [0, 1] in shaders.
−
;bc5: The BC5 format (also known as 3Dc or ATI2.) Stores red and green channels at 8 bits per pixel.
+
;BC5: The BC5 format (also known as 3Dc or ATI2.) Stores red and green channels at 8 bits per pixel.
−
;bc5s: The signed variant of the BC5 format.
+
;BC5s: The signed variant of the BC5 format.
−
{{newin|[[0.9.2]]|092|type=constants|plural='y'}}
+
{{New feature|0.9.2|
−
;bc6h: The BC6H format. Stores [http://en.wikipedia.org/wiki/Half-precision_floating-point_format half-precision] floating-point RGB data in the range of [0, infinity) at 8 bits per pixel. Suitable for HDR images.
+
;BC6h: The BC6H format. Stores [http://en.wikipedia.org/wiki/Half-precision_floating-point_format half-precision] floating-point RGB data in the range of [0, 65504] at 8 bits per pixel. Suitable for HDR images on desktop systems.
−
;bc6hs: The signed variant of the BC6H format. Stores RGB data in the range of (-infinity, +infinity.)
+
;BC6hs: The signed variant of the BC6H format. Stores RGB data in the range of [-65504, +65504].
−
;bc7: The BC7 format (also known as BPTC.) Stores RGB or RGBA data at 8 bits per pixel.
+
;BC7: The BC7 format (also known as BPTC.) Stores RGB or RGBA data at 8 bits per pixel.}}
−
;bc7srgb: The sRGB-encoded variant of the BC7 format.
+
{{New feature|0.10.0|
 +
;ETC1: The ETC1 format. RGB data at 4 bits per pixel. Suitable for fully opaque images on older Android devices.
 +
;ETC2rgb: The RGB variant of the ETC2 format. RGB data at 4 bits per pixel. Suitable for fully opaque images on newer mobile devices.
 +
;ETC2rgba: The RGBA variant of the ETC2 format. RGBA data at 8 bits per pixel. Recommended for images with varying opacity on newer mobile devices.
 +
;ETC2rgba1: The RGBA variant of the ETC2 format where pixels are either fully transparent or fully opaque. RGBA data at 4 bits per pixel.
 +
;EACr: The single-channel variant of the EAC format. Stores just the red channel, at 4 bits per pixel.
 +
;EACrs: The signed single-channel variant of the EAC format. Same as above but pixel values in the texture are in the range of [-1, 1] instead of [0, 1] in shaders.
 +
;EACrg: The two-channel variant of the EAC format. Stores red and green channels at 8 bits per pixel.
 +
;EACrgs: The signed two-channel variant of the EAC format.
 +
;PVR1rgb2: The 2 bit per pixel RGB variant of the PVRTC1 format. Stores RGB data at 2 bits per pixel. Textures compressed with PVRTC1 formats must be square and power-of-two sized.
 +
;PVR1rgb4: The 4 bit per pixel RGB variant of the PVRTC1 format. Stores RGB data at 4 bits per pixel.
 +
;PVR1rgba2: The 2 bit per pixel RGBA variant of the PVRTC1 format.
 +
;PVR1rgba4: The 4 bit per pixel RGBA variant of the PVRTC1 format.
 +
;ASTC4x4: The 4x4 pixels per block variant of the ASTC format. RGBA data at 8 bits per pixel.
 +
;ASTC5x4: The 5x4 pixels per block variant of the ASTC format. RGBA data at 6.4 bits per pixel.
 +
;ASTC5x5: The 5x5 pixels per block variant of the ASTC format. RGBA data at 5.12 bits per pixel.
 +
;ASTC6x5: The 6x5 pixels per block variant of the ASTC format. RGBA data at 4.27 bits per pixel.
 +
;ASTC6x6: The 6x6 pixels per block variant of the ASTC format. RGBA data at 3.56 bits per pixel.
 +
;ASTC8x5: The 8x5 pixels per block variant of the ASTC format. RGBA data at 3.2 bits per pixel.
 +
;ASTC8x6: The 8x6 pixels per block variant of the ASTC format. RGBA data at 2.67 bits per pixel.
 +
;ASTC8x8: The 8x8 pixels per block variant of the ASTC format. RGBA data at 2 bits per pixel.
 +
;ASTC10x5: The 10x5 pixels per block variant of the ASTC format. RGBA data at 2.56 bits per pixel.
 +
;ASTC10x6: The 10x6 pixels per block variant of the ASTC format. RGBA data at 2.13 bits per pixel.
 +
;ASTC10x8: The 10x8 pixels per block variant of the ASTC format. RGBA data at 1.6 bits per pixel.
 +
;ASTC10x10: The 10x10 pixels per block variant of the ASTC format. RGBA data at 1.28 bits per pixel.
 +
;ASTC12x10: The 12x10 pixels per block variant of the ASTC format. RGBA data at 1.07 bits per pixel.
 +
;ASTC12x12: The 12x12 pixels per block variant of the ASTC format. RGBA data at 0.89 bits per pixel.}}
  
 
== Notes ==
 
== Notes ==
−
Not all formats are supported in love.graphics [[Image]]s on all systems, although the DXT formats have close to 100% support.
+
Not all formats are supported in love.graphics [[Image]]s on all systems, although the DXT formats have close to 100% support on desktop operating systems.
 +
 
 +
The BC4 and BC5 formats are supported on systems with DirectX 10 / OpenGL 3-capable desktop hardware and drivers. The BC6H and BC7 formats are only supported on desktop systems with DirectX 11 / OpenGL 4-capable hardware and very recent drivers. macOS does not support BC6H or BC7 at all currently.
 +
 
 +
ETC1 is supported by Android devices, as well as newer (OpenGL ES 3-capable) iOS devices.
 +
 
 +
The PVR1 formats are supported by iOS devices, as well as Android devices with PowerVR GPUs.
 +
 
 +
The ETC2 and EAC formats are supported by newer (OpenGL ES 3-capable) iOS and Android devices.
  
−
The BC4 and BC5 formats are supported on systems with DirectX 10 / OpenGL 3-capable hardware and drivers. The BC6H and BC7 formats are only supported on systems with DirectX 11 / OpenGL 4-capable hardware and very recent drivers. Mac OS X does not support BC6H or BC7 at all yet.
+
ASTC is only supported by very new mobile devices (e.g. the iPhone 6), and the latest Skylake (and newer) integrated Intel GPUs. It has a variety of variants to allow for picking the most compressed possible one that doesn't have any noticeable compression artifacts, for a given texture.
  
 
Use [[love.graphics.getCompressedImageFormats]] to check for support:
 
Use [[love.graphics.getCompressedImageFormats]] to check for support:
Line 26: Line 63:
 
local supportedformats = love.graphics.getCompressedImageFormats()
 
local supportedformats = love.graphics.getCompressedImageFormats()
  
−
if not supportedformats["dxt5"] then
+
if not supportedformats["DXT5"] then
−
     -- Can't load CompressedData with the DXT5 format into images!
+
     -- Can't load CompressedImageData with the DXT5 format into images!
−
     -- On some Linux systems with Mesa drivers, the user will need to install a "libtxc-dxtn" package because the DXT (aka S3TC) formats are patented.
+
     -- On some Linux systems with Mesa drivers, the user will need to install a "libtxc-dxtn" package because the DXT (aka S3TC) formats used to be patented.
 
     -- Support for DXT formats on all other desktop drivers is pretty much guaranteed.
 
     -- Support for DXT formats on all other desktop drivers is pretty much guaranteed.
 
end
 
end
  
−
if not supportedformats["bc5"] then
+
if not supportedformats["BC5"] then
−
     -- Can't load CompressedData with the BC5 format into images!
+
     -- Can't load CompressedImageData with the BC5 format into images!
 
     -- The user likely doesn't have a video card capable of using that format.
 
     -- The user likely doesn't have a video card capable of using that format.
 
end
 
end
Line 39: Line 76:
 
== See Also ==
 
== See Also ==
 
* [[parent::love.image]]
 
* [[parent::love.image]]
−
* [[parent::CompressedData]]
+
* [[parent::CompressedImageData]]
−
* [[CompressedData:getFormat]]
+
* [[CompressedImageData:getFormat]]
 
* [[love.graphics.getCompressedImageFormats]]
 
* [[love.graphics.getCompressedImageFormats]]
 
[[Category:Enums]]
 
[[Category:Enums]]
 
{{#set:Description=Compressed image data formats.}}
 
{{#set:Description=Compressed image data formats.}}
 
== Other Languages ==
 
== Other Languages ==
−
{{i18n|CompressedFormat}}
+
{{i18n|CompressedImageFormat}}

Latest revision as of 02:41, 31 July 2020

Available since LÖVE 0.9.0
This enum is not supported in earlier versions.
Deprecated in LÖVE 11.0
It has been superseded by PixelFormat..

Compressed image data formats. Here and here are a couple overviews of many of the formats.

Unlike traditional PNG or jpeg, these formats stay compressed in RAM and in the graphics card's VRAM. This is good for saving memory space as well as improving performance, since the graphics card will be able to keep more of the image's pixels in its fast-access cache when drawing it.

O.png In LÖVE versions prior to 0.10.0, these constants are all lower-case.  


Constants

DXT1
The DXT1 format. RGB data at 4 bits per pixel (compared to 32 bits for ImageData and regular Images.) Suitable for fully opaque images on desktop systems.
DXT3
The DXT3 format. RGBA data at 8 bits per pixel. Smooth variations in opacity do not mix well with this format.
DXT5
The DXT5 format. RGBA data at 8 bits per pixel. Recommended for images with varying opacity on desktop systems.
BC4
The BC4 format (also known as 3Dc+ or ATI1.) Stores just the red channel, at 4 bits per pixel.
BC4s
The signed variant of the BC4 format. Same as above but pixel values in the texture are in the range of [-1, 1] instead of [0, 1] in shaders.
BC5
The BC5 format (also known as 3Dc or ATI2.) Stores red and green channels at 8 bits per pixel.
BC5s
The signed variant of the BC5 format.
Available since LÖVE 0.9.2
BC6h
The BC6H format. Stores half-precision floating-point RGB data in the range of [0, 65504] at 8 bits per pixel. Suitable for HDR images on desktop systems.
BC6hs
The signed variant of the BC6H format. Stores RGB data in the range of [-65504, +65504].
BC7
The BC7 format (also known as BPTC.) Stores RGB or RGBA data at 8 bits per pixel.


Available since LÖVE 0.10.0
ETC1
The ETC1 format. RGB data at 4 bits per pixel. Suitable for fully opaque images on older Android devices.
ETC2rgb
The RGB variant of the ETC2 format. RGB data at 4 bits per pixel. Suitable for fully opaque images on newer mobile devices.
ETC2rgba
The RGBA variant of the ETC2 format. RGBA data at 8 bits per pixel. Recommended for images with varying opacity on newer mobile devices.
ETC2rgba1
The RGBA variant of the ETC2 format where pixels are either fully transparent or fully opaque. RGBA data at 4 bits per pixel.
EACr
The single-channel variant of the EAC format. Stores just the red channel, at 4 bits per pixel.
EACrs
The signed single-channel variant of the EAC format. Same as above but pixel values in the texture are in the range of [-1, 1] instead of [0, 1] in shaders.
EACrg
The two-channel variant of the EAC format. Stores red and green channels at 8 bits per pixel.
EACrgs
The signed two-channel variant of the EAC format.
PVR1rgb2
The 2 bit per pixel RGB variant of the PVRTC1 format. Stores RGB data at 2 bits per pixel. Textures compressed with PVRTC1 formats must be square and power-of-two sized.
PVR1rgb4
The 4 bit per pixel RGB variant of the PVRTC1 format. Stores RGB data at 4 bits per pixel.
PVR1rgba2
The 2 bit per pixel RGBA variant of the PVRTC1 format.
PVR1rgba4
The 4 bit per pixel RGBA variant of the PVRTC1 format.
ASTC4x4
The 4x4 pixels per block variant of the ASTC format. RGBA data at 8 bits per pixel.
ASTC5x4
The 5x4 pixels per block variant of the ASTC format. RGBA data at 6.4 bits per pixel.
ASTC5x5
The 5x5 pixels per block variant of the ASTC format. RGBA data at 5.12 bits per pixel.
ASTC6x5
The 6x5 pixels per block variant of the ASTC format. RGBA data at 4.27 bits per pixel.
ASTC6x6
The 6x6 pixels per block variant of the ASTC format. RGBA data at 3.56 bits per pixel.
ASTC8x5
The 8x5 pixels per block variant of the ASTC format. RGBA data at 3.2 bits per pixel.
ASTC8x6
The 8x6 pixels per block variant of the ASTC format. RGBA data at 2.67 bits per pixel.
ASTC8x8
The 8x8 pixels per block variant of the ASTC format. RGBA data at 2 bits per pixel.
ASTC10x5
The 10x5 pixels per block variant of the ASTC format. RGBA data at 2.56 bits per pixel.
ASTC10x6
The 10x6 pixels per block variant of the ASTC format. RGBA data at 2.13 bits per pixel.
ASTC10x8
The 10x8 pixels per block variant of the ASTC format. RGBA data at 1.6 bits per pixel.
ASTC10x10
The 10x10 pixels per block variant of the ASTC format. RGBA data at 1.28 bits per pixel.
ASTC12x10
The 12x10 pixels per block variant of the ASTC format. RGBA data at 1.07 bits per pixel.
ASTC12x12
The 12x12 pixels per block variant of the ASTC format. RGBA data at 0.89 bits per pixel.


Notes

Not all formats are supported in love.graphics Images on all systems, although the DXT formats have close to 100% support on desktop operating systems.

The BC4 and BC5 formats are supported on systems with DirectX 10 / OpenGL 3-capable desktop hardware and drivers. The BC6H and BC7 formats are only supported on desktop systems with DirectX 11 / OpenGL 4-capable hardware and very recent drivers. macOS does not support BC6H or BC7 at all currently.

ETC1 is supported by Android devices, as well as newer (OpenGL ES 3-capable) iOS devices.

The PVR1 formats are supported by iOS devices, as well as Android devices with PowerVR GPUs.

The ETC2 and EAC formats are supported by newer (OpenGL ES 3-capable) iOS and Android devices.

ASTC is only supported by very new mobile devices (e.g. the iPhone 6), and the latest Skylake (and newer) integrated Intel GPUs. It has a variety of variants to allow for picking the most compressed possible one that doesn't have any noticeable compression artifacts, for a given texture.

Use love.graphics.getCompressedImageFormats to check for support: 

local supportedformats = love.graphics.getCompressedImageFormats()

if not supportedformats["DXT5"] then
    -- Can't load CompressedImageData with the DXT5 format into images!
    -- On some Linux systems with Mesa drivers, the user will need to install a "libtxc-dxtn" package because the DXT (aka S3TC) formats used to be patented.
    -- Support for DXT formats on all other desktop drivers is pretty much guaranteed.
end

if not supportedformats["BC5"] then
    -- Can't load CompressedImageData with the BC5 format into images!
    -- The user likely doesn't have a video card capable of using that format.
end

See Also

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info

Retrieved from "https://love2d.org./w/index.php?title=CompressedImageFormat&oldid=25491"