impeller::android Namespace Reference

Namespaces
namespace	testing

Classes
struct	AndroidProc
class	Choreographer
	This class describes access to the choreographer instance for the current thread. Choreographers are only available on API levels above 24. On levels below 24, an invalid choreographer will be returned. More...
class	HardwareBuffer
	A wrapper for AHardwareBuffer https://developer.android.com/ndk/reference/group/a-hardware-buffer. More...
struct	HardwareBufferDescriptor
	A descriptor use to specify hardware buffer allocations. More...
class	NativeWindow
	A wrapper for ANativeWindow https://developer.android.com/ndk/reference/group/a-native-window. More...
struct	ProcTable
	The table of Android procs that are resolved dynamically. More...
class	SurfaceControl
	A wrapper for ASurfaceControl. https://developer.android.com/ndk/reference/group/native-activity#asurfacecontrol. More...
class	SurfaceTransaction
	A wrapper for ASurfaceTransaction. https://developer.android.com/ndk/reference/group/native-activity#asurfacetransaction. More...
struct	TransactionInFlightData
struct	WrappedSurfaceTransaction
	A wrapper class that indicates whether a SurfaceTransaction was created by the flutter engine or was borrowed from Java for platform interop. More...

Typedefs
using	HardwareBufferUsage = Mask< HardwareBufferUsageFlags >

Enumerations
enum class	HardwareBufferFormat { kR8G8B8A8UNormInt }
enum class	HardwareBufferUsageFlags {   kNone = 0u ,   kFrameBufferAttachment = 1u << 0u ,   kCompositorOverlay = 1u << 1u ,   kSampledImage = 1u << 2u ,   kCPUReadRarely = 1u << 3u ,   kCPUReadOften = 1u << 4u ,   kCPUWriteRarely = 1u << 5u ,   kCPUWriteOften = 1u << 6u }

Functions
static Choreographer::FrameTimePoint	ClockMonotonicNanosToFrameTimePoint (int64_t p_nanos)
static AHardwareBuffer_Format	ToAHardwareBufferFormat (HardwareBufferFormat format)
static AHardwareBuffer_Desc	ToAHardwareBufferDesc (const HardwareBufferDescriptor &desc)
const ProcTable &	GetProcTable ()
ProcTable &	GetMutableProcTable ()
template<class T >
void	ResolveAndroidProc (AndroidProc< T > &proc, const std::vector< fml::RefPtr< fml::NativeLibrary > > &libs)
ASurfaceTransaction *	ASurfaceTransaction_fromJava (JNIEnv *env, jobject transaction)
fml::UniqueFD	CreatePreviousReleaseFence (const SurfaceControl &control, ASurfaceTransactionStats *stats)

Typedef Documentation

HardwareBufferUsage

using impeller::android::HardwareBufferUsage = typedef Mask<HardwareBufferUsageFlags>

Definition at line 42 of file hardware_buffer.h.

Enumeration Type Documentation

HardwareBufferFormat

enum class impeller::android::HardwareBufferFormat

strong

Enumerator
kR8G8B8A8UNormInt	This format is guaranteed to be supported on all versions of Android. This format can also be converted to an Impeller and Vulkan format. See also Vulkan Format: VK_FORMAT_R8G8B8A8_UNORM OpenGL ES Format: GL_RGBA8 Why have many format when one format do trick?

Definition at line 18 of file hardware_buffer.h.

                                {
  //----------------------------------------------------------------------------
  /// This format is guaranteed to be supported on all versions of Android. This
  /// format can also be converted to an Impeller and Vulkan format.
  ///
  /// @see        Vulkan Format: VK_FORMAT_R8G8B8A8_UNORM
  /// @see        OpenGL ES Format: GL_RGBA8
  ///
  /// Why have many format when one format do trick?
  ///
  kR8G8B8A8UNormInt,
};

HardwareBufferUsageFlags

enum class impeller::android::HardwareBufferUsageFlags

strong

Enumerator
kNone
kFrameBufferAttachment
kCompositorOverlay
kSampledImage
kCPUReadRarely
kCPUReadOften
kCPUWriteRarely
kCPUWriteOften

Definition at line 31 of file hardware_buffer.h.

                                    {
  kNone = 0u,
  kFrameBufferAttachment = 1u << 0u,
  kCompositorOverlay = 1u << 1u,
  kSampledImage = 1u << 2u,
  kCPUReadRarely = 1u << 3u,
  kCPUReadOften = 1u << 4u,
  kCPUWriteRarely = 1u << 5u,
  kCPUWriteOften = 1u << 6u,
};

Function Documentation

ASurfaceTransaction_fromJava()

ASurfaceTransaction * impeller::android::ASurfaceTransaction_fromJava	(	JNIEnv *	env,
		jobject	transaction
	)

ClockMonotonicNanosToFrameTimePoint()

static Choreographer::FrameTimePoint impeller::android::ClockMonotonicNanosToFrameTimePoint ( int64_t  p_nanos )

static

Definition at line 33 of file choreographer.cc.

                     {
  return Choreographer::FrameTimePoint{std::chrono::nanoseconds(p_nanos)};
}

Referenced by impeller::android::Choreographer::PostFrameCallback().

CreatePreviousReleaseFence()

fml::UniqueFD impeller::android::CreatePreviousReleaseFence	(	const SurfaceControl &	control,
		ASurfaceTransactionStats *	stats
	)

Definition at line 11 of file surface_transaction_stats.cc.

                                                                          {
  const auto fd =
      GetProcTable().ASurfaceTransactionStats_getPreviousReleaseFenceFd(
          stats, control.GetHandle());
  if (fd == -1) {
    // The previous buffer has already been released. This is not an error.
    return {};
  }
  return fml::UniqueFD{fd};
}

