# 2D Video

A 2D Video is a video input that is displayed on a floating flat video surface in 3D space. The 2D Video entity has multiple different inputs that it can take as its video source, these are described in [Video Inputs](video-inputs.md).

The 2D Video’s biggest use is together with the [Output Alignment](entity-output-alignment.md) entity where it could be used to layout multiple 2D videos in the output texture. Another powerful way of using 2D Videos is to capture a computer’s display and show that. This is useful for presentations, games, and tutorials.

2D Videos are added to the scene graph like all other entities. The input is opened the same way inputs are opened in a Stitched Video entity.

![2d video](_images/2d-video.png)

Figure 1. The settings UI for 2D Videos.

## Settings

There are multiple different settings for 2D videos, some will be described here while others have their own chapters.

### Visible In Eye

Sets which eye or eyes in an HMD that the 2D Video should be visible for. In tab _Project Setting_, you can set which eye the 3D viewport should show.

### Curvature

The 2D video is flat by default, but curvature can be added to it. The curvature goes from -1 - 1 where 0 is flat.

Subdivisions

When the curvature is not 0, there will appear another setting which is subdivisions. Subdivisions set how many planes will be used to create the curvature. Smother curvature requires more subdivisions but will require more computing power.

### Stereo Mode

Stereo mode can be enabled to allow stereoscopic video inputs that are split horizontally or vertically.

Use Eye

**Use Eye** gives the user the choice to set which eye should be visible in the 3D viewport. This setting is only shown if **Stereo Mode** is not set to **Mono**.

### Anti-Aliasing

Anti-aliasing is a filter that can be added to make the edges of the 2D video smoother.

### Border

A border can be added to the 2D video by enabling the setting **Border**.

![2d video border](_images/2d-video-border.png)

Figure 2. The setting UI for 2D Videos border.

### View Fixed

View fixed is a tool for placing a 2D Video in the view space of the screen. This means that the video is in that pixel position even if the viewport camera moves. This is useful if you want a video that is always shown to the user regardless of their orientation in 3D.

Your browser does not support the video tag.

The position of the 2D video can either be set by pixel position or by percentage. The aspect ratio is locked by default but could be disabled by unchecking the setting **Lock Aspect**.

![2d video view fixed](_images/2d-video-view-fixed.png)

Figure 3. The setting UI for 2D videos view fixed.

### Color

Color is described in [Color Handling](colors.md).

### Chroma Key

Chroma Key is described in [Chroma Key](chroma-keyer.md).

### Matte Key

Matte Key is described in [Matte Key](matte-key.md).

### Input

Input is described in [Video Inputs](video-inputs.md).

## Focus region

2D videos have another function which is the focus region. Focus region is a technique where the 2D Video only consists of a small part of another video stream. This is useful if you only want to send a certain part of an image, but its greatest use is together with [Output Alignment](entity-output-alignment.md).

Two 2D videos are children to an [Output Alignment](entity-output-alignment.md) entity where one of them has input source and the second 2D Video will have its input as a clone stream from the first 2D Video. When enabling the focus region, all information about where the slice of the original image is taken from is streamed to the Player. If we send the original image in lower resolution while sending the focus region in its full resolution the Player can combine these two images, with a resulting image that is blurry in some regions and crystal clear in some, as in the figure below.

![2d video focus region example](_images/2d-video-focus-region-example.png)

Figure 4. Focus region example where most of the image is blurry while the bottom left is in high resolution.

Focus region is easy to use and is only two settings as seen in the figure below. One of the settings is **Focus Center** which is where the center of the focus region area will be located in the original image. These values are clamped so the focus region can never go outside of the image. The **Focus Center** values can be controlled from a plugin.

The second setting is **Focus Size** which is how large the focus region should be, this cannot be changed during runtime without inspecting the layout in the [Output Alignment](entity-output-alignment.md).

![2d video focus region](_images/2d-video-focus-region.png)

Figure 5. The UI enabling the focus region option.