impeller::DeviceBuffer Class Reference

#include <device_buffer.h>

Inheritance diagram for impeller::DeviceBuffer:

Public Member Functions
virtual	~DeviceBuffer ()
bool	CopyHostBuffer (const uint8_t *source, Range source_range, size_t offset=0u)
virtual bool	SetLabel (const std::string &label)=0
virtual bool	SetLabel (const std::string &label, Range range)=0
BufferView	AsBufferView () const
virtual std::shared_ptr< Texture >	AsTexture (Allocator &allocator, const TextureDescriptor &descriptor, uint16_t row_bytes) const
std::shared_ptr< const DeviceBuffer >	GetDeviceBuffer (Allocator &allocator) const
const DeviceBufferDescriptor &	GetDeviceBufferDescriptor () const
virtual uint8_t *	OnGetContents () const =0
Public Member Functions inherited from impeller::Buffer
virtual	~Buffer ()

Protected Member Functions
	DeviceBuffer (DeviceBufferDescriptor desc)
virtual bool	OnCopyHostBuffer (const uint8_t *source, Range source_range, size_t offset)=0

Protected Attributes
const DeviceBufferDescriptor	desc_

Detailed Description

Definition at line 20 of file device_buffer.h.

Constructor & Destructor Documentation

~DeviceBuffer()

impeller::DeviceBuffer::~DeviceBuffer ( )

virtualdefault

DeviceBuffer()

impeller::DeviceBuffer::DeviceBuffer ( DeviceBufferDescriptor  desc )

explicitprotected

Definition at line 9 of file device_buffer.cc.

: desc_(desc) {}

Member Function Documentation

AsBufferView()

BufferView impeller::DeviceBuffer::AsBufferView

(

)

const

Definition at line 19 of file device_buffer.cc.

                                            {
  BufferView view;
  view.buffer = shared_from_this();
  view.contents = OnGetContents();
  view.range = {0u, desc_.size};
  return view;
}

References impeller::BufferView::buffer, impeller::BufferView::contents, desc_, OnGetContents(), impeller::BufferView::range, and impeller::DeviceBufferDescriptor::size.

AsTexture()

std::shared_ptr< Texture > impeller::DeviceBuffer::AsTexture ( Allocator &  allocator, const TextureDescriptor &  descriptor, uint16_t  row_bytes  ) const

virtual

Definition at line 27 of file device_buffer.cc.

                              {
  auto texture = allocator.CreateTexture(descriptor);
  if (!texture) {
    return nullptr;
  }
  if (!texture->SetContents(std::make_shared<fml::NonOwnedMapping>(
          OnGetContents(), desc_.size))) {
    return nullptr;
  }
  return texture;
}

References impeller::Allocator::CreateTexture(), desc_, OnGetContents(), and impeller::DeviceBufferDescriptor::size.

CopyHostBuffer()

bool impeller::DeviceBuffer::CopyHostBuffer	(	const uint8_t *	source,
		Range	source_range,
		size_t	offset = 0u
	)

Definition at line 46 of file device_buffer.cc.

                                                               {
  if (source_range.length == 0u) {
    // Nothing to copy. Bail.
    return true;
  }
 
  if (source == nullptr) {
    // Attempted to copy data from a null buffer.
    return false;
  }
 
  if (desc_.storage_mode != StorageMode::kHostVisible) {
    // One of the storage modes where a transfer queue must be used.
    return false;
  }
 
  if (offset + source_range.length > desc_.size) {
    // Out of bounds of this buffer.
    return false;
  }
 
  return OnCopyHostBuffer(source, source_range, offset);
}

References desc_, impeller::kHostVisible, impeller::Range::length, OnCopyHostBuffer(), impeller::DeviceBufferDescriptor::size, and impeller::DeviceBufferDescriptor::storage_mode.

GetDeviceBuffer()

std::shared_ptr< const DeviceBuffer > impeller::DeviceBuffer::GetDeviceBuffer ( Allocator &  allocator ) const

virtual

Implements impeller::Buffer.

Definition at line 14 of file device_buffer.cc.

                                {
  return shared_from_this();
}

GetDeviceBufferDescriptor()

const DeviceBufferDescriptor & impeller::DeviceBuffer::GetDeviceBufferDescriptor

(

)

const

Definition at line 42 of file device_buffer.cc.

                                                                            {
  return desc_;
}

References desc_.

OnCopyHostBuffer()

virtual bool impeller::DeviceBuffer::OnCopyHostBuffer ( const uint8_t *  source, Range  source_range, size_t  offset  )

protectedpure virtual

Referenced by CopyHostBuffer().

OnGetContents()

virtual uint8_t* impeller::DeviceBuffer::OnGetContents ( ) const

pure virtual

Referenced by AsBufferView(), and AsTexture().

SetLabel() [1/2]

virtual bool impeller::DeviceBuffer::SetLabel ( const std::string &  label )

pure virtual

SetLabel() [2/2]

virtual bool impeller::DeviceBuffer::SetLabel ( const std::string &  label, Range  range  )

pure virtual

Member Data Documentation

desc_

const DeviceBufferDescriptor impeller::DeviceBuffer::desc_

protected

Definition at line 49 of file device_buffer.h.

Referenced by AsBufferView(), AsTexture(), CopyHostBuffer(), and GetDeviceBufferDescriptor().

---

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

• impeller/core/device_buffer.h
• impeller/core/device_buffer.cc