Welcome to 3D InterOp Graphical and 3D InterOp CGM, the interoperability component technologies that allow you to translate high-quality graphical and geometric modeling data from a variety of formats. 3D InterOp Graphical allows you to see what a model's all about while 3D InterOp CGM allows you to work directly on imported 3D geometric modeling data from within CGM.
Introduction to 3D InterOp Graphical and 3D InterOp CGM
3D InterOp Graphical provides access to high-quality graphical data directly from the source model. With 3D InterOp Graphical, you get the exact visual fidelity required to render data similar to the CAD system used to design the imported model. No modifications or adjustments are made to the graphical data between the source file and your extracting it off our interfaces. If your application has the need to preview a model before translation, validate PMI before sending it off to manufacturing, or to perform data analysis for your customers, 3D InterOp Graphical has the data you're looking for.
3D InterOp CGM allows you to translate B-rep data contained in a source file into an in-memory representation of the data in the form of a CGMContainer that can then be used in subsequent modeling operations or exported to another file format.
Review the Supported Formats Table for a complete list of formats supported by 3D InterOp Graphical and 3D InterOp CGM.
Key features for 3D InterOp Graphical and 3D InterOp CGM include:
- A set of object-oriented APIs for importing graphical and geometric modeling data from a source file as described in Concepts.
- Full API documentation for easy developer reference.
- Installation Guide for getting setup with 3D InterOp Graphical and 3D InterOp CGM.
- Samples and Utilities to aid in learning how to use 3D InterOp Graphical and 3D InterOp CGM.
- Comprehensive tutorials to help developers understand how to best work with Product Structures and import graphical data,
- Developer feedback during imports via Error Handling and Progress Callback.
- Access to graphical data and geometric data exchange for a variety of popular and industry-standard 3D CAD formats.
In addition, 3D InterOp CGM allows you to work on CGM models natively by:
- Importing of B-rep data from the source file into CGM (refer to Object and Part Management in your CGM documentation for information on working with CGM models).
- Exporting of B-rep data into part file and/or assembly files.
- Importing of attributes from the source file into CGM Properties (refer to Properties in your CGM documentation.)
Quick Start Guide
Once you have installed 3D InterOp Graphical or 3D InterOp CGM , you will likely want to begin importing your data right away. There are many resources to help you use 3D InterOp Graphical and 3D InterOp CGM, and you are encouraged to explore them all in more depth as you integrate some of the more advanced features. However, the quickest way to get started is to build and run the sample applications provided with your installation. We encourage you to copy-and-paste code you find in these samples into your own application to serve as a basis for your own implementation.
- CGMPartVisualization Sample shows you how to import and access the graphical data from a source 3D CAD file.
- CGMImportExport Sample shows you how to import B-rep data, access product structure information, and export parts and assemblies to supported formats.
You will also find useful hints on how to use 3D InterOp Graphical and 3D InterOp CGM in the tutorials: Import Product Structure in 3D InterOp Graphical or 3D InterOp CGM, Importing Graphical Data, Importing Geometry into CGM and Exporting Geometry from CGM .
As you explore the samples, keep the following items in mind:
- Before you create any class or invoke any method in 3D InterOp Graphical or 3D InterOp CGM, you must first call CGMInteropSystem::Initialize() with your license key. 3D InterOp CGM will not work without this initialization method being invoked with a valid license key.
- 3D InterOp Graphical and 3D InterOp CGM APIs communicate critical errors by throwing exceptions in the form of a CATError. You are strongly advised to place standard C++
try/catchblocks around all 3D InterOp Graphical and 3D InterOp CGM code. Refer to Error Handling for information about how to best handle exceptions in 3D InterOp Graphical and 3D InterOp CGM.
- All imported data in 3D InterOp Graphical and 3D InterOp CGM is accessed through the source representation's product structure. To access the graphical or B-rep data in a part model, you will need to navigate its product structure to locate the specific instance of your data for import. This navigation is demonstrated in the samples.
Your installation of 3D InterOp Graphical and 3D InterOp CGM includes two extensive sample projects that demonstrate most available functionality and should help get you started using the APIs quickly, including how to:
- Import source files into a Product Structure
- Query and navigate Product Structure assembly tree data
- Import graphical or geometric modeling data
- Start using imported data
In addition for 3D InterOp CGM, the CGMImportExport sample shows you how to:
- Access property information such as Colors and Names
- Export data to XCGM
Refer to Sample Applications for more information on building and running these samples.
The tutorials provided with 3D InterOp Graphical and 3D InterOp CGM explain how to work with the APIs on a practical level and they should be the first place you look when you have a question about how to use the APIs.
- Import Product Structure in 3D InterOp Graphical or 3D InterOp CGM
- Importing Graphical Data
- Importing Geometry into CGM
- Exporting Geometry from CGM
Several sample models have been provided for your convenience. They can be found at the root of your installation's .\Samples\Models folder.
Refer to Deprecated Features for information about deprecated APIs.
Format and Version Support
Refer to Format and Version Support for details.