videnc
Tip
Starting release 1.5, you can specify a comma-separated list of IDs as well as a range of IDs for the operation, for example, viden
c 3,2,0 start
or videnc 3-0 stop
.
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 or all. As of Makito X4 v1.5 and Makito X1 v1.2, you can specify a range or a comma-separated list of IDs for the operation, as shown in the examples that follow.
The number of encoders varies with the hardware platform: the Makito X4 offers eight encoding cores (encoder IDs 0 - 7), while the Makito X4 Single Channel and the Makito X1 offer two encoding cores (encoder IDs 0 - 1).
Synopsis
videnc ID start |
Actions
Action | Description |
---|---|
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 |
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 usevidenc all get table .
videnc get stats also provides a percentage of scaling resources used on a per encoder basis. |
clear | Clears the encoder’s statistics. |
reset | Resets the encoder. |
help | Displays usage information for the videnc command. |
Parameters*
*Assumes encoder Personality is SDI unless otherwise indicated.
Parameter | Default | Description/Values |
---|---|---|
algorithm | H265 | The codec algorithm for the encoder:
|
input | ||
SDI | BNC1 | The Video Input port for the encoder:
|
ST 2110 | 1 | The Video Input essence for the encoder:
|
ancinput | 1 | (ST 2110 input only) The Ancillary Data essence for the encoder:
|
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:
|
countmode | SMPTE12M-1 | (TimeCode Source must be System) Selects the TimeCode Counting Mode:
|
dailyresync | On | ( Note
|
resynchour | 0 (midnight) | (dailyresync must be enabled) Specifies the time for the resync to occur (ranging from 00:00 (midnight) to 23:00). |
| Auto | Specifies the aspect ratio of the video source and signals it into the MPEG stream:
|
dynamicrange | Auto-Detect | (10-bit chromasubsampling must be selected) Select to configure the encoder to detect the inbound High Dynamic Range (HDR) transfer function signaling and forward that information within the encoded stream.
|
| 6000 kbps | The Video Raw Elementary Stream bitrate (kbps). Range: |
| Scale | ( |
| 120 | The Group of Pictures size for the encoded video. Range: Note For intra-refresh mode, the GOP size is the number of frames between the sequence and picture parameter set NAL transmission. |
| IP | The GOP structure (i.e., video compression mode) for the encoded video: (See “Framing” under Video Encoder Settings)
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. |
profile | Select the application profile class for the encoder:
| |
skipframes | Off | ( |
picrate | Auto | The video frame rate per second:
|
intrarefresh | Off | This parameter enables Intra-refresh video encoding support in order to minimize latency, smooth the video bitrate, and minimize GOP pulsing artifacts. |
slices | 1 | Configures the encoder to use multiple slices per frame instead of the normal 1 slice per frame encoder configuration. Encoding latency is improved since encoded slices can be transmitted on the network without having to wait for the whole frame to be encoded. 1..11 Note Latency improvements are only seen on decoders that do not buffer entire video frames before decoding and can actually decode and output slices. Multiple slices cannot be used in conjunction with skipframes or gopstructure, i.e., Framing containing B-frames (IBP, .... IBBBBP). |
| Off | This parameter enables Closed Captioning on the encoder stream. |
| Select the Chroma Subsampling for the encoder:
| |
| CBR | Select the Rate Control for the encoder:
|
| (Rate Control must be VBR) Enter the maximum video bitrate for the encoder: Note
| |
| 50 ms. | Offset video timestamps by this value in ms. Range: -1000..1000 |
| Auto | Specifies the stream output resolution (i.e., the number of lines per frame and pixels per line to be encoded). Options depend on the Input Format detected.
|
Examples
# videnc 0,2,3 start Starts video encoders 0, 2 and 3. You will receive the following confirmation: 3 video encoders started successfully. |
# videnc 0,2,4-6 stop Stops video encoders 0, 2, 4, 5 and 6 5 video encoders stopped successfully. |
# videnc 0 set gopsize=120 Sets the video GOP to 120. Encoder configured successfully. |
# videnc 4-7 set gopsize=60 Sets the GOP to 60 for video encoders 4, 5, 6, and 7. 4 video encoders configured successfully. |
# videnc 0 set bitrate=6000 Sets the video bitrate to 6000. |
# videnc 0 set bitrate=6000 gopsize=120 resolution=1280x720 Input=BNC-1 Combines multiple video parameters in a single line. |
# videnc 0 get Returns video configuration information for the encoder: Encoder ID : 0 Configuration: |
# videnc 0 get stats Returns encoder statistics: Encoder ID : 0 |