Data Exchange

Currently, Jiushao Kernel supports import/export of BREP files, mesh file reading/writing (OBJ, STL), import/export of IGES/IGS files, and import/export of STEP files.

BREP File Import/Export

Import

AMCAX::OCCTIO::OCCTTool::Read provides the functionality to import BREP files.

AMCAX::TopoShape shape;
AMCAX::OCCTIO::OCCTTool::Read(shape, "./data/box.brep");

Export

AMCAX::OCCTIO::OCCTTool::Write provides the functionality to export BREP files.

// Construct a box
AMCAX::Point3 p1(-5.0, -5.0, 0.0);// diagonal corner points
AMCAX::Point3 p2(5.0, 5.0, 3.0);// diagonal corner points
AMCAX::TopoShape box = AMCAX::MakeBox(p1, p2);
 
// Write a shape to a file
AMCAX::OCCTIO::OCCTTool::Write(box, "./box.brep");

Mesh File Reading/Writing

OBJ

AMCAX::Meshing::Mesh::OBJReader provides the functionality to read OBJ files; AMCAX::Meshing::Mesh::OBJWriter provides the functionality to write OBJ files.

// Read
AMCAX::Meshing::Mesh::IOOptions io_options;
AMCAX::Meshing::Mesh::OBJReader< AMCAX::Meshing::Mesh::TriSoupTraits_Coord> obj_reader;
obj_reader.read("./data/cow.obj", io_options);
 
// Write
AMCAX::Meshing::Mesh::OBJWriter< AMCAX::Meshing::Mesh::TriSoupTraits_Coord> obj_writer;
std::streamsize precision = 10;// Precision of floating point numbers
obj_writer.write("cow1.obj", io_options, precision);

STL

AMCAX::Meshing::Mesh::STLReader provides the functionality to import STL files; AMCAX::Meshing::Mesh::STLWriter provides the functionality to export STL files.

// Read
AMCAX::Meshing::Mesh::IOOptions io_options;
AMCAX::Meshing::Mesh::STLReader< AMCAX::Meshing::Mesh::TriSoupTraits_Coord> stl_reader;
stl_reader.read("./data/cow.stl", io_options);
 
// Write
AMCAX::Meshing::Mesh::STLWriter< AMCAX::Meshing::Mesh::TriSoupTraits_Coord> stl_writer;
std::streamsize precision = 10;// Precision of floating point numbers
stl_writer.write("cow2.stl", io_options, precision);

IGES/IGS Files

Import

AMCAX::IGES::IgesIO::Read provides the functionality to import IGES/IGS files.

Import TopoShape

Supports importing wires, faces, and solids.

Import from iges/igs file

AMCAX::TopoShape ts;
AMCAX::IGES::IgesIO::Read(ts, "./data/test.iges");

Import from data stream

AMCAX::TopoShape ts;
std::ifstream ist("./data/test.iges");
AMCAX::IGES::IgesIO::Read(ts, ist);

Import Label

Import from iges/igs file

AMCAX::Label lb;
AMCAX::IGES::IgesIO::Read(lb, "./data/test.iges");

Import from data stream

AMCAX::Label lb;
std::ifstream ist("./data/test.iges");
AMCAX::IGES::IgesIO::Read(lb, ist);

Export

AMCAX::IGES::IgesIO::Write provides the functionality to export IGES/IGS files.
Before introducing the export functionality, let's explain the configuration parameters.

Configuration 1:

• FACE_MODE: Scattered face mode 【format=0】
• BREP_MODE: Brep mode 【format=1】

Configuration 2: Attribute inheritance strategy for WriteAF (export Label) 【Only effective when Configuration 1 is FACE_MODE】

• WRITE_ATTR_DEFAULT: Default strategy configuration (currently equivalent to WRITE_ATTR_SELF_HIGH_PRI)
• WRITE_ATTR_NOT_INHERIT: Parent topology attributes do not affect child topology
• WRITE_ATTR_SELF_HIGH_PRI: Child topology high priority 【Prioritize using own attributes】
• WRITE_ATTR_SELF_LOW_PRI: Parent topology high priority 【Prioritize using parent topology attributes】

Note:

