flutter_windows.h File Reference

#include <dxgi.h>
#include <stddef.h>
#include <stdint.h>
#include <windows.h>
#include "flutter_export.h"
#include "flutter_messenger.h"
#include "flutter_plugin_registrar.h"

Go to the source code of this file.

Classes
struct	FlutterDesktopEngineProperties

Typedefs
typedef void(*	VoidCallback) (void *)
typedef struct FlutterDesktopViewController *	FlutterDesktopViewControllerRef
typedef struct FlutterDesktopView *	FlutterDesktopViewRef
typedef struct FlutterDesktopEngine *	FlutterDesktopEngineRef
typedef int64_t	FlutterDesktopViewId
typedef bool(*	FlutterDesktopWindowProcCallback) (HWND, UINT, WPARAM, LPARAM, void *, LRESULT *result)

Enumerations
enum	FlutterDesktopGpuPreference {   NoPreference ,   LowPowerPreference }
enum	FlutterDesktopUIThreadPolicy {   Default ,   RunOnPlatformThread ,   RunOnSeparateThread }

Functions
FLUTTER_EXPORT FlutterDesktopViewControllerRef	FlutterDesktopViewControllerCreate (int width, int height, FlutterDesktopEngineRef engine)
FLUTTER_EXPORT void	FlutterDesktopViewControllerDestroy (FlutterDesktopViewControllerRef controller)
FLUTTER_EXPORT FlutterDesktopViewId	FlutterDesktopViewControllerGetViewId (FlutterDesktopViewControllerRef view_controller)
FLUTTER_EXPORT FlutterDesktopEngineRef	FlutterDesktopViewControllerGetEngine (FlutterDesktopViewControllerRef controller)
FLUTTER_EXPORT FlutterDesktopViewRef	FlutterDesktopViewControllerGetView (FlutterDesktopViewControllerRef controller)
FLUTTER_EXPORT void	FlutterDesktopViewControllerForceRedraw (FlutterDesktopViewControllerRef controller)
FLUTTER_EXPORT bool	FlutterDesktopViewControllerHandleTopLevelWindowProc (FlutterDesktopViewControllerRef controller, HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam, LRESULT *result)
FLUTTER_EXPORT FlutterDesktopEngineRef	FlutterDesktopEngineCreate (const FlutterDesktopEngineProperties *engine_properties)
FLUTTER_EXPORT bool	FlutterDesktopEngineDestroy (FlutterDesktopEngineRef engine)
FLUTTER_EXPORT bool	FlutterDesktopEngineRun (FlutterDesktopEngineRef engine, const char *entry_point)
FLUTTER_EXPORT uint64_t	FlutterDesktopEngineProcessMessages (FlutterDesktopEngineRef engine)
FLUTTER_EXPORT void	FlutterDesktopEngineReloadSystemFonts (FlutterDesktopEngineRef engine)
FLUTTER_EXPORT FlutterDesktopPluginRegistrarRef	FlutterDesktopEngineGetPluginRegistrar (FlutterDesktopEngineRef engine, const char *plugin_name)
FLUTTER_EXPORT FlutterDesktopMessengerRef	FlutterDesktopEngineGetMessenger (FlutterDesktopEngineRef engine)
FLUTTER_EXPORT FlutterDesktopTextureRegistrarRef	FlutterDesktopEngineGetTextureRegistrar (FlutterDesktopEngineRef engine)
FLUTTER_EXPORT void	FlutterDesktopEngineSetNextFrameCallback (FlutterDesktopEngineRef engine, VoidCallback callback, void *user_data)
FLUTTER_EXPORT HWND	FlutterDesktopViewGetHWND (FlutterDesktopViewRef view)
FLUTTER_EXPORT IDXGIAdapter *	FlutterDesktopViewGetGraphicsAdapter (FlutterDesktopViewRef view)
FLUTTER_EXPORT bool	FlutterDesktopEngineProcessExternalWindowMessage (FlutterDesktopEngineRef engine, HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam, LRESULT *result)
FLUTTER_EXPORT FlutterDesktopViewRef	FlutterDesktopPluginRegistrarGetView (FlutterDesktopPluginRegistrarRef registrar)
FLUTTER_EXPORT FlutterDesktopViewRef	FlutterDesktopPluginRegistrarGetViewById (FlutterDesktopPluginRegistrarRef registrar, FlutterDesktopViewId view_id)
FLUTTER_EXPORT void	FlutterDesktopPluginRegistrarRegisterTopLevelWindowProcDelegate (FlutterDesktopPluginRegistrarRef registrar, FlutterDesktopWindowProcCallback delegate, void *user_data)
FLUTTER_EXPORT void	FlutterDesktopPluginRegistrarUnregisterTopLevelWindowProcDelegate (FlutterDesktopPluginRegistrarRef registrar, FlutterDesktopWindowProcCallback delegate)
FLUTTER_EXPORT UINT	FlutterDesktopGetDpiForHWND (HWND hwnd)
FLUTTER_EXPORT UINT	FlutterDesktopGetDpiForMonitor (HMONITOR monitor)
FLUTTER_EXPORT void	FlutterDesktopResyncOutputStreams ()

