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

Revision as of 10:32, 7 May 2012

application management	→	AppLoad — AppMain · AppCleanup · AppHelp
—
message handling	→	PostMessage · SetMsgHandler · DispatchMsg · MsgQueue · MsgFilter · GetMessage
—
utilities for standard STx applications	→	ExtSetup · PlayCursor · GenerateScaleParams · MetaSegment
—
file functions	→	stxFileTypeList · stxFileType · SectionFile · FileToolBox
—
display functions	→	LogWindow · ConLog · UM and EM · ShowItem
—
dialog and window functions	→	CreateMenu · DoModalDialog · SetModalWindow · GetWindowPos · SetWindowPos · WindowSizeDlg · GetMonitor · GetDesktop · ProgressBox · InitDialogItem · SetControlMode
—
SPU and graph functions	→	SetGraphXScale · GetOutputValue
—
SPUs	→	XScaleLinear · XScaleBark · Table2Output · Wave2output

name	type	description

Load and run a registered STX application.

argument	description	default
`appname`	Name of a registered STX application.
`appargs`	Arguments for the application.
RESULT	description
void	This macro has no return value.


Start a script: appload bscript run ; $@root\scripts\myscript.sts ; mymacro ; arg1 arg2

@@ Line 48: / Line 48: @@
 |}
 ==AppLoad==
-====<code>APPLOAD [ <var>caller</var> [ ; <var>nch</var> ; <var>code</var> ]</code>====
+====<code>APPLOAD <var>appname</var> [ ; <var>appargs</var> ]</code>====
-:Dialog to create a new soundfile.
+:Load and run a registered STX application.
 {|class="einrahmen"
 !argument !!description !!default
 |-
-|<var>srate</var>
+|<var>appname</var>
-|Sampling rate in Hz
+|Name of a registered STX application.
-|last dialog value
+|
 |-
-|<var>nch</var>
+|<var>appargs</var>
-|Number of channels.
+|Arguments for the application.
-|last dialog value
+|
-|-
-|<var>code</var>
-|Signal sample size (number of bits) and code.
-|last dialog value
 |-
 !RESULT !!description
 |-
-|<var>path</var> ||The full pathname of the created soundfile.
+|void ||This macro has no return value.
-|-
-|''empty string'' ||If the dialog was canceled or the creation fails.
 |}
-;Notes:
+;Examples:
-*This function uses a two step dialog. In the first the soundfile name is selected. The second is used to select the soundfile parameters.
+*Start the realtime analyser: <code>appload rtanalyse<code>
-*The new soundfile is always the created using the '''Windows WAVE''' format.
+*Start a script: <code>appload bscript run ; $@root\scripts\myscript.sts ; mymacro ; arg1 arg2<code>
-*On return, the soundfile is created but not opened.
-;See also: