Free Trial

Teigha trial versions have full access to the Teigha API for building and running downloaded sample applications and for working with your own applications. Trial versions are available for:

  • Teigha Core
  • Teigha Architecture
  • Teigha BIM
  • Teigha Civil
  • Teigha for Java
  • Teigha Mechanical
  • Teigha.NET
  • Teigha.NET Classic
  • Teigha PRC
  • Teigha PRC.NET
  • TeighaX

Teigha supports many platforms, but trial versions are available only for Windows using these configurations:

  • Visual Studio 8 2005 DLL
  • Visual Studio 9 2008 DLL
  • Visual Studio 10 2010 DLL
  • Visual Studio 11 2012 DLL
  • Visual Studio 12 2013 DLL

NOTE: For Teigha for Java and TeighaX, only Visual Studio 2010 DLL configuration is available. For Teigha Architecture Visual Studio 2015 DLL configuration is available in addition. For Teigha BIM Visual Studio 2013 DLL for Windows XP is available in addition.

Each trial version can be run on one computer only and is valid for 60 days. During trial period users have full access to the documentation and support forum.

Trial versions require a subscription account, an electronically signed license agreement, and license activation. Other ways to evaluate Teigha include downloading Teigha File Converter, Teigha Viewer, Teigha Xtension (TX) SDK, and Teigha Online File Converter which do not require a subscription account.

Getting the Trial Subscription

  1. Request a subscription at https://manage.opendesign.com/node/add/membership-application
  2. Wait for subscription approval.
  3. Sign the trial license agreement with an electronic signature.

The 60-day evaluation period starts from this point.

You’ll receive an email that contains your trial subscription account information for downloading the trial version.

Downloading Trial Versions

  1. Log in at https://www.opendesign.com/trial
  2. Choose a folder:
    • Teigha — Contains Teigha Core in Teigha*.zip filenames and Teigha PRC in TP*.zip filenames.
    • Teigha.Java — Contains Teigha for Java in Teigha.Java*.zip filenames.
    • Teigha.NET — Contains Teigha.NET in Teigha.NET*.zip filenames.
    • Teigha.NET_Classic — Contains Teigha.NET Classic in TeighaNetClassic*.zip filenames.
    • TeighaX – Contains TeighaX in TeighaX_vc10dll_*.lic.msi filename, where * is the Teigha version number.
    • Teigha_Architecutre — Contains Teigha Architecture in TA*.zip filenames.
    • Teigha_BIM — Contains Teigha BIM in TB*.zip filenames.
    • Teigha_Civil — Contains Teigha Civil in TC*.zip filenames.
    • Teigha_Mechanical — Contains Teigha Mechanical in TM*.zip filenames.
    • Teigha_Prc.NET — Contains Teigha PRC.NET in TP.NET*.zip filenames.
  3. Choose a platform subfolder. Platform-dependent archives are located in separate subfolders for easy access.

    For example, to download Teigha Civil for the Win32 platform, choose the /trial/Teigha_Civil/Win32 folder.

    NOTE: Archives for Teigha for Java, Teigha.NET, Teigha.NET Classic, Teigha PRC.NET are not separated into platform dependent subfolders.

  4. Choose a file to download according to your configuration.

    For example, Teigha Core trial version built with Microsoft Visual Studio 2012 has the following name: Teigha_vc11dll.lic.zip.

    Name Description
    vc8dll Visual Studio 8 2005 DLL
    vc9dll Visual Studio 9 2008 DLL
    vc10dll Visual Studio 10 2010 DLL
    vc11dll Visual Studio 11 2012 DLL
    vc12dll Visual Studio 12 2013 DLL
    vc12xp_dll Visual Studio 12 2013 DLL for Windows XP
    vc14dll Visual Studio 14 2015 DLL

    TeighaX trial version is available only for the Visual Studio 2010 DLL configuration, therefore only TeighaX_vc10dll_X.YY.N.lic.msi can be downloaded.

  5. For all Teigha trial versions, except TeighaX: Unpack the downloaded files to your local drive (for example, C:\Teigha\Trial). If you use multiple Teigha products, you can unpack all files into one folder. First unpack Teigha Core, then unpack other downloads and overwrite existing files.

    NOTE: For Windows XP, install an appropriate version of Visual Studio Redistributable Package before generating license keys.

    For TeighaX trial version: Run the downloaded installation file and follow the instructions of the installation program.