References impeller::android::SurfaceControl::GetHandle(), and GetProcTable().

GetMutableProcTable()

ProcTable & impeller::android::GetMutableProcTable

(

)

Definition at line 18 of file proc_table.cc.

                                 {
  return const_cast<ProcTable&>(GetProcTable());
}

References GetProcTable().

GetProcTable()

const ProcTable & impeller::android::GetProcTable

(

)

Definition at line 12 of file proc_table.cc.

                                {
  static ProcTable gProcTable;
  return gProcTable;
}

Referenced by flutter::ImageExternalTexture::AHardwareBufferFor(), impeller::android::SurfaceTransaction::Apply(), flutter::ImageExternalTextureGL::CreateEGLImage(), impeller::glvk::CreateEGLImageFromAHBTexture(), CreatePreviousReleaseFence(), flutter::PlatformViewAndroidJNIImpl::createTransaction(), impeller::android::HardwareBuffer::Describe(), GetMutableProcTable(), impeller::android::HardwareBuffer::GetSystemUniqueID(), impeller::android::HardwareBuffer::HardwareBuffer(), impeller::android::HardwareBufferDescriptor::IsAllocatable(), impeller::android::Choreographer::IsAvailableOnPlatform(), impeller::android::HardwareBuffer::IsAvailableOnPlatform(), impeller::android::SurfaceControl::IsAvailableOnPlatform(), impeller::android::SurfaceTransaction::IsAvailableOnPlatform(), impeller::android::HardwareBuffer::Lock(), impeller::android::NativeWindow::NativeWindow(), impeller::android::Choreographer::PostFrameCallback(), impeller::android::SurfaceTransaction::SetBackgroundColor(), impeller::android::SurfaceTransaction::SetContents(), impeller::android::SurfaceTransaction::SetParent(), impeller::android::SurfaceControl::SurfaceControl(), impeller::android::testing::TEST(), and impeller::android::HardwareBuffer::Unlock().

ResolveAndroidProc()

template<class T >

void impeller::android::ResolveAndroidProc	(	AndroidProc< T > &	proc,
		const std::vector< fml::RefPtr< fml::NativeLibrary > > &	libs
	)

Definition at line 23 of file proc_table.cc.

                                                        {
  for (const auto& lib : libs) {
    proc.proc = lib->ResolveFunction<T*>(proc.proc_name).value_or(nullptr);
    if (proc.proc) {
      break;
    }
  }
}

References impeller::android::AndroidProc< T >::proc, and impeller::android::AndroidProc< T >::proc_name.

ToAHardwareBufferDesc()

static AHardwareBuffer_Desc impeller::android::ToAHardwareBufferDesc ( const HardwareBufferDescriptor &  desc )

static

Definition at line 20 of file hardware_buffer.cc.

                                          {
  AHardwareBuffer_Desc ahb_desc = {};
  ahb_desc.width = desc.size.width;
  ahb_desc.height = desc.size.height;
  ahb_desc.format = ToAHardwareBufferFormat(desc.format);
  ahb_desc.layers = 1u;
  if (desc.usage & HardwareBufferUsageFlags::kFrameBufferAttachment) {
    ahb_desc.usage |= (AHARDWAREBUFFER_USAGE_GPU_FRAMEBUFFER |
                       AHARDWAREBUFFER_USAGE_GPU_COLOR_OUTPUT);
  }
  if (desc.usage & HardwareBufferUsageFlags::kCompositorOverlay) {
    ahb_desc.usage |= AHARDWAREBUFFER_USAGE_COMPOSER_OVERLAY;
  }
  if (desc.usage & HardwareBufferUsageFlags::kSampledImage) {
    ahb_desc.usage |= AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE;
  }
  if (desc.usage & HardwareBufferUsageFlags::kCPUReadRarely) {
    ahb_desc.usage |= AHARDWAREBUFFER_USAGE_CPU_READ_RARELY;
  }
  if (desc.usage & HardwareBufferUsageFlags::kCPUReadOften) {
    ahb_desc.usage |= AHARDWAREBUFFER_USAGE_CPU_READ_OFTEN;
  }
  if (desc.usage & HardwareBufferUsageFlags::kCPUWriteRarely) {
    ahb_desc.usage |= AHARDWAREBUFFER_USAGE_CPU_WRITE_RARELY;
  }
  if (desc.usage & HardwareBufferUsageFlags::kCPUWriteOften) {
    ahb_desc.usage |= AHARDWAREBUFFER_USAGE_CPU_WRITE_OFTEN;
  }
  return ahb_desc;
}

References impeller::android::HardwareBufferDescriptor::format, impeller::TSize< T >::height, kCompositorOverlay, kCPUReadOften, kCPUReadRarely, kCPUWriteOften, kCPUWriteRarely, kFrameBufferAttachment, kSampledImage, impeller::android::HardwareBufferDescriptor::size, ToAHardwareBufferFormat(), impeller::android::HardwareBufferDescriptor::usage, and impeller::TSize< T >::width.

Referenced by impeller::android::HardwareBufferDescriptor::IsAllocatable().

ToAHardwareBufferFormat()

static AHardwareBuffer_Format impeller::android::ToAHardwareBufferFormat ( HardwareBufferFormat  format )

static

Definition at line 11 of file hardware_buffer.cc.

                                 {
  switch (format) {
    case HardwareBufferFormat::kR8G8B8A8UNormInt:
      return AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM;
  }
  FML_UNREACHABLE();
}

References FML_UNREACHABLE, format, and kR8G8B8A8UNormInt.

Referenced by ToAHardwareBufferDesc().