mirror of
https://github.com/obsproject/obs-studio.git
synced 2024-09-20 13:08:50 +02:00
c2f8b2058b
Add a new Linux capture based on PipeWire [1] and the Desktop portal [2].
This new capture starts by asking the Desktop portal for a screencapture session.
There are quite a few D-Bus calls involved in this, but the key points are:
1. A connection to org.freedesktop.portal.ScreenCast is estabilished, and the
available cursor modes are updated.
2. CreateSession() is called. This is the first step of the negotiation.
3. SelectSources() is called. This is when a system dialog pops up asking the
user to either select a monitor (desktop capture) or a window (window capture).
4. Start() is called. This signals the compositor that it can setup a PipeWire
stream, and start sending buffers.
The reply to this fourth call gives OBS Studio the PipeWire fd, and the id of the
PipeWire node where the buffers are being sent to. This allows creating a consumer
PipeWire stream, and receive the buffers.
Metadata cursor is always preferred, but on the lack of it, we ask the stream for
an embedded cursor (i.e. the cursor is drawn at the buffer, and OBS Studio has no
control over it.)
Window capturing is implemented as a crop operation on the buffer. Compositors
can send big buffers, and a crop rectangle, and this is used to paint a subregion
of the buffer in the scene.
The new capture is only loaded when running on EGL, since it depends on EGL to
call gs_texture_create_from_dmabuf().
[1] https://pipewire.org/
[2] https://github.com/flatpak/xdg-desktop-portal/
54 lines
1.8 KiB
C
54 lines
1.8 KiB
C
/* pipewire.h
|
|
*
|
|
* Copyright 2020 Georges Basile Stavracas Neto <georges.stavracas@gmail.com>
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <obs-module.h>
|
|
#include <pipewire/pipewire.h>
|
|
|
|
typedef struct _obs_pipewire_data obs_pipewire_data;
|
|
|
|
enum obs_pw_capture_type {
|
|
DESKTOP_CAPTURE = 1,
|
|
WINDOW_CAPTURE = 2,
|
|
};
|
|
|
|
void *obs_pipewire_create(enum obs_pw_capture_type capture_type,
|
|
obs_data_t *settings, obs_source_t *source);
|
|
|
|
void obs_pipewire_destroy(obs_pipewire_data *obs_pw);
|
|
|
|
void obs_pipewire_get_defaults(obs_data_t *settings);
|
|
|
|
obs_properties_t *obs_pipewire_get_properties(obs_pipewire_data *obs_pw,
|
|
const char *reload_string_id);
|
|
|
|
void obs_pipewire_update(obs_pipewire_data *obs_pw, obs_data_t *settings);
|
|
|
|
void obs_pipewire_show(obs_pipewire_data *obs_pw);
|
|
|
|
void obs_pipewire_hide(obs_pipewire_data *obs_pw);
|
|
uint32_t obs_pipewire_get_width(obs_pipewire_data *obs_pw);
|
|
uint32_t obs_pipewire_get_height(obs_pipewire_data *obs_pw);
|
|
void obs_pipewire_video_render(obs_pipewire_data *obs_pw, gs_effect_t *effect);
|
|
|
|
enum obs_pw_capture_type
|
|
obs_pipewire_get_capture_type(obs_pipewire_data *obs_pw);
|