Maxwell 3D v11中自定义参数模型的建立
Maxwell 3D v11版已经支持用户自己定义建立参数模型，比如基本模型中没有管状件，需要生成两个圆柱，然后布尔运算才可以实现。这里我们就给Maxwell添加参数化建立这个模型的功能。
在VC中建立一个普通Win32的动态连接库DLL项目Tube，在项目中添加UserDefinedPrimitiveStructures.h和UserDefinedPrimitiveDLLInclude.h两个文件，这两个文件放在X:/Program Files/Ansoft/Maxwell11/UserDefinedPrimitives/Examples/Headers目录中。
然后在Tube.cpp中添加如下代码：
#include "Headers/UserDefinedPrimitiveDLLInclude.h" //包含预定义
static struct UDPPrimitiveTypeInfo primitiveInfo =
{
"TubeModel", //模型标题
"Create a tube model with Z axis as axis. Written by Hottomson", //关于模型的说明
"CHINA", //单位信息
"08-22-2006", //开发日期
"1.0" //版本
};
extern "C" DLLEXPORT
struct UDPPrimitiveTypeInfo* GetPrimitiveTypeInfo()
{
return &primitiveInfo;
}
struct UDPPrimitiveParameterDefinition primParams[] =
{
{"Xpos", "X Position of center point", kUDPLengthUnit, 0},
{"Ypos", "Y Position of center point", kUDPLengthUnit, 0},
{"OutRad", "Outer Radius of tube", kUDPLengthUnit, 15},
{"inRad", "Inner Radius of tube", kUDPLengthUnit, 12},
{"Length", "Length of tube model", kUDPLengthUnit, 100},
//定义所有用到的参数名称、说明、单位、默认值
};
static int numOfParameters = sizeof(primParams)/sizeof(primParams[0]);
extern "C" DLLEXPORT
int GetPrimitiveParametersDefinition(struct UDPPrimitiveParameterDefinition** paramDefinition)
{
*paramDefinition = primParams;
return numOfParameters;
}
extern "C" DLLEXPORT
char* GetLengthParameterUnits()
{
return "mm";
}
// Incase of error this function should return 0
extern "C" DLLEXPORT
int AreParameterValuesValid(char ** error, double* paramValues)
{ //输入数值的有效性判断
double inRad = paramValues[3];
double OutRad = paramValues[2];
double length = paramValues[4];//数值的取出与上面参数表的定义对应
if (inRad <= 0)
{
*error = "Inner Radius of tube should be more than 0.";
return 0;
}
if (OutRad <= 0)
{
*error = "Outer Radius of tube should be more than 0.";
return 0;
}
if (length <= 0)
{
*error = "Length of tube model should be more than 0.";
return 0;
}
if (OutRad <= inRad)
{
*error = "Outer Diameter of tube should be more than the inner Diameter.";
return 0;
}
return 1;
}
extern "C" DLLEXPORT
long CreatePrimitive(struct UDPFunctionLib* functionLib, void* callbackData, double* paramValues)
{
//生成实体过程
functionLib->addMessage(kUDPInfoMessage, "Start to create tube model", callbackData);
//在消息栏添加开始生成模型的消息
double inRad = paramValues[3];
double outRad = paramValues[2];
double length = paramValues[4];
struct UDPPosition startPt = {0, 0, 0};
startPt.z=-length/2;
long idInCyl=functionLib->createCylinder(kUDPZAxis, &startPt, inRad, length, callbackData);
//生成较小的圆柱体
if (idInCyl == -1)
{
functionLib->addMessage(kUDPErrorMessage, "Could not create inner cylinder", callbackData);
return 0;
}
long idOutCyl=functionLib->createCylinder(kUDPZAxis, &startPt, outRad, length, callbackData);
//生成较大的圆柱体
if (idOutCyl == -1)
{
functionLib->addMessage(kUDPErrorMessage, "Could not create outer cylinder", callbackData);
return 0;
}
long success = functionLib->subtract(&idOutCyl, 1, &idInCyl, 1, callbackData);
//两个圆柱体相减
if (success == 0)
{
functionLib->addMessage(kUDPErrorMessage, "Could not sweep profile along path", callbackData);
return 0;
}
functionLib->addMessage(kUDPInfoMessage, "Create tube model end", callbackData);
//在消息栏添加生成模型结束的消息
return success;
}
编译输出，将生成的Tube.dll复制到目录X:/Program Files/Ansoft/Maxwell11/userlib/UserDefinedPrimitives中，此时再打开Maxwell V11，在菜单Draw>User Defined Primitive>UserLib中就出现了Tube这个命令，点击后就出现如同其它实体输入参数的对话框，确定后实体就生成了。
这里生成的实体比较简单，如果你的项目中有的一系列复杂实体，只是几个参数不同，就可以采用这种方法来实现，操作比适用VBScript还要方便，当然这要你有点编程的功底哦。