- ::wsurf::ApplyPreferences
- ::wsurf::ChooseConfigurationDialog
- ::wsurf::GetConfigurations
- ::wsurf::GetCurrent
- ::wsurf::getopt
- ::wsurf::GetPreference
- ::wsurf::GetPreferences
- ::wsurf::GetPlugins
- ::wsurf::Initialize
- ::wsurf::MakeCurrent
- ::wsurf::PreferencePage
- ::wsurf::NeedSave
- ::wsurf::SetDefaultPrefs
- ::wsurf::SetPreference

# ::wsurf::ApplyPreferences

This command should be invoked if the user hits "OK" or "Apply" in an applications preferences dialog to handle global widget preferences.

# ::wsurf::ChooseConfigurationDialog

This command is used to to display the "Choose configuration" dialog.

# ::wsurf::GetConfigurations

Returns a list with available configurations.

# ::wsurf::GetCurrent

Returns the name of the currently active wsurf widget.

# ::wsurf::getopt

This procedure is invoked to handle option parsing of the command line. This allows plug-ins to handle their own command line switches.

# ::wsurf::GetPreference

Returns the current value for specified preference. Syntax:

`::wsurf::GetPreference preference`

# ::wsurf::GetPreferences

Returns global widget preferences in text form.

# ::wsurf::GetPlugins

Returns a list with available plug-ins.

# ::wsurf::Initialize

This command initializes the wsurf library and should be called before creating the first widget. The command loads all plug-ins, creates default bindings, and sets default preferences. Syntax:

`::wsurf::Initialize preference ?-plugindir dir? ?-configdir dir?`

The options are used to specify additional directories to search for plug-ins and configurations.

# ::wsurf::MakeCurrent

Makes a wsurf widget current. Syntax:

`::wsurf::MakeCurrent widget`

# ::wsurf::PreferencePage

This command returns a list with global widget tab names and corresponding notebook page rendering procedures.

# ::wsurf::NeedSave

Returns 1 if there is an unsaved modification to a sound or to related data in a plug-in.

# ::wsurf::SetDefaultPrefs

Sets default values for global widget preferences.

# ::wsurf::SetPreference

Sets specified preference to given value. Syntax:

`::wsurf::SetPreference preference value`