vision.DeployableVideoPlayer

Display video

Description

The DeployableVideoPlayer object displays video frames. This player is capable of displaying high definition video at high frame rates. This video player object supports C code generation.

Note

Starting in R2016b, instead of using the step method to perform the operation defined by the System object™, you can call the object with arguments, as if it were a function. For example, y = step(obj,x) and y = obj(x) perform equivalent operations.

Creation

Syntax

depVideoPlayer = vision.DeployableVideoPlayer
depVideoPlayer = vision.DeployableVideoPlayer(Name,Value)

Description

depVideoPlayer = vision.DeployableVideoPlayer returns a video player depVideoPlayer, for displaying video frames. This object, unlike the vision.VideoPlayer object, can generate C code.

depVideoPlayer = vision.DeployableVideoPlayer(Name,Value) sets properties using one or more name-value pairs. Enclose each property name in quotes. For example, depVideoPlayer = vision.DeployableVideoPlayer('Name','Caption title')

Properties

expand all

Location of bottom left corner of video frame, specified as a two-element vector. The first and second elements are specified in pixels and represent the horizontal and vertical coordinates respectively. The coordinates [0 0] represent the bottom left corner of the screen. The default location depends on the screen resolution, and will result in a window positioned in the center of the screen.

Video window title bar caption, specified as the comma-separated pair consisting of 'Name' and a character vector.

Size of video display window, specified as the comma-separated pair consisting of 'Size' and Full-screen, True size (1:1) or Custom. When this property is set to Full-screen, use the Esc key to exit out of full-screen mode.

Custom size for video player window, specified as the comma-separated pair consisting of 'CustomSize' and a two-element vector. The first and second elements are specified in pixels and represent the horizontal and vertical components respectively. The video data will be resized to fit the window. This property applies when you set the Size property to Custom.

Color format of input signal, specified as the comma-separated pair consisting of 'InputColorFormat' and 'RGB' or 'YCbCr 4:2:2'. The number of columns in the Cb and Cr components must be half the number of columns in Y.

Usage

For versions earlier than R2016b, use the step function to run the System object algorithm. The arguments to step are the object you created, followed by the arguments shown in this section.

For example, y = step(obj,x) and y = obj(x) perform equivalent operations.

Syntax

depVideoPlayer(videoFrame)
depVideoPlayer(videoFrame,Y,Cb,Cr)

Description

example

depVideoPlayer(videoFrame) displays one grayscale or truecolor RGB video frame in the video player.

depVideoPlayer(videoFrame,Y,Cb,Cr) displays one frame of YCbCr 4:2:2 video in the color components Y, Cb, and Cr when you set the InputColorFormat property to YCbCr 4:2:2. The number of columns in the Cb and Cr components must be half the number of columns in the Y component.

Input Arguments

expand all

Video frame, specified as a truecolor or 2-D grayscale image.

YCbCr color format, returned in the YCbCr 4:2:2 format.

Object Functions

To use an object function, specify the System object as the first input argument. For example, to release system resources of a System object named obj, use this syntax:

release(obj)

expand all

isOpenVisible or hidden status for player
stepRun System object algorithm
releaseRelease resources and allow changes to System object property values and input characteristics
resetReset internal states of System object

Examples

expand all

Set up System objects to read and view a video file.

videoFReader   = vision.VideoFileReader('atrium.mp4');
depVideoPlayer = vision.DeployableVideoPlayer;

Continue to read frames of video until the last frame is read. Exit the loop if user closes the video player window.

cont = ~isDone(videoFReader);
  while cont
    videoFrame = videoFReader();
    depVideoPlayer(videoFrame);
    cont = ~isDone(videoFReader) && isOpen(depVideoPlayer);
  end

Release System objects.

release(videoFReader);
release(depVideoPlayer);

Extended Capabilities

Introduced in R2012a