Programmer Guide/Macro Library/Kernal/CAppSetup: Difference between revisions
m (1 revision: Initial import) |
Revision as of 09:57, 28 April 2011
Contents
- 1 CAppSetup : CObj
- 1.1 CAppSetup Member Functions
- 1.1.1 CONSTRUCT profileType profileSubType profileName
- 1.1.2 Usage:
- 1.1.3 Result:
- 1.1.4 Description:
- 1.1.5 DELETEPROFILE
- 1.1.6 Result:
- 1.1.7 Description:
- 1.1.8 DESTRUCT
- 1.1.9 Description:
- 1.1.10 LISTPROFILES [table]
- 1.1.11 Usage:
- 1.1.12 Result:
- 1.1.13 Description:
- 1.1.14 LOAD|LOADPROFILE [profileName]
- 1.1.15 Usage:
- 1.1.16 Result:
- 1.1.17 Description:
- 1.1.18 RESTART
- 1.1.19 Usage:
- 1.1.20 Result:
- 1.1.21 Description:
- 1.1.22 RUN wait ; audioSet ; audioSegment ; channel
- 1.1.23 Usage:
- 1.1.24 Result:
- 1.1.25 Description:
- 1.1.26 SAVEPROFILEAS
- 1.1.27 Result:
- 1.1.28 Description:
- 1.1.29 SAVE|SAVEPROFILE [profileName]
- 1.1.30 usage:
- 1.1.31 result:
- 1.1.32 description:
- 1.1.33 SET parameter=value [parameterX=valueX ...]
- 1.1.34 Usage:
- 1.1.35 Result:
- 1.1.36 Description:
- 1.1.37 SETUPDIALOG
- 1.1.38 Result:
- 1.1.39 Description:
- 1.1.40 WAIT
- 1.1.41 Usage:
- 1.1.42 Parameters:
- 1.1 CAppSetup Member Functions
CAppSetup : CObj
The CAPPSETUP class is still being documented
CAppSetup Member Functions
CONSTRUCT profileType profileSubType profileName
Usage:
| profileType | the name of the application profile type (see below) |
| profileSubType | the name of the sub-profile type to use or * if there is no sub-profile type |
| profileName | the profile name |
Result:
0
Description:
Initializes a new CAppSetup instance with data from the profile passed.
The following application profile types are supported:
Viewer1|Viewer2|Viewer3|DSP1App|DSP1Copy|DSP1Amplify|DSP1Normalize|DSP1AGC|DSP1Filter|DSP1Bandpass|DSP1Spectrum|DSP1DeNoise|DSP1Irrelevance
DELETEPROFILE
Result:
1 on success, 0 on failure
Description:
Show a dialog prompting the user to delete the profile. The function returns 1 if the user chooses to delete and 0 if they cancel the dialog box.
DESTRUCT
Description:
Destroy the CAppSetup instance and clean up.
LISTPROFILES [table]
Usage:
| table | name of target table or * if a table should be created. |
Result:
a table containing a list of all profile ids for the current instance's profile type
Description:
Creates a sorted list of profile names for the current profile type.
LOAD|LOADPROFILE [profileName]
Usage:
| profileName | the name of the application profile to load |
Result:
void
Description:
Load all application settings for the specified profile and convert loaded settings to shell or global variables. If no profile name is specified, the instance's current profile is used.
RESTART
Usage:
Result:
Description:
RUN wait ; audioSet ; audioSegment ; channel
Usage:
| wait | 1 if the macro/script should wait for the application to finish before continuing to the next command. |
| audioSet | the audio set IREF |
| audioSegment | the audio segment |
| channel | the audio channel |
Result:
0 for success, 1 on failure
Description:
Run the application.
SAVEPROFILEAS
Result:
1
Description:
Show a dialog box prompting the user to save the current profile under a new name.
SAVE|SAVEPROFILE [profileName]
usage:
| profileName | the name of the application profile |
result:
void
description:
Store all application setup variables into a table and save the table into the setup elements for the specified profile. If no profile name is specified, the instance's current profile name is used.
SET parameter=value [parameterX=valueX ...]
Usage:
| parameter=value | set the specified parameter to the specified value |
Result:
void
Description:
Set one or multiple parameter values.
SETUPDIALOG
Result:
the string 'Okay' if the user pressed the OK button, or 'Cancel' if the user pressed the Cancel button.
Description:
Show the setup dialog for the instance's current profile.
WAIT
Usage:
WAIT exit
Parameters:
- exit
1if application should exit,0if the application should wait until the user closes it.
