1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
"""Start xvfb from Python."""
from __future__ import annotations
import os
import time
XVFB_INSTALL_NOTES = """Please install Xvfb with:
Debian
$ sudo apt install libgl1-mesa-glx xvfb
CentOS / RHL
$ sudo yum install libgl1-mesa-glx xvfb
"""
def start_xvfb(wait=3, window_size=None):
"""Start the virtual framebuffer Xvfb.
Parameters
----------
wait : float, optional
Time to wait for the virtual framebuffer to start. Set to 0
to disable wait.
window_size : list, optional
Window size of the virtual frame buffer. Defaults to
:attr:`pyvista.global_theme.window_size
<pyvista.plotting.themes.Theme.window_size>`.
Notes
-----
Only available on Linux. Be sure to install ``libgl1-mesa-glx
xvfb`` in your package manager.
Examples
--------
>>> import pyvista as pv
>>> pv.start_xvfb() # doctest:+SKIP
"""
from pyvista import global_theme
if os.name != 'posix':
raise OSError('`start_xvfb` is only supported on Linux')
if os.system('which Xvfb > /dev/null'):
raise OSError(XVFB_INSTALL_NOTES)
# use current default window size
if window_size is None:
window_size = global_theme.window_size
window_size_parm = f'{window_size[0]:d}x{window_size[1]:d}x24'
display_num = ':99'
os.system(f'Xvfb {display_num} -screen 0 {window_size_parm} > /dev/null 2>&1 &')
os.environ['DISPLAY'] = display_num
if wait:
time.sleep(wait)
|