You must obtain license keys and activate the trial versions next, otherwise errors will occur when you use Teigha trial versions.

Generating License Keys and Activating Trial Versions

For All Teigha Trial Versions Except TeighaX

  1. Start the command prompt. (Choose Start > Run, type “cmd”, and press Enter.)
  2. Change directories to the location of LicenseMgrApp.exe in your Teigha trial folder. For example, if you downloaded a trial version built with Visual Studio 2012 and unpacked it to C:\Teigha\Trial, use the command: cd C:\Teigha\Trial\exe\vc11dll.
  3. Because applications based on Teigha trial versions are restricted to running on a single computer, generate a hardware ID for your computer:

    LicenseMgrApp.exe -c getHardwareID

    The generated hardware ID displays in the window:

  4. Log in at: https://manage.opendesign.com/manage-license-keys
  5. On the License Key Management page, generate a license key for Teigha Core, which is required for evaluation of all Teigha products:
    • Select Teigha Core from the list.
    • Enter the hardware ID that you obtained previously.
    • Click Generate Key.
  6. Generate license keys for other Teigha products you want to evaluate.

    NOTE: Teigha.NET, Teigha.NET Classic and Teigha PRC.NET use Teigha Core key and don’t need key generation.

  7. Highlight a generated license key and copy it to the clipboard.

    If a license key was not generated, an error message displays. For help resolving the issue, see the Trial Forum for contact information.

  8. Return to the command prompt and enter the following:

    LicenseMgrApp.exe -c activateLicense -n <user name> -k <activation-key>

    Where <user name> is the username you received from Open Design Alliance and <activation-key> is the license key you copied previously.

  9. Repeat for each license key you obtained.

Teigha trial versions are now ready to use.

For TeighaX Trial Version

If you have an activated Teigha Core trial license on your computer:

  1. Copy TeighaLicense.ini from Teigha trial version folder to one of the following (* is the Teigha version number):
    • C:\Program Files\Common Files\TeighaX * for a 32-bit system.
    • C:\Program Files (x86)\Common Files\TeighaX * for a 64-bit system.

If you don’t have an activated Teigha Core trial license on your computer:

  1. Copy LicenseManagerApp.exe from one of the following folders (* is the Teigha version number):

    • C:\Program Files\Common Files\TeighaX * for a 32-bit system.
    • C:\Program Files (x86)\Common Files\TeighaX * for a 64-bit system.

    And place the file in any other folder where it can be run without elevated privileges (for example, a current user folder).

  2. Follow activation steps for Teigha Core in that folder. Upon success, TeighaLicense.ini file is created.
  3. Copy TeighaLicense.ini which was created during the previous step back to (* is the Teigha version number):

    • C:\Program Files\Common Files\TeighaX * for a 32-bit system.
    • C:\Program Files (x86)\Common Files\TeighaX * for a 64-bit system.

TeighaX trial version is now ready to use.

Running the Samples

Sample applications are pre-built in the exe\<configuration> folder and can be run immediately after activating the trial versions. At the command prompt, run any sample application without arguments to display information about its usage.

NOTE: If you run samples without a valid license key, errors display and the command prompt closes.

To use a sample, enter the sample application executable file name followed by arguments, for example:

OdCopyEx test.dxb test_copy.dwg

The following samples are recommended as a starting point for evaluating Teigha. For a full list of samples and their descriptions, go to: https://docs.opendesign.com/td/td_samples.html

