Change Log

This section describes the API evolution from version to version.

Version 2.8

New in this release:

• Introduced MFX_FOURCC_ABGR16F FourCC for 16-bit float point (per channel) 4:4:4 ABGR format.

• Clarified the mfxExtMasteringDisplayColourVolume::DisplayPrimariesX, mfxExtMasteringDisplayColourVolume::DisplayPrimariesY for the video processing usage.

• Added MFX_CONTENT_NOISY_VIDEO in ContentInfo definition.

• Added Camera Processing API for Camera RAW data.

• Introduced hint to disable external video frames caching for GPU copy.

• Clarified usage of mfxExtMasteringDisplayColourVolume::InsertPayloadToggle and mfxExtContentLightLevelInfo::InsertPayloadToggle during decode operations.

• Fixed multiple spelling errors.

• Experimental API: introduced mfxExtMBQP::Pitch value for QP map defined in mfxExtMBQP.

• Clarified when MFXEnumImplementations() may be called for implementation capabilities query.

• Added table with filenames included in the dispatcher’s search process.

Bug Fixes:

• Fixed Experimental API table to note that mfxExtRefListCtrl and MFX_EXTBUFF_UNIVERSAL_REFLIST_CTRL were moved to production in version 2.8.

Version 2.7

New in this release:

• mfxExtVppAuxData::RepeatedFrame flag is actual again and returned back from deprecation state.

• Clarified GPUCopy control behavior.

• Introduced MFX_FOURCC_XYUV FourCC for non-alpha packed 4:4:4 format.

• Notice added to the mfxFrameSurfaceInterface::OnComplete to clarify when library can call this callback.

• New product names for platforms:

  • Code name Alder Lake N.

• Annotated missed aliases mfxExtHEVCRefListCtrl, mfxExtHEVCRefLists, mfxExtHEVCTemporalLayers.

• New dispatcher’s config properties:

  • Pass through extension buffer to mfxInitializationParam.

  • Select host or device responsible for the memory copy between host and device.

• Refined description of struct mfxExtMasteringDisplayColourVolume and mfxExtContentLightLevelInfo for HDR SEI decoder usage.

• Experimental API: introduced interface to get statistics after encode.

Bug Fixes:

• Fixed missprint in the mfxExtDeviceAffinityMask description.

• MFXVideoENCODE_Query description fixed for query mode 1.

Version 2.6

New in this release:

• New development practice to treat some new API features as experimental was introduced. All new experimental API is wrapped with ONE_EXPERIMENTAL macro.

• Experimental API: introduced MFX_HANDLE_PXP_CONTEXT to support protected content.

• Experimental API: introduced CPUEncToolsProcessing hint to run adaptive encoding tools on CPU.

• Experimental API: extended device ID reporting to cover multi-adapter cases.

• Experimental API: introduced common alias for mfxExtAVCRefListCtrl

• Experimental API: mfxExtDecodeErrorReport ErrorTypes enum extended with new JPEG/MJPEG decode error report.

• Clarified LowPower flag meaning.

• Described that mfxExtThreadsParam can be attached to mfxInitializationParam during session initialization.

• Refined description of the MFXVideoDECODE_VPP_DecodeFrameAsync function.

• New dispatcher’s config filter property: MediaAdapterType.

• Marked all deprecated fields as MFX_DEPRECATED.

• Introduced priority loading option for custom libraries.

• Clarified AV1 encoder behavior about writing of IVF headers.

• Removed outdated note about loading priority of Intel^® Media Software Development Kit. For loading details see oneVPL implementation on Intel® platforms with Xe architecture and Intel® Media Software Development Kit Coexistence.

• Spelled out mfxVariant type usage for strings.

• New product names for platforms:

  • Code name DG2,

  • Code name ATS-M.

Version 2.5

New in this release:

• Added mfxMediaAdapterType to capability reporting.

• Added surface pool interface.

• Helper macro definition to simplify filter properties set up process for dispatcher.

• Added mfxExtAV1BitstreamParam, mfxExtAV1ResolutionParam and mfxExtAV1TileParam for AV1e.

• Added MFX_RESOURCE_VA_SURFACE_PTR and MFX_RESOURCE_VA_BUFFER_PTR enumerators.

• Clarified HEVC Main 10 Still Picture Profile configuration.

• External Buffer ID of mfxExtVideoSignalInfo and mfxExtMasteringDisplayColourVolume for video processing.

• New MFX_WRN_ALLOC_TIMEOUT_EXPIRED return status. Indicates that all surfaces are currently in use and timeout set by mfxExtAllocationHints for allocation of new surfaces through functions GetSurfaceForXXX expired.

• Introduced universal temporal layering structure.

• Added MFX_RESOURCE_VA_SURFACE_PTR and MFX_RESOURCE_VA_BUFFER_PTR enumerators.

• Introduced segmentation interface for AV1e, including ext-buffers and enums.

• Introduced planar I422 and I210 FourCC codes.

Bug Fixes:

• Dispatcher: Removed /etc/ld.so.cache from oneVPL search order.

• mfxSurfaceArray: CDECL attribute added to the member-functions.

Deprecated:

• mfxExtVPPDenoise extension buffer.

Version 2.4

• Added ability to retrieve path to the shared library with the implementation.

• Added 3DLUT (Three-Dimensional Look Up Table) filter in VPP.

• Added mfxGUID structure to specify Globally Unique Identifiers (GUIDs).

• Added QueryInterface function to mfxFrameSurfaceInterface.

• Added AdaptiveRef and alias for ExtBrcAdaptiveLTR.

• Added MFX_FOURCC_BGRP FourCC for Planar BGR format.

• Environmental variables to control dispatcher’s logger.

Version 2.3

• Encoding in Hyper mode.

• New product names for platforms:

  • Code name Rocket Lake,

  • Code name Alder Lake S,

  • Code name Alder Lake P,

  • Code name for Arctic Sound P.

  • For spec version 2.3.1 MFX_PLATFORM_XEHP_SDV alias was added

• mfx.h header file is added which includes all header files.

• Added deprecation messages (deprecation macro) to the functions MFXInit and MFXInitEx functions definition.