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。