# v4l2h265enc
Source: [https://docs.qualcomm.com/doc/80-70020-50/topic/v4l2h265enc.html](https://docs.qualcomm.com/doc/80-70020-50/topic/v4l2h265enc.html)
The v4l2h265enc plugin uses V4L2 APIs for encoding of video stream.
- The plugin uses the H.265 video encoder to provide hardware accelerated H.265
(MPEG-H Part 2) encoding on supported platforms
- The plugin is based on [GstVideoEncoder](https://gstreamer.freedesktop.org/documentation/video/gstvideoencoder.html?gi-language=c) base class.
## Inheritance chain
[GObject](https://docs.gtk.org/gobject/) → [GstObject](https://gstreamer.freedesktop.org/documentation/gstreamer/gstobject.html?gi-language=c) → [GstElement](https://gstreamer.freedesktop.org/documentation/gstreamer/gstelement.html?gi-language=c) → [GstVideoEncoder](https://gstreamer.freedesktop.org/documentation/video/gstvideoencoder.html?gi-language=c) → GstV4l2VideoEnc →
v4l2h265enc
The following tables provide information on pad templates and element properties of
v4l2h265enc. For use cases, see [Video encode and decode](https://docs.qualcomm.com/doc/80-70020-50/topic/camera-and-video-encode.html) and
[Slice-based encoding](https://docs.qualcomm.com/doc/80-70020-50/topic/camera-and-video-encode.html#slice-based-encoding).
## Pad configuration
| Pad Name | Capabilities | Capabilities | Capabilities |
| --- | --- | --- | --- |
| SINK template: 'sink'
- Availability: Always
- Direction: sink
| video/x-raw | format: | { (string)NV12, (string)NV21 } |
| SINK template: 'sink'
- Availability: Always
- Direction: sink
| video/x-raw | width: | [ 1, 32768 ] |
| SINK template: 'sink'
- Availability: Always
- Direction: sink
| video/x-raw | height: | [ 1, 32768 ] |
| SINK template: 'sink'
- Availability: Always
- Direction: sink
| video/x-raw | framerate: | [ 0/1, 2147483647/1 ] |
| SRC template: 'src'
- Availability: Always
- Direction: source
| video/x-h265 | alignment: | au |
| SRC template: 'src'
- Availability: Always
- Direction: source
| video/x-h265 | stream-format: | byte-stream |
| | | | |
| | | | |
| | | | |
## Element configuration
Table : Element properties of v4l2h265enc
| Property | Description |
| --- | --- |
| capture-io-mode | Capture I/O mode (matches src pad).
- flags: readable, writable
- Enum "GstV4l2IOMode" Default: 0, "auto"
- (0): auto - GST_V4L2_IO_AUTO
- (1): rw - GST_V4L2_IO_RW
- (2): mmap - GST_V4L2_IO_MMAP
- (3): userptr - GST_V4L2_IO_USERPTR
- (4): dmabuf - GST_V4L2_IO_DMABUF
- (5): dmabuf-import - GST_V4L2_IO_DMABUF_IMPORT
|
| device | The device location.
- flags: readable
- String. Default: "/dev/video1"
|
| device-fd | The file descriptor of the device.
- flags: readable
- Integer. Range: ˗1 to 2147483647, default: ˗1
|
| device-name | The name of the device.
- flags: readable
- String. Default: null
|
| extra-controls | The extra v4l2 controls (CIDs) for the device.
- flags: readable, writable
- Boxed pointer of type "GstStructure"
|
| min-force-key-unit-interval | The minimum interval between force-key-unit requests in
nanoseconds.
- flags: readable, writable
- Unsigned Integer64. Range: 0 - 18446744073709551615 Default:
0
|
| name | The name of the object.
- flags: readable, writable, 0x2000
- String. Default: "v4l2h265enc0"
|
| output-io-mode | The output side I/O mode (matches sink pad).
|
| parent | The parent of the object.
- flags: readable, writable, 0x2000
- Object of type "GstObject"
|
| qos | Handle quality-of-service events from downstream.
- flags: readable, writable
- Boolean. Default: true
|
The following table lists the codec controls for H.265. For the general v4l2ctl user
and codec controls, see [Table : v4l2ctl extra-controls–user controls](https://docs.qualcomm.com/doc/80-70020-50/topic/v4l2h264enc.html#v4l2h264enc__table_ss2_ljc_fbc) and [Table : v4l2ctl extra-controls–codec controls](https://docs.qualcomm.com/doc/80-70020-50/topic/v4l2h264enc.html#v4l2h264enc__table_o4d_tjc_fbc).
Table : v4l2ctl–H.265 codec controls
| Control name | Control type | Parameters |
| --- | --- | --- |
| hevc\_minimum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=1; this is the default value
- flags=execute-on-write
|
| hevc\_maximum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=51; this is the default value
- flags=execute-on-write
|
| hevc\_i\_frame\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=20; this is the default value
- flags=execute-on-write
|
| hevc\_p\_frame\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=20; this is the default value
- flags=execute-on-write
|
| hevc\_b\_frame\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=20; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_coding\_type | Menu |
- min=0
- max=1
- value=1 (P)
- 0: B
- 1: P; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_coding\_layer | Integer |
- min=0
- max=5
- step=1
- value=0; this is the default value
- flags=execute-on-write
|
| hevc\_profile | Menu |
- min=0
- max=2
- default=0
- value=0 (Main)
- 0: Main; this is the default value
- 1: Main Still Picture
- 2: Main 10
- flags=execute-on-write
|
| hevc\_level | Menu |
- min=0
- max=7
- value=7 (5)
- 0: 1
- 1: 2
- 2: 2.1
- 3: 3
- 4: 3.1
- 5: 4
- 6: 4.1
- 7: 5; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_lay\_0\_bitrate | Integer |
- min=1
- max=100000000
- step=1
- value=20000000; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_lay\_1\_bitrate | Integer |
- min=1
- max=100000000
- step=1
- default=20000000; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_lay\_2\_bitrate | Integer |
- min=1
- max=100000000
- step=1
- value=20000000; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_lay\_3\_bitrate | Integer |
- min=1
- max=100000000
- step=1
- value=20000000; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_lay\_4\_bitrate | Integer |
- min=1
- max=100000000
- step=1
- value=20000000; this is the default value
- flags=execute-on-write
|
| hevc\_hierarchical\_lay\_5\_bitrate | Integer |
- min=1
- max=100000000
- step=1
- value=20000000; this is the default value
- flags=execute-on-write
|
| hevc\_i\_frame\_minimum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=1; this is the default value
- flags=execute-on-write
|
| hevc\_i\_frame\_maximum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=51; this is the default value
- flags=execute-on-write
|
| hevc\_p\_frame\_minimum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=1; this is the default value
- flags=execute-on-write
|
| hevc\_p\_frame\_maximum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=51; this is the default value
- flags=execute-on-write
|
| hevc\_b\_frame\_minimum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=1; this is the default value
- flags=execute-on-write
|
| hevc\_b\_frame\_maximum\_qp\_value | Integer |
- min=1
- max=51
- step=1
- value=51; this is the default value
- flags=execute-on-write
|
**Parent Topic:** [Configure display, camera, encode and decode plugins](https://docs.qualcomm.com/doc/80-70020-50/topic/display-plugins.html)
Last Published: Jan 30, 2026
[Previous Topic
v4l2h264enc](https://docs.qualcomm.com/bundle/publicresource/80-70020-50/topics/v4l2h264enc.md) [Next Topic
v4l2vp9dec](https://docs.qualcomm.com/bundle/publicresource/80-70020-50/topics/v4l2vp9dec.md)