Typedef Documentation

FlutterDesktopEngineRef

typedef struct FlutterDesktopEngine* FlutterDesktopEngineRef

Definition at line 33 of file flutter_windows.h.

FlutterDesktopViewControllerRef

typedef struct FlutterDesktopViewController* FlutterDesktopViewControllerRef

Definition at line 25 of file flutter_windows.h.

FlutterDesktopViewId

typedef int64_t FlutterDesktopViewId

Definition at line 36 of file flutter_windows.h.

FlutterDesktopViewRef

typedef struct FlutterDesktopView* FlutterDesktopViewRef

Definition at line 29 of file flutter_windows.h.

FlutterDesktopWindowProcCallback

typedef bool(* FlutterDesktopWindowProcCallback) (HWND, UINT, WPARAM, LPARAM, void *, LRESULT *result)

Definition at line 271 of file flutter_windows.h.

VoidCallback

typedef void(* VoidCallback) (void *)

Definition at line 21 of file flutter_windows.h.

Enumeration Type Documentation

FlutterDesktopGpuPreference

enum FlutterDesktopGpuPreference

Enumerator
NoPreference
LowPowerPreference

Definition at line 39 of file flutter_windows.h.

             {
  // No preference.
  NoPreference,
  // Prefer energy efficiency over performance, such as an integrated GPU.
  // This falls back to a high performance GPU if no low power GPU is
  // available.
  LowPowerPreference,
} FlutterDesktopGpuPreference;

FlutterDesktopUIThreadPolicy

enum FlutterDesktopUIThreadPolicy

Enumerator
Default
RunOnPlatformThread
RunOnSeparateThread

Definition at line 49 of file flutter_windows.h.

             {
  // Default value. Currently will run the UI isolate on separate thread,
  // later will be changed to running the UI isolate on platform thread.
  Default,
  // Run the UI isolate on platform thread.
  RunOnPlatformThread,
  // Run the UI isolate on a separate thread.
  RunOnSeparateThread,
} FlutterDesktopUIThreadPolicy;

Function Documentation

FlutterDesktopEngineCreate()

FLUTTER_EXPORT FlutterDesktopEngineRef FlutterDesktopEngineCreate

(

const FlutterDesktopEngineProperties *

engine_properties

)

Definition at line 183 of file flutter_windows.cc.

                                                             {
  flutter::FlutterProjectBundle project(*engine_properties);
  auto engine = std::make_unique<flutter::FlutterWindowsEngine>(project);
  return HandleForEngine(engine.release());
}

References HandleForEngine().

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

FlutterDesktopEngineDestroy()

FLUTTER_EXPORT bool FlutterDesktopEngineDestroy

(

FlutterDesktopEngineRef

engine

)

Definition at line 190 of file flutter_windows.cc.

                                                                     {
  flutter::FlutterWindowsEngine* engine = EngineFromHandle(engine_ref);
  bool result = true;
  if (engine->running()) {
    result = engine->Stop();
  }
  delete engine;
  return result;
}

References EngineFromHandle(), flutter::FlutterWindowsEngine::running(), and flutter::FlutterWindowsEngine::Stop().

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

FlutterDesktopEngineGetMessenger()

FLUTTER_EXPORT FlutterDesktopMessengerRef FlutterDesktopEngineGetMessenger

(

FlutterDesktopEngineRef

engine

)

Definition at line 234 of file flutter_windows.cc.

                                    {
  return EngineFromHandle(engine)->messenger();
}

References EngineFromHandle(), and flutter::FlutterWindowsEngine::messenger().

Referenced by flutter::FlutterEngine::FlutterEngine().

FlutterDesktopEngineGetPluginRegistrar()

FLUTTER_EXPORT FlutterDesktopPluginRegistrarRef FlutterDesktopEngineGetPluginRegistrar	(	FlutterDesktopEngineRef	engine,
		const char *	plugin_name
	)

Definition at line 224 of file flutter_windows.cc.

                             {
  // Currently, one registrar acts as the registrar for all plugins, so the
  // name is ignored. It is part of the API to reduce churn in the future when
  // aligning more closely with the Flutter registrar system.
 
  return EngineFromHandle(engine)->GetRegistrar();
}

