CNC解釋庫調用接口詳述

以下展示庫函數接口的意義及相關示例編程的部分代碼，關于CNC解釋庫的完整頭文件DMCNC.H，用戶可以咨詢本公司，公司視情況會進行相應的處理。
聲明一點，本庫暫支持C++語言。

# define CW -1
# define CCW 1
//以上兩個宏定義值，為圓弧的順逆時走向

struct D2POINT //二維點
{
double x,y;
};
二維點的結構，主要用于平面設備處理

struct D3POINT: public D2POINT //三維點
{
double z;
};
三維點的結構，可用于浮點雕刻與點膠

struct tag_ARC
{
int nType; //方向

D2POINT ptStart; //起點
D2POINT ptOrgin; //圓心
D2POINT ptEnd; //終點
};
圓弧結構，適合本公司DMC3000控制卡對其坐標關系的定義，唯參數nType方向需要對應函數的0或1的邏輯判斷，往后的例子會說明這一點的。

struct tag_CMD //CNC指令結構
{
char cmd; //G,M,F,S等指令
int nCode; //指令值

int nAxisBit; //驅動軸號位(X,Y,Z,U,A)

D3POINT ptStart; //坐標1
D3POINT ptEnd; //坐標2
D3POINT ptOrgin; //坐標3

double fValue; //一個浮點保留接口
};
CNC指令結構，重點說明一下：
cmd 可以是G，M，C，F，S等設備指令，若客戶想增加其它指令，可通知本公司進行擴充即可。
nCode 指令值，如G指令，可以有00,01,02,03，常表述為G00,G01,G02,G03
nAxisBit 當前行的有效驅動軸，此變量的提取可由函數JP_GET_AXIS進行提取
ptStart, ptEnd 分別為直線或圓弧的起點和終點
ptOrgin 僅為圓弧的圓心
fValue 專門為帶有浮點值的指令保留，如C代碼，可能有表示為 ：C0.317

以下展示一下，tag_CMD的一般用法操作(用以加工的)：
int CNC_MARK( tag_CMD &cmd, tag_CONTROL &ctrlItem )
{//此函數不斷接受到新的CNC指令
//g_DmcCard為一個控制類的實例，如TD3000 g_DmcCard;
//
switch( cmd.cmd ){
case ’G’:
{// 以G代碼為例，以下代碼為對G代碼的處理
if( ctrlItem.nStatus != tag_CONTROL::Running )
return ctrlItem.nStatus;
while( ctrlItem.nStatus != tag_CONTROL::NoRun )
{
DoEvents();//此函數可參見我的相關文章
if( ctrlItem.nStatus==tag_CONTROL::Pause ) continue;
//處理暫停的代碼
if( g_DmcCard.IsRunning() != 1 ) break;
}
if( ctrlItem.nStatus == tag_CONTROL::Running )
{
ctrlItem.cmdCurrent = cmd;//保存當前執行的CNC指令
return DoGCode( cmd, ctrlItem );
//處理G代碼函數（用戶自定）
}
} break;
case ’S’://其它代碼處理
case ’M’:
break;
}
return ctrlItem.nStatus;
}

//處理G代碼的函數
int DoGCode( tag_CMD &cmd, tag_CONTROL &ctrlItem )
{
tag_PARA ¶ = g_Para;//一個參數對象，內容由用戶決定，在此僅作為示例

C3DPoint pt( para.pntWorkOrgin.x, para.pntWorkOrgin.y, para.fZLimit);
//double fsafePos = para.fZLimit - para.fZUpSafe;

switch( cmd.nCode ){
case 0:
{//G00指令

short nAxis(cmd.nCode>>8),i(0);
short axisArray[4];
double pos[4];
if( (nAxis&0x100) != 0 ){
axisArray[i]=XCH;
pos[i++] = cmd.ptStart.x+g_Para.pntWorkOrgin.x;
}
if( (nAxis&0x010) != 0 ){
axisArray[i]=YCH;
pos[i++] = cmd.ptStart.y+g_Para.pntWorkOrgin.y;
}
if( (nAxis&0x001) != 0 ){
axisArray[i]=ZCH;
pos[i++] = pt.z-cmd.ptStart.z ;
}

g_DmcCard.MoveES( i, axisArray, pos,
g_Para.jumpSpeed,
false );
}
break;
case 1:
{//G01指令
g_DmcCard.MoveM3( XCH, YCH, ZCH,
cmd.ptEnd.x+g_Para.pntWorkOrgin.x,
cmd.ptEnd.y+g_Para.pntWorkOrgin.y,
pt.z-cmd.ptEnd.z,
g_Para.workSpeed,
true );
}
break;
case 2://順圓弧，注意方向， tag_CARC是在控制卡類定義的結構
//0為順時，1為逆時
g_DmcCard.Arc( XCH, YCH,
tag_CARC(cmd.ptOrgin.x+g_Para.pntWorkOrgin.x,
cmd.ptOrgin.y+g_Para.pntWorkOrgin.y,
cmd.ptEnd.x+g_Para.pntWorkOrgin.x,
cmd.ptEnd.y+g_Para.pntWorkOrgin.y,0),
g_Para.workSpeed, 0.1 );
break;
case 3://逆圓弧
g_DmcCard.Arc( XCH, YCH,
tag_CARC(cmd.ptOrgin.x+g_Para.pntWorkOrgin.x,
cmd.ptOrgin.y+g_Para.pntWorkOrgin.y,
cmd.ptEnd.x+g_Para.pntWorkOrgin.x,
cmd.ptEnd.y+g_Para.pntWorkOrgin.y,1),
g_Para.workSpeed, 0.1 );
break;
default: break;
}
return ctrlItem.nStatus;

}

