Module sdl2::render

source ·
Expand description

2D accelerated rendering

Official C documentation: https://wiki.libsdl.org/CategoryRender

Introduction

This module contains functions for 2D accelerated rendering.

This API supports the following features:

  • single pixel points
  • single pixel lines
  • filled rectangles
  • texture images
  • All of these may be drawn in opaque, blended, or additive modes.

The texture images can have an additional color tint or alpha modulation applied to them, and may also be stretched with linear interpolation, rotated or flipped/mirrored.

For advanced functionality like particle effects or actual 3D you should use SDL’s OpenGL/Direct3D support or one of the many available 3D engines.

This API is not designed to be used from multiple threads, see this bug for details.


None of the draw methods in Canvas are expected to fail. If they do, a panic is raised and the program is aborted.

Structs

Manages and owns a target (Surface or Window) and allows drawing in it.
The type that allows you to build Window-based renderers.
Manages what keeps a SDL_Renderer alive
A structure that contains information on the capabilities of a render driver or the current render context.
Contains the description of an error returned by SDL
A texture for a rendering context.
Creates Textures that cannot outlive the creator

Enums

Possible errors returned by targeting a Canvas to render to a Texture

Traits

Represents structs which can be the target of a SDL_Renderer (or Canvas).

Functions

Gets an iterator of all render drivers compiled into the SDL2 library.

Type Definitions

Alias for a Canvas that was created out of a Surface