hevc_tool

Author:
Armin Trattnig
Version:
1.0
Includes:
"TLibDecoder/TDecEntropy.h"
"MP4Movies.h"
"MP4Atoms.h"
"Options.h"
"isoiff.h"
"isoiff_hevc.h"

Introduction

Provides ISO Image File Format functions, that will work with HEVC bitstream (generated by HM)

Updated:
Friday, December 05, 2014


Functions

addHEVCImageToCollection
createHEVC_ImageCollection
getHEVCBitstreamFromImage
getHEVCImages
processHEVC_NALUnits

addHEVCImageToCollection


MP4Err addHEVCImageToCollection (
    ISOIFF_ImageCollection collection,
    ISOIFF_HEVCDecoderConfigRecord record,
    ISOIFF_HEVCItemData itemData,
    u32 width,
    u32 height);  
Parameters
collection

The image collection the provided HEVC image will be added to *

record

The decoder configuration record (use processHEVC_NALUnits to fill with data) *

itemData

The HEVC Item (image) data (use processHEVC_NALUnits to fill with data) *

width

The image width *

height

The image height

Discussion

Will add an HEVC image item to the provided collection. The decoder configuration record will be linked to the image. NOTE: Before calling this function, create the image collection and generate the record and itemData using processHEVC_NALUnits *


createHEVC_ImageCollection


Parameters
collection

Pointer to an ISOIFF_ImageCollection

Discussion

Creates an ISOIFF_ImageCollection with handler type 'hevc'


getHEVCBitstreamFromImage


MP4Err getHEVCBitstreamFromImage (
    ISOIFF_Image image,
    ISOIFF_HEVCDecoderConfigRecord decoderConfig,
    MP4Handle bitstreamH);  
Parameters
image

HEVC Image

decoderConfig

Decoder Configuration Record (Contains VPS, SPS, PPS)

bitstreamH

Handle that will contain the bitstream data

Discussion

Restores the HEVC bitstream from an HEVC image.


getHEVCImages


MP4Err getHEVCImages (
    ISOIFF_ImageCollection collection,
    ISOIFF_Image **images,
    ISOIFF_HEVCDecoderConfigRecord **decoderConfigs,
    u32 *numberOfImagesFound);  
Parameters
collection

The image collection that will be searched for HEVC images *

images

Returning array with all HEVC images found *

decoderConfigs

Returning array of decoder configuration records, that belong to the image of the same array index *

numberOfImagesFound

The number of images found

Discussion

Collects all HEVC Images from a image collection and provides the results in form of arrays. The corresponding decoder configuration record of an image can be found in the decoderConfigs array with the same index. *


processHEVC_NALUnits


Parameters
record

ISOIFF_HEVCDecoderConfigRecord must be created before calling this function *

itemData

ISOIFF_HEVCItemData must be created before calling this function *

options

Pointer to Options for the input file path

Discussion

Will read bytes from the option's inputFile and will parse the NAL Units and creating contents of the ISOIFF_HEVCDecoderConfigRecord and the ISOIFF_HEVCItemData for a single HEVC still image. *