ODA Trial Version

Getting Started Guide

Free Trial

 

 

ODA trial versions have full access to the ODA platform for building and running downloaded sample applications and for working with your own applications. Currently trial archives are available for Windows 32-bit configuration only (but they can be run on Windows 64-bit platforms as well).

Each product archive contains only its specific modules, and to use a particular archive you need to download all the dependencies:

 

Apply for trial subscription

  1. Request a subscription here. Mark the ODA products you want to evaluate.
  2. Confirm your email address using the confirmation link you receive via email.
  3. Receive your credentials via email and a link for downloading requested trial versions.
  4. Download, unpack and activate the trial archives for the ODA products you want to evaluate.

The 60-day evaluation period starts when you receive the email with your trial subscription account information.

Trial versions are available for the following products:

Basic Package Special Interest Groups (SIG)        .Net, Java, and ActiveX Wrappers
     
ODA Visualize SDK   ODA Drawings SDK for Java
ODA Drawings SDK ODA BimRv SDK ODA Drawings.NET SDK
ODA PRC SDK ODA BimNv SDK ODA PRC.NET SDK
ODA Architecture SDK ODA Mechanical SDK ODA Architecture.NET SDK
ODA Publish SDK ODA Civil SDK ODA Drawings X SDK
     

ODA software supports a wide list of platforms, but trial versions are available only for the Win32 platform as DLL configurations:

  • Visual Studio 2005 - 2013 for basic products
  • Visual Studio 2008 - 2012 for .NET wrappers
  • Visual Studio 2010 for ODA Drawings SDK for Java and ODA Drawings X SDK

NOTE: Since the trial version of ODA Drawings SDK for Java is provided as a 32-bit package, you need to use Java VM for the x86 platform.

Trial and full version archives are updated and released at the same time.
Each trial version runs on one computer only and is valid for 60 days.
During the trial, users have full access to the documentation and support forum (login required).
Trial versions require a subscription account and license activation.

When filling in the subscription application form, specify the list of ODA products you want to evaluate by marking the appropriate check boxes:

products_selector

After approving your e-mail address, you'll receive your credentials and the link for downloading an archive that contains all the trial ODA products you requested.

Follow this link to download and unpack the archive. Select the folder according to the appropriate version of Microsoft® Visual Studio® you want to use:

  • vc8 — Microsoft Visual Studio 2005
  • vc9 — Microsoft Visual Studio 2008
  • vc10 — Microsoft Visual Studio 2010
  • vc11 — Microsoft Visual Studio 2012
  • vc12 — Microsoft Visual Studio 2013

Now you need to activate your trial version (see the next section for details).

email_link

Generating License Keys and Activating Trial Versions

To get additional information about license keys needed for a particular ODA product, please see ODA Trial Version License Keys Map.

For All ODA Trial Versions Except Drawings X

  1. Start the Trial Version Activator Application (TrialActivator.exe) located in the exe folder with prebuilt executables and DLLs.activator
  2. In the Activator Application window, enter your login and password obtained at the subscription step (the login and password are the same as what you used to download the trial archives).
  3. Check that your Internet connection is available. The activator application connects to ODA remote resources during the activation.
  4. Click Activate.
    If the ODA product is successfully activated, the activator application shows a “Success” message.
  5. After successful activation, you can start using the ODA product.

You can generate a license key and activate a trial version in manual mode without using the activator application.

For Drawings X Trial Version

If you have an activated ODA Drawings SDK trial license on your computer:

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

If you don’t have an activated ODA Drawings SDK trial license on your computer:

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

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

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

  2. Follow the manual mode activation steps for the ODA Drawings SDK trial in that folder. Upon success, the TeighaLicense.ini file is created.
  3. Copy TeighaLicense.ini to one of the following folders (* is the ODA software version number):

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

Drawings X trial version is now ready to use.

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 filename followed by arguments, for example:

OdCopyEx test.dxb test_copy.dwg

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

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:

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

See the video at the ODA YouTube channel for an OdCopyEx sample overview.

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:

  • ODA platform 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

See the video at the ODA YouTube channel for an OdReadEx sample application overview.

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

See the video at the ODA YouTube channel for an OdWriteEx sample application overview.