Converting a Drawing File to a New Type and Version

OdCopyEx reads a drawing file and saves it as a new .dwg, .dxf, or .dxb file. It illustrates:

  • Teigha initialization
  • File loading into a database
  • Auditing of a loaded database
  • Saving a database to a specified file version and type
  • Assert function customization

OdCopyEx has the following parameters and usage:

NOTE: The target file extension must be the same as OutType, or it should be .dwg if OutType is not specified.

Reading a Drawing File

OdReadEx reads a drawing file and displays all information about the entities and object types located in the file. It illustrates:

  • Teigha initialization
  • File loading, including password-protected files
  • Parsing of a loaded database
  • Switching on entity/object types using protocol extensions
  • Accessing various object properties
  • Getting entity geometry via vectorization
  • Assert function customization

OdReadEx has the following parameters and usage:

Creating a Drawing File

OdWriteEx creates a new drawing, populates it with various entities, and saves to a file. It illustrates:

  • Creating various entities and objects
  • Freezing local time to create drawings with the same creation/modification time (useful for comparing created drawings while testing)
  • Providing a bitmap device for drawing preview creation
  • Using a custom AuditInfo object to save audit messages to a file
  • Using support files (fonts, etc.) from a third-party, if available
  • Saving a password-protected file
  • Assert function customization

OdWriteEx has the following parameters and usage:

NOTE: The filename parameter must have a file extension that is equal to OutType; .dwg is used if OutType is not specified. To use the [UseUnloadPaging | UseFilePaging] parameter, OutVer and OutType must be specified.

Extracting Text From a Drawing File

OdExtractTextEx extracts text content from a drawing file to the command prompt window (or redirects to a file). It illustrates:

  • Teigha initialization
  • File loading into a database
  • Parsing of a loaded database
  • Switching on entity types using protocol extensions
  • Assert function customization

OdExtractTextEx has the following parameters and usage:

NOTE: The extension of the drawing file should be .dwg, .dxf, or .dxb.

Creating Custom Applications Based on the Samples

Overview of Teigha Contents

The following folders are created when the trial versions are unpacked (except for TeighaX):

  • Architecture — Teigha Architecture header files and sample applications (included with the Teigha Civil trial version).
  • Bim — Teigha BIM header files and sample applications.
  • Civil — Teigha Civil header files and sample applications.
  • Core — Teigha Core header files and sample applications.
  • Dgn — Header files and sample applications for working with .dgn files.
  • exe — Pre-built sample applications and DLLs for a particular build configuration (for example, exe\vc11dll contains executables and DLLs for Microsoft Visual Studio 2012 C++ compiler and DLL configuration).
  • lib — Static libraries required to build sample applications for a particular build configuration (for example, lib\vc11dll contains static libraries for Microsoft Visual Studio 2012 C++ compiler and DLL configuration).
  • Mechanical — Teigha Mechanical header files and sample applications.
  • Platforms — Visual Studio solution and project files for building sample applications for a particular build configuration (for example, Platforms\vc11dll contains solution and project files for Microsoft Visual Studio 2012 C++ compiler and DLL configuration).
  • Prc — Teigha PRC (3D PDF) header files and sample applications.
  • Teigha.NET — Teigha.NET assembly information file and sample applications.
  • ThirdParty — Third-party components used by Teigha.

The following folders are created when the TeighaX trial is installed (where * is the Teigha version number):

  • C:\Program Files (x86)\Common Files\TeighaX * — Teigha Core binaries used by TeighaX on a 64-bit system, where * is the Teigha version number. For 32-bit system, the folder is C:\Program Files\Common Files\TeighaX *.
  • Examples — Sample applications source code.
  • Include — Header files for TeighaX.
  • Redist — Merge package files.

