PreviousELAB Raspberry Pi 4 Heat Sink (Copper)NextXIAO RP2350 Onboard RGB LED, Arm Cortex-M33 and Hazard3 RISC-V(Pre-Order)
Last updated
To test the Camera, you need to connect a HDMI display or a DIS display for previewing. The connectors of the DSI interface (display) and the CSI interface (camera) look the same, please take care of it when you connect the camera. The CSI interface is placed between the Audio jack and the HDMI port. The CSI connector of Pi zero series is beside the Power interface. If you use the Compute Module, please check the actual place of the carrier board.
| Photosensitive Chip Model | Supported Raspberry Pi Board Model | Supported Driver Type |
|---|---|---|
OV5647 | All Raspberry Pi boards | libcamera/Raspicam |
OV9281 | All Raspberry Pi boards | libcamera |
IMX219 (Official Raspberry Pi) | All Raspberry Pi boards | libcamera/Raspicam |
IMX219 (Third party) | Raspberry Pi Compute Module | libcamera |
IMX290/IMX327 | All Raspberry Pi boards | libcamera |
IMX378 | All Raspberry Pi boards | libcamera |
IMX477 (Official Raspberry Pi) | All Raspberry Pi boards | libcamera/Raspicam |
IMX477 (Third party) | Raspberry Pi Compute Module | libcamera |
IMX519 | All Raspberry Pi boards | libcamera (driver required) |
IMX708 (Raspberry Pi Camera Module 3) | All Raspberry Pi boards | libcamera |
IMX296 (Raspberry Pi Global Camera) | All Raspberry Pi boards | libcamera |
If you are using the latest Raspberry Pi Camera Module 3 or Raspberry Pi Global Shutter Camera, you need to run the following command to update the system (network connection is required).
If only one camera is invoked, connect the camera to the CAM1 port. If you do not use an official Raspberry Pi camera, you need to configure the "config.txt " file. If you use the latest Bookworm system, you need to configure /boot/firmware/config.txt.
Find "camera-auto-detect=1" and modify it to "camera_auto_detect=0".
At the end of the file, add the following setting statements according to the camera model.
| Model | Set Statement |
|---|---|
OV9281 | dtoverlay=ov9281 |
IMX290/IMX327 | dtoverlay=imx290, clock-frequency=37125000 |
IMX378 | dtoverlay=imx378 |
IMX219 | dtoverlay=imx219 |
IMX477 | dtoverlay=imx477 |
IMX708 | dtoverlay=imx708 |
Binocular Camera Configuration
Currently, both the CM4 and Raspberry Pi 5 support the connection of two cameras.
If you want to simultaneously connect to two cameras, you can designate the cameras by adding 'cam0' and 'cam1' after the corresponding camera configuration statements.
For example, the imx219 is connected to the cam0 interface and the ov5647 camera is connected to the cam1 interface.
Enter the Raspberry Pi terminal and enable the camera to preview:
If you want to close the preview window, you can directly press the keys "Alt-F4", or click "x" to close. Also, you can return to the terminal interface and press "Ctrl-c" to end the demo. Note: if using "Camera Module 3", the auto-focus function is enabled. Test Binocular Camera
When testing the binocular camera, you need to add "--camera" to specify the camera. If you do not add this parameter, "cam0" is specified by default.
After the Bullseye version, the underlying Raspberry Pi driver for the Raspberry Pi image has been switched from Raspicam to libcamera. Libcamera is an open-source software stack (referred to as a driver later for ease of understanding) that is convenient for third-party porting and developing their own camera drivers. As of December 11, 2023, the official pycamera2 library has been provided for libcamera, making it easier for users to call Python demos.
The libcamera software stack provides six commands for users to preview and test the camera interface.
This is a simple "hello world" program that previews the camera and displays the camera image on the screen. Example
This command will preview the camera on the screen for about 5 seconds. The user can use the "-t <duration>" parameter to set the preview time, where the unit of <duration> is milliseconds. If it is set to 0, it will keep previewing all the time. For example:
Tune File The libcamera driver of the Raspberry Pi will call a tuning file for different camera modules. The tuning file provides various parameters. When calling the camera, libcamera will call the parameters in the tuning file, and process the image in combination with the algorithm. The final output is the preview screen. Since the libcamera driver can only automatically receive the signal of the chip, the final display effect of the camera will also be affected by the entire module. The use of the tuning file is to flexibly handle the cameras of different modules and adjust to improve the image quality. If the output image of the camera is not ideal after using the default tuning file, the user can adjust the image by calling the custom tuning file. For example, if you are using the official NOIR version of the camera, the NOIR camera may require different white balance parameters compared with the regular Raspberry Pi Camera V2. In this case, you can switch by calling the tuning file.
Users can copy the default tuning files and modify them according to their needs. Note: The use of tuning files applies to other libcamera commands, and will not be introduced in subsequent commands.
Preview Window Most libcamera commands will display a preview window on the screen. Users can customize the title information of the preview window through the --info-text parameter, and can also call some camera parameters through %directives and display them on the window. For example, if you use HQ Camera: You can display the focal length of the camera on the window through --info-txe "%focus".
Note: For more information on parameter settings, please refer to the following chapters.
libcamera-jpeg is a simple static picture shooting program, different from the complex functions of libcamera-still, libcamera-jpeg code is more concise and has many of the same functions to complete picture shooting. Take JPEG image of full pixel
This shooting command will display a preview serial port for about 5 seconds, and then shoot a full-pixel JPEG image and save it as test.jpg. Users can set the preview time through the -t parameter and can set the resolution of the captured image through --width and --height. E.g:
Exposure control All libcamera commands allow the user to set the shutter time and gain themselves, such as:
This command will capture an image with 20ms exposure and camera gain set to 1.5x. The gain parameter set will first set the analog gain parameter inside the photosensitive chip. If the set gain exceeds the maximum built-in analog gain value of the driver, the maximum analog gain of the chip will be set first, and then the remaining gain multiples will be used as digital gains to take effect. Remarks: The digital gain is realized by ISP (image signal processing), not directly adjusting the built-in register of the chip. Under normal circumstances, the default digital gain is close to 1.0, unless there are the following three situations.
Overall gain parameter requirements, that is, when the analog gain cannot meet the set gain parameter requirements, the digital gain will be needed for compensation.
One of the color gains is less than 1 (the color gain is achieved by digital gain), in this case, the final gain is stabilized at 1/min(red_gain, blue_gain), that is, a uniform digital gain is applied, and is the gain value for one of the color channels (not the green channel).
AEC/AGC was modified. If there is a change in AEC/AGC, the digital gain will also change to a certain extent to eliminate any fluctuations, this change will be quickly restored to the "normal" value.
The Raspberry Pi's AEC/AGX algorithm allows the program to specify exposure compensation, which is to adjust the brightness of the image by setting the aperture value, for example:
libcamera-still and libcamera-jpeg are very similar, the difference is that libcamera inherits more functions of raspistill. As before, users can take a picture with the following command. Test Command
Encoder libcamea-still supports image files in different formats, can support png and bmp encoding, and also supports saving binary dumps of RGB or YUV pixels as files without encoding or in any image format. If you save RGB or YUV data directly, the program must understand the pixel arrangement of the file when reading such files.
Note: The format of image saving is controlled by the -e parameter. If the -e parameter is not called, it will be saved in the format of the output file name by default. Raw Image Capture The raw image is the image output by the direct image sensor without any ISP or CPU processing. For color camera sensors, the output format of the raw image is generally Bayer. Note that the raw image is different from the bit-encoded RGB and YUV images we said earlier, and RGB and YUV are also ISP-processed images. A command to take a raw image:
The raw image is generally saved in DNG (Adobe Digital Negative) format, which is compatible with most standard programs, such as dcraw or RawTherapee. The raw image will be saved as a file of the same name with the .dng suffix, for example, if you run the above command, it will be saved as a test.dng, and generate a jpeg file at the same time. The DNG file contains metadata related to image acquisition, such as white balance data, ISP color matrix, etc. The following is the metadata encoding information displayed by the exiftool:
Long Exposure If we want to take a super long exposure picture, we need to disable AEC/AGC and white balance, otherwise, these algorithms will cause the picture to wait for a lot of frame data when it converges. Disabling these algorithms requires another explicit value to be set. Additionally, the user can skip the preview process with the --immediate setting. Here is the command to take an image with an exposure of 100 seconds:
Remarks: Reference table for the longest exposure time of several official cameras.
| Module | Maximum exposure time (s) |
|---|---|
V1 (OV5647) | 6 |
V2 (IMX219) | 11.76 |
V3 (IMX708) | 112 |
HQ (IMX477) | 670 |
libcamera-vid is a video recording demo that uses the Raspberry Pi hardware H.264 encoder by default. After the program runs, a preview window will be displayed on the screen, and simultaneously the bitstream encoding will be output to the specified file. For example, record a 10s video.
If you want to view the video, you can use vlc to play it.
Note: The recorded video stream is unpackaged. Users can use --save-pts to set the output timestamp to facilitate the subsequent conversion of the bit stream to other video formats.
If you want to output the mkv file, you can use the following command:
Encoder Raspberry Pi supports JPEG format and YUV420 without compression and format:
The --codec option sets the output format, not the output file extension. Use the --segment parameter to split the output file into segments (unit is ms), which is suitable for JPEG files that need to split the JPEG video stream into separate short (about 1ms) JPEG files.
UDP Video Streaming Transmission UDP can be used for video streaming transmission, and the Raspberry Pi runs (server):
Among them, <ip-addr> needs to be replaced with the actual client IP address or multicast address. On the client (client), enter the following commands to obtain and display the video stream (you can use one of the two commands);
Note: The port needs to be the same as the one you set on the Raspberry Pi. TCP Video Streaming Transmission You can use TCP for video streaming, and the Raspberry Pi runs (server):
The client runs:
RTSP Video Streaming Transmission On the Raspberry Pi, vlc is usually used to process the RTSP video stream:
On the playback side, you can run any of the following commands:
In all preview commands, if you want to turn off the preview window on the Raspberry Pi, you can use the parameter -n (--nopreview) to set it. Also, pay attention to the setting of the --inline parameter. Changing the setting will force the header information of the video stream to be included in each I (intra) frame. This setting allows the client to correctly parse the video stream even if the video header is lost. High Frame Rate Mode If you use the libcamera-vid command to record high frame rate video (generally higher than 60fps) while reducing frame loss, you need to pay attention to the following points:
The target level of H.264 needs to be set to 4.2, which can be set with the --level 4.2 parameter.
The color noise reduction function must be turned off, which can be set with the --denoise cdn_off parameter.
If the set frame rate is higher than 100fps, close the preview window to release more CPU resources and avoid frame loss, which can be set with the -n parameter.
It is recommended to add the setting force_turbo=1 in the /boot/config.txt file to ensure that the CPU clock will not be limited in the video stream.
Adjust the ISP output resolution, use -width 1280 --height 720 to set the resolution, or set it to a lower resolution, depending on the camera model.
If you are using Pi 4 or higher-performance model, you can add the setting gpu_freq=550 or higher in the /boot/config.txt file to overclock the motherboard GPU to achieve higher performance.
For example, record 1280x720 120fps video.
Libcamera-raw is similar to a video recording demo. The difference is, libcamera-raw records the Bayer format data output by the direct sensor, that is, the raw image data. Libcamera-raw doesn't show a preview window. For example, record a 2-second piece of raw data.
The demo will directly dump the raw frame without format information, the program will directly print the pixel format and image size on the terminal, and the user can view the pixel data according to the output data. By default, the program will save the raw frame as a file, the file is usually large, and the user can divide the file by the --segement parameter.
If the memory is large (such as using SSD), libcamera-raw can write the official HQ Camera data (about 18MB per frame) to the hard disk at a speed of about 10 frames per second. To achieve this speed, the demo writes the unformatted raw frames, there is no way to save them as DNG files like libcamera-still does. If you want to ensure that there are no dropped frames, you can use --framerate to reduce the frame rate.
Common command setting options apply to all libcamera commands:
Print program help information, you can print the available setting options for each program command, and then exit.
Print the software version, print the software version of libcamera and libcamera-app, then exit.
Displays the recognized supported cameras. for example:
According to the printed information, the IMX219 camera has a suffix of 0, and the IM new 477 camera has a suffix of 1. When calling the camera, you can specify the corresponding suffix.
Specify the camera, and the corresponding suffix can refer to the print information of the command --list-camera. For example: libcamera-hello -c config.txt In the setting file, set parameters one line at a time, in the format of key=value:
Under normal circumstances, we can directly set the camera parameters through commands. Here we use the --config parameter to specify the setting file and directly read the setting parameters in the file to set the camera preview effect.
The "-t" option sets the runtime of the libcamera demo. If the video recording command is run, the timeout option sets the recording duration. If the image capture command is run, the timeout sets the preview time before the image is captured and output. If "timeout" is not set when running the libcamera demo, the default timeout value is 5000 (5 seconds). If the timeout is set to 0, the demo will continue to run. Example: libcamera-hello -t 0
"-p" sets the size and position of the preview window (the qualified settings are valid in both X and DRM version windows), and the format is --preview <x. y, w, h> where "x, y" sets the preview window coordinate, "w" and "h" set the width and length of the preview window. The settings of the preview serial port will not affect the resolution and aspect ratio of the camera image preview. The demo will scale the preview image to display in the preview window and adapt it according to the original image aspect ratio. Example: libcamera-hello -p 100,100,500,500
The "-f" option sets the preview window full screen, the preview window and the border in full-screen mode. Like "-p", it does not affect the resolution and aspect ratio, and will automatically adapt. Example: libcamera-still -f -o test.jpg
Using the preview window based on the QT framework, this setting is not recommended under normal circumstances, because the preview demo will not use zero-copy buffer sharing and GPU acceleration, which will occupy more resources. The QT preview window supports X forwarding (the default preview program does not). The Qt preview serial port does not support the "--fullscreen" setting option. If the user wants to use the Qt preview, it is recommended to keep a small preview window to avoid excessive resource usage and affecting the normal operation of the system. Example: libcamera-hello --qt-preview
Images are not previewed. This setting will turn off the image preview function. Example: libcamera-hello -n
Set the title and information display of the preview window (only available in the X graphics window) using the format --info-text <string>. When calling this option, multiple parameters can be set, and the parameters are usually called in the % command format. The demo will call the corresponding value in the graphics metadata according to the instructions. If no window info is specified, the default --info-text is set to "#%frame (%fps fps) exp %exp ag %ag dg %dg" Example: libcamera-hello --info-test "Focus measure: %focus Available parameters:
| Instructions | Instructions |
|---|---|
%frame | Frame sequence number |
%fps | Instantaneous frame rate |
%exp | The shutter speed when capturing the image, in ms |
%ag | Image analog gain controlled by the sensor chip |
%dg | Image value gain controlled by ISP |
%rg | Gain of the red component of each pixel |
%bg | The gain of the blue component of each pixel |
%focus | The corner measurement of the image, the larger the value, the clearer the image |
%lp | Diopter of the current lens (1/distance in meters) |
%afstate | Autofocus state (idle, scanning, focused, failed) |
These two parameters set the width and height of the image, respectively. For libcamera-still, libcamera-jpeg, and libcamera-vid commands, these two parameters can set the resolution of the output image/video. If the libcamera-raw command is used, these two parameters affect the size of the obtained metadata frame. The camera has a 2 x 2 block reading mode. If the set resolution is smaller than the split mode, the camera will obtain the metadata frame according to the 2 x 2 block size. libcamera-hello cannot specify the resolution. Example: libcamera-vid -o test.h264 --width 1920 --height 1080 Record 1080p video libcamera-still -r -o test.jpg --width 2028 --height 1520 Takes a 2028 x 1520 JPEG image.
This setting option is also used to set the resolution of the image, the difference is only the image size of the preview. It does not affect the final output image or video resolution.The size of the preview image will not affect the size of the preview window and it will be adapted according to the window. Example: libcamera-hello --viewfinder-width 640 --viewfinder-height 480.
This setting forces the sensor to use the --width and --height settings to output still images and video in full-resolution read mode. This setting libcamera-hello has no effect. With this setting, the framerate is sacrificed. In full-resolution mode, frame reading will be slower. Example: libcamera-raw -t 2000 --segment 1 --rawfull -o test%03d.raw The example command captures multiple Metadata frames in full-resolution mode. If you are using an HQ camera, the size of each frame is 18MB, and if --rawfull is not set, the HQ camera defaults to 2 x 2 mode, and the data size of each frame is only 4.5MB.
This parameter is more general than rawfull. It is used to set the camera mode. When using it, you need to specify the width, height, bit depth and packing mode, and separate them with colons. The set value does not have to be completely accurate, the system will automatically match the closest value, and the bit depth and packing mode can be set (the default is 12 and P means packing).
4056:3040:12:P - 4056x3040 resolution, 12bit per pixel, packed. Packed means that the raw image data will be packed in the buffer. In this case, two pixels will only occupy 3 bytes, which can save memory.
1632:1224:10 - 1632x1224 resolution, 10bit per pixel, packed by default. In 10-bit packing mode, 4-pixel data will occupy 5 bytes.
2592:1944:10:U - 2592x1944 resolution, 10bits per pixel, no packed. In the case of unpacking, each speed limit will occupy 2bytes of memory, in this case, the highest 6 bits will be set to 0.
3262:2448 -3264x2448 resolution, 12bits and packed mode are used by default. However, if the camera model, such as Camera V2 (IMX219), does not support 12-bit mode, the system will automatically select 10bits mode.
The --mode parameter is used to set the camera mode when recording video and shooting still images. If you want to set it when previewing, you can use the --viewfinder-mode parameter.
These two options set low-resolution images. The low-resolution data stream compresses the image, causing the aspect ratio of the image to change. When using libcamera-vid to record video, if a low resolution is set, functions such as color denoising will be disabled. Example: libcamera-hello --lores-width 224 --lores-height 224 Note that low-resolution settings are often used in conjunction with image postprocessing, otherwise it has little effect.
These three options are used to flip the image. The parameters of --rotation currently only support 0 and 180, which are equivalent to --hflip and --vflip. Example: libcamera-hello --vflip --hflip
"--roi" allows the user to crop the image area they want according to the coordinates from the complete image provided by the sensor, that is, digital scaling, paying attention to the coordinate value if it is in the valid range. For example --roi 0, 0, 1, 1 is an invalid instruction. Example: libcamera-hello --roi 0.25,0.25,0.5,0.5 The example command will crop 1/4 of the image from the center of the image.
The hdr parameter is used to set the wide dynamic mode of the camera. This setting will only take effect if the camera supports a wide dynamic range. You can use --list-camera to see if the camera supports hdr mode.
Adjust the sharpness of the image by the value of <number>. If set to 0, no sharpening is applied. If you set a value above 1.0, an extra sharpening amount will be used. Example: libcamera-still -o test.jpg --sharpness 2.0
Example: libcamera-still -o test.jpg --contrast 1.5
The setting range is -1.0 ~ 1.0 Example: libcamera-still -o test.jpg --brightness 0.2
Example: libcamera-still -o test.jpg --saturation 0.8
Set the EV compensation of the image in aperture units, the setting range is -10 ~ 10, the default value is 0. The program works by improving the target method of the AEC/AGC algorithm. Example: libcamera-still -o test.jpg --ev 0.3
Note: If the frame rate of the camera is too fast, it may not work according to the set shutter time. If this happens, you can try to use --framerate to reduce the frame rate. Example: libcamera-hello --shutter 30000
--analoggain is the same as --gain, the use of analoggain is only for compatibility with raspicam programs.
Set the metering mode of the AEC/AGC algorithm, the available parameters are:
centre - Center metering (default)
spot - spot metering
average - average or full frame metering
custom - custom metering mode, can be set via tuning file
Example: libcamera-still -o test.jpg --metering spot
The exposure mode can be set to normal or sport. The report profile for these two modes does not affect the overall exposure of the image, but in the case of sports mode, the program will shorten the exposure time and increase the justice to achieve the same exposure effect. Example: libcamera-still -o test.jpg --exposure sport
Available white balance modes:
| Mode | Color Temperature |
|---|---|
auto | 2500K ~ 8000K |
incadescent | 2500K ~ 3000K |
tungsten | 3000K ~3500K |
fluorescent | 4000K ~ 4700K |
indoor | 3000K ~ 5000K |
daylight | 5500K ~ 6500K |
cloudy | 7000K ~ 8500K |
custom | Custom range, set via tuning file |
Example: libamera-still -o test.jpg --awb tungsten
Set red and blue gain. Example: libcamera-still -o test.jpg --awbgains 1.5, 2.0
Supported denoising modes:
auto - default mode, use standard spatial denoising, if it is video, it will use fast color noise reduction and use high-quality color noise reduction when taking still pictures. The preview image will not use any color denoising.
off - turn off spatial denoising and color denoising.
cdn_off - turn off color denoising.
cdn_fast - use fast color denoising.
cdn_hq - use high-quality color denoising, not suitable for video recording.
Example: libcamera-vid -o test.h264 --denoise cdn_off
For more instructions on tuning files, you can refer to official tutorial Example: libcamera-hello --tuning-file ~/my~camera-tuning.json
Set the autofocus mode.
default - By default, the camera will use continuous autofocus mode, unless --lens-position or --autofocus-on-capture manual focus is set.
manual - manual focus mode, the focus position can be set by --lens-position.
auto - focus will only be done once when the camera is turned on, and will not be adjusted in other cases. (If you use the libcamera-still command, only when --autofocus-on-capture is used, it will focus once before taking a photo).
continuous - The camera will automatically adjust the focus position according to the scene changes.
Set the autofocus range.
normal -- the default item, from nearest to infinity.
macro - macro mode, only focus on nearby objects.
full - full distance mode, adjusted to infinity for the closest object.
Set the focus speed.
normal - default item, normal speed.
fast - fast focus mode.
To display the focus window, you need to set x, y, width, height, and the coordinate value setting is based on the ratio of the image. For example --autofocus-window 0.25,0.25,0.5,0.5 would set a window half the size of the image and centered.
Set the focus position.
0.0 -- set the focus position to infinity.
number -- set the focus position to 1/number, number is any value you set, for example, if you set 2, it means that it will focus on the position of 0.5m.
default -- focus on the default position relative to the hyperfocal distance of the lens.
Set the filename of the output image or video. In addition to setting the file name, you can also specify the output udp or tcp server address to output the image to the server. If you are interested, you can check the relevant setting instructions of the subsequent tcp and udp. Example: libcamera-vid -t 100000 -o test.h264
Example: libcamera-vid -t 0 --codec mjpeg --segment 1 --wrap 100 -o image%d.jpg
--flush will immediately update each frame of the image to the hard disk at the same time as it is written, reducing latency. Example: libcamera-vid -t 10000 --flush -o test.h264
For more camera setup instructions, please refer to Official Camera Documentation.
If you are using the Buster version of the image, the Raspicam driver is installed by default in the system, you can directly turn on the camera and use it. If you are using the latest Bullseye system, you need to install and configure it separately. Applicable to OV5647, official IMX219, official IMX477.
Open the Raspberry Pi terminal, and enter the following command to install the driver. Note: This driver cannot support a 64-bit Raspberry Pi system temporarily.
Restart the system after installation.
The raspistill command is used to take still pictures. Example: raspistill -o cam.jpg
The raspivid command is used to record video. Example: raspivid -o vid.h264
The raspiyuv command has the same function as raspisitll, the difference is that raspiyuv dosen't output jpgs and other standard image files, but generate YUV420 or RGB888 image files from the camera's ISP output. In most cases, it is better to use raspistill to capture images, but if you want to use uncompressed black and white images, you can choose to use the raspiyuv command. Example: raspiyuv -o cam.jpg
When the raspicam command is used, the final imaging effect can be adjusted by setting options. The available setting options are listed below for reference.
The user can set the position of the preview window by setting the values of x and y, and adjust the resolution of the preview image by setting the values of w and h.
Display the preview window in full screen.
Close the preview window and the command will output the image or video directly to a file.
Set the transparency of the preview window, 0 is invisible, and 255 is fully transparent.
The default sharpening value is 0.
The default contrast is 0.
The default brightness is 50, 0 is fully black, and 100 is full white.
The default saturation is 0.
Set sensitivity when taking pictures.
Only the video recording mode is valid, and video stabilization is enabled.
Set the EV compensation value of the image, default 0.
Configurable exposure options:
auto: automatic exposure mode
night: night shooting mode
nightpreview
backlight: backlight mode
spotlight
sports: sports mode (the shutter time will be shortened in sports mode)
snow: snow mode
beach: beach mode
verylong: long exposure mode
fixedfps: fixed fps
antishake: anti-shake mode
fireworks: fireworks mode
Note: Depending on the camera model, some modes are not available.
Configurable modes:
off: turn off anti-flicker mode
auto: automatic detection of injection frequency
50Hz: set the anti-flicker frequency to 50Hz
60Hz: set the anti-flicker frequency to 60Hz
off: disable auto white balance
auto: auto white balance mode (default)
sun: sunny mode (5000K ~ 6500K)
cloud: cloudy mode (6500K ~ 12000K)
shade: shadow mode
tungsten: Tungsten mode (2500K ~ 3500K)
incadescent: Incadescent mode (2500K ~ 4500K)
flash: flash mode
horizon: horizon mode
greyworld: If you are using a camera without an IR filter (eg NoIR), you can fix the white balance misalignment caused by the lack of an IR filter.
Note: Depending on the camera model, some modes are not available.
Configurable image filter effects:
none: no effect (default)
negative: color flip
solarise: sunlight effect
posterise: poster effect
whiteboard: whiteboard effect
backboard: blackboard effect
sketch: sketch
denoise: denoise
emboss: emboss
oilpaint: oil painting
hatch: texture
gpen: pencil sketch
pastel: colored pencils
watercolour: watercolor
film: film
blur: blur
saturation: saturation
Note: Depending on the camera model, some modes are not available.
The setting range of the U and V parameters is 0 ~ 255, which are used to adjust the values of the U and Y channels. For example --colfx 128:128 will set the image to monochrome.
Configurable options:
average: average or full frame metering
spot: spot metering
backlit: preset a backlight image
matrix: matrix metering
The image rotation angle can be set by the angle parameter.
Set the image to be flipped horizontally.
Flip the image vertically.
Crop the image according to the parameters, note that the parameters are all planned in (0,0 ~ 1.0), for example, if you want to crop 1/4 of the image, you can use the command - roi 0.5,0.5,0.25,0.25.
Set the shutter time (unit: ms). The maximum shutter time that can be set is different depending on the photosensitive chip.
| Model | Max Digit (ms) |
|---|---|
V1 (OV5647) | 6000000 (6s) |
V2 (IMX219) | 10000000 (10s) |
HQ (IMX477) | 200000000 (200s) |
off (default)
low
med
high
Set blue and green gain, which takes effect if --awb off is set.
Set the analog gain value
Set digital gain value
Set sensor mode:
OV5647
| Mode | Resolution | Aspect Ratio | Frame Rate | FoV |
|---|---|---|---|---|
0 | Automatic selection | |||
1 | 1920 x 1080 | 16:9 | 1-30fps | Partial |
2 | 2592 x 1944 | 4:3 | 1-15fps | Full Frame |
3 | 2592 x 1944 | 4:3 | 0.1666 - 1fps | Full Frame |
4 | 1296 x 972 | 4:3 | 1 - 42fps | Full Frame |
5 | 1296 x 730 | 16:9 | 1- 49fps | Full Frame |
6 | 640 x 480 | 4:3 | 42.1 - 60fps | Full Frame |
7 | 640 x 480 | 4:3 | 60.1 - 90fps | Full Frame |
IMX219
| Mode | Resolution | Aspect Ratio | Frame Rate | FoV |
|---|---|---|---|---|
0 | Automatic selection | |||
1 | 1920 x 1080 | 16:9 | 0.1-30fps | Partial |
2 | 3280 x 2464 | 4:3 | 0.1-15fps | Full Frame |
3 | 3280 x 2464 | 4:3 | 0.1 - 15fps | Full Frame |
4 | 1640 x 972 | 4:3 | 1 - 42fps | Full Frame |
5 | 1296 x 730 | 16:9 | 1- 49fps | Full Frame |
6 | 640 x 480 | 4:3 | 42.1 - 60fps | Full Frame |
7 | 640 x 480 | 4:3 | 60.1 - 90fps | Full Frame |
HQ Camera
| Mode | Resolution | Aspect Ratio | Frame Rate | FoV |
|---|---|---|---|---|
0 | Automatic selection | |||
1 | 2028 x 1080 | 169:90 | 0.1-50fps | Partial |
2 | 2028 x 1080 | 4:3 | 0.1-50fps | Full Frame |
3 | 4056 x 3040 | 4:3 | 0.005 - 10fps | Full Frame |
4 | 1332 x 990 | 74:55 | 50.1-120 fps | Partial |
When multiple cameras are connected to the system, select camera, 0 or 1.
The parameters are represented by bit masks in the metadata, which can be directly represented by addition. For example, 12 can represent the display time (4) and the display date (8), which is represented by the addition of 4+8 =12. Configurable options
| Value | Parameter description |
|---|---|
-a 4 | Time |
-a 8 | Date |
-a 12 | Time and date, actually 4 + 8 |
-a 16 | Shutter setting |
-a 32 | CAF settings |
-a 64 | Gain setting |
-a 128 | Lens settings |
-a 256 | Animation settings |
-a 512 | Number of frames |
-a 1024 | Black background |
-a "ABC %Y-%m-%d %X" | Display text |
-a 4 -a "ABC %Y-%m-%d %X" | Display time/date in custom format |
-a 8 -a "ABC %Y-%m-%d %X" | Display time/date in custom format |
Set the binocular mode.
sbs - Side-by-side mode
tb: - Portrait mode
off - turn off binocular mode (default)
Halve the width and height of the binocular image.
Output current camera settings.
