Skip to main content

videnc

The videnc command is used to manage video encoding parameters. The videnc start and videnc stop commands can be used to start and stop encoding of the video input. ID is either the encoder ID (0, 1, 2, or 3) or all. On Makito X HEVC units, the HEVC encoder uses ID 4 and 5.

Synopsis

videnc ID start
videnc ID stop
videnc ID set parameter=value [parameter=value...]
videnc ID get [config, stats, all]
videnc ID clear
videnc ID reset

Actions

ActionDescription

start

Activates encoding of the video input.

stop

Stops (mutes) encoding of the video input.

set

Configures encoder video parameters. A series of one or more parameter=value pairs can be specified at once. See 74356209 below.

get

Displays encoder video status information. You can specify to display the configuration (config), stats, or all.

Tip

To display a summary of all the encoders in a table format, you can use videnc all get table.

clear

Clears the encoder’s statistics.

reset

Resets the encoder.

help

Displays usage information for the videnc command.

Parameters

ParameterDefaultDescription/Values

input


(SDI Dual-BNC only) The Video Input port for the encoder:

  • BNC1
  • BNC2

timecode

None

Timecodes are used to mark video frames, mainly for editing purposes. This field either disables timecoding, or selects the source to “timecode” the encoded video frame. The following selections are available:

  • None: No time code will be inserted in the video stream (saves bandwidth if not required).
  • Video: (SDI only) The timecode will be extracted from the incoming video signal.
  • System: If no timecode is included in the video feed, the encoded timecode is based on the encoder’s system clock. In this case, it is a good idea to enable NTP (see Configuring Network Settings).

Note

See TimeCode Source for currently supported TimeCode features.

aspectratio

Auto

Specifies the aspect ratio of the video source and signals it into the MPEG stream:

  • Auto: Aspect ratio is derived from the incoming video source resolution.
  • 3:2, 4:3, 5:3, 5:4, 16:9, 16:10, 17:9: Forces aspect ratio to specified value.
  • WSS/AFD: Extracts aspect ratio from incoming video source based on WSS (Wide Screen Signaling) or AFD (Active Format Description) if detected.

Note

WSS is only supported with analog PAL video; AFD is only supported with SDSDI video.

bitrate

6000 kbps

The Video Raw Elementary Stream bitrate (kbps):

Range: 32-25000

resizemode

Scale

By default, input is scaled to the output resolution.

  • Scale: Input is scaled to output resolution.
  • Crop: This setting crops the input and encodes to a rectangle within the input image (at the center of the image) while discarding the rest of the input image. The output resolution is the portion of the input that is encoded from the center. This may be done instead of downscaling.

Note

Cropping is disabled if resolution is set to Auto, 960, or 1440, or if (output) resolution is set to equal or larger than the input resolution.

gopsize

120

The Group of Pictures size for the encoded video.Range: 1-1000

Note

For intra-refresh mode, the GOP size is the number of frames between the sequence and picture parameter set NAL transmission.


gopstructure

IP

The GOP structure for the encoded video: (See “Framing” in Video Encoder Settings)

  • I: I frames only (lowest delay; lowest quality)
  • IP: I and P frames only
  • IBP: I, B and P frames (H.264 only)
  • IBBP: I, BB (two B frames in sequence) and P frames (highest delay; highest quality) (H.264 only)

Note

B frames require a Main Profile decoder.


B frames provide more quality as the encoding is more efficient; thus more details can be rendered in the same bandwidth/bitrate.

Tip

When B frames are used, the GOP may be rounded up to make the sequence end with a P frame.

entropycoding

CAVLC

Select the compression scheme:

  • CAVLC: Context-adaptive Variable-length Coding is a lower-complexity alternative to CABAC. CAVLC produces lower quality, but is easier to decode.
  • CABAC: Context-adaptive Binary Arithmetic Coding is an algorithm to losslessly compress syntax elements in the video stream. CABAC compresses data more efficiently than CAVLC and should produce better quality, but requires considerably more processing to decode.

Note

The H.264 decoder must be Main Profile compliant or higher to decode a CABAC video stream.

Tip

Generally, you get better visual quality if you are using CABAC because it is more efficient.

partitioning

Off

Enables (on) or disables (off) Intra-Picture SubPartitioning. Intra-Partitioning is a setting that allows the use of a sub-macroblock partition called the “Intra8x8 block” with all the intra-prediction modes associated with it.

Note

Intra-Partitioning requires that the H.264 decoder be High Profile compliant.


Generally, you get better visual quality if you enable Intra-Partitioning because it gives the video encoder better coding tools.

