README_zh_CN.md

dxjt_toolkit

Author: bitbybit3d@163.com

dxjt_toolkit 以C++ API形式，提供以下能力：

• 读取 JT 8.0 - JT 10.5格式 (限于LSG Segment、RangeLOD、Properties、Attributes等)
• 以 JT8.1 个数输出至 JT 文件 (不带Instance的部件可以在Jt2Go正常打开)

简介

个人作品，底层实现 libdxjt 和 dxjt_toolkit 不开源，仅开源用法与演示案例。

libdxjt.dll 为贴近JT格式解析文件内容，而 dxjt_toolkit 则类比 JTOpen Toolkit 转换成类似的装配组织结构。

dxjt_toolkit 依赖 libdxjt.dll，而 libdxjt.dll 依赖 zlib.dll 和 liblzma.dll。

示例

examples/traverse

以控制台形式，打开JT文件，遍历查询它的内容

examples/osgexamples

项目 Plugins jt 系为OSG定制的可以读取JT文件的插件，将产生 osgdb_jtd.dll，若编译成功，会自动拷贝至 OSG 目录，但前提是 OSG_DIR 变量有定义。

项目 osgviewer_jt 仅为方便加载 jt文件用于测试。

JtMFCViewer

未提供源码，在发行版处可以找到，但其实只是 OpenSceneGraph 内的 MFC 范例，额外添加 osgdb_jt.dll 插件用于读取JT文件而已。

重要建议

在 DxJtShape 类，建议采用 getTriangles() 接口一次获取该shape所包含的所有网格数据

Change Log

• 将接口头文件各类，加前缀 Dx，目的是为了加大与 JtOpen 头文件的区分度
• 解决 JT10 版本里边的 Move-to-Front 解码问题
• 修复读取某些JT文件时的错误问题

TODO

• 支持多线程加载
• 增加 Primitive Set 解析
• 了解 JT格式里 JT_PROP_NAME 的构件规则，确保带有Instance的装配可以正确写入(只影响JT格式写出)

参考资源

• JT-v8.1_File_Format_Reference.PDF
• JT-v95_File_Format_Reference_Rev-D.pdf
• ISO14306-2012 Industrial automation systems and integration - JT file format specification for 3D visualization
• ISO14306-2017 Industrial automation systems and integration - JT file format specification for 3D visualization
• JT-V10.5 Format Description and annexs 10292019_tcm27-58011.pdf