以上基本顯示一個G代碼處理過程，若要處理暫停/繼續，也很簡單，等介紹tag_CONTROL結構時，再舉例說明。
struct tag_FILEACTION
{
enum{ Inital, Over, Process };

int nAction;

int nFilePosition;//文件當前位置
int nFileSize;//文件大小

void * pUserData; //保留接口
};
文件進度處理進度結構，注要用于用戶對界面顯示的要求，僅三個動作，初始化，結束，處理中。其中pUserData由用戶自定義，注意，此參數不一定等同于tag_CONTROL的pUserData，不要混淆含義了。

由于常用到進度處理顯示，因此，舉一程序片段如下，以幫助理解：
int FILE_PRO( tag_FILEACTION &action )
{
CCtrlFormView *pView = (CCtrlFormView *)action.pUserData;
// 之所有有這個轉型，是因為初始化有這樣一句代碼
// m_ctrlItem.fileAction.pUserData = ( void *) this;
//m_ctrlItem為CctrlFormView的一個成員函數，初始化動作是在CctrlFormView的
//構造函數完成的.
switch( action.nAction ){
case tag_FILEACTION::Inital:
{
pView->GetDlgItem( IDC_BUTTON_MARK )->EnableWindow( FALSE );
pView->m_nCtrlMode = Ctl_Mark;
pView->m_prgMark.SetRange( short(0), (short)action.nFileSize);
pView->m_prgMark.PostMessage( PBM_SETPOS, 0, 0 );
//初始化進度條
}
break;
case tag_FILEACTION::Process://不斷顯示進度條
pView->m_prgMark.PostMessage( PBM_SETPOS, action.nFilePosition, 0 );
break;
case tag_FILEACTION::Over://處理結束后，作一些處理
pView->m_nCtrlMode = Ctl_Edit;
pView->GetDlgItem( IDC_BUTTON_MARK )->EnableWindow( TRUE );
pView->GetDlgItem( IDC_BUTTON_MARK )->SetWindowText("運行");
pView->m_ctrlItem.nStatus=tag_CONTROL::NoRun;
break;
default: break;
}
return 1;
}

務必記住一點，即使用戶不打算作任何界面上的顯示或處理，也需要定義一個類似于FILE_PRO函數，只要為空即可。

struct tag_CONTROL
{
enum{ NoRun=0, Running=1, Pause=2, Continue=3 };//控制狀態

int nStatus; //執行狀態
tag_CMD cmdCurrent; //當前執行指令

tag_FILEACTION fileAction;//文件處理結構
int (*pfnCncAction)( tag_CMD &cmd, tag_CONTROL &ctrlItem );
//代碼處理函數指針
int (*pfnFileAction)( tag_FILEACTION &action );
//文件進度處理函數指針

double fUnitX,fUnitY; //PLT文件比值
void * pUserData; //保留接口
};

解釋庫中的其它輔助函數的調用，暫時保留，實質上用戶都可以自已解決。
至此，本人已利用此庫完成了一個CNC簡易調試器軟件（以上部分代碼即從此軟件代碼粘貼過來的），及一個文件分析處理的操作，即將CNC文件轉成自定的一些數據結構，以用于3D顯示等等之類。