References EngineFromHandle(), and flutter::FlutterWindowsEngine::GetRegistrar().

Referenced by flutter::FlutterEngine::GetRegistrarForPlugin(), and flutter::testing::TEST_F().

FlutterDesktopEngineGetTextureRegistrar()

FLUTTER_EXPORT FlutterDesktopTextureRegistrarRef FlutterDesktopEngineGetTextureRegistrar

(

FlutterDesktopEngineRef

engine

)

Definition at line 239 of file flutter_windows.cc.

                                    {
  return HandleForTextureRegistrar(
      EngineFromHandle(engine)->texture_registrar());
}

References EngineFromHandle(), and HandleForTextureRegistrar().

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

FlutterDesktopEngineProcessExternalWindowMessage()

FLUTTER_EXPORT bool FlutterDesktopEngineProcessExternalWindowMessage	(	FlutterDesktopEngineRef	engine,
		HWND	hwnd,
		UINT	message,
		WPARAM	wparam,
		LPARAM	lparam,
		LRESULT *	result
	)

Definition at line 272 of file flutter_windows.cc.

                     {
  std::optional<LRESULT> lresult =
      EngineFromHandle(engine)->ProcessExternalWindowMessage(hwnd, message,
                                                             wparam, lparam);
  if (result && lresult.has_value()) {
    *result = lresult.value();
  }
  return lresult.has_value();
}

References EngineFromHandle(), message, and flutter::FlutterWindowsEngine::ProcessExternalWindowMessage().

Referenced by flutter::FlutterEngine::ProcessExternalWindowMessage().

FlutterDesktopEngineProcessMessages()

FLUTTER_EXPORT uint64_t FlutterDesktopEngineProcessMessages

(

FlutterDesktopEngineRef

engine

)

Definition at line 216 of file flutter_windows.cc.

                                                                             {
  return std::chrono::nanoseconds::max().count();
}

Referenced by flutter::FlutterEngine::ProcessMessages().

FlutterDesktopEngineReloadSystemFonts()

FLUTTER_EXPORT void FlutterDesktopEngineReloadSystemFonts

(

FlutterDesktopEngineRef

engine

)

Definition at line 220 of file flutter_windows.cc.

                                                                           {
  EngineFromHandle(engine)->ReloadSystemFonts();
}

References EngineFromHandle(), and flutter::FlutterWindowsEngine::ReloadSystemFonts().

Referenced by flutter::FlutterEngine::ReloadSystemFonts().

FlutterDesktopEngineRun()

FLUTTER_EXPORT bool FlutterDesktopEngineRun	(	FlutterDesktopEngineRef	engine,
		const char *	entry_point
	)

Definition at line 206 of file flutter_windows.cc.

                                                      {
  std::string_view entry_point_view{""};
  if (entry_point != nullptr) {
    entry_point_view = entry_point;
  }
 
  return EngineFromHandle(engine)->Run(entry_point_view);
}

References EngineFromHandle(), and flutter::FlutterWindowsEngine::Run().

Referenced by flutter::FlutterEngine::Run(), and flutter::testing::TEST_F().

FlutterDesktopEngineSetNextFrameCallback()

FLUTTER_EXPORT void FlutterDesktopEngineSetNextFrameCallback	(	FlutterDesktopEngineRef	engine,
		VoidCallback	callback,
		void *	user_data
	)

Definition at line 245 of file flutter_windows.cc.

                                                               {
  EngineFromHandle(engine)->SetNextFrameCallback(
      [callback, user_data]() { callback(user_data); });
}

References callback, EngineFromHandle(), flutter::FlutterWindowsEngine::SetNextFrameCallback(), and user_data.

Referenced by flutter::FlutterEngine::SetNextFrameCallback(), and flutter::testing::TEST_F().

FlutterDesktopGetDpiForHWND()

FLUTTER_EXPORT UINT FlutterDesktopGetDpiForHWND

(

HWND

hwnd

)

Definition at line 322 of file flutter_windows.cc.

                                            {
  return flutter::GetDpiForHWND(hwnd);
}

References flutter::GetDpiForHWND().

Referenced by InternalFlutterWindows_WindowManager_GetWindowContentSize().

FlutterDesktopGetDpiForMonitor()

FLUTTER_EXPORT UINT FlutterDesktopGetDpiForMonitor

(

HMONITOR

monitor

)

Definition at line 326 of file flutter_windows.cc.

                                                      {
  return flutter::GetDpiForMonitor(monitor);
}

