弯管机YBC管型预览控件开发手册.docx
《弯管机YBC管型预览控件开发手册.docx》由会员分享，可在线阅读，更多相关《弯管机YBC管型预览控件开发手册.docx（9页珍藏版）》请在冰豆网上搜索。
弯管机YBC管型预览控件开发手册
BendPreviewCtrl
弯管机YBC管型预览控件
使
用
手
册
上海隆欣自动化技术有限公司
版权声明
本用户手册的所有部分，其著作财产权归属上海隆欣自动化技术有限公司（以下简称隆欣自动化）所有，未经隆欣自动化许可，任何人不可任意仿制，拷贝、誊抄或转译。
本用户手册没有任何形式的担保，立场表达或其他暗示。
若有任何因本用户手册或其所提到之产品的所有信息，所引起的直接或间接的资料流出，利益损失或事业终止，隆欣自动化及其所属员工恕不担负任何责任。
第1章概述
1.1简介
弯管技术广泛应用于锅炉及压力容器,空调制造，汽车，航空航天等多种行业。
管型的形状复杂多变弯管工艺人员通常依据图纸输入关键点的坐标（XYZ坐标），然后生成可以由弯管机设备直接直接完成的加工指令YBC数据由于传统的二维显示界面很难在加工管型之前显示管材的逼真形状。
为此，上海隆欣自动化技术有限公司推出基于OPENGL的YBC管型预览控件BendPreviewCtrl，可以将YBC弯管指令直接预览出最后加工成型的弯子的3D几何形状。
1.2主要性能
Ø由于架构是ActiveX控件所以很容易集成进VB，VC等开发环境中去；
Ø直接导入YBC文本文件，方便简单
Ø采用3D特殊的显示效果，使三维管子非常逼真；
Ø可以用鼠标点中管子的任何部分，并返回选中的管子的信息；
Ø直管弯管用不同的颜色显示，一目了然；
Ø支持视图的平移旋转缩放等操作，可以从任何方位观察管子形状；
Ø支持视图的平移旋转缩放等操作，可以从任何方位观察管子形状；
Ø可以根据客户的需要提供基于WINCE的X86或ARM的嵌入式版本的YBC管型预览控件；
第2章控件接口函数说明
提供全部YBC管型预览的接口函数。
YBC数据文件导入：
voidAPILoadYBCDataFromFile（LPCTSTRpath）
参数：
pathYBC数据文件路径
返回值
功能描述:
导入YBC数据文件。
YBC文件数据格式见附件.
例程：
（以标准C语言为例说明，下同）
管型的选取以及查询：
BOOLAPIGetSelectedPipe（short*nPipeType,short*nPipeIndexInYBC）
参数：
返回值
nPipeType得到管型的类型，0为直管，1为弯管
nPipeIndexInYBC为当前选中管在管子中的位置
功能描述:
当鼠标点中3d管子时候返回点中的管子的类型以及索引。
.
例程：
（以标准C语言为例说明，下同）
voidAPISelectByYBCNum（shortnum）
参数：
num指定选中的哪段管子
返回值
功能描述:
指定选中哪段管子.
例程：
（以标准C语言为例说明，下同）
视图控制：
voidAPIZoomOut（）
参数：
返回值无
功能描述:
视图放大.
例程：
（以标准C语言为例说明，下同）
voidAPIZoomIn（）
参数：
返回值无
功能描述:
视图缩小.
例程：
（以标准C语言为例说明，下同）
voidAPIRotateView（）
参数：
返回值无
功能描述:
视图旋转.
例程：
（以标准C语言为例说明，下同）
voidAPIMoveView（）
参数：
返回值无
功能描述:
视图平移.
例程：
（以标准C语言为例说明，下同）
voidAPIResetView（）
参数：
返回值无
功能描述:
视图还原.
例程：
（以标准C语言为例说明，下同）
APIMoveViewTop（）
参数：
返回值无
功能描述:
视图上移.
例程：
（以标准C语言为例说明，下同）
voidAPIMoveViewDown（）
参数：
返回值无
功能描述:
视图下移.
例程：
（以标准C语言为例说明，下同）
voidAPIMoveViewLeft（）
参数：
返回值无
功能描述:
视图左移.
例程：
（以标准C语言为例说明，下同）
voidAPIMoveViewRight（）
参数：
返回值无
功能描述:
视图右移.
例程：
（以标准C语言为例说明，下同）
voidAPIMoveViewRight（）
参数：
返回值无
功能描述:
视图右移.
例程：
（以标准C语言为例说明，下同）
第3章YBC格式说明
（1）PipeLength
管长
（2）PipeRadius
管径
（3）YBCNum
YBC的个数
（4）YBCR
YBC数据以及轮模半径
第4章控件的使用说明
（1）控件的加载：
在注册完控件后，打开vb6.0
在如下图位置点击右键
然后选
找到预览控件后点击确定
此时会在左边的工具栏出现预览控件的图标，如下图所示：
此时可以把预览控件拖进vb的窗口进行编程；
（2）控件的使用：
通过调用函数voidAPILoadYBCDataFromFile（LPCTSTRpath）;
加载YBC文件，具体格式请参看YBC.txt的格式
每次加载后都自动清空以前的YBC管型预览数据
加载完后可以通过鼠标中键盘滑轮来缩放合适视图
其中管子有3种颜色
一种是直管
一种是弯管
一种是最后剩余的直管
用鼠标左键可以选中管子，选中的管子用红色标识，通过调用APIGetSelectedPipe函数可以知道管子的选中的信息
如下是鼠标选中的直管的情形
升级会员 