0
0
mirror of https://github.com/obsproject/obs-studio.git synced 2024-09-20 13:08:50 +02:00
obs-studio/plugins/linux-capture/xhelpers.h
Keith Packard 96924553f0 linux-capture: Use RandR monitors for screen information
RandR has two sets of screen geometry information:

 1. CRTC. These are the physical scanout engines in the hardware

 2. Monitors. These are the logical partitions of the screen.

By default, each CRTC gets mapped to a Monitor. However, some monitors
actually require two CRTCs to drive them due to limitations in the
scanout hardware. Users can also create 'virtual' monitors to support
VNC or other systems.

This patch makes the RandR code prefer the Monitor mechanism to the
older CRTC mechanism. If the server doesn't support a new enough RandR
version, the existing CRTC code is used instead.

The name of the monitor is also provided in place of the arbitrary
number to help users select the desired source.

Signed-off-by: Keith Packard <keithp@keithp.com>
2020-03-13 18:29:35 -07:00

142 lines
3.4 KiB
C

/*
Copyright (C) 2014 by Leonhard Oelke <leonhard@in-verted.de>
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/>.
*/
#pragma once
#ifdef __cplusplus
extern "C" {
#endif
#include <xcb/shm.h>
#include <xcb/xproto.h>
#include <obs.h>
typedef struct {
xcb_connection_t *xcb;
xcb_shm_seg_t seg;
int shmid;
uint8_t *data;
} xcb_shm_t;
/**
* Check for Xinerama extension
*
* @return true if xinerama is available and active
*/
bool xinerama_is_active(xcb_connection_t *xcb);
/**
* Get the number of Xinerama screens
*
* @return number of screens
*/
int xinerama_screen_count(xcb_connection_t *xcb);
/**
* Get screen geometry for a Xinerama screen
*
* @note On error the passed coordinates/sizes will be set to 0.
*
* @param xcb xcb connection
* @param screen screen number to get geometry for
* @param x x-coordinate of the screen
* @param y y-coordinate of the screen
* @param w width of the screen
* @param h height of the screen
*
* @return < 0 on error
*/
int xinerama_screen_geo(xcb_connection_t *xcb, int_fast32_t screen,
int_fast32_t *x, int_fast32_t *y, int_fast32_t *w,
int_fast32_t *h);
/**
* Check for Randr extension
*
* @return true if randr is available which means it's active.
*/
bool randr_is_active(xcb_connection_t *xcb);
/**
* Get the number of Randr screens
*
* @return number of screens
*/
int randr_screen_count(xcb_connection_t *xcb);
/**
* Get screen geometry for a Rand crtc (screen)
*
* @note On error the passed coordinates/sizes will be set to 0.
*
* @param xcb xcb connection
* @param screen screen number to get geometry for
* @param x x-coordinate of the screen
* @param y y-coordinate of the screen
* @param w width of the screen
* @param h height of the screen
*
* @return < 0 on error
*/
int randr_screen_geo(xcb_connection_t *xcb, int_fast32_t screen,
int_fast32_t *x, int_fast32_t *y, int_fast32_t *w,
int_fast32_t *h, xcb_screen_t **rscreen, char **name);
/**
* Get screen geometry for a X11 screen
*
* @note On error the passed sizes will be set to 0.
*
* @param xcb xcb connection
* @param screen screen number to get geometry for
* @param w width of the screen
* @param h height of the screen
*
* @return < 0 on error
*/
int x11_screen_geo(xcb_connection_t *xcb, int_fast32_t screen, int_fast32_t *w,
int_fast32_t *h);
/**
* Attach a shared memory segment to the X-Server
*
* @param xcb xcb connection
* @param w width of the captured screen
* @param h height of the captured screen
*
* @return NULL on error
*/
xcb_shm_t *xshm_xcb_attach(xcb_connection_t *xcb, const int w, const int h);
/**
* Detach a shared memory segment
*/
void xshm_xcb_detach(xcb_shm_t *shm);
/**
* Get screen by id for a xcb connection
*
* @param xcb xcb connection
* @param screen id of the screen
* @return screen info structure
*/
xcb_screen_t *xcb_get_screen(xcb_connection_t *xcb, int screen);
#ifdef __cplusplus
}
#endif