TIOVX User Guide
TIOVX Usage Recommendations

vxSetNodeTarget()

  • vxSetNodeTarget() should only be called on nodes of a graph before calling vxVerifyGraph() for that graph.
  • If a kernel that has only one available target is instantiated, the vxSetNodeTarget() API does not have to be called for that instantiated kernel. It will default to the only available target.
  • If multiple targets are available for a given kernel and the vxSetNodeTarget() is not called, the framework will default to the first target added to the kernel via the tivxAddKernelTarget() API, which is called when adding the target kernel to the context.

vxGetRemapPoint() and vxSetRemapPoint()

  • The vxGetRemapPoint() and vxSetRemapPoint() API's must always get or set the (0,0) element first prior to any other get or set. Additionally, the element at (remap_width, remap_height) must be set or gotten last. This is because getting or setting the (0,0) element performs a map of the remap object and getting or setting the (remap_width, remap_height) element performs an unmap of the remap object.

Stride Alignment for Images and Raw Images

  • TIOVX automatically aligns the stride of images and raw images to the value of TIVX_DEFAULT_STRIDE_Y_ALIGN. This is a requirement of certain hardware accelerators (such as LDC) and should not be modified.

Statically Allocated Structures

  • The maximum values of statically allocated structures are defined in the file <TIOVX_PATH>/include/TI/tivx_config.h
  • Utility functions were developed to assist in optimizing these values
  • The utility function, tivxPrintAllResourceStats, prints that maximum value of each parameter as well as the value being used currently
  • The utility function, tivxQueryResourceStats, provides information about the parameter values of a specific resource given as a parameter to the function
  • The utility function, tivxExportAllResourceMaxUsedValueToFile, generates a new config file called "tivx_config_generated.h" at VX_TEST_DATA_PATH. This config file contains optimized parameter values.
  • All of the max values are documented in the following link: TIOVX Configuration Parameters
  • All of these API's are documented further in the following link: c: Application Interface APIs