References flutter::GetDpiForMonitor().

FlutterDesktopPluginRegistrarGetView()

FLUTTER_EXPORT FlutterDesktopViewRef FlutterDesktopPluginRegistrarGetView

(

FlutterDesktopPluginRegistrarRef

registrar

)

Definition at line 296 of file flutter_windows.cc.

                                                {
  return HandleForView(registrar->engine->view(flutter::kImplicitViewId));
}

References FlutterDesktopPluginRegistrar::engine, HandleForView(), flutter::kImplicitViewId, and flutter::FlutterWindowsEngine::view().

Referenced by flutter::PluginRegistrarWindows::PluginRegistrarWindows(), and flutter::testing::TEST_F().

FlutterDesktopPluginRegistrarGetViewById()

FLUTTER_EXPORT FlutterDesktopViewRef FlutterDesktopPluginRegistrarGetViewById	(	FlutterDesktopPluginRegistrarRef	registrar,
		FlutterDesktopViewId	view_id
	)

Definition at line 301 of file flutter_windows.cc.

                                  {
  return HandleForView(registrar->engine->view(view_id));
}

References FlutterDesktopPluginRegistrar::engine, HandleForView(), and flutter::FlutterWindowsEngine::view().

Referenced by flutter::PluginRegistrarWindows::GetViewById(), and flutter::testing::TEST_F().

FlutterDesktopPluginRegistrarRegisterTopLevelWindowProcDelegate()

FLUTTER_EXPORT void FlutterDesktopPluginRegistrarRegisterTopLevelWindowProcDelegate	(	FlutterDesktopPluginRegistrarRef	registrar,
		FlutterDesktopWindowProcCallback	delegate,
		void *	user_data
	)

Definition at line 307 of file flutter_windows.cc.

                     {
  registrar->engine->window_proc_delegate_manager()
      ->RegisterTopLevelWindowProcDelegate(delegate, user_data);
}

References FlutterDesktopPluginRegistrar::engine, flutter::WindowProcDelegateManager::RegisterTopLevelWindowProcDelegate(), user_data, and flutter::FlutterWindowsEngine::window_proc_delegate_manager().

Referenced by flutter::PluginRegistrarWindows::RegisterTopLevelWindowProcDelegate().

FlutterDesktopPluginRegistrarUnregisterTopLevelWindowProcDelegate()

FLUTTER_EXPORT void FlutterDesktopPluginRegistrarUnregisterTopLevelWindowProcDelegate	(	FlutterDesktopPluginRegistrarRef	registrar,
		FlutterDesktopWindowProcCallback	delegate
	)

Definition at line 315 of file flutter_windows.cc.

                                               {
  registrar->engine->window_proc_delegate_manager()
      ->UnregisterTopLevelWindowProcDelegate(delegate);
}

References FlutterDesktopPluginRegistrar::engine, flutter::WindowProcDelegateManager::UnregisterTopLevelWindowProcDelegate(), and flutter::FlutterWindowsEngine::window_proc_delegate_manager().

Referenced by flutter::PluginRegistrarWindows::UnregisterTopLevelWindowProcDelegate().

FlutterDesktopResyncOutputStreams()

FLUTTER_EXPORT void FlutterDesktopResyncOutputStreams

(

)

Definition at line 330 of file flutter_windows.cc.

                                         {
  FILE* unused;
  if (freopen_s(&unused, "CONOUT$", "w", stdout)) {
    _dup2(_fileno(stdout), 1);
  }
  if (freopen_s(&unused, "CONOUT$", "w", stderr)) {
    _dup2(_fileno(stdout), 2);
  }
  std::ios::sync_with_stdio();
}

FlutterDesktopViewControllerCreate()

FLUTTER_EXPORT FlutterDesktopViewControllerRef FlutterDesktopViewControllerCreate	(	int	width,
		int	height,
		FlutterDesktopEngineRef	engine
	)

Definition at line 121 of file flutter_windows.cc.

                                    {
  return CreateViewController(engine, width, height, /*owns_engine=*/true);
}

References CreateViewController().

Referenced by flutter::FlutterViewController::FlutterViewController(), and flutter::testing::TEST_F().

FlutterDesktopViewControllerDestroy()

FLUTTER_EXPORT void FlutterDesktopViewControllerDestroy

(

FlutterDesktopViewControllerRef

controller

)

Definition at line 135 of file flutter_windows.cc.

                                                                              {
  auto controller = ViewControllerFromHandle(ref);
  controller->Destroy();
  delete controller;
}

References ViewControllerFromHandle().

Referenced by flutter::FlutterViewController::~FlutterViewController().

