Struct sfml::graphics::Vertex

#[repr(C)]
pub struct Vertex {
    pub position: Vector2f,
    pub color: Color,
    pub tex_coords: Vector2f,
}

Define a point with color and texture coordinates.

A vertex is an improved point.

It has a position and other extra attributes that will be used for drawing: in SFML, vertices also have a color and a pair of texture coordinates.

The vertex is the building block of drawing. Everything which is visible on screen is made of vertices. They are grouped as 2D primitives (triangles, quads, …), and these primitives are grouped to create even more complex 2D entities such as sprites, texts, etc.

If you use the graphical entities of SFML (sprite, text, shape) you won’t have to deal with vertices directly. But if you want to define your own 2D entities, such as tiled maps or particle systems, using vertices will allow you to get maximum performances.

Example:

// define a 100x100 square, red, with a 10x10 texture mapped on it
let vertices = [
    Vertex::new(Vector2f::new(  0.,   0.), Color::RED, Vector2f::new( 0.,  0.)),
    Vertex::new(Vector2f::new(  0., 100.), Color::RED, Vector2f::new( 0., 10.)),
    Vertex::new(Vector2f::new(100., 100.), Color::RED, Vector2f::new(10., 10.)),
    Vertex::new(Vector2f::new(100.,   0.), Color::RED, Vector2f::new(10.,  0.)),
];
// draw it
window.draw_primitives(&vertices, PrimitiveType::QUADS, &RenderStates::DEFAULT);

Note: although texture coordinates are supposed to be an integer amount of pixels, their type is float because of some buggy graphics drivers that are not able to process integer coordinates correctly.

Fields

position: Vector2f

2D position of the vertex

color: Color

Color of the vertex.

tex_coords: Vector2f

Coordinates of the texture’s pixel to map to the vertex.

Implementations

impl Vertex

pub const fn new(position: Vector2f, color: Color, tex_coords: Vector2f) -> Self

Create a new Vertex

Arguments

• position - Position of the vertex
• color - Color of the vertex
• tex_coords - Texture coordinate of the vertex

Return a Vertex

pub const fn with_pos(position: Vector2f) -> Self

Create a new Vertex with a position

Arguments

• position - Position of the vertex

Default

• color - white
• tex_coords - (0., 0.)

Return a Vertex

pub const fn with_pos_color(position: Vector2f, color: Color) -> Vertex

Create a new Vertex with the position and the color

Arguments

• position - Position of the vertex
• color - Color of the vertex

Default

• tex_coords - (0., 0)

Return a Vertex

pub const fn with_pos_coords(position: Vector2f, tex_coords: Vector2f) -> Vertex

Create a new Vertex with the position and the texture coordinates

Arguments

• position - Position of the vertex
• tex_coords - Texture coordinate of the vertex

Default

• color - white

Return a Vertex

Trait Implementations

impl Clone for Vertex

fn clone(&self) -> Vertex

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Vertex

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Vertex

Create a new default Vertex

Default

• position - (0., 0.)
• color - white
• tex_coords - (0., 0.)

Return a Vertex

fn default() -> Vertex

Returns the “default value” for a type.

impl Copy for Vertex