Building the Samples for All Trial Versions Except TeighaX

  1. In Microsoft Visual Studio, open a sample application solution file located in the Platforms\<configuration> folder. The following solution files are available:
    • TA*_ex.sln — Contains Teigha Architecture sample application projects, for example, TA_vc11dll_ex.sln.
    • TB*ex.sln — Contains Teigha BIM sample application projects, for example, TB_vc11dll_ex.sln is for Microsoft Visual Studio 2012.
    • TC*ex.sln — Contains Teigha Civil and Teigha Architecture sample application projects, for example, TC_vc11dll_ex.sln is for Microsoft Visual Studio 2012.
    • TM*ex.sln — Contains Teigha Mechanical sample application projects, for example, TM_vc11dll_ex.sln is for Microsoft Visual Studio 2012.
    • Teigha*ex.sln — Contains Core sample application projects, for example, Teigha_vc11dll_ex.sln is for Microsoft Visual Studio 2012.
    • TeighaNET*ex.sln — Contains Teigha.NET sample application projects, for example TeighaNET_vc11dll_ex.sln is for Microsoft Visual Studio 2012.
    • ODA*.sln — Contains Teigha.NET Classic sample application projects, for example, ODA_vc11dll.sln is for Microsoft Visual Studio 2012.
    • TP.NET*ex.sln — Contains Teigha PRC.NET sample application projects, for example, TP.NET_vc11dll_ex.sln is for Microsoft Visual Studio 2012.
    • TP*ex.sln — Contains Teigha PRC sample applications projects, for example, TP_vc11dll_ex.sln is for Microsoft Visual Studio 2012.
  2. Build the solution to generate binary executable files and libraries for the samples. (Press F7 or choose Build > Build Solution).

    If the build is successful, binary output is placed in the exe\<configuration> folder.

  3. Modify or add your own code to the source code located in the Examples folder to further evaluate Teigha.

Building the Samples for TeighaX

There are no prebuilt samples for TeighaX, but trial users can build the samples from source code. Sample source code is located in the TeighaX trial version installation folder (usually C:\Program Files\Open Design Alliance\TeighaX * for 32-bit systems or C:\Program Files (x86)\Open Design Alliance\TeighaX * for 64-bit systems, where * is the Teigha version number).

To obtain working binary files of TeighaX samples for .NET (located in Example/.NET subfolder), the following steps may be required:

  1. Open a solution, for example, sharpTest.sln.

    You can virtually use any version of Visual Studio supported by Teigha and upgrade the solution if it’s requested.

  2. Check whether the Platform property in the Visual Studio Standard toolbar is “x86 CPU architecture”. If yes, go to Step 6 to build the solution immediately. If no, continue to the next step.
  3. On the Standard toolbar, select “Configuration Manager...”.

  4. For each configuration (Debug/Release) you are going to build, do the following:

    • In Platform, select New. The New Project Platform dialog displays.
    • In New platform, select x86.
    • Click OK.

  5. Verify that the solution platform is updated as shown below, and then click Close.

  6. Build the example.

Getting More Information

Use the following resources to continue your evaluation of Teigha.

Documentation

Teigha: https://docs.opendesign.com/td/

Teigha Getting Started: https://docs.opendesign.com/td/GettingStarted_html.html

Teigha BIM: https://docs.opendesign.com/tbim/

Teigha.NET: http://docs.opendesign.com/tnet/

Teigha for Java: http://docs.opendesign.com/tjava/

Teigha PRC: https://docs.opendesign.com/tprc/

Teigha PRC.NET: http://docs.opendesign.com/tprcnet/

Teigha Architecture: https://docs.opendesign.com/ta/

Teigha Civil: https://docs.opendesign.com/tc/

Teigha.NET Classic: http://docs.opendesign.com/tdn/

TeighaX: https://docs.opendesign.com/tdx/

Forum

Use the following forum thread for special issues and discussions about trial versions, including downloading and activation: http://forum.opendesign.com/forumdisplay.php?48-Teigha-Trial-Versions

Use the main forum to search for answers and to ask questions about technical issues and general Teigha usage: http://forum.opendesign.com/