Documentation of SFML 2.1

Warning: this page refers to an old version of SFML. Click here to switch to the latest version.
sf::VertexArray Class Reference

Define a set of one or more 2D primitives. More...

#include <VertexArray.hpp>

Inheritance diagram for sf::VertexArray:
sf::Drawable

Public Member Functions

 VertexArray ()
 Default constructor.
 
 VertexArray (PrimitiveType type, unsigned int vertexCount=0)
 Construct the vertex array with a type and an initial number of vertices.
 
unsigned int getVertexCount () const
 Return the vertex count.
 
Vertexoperator[] (unsigned int index)
 Get a read-write access to a vertex by its index.
 
const Vertexoperator[] (unsigned int index) const
 Get a read-only access to a vertex by its index.
 
void clear ()
 Clear the vertex array.
 
void resize (unsigned int vertexCount)
 Resize the vertex array.
 
void append (const Vertex &vertex)
 Add a vertex to the array.
 
void setPrimitiveType (PrimitiveType type)
 Set the type of primitives to draw.
 
PrimitiveType getPrimitiveType () const
 Get the type of primitives drawn by the vertex array.
 
FloatRect getBounds () const
 Compute the bounding rectangle of the vertex array.
 

Detailed Description

Define a set of one or more 2D primitives.

sf::VertexArray is a very simple wrapper around a dynamic array of vertices and a primitives type.

It inherits sf::Drawable, but unlike other drawables it is not transformable.

Example:

lines[0].position = sf::Vector2f(10, 0);
lines[1].position = sf::Vector2f(20, 0);
lines[2].position = sf::Vector2f(30, 5);
lines[3].position = sf::Vector2f(40, 2);
window.draw(lines);
See Also
sf::Vertex

Definition at line 45 of file VertexArray.hpp.

Constructor & Destructor Documentation

sf::VertexArray::VertexArray ( )

Default constructor.

Creates an empty vertex array.

sf::VertexArray::VertexArray ( PrimitiveType  type,
unsigned int  vertexCount = 0 
)
explicit

Construct the vertex array with a type and an initial number of vertices.

Parameters
typeType of primitives
vertexCountInitial number of vertices in the array

Member Function Documentation

void sf::VertexArray::append ( const Vertex vertex)

Add a vertex to the array.

Parameters
vertexVertex to add
void sf::VertexArray::clear ( )

Clear the vertex array.

This function removes all the vertices from the array. It doesn't deallocate the corresponding memory, so that adding new vertices after clearing doesn't involve reallocating all the memory.

FloatRect sf::VertexArray::getBounds ( ) const

Compute the bounding rectangle of the vertex array.

This function returns the axis-aligned rectangle that contains all the vertices of the array.

Returns
Bounding rectangle of the vertex array
PrimitiveType sf::VertexArray::getPrimitiveType ( ) const

Get the type of primitives drawn by the vertex array.

Returns
Primitive type
unsigned int sf::VertexArray::getVertexCount ( ) const

Return the vertex count.

Returns
Number of vertices in the array
Vertex& sf::VertexArray::operator[] ( unsigned int  index)

Get a read-write access to a vertex by its index.

This function doesn't check index, it must be in range [0, getVertexCount() - 1]. The behaviour is undefined otherwise.

Parameters
indexIndex of the vertex to get
Returns
Reference to the index-th vertex
See Also
getVertexCount
const Vertex& sf::VertexArray::operator[] ( unsigned int  index) const

Get a read-only access to a vertex by its index.

This function doesn't check index, it must be in range [0, getVertexCount() - 1]. The behaviour is undefined otherwise.

Parameters
indexIndex of the vertex to get
Returns
Const reference to the index-th vertex
See Also
getVertexCount
void sf::VertexArray::resize ( unsigned int  vertexCount)

Resize the vertex array.

If vertexCount is greater than the current size, the previous vertices are kept and new (default-constructed) vertices are added. If vertexCount is less than the current size, existing vertices are removed from the array.

Parameters
vertexCountNew size of the array (number of vertices)
void sf::VertexArray::setPrimitiveType ( PrimitiveType  type)

Set the type of primitives to draw.

This function defines how the vertices must be interpreted when it's time to draw them:

  • As points
  • As lines
  • As triangles
  • As quads The default primitive type is sf::Points.
Parameters
typeType of primitive

The documentation for this class was generated from the following file: