此功能傳回指定的掃描弧段終點的指數：ARCSEGMENTENDINDEX(<ID>, <index>,<tol1>,<tol2>)

<ID> – 第一個參數是掃描段的 ID 字串值，函式在該掃描段上提取弧段終點指數。ID 字串值既可是引號中的 ID，也可以是強制型轉爲字串類型時作爲掃描段的 ID 結束的運算式。

<index> – 第二個參數是要獲取其終點數值的弧的指數。這是一個基值。例如，如果要獲取掃描段的第三個弧段的終點數，則弧的指數爲 3。

<tol1> – 第三個參數是一般特徵公差。它是將掃描分解爲線與弧所採用的最大形狀誤差。

<tol2> – 第四個參數是改進的公差。一般而言，此公差更爲嚴格，它用於從特徵的任意一端取點，直至弧段的形狀誤差在該公差之內。

有了弧段的起點及終點指數後，即可在構造特徵內使用這些點以建構一個獨立的弧段特徵。有關相似範例，參閱「從掃描段建立線段特徵的範例」。

此功能傳回指定的掃描弧段起點的指數：ARCSEGMENTSTARTINDEX(<ID>, <index>,<tol1>,<tol2>)。

<ID> – 第一個參數是掃描段的 ID 字串值，函式在該掃描段上提取弧段起點指數。ID 字串值既可是引號中的 ID，也可以是強制型轉爲字串類型時作爲掃描段的 ID 結束的運算式。

<index> – 第二個參數是要獲取其起點數值的弧的指數。這是一個基值。例如，如果要獲取掃描段的第三個弧段的起點數，則弧的指數爲 3。

<tol1> – 第三個參數是一般特徵公差。它是將掃描分解爲線與弧所採用的最大形狀誤差。

<tol2> – 第四個參數是改進的公差。一般而言，此公差更爲嚴格，它用於從特徵的任意一端取點，直至弧段的形狀誤差在該公差之內。

還有兩個附加參數，這兩個參數用於控制已識別的掃描弧段是否合格。僅可運用 PC-DMIS 設定編輯器對此進行變更。任何弧度小於 MinimumArcSegmentRadiusInMM 登陸項目值的弧段均會被捨棄。此參數的預設值爲 2 公釐。同樣，任何弧度大於 MaximumArcSegmentRadiusInMM 登陸項目值的弧段也將被捨棄。此參數的預設值爲 2000 公釐（無需變更此值）。

有了弧段的起點及終點指數後，即可在構造特徵內使用這些點以建構一個獨立的弧段特徵。有關相似範例，參閱「從掃描段建立線段特徵的範例」。

EOF 和 EOL 有關這些函式的資訊，請參考「使用檔案輸入/輸出」一章中的「檢查檔案末尾或行的末尾」。

建立函式：FUNCTION((<PARAM1>, <PARAM2>…), <EXPRESSION>)

建立一個有參數清單所示的參數個數的函式，並將這些參數代入運算式中。

1. • 使用 FUNCTION 關鍵字時的第一項即參數清單。

   • 此清單由以逗點分隔的參數名稱組成。

   • 參數清單也由括弧括住。

   • 第二項即運算式。

   • 運算式包含有參數名稱，在呼叫函式時會將參數代入到參數名稱中。

有關範例，請參閱「泛型函式範例」主題。

此函數在以下配置中返回指定旋轉臺的中心、角位置和矢量值。

GETROTABDATA(<PARAMETER>[,<TABLE>])

此功能返回以下配置的值：

• 單旋轉臺

• 雙旋（獨立）轉臺

• 堆棧的旋轉臺

函數返回的數據與「旋轉臺設定」對話方塊（編輯 | 喜好設定 | 旋轉臺設定）中的數據匹配。有關此對話方塊的更多信息，請參閱「定義旋轉臺」。

中心

• 「中心」 - 傳回目前旋轉臺的 XYZ 中心。

• "CENTER","V" - 傳回目前雙臺或堆棧臺配置的旋轉臺 V 的 XYZ 中心。

• "CENTER","W" - 傳回目前雙臺或堆棧臺配置的旋轉臺 W 的 XYZ 中心。

範例：

ASSIGN/V1=GETROTABDATA("CENTER")	V1 被設爲目前旋轉臺的 XYZ 中心值。
ASSIGN/V1=GETROTABDATA("CENTER","V")	V1 被設爲目前旋轉臺 V 的 XYZ 中心值。
ASSIGN/V1=GETROTABDATA("CENTER","W")	V1 被設爲目前旋轉臺 W 的 XYZ 中心值。

角位置

