DAQmxCreateMapScale
int32 DAQmxCreateMapScale (const char name[], float64 prescaledMin, float64 prescaledMax, float64 scaledMin, float64 scaledMax, int32 preScaledUnits, const char scaledUnits[]);
Purpose
Creates and configures a scale that scales values proportionally from a range of prescaled values to a range of scaled values.
Parameters
|
Input
|
| Name |
Type |
Description |
|
name
|
const char []
|
Identifies the custom scale for later use, such as when you create channels. |
|
prescaledMin
|
float64 |
The smallest value in the range of prescaled values. NI-DAQmx maps this value to scaledMin. |
|
prescaledMax
|
float64 |
The largest value in the range of prescaled values. NI-DAQmx maps this value to scaledMax. |
|
scaledMin
|
float64 |
The smallest value in the range of scaled values. NI-DAQmx maps this value to prescaledMin. Read operations clip samples that are smaller than this value. Write operations generate errors for samples that are smaller than this value. |
|
scaledMax
|
float64 |
The largest value in the range of scaled values. NI-DAQmx maps this value to prescaledMax. Read operations clip samples that are larger than this value. Write operations generate errors for samples that are larger than this value. |
|
preScaledUnits
|
int32 |
The units of the values to scale.
| Value |
|
Description |
|
DAQmx_Val_Volts
|
|
volts |
|
DAQmx_Val_Amps
|
|
amperes |
|
DAQmx_Val_DegF
|
|
degrees Fahrenheit |
|
DAQmx_Val_DegC
|
|
degrees Celsius |
|
DAQmx_Val_DegR
|
|
degrees Rankine |
|
DAQmx_Val_Kelvins
|
|
kelvins |
|
DAQmx_Val_Strain
|
|
strain |
|
DAQmx_Val_Ohms
|
|
ohms |
|
DAQmx_Val_Hz
|
|
hertz |
|
DAQmx_Val_Seconds
|
|
seconds |
|
DAQmx_Val_Meters
|
|
meters |
|
DAQmx_Val_Inches
|
|
inches |
|
DAQmx_Val_Degrees
|
|
degrees |
|
DAQmx_Val_Radians
|
|
radians |
|
DAQmx_Val_g
|
|
G. 1 g is approximately equal to 9.81 m/s2. |
|
DAQmx_Val_Pascals
|
|
pascals |
|
DAQmx_Val_FromTEDS
|
|
Units defined by TEDS information associated with the channel. |
|
|
scaledUnits
|
const char []
|
The units you want to use for the scaled value. You can use an arbitrary value. |
Return Value
| Name |
Type |
Description |
|
status
|
int32 |
The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error. |