NewFIFOChan
NewFIFOChan [/B/C/D/I/S/U/W/Y=numType ] FIFOName, channelName, offset, gain, minusFS, plusFS, unitsStr [, vectPnts ]
The NewFIFOChan operation creates a new channel for the named FIFO.
Parameters
channelName must be unique for the specified FIFO.
The offset, gain, plusFS, minusFS and unitsStr parameters are used when the channel's data is displayed or transferred to a wave. If given, vectPnts must be between 1 and 65535.
Flags
The flags define the type of data to be stored in the FIFO channel:
| /B | 8-bit signed integer or unsigned integer if /U is present. | |
| /C | Complex. | |
| /D | Double precision IEEE floating point. | |
| /I | 32-bit signed integer or unsigned integer if /U is present. | |
| /S | Single precision IEEE floating point (default). | |
| /U | Integer data are unsigned. | |
| /W | 16-bit signed integer or unsigned integer if /U is present. | |
| /Y=type | Specifies wave data type. See details below. | |
Wave Data Types
As a replacement for the above number type flags you can use /Y=numType to set the number type as an integer code. See WaveType for code values. Do not use /Y in combination with other type flags.
Details
You cannot invoke NewFIFOChan while the named FIFO is running.
If you provide a value for vectPnts, you will create a channel capable of holding a vector of data rather than just a single data value. When such a channel is used in a Chart, it is displayed as an image using one of the built-in color tables.
Igor scales values in the FIFO channel before displaying them in a chart or transferring them to a wave as followed:
scaled_value = (FIFO_value - offset) * gain
Igor uses the plusFS and minusFS parameters (plus and minus full scale) to set the default display scaling for charts.
The unitsStr parameter is an Igor units string (3 bytes maximum).
When you transfer a channel's data to a wave, using the FIFO2Wave operation, Igor stores the plusFS and minusFS values and the unitsStr in the wave's Y scaling.