flutter::DlVertices::Builder Class Reference

A utility class to build up a |DlVertices| object one set of data at a time. More...

#include <dl_vertices.h>

Classes
union	Flags
	flags to indicate/promise which of the optional texture coordinates or colors will be supplied during the build phase. More...

Public Member Functions
	Builder (DlVertexMode mode, int vertex_count, Flags flags, int index_count)
	Constructs a Builder and prepares room for the required and optional data. More...
bool	is_valid ()
	Returns true iff the underlying object was successfully allocated. More...
void	store_vertices (const SkPoint points[])
	Copies the indicated list of points as vertices. More...
void	store_vertices (const float coordinates[])
	Copies the indicated list of float pairs as vertices. More...
void	store_texture_coordinates (const SkPoint points[])
	Copies the indicated list of points as texture coordinates. More...
void	store_texture_coordinates (const float coordinates[])
	Copies the indicated list of float pairs as texture coordinates. More...
void	store_colors (const DlColor colors[])
	Copies the indicated list of colors as vertex colors. More...
void	store_colors (const uint32_t colors[])
	Copies the indicated list of unsigned ints as vertex colors in the 32-bit RGBA format. More...
void	store_indices (const uint16_t indices[])
	Copies the indicated list of 16-bit indices as vertex indices. More...
std::shared_ptr< DlVertices >	build ()
	Finalizes and the constructed DlVertices object. More...

Static Public Attributes
static constexpr Flags	kNone = {{false, false}}
static constexpr Flags	kHasTextureCoordinates = {{true, false}}
static constexpr Flags	kHasColors = {{false, true}}

Detailed Description

A utility class to build up a |DlVertices| object one set of data at a time.

Definition at line 75 of file dl_vertices.h.

Constructor & Destructor Documentation

Builder()

flutter::DlVertices::Builder::Builder	(	DlVertexMode	mode,
		int	vertex_count,
		Flags	flags,
		int	index_count
	)

Constructs a Builder and prepares room for the required and optional data.

Vertices are always required. Optional texture coordinates and optional colors are reserved depending on the |Flags|. Optional indices will be reserved if the index_count is positive (>0).

The caller must provide all data that is promised by the supplied |flags| and |index_count| parameters before calling the |build()| method.

Definition at line 202 of file dl_vertices.cc.

    : needs_texture_coords_(flags.has_texture_coordinates),
      needs_colors_(flags.has_colors),
      needs_indices_(index_count > 0) {
  vertex_count = std::max(vertex_count, 0);
  index_count = std::max(index_count, 0);
  void* storage =
      ::operator new(bytes_needed(vertex_count, flags, index_count));
  vertices_.reset(new (storage)
                      DlVertices(mode, vertex_count, flags, index_count),
                  DlVerticesDeleter);
}

Member Function Documentation

build()

std::shared_ptr< DlVertices > flutter::DlVertices::Builder::build

(

)

Finalizes and the constructed DlVertices object.

fails if any of the optional data promised in the constructor is missing.

Definition at line 279 of file dl_vertices.cc.

                                                   {
  FML_CHECK(is_valid());
  if (vertices_->vertex_count() <= 0) {
    // We set this to true in the constructor to make sure that they
    // call store_vertices() only once, but if there are no vertices
    // then we will not object to them never having stored any vertices
    needs_vertices_ = false;
  }
  FML_CHECK(!needs_vertices_);
  FML_CHECK(!needs_texture_coords_);
  FML_CHECK(!needs_colors_);
  FML_CHECK(!needs_indices_);
 
  vertices_->bounds_ =
      compute_bounds(vertices_->vertices(), vertices_->vertex_count_);
 
  return std::move(vertices_);
}

is_valid()

bool flutter::DlVertices::Builder::is_valid ( )

inline

Returns true iff the underlying object was successfully allocated.

Definition at line 115 of file dl_vertices.h.

{ return vertices_ != nullptr; }

store_colors() [1/2]

void flutter::DlVertices::Builder::store_colors

(

const DlColor

colors[]

)

Copies the indicated list of colors as vertex colors.

fails if colors have already been supplied or if they were not promised by the flags.has_colors.

Definition at line 261 of file dl_vertices.cc.

                                                           {
  FML_CHECK(is_valid());
  FML_CHECK(needs_colors_);
  char* pod = reinterpret_cast<char*>(vertices_.get());
  size_t bytes = vertices_->vertex_count_ * sizeof(colors[0]);
  memcpy(pod + vertices_->colors_offset_, colors, bytes);
  needs_colors_ = false;
}