• 「角度」 - 傳回旋轉臺的當前角度位置。

• 「角度」、「V」 - 傳回目前雙臺或堆棧臺配置的旋轉臺 V 的 角度位置。

• 「角度」、「W」 - 傳回目前雙臺或堆棧臺配置的旋轉臺 W 的 角度位置。

範例：

ASSIGN/V2=GETROTABDATA("ANGLE")	V2 設為傳回旋轉臺的當前角度位置。
ASSIGN/V2=GETROTABDATA("ANGLE","V")	V2 設為傳回旋轉臺 V 的當前角度位置。
ASSIGN/V2=GETROTABDATA("ANGLE","W")	V2 設為傳回旋轉臺 W 的當前角度位置。

向量

• "VECTOR" - 傳回目前旋轉臺的 IJK 向量。

• "VECTOR","V" - 傳回目前雙臺或堆棧臺配置的旋轉臺 V 的 IJK 向量。

• "VECTOR","W" - 傳回目前雙臺或堆棧臺配置的旋轉臺 W 的 IJK 向量。

範例：

ASSIGN/V3=GETROTABDATA("VECTOR")	V3 被設爲目前旋轉臺的 IJK 向量。
ASSIGN/V3=GETROTABDATA("VECTOR","V")	V3 被設爲目前旋轉臺 V 的 IJK 向量。
ASSIGN/V3=GETROTABDATA("VECTOR","W")	V3 被設爲目前旋轉臺 W 的 IJK 向量。

條件運算式求值：IF(<EXPRESSION1>, <EXPRESSION2>, <EXPRESSION3>)

如果 expression1 求值的結果爲 true（非零），則該函式傳回 expression2 的值；否則傳回 expression3 的值。

此運算式有兩個參數。第一個參數指示將檢查哪一個 I/O 通道（可用的數值範圍基於使用的機器）。第二個參數確定軟體是否查詢臂 1 或臂 2。如果將第二個參數設爲 1（一），將查詢臂 2 控制器。若無第二個參數（或設爲零），IO 通道將查詢臂 1 控制器。如未處於多臂模式下，僅可使用臂 1 控制器這個選項。

如果提供的測頭資料類型、測尖 ID、測頭檔案名稱或通道號無效，則運算式求值的結果爲 0。

例如：

ASSIGN/V4=ISIOCHANNELSET(3,0)

設定了通道時，V4 等於 1（求值的結果爲 true）；否則等於 0（求值的結果爲 false）。

此功能傳回指定的掃描線段終點的指數：LINESEGMENTENDINDEX(<ID>, <index>,<tol1>,<tol2>)。

<ID> – 第一個參數是掃描段的 ID 字串值，函式在該掃描段上提取線段終點指數。ID 字串值既可是引號中的 ID，也可以是強制型轉爲字串類型時作爲掃描段的 ID 結束的運算式。

<index> – 第二個參數是要獲取其終點數值的線段的指數。這是一個基值。例如，如果要獲取掃描段的第三條線段的終點數，則線段指數爲 3。

<tol1> – 第三個參數是一般特徵公差。它是將掃描分解爲線與弧所採用的最大形狀誤差。

<tol2> – 第四個參數是改進的公差。一般而言，此公差更爲嚴格，它用於從特徵的任意一端取點，直至弧段的形狀誤差在該公差之內。

有了線段的起點及終點指數後，即可在構造特徵內使用這些點以建構一個獨立的線段特徵。有關相似範例，參閱「從掃描段建立線段特徵的範例」。

 

此函式傳回指定的掃描線段起點的指數：LINESEGMENTSTARTINDEX(<ID>, <index>,<tol1>,<tol2>)。

<ID> – 第一個參數是掃描段的 ID 字串值，函式在該掃描段上提取線段起點指數。ID 字串值既可是引號中的 ID，也可以是強制型轉爲字串類型時作爲掃描段的 ID 結束的運算式。

<index> – 第二個參數是要獲取其起點數值的線段的指數。這是一個基值。例如，如果要獲取掃描段的第三條線段的起點數，則線段指數爲 3。

<tol1> – 第三個參數是一般特徵公差。它是將掃描分解爲線與弧所採用的最大形狀誤差。

<tol2> – 第四個參數是改進的公差。一般而言，此公差更爲嚴格，它用於從特徵的任意一端取點，直至弧段的形狀誤差在該公差之內。

還有另外一個附加參數，這個參數用於控制已識別的掃描線段是否合格。僅可使用 PC-DMIS 設定編輯器對此進行變更。任何長度小於 MinimumLineSegmentLengthInMM 登陸項目值的線段均被捨棄。此參數的預設值爲 2 公釐。

