Programmer Guide/Macro Library/BSF

• File: BSF.STX, linked to library STX.LIB
• Title: soundfile handling

---

Content

NewDialog	—	OpenDialog
Open	—	Close	—	CloseAll
Select	—	Truncate

Variables and items used by this library

name	type	description
@ParSoundFileNew	global variable	default values for function NewDialog
@ListAudioSampleCode	global variable	list of defined sample code keywords
@MaxAudioChannels	global variable	maximum number of soundfile channels
@MaxAudioSRate	global variable	maximum sampling rate in Hz
@ListAudioSRate	global variable	list of standard sampling rate values
@TempDir	global variable	directory for temporary files
BSFOpenList	table item	list of open soundfiles (only for BScript applications); this table is used by the functions Open, Close and CloseAll
SoundFileList	shell variable	name of the shared soundfile table item (see BSTXIni)

NewDialog

BSF NEWDIALOG [ srate [ ; nch ; code ]

New soundfile dialog.

argument	description	default
type	Selects the action to perform: LOAD or OPEN → open existing file SAVE or NEW → create new file	OPEN
title	The caption of the dialog window.	Select File
file	The default file or directory.	current directory
ftype1 ...	Each ftype argument defines one entry of the filetype-combobox of the dialog. Each filetype is defined by the string extension=description. Example: WAV=wave files If a ftype argument is the name of a (simple) table item, each entry of the table defines a filetype.
RESULT	description
path	The full pathname of the file to be opened or created.
empty string	If the dialog was canceled.

See also