Framework: Directives

Detailed Description

Defines the Directives Interface.

Directives are messages given the OpenVX implementation that it must support. (These are required, i.e., non-optional.)

Enumerations
enum	vx_directive_e {   VX_DIRECTIVE_DISABLE_LOGGING = ((( VX_ID_KHRONOS ) << 20) | ( VX_ENUM_DIRECTIVE << 12)) + 0x0,   VX_DIRECTIVE_ENABLE_LOGGING = ((( VX_ID_KHRONOS ) << 20) | ( VX_ENUM_DIRECTIVE << 12)) + 0x1,   VX_DIRECTIVE_DISABLE_PERFORMANCE = ((( VX_ID_KHRONOS ) << 20) | ( VX_ENUM_DIRECTIVE << 12)) + 0x2,   VX_DIRECTIVE_ENABLE_PERFORMANCE = ((( VX_ID_KHRONOS ) << 20) | ( VX_ENUM_DIRECTIVE << 12)) + 0x3 }
	These enumerations are given to the vxDirective API to enable/disable platform optimizations and/or features. Directives are not optional and usually are vendor-specific, by defining a vendor range of directives and starting their enumeration from there. More...

Functions
vx_status VX_API_CALL	vxDirective (vx_reference reference, vx_enum directive)
	Provides a generic API to give platform-specific directives to the implementations. More...

Enumeration Type Documentation

enum vx_directive_e

These enumerations are given to the vxDirective API to enable/disable platform optimizations and/or features. Directives are not optional and usually are vendor-specific, by defining a vendor range of directives and starting their enumeration from there.

See also

vxDirective

Enumerator
VX_DIRECTIVE_DISABLE_LOGGING	Disables recording information for graph debugging.
VX_DIRECTIVE_ENABLE_LOGGING	Enables recording information for graph debugging.
VX_DIRECTIVE_DISABLE_PERFORMANCE	Disables performance counters for the context. By default performance counters are disabled.
VX_DIRECTIVE_ENABLE_PERFORMANCE	Enables performance counters for the context.

Definition at line 647 of file vx_types.h.

Function Documentation

vx_status VX_API_CALL vxDirective	(	vx_reference	reference,
		vx_enum	directive
	)

Provides a generic API to give platform-specific directives to the implementations.

Parameters

[in]	reference	The reference to the object to set the directive on. This could be vx_context, vx_graph, vx_node, vx_image, vx_array, or any other reference.
[in]	directive	The directive to set. See vx_directive_e.

Returns

A vx_status_e enumeration.

Return values

VX_SUCCESS	No errors; any other value indicates failure.
VX_ERROR_INVALID_REFERENCE	reference is not a valid vx_reference reference.
VX_ERROR_NOT_SUPPORTED	If the directive is not supported.

Note

The performance counter directives are only available for the reference vx_context. Error VX_ERROR_NOT_SUPPORTED is returned when used with any other reference.