User Tools
Site Tools
Sidebar
DzApp
Enumerations
Properties
Static Methods
| DAZ Script | |
|---|---|
| DzVersion | getVersion () |
| Boolean | hasActiveModalWidget () |
Methods
Signals
| void | closing () |
| void | debugMsg ( String msg ) |
| void | eventLoopStarted () |
| void | mouseEvent () |
| void | multiThreadingChanged ( Boolean onOff ) |
| void | sceneBuilderAccepted ( Array selections ) |
| void | sceneBuilderRejected () |
| void | starting () |
| void | styleAboutToChange () |
| void | styleChanged ( DzStyle newStyle ) |
| void | warningMsg ( String msg ) |
Detailed Description
Derived from QApplication, this class embodies the main event loop, and owns application-wide settings and objects not directly related to the user interface.
Can be directly accessed using the global variable App.
Enumerations
The current graphical systems available in the application.
—–
Enumerated values representing the Operating System under which the application is currently running.
—–
Enumerated values representing the hardware/software environment on which the application is currently running.
—–
Enumerated values representing the release cycles (channels) for the application.
—–
Enumerated values representing a set of features in the application.
Properties
Holds the name of the application; i.e., “DAZ Studio”. (Read Only)
Holds the name of the cloud service; i.e., “Daz Connect”. (Read Only)
Since:
- 4.9.0.26
Holds the exit code returned by the application. (Read Only)
Since:
- 4.9.3.51
Holds the size, in bytes, of the log file.
Since:
- 4.9.4.70
Holds a string representation of the full product version number; i.e., major.minor.revision.build. (Read Only)
Holds the name of the organization; i.e., “DAZ 3D”. (Read Only)
Holds the arguments passed to the application on launch. (Read Only)
Since:
- 4.9.3.39
Holds the full product version number as an encoded 32-bit integer. (Read Only) Deprecated
Use version64 instead.
Holds the full product version number as an encoded 64-bit integer. (Read Only)
Holds a string representation of the product version number; i.e., major.minor. (Read Only)
Static Methods
DzVersion : getVersion()
Return Value:
- The current version of the application.
Since:
- 4.11.0.230
Boolean : hasActiveModalWidget()
Return Value:
trueif a modal widget (i.e., dialog) is currently displayed, otherwisefalse.
Example
(function(){ print( App.hasActiveModalWidget() ); var wDlg = new DzBasicDialog(); App.postScriptEvent( true, "print( \"Testing:\", App.hasActiveModalWidget() );" ); wDlg.exec(); })();
Since:
- 4.12.1.116
Methods
Return Value:
- A numeric representation of the bit architecture the application was compiled for.
String : bitArchitectureString()
Return Value:
- A user-friendly string representation of the bit architecture the application was compiled for.
String : byteSizeToString( Number bytes )
Parameter(s):
- bytes - The numeric value to convert into a string.
Return Value:
- A string representation of the byte size.
Example:
// The message will be written to the log print( App.byteSizeToString( 1073741824 ) ); //1.0 GB
Boolean : canShowSceneBuilder( Object definition=undefined )
Parameter(s):
- definition - If empty, the default SceneBuilder.json file (if any) in getResourcesPath() will be checked. If a string, the full path of a Scene Builder configuration file to check is expected. If an object, a map of Scene Builder configuration data is expected. (since 4.6.4.62)
Return Value:
trueif the Scene Builder dialog would be displayed, otherwisefalse.
Since:
- 4.6.2.69
void : clearDelayedDeleteStack( Boolean doProgress )
Forces a deletion of all objects currently waiting to be deleted to free up more memory. If you are using this to clear memory you will generally want to clear the Undo Stack first.
See Also:
Parameter(s):
- doProgress - If
true, a progress dialog will be shown to the user while the operation is taking place.
void : clearPixmapCache()
Clears application wide cache of pixmaps.
Since:
- 4.11.0.34
String : createDigest( ByteArray data )
Parameter(s):
- data - The byte array to create a digest of.
Return Value:
- A string representing a message digest. The string is formatted as 36 characters, in which 32 are hexadecimal and distributed across five groups of 8-4-4-4-12 separated by a hyphen ('-', i.e. “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” where each 'x' is a hexadecimal digit).
String : createDigest( Array tokens )
Parameter(s):
- tokens - The list of strings to create a digest of.
Return Value:
- A string representing a message digest. The string is formatted as 36 characters, in which 32 are hexadecimal and distributed across five groups of 8-4-4-4-12 separated by a hyphen ('-', i.e. “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” where each 'x' is a hexadecimal digit).
String : createUuid()
Return Value:
- A string representing a randomly generated Universally Unique Identifier (UUID). The string is formatted as 38 characters, in which 32 are hexadecimal and distributed across five groups of 8-4-4-4-12 separated by a hyphen ('-') and enclosed by a pair of curly braces (i.e. “{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}” where each 'x' is a hexadecimal digit).
void : debug( String message )
Writes a debug message to the application log.
Parameter(s):
- message - The message to write.
See Also:
void : delayedExit( Number exitCode=0 )
Posts an event that causes the application to exit.
Parameter(s):
- exitCode - The exit code to set. (since 4.9.3.51)
Since:
- 4.6.2.55
void : enableMultiThreading( Boolean onOff )
Parameter(s):
- onOff - If
true, multi-threaded features are enabled, otherwise multi-threaded features are disabled.
Writes any currently buffered log messages to the log file. This is automatically called whenever the log buffer has more than 512 characters of data, but can be called at any time to force all messages to be written out.
String : getAbsoluteScriptPath( String scriptName )
Searches in default locations for a script file of the given name.
Parameter(s):
- scriptName - The name/path of a script file to find. This can be a file name, a relative file path, or an absolute file path.
Return Value:
- The absolute path of the found script file (if any), otherwise an empty string.
See Also:
String : getAppDataInstancePath()
Return Value:
- The absolute path of the application data directory for the current machine user, the current major version, the current release cycle and the current instance of the application.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
See Also:
Since:
- 4.12.1.23
String : getAppDataPath()
Return Value:
- The absolute path of the application data directory for the current machine user, the current major version and the current release cycle of the application.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
See Also:
String : getApplicationBaseName()
Return Value:
- The base name of the application; e.g., “Studio”.
Since:
- 4.9.2.33
String : getApplicationDataName()
Return Value:
- The name of the application settings; e.g., “Studio4 Public Build [1]”.
Since:
- 4.12.1.26
DzAppSettingsMgr : getAppSettingsMgr()
Deprecated
Exists only to keep old code working. Do not use in new code. Use DzAppSettings instead.
Return Value:
- The application-wide persistent Settings Manager - used to set and retrieve application settings.
DzAssetIOMgr : getAssetIOMgr()
Return Value:
- The application-wide Asset I/O Manager in charge of native format assets.
Return Value:
- The application-wide Asset Manager.
DzAuthenticationMgr : getAuthenticationMgr()
Return Value:
- The application-wide Authentication Manager - responsible for tracking user authentication.
DzCallBackMgr : getCallBackMgr()
Return Value:
- The application-wide Call Back Manager - responsible for tracking call back objects.
String : getCloudLogFilename()
Return Value:
- The filename for the file that logs messages from the application that pertains to the cloud service.
Since:
- 4.12.1.26
String : getCommonUserDocumentPath()
Return Value:
- The absolute path of the public/shared user documents folder.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
DzContentMgr : getContentMgr()
Return Value:
- The application-wide Content Manager.
Return Value:
- The current author (user that is currently running the app).
Return Value:
- The name of the data folder under the content directory.
Return Value:
- The full path for the location where data is stored.
String : getDataFolderPathBase()
Return Value:
- The base path for the location where data is stored.
String : getDAZDataPath()
Return Value:
- The absolute path of the data directory for the organization.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
See Also:
Return Value:
- The application-wide Device Manager - responsible for devices supported by the application.
Return Value:
- The active modal widget or the application main window if one exists.
String : getDocumentationPath()
Return Value:
- The absolute path of the directory where application documentation files are stored.
See Also:
Return Value:
- The absolute path of the user documents folder for the application.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
Return Value:
- The application-wide Export Manager in charge of file exporters.
DzFileIOPresetMgr : getFileIOPresetMgr()
Return Value:
- The application-wide File I/O Preset Manager.
String : getGeneratedScriptsPath()
Return Value:
- The absolute path of the directory where support script files that are automatically generated are stored.
See Also:
String : getGeneratedShadersPath()
Return Value:
- The absolute path of the application data directory for automatically generated shaders.
See Also:
GraphicsMode : getGraphicsMode()
Return Value:
- An enumerated value representing the current graphics mode.
DzHelpMgr : getHelpMgr()
Return Value:
- The application-wide Help Manager.
String : getHomePath()
Return Value:
- The absolute path of the directory that contains the application executable.
Return Value:
- The application-wide Image Manager - responsible for image I/O and tracking of currently loaded images.
Return Value:
- The application-wide Import Manager in charge of file importers.
Return Value:
- The main interface widget if the application is running with an interface, otherwise NULL.
See Also:
Last directory that files were loaded or saved to/from.
See Also:
String : getLogFilename()
Return Value:
- The filename for the file that logs messages from the application that pertains to the core application and any plugins.
See Also:
Since:
- 4.12.1.26
DzMultiMediaMgr : getMultiMediaMgr()
Return Value:
- The application-wide Video and Audio Manager - responsible for video and audio I/O.
Return Value:
- The application-wide Plug-in Manager - responsible for tracking plug-ins.
String : getPluginsPath()
Return Value:
- The absolute path of the base directory where plug-ins are loaded from.
See Also:
String : getProgramDataAppInstancePath()
Return Value:
- The absolute path of the machine's global program data directory for the organization, the current major version, the current release cycle, and the current instance of the application.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
See Also:
Since:
- 4.12.1.23
String : getProgramDataAppPath()
Return Value:
- The absolute path of the machine's global program data directory for the organization, the current major version, and the current release cycle of the application.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
See Also:
Return Value:
- The absolute path of the machine's global program data directory for the organization.
Attention:
- This path is dynamically constructed using calls to the underlying operating system. If the call to the OS fails, getHomePath() is used as a fallback.
See Also:
Return Value:
- The application-wide Render Manager.
Return Value:
- The absolute path of the directory where application resource files are stored.
See Also:
DzSaveFilterMgr (deprecated) : getSaveFilterMgr()
Return Value:
- The application-wide Save Filter Manager in charge of save filters.
String : getScriptsPath()
Return Value:
- The absolute path of the directory where support script files are stored.
See Also:
String : getShadersPath()
Return Value:
- The absolute path of the base directory for all shaders.
See Also:
DzSimulationMgr : getSimulationMgr()
Return Value:
- The application-wide Simulation Manager.
Since:
- 4.9.3.140
Return Value:
- The application-wide style object; subject to becoming invalid if the application style changes.
Return Value:
- The name of the style definition currently in use.
Array : getStyleDefinitionList()
Return Value:
- A list of the available style definitions.
Get a filename for temporary storage.
Return Value:
- A unique filename (with no extension) whose path will be in the current temporary working folder.
Attention:
- All files in this folder will be deleted when shutdown() is called.
String : getTempPath()
Return Value:
- The absolute path of the directory where temporary files are stored.
See Also:
String : getTempRenderFilename()
Get a filename for temporary storage of rendered images.
Return Value:
- A filename (with no extension) whose path will be in the current temporary working folder.
Attention:
- All files in this folder will be deleted when shutdown() is called.
Return Value:
- The absolute path of the temporary directory for automatically generated shaders.
See Also:
Return Value:
- The absolute path of the base directory for all binary utilities.
See Also:
String : instanceName()
Return Value:
- A user-friendly string indicating the name of the application instance (of the release cycle).
Since:
- 4.12.1.19
Return Value:
- A string indicating the name of the application instance (of the release cycle).
Since:
- 4.12.1.23
Return Value:
trueif the application is in the process of shutting down, otherwisefalse.
Boolean : isKeyDown( Number key=-1 )
Parameter(s):
- key - The Qt::Key value for the key to check. Since 4.11.0.263, any value < 0 (default) is interpreted as “any key” rather than a specific key.
Return Value:
trueifkeyis currently pressed, otherwisefalse.
Boolean : isKeySequenceDown( String sequence=“Any” )
Parameter(s):
- sequence - A string consistent with QKeySequence::fromString(), in the
PortableTextformat. Since 4.11.0.263, “any” is interpreted as “any key” rather than a specific key sequence.
Return Value:
trueifsequenceis currently pressed, otherwisefalse.
Boolean : isMultiThreadingEnabled()
Return Value:
trueif the user has chosen to enable multi-threaded features, otherwisefalse.
Boolean : isRegistered()
Return Value:
trueif a valid serial number has been provided, otherwisefalse.
Return Value:
trueif the main event loop is running and events that are posted can be expected to be delivered, otherwisefalse.
Return Value:
trueif the application is running as a slave to another application, otherwisefalse.
Boolean : isStarting()
Return Value:
trueif the application is in the process of starting up, otherwisefalse.
Boolean : isValidGuid( String data )
Parameter(s):
- data - The string to test whether or not it is a valid GUID.
Return Value:
trueifdataconsists of 32 hexadecimal characters (i.e. “xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx” where 'x' represents a hexadecimal value in the range [0-9a-f]), or 36 characters in which 32 are hexadecimal values distributed across five groups of 8-4-4-4-12 separated by a hyphen ('-', i.e. “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”), or 38 characters where the previous description is enclosed by curly braces (i.e. “{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}”), otherwisefalse.
Since:
- 4.12.1.63
Writes a normal operational message to the application log.
Parameter(s):
- message - The message to write.
See Also:
Shift = 0x02000000 Control = 0x04000000 (Ctrl keys on a Windows keybord, Command keys on a Macintosh keybord) Alt = 0x08000000 Meta = 0x10000000 (Windows key on a Windows keybord, Control keys on a Macintosh keybord) Keypad = 0x20000000
Return Value:
- The current modifier key state; this value is a bitwise OR of the Qt::KeyboardModifier flags for the active keys (if any).
Example:
var bIsOSX = App.platform == DzApp.MacOSX; var nModifiers = App.modifierKeyState(); var sStateValue = "0x" + nModifiers.toString( 16 ).toUpperCase(); var aKeys = []; if( nModifiers & 0x02000000 ){ aKeys.push( "Shift" ); } if( nModifiers & 0x04000000 ){ aKeys.push( bIsOSX ? "Command" : "Ctrl" ); } if( nModifiers & 0x08000000 ){ aKeys.push( "Alt" ); } if( nModifiers & 0x10000000 ){ aKeys.push( bIsOSX ? "Control" : "Windows" ); } if( nModifiers & 0x20000000 ){ aKeys.push( "Keypad" ); } print( aKeys.join( " + " ), "=", sStateValue );
OperatingSystem : operatingSystem()
Return Value:
- The enumerated value associated with the OperatingSystem that the application is running under.
String : operatingSystemString()
Return Value:
- A user-readable string that describes the current Operating System.
The application is intended to be as platform independent as possible, but there are cases where something needs to be done differently on one platform or another. This function provides a simple way to check which platform the application is running under.
Return Value:
- The enumerated value associated with the Platform that the application is running under.
Example:
var nPlatform = App.platform(); if( nPlatform == App.Windows ){ //doWinSomething(); } else if( nPlatform == App.MacOSX ){ //doMacSomething(); }
void : postScriptEvent( Boolean evaluate, String script, Array args=[] )
Posts an event that causes execution of a script as it is encountered in the event stack.
Parameter(s):
- evaluate - If
scriptis actual code, set this totrue, otherwise set this tofalse. - script - This can be a file name, a relative file path, an absolute file path or code. If passed a file name or path, getAbsoluteScriptPath() is used to resolve it. If passed actual code,
evaluatemust also be set totrue. - args - The list of arguments to pass to the script.
Since:
- 4.10.0.101
Return Value:
- The enumerated value associated with the ReleaseCycle of the application.
String : releaseCycleInstanceString()
Return Value:
- A user-friendly string describing the release cycle (and optionally, the instance) of the application.
Since:
- 4.12.1.19
String : releaseCycleInstanceSuffix()
Return Value:
- A user-friendly string describing the release cycle (and optionally, the instance) of the application.
Since:
- 4.12.1.19
String : releaseCycleInstanceSuffixStripped()
Return Value:
- A string describing the release cycle (and optionally, the instance) of the application, without any space characters.
Since:
- 4.12.1.19
Return Value:
- A user-friendly string describing the release cycle of the application.
Return Value:
- A user-friendly string describing the release cycle of the application.
String : releaseCycleSuffixStripped()
Return Value:
- A string describing the release cycle of the application, without any space characters.
ReleaseEdition : releaseEdition()
Return Value:
- The enumerated value associated with the ReleaseEdition of the application.
String : releaseEditionString()
Return Value:
- A user-friendly string describing the release edition of the application.
void : restoreDefaultTempPath()
Restores the temporary files directory to the default location.
See Also:
void : setLoadSavePath( String path )
Sets the default directory for loading or saving files.
Parameter(s):
- path - The absolute path of the (default) directory to load/save files from/to.
Example:
//Set the load/save path to our favorite folder App.setLoadSavePath( "c:/MyScenes" );
See Also:
Boolean : setStyleDefinition( String name )
Sets the current style for the application.
Parameter(s):
- name - The name of the style definition to use.
Return Value:
trueif the application switched to the given style, otherwisefalse.
Boolean : setTempPath( String tempPath )
Sets the directory path where temporary files are stored. The path provided needs to be an absolute path. A directory will be created at the new location if it does not already exist.
Parameter(s):
- tempPath - The path of the new temporary files directory.
Return Value:
trueif the path provided is valid and changing the temporary path succeeded.falseif any errors occurred.
See Also:
Boolean : showInNativeBrowser( String absFilePath )
A convenience method for opening a showing a file/directory in the OS file browser.
Parameter(s):
- absFilePath - The absolute file path to a file or folder to show.
Return Value:
trueif the file exists and the OS file browser could be launched, otherwisefalse.
Boolean : showPrompts()
Return Value:
trueif the application should prompt the user for input, otherwisefalse.
Array : showSceneBuilder( Object definition=undefined, Boolean asEvent=false )
Displays the Scene Builder dialog.
Parameter(s):
- definition - If empty, the default SceneBuilder.json file (if any) in getResourcesPath() will be used. If a string, the full path of a Scene Builder configuration file to check is expected. If an object, a map of Scene Builder configuration data is expected. (since 4.6.4.62)
- asEvent - If
false(default), the Scene Builder configuration data is processed immediately. Iffalse, the Scene Builder configuration data is posted to an event and processed as it is encountered in the event stack. (since 4.6.4.62)
Return Value:
- If
asEventisfalse, a list of the selections made by the user in the Scene Builder dialog, otherwise an empty list. (since 4.6.4.62)
See Also:
Since:
- 4.6.2.69
A convenience method for browsing to a given URL.
Parameter(s):
- url - The url to open in the system's default browser. Be sure to specify the scheme of the url (e.g., 'http:' or 'file:').
Example:
void : statusLine( String message, Boolean addToLog=true )
Display a message in the current status interface.
Parameter(s):
- message - The string to be displayed (and logged if logging is enabled)
- addToLog - If
true(default), the message will also be added to the log.
Example:
//The message will be displayed in status bar and written to the log file App.statusLine( "Hello World!" );
See Also:
Return Value:
trueif the application is using a user interface, otherwisefalse.
void : warning( String message )
Writes a warning message to the application log.
Parameter(s):
- message - The message to write.
See Also:
Boolean : writeConfigScript( String configScriptFilename=“” )
Saves out a user configuration script to the given filename. If no filename is given, the script is saved to the same file read from in startup(). The run() function calls this at the end of each execution.
Parameter(s):
- filename - The name of the file to save a configuration script to. If empty (default), the default configuration script for the running application instance is used - i.e., getAppDataInstancePath() + '/' + “StartupScript.dsa” is used.
Return Value:
trueif the file was written successfully, otherwisefalse.
void : writeToLog( String message, Boolean immediate )
Write a message to the application log.
Parameter(s):
- message - The message to write.
- immediate - If
true, the message (and any others in the log buffer) will be immediately written to the log file. Iffalse, the message will be written to the log buffer - the log buffer will be automatically flushed (written to file) if it exceeds the maximum defined buffer size.
Example:
//The message will be written to the log App.writeToLog( "Hello World!", true );
See Also:
Since:
- 4.14.0.4
void : writeToLog( String message )
Writes a message to the application log.
Parameter(s):
- message - The message to write.
Example:
//The message will be written to the log App.writeToLog( "Hello World!" );
See Also:
Since:
- 4.14.0.4
Signals
void : closing()
Signature:“closing()”
Emitted immediately after the main event loop exits.
Signature:“debugMsg(const QString&)”
Emitted when a debug message is sent to the application.
void : eventLoopStarted()
Signature:“eventLoopStarted()”
Emitted when the event loop is started on the application.
void : mouseEvent()
Signature:“mouseEvent()”
Emitted when a MouseButtonDblClick or MouseButtonRelease event occurs on the application.
void : multiThreadingChanged( Boolean onOff )
Signature:“multiThreadingChanged(bool)”
Emitted when multi-threading has changed on the application.
void : sceneBuilderAccepted( Array selections )
Signature:“sceneBuilderAccepted(const QStringList&)”
Emitted when the Scene Builder dialog has been rejected by the user, or when none of the files specified in the Scene Builder definition can be found.
Since:
- 4.6.4.62
void : sceneBuilderRejected()
Signature:“sceneBuilderRejected()”
Emitted when the Scene Builder dialog has been rejected by the user, or when none of the files specified in the Scene Builder definition can be found.
Since:
- 4.6.4.62
void : starting()
Signature:“starting()”
Emitted after the application has finished its startup just before the main event loop begins.
void : styleAboutToChange()
Signature:“styleAboutToChange()”
Emitted when a the style is about to change on the application.
void : styleChanged( DzStyle newStyle )
Signature:“styleChanged(DzStyle*)”
Emitted when the application wide style has changed.
void : warningMsg( String msg )
Signature:“warningMsg(const QString&)”
Emitted when a warning message is sent to the application.
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution 3.0 Unported