有了線段的起點及終點指數後，即可在構造特徵內使用這些點以建構一個獨立的線段特徵。有關範例參閱「從掃描段建立線段特徵的範例」。

此功能傳回目前測頭或指定測頭的資料：PROBEDATA(<OPTPROBEDATATYPE>, <OPTTIPID>, <OPTPROBEFILENAME>)

該函式最多有三個可選參數。如要使用一個以上的參數，祇需用逗點分隔參數即可。空參數之間無需逗點。例如，要獲取目前測頭的直徑，使用 ASSIGN/V1 = PROBEDATA("DIAM")。

OPTPROBEDATATYPE - 指定了運算式要傳回的測頭資料的可選參數。如未提供此參數，傳回目前測尖 ID。此參數爲 string 型。任何爲有效字串運算式的運算式可置於第一個運算式欄中。第一個參數的有效的字串運算式（大小寫不敏感）應包括以下內容。這些是字串運算式，且應當放在雙引號中：

"Offset" - 測尖 X,Y,Z 偏移測量值。傳回 point 型。

"Vector" - 測尖向量。傳回 point 型。

"A" - 測尖 A 角。傳回 double 型。

"B" - 測尖 B 角。傳回 double 型。

"Diam" 或 "Diameter" - 測尖直徑的測量值。前四個字母要求爲 "Diam"，但也可包括多個字母乃至 "Diameter" 全名。傳回 double 型。

"Thick" 或 "Thickness" - 測尖厚度的測量值。前五個字母要求爲 "Thick"，但也可包括多個字母乃至 "Thickness" 全名。傳回 double 型。

"Date" - 測尖最近一次檢驗的日期。傳回 string 型。

"Time" - 測尖最上一次檢驗的時間。傳回 string 型。

"ID" - 測尖 ID。預設參數。傳回 string 型。

"PrbRdv" - 測頭徑向偏差。傳回 double 型。

"Standarddeviation" - 測頭標準偏差。傳回 double 型。

"C" - CW43 光測頭的 C 角。傳回 integer 型。

在 「Offset」、"Diameter" 或 "Thickness" 的前面新增一個 "T"，將傳回理論資訊（如 TOFFSET、TDIAMETER 和 TTHICKNESS）。

OPTTIPID - 這一可選參數指定了獲取第一個運算式中指定的測頭資料時要採用的測尖。如未提供測尖，則採用目前測尖。此參數應爲 string 型。

OPTPROBEFILENAME - 這一可選參數指定了獲取測頭資料時要採用的測頭檔名。如未提供測頭檔名，則採用目前測頭檔案。

範例：

ASSIGN/V1=PROBEDATA()	V1 設定爲目前的測尖ID（即「T1A0B0」）
ASSIGN/V2=PROBEDATA("TOFFSET","T1A45B0")	V2 設定爲測尖 T1A45B0 的測頭理論偏移。
ASSIGN/V3=PROBEDATA("Date","T1A90B90","MYPROB")	V3 設定爲表示測頭檔案 MYPROB的測尖 T1A90B90 最上一次檢驗的日期。

此功能將中心或向量設定為新的輸入值：SETROTABDATA(<PARAMETER>,<NewValue>[,<TABLE>])
此功能在以下配置中將中心或向量設定為新的輸入值：

• 單旋轉臺

• 雙旋（獨立）轉臺

• 堆棧的旋轉臺

中心

• 「中心」，<新值> - 將旋轉臺的 XYZ 中心設定為新值。

• 「中心」、「新值」 - 將目前雙臺或堆棧臺配置的旋轉臺 V 的 XYZ 中心設定為新值。

• 「中心」、「新值」、「W」 - 將目前雙臺或堆棧臺配置的旋轉臺 W 的 XYZ 中心設定為新值。

範例：

ASSIGN/V1=SETROTABDATA("CENTER",NewValue)	V1 為傳回代碼（1=成功，0=失敗）。
ASSIGN/V1=SETROTABDATA("CENTER",NewValue,"V")	V1 為傳回代碼（1=成功，0=失敗）。
ASSIGN/V1=SETROTABDATA("CENTER",NewValue,"W")	V1 為傳回代碼（1=成功，0=失敗）。

向量

• 「向量」，<新值> - 將旋轉臺的 IJK 向量設定為新值。

• 「向量」、「新值」 - 將目前雙臺或堆棧臺配置的旋轉臺 V 的 IJK 向量設定為新值。

• 「向量」、「新值」、「W」 - 將目前雙臺或堆棧臺配置的旋轉臺 W 的 IJK 向量設定為新值。

