How dolbylaboratories/dolby-encoding-engine works
This repository provides Dolby Encoding Engine integration plugins: HEVC encoders, image transformation, and JPEG 2000, TIFF, PCM watermarking, and ProRes decoder/plugin APIs. The user-facing workflow is DEE invoking a plugin through its C API to configure it, process frames, and retrieve outputs or status. Sampled implementation details chiefly cover Beamr/x265 encoding and Kakadu/libtiff decoding; other capabilities are retained from the tree and APIs, with uncertain internal wiring omitted.
Main entry points: plugins_common.h Common types · hevc_enc_beamr_impl.cpp Beamr encoder · hevc_enc_api.h HEVC API · hevc_enc_beamr.cpp Beamr adapter
Components 18
Plugin contracts
- Common types
plugins/code/common/Common/plugins_common.h - HEVC API
plugins/code/api/hevc_enc/hevc_enc_api.h - Transformer API
plugins/code/api/image_transformer/image_transformer_api.h - JPEG 2000 API
plugins/code/api/j2k_dec/j2k_dec_api.h - TIFF API
plugins/code/api/tiff_dec/tiff_dec_api.h - PCM watermark API
plugins/code/api/pcm_watermarker/pcm_watermarker_api.h - ProRes API
plugins/code/api/prores_dec/prores_dec_api.h
HEVC encoding
- Beamr adapter
plugins/code/hevc_enc/beamr/src/hevc_enc_beamr.cpp - Beamr encoder
plugins/code/hevc_enc/beamr/src/hevc_enc_beamr_impl.cpp - Beamr utilities
plugins/code/hevc_enc/beamr/src/hevc_enc_beamr_utils.cpp - x265 adapter
plugins/code/hevc_enc/x265/src/hevc_enc_x265.cpp - x265 utilities
plugins/code/hevc_enc/x265/src/hevc_enc_x265_utils.cpp
Image and decoding
- Dummy transformer
plugins/code/image_transformer/dummy/src/image_transformer_dummy.cpp - Kakadu decoder
plugins/code/j2k_dec/kakadu/src/j2k_dec_kakadu.cpp - Kakadu exports
plugins/code/j2k_dec/kakadu/src/j2k_dec_kakadu_plugin.cpp - libtiff decoder
plugins/code/tiff_dec/libtiff/src/tiff_dec_libtiff.cpp
Shared support
- Call debugger
plugins/code/common/Debugger/plugins_debugger.h
Other components
- DEE host
Connections 22
- DEE host → Beamr adapter: invokes plugin
- DEE host → x265 adapter: invokes plugin
- DEE host → Dummy transformer: invokes plugin
- DEE host → Kakadu exports: loads export
- DEE host → libtiff decoder: invokes plugin
- Common types → HEVC API: defines shared types
plugins/code/api/hevc_enc/hevc_enc_api.h - Common types → Transformer API: defines shared types
plugins/code/api/image_transformer/image_transformer_api.h - Common types → JPEG 2000 API: defines shared types
plugins/code/api/j2k_dec/j2k_dec_api.h - Common types → TIFF API: defines shared types
plugins/code/api/tiff_dec/tiff_dec_api.h - Common types → PCM watermark API: defines shared types
plugins/code/api/pcm_watermarker/pcm_watermarker_api.h - Common types → ProRes API: defines shared types
plugins/code/api/prores_dec/prores_dec_api.h - Beamr adapter → HEVC API: implements contract
plugins/code/hevc_enc/beamr/src/hevc_enc_beamr.cpp - Beamr adapter → Beamr encoder: delegates encoding
plugins/code/hevc_enc/beamr/src/hevc_enc_beamr.cpp - Beamr encoder → Beamr utilities: uses parsing helpers
plugins/code/hevc_enc/beamr/src/hevc_enc_beamr_impl.cpp - Beamr encoder → Call debugger: uses call macros
plugins/code/hevc_enc/beamr/src/hevc_enc_beamr_impl.cpp - Beamr encoder → HEVC API: uses encoder types
- x265 adapter → HEVC API: implements contract
plugins/code/hevc_enc/x265/src/hevc_enc_x265.cpp - x265 adapter → x265 utilities: uses helpers
plugins/code/hevc_enc/x265/src/hevc_enc_x265.cpp - Dummy transformer → Transformer API: implements contract
plugins/code/image_transformer/dummy/src/image_transformer_dummy.cpp - Kakadu exports → Kakadu decoder: exports decoder
plugins/code/j2k_dec/kakadu/src/j2k_dec_kakadu_plugin.cpp - Kakadu decoder → JPEG 2000 API: uses decoder contract
- libtiff decoder → TIFF API: implements contract
plugins/code/tiff_dec/libtiff/src/tiff_dec_libtiff.cpp