• WRITE_ATTR_SELF_HIGH_PRI and WRITE_ATTR_SELF_LOW_PRI configurations only take effect when attribute inheritance conflicts occur; when there is no conflict, parent topology attributes are automatically inherited.
• Bitwise OR is only used for combining different configurations, such as: FACE_MODE | WRITE_ATTR_NOT_INHERIT

Export TopoShape

Supports exporting points, wires, faces, and solids as discrete geometric entities.

Export to iges/igs file

// Make a box
AMCAX::Point3 p1(0., 0., 0.);
AMCAX::Point3 p2(2., 2., 2.);
AMCAX::TopoShape ts = AMCAX::MakeBox(p1, p2);
 
// Set output path 
std::string filePath = "./iges/Outpute_TopoToFile.iges";
 
// Write a TopoShape to file
//【default format config = FACE_MODE】
bool ret = AMCAX::IGES::IgesIO::Write(ts, filePath);
if (!ret)
{
    std::cout << "error" << std::endl;
}
 
//【BREP_MODE】
ret = AMCAX::IGES::IgesIO::Write(ts, filePath, BREP_MODE);
if (!ret)
{
    std::cout << "error" << std::endl;
}

Export to data stream

// Make a box
AMCAX::Point3 p1(0., 0., 0.);
AMCAX::Point3 p2(2., 2., 2.);
AMCAX::TopoShape ts = AMCAX::MakeBox(p1, p2);
 
// Write a TopoShape to ostream
std::ostringstream os_t；
//【default format config = FACE_MODE】
bool ret = AMCAX::IGES::IgesIO::Write(ts, os_t);
if (!ret)
{
    std::cout << "error" << std::endl;
}
 
//【BREP_MODE】
ret = AMCAX::IGES::IgesIO::Write(ts, os_t, BREP_MODE);
if (!ret)
{
    std::cout << "error" << std::endl;
}

Export Label

Export to file

// Create box label
auto makeBox = WithAttr<MakeBox>(1.0, 1.0, 1.0);
makeBox.Build();
AMCAX::Label lb = makeBox.GetResultLabel();
 
// Set output path 
std::string filePath = "./iges/Outpute_LabelToFile.iges";
 
// Write a Label to file
//【default format config = FACE_MODE | WRITE_ATTR_DEFAULT】
bool ret = AMCAX::IGES::IgesIO::Write(lb, filePath);
if (!ret)
{
    std::cout << "error" << std::endl;
}
 
//【WRITE_ATTR_NOT_INHERIT Mode】
ret = AMCAX::IGES::IgesIO::Write(lb, filePath, FACE_MODE | WRITE_ATTR_NOT_INHERIT);
if (!ret)
{
    std::cout << "error" << std::endl;
}
 
//【WRITE_ATTR_SELF_LOW_PRI Mode】
ret = AMCAX::IGES::IgesIO::Write(lb, filePath, FACE_MODE | WRITE_ATTR_SELF_LOW_PRI);
if (!ret)
{
    std::cout << "error" << std::endl;
}

Export to data stream

// Create box label
auto makeBox = WithAttr<MakeBox>(1.0, 1.0, 1.0);
makeBox.Build();
AMCAX::Label lb = makeBox.GetResultLabel();
 
// Write a Label to ostream
std::ostringstream os_l;
//【default format config = FACE_MODE | WRITE_ATTR_DEFAULT】
bool ret = AMCAX::IGES::IgesIO::Write(lb, os_l);
if (!ret)
{
    std::cout << "error" << std::endl;
}
 
//【WRITE_ATTR_NOT_INHERIT Mode】
ret = AMCAX::IGES::IgesIO::Write(lb, os_l, FACE_MODE | WRITE_ATTR_NOT_INHERIT);
if (!ret)
{
    std::cout << "error" << std::endl;
}
 
//【WRITE_ATTR_SELF_LOW_PRI Mode】
ret = AMCAX::IGES::IgesIO::Write(lb, os_l, FACE_MODE | WRITE_ATTR_SELF_LOW_PRI);
if (!ret)
{
    std::cout << "error" << std::endl;
}

STEP Files

Import

Supports importing part bodies, names, text descriptions, positions, orientations, and simple assembly information.
To be down.

Export

Supports exporting part bodies, names, positions, orientations, colors, and other information.
To be down.