範例：

ASSIGN/V2=SETROTABDATA("VECTOR",NewValue)	V2 為傳回代碼（1=成功，0=失敗）。
ASSIGN/V2=SETROTABDATA("VECTOR",NewValue,"V")	V2 為傳回代碼（1=成功，0=失敗）。
ASSIGN/V2=SETROTABDATA("VECTOR",NewValue,"W")	V2 為傳回代碼（1=成功，0=失敗）。

該函式有一個參數，這個引數既可爲數值，亦可爲字串（字串應爲特徵 ID）。

TUTORELEMENT(<PARAMETER>)TUTORELEMENT(<PARAMETER>)

該函式結合變數類型結構使用。有關結構及子元素的說明，請參閱「結構」。

範例：

ASSIGN/E=TUTORELEMENT(1)	建立一個 Tutor 元素結構
ASSIGN/WM=TUTORELEMENT(n)	對於 1 以上的任何數值，則建立一個有 n 個 Tutor 元素結構的陣列。
ASSIGN/CIR1E=TUTORELEMENT("CIR1")	將特徵 CIR1 的資料複製到 Tutor 元素結構。

 

TutorElement 結構目前有以下子元素：

子元素	描述
ID	特徵 ID 字串
類型	INTEGER (FTYPE)
X, Y, Z	X、Y、Z 坐標值
PR	極半徑
PA	極角
CX	I
CY	J
CZ	K
分米	直徑 1
DM2	直徑 2
DS	與原點的距離
A	角度
AXY	XY 平面中的角度
AYZ	YZ 平面中的角度
AZX	ZX 平面中的角度
F	形狀誤差
SDEV	標準差
TP	位置

 

此函式傳回當前或指定的校驗工具的資料。其語法爲：

QUALTOOLDATA(<TOOLINFO>, <TOOLID>, <FACENUMBER>)QUALTOOLDATA(<TOOLINFO>, <TOOLID>, <FACENUMBER>)

此函式最多可有三個參數。至少需有一個參數以傳回資料：

第一個參數 <TOOLINFO> 指定傳回校準工具的資訊類型的字串。若未傳遞此參數，函式將傳回目前校準工具或指定的校準工具的名稱。

• “CTE” 或 “COEFFICIENTOFTHERMALEXPANSION” - 這些字符串中的任一個將熱膨脹係數返回為雙倍值。

• "DIAM" - 此字符串傳回 double 型的工具直徑值。

• "ID" - 此字符串傳回字符串型的工具名稱。

• "LENGTH" - 此字符串與「DIAM」的功用相同。它還會傳回 double 型的工具直徑值。

• "OVERRIDEIJK" - 此字符串傳回 point 型的搜尋覆寫 IJK 向量。

• "POLYDIAM" - 此字符串傳回 double 型的指定多面體的面的直徑。

• "POLYIJK" - 此字符串傳回 point 型的指定多面體的面的 IJK 向量。

• "POLYXYZ" - 此字符串傳回 point 型的指定多面體的面的 XYZ 中心。

• "SHANKIJK" - 此字符串傳回 point 型的測桿的 IJK 向量。

• ·"TYPE" – 此字符串傳回整數值的工具類型（0 表示球體，1 表示臂2 球體，2 表示多面體，3表示臂 2 多面體）。

• "WIDTH" - 不再使用此參數。

• "XYZ" - 此字符串傳回 point 型的工具的 XYZ 位置。

第二個參數 <TOOLID> 是指定使用者要接收資訊的校準工具之名稱的字串。若未傳遞此參數，PC-DMIS 假定您要接收目前校準工具的資訊。字串不區分大小寫。

第三個參數是 <FACENUMBER>，僅需在校準工具爲多面體類型，且第一個參數爲「POLYXYZ」、「POLYIJK」或「POLYDIAM」時使用。該參數爲整數值，指定的是用於獲取資料的多面體工具的面。

範例：

ASSIGN/VDIAM=QUALTOOLDATA("DIAM","SPHERE_1_IN")	爲變數 VDIAM 指派工具 SPHERE_1_IN 的直徑。
ASSIGN/VID=QUALTOOLDATA("ID")	爲變數 VID 指派目前工具的名稱。
ASSIGN/VTYPE=QUALTOOLDATA("TYPE")	爲變數 VTYPE 指派目前工具的類型。
ASSIGN/VPOLYDIAM=QUALTOOLDATA("POLYDIAM","POLYTEST",3)	爲變數 VPOLYDIAM 指派多面工具 POLYTEST 的第 3 個面的直徑。