MO_InitITCMArea

C Specification

#include <nitro/mobiclip.h>

void MO_InitITCMArea ( void* itcmPtr, u32 size );

Description

Give to Mobiclip the address and size in bytes of the usable ITCM area.
This function is used for code relocation management.

If this function is not called or the size given in parameter is 0, Mobiclip core routines will run from main memory.
If the size given in parameter is greater or equal to the value returned by the MO_GetOptimalITCMSize function,
all the core routines of Mobiclip will be relocated to this area.
If the size given in parameter is less than the value returned by the MO_GetOptimalITCMSize function,
Mobiclip will try to relocate parts of its core routines to this area.
If only parts or none of the core routines resides in ITCM, playback performance will NOT be optimal.

You can call this function several times with different paramaters; for each call the code relocation state will be resetted.
This function MUST NOT be called when a Mobiclip movie handle is still opened.

Arguments

itcmPtr Address of the usable ITCM area.
size Size in bytes of the usable ITCM area.

Return Values

Nothing.

See Also

MO_GetOptimalITCMSize
MO_GetOptimalDTCMSize
MO_InitDTCMArea

Revision History

03/13/2008 Fixed a typo and replaced SDRAM by "main memory"
03/03/2008 Initial Version