InterOp:Graphical/Getting Started

From DocR23

Jump to: navigation, search
Showproduct.png



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.

Contents

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.

Features

Key features for 3D InterOp Graphical and 3D InterOp CGM include:

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/catch blocks 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.

Examples

Sample Code

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.

Tutorials

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.

Sample Files

Several sample models have been provided for your convenience. They can be found at the root of your installation's .\Samples\Models folder.

Deprecated APIs

Refer to Deprecated Features for information about deprecated APIs.

Format and Version Support

Refer to Format and Version Support for details.

Personal tools