Difference between revisions of "Application"

(dirty example to put in its own page!)
(typo in code)
 
Line 14: Line 14:
 
-- Request permission
 
-- Request permission
 
if not application:checkPermission("android.permission.WRITE_EXTERNAL_STORAGE") then
 
if not application:checkPermission("android.permission.WRITE_EXTERNAL_STORAGE") then
     application:requestPermission({"android.permission.WRITE_EXTERNAL_STORAGE"})
+
     application:requestPermissions({"android.permission.WRITE_EXTERNAL_STORAGE"}) -- note the plural in "requestPermissions"
 
end
 
end
 
</source>
 
</source>

Latest revision as of 21:43, 29 June 2020


Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: Object

Description

The Application class contains the common functions that are available to the current application. There is a global variable application of type Application to access these functions.


I add a quick example here but it would need its own page! (TO DO)

-- Request permission
if not application:checkPermission("android.permission.WRITE_EXTERNAL_STORAGE") then
    application:requestPermissions({"android.permission.WRITE_EXTERNAL_STORAGE"}) -- note the plural in "requestPermissions"
end


Methods

Application:canOpenUrl Tests if it is possible to open provided url
Application:configureFrustum Configure the projection for 3D perspective.
Application:exit terminates the application
Application:get returns state of desktop setting
Application:getApiVersion returns the API version
Application:getAppId returns the app id or bundle id
Application:getBackgroundColor returns the background color in hexadecimal format
Application:getContentHeight returns content height
Application:getContentWidth returns content width
Application:getDeviceHeight returns the physical height of the device in pixels
Application:getDeviceWidth returns the physical width of the device in pixels
Application:getDeviceInfo returns information about device
Application:getDeviceOrientation Get the device orientation
Application:getDeviceSafeArea returns the safe display area bounds
Application:getFps returns the frame rate of the application
Application:getKeyboardModifiers returns the current keyboard modifiers
Application:getLanguage returns the user language
Application:getLocale returns the device locale
Application:getLogicalBounds returns the physical screen bounds in logical space
Application:getLogicalHeight returns the logical height of the application
Application:getLogicalWidth returns the logical width of the application
Application:getLogicalScaleX returns the scaling of automatic screen scaling on the x-axis
Application:getLogicalScaleY returns the scaling of automatic screen scaling on the y-axis
Application:getLogicalTranslateX returns the translation of automatic screen scaling on the x-axis
Application:getLogicalTranslateY returns the translation of automatic screen scaling on the y-axis
Application:getOrientation returns the orientation of the application
Application:getScaleMode returns the automatic scale mode of the application
Application:getScreenDensity returns the screen density in pixels per inch
Application:getTextureMemoryUsage returns the texture memory usage in Kbytes
Application:isPlayerMode Check if app runs on player
Application:openUrl opens the given URL in the appropriate application
Application:set sets state of desktop settings
Application:setBackgroundColor sets the background color in hexadecimal format
Application:setFps sets the frame rate of the application
Application:setFullScreen Full screen or window mode
Application:setKeepAwake enables/disables screen dimming and device sleeping
Application:setKeyboardVisibility
Application:setLogicalDimensions sets the logical dimensions of the application
Application:setOrientation sets the orientation of the application
Application:setScaleMode sets the automatic scale mode of the application
Application:setWindowSize Sets desktop window to a specific size
Application:vibrate vibrates the device

Events

Event.APPLICATION_START
Event.APPLICATION_RESIZE
Event.APPLICATION_SUSPEND
Event.APPLICATION_EXIT
Event.APPLICATION_RESUME

Constants

Application.LANDSCAPE_LEFT
Application.LANDSCAPE_RIGHT
Application.PORTRAIT
Application.PORTRAIT_UPSIDE_DOWN