cameractrls

Cameractrls

Linux的摄像机控件

这是独立的Python CLI和GUI（GTK3，GTK4）和相机查看器（SDL），可以在Linux中设置相机控件。它可以设置V4L2控件，并且可以通过非标准控件扩展。 Currently it has a Logitech extension (LED mode, LED frequency, BRIO FoV, Relative Pan/Tilt, PTZ presets), Kiyo Pro extension (HDR, HDR mode, FoV, AF mode, Save), Dell UltraSharp WB7022 extension, Preset extension (Save and restore controls), Control Restore Daemon (to restore presets at device connection).

安装

来自Flathub

 flatpak install flathub hu.irl.cameractrls

来自Arch软件包存储库

 pacman -S cameractrls

来自Manjaro软件包存储库

 pamac install cameractrls

git安装方法

通过APT安装依赖项：

sudo apt install git libsdl2-2.0-0 libturbojpeg

或通过DNF：

sudo dnf install git SDL2 turbojpeg

克隆仓库

git clone https://github.com/soyersoyer/cameractrls.git
cd cameractrls

cameractrlsgtk

摄像机控件的GTK3 GUI

GTK3 GUI安装

将桌面文件添加到启动器

desktop-file-install --dir= " $HOME /.local/share/applications " 
--set-key=Exec --set-value= " $PWD /cameractrlsgtk.py " 
--set-key=Path --set-value= " $PWD " 
--set-key=Icon --set-value= " $PWD /pkg/hu.irl.cameractrls.svg " 
pkg/hu.irl.cameractrls.desktop

从发射器或外壳跑

./cameractrlsgtk.py

GTK4 GUI安装（实验）

将桌面文件添加到启动器

desktop-file-install --dir= " $HOME /.local/share/applications " 
--set-key=Exec --set-value= " $PWD /cameractrlsgtk4.py " 
--set-key=Path --set-value= " $PWD " 
--set-key=Icon --set-value= " $PWD /pkg/hu.irl.cameractrls.svg " 
pkg/hu.irl.cameractrls.desktop

从发射器或外壳跑

./cameractrlsgtk4.py

cameractrls.py

CLI。

运行相机

./cameractrls.py

 usage: ./cameractrls.py [--help] [-d DEVICE] [--list] [-c CONTROLS]

optional arguments:
  -h, --help         show this help message and exit
  -d DEVICE          use DEVICE, default /dev/video0
  -l, --list         list the controls and values
  -L, --list-devices list capture devices
  -c CONTROLS        set CONTROLS (eg.: hdr=on,fov=wide)

example:
  ./cameractrls.py -c brightness=128,kiyo_pro_hdr=on,kiyo_pro_fov=wide

cameractrlsd.py

控制恢复守护程序。

使用GUI/CLI添加到SystemD/Desktop门户。

cameraview.py

相机查看器。

./cameraview.py -h

 usage: ./cameraview.py [--help] [-d DEVICE] [-s SIZE] [-r ANGLE] [-m FLIP] [-c COLORMAP]

optional arguments:
  -h, --help         show this help message and exit
  -d DEVICE          use DEVICE, default /dev/video0
  -s SIZE            put window inside SIZE rectangle (wxh), default unset
  -r ANGLE           rotate the image by ANGLE, default 0
  -m FLIP            mirror the image by FLIP, default no, (no, h, v, hv)
  -c COLORMAP        set colormap, default none
                    (none, grayscale, inferno, viridis, ironblack, rainbow)

example:
  ./cameraview.py -d /dev/video2

shortcuts:
  f: toggle fullscreen
  r: ANGLE +90 (shift+r -90)
  m: FLIP next (shift+m prev)
  c: COLORMAP next (shift+c prev)

PTZ控件

键盘

用箭头键/键盘键/wasd/home/end/pageup/pageown/+/+/ - /ctrl ++/ctrl+ - 在PTZ控件中之一处于焦点或摄像头窗口中时，用箭头键/键盘/pagep/pagep/pagep/pagep/pagep/ctrl+ - 控制您的PTZ相机。

使用alt+预设为Logitech_pantilt_preset选择一个预设。

3DCONNEXNEXION SPACEMOUSE

用6DOF的空间控制相机。

 Z => zoom_absolute
X => pan_absolute
Y => tilt_absolute
RY => pan_speed
RX => tilt_speed
BTN1 => PTZ reset

它需要Spacenavd和libspnav。 （可选，只有在您有空间的情况下）

sudo apt install spacenavd libspnav0
sudo cp /usr/share/doc/spacenavd/examples/example-spnavrc /etc/spnavrc

或通过DNF：

sudo dnf install spacenavd libspnav
sudo cp /usr/share/doc/spacenavd/example-spnavrc /etc/spnavrc

提示：设置led = auto在 /etc /spnavrc

游戏控制器

使用游戏控制器（PS5 DualSense/Xbox Controlter/等）控制相机

 Left Stick => pan_speed/tilt_speed or pan_absolute/tilt_absolute
Right Stick => pan_absolute/tilt_absolute
DPAD => pan_absolute/tilt_absolute
Left/Right Trigger => zoom_absolute
South/East/West/North/Left Shoulder/Right Shoulder/Back/Start => PTZ Presets 1-8
Guide => PTZ Reset

MIDI控制器

使用MIDI控制器控制相机（例如MPK mini或任何可配置旋钮/欢乐的任何相机）

如下以下配置MIDI控制器：

 With joystick:
CC78 => pan_speed/pan_absolute
CC79 => tilt_speed/tilt_absolute

With absolute knobs (knob values: 0-127):
CC71 => pan_absolute
CC72 => tilt_absolute
CC73 => zoom_absolute

With relative knobs (knob values: INC:1 DEC:127):
CC70 => pan_speed
CC74 => tilt_speed
CC75 => pan_absolute
CC76 => tilt_absolute
CC77 => zoom_absolute

CC121 => PTZ reset
PGM0-7 => PTZ presets 1-8

更新cameractrls

git pull

更新0.5.x-> 0.6.x

禁用，停止和删除旧的SystemD路径，服务：

 cd ~ /.config/systemd/user
systemctl --user disable --now cameractrls- *
rm cameractrls- *

删除cameractrls

禁用，停止并删除SystemD服务：

 cd ~ /.config/systemd/user
systemctl --user disable --now cameractrlsd.service
rm cameractrlsd.service

删除发射器快捷方式

rm ~ /.local/share/applications/hu.irl.cameractrls.desktop

删除相机：

rm -rf cameractrls

供应商的合作机会

Linux使用量每年都在增加，目前约为4-5％。

由于Linux的采用率较低，带有自定义控件的相机控制软件通常仅适用于Windows/MacOS，因此Linux用户无法利用每个相机的真正潜力。

如果您想要快乐的Linux客户，并且您的相机具有此应用程序中缺少的自定义控件，请给我发送相机，我将添加它们。接触

或当然，您可以创建一个PR。