FlutterDesktopViewControllerForceRedraw()

FLUTTER_EXPORT void FlutterDesktopViewControllerForceRedraw

(

FlutterDesktopViewControllerRef

controller

)

Definition at line 159 of file flutter_windows.cc.

                                         {
  auto controller = ViewControllerFromHandle(ref);
  controller->view()->ForceRedraw();
}

References ViewControllerFromHandle().

Referenced by flutter::FlutterViewController::ForceRedraw().

FlutterDesktopViewControllerGetEngine()

FLUTTER_EXPORT FlutterDesktopEngineRef FlutterDesktopViewControllerGetEngine

(

FlutterDesktopViewControllerRef

controller

)

Definition at line 147 of file flutter_windows.cc.

                                         {
  auto controller = ViewControllerFromHandle(ref);
  return HandleForEngine(controller->engine());
}

References HandleForEngine(), and ViewControllerFromHandle().

Referenced by flutter::testing::TEST_F().

FlutterDesktopViewControllerGetView()

FLUTTER_EXPORT FlutterDesktopViewRef FlutterDesktopViewControllerGetView

(

FlutterDesktopViewControllerRef

controller

)

Definition at line 153 of file flutter_windows.cc.

                                         {
  auto controller = ViewControllerFromHandle(ref);
  return HandleForView(controller->view());
}

References HandleForView(), and ViewControllerFromHandle().

Referenced by flutter::FlutterViewController::FlutterViewController(), and flutter::testing::TEST_F().

FlutterDesktopViewControllerGetViewId()

FLUTTER_EXPORT FlutterDesktopViewId FlutterDesktopViewControllerGetViewId

(

FlutterDesktopViewControllerRef

view_controller

)

Definition at line 141 of file flutter_windows.cc.

                                         {
  auto controller = ViewControllerFromHandle(ref);
  return static_cast<FlutterDesktopViewId>(controller->view()->view_id());
}

References ViewControllerFromHandle().

Referenced by flutter::testing::TEST_F(), and flutter::FlutterViewController::view_id().

FlutterDesktopViewControllerHandleTopLevelWindowProc()

FLUTTER_EXPORT bool FlutterDesktopViewControllerHandleTopLevelWindowProc	(	FlutterDesktopViewControllerRef	controller,
		HWND	hwnd,
		UINT	message,
		WPARAM	wparam,
		LPARAM	lparam,
		LRESULT *	result
	)

Definition at line 165 of file flutter_windows.cc.

                     {
  auto controller = ViewControllerFromHandle(ref);
  std::optional<LRESULT> delegate_result =
      controller->engine()
          ->window_proc_delegate_manager()
          ->OnTopLevelWindowProc(hwnd, message, wparam, lparam);
  if (delegate_result) {
    *result = *delegate_result;
  }
  return delegate_result.has_value();
}

References message, and ViewControllerFromHandle().

Referenced by flutter::FlutterViewController::HandleTopLevelWindowProc().

FlutterDesktopViewGetGraphicsAdapter()

FLUTTER_EXPORT IDXGIAdapter* FlutterDesktopViewGetGraphicsAdapter

(

FlutterDesktopViewRef

view

)

Definition at line 256 of file flutter_windows.cc.

                                                                               {
  auto egl_manager = ViewFromHandle(view)->GetEngine()->egl_manager();
  if (egl_manager) {
    Microsoft::WRL::ComPtr<ID3D11Device> d3d_device;
    Microsoft::WRL::ComPtr<IDXGIDevice> dxgi_device;
    if (egl_manager->GetDevice(d3d_device.GetAddressOf()) &&
        SUCCEEDED(d3d_device.As(&dxgi_device))) {
      IDXGIAdapter* adapter;
      if (SUCCEEDED(dxgi_device->GetAdapter(&adapter))) {
        return adapter;
      }
    }
  }
  return nullptr;
}

References flutter::FlutterWindowsEngine::egl_manager(), flutter::FlutterWindowsView::GetEngine(), and ViewFromHandle().

Referenced by flutter::FlutterView::GetGraphicsAdapter(), and flutter::testing::TEST_F().

FlutterDesktopViewGetHWND()

FLUTTER_EXPORT HWND FlutterDesktopViewGetHWND

(

FlutterDesktopViewRef

view

)

Definition at line 252 of file flutter_windows.cc.

                                                           {
  return ViewFromHandle(view)->GetWindowHandle();
}

References flutter::FlutterWindowsView::GetWindowHandle(), and ViewFromHandle().

Referenced by flutter::FlutterView::GetNativeWindow(), and flutter::testing::TEST_F().