(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)

SDL_RenderDrawPointsF

Draw multiple points on the current rendering target at subpixel precision.

Header File

Defined in SDL_render.h

Syntax

int SDL_RenderDrawPointsF(SDL_Renderer * renderer,
                      const SDL_FPoint * points,
                      int count);

Function Parameters

SDL_Renderer *	renderer	The renderer which should draw multiple points.
const SDL_FPoint *	points	The points to draw.
int	count	The number of points to draw.

Return Value

(int) Return 0 on success, or -1 on error.

Version

This function is available since SDL 2.0.10.

Example

#define WIDTH  640
#define HEIGHT 480

// Calculate centre of the screen

double x_centre = WIDTH / 2;
double y_centre = HEIGHT / 2;

/* ... */
SDL_Renderer *renderer;

// Initialize three points of triangle

SDL_FPoint a = {x_centre, y_centre};
SDL_FPoint b = {x_centre, y_centre - 10.5};
SDL_FPoint c = {x_centre - 10.5, y_centre};

// Initialize array of points

SDL_FPoint triangle[] = {
    a,
    b,
    c
};

/* ... */

// Set render color to white

SDL_SetRenderDrawColor(renderer, 255, 255, 255, 255);
SDL_RenderClear(renderer);

// Draw triangle

SDL_RenderDrawPointsF(renderer, triangle, 3);

SDL_RenderPresent(renderer);

---

CategoryAPI, CategoryAPIFunction, CategoryRender

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.