Overview of ODA Software Contents

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

  • Architecture — ODA Architecture SDK header files and sample applications.
  • BimNv — ODA BimNv SDK header files and sample applications.
  • BimRv — ODA BimRv SDK header files and sample applications.
  • Civil — ODA Civil SDK header files and sample applications.
  • Components — ODA Visualize SDK header files and sample applications.
  • Kernel — ODA Kernel SDK header files and sample applications.
  • Drawing — ODA Drawings SDK 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 — ODA Mechanical SDK 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 — ODA PRC SDK (3D PDF) header files and sample applications.
  • Teigha.NET — .NET assembly information file and sample applications.
  • ThirdParty — Third-party components used by ODA software.

The following folders are created when the Drawings X trial is installed (where * is the ODA software version number):

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

Building the Samples for All Trial Versions Except Drawings X

  1. In Microsoft Visual Studio, open a sample application solution file located in the Platforms\<configuration> folder. The following solution files are available:
    • Architecture_vcXXdll_ex.sln — Contains ODA Architecture SDK sample application projects, where XX is a Microsoft Visual Studio version number (for example, Architecture_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • BIM_vcXXdll_ex.sln — Contains ODA BIM SDK sample application projects, where XX is a Microsoft Visual Studio version number (for example, BIM_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • Civil_vcXXdll_ex.sln — Contains ODA Civil SDK sample application projects, where XX is a Visual Studio version number (for example, Civil_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • Drawings_vcXXdll_ex.sln — Contains ODA Drawings SDK sample application projects, where XX is a Visual Studio version number (for example, Drawings_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • Drawings.NET_vcXXdll_ex.sln — Contains ODA Drawings.NET SDK sample application projects, where XX is a Visual Studio version number (for example, Drawings.NET_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • Java_vcXXdll_ex.sln — Contains ODA Drawings SDK for Java sample application projects, where XX is a Visual Studio version number (for example, Java_vc10dll_ex.sln is for Microsoft Visual Studio 2010).
    • Kernel_vcXXdll_ex.sln — Contains ODA Kernel SDK sample application projects, where XX is a Visual Studio version number (for example, Kernel_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • Mechanical_vcXXdll_ex.sln — Contains ODA Mechanical SDK sample application projects, where XX is a Visual Studio version number (for example, Mechanical_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • PRC_vcXXdll_ex.sln — Contains ODA PRC SDK sample application projects, where XX is a Visual Studio version number (for example, PRC_vc10dll_ex.sln is for Microsoft Visual Studio 2010).
    • PRC.NET_vcXXdll_ex.sln — Contains ODA PRC.NET SDK sample application projects, where XX is a Visual Studio version number (for example, PRC.NET_vc11dll_ex.sln is for Microsoft Visual Studio 2012).
    • Publish_vcXXdll_ex.sln — Contains ODA Publish SDK sample applications projects, where XX is a Visual Studio version number (for example, Publish_vc10dll_ex.sln is for Microsoft Visual Studio 2010).
    • Visualize_vcXXdll_ex.sln — Contains ODA Visualize SDK sample applications projects, where XX is a Visual Studio version number (for example, Visualize_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 ODA software.

Building the Samples for Drawings X

There are no prebuilt samples for Drawings X, but trial users can build the samples from source code. Sample source code is located in the Drawings X 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 ODA software version number).

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

  1. Open a solution, for example, sharpTest.sln.
    You can use any version of Visual Studio supported by ODA software 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.

Use the following resources to continue your evaluation of ODA software.

Documentation

ODA Software Getting Started: https://docs.opendesign.com/tkernel/tkernel_whats_new.html

ODA Kernel SDK: https://docs.opendesign.com/tkernel/

ODA Visualize SDK: https://docs.opendesign.com/tv/

ODA Drawings SDK: https://docs.opendesign.com/td/

ODA BimRv SDK: https://docs.opendesign.com/tbim/

ODA Cloud SDK: https://docs.opendesign.com/tcloud/

ODA Publish SDK: https://docs.opendesign.com/tp/

ODA PRC SDK: https://docs.opendesign.com/tprc/

ODA Architecture SDK: https://docs.opendesign.com/ta/

ODA Civil SDK: https://docs.opendesign.com/tc/

ODA Drawings.NET SDK: http://docs.opendesign.com/tnet/

ODA Drawings SDK for Java: http://docs.opendesign.com/tjava/

ODA PRC.NET SDK: http://docs.opendesign.com/tprcnet/

Drawings X: 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 ODA software usage: http://forum.opendesign.com/.