store_colors() [2/2]

void flutter::DlVertices::Builder::store_colors ( const uint32_t  colors[] )

inline

Copies the indicated list of unsigned ints as vertex colors in the 32-bit RGBA format.

fails if colors have already been supplied or if they were not promised by the flags.has_colors.

Definition at line 150 of file dl_vertices.h.

                                               {
      store_colors(reinterpret_cast<const DlColor*>(colors));
    }

store_indices()

void flutter::DlVertices::Builder::store_indices

(

const uint16_t

indices[]

)

Copies the indicated list of 16-bit indices as vertex indices.

fails if indices have already been supplied or if they were not promised by (index_count > 0).

Definition at line 270 of file dl_vertices.cc.

                                                              {
  FML_CHECK(is_valid());
  FML_CHECK(needs_indices_);
  char* pod = reinterpret_cast<char*>(vertices_.get());
  size_t bytes = vertices_->index_count_ * sizeof(indices[0]);
  memcpy(pod + vertices_->indices_offset_, indices, bytes);
  needs_indices_ = false;
}

store_texture_coordinates() [1/2]

void flutter::DlVertices::Builder::store_texture_coordinates

(

const float

coordinates[]

)

Copies the indicated list of float pairs as texture coordinates.

fails if texture coordinates have already been supplied or if they were not promised by the flags.has_texture_coordinates.

Definition at line 252 of file dl_vertices.cc.

                                                                      {
  FML_CHECK(is_valid());
  FML_CHECK(needs_texture_coords_);
  char* pod = reinterpret_cast<char*>(vertices_.get());
  store_points(pod, vertices_->texture_coordinates_offset_, coords,
               vertices_->vertex_count_);
  needs_texture_coords_ = false;
}

store_texture_coordinates() [2/2]

void flutter::DlVertices::Builder::store_texture_coordinates

(

const SkPoint

points[]

)

Copies the indicated list of points as texture coordinates.

fails if texture coordinates have already been supplied or if they were not promised by the flags.has_texture_coordinates.

Definition at line 243 of file dl_vertices.cc.

                                                                        {
  FML_CHECK(is_valid());
  FML_CHECK(needs_texture_coords_);
  char* pod = reinterpret_cast<char*>(vertices_.get());
  size_t bytes = vertices_->vertex_count_ * sizeof(coords[0]);
  memcpy(pod + vertices_->texture_coordinates_offset_, coords, bytes);
  needs_texture_coords_ = false;
}

store_vertices() [1/2]

void flutter::DlVertices::Builder::store_vertices

(

const float

coordinates[]

)

Copies the indicated list of float pairs as vertices.

fails if vertices have already been supplied.

Definition at line 234 of file dl_vertices.cc.

                                                             {
  FML_CHECK(is_valid());
  FML_CHECK(needs_vertices_);
  char* pod = reinterpret_cast<char*>(vertices_.get());
  store_points(pod, vertices_->vertices_offset_, vertices,
               vertices_->vertex_count_);
  needs_vertices_ = false;
}

store_vertices() [2/2]

void flutter::DlVertices::Builder::store_vertices

(

const SkPoint

points[]

)

Copies the indicated list of points as vertices.

fails if vertices have already been supplied.

Definition at line 225 of file dl_vertices.cc.

                                                               {
  FML_CHECK(is_valid());
  FML_CHECK(needs_vertices_);
  char* pod = reinterpret_cast<char*>(vertices_.get());
  size_t bytes = vertices_->vertex_count_ * sizeof(vertices[0]);
  memcpy(pod + vertices_->vertices_offset_, vertices, bytes);
  needs_vertices_ = false;
}

Member Data Documentation

kHasColors

constexpr Flags flutter::DlVertices::Builder::kHasColors = {{false, true}}

staticconstexpr

Definition at line 98 of file dl_vertices.h.

kHasTextureCoordinates

constexpr Flags flutter::DlVertices::Builder::kHasTextureCoordinates = {{true, false}}

staticconstexpr

Definition at line 97 of file dl_vertices.h.

kNone

constexpr Flags flutter::DlVertices::Builder::kNone = {{false, false}}

staticconstexpr

Definition at line 96 of file dl_vertices.h.

---

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

• display_list/dl_vertices.h
• display_list/dl_vertices.cc