flutter::DisplayListStorage Class Reference

#include <dl_storage.h>

Public Member Functions
	DisplayListStorage ()=default
	DisplayListStorage (DisplayListStorage &&)
uint8_t *	base ()
	Returns a pointer to the base of the storage.
const uint8_t *	base () const
size_t	size () const
	Returns the currently allocated size.
size_t	capacity () const
	Returns the maximum currently allocated space.
uint8_t *	allocate (size_t needed)
void	trim ()
void	reset ()
	Resets the storage and allocation of the object to an empty state.
DisplayListStorage &	operator= (DisplayListStorage &&other)

Static Public Member Functions
static size_t	NextPowerOfTwoSize (size_t x)
	Compute the next power of two from [x].

Static Public Attributes
static const constexpr size_t	kDLPageSize = 4096u

Detailed Description

Definition at line 15 of file dl_storage.h.

Constructor & Destructor Documentation

DisplayListStorage() [1/2]

flutter::DisplayListStorage::DisplayListStorage ( )

default

DisplayListStorage() [2/2]

flutter::DisplayListStorage::DisplayListStorage

(

DisplayListStorage &&

source

)

Definition at line 60 of file dl_storage.cc.

                                                                  {
  ptr_ = std::move(source.ptr_);
  used_ = source.used_;
  allocated_ = source.allocated_;
  source.used_ = 0u;
  source.allocated_ = 0u;
}

Member Function Documentation

allocate()

uint8_t * flutter::DisplayListStorage::allocate

(

size_t

needed

)

Ensures the indicated number of bytes are available and returns a pointer to that memory within the storage while also invalidating any other outstanding pointers into the storage.

Definition at line 39 of file dl_storage.cc.

                                                   {
  if (used_ + needed > allocated_) {
    static_assert(is_power_of_two(kDLPageSize),
                  "This math needs updating for non-pow2.");
 
    // NPOT, with minimum size of kDLPageSize.
    size_t new_size = std::max(NextPowerOfTwoSize(used_ + needed), kDLPageSize);
    size_t old_size = allocated_;
    realloc(new_size);
    FML_CHECK(ptr_.get());
    FML_CHECK(allocated_ == new_size);
    FML_CHECK(allocated_ >= old_size);
    FML_CHECK(used_ + needed <= allocated_);
    memset(ptr_.get() + used_, 0, allocated_ - old_size);
  }
  uint8_t* ret = ptr_.get() + used_;
  used_ += needed;
  FML_CHECK(used_ <= allocated_);
  return ret;
}

References FML_CHECK, flutter::is_power_of_two(), kDLPageSize, and NextPowerOfTwoSize().

Referenced by flutter::testing::TEST(), and flutter::testing::TEST().

base() [1/2]

uint8_t * flutter::DisplayListStorage::base ( )

inline

Returns a pointer to the base of the storage.

Definition at line 23 of file dl_storage.h.

{ return ptr_.get(); }

Referenced by flutter::CompareOps(), flutter::DisplayList::Dispatch(), flutter::DisplayList::Dispatch(), flutter::DisplayList::Dispatch(), flutter::DisplayList::Equals(), flutter::DisplayList::GetOpType(), flutter::DisplayListBuilder::Restore(), flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

base() [2/2]

const uint8_t * flutter::DisplayListStorage::base ( ) const

inline

Definition at line 24 of file dl_storage.h.

{ return ptr_.get(); }

capacity()

size_t flutter::DisplayListStorage::capacity ( ) const

inline

Returns the maximum currently allocated space.

Definition at line 30 of file dl_storage.h.

{ return allocated_; }

Referenced by flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

NextPowerOfTwoSize()

size_t flutter::DisplayListStorage::NextPowerOfTwoSize ( size_t  x )

static

Compute the next power of two from [x].

Definition at line 14 of file dl_storage.cc.

                                                      {
  if (x == 0) {
    return 1;
  }
 
  --x;
 
  x |= x >> 1;
  x |= x >> 2;
  x |= x >> 4;
  x |= x >> 8;
  x |= x >> 16;
  if constexpr (sizeof(size_t) > 4) {
    x |= x >> 32;
  }
 
  return x + 1;
}

References x.

Referenced by allocate(), and flutter::testing::TEST().

operator=()

DisplayListStorage & flutter::DisplayListStorage::operator=

(

DisplayListStorage &&

other

)

Definition at line 74 of file dl_storage.cc.

                                                                             {
  ptr_ = std::move(source.ptr_);
  used_ = source.used_;
  allocated_ = source.allocated_;
  source.used_ = 0u;
  source.allocated_ = 0u;
  return *this;
}

reset()

void flutter::DisplayListStorage::reset

(

)

Resets the storage and allocation of the object to an empty state.

Definition at line 68 of file dl_storage.cc.

                               {
  ptr_.reset();
  used_ = 0u;
  allocated_ = 0u;
}

size()

size_t flutter::DisplayListStorage::size ( ) const

inline

Returns the currently allocated size.

Definition at line 27 of file dl_storage.h.

{ return used_; }

Referenced by flutter::DisplayList::bytes(), flutter::CompareOps(), flutter::DisplayList::Dispatch(), flutter::DisplayList::DisplayList(), flutter::DisplayList::Equals(), flutter::DisplayList::GetOpType(), flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

trim()

void flutter::DisplayListStorage::trim ( )

inline

Trims the storage to the currently allocated size and invalidates any outstanding pointers into the storage.

Definition at line 39 of file dl_storage.h.

{ realloc(used_); }

Referenced by flutter::DisplayListBuilder::Build().

Member Data Documentation

kDLPageSize

const constexpr size_t flutter::DisplayListStorage::kDLPageSize = 4096u

staticconstexpr

Definition at line 17 of file dl_storage.h.

Referenced by allocate(), flutter::testing::TEST(), and flutter::testing::TEST().

---

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

• display_list/dl_storage.h
• display_list/dl_storage.cc