mirror of
https://bitbucket.org/chromiumembedded/cef
synced 2025-01-28 18:19:56 +01:00
260dd0ca24
Adds support for the OnAcceleratedPaint callback. Verified to work on macOS and Windows. Linux support is present but not implemented for cefclient, so it is not verified to work. To test: Run `cefclient --off-screen-rendering-enabled --shared-texture-enabled`
272 lines
12 KiB
C
272 lines
12 KiB
C
// Copyright (c) 2024 Marshall A. Greenblatt. All rights reserved.
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without
|
|
// modification, are permitted provided that the following conditions are
|
|
// met:
|
|
//
|
|
// * Redistributions of source code must retain the above copyright
|
|
// notice, this list of conditions and the following disclaimer.
|
|
// * Redistributions in binary form must reproduce the above
|
|
// copyright notice, this list of conditions and the following disclaimer
|
|
// in the documentation and/or other materials provided with the
|
|
// distribution.
|
|
// * Neither the name of Google Inc. nor the name Chromium Embedded
|
|
// Framework nor the names of its contributors may be used to endorse
|
|
// or promote products derived from this software without specific prior
|
|
// written permission.
|
|
//
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
//
|
|
// ---------------------------------------------------------------------------
|
|
//
|
|
// This file was generated by the CEF translator tool and should not edited
|
|
// by hand. See the translator.README.txt file in the tools directory for
|
|
// more information.
|
|
//
|
|
// $hash=5151b6ea3c06e46a75f2cd7679044a2891063d29$
|
|
//
|
|
|
|
#ifndef CEF_INCLUDE_CAPI_CEF_RENDER_HANDLER_CAPI_H_
|
|
#define CEF_INCLUDE_CAPI_CEF_RENDER_HANDLER_CAPI_H_
|
|
#pragma once
|
|
|
|
#include "include/capi/cef_accessibility_handler_capi.h"
|
|
#include "include/capi/cef_base_capi.h"
|
|
#include "include/capi/cef_browser_capi.h"
|
|
#include "include/capi/cef_drag_data_capi.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
///
|
|
/// Implement this structure to handle events when window rendering is disabled.
|
|
/// The functions of this structure will be called on the UI thread.
|
|
///
|
|
typedef struct _cef_render_handler_t {
|
|
///
|
|
/// Base structure.
|
|
///
|
|
cef_base_ref_counted_t base;
|
|
|
|
///
|
|
/// Return the handler for accessibility notifications. If no handler is
|
|
/// provided the default implementation will be used.
|
|
///
|
|
struct _cef_accessibility_handler_t*(CEF_CALLBACK* get_accessibility_handler)(
|
|
struct _cef_render_handler_t* self);
|
|
|
|
///
|
|
/// Called to retrieve the root window rectangle in screen DIP coordinates.
|
|
/// Return true (1) if the rectangle was provided. If this function returns
|
|
/// false (0) the rectangle from GetViewRect will be used.
|
|
///
|
|
int(CEF_CALLBACK* get_root_screen_rect)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_rect_t* rect);
|
|
|
|
///
|
|
/// Called to retrieve the view rectangle in screen DIP coordinates. This
|
|
/// function must always provide a non-NULL rectangle.
|
|
///
|
|
void(CEF_CALLBACK* get_view_rect)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_rect_t* rect);
|
|
|
|
///
|
|
/// Called to retrieve the translation from view DIP coordinates to screen
|
|
/// coordinates. Windows/Linux should provide screen device (pixel)
|
|
/// coordinates and MacOS should provide screen DIP coordinates. Return true
|
|
/// (1) if the requested coordinates were provided.
|
|
///
|
|
int(CEF_CALLBACK* get_screen_point)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
int viewX,
|
|
int viewY,
|
|
int* screenX,
|
|
int* screenY);
|
|
|
|
///
|
|
/// Called to allow the client to fill in the CefScreenInfo object with
|
|
/// appropriate values. Return true (1) if the |screen_info| structure has
|
|
/// been modified.
|
|
///
|
|
/// If the screen info rectangle is left NULL the rectangle from GetViewRect
|
|
/// will be used. If the rectangle is still NULL or invalid popups may not be
|
|
/// drawn correctly.
|
|
///
|
|
int(CEF_CALLBACK* get_screen_info)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_screen_info_t* screen_info);
|
|
|
|
///
|
|
/// Called when the browser wants to show or hide the popup widget. The popup
|
|
/// should be shown if |show| is true (1) and hidden if |show| is false (0).
|
|
///
|
|
void(CEF_CALLBACK* on_popup_show)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
int show);
|
|
|
|
///
|
|
/// Called when the browser wants to move or resize the popup widget. |rect|
|
|
/// contains the new location and size in view coordinates.
|
|
///
|
|
void(CEF_CALLBACK* on_popup_size)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
const cef_rect_t* rect);
|
|
|
|
///
|
|
/// Called when an element should be painted. Pixel values passed to this
|
|
/// function are scaled relative to view coordinates based on the value of
|
|
/// CefScreenInfo.device_scale_factor returned from GetScreenInfo. |type|
|
|
/// indicates whether the element is the view or the popup widget. |buffer|
|
|
/// contains the pixel data for the whole image. |dirtyRects| contains the set
|
|
/// of rectangles in pixel coordinates that need to be repainted. |buffer|
|
|
/// will be |width|*|height|*4 bytes in size and represents a BGRA image with
|
|
/// an upper-left origin. This function is only called when
|
|
/// cef_window_tInfo::shared_texture_enabled is set to false (0).
|
|
///
|
|
void(CEF_CALLBACK* on_paint)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_paint_element_type_t type,
|
|
size_t dirtyRectsCount,
|
|
cef_rect_t const* dirtyRects,
|
|
const void* buffer,
|
|
int width,
|
|
int height);
|
|
|
|
///
|
|
/// Called when an element has been rendered to the shared texture handle.
|
|
/// |type| indicates whether the element is the view or the popup widget.
|
|
/// |dirtyRects| contains the set of rectangles in pixel coordinates that need
|
|
/// to be repainted. |info| contains the shared handle; on Windows it is a
|
|
/// HANDLE to a texture that can be opened with D3D11 OpenSharedResource, on
|
|
/// macOS it is an IOSurface pointer that can be opened with Metal or OpenGL,
|
|
/// and on Linux it contains several planes, each with an fd to the underlying
|
|
/// system native buffer.
|
|
///
|
|
/// The underlying implementation uses a pool to deliver frames. As a result,
|
|
/// the handle may differ every frame depending on how many frames are in-
|
|
/// progress. The handle's resource cannot be cached and cannot be accessed
|
|
/// outside of this callback. It should be reopened each time this callback is
|
|
/// executed and the contents should be copied to a texture owned by the
|
|
/// client application. The contents of |info| will be released back to the
|
|
/// pool after this callback returns.
|
|
///
|
|
void(CEF_CALLBACK* on_accelerated_paint)(
|
|
struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_paint_element_type_t type,
|
|
size_t dirtyRectsCount,
|
|
cef_rect_t const* dirtyRects,
|
|
const cef_accelerated_paint_info_t* info);
|
|
|
|
///
|
|
/// Called to retrieve the size of the touch handle for the specified
|
|
/// |orientation|.
|
|
///
|
|
void(CEF_CALLBACK* get_touch_handle_size)(
|
|
struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_horizontal_alignment_t orientation,
|
|
cef_size_t* size);
|
|
|
|
///
|
|
/// Called when touch handle state is updated. The client is responsible for
|
|
/// rendering the touch handles.
|
|
///
|
|
void(CEF_CALLBACK* on_touch_handle_state_changed)(
|
|
struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
const cef_touch_handle_state_t* state);
|
|
|
|
///
|
|
/// Called when the user starts dragging content in the web view. Contextual
|
|
/// information about the dragged content is supplied by |drag_data|. (|x|,
|
|
/// |y|) is the drag start location in screen coordinates. OS APIs that run a
|
|
/// system message loop may be used within the StartDragging call.
|
|
///
|
|
/// Return false (0) to abort the drag operation. Don't call any of
|
|
/// cef_browser_host_t::DragSource*Ended* functions after returning false (0).
|
|
///
|
|
/// Return true (1) to handle the drag operation. Call
|
|
/// cef_browser_host_t::DragSourceEndedAt and DragSourceSystemDragEnded either
|
|
/// synchronously or asynchronously to inform the web view that the drag
|
|
/// operation has ended.
|
|
///
|
|
int(CEF_CALLBACK* start_dragging)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
struct _cef_drag_data_t* drag_data,
|
|
cef_drag_operations_mask_t allowed_ops,
|
|
int x,
|
|
int y);
|
|
|
|
///
|
|
/// Called when the web view wants to update the mouse cursor during a drag &
|
|
/// drop operation. |operation| describes the allowed operation (none, move,
|
|
/// copy, link).
|
|
///
|
|
void(CEF_CALLBACK* update_drag_cursor)(struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_drag_operations_mask_t operation);
|
|
|
|
///
|
|
/// Called when the scroll offset has changed.
|
|
///
|
|
void(CEF_CALLBACK* on_scroll_offset_changed)(
|
|
struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
double x,
|
|
double y);
|
|
|
|
///
|
|
/// Called when the IME composition range has changed. |selected_range| is the
|
|
/// range of characters that have been selected. |character_bounds| is the
|
|
/// bounds of each character in view coordinates.
|
|
///
|
|
void(CEF_CALLBACK* on_ime_composition_range_changed)(
|
|
struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
const cef_range_t* selected_range,
|
|
size_t character_boundsCount,
|
|
cef_rect_t const* character_bounds);
|
|
|
|
///
|
|
/// Called when text selection has changed for the specified |browser|.
|
|
/// |selected_text| is the currently selected text and |selected_range| is the
|
|
/// character range.
|
|
///
|
|
void(CEF_CALLBACK* on_text_selection_changed)(
|
|
struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
const cef_string_t* selected_text,
|
|
const cef_range_t* selected_range);
|
|
|
|
///
|
|
/// Called when an on-screen keyboard should be shown or hidden for the
|
|
/// specified |browser|. |input_mode| specifies what kind of keyboard should
|
|
/// be opened. If |input_mode| is CEF_TEXT_INPUT_MODE_NONE, any existing
|
|
/// keyboard for this browser should be hidden.
|
|
///
|
|
void(CEF_CALLBACK* on_virtual_keyboard_requested)(
|
|
struct _cef_render_handler_t* self,
|
|
struct _cef_browser_t* browser,
|
|
cef_text_input_mode_t input_mode);
|
|
} cef_render_handler_t;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // CEF_INCLUDE_CAPI_CEF_RENDER_HANDLER_CAPI_H_
|