Static Public Member Functions | |
XFCIMPORT const CHAR * | getPlatformString () |
Returns platform as a printable CHAR * string. | |
XFCIMPORT INT32 | getPlatformId () |
Returns platform as a generic id (see XFCPLATFORM enum). | |
XFCIMPORT const CHAR * | getCommandlineString () |
Returns command line as a CHAR string, if applicable to the platform. | |
XFCIMPORT void | setRenderer (XFcRenderer *aNewRenderer) |
Sets (or changes) the renderer object. | |
XFCIMPORT void | setController (XFcInput *aNewController) |
Sets (or changes) the input receiver object. | |
XFCIMPORT INT32 | getTick () |
Returns the system tick (in milliseconds). | |
XFCIMPORT INT64 | getTick64 () |
Returns the system tick (in milliseconds) as an INT64 value. | |
XFCIMPORT void | quit () |
Quits the application. | |
XFCIMPORT void | systemPanic (const CHAR *aPanicMessage) |
Performs system panic; shows dialog for user, tries to shut down cleanly. | |
XFCIMPORT XFcApp * | getApp () |
Returns a pointer to the application class. | |
XFCIMPORT INT32 | getDeviceWidth () |
Returns graphics device logical width in pixels. | |
XFCIMPORT INT32 | getDeviceHeight () |
Returns graphics device logical height in pixels. | |
XFCIMPORT INT | openCFL (const CHAR *aFileName) |
Opens a compressed file library from filename. | |
XFCIMPORT void | resetCFLDirectory () |
Resets the CFL directory. | |
XFCIMPORT void | setFileOpenStrategy (INT32 aStrategy) |
Changes the default file open strategy. | |
XFCIMPORT void | compactMemory (UINT32 aFlags) |
Attempts to compact memory pool. | |
XFCIMPORT UINT32 | getMemoryBlockSize (void *aPtr) |
Returns size of an allocated memory block. | |
XFCIMPORT UINT32 | getFreePoolMemory () |
Returns free memory. | |
XFCIMPORT void * | allocateSystemMemory (const INT32 aSize) |
Performs platform independent memory allocation. | |
XFCIMPORT void | freeSystemMemory (void *aPtr) |
Performs platform independent memory deallocation. | |
XFCIMPORT REAL | getBatteryState () |
Returns percentage of battery left (0..1). | |
XFCIMPORT void | addScreenButton (const XFcRectangle &aRect, INT32 aScanCode) |
Adds a virtual button on screen. | |
XFCIMPORT void | resetScreenButtons () |
Removes all virtual buttons from screen. | |
XFCIMPORT UINT32 | getControlMappingCount () |
Returns the number of allocated control mappings. | |
XFCIMPORT void | getControlMapping (UINT32 aControlIndex, INT32 &aControlCode, INT32 &aHardwareScanCode) |
Returns one control mapping for an index. | |
XFCIMPORT void | mapControlCode (INT32 aControlCode, INT32 aHardwareScanCode) |
Maps a hardware scan code to a control code. | |
XFCIMPORT void | unmapControlCode (INT32 aControlCode, INT32 aHardwareScanCode) |
Unmaps the link from a hardware scan code to a control code. | |
XFCIMPORT void | resetControlMappings () |
Resets control mappings to default. | |
XFCIMPORT XFcCommunication * | getCommunicationScheduler () |
Returns network communication scheduler. | |
XFCIMPORT XFcCPUInfo * | getCPUInfo () |
Allocates and returns CPU information class. | |
XFCIMPORT void | sleep (INT32 aMilliseconds) |
Sleeps the current thread for at least specified amount of milliseconds. | |
XFCIMPORT INT32 | setExclusiveMode (INT32 aMode, XFcExclusiveModeSettings &aSettings) |
Sets exclusive mode. | |
XFCIMPORT void | setOutOfMemoryAction (INT32 aMode) |
Sets the action which should be taken when memory allocation fails. | |
XFCIMPORT void | setIdleMode (INT32 aMode) |
Tells X-Forge whether to let the device go into idle state or not. | |
XFCIMPORT INT32 | getSilentProfileState () |
Asks if the device is in silent profile. | |
XFCIMPORT UINT32 | getDeviceLocale () |
Asks for the current locale in the device. | |
XFCIMPORT XFcPrimitiveTranslator * | getPrimitiveTranslator () |
Returns the primitive translator class for high level 2D vector graphics drawing. | |
XFCIMPORT XFcPrimitiveDraw * | getPrimitiveDraw () |
Returns the primitive draw class for low level 2D vector graphics drawing. |
|
Adds a virtual button on screen. Please note that this is not a widget, and there is no visual feedback. If stylus touched the defined rectangle, a keydown event is dispatched; when the stylus exits the region, keyup event is dispatched. You can map the scancode to a control code using the mapControlCode call.
|
|
Performs platform independent memory allocation.
|
|
Attempts to compact memory pool. Tells the memory manager that now would be a good time to do any house-keeping tasks that may take some time.
|
|
Performs platform independent memory deallocation.
|
|
Returns a pointer to the application class.
|
|
Returns percentage of battery left (0..1). It is advisable to show the battery state inside games; however, the value returned by this call is not reliable enough to warrant any action on low battery situations.
|
|
Returns command line as a CHAR string, if applicable to the platform.
|
|
Returns network communication scheduler.
|
|
Returns one control mapping for an index. Returned values aControlCode and aHardwareScanCode are either valid control and hardware scan codes, or both are -1 if the allocated link is not currently in use.
|
|
Returns the number of allocated control mappings.
|
|
Allocates and returns CPU information class.
|
|
Returns graphics device logical height in pixels.
|
|
Asks for the current locale in the device. Note that this method is not neccessarily supported on devices that do support several locale settings, and even on those, not all supported locales are returned. If querying the locale fails or is unsupported, the function returns zero. If the application does not detect a supported locale, it should default to english. See XFCLOCALES enum for full list of possible return values. |
|
Returns graphics device logical width in pixels.
|
|
Returns free memory.
|
|
Returns size of an allocated memory block.
|
|
Returns platform as a generic id (see XFCPLATFORM enum).
|
|
Returns platform as a printable CHAR * string.
|
|
Returns the primitive draw class for low level 2D vector graphics drawing.
|
|
Returns the primitive translator class for high level 2D vector graphics drawing.
|
|
Asks if the device is in silent profile.
|
|
Returns the system tick (in milliseconds).
|
|
Returns the system tick (in milliseconds) as an INT64 value. Implemeted for situations where INT32 overflow is a problem.
|
|
Maps a hardware scan code to a control code. When a certain scan code is received from physical buttons, the core can map it to some control code, and calls onControlDown() with the control code. All controls can be re-mapped with this method.
|
|
Opens a compressed file library from filename. You can open multiple files. If several resource names overlap, only the last opened one is used.
|
|
Quits the application. This method never returns. It causes onAppDeinit() to be called, as well as closing any current renderers and so on. |
|
Resets the CFL directory. In order to change levels or other data, you may want to flush the current CFL directory entries and re-open the CFL files.
|
|
Resets control mappings to default. Discards any changes done with mapControlCode, and returns to startup defaults (which are platform specific). |
|
Removes all virtual buttons from screen.
|
|
Sets (or changes) the input receiver object.
|
|
Sets exclusive mode. In exclusive mode application takes over the whole screen and may capture control events that would otherwise be handled by the device. Applications start in exclusive mode.
|
|
Changes the default file open strategy. See XFCFILEOPENSTRATEGY enum. The default strategy is XFCFO_DISKFIRST. |
|
Tells X-Forge whether to let the device go into idle state or not. Normally a game would not want the device to go idle while the game is being played. There can be situations, such as cutscenes, which last long enough for the device to turn off backlight. In some situations, such as game menus or pause mode it is, however, desirable to let the device time out in order to save batteries.
|
|
Sets the action which should be taken when memory allocation fails. This function sets the global action which should be taken whenever memory allocation fails. The normal mode of action is to do nothing and return NULL from the memory allocation. It may be desirable to set the out of memory action to XFCOMA_PANIC to detect out of memory situations in unexpected situations. XFCOMA_ASSERT can be used to break into debugger in debug builds; finally, XFCOMA_NONE can be used to return to normal operation.
|
|
Sets (or changes) the renderer object. Causes the old renderer to get a deinitialization call, and the new one to receive an initialization call. |
|
Sleeps the current thread for at least specified amount of milliseconds. It is highly recommended to sleep() as much as possible during idle moments, as this saves device batteries.
|
|
Performs system panic; shows dialog for user, tries to shut down cleanly. This method is to be used when an error situation is so severe that it is uncertain whether the application is able to continue. |
|
Unmaps the link from a hardware scan code to a control code.
|
![]() | ||||
![]() |
Confidential Copyright © 2002-2003 Fathammer | with doxygen by Dimitri van Heesch |