Siemens-NXUG二次开发-打开与关闭prt文件[Python UF][20231206]
Siemens-NXUG二次开发-打开与关闭prt文件[Python UF][20231206]
- 1.python uf函数
- 1.1 NXOpen.UF.Part.Open
- 1.2 NXOpen.UF.Part.LoadStatus
- 1.3 NXOpen.UF.Part.Close
- 1.4 NXOpen.UF.Part.AskUnits
- 2.示例代码
- 3.运行结果
- 3.1 内部模式
- 3.2 外部模式
1.python uf函数
1.1 NXOpen.UF.Part.Open
# 内部和外部模式可用
"""
官方文档翻译:将现有NX part或Solid Edge part检索到会话中,并使其成为工作和显示part。
通过从Solid Edge part中提取Parasolids数据,然后将该数据导入到扩展名为.prt的新NX part中,可以打开Solid Edge部件(.par、.psm、.pwd或.asm文件扩展名)。
新NX part的文件名具有Solid Edge part名和“.prt”文件扩展名。
如果存在与Solid Edge part同名的现有NX part,则此函数将返回错误。
通过打开Solid Edge part文件创建的NX part文件包含一个或多个未参数化的实体。
可以通过此调用打开其他文件。
以下扩展名有效-.udf、.bkm、.xpk和.jt。
具有以下扩展名的外来文件也可以使用UF_PART_open打开-.igs、.stp、.dxf、.dwg和.model。
返回值:一个元素,0位置元素为打开part的tag(python语言的int类型),1位置元素为NXOpen.UF.Part.LoadStatus类对象
"""
def NXOpen.UF.Part.Open(self, part_name)
1.2 NXOpen.UF.Part.LoadStatus
# 内部和外部模式可用
类:NXOpen.UF.Part.LoadStatus(在NXOpen C API中是struct UF_PART_load_status_s)
对象方法:
# 如果加载失败并回滚,则为True
def NXOpen.UF.Part.LoadStatus.Failed(sel)
def NXOpen.UF.Part.LoadStatus.Failed(self, value)
# (len:n_parts,free:UF_free_string_array)分配的文件名数组
def NXOpen.UF.Part.LoadStatus.FileNames(self)
def NXOpen.UF.Part.LoadStatus.FileNames(self, value)
# 以下两个已分配数组的长度。加载时出现错误或警告的part数目,这是file_names和status数组中的元素个数(范围)。
def NXOpen.UF.Part.LoadStatus.NParts(self)
def NXOpen.UF.Part.LoadStatus.NParts(self, value)
# (len:n_parts)为每个文件名分配的相关状态代码数组。对数组中的每个状态代码使用UF_get_fail_message来获取关联的消息字符串,必须释放已分配的数组
def NXOpen.UF.Part.LoadStatus.Statuses(self)
def NXOpen.UF.Part.LoadStatus.Statuses(self, value)
# 如果唯一的“失败”是用户中止,则为True
def NXOpen.UF.Part.LoadStatus.UserAbort(self)
def NXOpen.UF.Part.LoadStatus.UserAbort(self, value)
1.3 NXOpen.UF.Part.Close
# 内部和外部模式可用
"""
官方文档翻译:关闭部件树中选定的零件以及它下面的所有零件(可选)。如果您在内部模式下运行此程序,系统会显示一个确认窗口,询问您是否应该关闭修改后的part。如果在外部模式下运行此程序,系统会认为该part应该关闭。
使用UF_part_close关闭part不会删除NX中的撤消标记。因此,如果使用此函数,可能会消耗大量内存。要释放此内存,请在调用UF_PART_close之后调用UF_UNDO_delete_all_marks。
scope指定要关闭的多少part:
0=仅指定部分;
1=part和所有子组件。
mode:
0=询问是否修改了零件(仅限内部,外部假设回答“是,删除”);
1=卸载part,即使已修改
2=仅在未修改的情况下卸载part
"""
def NXOpen.UF.Part.Close(self, part_tag, scope, mode)
1.4 NXOpen.UF.Part.AskUnits
# 内部和外部模式可用
"""
官方文档翻译:返回一个值,该值指示part的单位是英制还是公制。
返回值:
(NXOpen C API宏定义值)UF_PART_METRIC(NXOpen Python UF API:NXOpen.UF.UFConstants.UF_PART_METRIC);
(NXOpen C API宏定义值)UF_PART_ENGLISH(NXOpen Python UF API:NXOpen.UF.UFConstants.UF_PART_ENGLISH)。
"""
def NXOpen.UF.Part.AskUnits(self, part_tag)
2.示例代码
import NXOpen.UF as UF
def get_uf_session():
# 获取当前UF会话
return UF.UFSession.GetUFSession()
def pyuf_open_prt(the_pyuf_session, open_prt_file_name):
"""
功能:打开一个指定文件路径和文件名的.prt文件
"""
# 由于要对Part进行操作,因此需要获取Part实例对象
pyuf_part_instance = the_pyuf_session.Part
# Open方法位于Part类对象中
return pyuf_part_instance.Open(open_prt_file_name)
def pyuf_close_prt(the_pyuf_session, part_tag, scope, mode):
"""
功能:关闭当前工作part
"""
# 由于要对Part进行操作,因此需要获取Part实例对象
pyuf_part_instance = the_pyuf_session.Part
# Close方法位于Part类对象中
return pyuf_part_instance.Close(part_tag, scope, mode)
def pyuf_get_prt_units(the_pyuf_session, part_tag):
"""
功能:查询某prt的单位制
"""
# 由于要对Part进行操作,因此需要获取Part实例对象
pyuf_part_instance = the_pyuf_session.Part
# AskUnits方法位于Part类对象中
return pyuf_part_instance.AskUnits(part_tag)
if __name__ == '__main__':
# 获取uf session
the_pyuf_session = get_uf_session()
# 打开prt文件路径与名称
open_prt_file_name = 'D:\\pyuf_open_prt_test.prt'
# 打开D盘根目录下的示例.prt文件,并成为工作prt(work part)
# 如果是在内部模式运行,则会在NX/UG界面打开一个名为pyuf_open_prt_test.prt的文件窗口
# 如果是外部模式运行,则运行时不会有启动ug界面
open_prt_file_data = pyuf_open_prt(the_pyuf_session, open_prt_file_name)
# 查询prt的单位制
unit_type = pyuf_get_prt_units(the_pyuf_session, open_prt_file_data[0])
prt_unit_string = ""
if unit_type == UF.UFConstants.UF_PART_METRIC:
prt_unit_string = "metric"
elif unit_type == UF.UFConstants.UF_PART_ENGLISH:
prt_unit_string = "english"
# 外部模式运行,会在命令行中打印,但内部模式运行则无反应,因在UF.UI类中操作,才可在NX/UG界面显示数据
# 由于与NX/UG界面UI操作的方法都在UI类中,因此先获取UF.UI示例对象
pyuf_ui_instance = the_pyuf_session.Ui
# 判断信息窗口是否打开
if pyuf_ui_instance.IsListingWindowOpen() == False:
# 信息窗口未打开,先要将其打开
# 打开信息窗口
pyuf_ui_instance.OpenListingWindow()
# 向信息窗口写入内容
pyuf_ui_instance.WriteListingWindow('\nopen_prt_file_name is:' + str(open_prt_file_name))
pyuf_ui_instance.WriteListingWindow('\nopen_prt_file_tag type is:' + str(type(open_prt_file_data)))
pyuf_ui_instance.WriteListingWindow('\nopen_prt_file_tag is:{}'.format(open_prt_file_data))
pyuf_ui_instance.WriteListingWindow('\nunit_type type is:{}'.format(type(unit_type)))
pyuf_ui_instance.WriteListingWindow('\nunit_type is:{}'.format(unit_type))
pyuf_ui_instance.WriteListingWindow('\nprt_unit_string is:{}'.format(prt_unit_string))
# 将信息窗口的内容保存到指定文件中
pyuf_ui_instance.SaveListingWindow('D:\\pyuf_listingwindow_content_test.txt')
# 关闭信息窗口
#pyuf_ui_instance.ExitListingWindow()
3.运行结果
3.1 内部模式
选中要运行的.py文件后,点击“管道通路”即可。
运行结果:
3.2 外部模式
cmd命令:“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_open_prt.py。
powershell命令:&“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_open_prt.py。
运行结果(内存访问违例,不知道为什!!!):