You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
close
You are viewing the article in preview mode. It is not live at the moment.
Support will be closed on January 19th in observance of Martin Luther King Jr. Day.
Home > Video Wall > Mosaic Video Wall with MaxColor, Ultra, or Omega Series Devices
Mosaic Video Wall with MaxColor, Ultra, or Omega Series Devices
print icon

Overview

A Mosaic Video Wall allows displays of different sizes and positions to show different portions of a single video source. All displays must be mounted in either landscape or portrait orientation and may be rotated in 90° increments.

Each display acts as a window into a larger virtual image called the Canvas. Every Receiver crops and positions its own view of that Canvas based on physical measurements.

Mosaic Video Walls are supported on all MaxColor, Ultra, and Omega Series Receivers and require no external video wall processor.

Quick Start (Experienced Technicians)

  1. Mount all displays
  2. Measure the overall Canvas
  3. Measure each display’s viewable area and position
  4. Decide how content should align within the Canvas
  5. Send one vw mosaic command to each Receiver

If seams do not line up, the issue is almost always display scaling, source format, or measurement accuracy — not the command.

Requirements

  • One Receiver per display
  • All displays rotated in 0°, 90°, 180°, or 270°
  • justOS firmware B1.2.1 or later
  • Static IPs and Telnet access (port 23)

Core Concept: Canvas vs Displays

Think of the system as one large image (Canvas) viewed through multiple smaller cutouts (Displays).

  • The Canvas defines the total video area
  • Each display defines what portion of that Canvas it shows
  • Receivers do not scale independently — they crop and position

Download Spreadsheet Assistant

This Excel spreadsheet assists with programming the displays in the Mosaic Video Wall. Make a measurement, enter it in the spreadsheet, and it will provide the command to be sent to each Receiver.

Content Alignment (Critical Decision)

Most video content is produced at a 16:9 aspect ratio. Mosaic Video Walls often are not. Alignment determines how the video is handled when the Canvas does not match the source.

If alignment is not specified, the system defaults to Center.

Alignment Modifier (-a)

Use the -a modifier to control how the video is positioned within the Canvas.

  • center (default) — Centers the content within the Canvas
  • fit — Scales and distorts the image to fill the Canvas
  • tl — Lock to top-left corner
  • tc — Lock to top-center side
  • tr — Lock to top-right corner
  • cl — Lock to center-left side
  • cr — Lock to center-right side
  • bl — Lock to bottom-left corner
  • bc — Lock to bottom-center side
  • br — Lock to bottom-right corner

Left Img. - Center | Right Img. - Fit

Best practice: Start with center. Only use fit when content distortion is acceptable or expected.

Measure the Wall

All measurements may be taken in any unit (inches, millimeters, centimeters), as long as the same unit is used consistently throughout the wall.

Measurements are based on viewable pixels only. Do not include bezels, frames, or mounting hardware.

Step 1: Measure the Canvas

The Canvas represents the total video area across all displays. It defines the coordinate space that every Receiver references.

  • Canvas Width (CW)
    Measure from the left-most viewable pixel of the left-most display to the right-most viewable pixel of the right-most display. Display frames and bezels are not included.
  • Canvas Height (CH)
    Measure from the top-most viewable pixel of the highest display to the bottom-most viewable pixel of the lowest display.

Step 2: Measure Each Display’s Viewable Area

Each display’s viewable area defines how large its window into the Canvas will be. Rotation does not change how these measurements are taken.

  • Viewable Width (VW)
    Measure the horizontal distance between the first and last visible pixels on the display, regardless of rotation.
  • Viewable Height (VH)
    Measure the vertical distance between the first and last visible pixels on the display, regardless of rotation.

Step 3: Measure Display Position (Offsets)

Offsets define where each display is located within the Canvas. These values determine which portion of the source image the Receiver shows.

  • Left Offset (LO)
    Measure from the left edge of the Canvas to the left-most viewable pixel of the display.
  • Top Offset (TO)
    Measure from the top edge of the Canvas to the top-most viewable pixel of the display.

Step 4: Record Display Rotation

Rotation tells the Receiver how the physical display is mounted. Only right-angle rotations are supported for Mosaic Video Walls.

  • ROT — 0°, 90°, 180°, or 270°

Important: Rotation does not change how VW, VH, LO, or TO are measured. Always measure in physical screen space, not perceived orientation.

Program the Receivers

Command template:

vw mosaic -c w:CW,h:CH -v w:VW,h:VH -o l:LO,t:TO -r ROT -a ALIGN

Example:

vw mosaic -c w:500,h:300 -v w:160,h:90 -o l:10,t:100 -r 180 -a center

The command syntax is identical across Maxcolor, Ultra, or Omega Series Receivers.

Troubleshooting

  • Disable all display scaling, zoom, and overscan
  • Use progressive sources only (720p, 1080p, 2160p)
  • Re-check offsets and viewable measurements

Further troubleshooting steps are available here.

scroll to top icon