Skip to main content

Usage Guide

Overview​

Enumerate and List All Video Devices​

When VizionViewer™ starts, it displays an initial screen showing all available video devices. You can select a camera either from this device list or from the dropdown menu. The device list refreshes every second.

Camera Selection

Change Streaming Format​

Color Space / Compression​

After selecting a camera, the color space/compression dropdown displays all supported formats. Supported formats include UYVY, YUY2, NV12, and MJPG.

Resolution​

Once a color space/compression is chosen, the resolution dropdown lists all supported resolutions for the selected camera.

Framerate​

After selecting a resolution, the framerate dropdown displays all supported framerates.

Display the Current Frame Rate Per Second​

info

"Stream Frame Rate" refers to the camera's streaming output rate, not the rendering rate of VizionViewer™.

Frame Rate Display

Extension Settings Control​

info

Switching the Control Mode to UVC will reset ISP Extension settings to default. Switching to ISP mode will reset UVC Extension settings to default.

Extension Controls

UVC Mode Extensions​

Supported controls:

  • White Balance (Auto / Manual)
  • Exposure / Gain (Auto / Manual)
  • Contrast
  • Saturation
  • Sharpness
  • Gamma
  • Brightness
  • Hue
  • Backlight
  • Focus
  • Iris
  • Zoom
  • Pan
  • Tilt
  • Roll

ISP Mode Extensions​

White Balance (Auto / Manual)​

EHDR Settings (Note: Supported only on device models 0821 and 0822)​

  • State: Enable / Disable
  • Exposure: Set Min/Max Number
  • Ratio: Set Min/Max Ratio

Exposure / Gain (Auto / AGC / Manual)​

Image Adjustment​

Supported controls:

  • Contrast
  • Saturation
  • Sharpness
  • Denoise
  • Backlight Compensation
  • Brightness
  • JPEG Quality
  • Filter: Apply visual effects (Black and White, Grayscale, Negative, Sketch)
  • Flick Mode: Reduce flickering under artificial lighting (Disable, 50Hz, 60Hz, Auto)

Region of Interest​

Control the camera's field of view:

  • Zoom: Adjust the zoom level
  • Pan: Move the view horizontally
  • Tilt: Move the view vertically
  • Flip Mode: Rotate or mirror the image (Vertical, Horizontal, Rotate 180°)

Set Up AGC Exposure Mode to Maintain Constant Framerate​

Floating Framerate

For low-light applications, the camera increases exposure time in automatic exposure mode to maintain image quality.

You can switch to AGC exposure mode to keep the framerate constant.

AGC Mode

Auto gain control, manual exposure time.

When AGC mode is enabled, gain is set automatically. The initial exposure value adjusts based on the current streaming framerate to maintain a constant framerate.

AGC Mode

Limit Exposure Range in Auto Exposure Mode​

(Default Exposure Range) When switching to Auto Exposure Mode, the Exposure Time Range is automatically set to the default range based on the selected streaming format.

You can limit the exposure range even in Auto Exposure Mode. This is useful when you want to avoid overexposure or motion blur in specific lighting conditions. The default exposure range varies depending on the selected resolution and framerate.

The current Exposure Time and Exposure Gain values are displayed after the camera starts streaming and are updated every second to reflect real-time changes.

Exposure Range

Update Technexion Camera Firmware​

If firmware updates are available for the selected camera, the Update button becomes enabled. You can:

  • Update your camera's firmware directly
  • Download firmware for later installation

Firmware Update Download for Later

Manage OS Profiles​

Profiles allow you to save video stream and extension settings for your camera. You can create and name multiple profiles for different scenarios, making it easy to apply predefined configurations.

OS Profile Management

Manage OSP (On Sensor Profile)​

Store profiles directly on the sensor. The camera will automatically apply your preset profile upon startup.

OSP Profile Settings

Preview Features​

Software Zoom​

Zoom

Enable zoom to magnify the camera preview. Use the zoom controls to adjust the magnification level for detailed inspection of the camera feed.

Grid Overlay​

Grid

Display composition guides on the camera preview to help with framing and alignment. Choose from multiple grid types:

  • Off: No grid overlay
  • Rule of Thirds: Classic 3×3 grid for balanced composition
  • Golden Ratio: Grid based on the golden ratio for aesthetic framing
  • Crosshairs: Center cross for precise alignment
  • Square: Centered square guide

Record Videos and Capture Photos​

Record Videos​

info

On embedded platforms, the maximum recording resolution is 1920x1200.

  • Video Codec Options: Choose between H264 (compressed, smaller file size) or FFV1 (lossless, larger file size)
  • Filenames follow the format: yyyyMMdd_hh_mm_ss_zzz.avi
  • Default storage location: system default path (Tools → File → Open Video Folder)
  • To change codec or storage location: Tools → File → Options

Take Photos​

  • Image Format Options: Choose from BMP, PNG, JPG, or Direct Buffer (raw)
  • Filenames follow the format: yyyyMMdd_hh_mm_ss_zzz.[format]
  • Default storage location: system default path (Tools → File → Open Image Folder)
  • To change format or storage location: Tools → File → Options

Stream Format Preference​

Configure your preferred camera stream format for optimal performance:

  • YUY2: Packed YUV 4:2:2 format, good quality with moderate bandwidth
  • UYVY: Packed YUV 4:2:2 format, similar to YUY2 with different byte order
  • NV12: Planar YUV 4:2:0 format, efficient for video processing
  • MJPEG: Motion JPEG format, compressed with lower bandwidth usage

Access these settings through Tools → File → Options.

Camera Simulation​

  • View multiple cameras simultaneously: Observe up to eight camera feeds at once.
  • Stream All / Stop All: Quickly start or stop streaming for all cameras at once with convenient control buttons.

Camera Simulation Stream All

Route Configuration (IMX93/95 Users)​

For i.MX93 and i.MX95 platforms, you can load route configuration files to automatically set up camera media links. This feature enables the correct MIPI or GMSL camera connections for your system.

Route Config Button Route Config

To load a route configuration:

  1. Click the route configuration button
  2. Select the appropriate YAML configuration file for your camera setup
  3. Click Activate to apply the configuration

The system will automatically configure the media links based on the selected route configuration file.

See more: Camera Media Route Configuration​

Customize Layout with Drag-and-Drop​

Layout Customization​

Drag panel title bars to reposition interface elements.

Drag Layout

Change Color Theme​

Select theme from Tools → Settings → Appearance (Ocean Blue/Dream Purple/Mountain Green).

Color Theme

Logo Options​

  • Default Logo: TechNexion branding
  • Hide Logo: No logo displayed
  • Custom Text Logo: Enter custom text
  • Custom Image Logo: Upload SVG image file

Configuration​

  • Access: App Settings -> Customize Logo
  • Select logo type
  • For Custom Image Logo: Browse and select file
    • Supported formats: SVG
    • Recommended size: 206×26 pixels (SVG with transparent background)

Custom Logo

Support​

If you encounter any issues with VizionViewer™:

  1. Go to Tools → File
  2. Export VizionViewer™ Log File
  3. Attach the report file
  4. Describe the issue
  5. Send to support.vision@technexion.com