CanvasFormat (Français)

Disponible depuis LÖVE 0.9.0
Ce-tte enum n'est pas supporté-e par des versions plus anciennes.
Déprécié dans LÖVE 11.0
Elle a été remplacée par PixelFormat..

Formats de Canvas (toile).

Constantes

normal
Format de Canvas par défaut - Généralement un alias pour le format rgba8, ou le format srgb si le rendu avec correction gamma est activée dans LÖVE 0.10.0 et plus récent.
hdr
Un format adapté aux contenu à haute plage dynamique - un alias pour le format rgba16f, normalement.
Available since LÖVE 0.9.2
rgba8
8 bits par canal (32 bpp) RGBA. L'étendue des valeurs du cannal de couleur va de 0 à 255 (0 à 1 dans les ombrages).
rgba4
4 bits par canal (16 bpp) RGBA.
rgb5a1
RGB avec 5 bits chacun, et un canal alpha 1-bit (16 bpp).
rgb565
RGB avec 5, 6, et 5 bits chacun, respectivement (16 bpp). Il n'y a pas de canal alpha dans ce format.
rgb10a2
RGB avec 10 bits par canal, et un canal alpha de 2 bits (32 bpp).
rgba16f
RGBA en virgule flotttante avec 16 bits par canal (64 bpp). Les valeurs des couleurs sont dans la plage [-65504, +65504].
rgba32f
RGBA en virgule flottante avec 32 bits par canal (128 bpp).
rg11b10f
RGB en virgule flottante avec 11 bits dans les canaux rouge et vert, et 10 bits dans le canal bleu (32 bpp). Il n'y a pas de canal alpha. Les valeurs des couleurs sont dans la plage [0, +65024].
srgb
Identique à rgba8, mais le Canvas est interprété comme étant dans l'espace colorimétrique sRGB. Tout ce qui est tracé sur le Canvas sera convertir du RGB linéaire au sRGB. Lorsque le Canvas est tracé (ou utilisé dans un ombrage), il sera décodé de sRGB vers RGB linéaire. cela réduit les bandes de couleur lors d'un rendu avec correction gamma, puisque l'encodage sRGB a d'avantage de précision que le RGB linéaire pour les couleurs plus sombres.


Disponible depuis LÖVE 0.10.0
r8
Single-channel (red component) format (8 bpp).
rg8
Two channels (red and green components) with 8 bits per channel (16 bpp).
r16f
Floating point single-channel format (16 bpp). Color values can range from [-65504, +65504].
rg16f
Floating point two-channel format with 16 bits per channel (32 bpp). Color values can range from [-65504, +65504].
r32f
Floating point single-channel format (32 bpp).
rg32f
Floating point two-channel format with 32 bits per channel (64 bpp).


Notes

The 16 bpp RGB and RGBA formats use half as much VRAM as the 32 bpp RGBA formats, but they have significantly lower quality.

The HDR / floating point formats are most useful when combined with pixel shaders. Effects such as tonemapped HDR with bloom can be accomplished, or the canvas can be used to store arbitrary non-color data such as positions which can then be used in a custom shader.

The sRGB format should only be used when doing gamma-correct rendering, which is an advanced topic and it's easy to get color-spaces mixed up. If you're not sure whether you need this, you might want to avoid it. Read more about gamma-correct rendering here, here, and here.

Not all systems support every format. Use love.graphics.getCanvasFormats to check before creating the Canvas.

In general, rgba8, rgba4, and rgb5a1 are supported everywhere. rgb10a2 is also supported everywhere on desktop platforms.

The regular single- and two-channel formats (r8 and rg8), as well as the srgb format, are supported on desktop graphics cards capable of OpenGL 3+ / DirectX 10+ (nvidia GeForce 8000 series and up, ATI/AMD HD 2000 series and up, and the Intel HD 2000 and up), and mobile GPUs capable of OpenGL ES 3.

The floating-point formats (rgba16f, rgba32f, rg11b10f, r16f, rg16f, r32f, and rg32f) are supported on OpenGL 3-capable desktop graphics cards, and some OpenGL ES 3 mobile GPUs. The 32-bit-per-channel floating point formats are rarely supported on mobile devices.

rgb565 is often only supported on OpenGL ES / mobile devices, or with very new desktop OpenGL drivers. 1

Voir également


Autres langues