The question is which capture route to ship for live streaming and agent eyes. Speed alone does not decide it, so every route now also reports producer CPU and RSS, machine CPU from /proc/stat, the compositor's own CPU, and a per-frame buffer footprint -- all sampled around the measured loop, with an idle control sample so an animating page's cost is not attributed to the capture. The baseline forks a process per frame and spends 95% of each frame waiting, so the interesting finding is not which route is faster but which one leaves the compositor able to do its job: in-process acquisition roughly halves the compositor's per-frame CPU even though the machine saturates either way.
151 lines
5.6 KiB
Python
151 lines
5.6 KiB
Python
# This file has been autogenerated by the pywayland scanner
|
|
|
|
# Copyright © 2008-2011 Kristian Høgsberg
|
|
# Copyright © 2010-2011 Intel Corporation
|
|
# Copyright © 2012-2013 Collabora, Ltd.
|
|
#
|
|
# Permission is hereby granted, free of charge, to any person
|
|
# obtaining a copy of this software and associated documentation files
|
|
# (the "Software"), to deal in the Software without restriction,
|
|
# including without limitation the rights to use, copy, modify, merge,
|
|
# publish, distribute, sublicense, and/or sell copies of the Software,
|
|
# and to permit persons to whom the Software is furnished to do so,
|
|
# subject to the following conditions:
|
|
#
|
|
# The above copyright notice and this permission notice (including the
|
|
# next paragraph) shall be included in all copies or substantial
|
|
# portions of the Software.
|
|
#
|
|
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
# SOFTWARE.
|
|
|
|
from __future__ import annotations
|
|
|
|
import enum
|
|
|
|
from pywayland.protocol_core import (
|
|
Argument,
|
|
ArgumentType,
|
|
Global,
|
|
Interface,
|
|
Proxy,
|
|
Resource,
|
|
)
|
|
|
|
from .wl_subsurface import WlSubsurface
|
|
from .wl_surface import WlSurface
|
|
|
|
|
|
class WlSubcompositor(Interface):
|
|
"""Sub-surface compositing
|
|
|
|
The global interface exposing sub-surface compositing capabilities. A
|
|
:class:`~pywayland.protocol.wayland.WlSurface`, that has sub-surfaces
|
|
associated, is called the parent surface. Sub-surfaces can be arbitrarily
|
|
nested and create a tree of sub-surfaces.
|
|
|
|
The root surface in a tree of sub-surfaces is the main surface. The main
|
|
surface cannot be a sub-surface, because sub-surfaces must always have a
|
|
parent.
|
|
|
|
A main surface with its sub-surfaces forms a (compound) window. For window
|
|
management purposes, this set of
|
|
:class:`~pywayland.protocol.wayland.WlSurface` objects is to be considered
|
|
as a single window, and it should also behave as such.
|
|
|
|
The aim of sub-surfaces is to offload some of the compositing work within a
|
|
window from clients to the compositor. A prime example is a video player
|
|
with decorations and video in separate
|
|
:class:`~pywayland.protocol.wayland.WlSurface` objects. This should allow
|
|
the compositor to pass YUV video buffer processing to dedicated overlay
|
|
hardware when possible.
|
|
"""
|
|
|
|
name = "wl_subcompositor"
|
|
version = 1
|
|
|
|
class error(enum.IntEnum):
|
|
bad_surface = 0
|
|
bad_parent = 1
|
|
|
|
|
|
class WlSubcompositorProxy(Proxy[WlSubcompositor]):
|
|
interface = WlSubcompositor
|
|
|
|
@WlSubcompositor.request()
|
|
def destroy(self) -> None:
|
|
"""Unbind from the subcompositor interface
|
|
|
|
Informs the server that the client will not be using this protocol
|
|
object anymore. This does not affect any other objects,
|
|
:class:`~pywayland.protocol.wayland.WlSubsurface` objects included.
|
|
"""
|
|
self._marshal(0)
|
|
self._destroy()
|
|
|
|
@WlSubcompositor.request(
|
|
Argument(ArgumentType.NewId, interface=WlSubsurface),
|
|
Argument(ArgumentType.Object, interface=WlSurface),
|
|
Argument(ArgumentType.Object, interface=WlSurface),
|
|
)
|
|
def get_subsurface(self, surface: WlSurface, parent: WlSurface) -> Proxy[WlSubsurface]:
|
|
"""Give a surface the role sub-surface
|
|
|
|
Create a sub-surface interface for the given surface, and associate it
|
|
with the given parent surface. This turns a plain
|
|
:class:`~pywayland.protocol.wayland.WlSurface` into a sub-surface.
|
|
|
|
The to-be sub-surface must not already have another role, and it must
|
|
not have an existing :class:`~pywayland.protocol.wayland.WlSubsurface`
|
|
object. Otherwise the bad_surface protocol error is raised.
|
|
|
|
Adding sub-surfaces to a parent is a double-buffered operation on the
|
|
parent (see :func:`WlSurface.commit()
|
|
<pywayland.protocol.wayland.WlSurface.commit>`). The effect of adding a
|
|
sub-surface becomes visible on the next time the state of the parent
|
|
surface is applied.
|
|
|
|
The parent surface must not be one of the child surface's descendants,
|
|
and the parent must be different from the child surface, otherwise the
|
|
bad_parent protocol error is raised.
|
|
|
|
This request modifies the behaviour of :func:`WlSurface.commit()
|
|
<pywayland.protocol.wayland.WlSurface.commit>` request on the sub-
|
|
surface, see the documentation on
|
|
:class:`~pywayland.protocol.wayland.WlSubsurface` interface.
|
|
|
|
:param surface:
|
|
the surface to be turned into a sub-surface
|
|
:type surface:
|
|
:class:`~pywayland.protocol.wayland.WlSurface`
|
|
:param parent:
|
|
the parent surface
|
|
:type parent:
|
|
:class:`~pywayland.protocol.wayland.WlSurface`
|
|
:returns:
|
|
:class:`~pywayland.protocol.wayland.WlSubsurface` -- the new sub-
|
|
surface object ID
|
|
"""
|
|
id = self._marshal_constructor(1, WlSubsurface, surface, parent)
|
|
return id
|
|
|
|
|
|
class WlSubcompositorResource(Resource):
|
|
interface = WlSubcompositor
|
|
|
|
|
|
class WlSubcompositorGlobal(Global):
|
|
interface = WlSubcompositor
|
|
|
|
|
|
WlSubcompositor._gen_c()
|
|
WlSubcompositor.proxy_class = WlSubcompositorProxy
|
|
WlSubcompositor.resource_class = WlSubcompositorResource
|
|
WlSubcompositor.global_class = WlSubcompositorGlobal
|