<commit_before>
# Decoding Sample

## Overview

**Decoding Sample** works with **Intel® Media SDK** \(hereinafter referred to as "**SDK**"\).

It demonstrates how to use the **SDK** API to create a sample console application that performs decoding of various video compression formats.

The sample is able to work with **HEVC Decoder & Encoder** \(hereinafter referred to as "**HEVC**"\).

**Note:** To run HEVC, please read the instructions in the “HEVC Plugin” section carefully.

## Features

**Decoding Sample** supports the following video formats:

|Format type| |
|---|---|
| input \(compressed\) | H.264 \(AVC, MVC – Multi-View Coding\), MPEG-2 video, VC-1, JPEG\*/Motion JPEG, HEVC \(High Efficiency Video Coding\), VP8 |
| output \(uncompressed\) | YUV420 |

**Note 2: Decoding Sample** renders the decoded video stream to a file in YUV 4:2:0 sampling format, with the color planes Y, U and V in that order.

## Hardware Requirements

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

## Software Requirements

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

## How to Build the Application

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

## Running the Software

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

The executable file requires the following command-line switches to function properly:

| Option | Description |
|---|---|
| h265\|h264\|mpeg2\|vc1\|vp8\|mvc\|jpeg |Input video type. This is an elementary video stream. The use of option h265 is possible only if corresponding plugins are installed. |
| -i <InputFile\> | Input \(compressed\) video file, name and path. |
| -o <Output\> | Specifies output \(YUV\) video file\(s\), name and path. With MVC, specify the file name without extension to use as a pattern. The sample creates several output files with names such as “filename\_N.yuv” according to the number of views in the MVC stream. |

The following command-line switches are optional:

| Option | Description|
|---|---|
 | [-?]| print help|
  | [-hw]| use platform specific SDK implementation (default)|
 | [-sw] | use software implementation, if not specified platform specific SDK implementation is used|
   |[-p plugin] | decoder plugin. Supported values: hevcd_sw, hevcd_hw, vp8d_hw, vp9d_hw, camera_hw, capture_hw|
  | [-path path]| path to plugin (valid only in pair with -p option) (optional for Media SDK in-box plugins, required for user-decoder ones)|
 |  [-f]| rendering framerate|
  | [-w]| output width|
  | [-h]| output height|
   |[-di bob/adi] | enable deinterlacing BOB/ADI|
 |  [-d]| enable decode error report|
   |[-jpeg_rgb] |RGB Chroma Type|
   |[-device /path/to/device]| set graphics device for processing. For example: `-device /dev/dri/renderD128`. If not specified, defaults to the first Intel device found on the system. |
|Output format parameters:||
 |  [-i420] | pipeline output format: NV12, output file format: I420|
  | [-nv12] | pipeline output format: NV12, output file format: NV12|
 |  [-yuy2] | pipeline output format: YUV2, output file format: YUV2|
 |  [-uyvy]|pipeline output format: UYVY, output file format: UYVY|
  | [-rgb4]| pipeline output format: RGB4, output file format: RGB4|
  | [-rgb4_fcr] | pipeline output format: RGB4 in full color range, output file format: RGB4 in full color range|
  | [-p010] | pipeline output format: P010, output file format: P010|
  | [-a2rgb10] | pipeline output format: A2RGB10, output file format: A2RGB10|<commit_msg>Added av1 to sample_decode documentation<commit_after>
# Decoding Sample

## Overview

**Decoding Sample** works with **Intel® Media SDK** \(hereinafter referred to as "**SDK**"\).

It demonstrates how to use the **SDK** API to create a sample console application that performs decoding of various video compression formats.

The sample is able to work with **HEVC Decoder & Encoder** \(hereinafter referred to as "**HEVC**"\).

**Note:** To run HEVC, please read the instructions in the “HEVC Plugin” section carefully.

## Features

**Decoding Sample** supports the following video formats:

|Format type| |
|---|---|
| input \(compressed\) | H.264 \(AVC, MVC – Multi-View Coding\), MPEG-2 video, VC-1, JPEG\*/Motion JPEG, HEVC \(High Efficiency Video Coding\), VP8, AV1 |
| output \(uncompressed\) | YUV420 |

**Note 2: Decoding Sample** renders the decoded video stream to a file in YUV 4:2:0 sampling format, with the color planes Y, U and V in that order.

## Hardware Requirements

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

## Software Requirements

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

## How to Build the Application

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

## Running the Software

See [`<install-folder>/Media_Samples_Guide_Linux.md`](./Media_Samples_Guide_Linux.md).

The executable file requires the following command-line switches to function properly:

| Option | Description |
|---|---|
| h265\|h264\|mpeg2\|vc1\|vp8\|mvc\|jpeg\|av1 |Input video type. This is an elementary video stream. The use of option h265 is possible only if corresponding plugins are installed. |
| -i <InputFile\> | Input \(compressed\) video file, name and path. |
| -o <Output\> | Specifies output \(YUV\) video file\(s\), name and path. With MVC, specify the file name without extension to use as a pattern. The sample creates several output files with names such as “filename\_N.yuv” according to the number of views in the MVC stream. |

The following command-line switches are optional:

| Option | Description|
|---|---|
 | [-?]| print help|
  | [-hw]| use platform specific SDK implementation (default)|
 | [-sw] | use software implementation, if not specified platform specific SDK implementation is used|
   |[-p plugin] | decoder plugin. Supported values: hevcd_sw, hevcd_hw, vp8d_hw, vp9d_hw, camera_hw, capture_hw|
  | [-path path]| path to plugin (valid only in pair with -p option) (optional for Media SDK in-box plugins, required for user-decoder ones)|
 |  [-f]| rendering framerate|
  | [-w]| output width|
  | [-h]| output height|
   |[-di bob/adi] | enable deinterlacing BOB/ADI|
 |  [-d]| enable decode error report|
   |[-jpeg_rgb] |RGB Chroma Type|
   |[-device /path/to/device]| set graphics device for processing. For example: `-device /dev/dri/renderD128`. If not specified, defaults to the first Intel device found on the system. |
|Output format parameters:||
 |  [-i420] | pipeline output format: NV12, output file format: I420|
  | [-nv12] | pipeline output format: NV12, output file format: NV12|
 |  [-yuy2] | pipeline output format: YUV2, output file format: YUV2|
 |  [-uyvy]|pipeline output format: UYVY, output file format: UYVY|
  | [-rgb4]| pipeline output format: RGB4, output file format: RGB4|
  | [-rgb4_fcr] | pipeline output format: RGB4 in full color range, output file format: RGB4 in full color range|
  | [-p010] | pipeline output format: P010, output file format: P010|
  | [-a2rgb10] | pipeline output format: A2RGB10, output file format: A2RGB10|
{'fraction_non_alphanumeric': 0.1263318112633181, 'fraction_numerical': 0.020063650200636503, 'mean_word_length': 4.2797662527392255, 'pattern_counts': {'":': 0, '<': 15, '<?xml version=': 0, '>': 15, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3726710', 'n_tokens_mistral': 2362, 'n_tokens_neox': 2164, 'n_words': 862}