跳转至

GTN_GetCompensate3DTable

指令原型：

GT_API GTN_GetCompensate3DTable(short core,short tableIndex,TCompensate3DTable*pTable,TCompendate3DPoint *pPointArray,TCompensate3DPointRange *pPointRange,short*pExtend)

指令类型：

立即指令，调用后立即生效。

指令说明：

读取三维补偿表的补偿范围和补偿点的补偿值。

指令参数说明：

core 核号，正整数，取值范围请参照核号参数范围一栏。
tableIndex 补偿表索引号，取值范围：[1, 3]。
pTable 三维补偿表补偿范围参数结构体指针。详情说明请参照TCompensate3DTable
TCompensate3DTable 
typedef struct Compensate3DTable
{
    long count[3];          // count[0]：X轴方向补偿点数
                            // count[1]：Y轴方向补偿点数
                            // count[2]：Z轴方向补偿点数

    long pad1[5];           // 保留参数，必须为0

    double posBegin[3];     // posBegin[0]：补偿区域X轴起点
                            // posBegin[1]：补偿区域Y轴起点
                            // posBegin[2]：补偿区域Z轴起点

    double step[3];         // step[0]：补偿区域X轴方向补偿点间距
                            // step[1]：补偿区域Y轴方向补偿点间距
                            // step[2]：补偿区域Z轴方向补偿点间距

    double reserve1[4];     // 保留参数，必须为0
} TCompensate3DTable;
count：补偿表的数据点数量。
count[0]：X方向数据点数量，最小值为2。
count[1]：Y方向数据点数量，最小值为2。
count[2]：Z方向数据点数量，最小值为2。
pad1：保留参数，必须为0。
posBegin：补偿区域起始点。
posBegin[0]：X方向位置。
posBegin[1]：Y方向位置。
posBegin[2]：Z方向位置。
step：补偿区域的步长，即补偿区域内，每两个补偿点间的距离。
step[0]：X方向的间距。
step[1]：Y方向的间距。
step[2]：Z方向的间距。
reserve1：保留参数，必须为0。
pPointArray 三维补偿表的补偿点参数结构体指针。：返回补偿点信息，数组长度不能小于pPointRange.rangeCount[0]、pPointRange.rangeCount[1]和pPointRange.rangeCount[2]三者的乘积。详情说明请参照TCompendate3DPoint
TCompendate3DPoint
pPointRange 描述回读补偿点的范围参数结构体指针。详情说明请参照TCompensate3DPointRange
TCompensate3DPointRange 
typedef struct Compensate3DPointRange
{
    long rangeIndex[3];     // rangeIndex[0]：X轴方向回读补偿点起始点索引
                            // rangeIndex[1]：Y轴方向回读补偿点起始点索引
                            // rangeIndex[2]：Z轴方向回读补偿点起始点索引

    long rangeCount[3];     // rangeCount[0]：X轴方向回读补偿点数量
                            // rangeCount[1]：Y轴方向回读补偿点数量
                            // rangeCount[2]：Z轴方向回读补偿点数量
} TCompensate3DPointRange;
rangeIndex：回读补偿点起始点索引。
rangeIndex[0]：X轴方向回读补偿点起始点索引。
rangeIndex[1]：Y轴方向回读补偿点起始点索引。
rangeIndex[2]：Z轴方向回读补偿点起始点索引。
rangeCount：回读补偿点数量。
rangeCount[0]：X轴方向回读补偿点数量。
rangeCount[1]：Y轴方向回读补偿点数量。
rangeCount[2]：Z轴方向回读补偿点数量。
extend 是否自动扩展补偿区域。
0：不会自动扩展补偿区域，当超出补偿区域后补偿值立即清0。
1：将补偿区域自动向外扩展一个步长，扩展后的边界上的补偿值为0，当超出补偿区域时在一个步长内将补偿值渐变到0。。

指令返回值：

17051：pointCount参数超限。
17500：tableIndex参数错误。
17505：rangeIndex[0]参数小于1，或者rangeIndex[0]+rangeCount[0]大于补偿表的count[0]。
17506：rangeIndex[1]参数小于1，或者rangeIndex[1]+rangeCount[1]大于补偿表的count[1]。
17507：rangeIndex[2]参数小于1，或者rangeIndex[2]+rangeCount[2]大于补偿表的count[2]。

其他返回值请参照通用返回值说明。

相关指令：

GTN_SetCompensate3DTable