Tip

Noisy Matrix completion is enabled automatically when Partitioning is enabled and video bitrate is under 800 Kbps. Noisy Matrix completion enhances video image “noise” reduction to improve video quality at lower bitrates and make blocky artifacts less visible.

intrarefresh

Off

Enables (on) or disables (off) Intra-refresh video encoding support. Intra-refresh is a video encoding mode of operation in which no distinct IDR frame is sent in the video elementary stream. Instead, the macro-blocks that make up the IDR frame are sent gradually within a certain time so that the entire video reference frame is re-built (at the decoder) within the number of frames specified by the refreshrate parameter. Intrarefresh minimizes latency, smooths the video bitrate, and minimizes GOP pulsing artifacts.

Tip

Intra-refresh requires that the decoder and streams be started first.


refreshrate

60

Specifies the number of frames over which the entire picture is refreshed. Range: 1-5000

Note

If the refresh rate is set too low, a left-to-right wave-like artifact may result.

skipframes

Off

This parameter permits the dropping of frames to improve video quality at lower bitrates. Off, On For more information, see Partial Image Skip under Video Encoder Settings.

picrate

Auto

The video frame rate per second:

  • Auto: Encodes at the same frame rate as the input
  • Range: 1-60

closedcaption

Off

This parameter enables Closed Captioning on the encoder stream. Off, On

Note

For more information, see Closed Captioning.

ptsoffset

50 ms.

Offset video timestamps by this value in ms. Range: -1000–1000

resolution

Auto

The stream output resolution. Specifies the number of lines per frame and pixels per line to be encoded. Options depend on the Input Format detected.

  • Auto (output resolution is the same as the input)
  • 1080p, 1920x1080p
  • 1080i, 1920x1080i
  • 1440x1080p
  • 1440x1080i
  • 960x1080p
  • 960x1080i
  • 720p, 1280x720
  • 960x720
  • 640x720
  • 480p, 720x480p
  • 480i, 720x480i
  • 576p, 720x576p
  • 576i, 720x576i
  • 540x480p
  • 540x480
  • 704x576p
  • 704x576i
  • 540x576p
  • 540x576i
  • 352x480p
  • 352x480i
  • 352x576p
  • 352x576i
  • 352x288p
  • 352x288i

RGB


  • WUXGA, 1900x1200
  • UXGA, 1600x1200
  • WSXGA, 1680x1050
  • HD+, 1600x900
  • SXGA+, 1400x1050
  • WXGA+, 1440x900
    1360x768
  • SXGA, 1280x1024
  • WXGA, 1280x768
  • XGA, 1024x768
  • SVGA, 800x600
  • VGA, 640x480

Note

See Video Encoding.

Examples

# videnc 0 set gopsize=120

Sets the video GOP to 120. You will receive the following confirmation:

Encoder configured successfully.

# videnc 0 set bitrate=6000

Sets the video bitrate to 6000.

# videnc 0 set bitrate=6000 gopsize=120 resolution=1280x720 Input=BNC1

Combines multiple video parameters in a single line.

# videnc 0 get

Returns video configuration information for the encoder:

Encoder ID                : 0
Name : "HD Video Encoder 0"
Configuration :
Video Input : BNC-1
Video Format : Auto-Detect
Aspect Ratio : Auto-Detect
Time Code : VIDEO
Video Bitrate : 6000 kbps
Video GOP Size : 120
Encoded Picture Rate : Input/Auto
Output Resolution : Input/Auto
Closed Captioning : Off
Video GOP Structure : IP
Video Entropy Coding : CAVLC
Picture Partitioning : Off
Intra Refresh : On
Refresh Rate : 60
# videnc 0 get stats

Returns encoder statistics:

Encoder ID                : 0
Name : "HD Video Encoder 0"
Statistics :
State : WORKING
Uptime : 21h8m28s
Input Present : Yes
Input Type : SDI
Input Format : 1280x720p59
Output Resolution : 1280x720p
Input Aspect Ratio : 16:9
  Encoded Frames           : 2,148,020
Encoded Bytes : 2,326,715,604
Encoded Frame Rate : 30
Dropped Frames : 2
Encoded Bitrate : 5,994 kbps
Encoder Resets : 2
Encoder PTS : 0x1708c8ce8
Encoder Load : 14%
Closed Captioning          : Disabled
Timecode Source : SYSTEM
Timecode : 20:18:48:07
Source Switches : 5
UTC : 1386188328244254 (2013-Dec-4-
20h18m48s244254us)
H.264 Profile : Main
H.264 Level : 4


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.