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.
113 lines
4.4 KiB
Python
113 lines
4.4 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
|
|
|
|
from pywayland.protocol_core import Global, Interface, Proxy, Resource
|
|
|
|
|
|
class WlBuffer(Interface):
|
|
"""Content for a :class:`~pywayland.protocol.wayland.WlSurface`
|
|
|
|
A buffer provides the content for a
|
|
:class:`~pywayland.protocol.wayland.WlSurface`. Buffers are created through
|
|
factory interfaces such as :class:`~pywayland.protocol.wayland.WlShm`,
|
|
wp_linux_buffer_params (from the linux-dmabuf protocol extension) or
|
|
similar. It has a width and a height and can be attached to a
|
|
:class:`~pywayland.protocol.wayland.WlSurface`, but the mechanism by which
|
|
a client provides and updates the contents is defined by the buffer factory
|
|
interface.
|
|
|
|
Color channels are assumed to be electrical rather than optical (in other
|
|
words, encoded with a transfer function) unless otherwise specified. If the
|
|
buffer uses a format that has an alpha channel, the alpha channel is
|
|
assumed to be premultiplied into the electrical color channel values (after
|
|
transfer function encoding) unless otherwise specified.
|
|
|
|
Note, because :class:`WlBuffer` objects are created from multiple
|
|
independent factory interfaces, the :class:`WlBuffer` interface is frozen
|
|
at version 1.
|
|
"""
|
|
|
|
name = "wl_buffer"
|
|
version = 1
|
|
|
|
|
|
class WlBufferProxy(Proxy[WlBuffer]):
|
|
interface = WlBuffer
|
|
|
|
@WlBuffer.request()
|
|
def destroy(self) -> None:
|
|
"""Destroy a buffer
|
|
|
|
Destroy a buffer. If and how you need to release the backing storage is
|
|
defined by the buffer factory interface.
|
|
|
|
For possible side-effects to a surface, see :func:`WlSurface.attach()
|
|
<pywayland.protocol.wayland.WlSurface.attach>`.
|
|
"""
|
|
self._marshal(0)
|
|
self._destroy()
|
|
|
|
|
|
class WlBufferResource(Resource):
|
|
interface = WlBuffer
|
|
|
|
@WlBuffer.event()
|
|
def release(self) -> None:
|
|
"""Compositor releases buffer
|
|
|
|
Sent when this :class:`WlBuffer` is no longer used by the compositor.
|
|
|
|
For more information on when release events may or may not be sent, and
|
|
what consequences it has, please see the description of
|
|
:func:`WlSurface.attach()
|
|
<pywayland.protocol.wayland.WlSurface.attach>`.
|
|
|
|
If a client receives a release event before the frame callback
|
|
requested in the same :func:`WlSurface.commit()
|
|
<pywayland.protocol.wayland.WlSurface.commit>` that attaches this
|
|
:class:`WlBuffer` to a surface, then the client is immediately free to
|
|
reuse the buffer and its backing storage, and does not need a second
|
|
buffer for the next surface content update. Typically this is possible,
|
|
when the compositor maintains a copy of the
|
|
:class:`~pywayland.protocol.wayland.WlSurface` contents, e.g. as a GL
|
|
texture. This is an important optimization for GL(ES) compositors with
|
|
:class:`~pywayland.protocol.wayland.WlShm` clients.
|
|
"""
|
|
self._post_event(0)
|
|
|
|
|
|
class WlBufferGlobal(Global):
|
|
interface = WlBuffer
|
|
|
|
|
|
WlBuffer._gen_c()
|
|
WlBuffer.proxy_class = WlBufferProxy
|
|
WlBuffer.resource_class = WlBufferResource
|
|
WlBuffer.global_class = WlBufferGlobal
|