CreateMovie loads an SWF file into a movie definition object; users must release the movie definition. If the user needs to override the file I/O interface for loading, they can install FileOpener object on the loader. The loaded movies are stored in the internal resource library to reduce memory footprint and enable resource sharing. If CreateMovie is called on the file that is already loaded before its movie definition was released, no loading will actually take place and the original pointer will be reused.
The CreateMovie creates a heap to hold the data loaded from a particular SWF/GFx file. The parameter "memoryArena" identifies the arena used for this purpose.
|
Parameters |
Description |
|
const char* pfilename |
File name from which SWF data will be loaded. This filename will be passed to the file open callback inorder to open the file. Note that the file name should be encoded as UTF-8 to support international file names. |
|
unsigned loadConstants = LoadAll |
Flags used to control what data is loaded from the file and whether the resource library is used. |
|
UPInt memoryArena = 0 |
Index of the memory arena used for memory allocation. |
A MovieDef pointer to the loaded SWF movie definition. This interface must be released once it is no longer used.