DBL
- Updated2023-02-17
- 4 minute(s) read
DBL
Reads double-precision, floating-point numeric data from a sound input device.
The Y component of the waveform this node returns is an array of double-precision, floating-point numbers.
Programming Patterns
To create a task ID, use the Sound Input Configure node and wire the task ID output to the input of this node.
.gvi.png?_LANG=enus)
number of samples/ch
Number of samples per channel in the buffer. Use a large number of samples for continuous operations. Use a smaller number of samples if you want to use less memory.
Default: 10,000
task ID in
Reference to the configured sound device you want to manipulate or input.
error in
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
| error in does not contain an error | error in contains an error |
|---|---|
| If no error occurred before the node runs, the node begins execution normally.
If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out. | If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out. |
Default: No error
timeout
Time, in seconds, that the node waits for the sound operation to complete. This node returns an error if the time elapses. If you set timeout to -1, the node waits indefinitely.
Default: 10
task ID out
Reference to the configured sound device originally passed to the task ID in parameter.
data
Any sound data read from the file. For multi-channel sound data, data is an array of waveforms where each element of the array is a single channel.
error out
Error information.
The node produces this output according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
| error in does not contain an error | error in contains an error |
|---|---|
| If no error occurred before the node runs, the node begins execution normally.
If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out. | If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out. |
Where This Node Can Run:
Desktop OS: Windows
FPGA:
Web Server: