OMX.broadcom.hvs

This component wraps the HVS (Hardware Video Scalar) hardware block to offer hardware accelerated format conversion, blending, and resizing. It has four inputs port taking numerous different formats, and one output port which supports various RGB formats.

Port 380 can be considered the master input port. When both ports 380 and 385 have a bufferthen the component will generate the output buffer based on the current set of buffers and parameters. The additional input ports are used for providing extra items to be composed into the output image. The ports are double-bufferred, only returning a buffer once a new one has been sent to replace it. Sending an empty buffer to these ports will return the current buffer and stop that port contributing to the output image.

Please note that this component has been developed for use under MMAL. It has not been tested at all under IL, so there may be unexpected behaviour under IL. It is also not considered to be production quality code yet - please use with caution.

Port	Index	Notes
380 381 382 383 384	OMX_IndexParamPortDefinition	Set this to control the geometry and format of the input buffers. The stripe height requirements vary based on format, but must be >= nFrameHeight. As an exception to the IL spec, this component supports updating this parameter in any state. Buffer presented to the port will be interpreted with the settings defined when the buffer is presented.
	OMX_IndexConfigDisplayRegion	Setting this config allows control over how buffers passed on that port contribute to the output frame. Source rectangles may currently not take into account any cropping required by a decoder. It does not support the OMX_DISPLAY_MODE_FILL and OMX_DISPLAY_MODE_LETTERBOX flags. It assumes that OMX_DISPLAY_SET_NOASPECT is set, ie it will distort the image to map the source/source rectangle into the destination rectangle. Buffers will be displayed with the value of OMX_IndexConfigDisplayRegion set at the point the buffer is submitted, even if it is subsequently updated.
	OMX_IndexParamColorSpace	Set/retrieve the image colour space settings that images received on this port should be rendered with.
	OMX_IndexParamCameraPoolToEncoderFunction	Used to set up proprietary communication with the previous component.
	OMX_IndexConfigBrcmUseProprietaryCallback	Forces use of proprietary tunnelling between ports.
	OMX_IndexParamBrcmSupportsUnalignedSliceheight	Retrieves the capabilites of this component to allow any nSliceHeight value >= nHeight.
385	OMX_IndexParamPortDefinition	Set / query this to control the geometry and format of the output buffers.
380 381 382 383 384 385	OMX_IndexParamMinimumAlignment	Query the minimum alignment that the component requries on the port.
	OMX_IndexParamVideoPortFormat	Set / query the image port format used.