Programmer Guide/Macro Library/Kernal/CAppSetup: Difference between revisions

From STX Wiki
Jump to navigationJump to search

Revision as of 09:24, 7 March 2018

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
1 if application should exit, 0 if the application should wait until the user closes it.

Navigation menu

Personal tools