Developer's Guide > Get Started with Civil SDK > Using Sample Applications > ExTcCopy Sample Application
ExTcCopy Sample Application

Summary

ODA Product: Civil SDK
Sample Name: ExTcCopy
Source Code Location: <INSTALL_DIR>/Civil/Examples/ExTcCopy

Description

The ExTcCopy sample application saves a source .dwg file to another file. By default, the application updates the source .dwg file to the latest version. The drawing from the source file can be visualized to a .bmp image.

It illustrates:

  • Initialization of ODA services.
  • Assert function customization.
  • Reading/writing drawing files.
  • Visualizing a drawing to a .bmp image.

Run Sample Application

To run the ExTcCopy sample application, please do the following:

  1. Open the terminal and go to the directory where the sample binary file is built:
    • For Windows: <INSTALL_DIR>\exe\<PLATFORM_NAME>\
    • For Non-Windows OS: <INSTALL_DIR>/bin/<PLATFORM_NAME>/
    <INSTALL_DIR> is a directory where you unpacked the Civil SDK archive.
    To determine your <PLATFORM_NAME> parameter, please see the ODA Platform Naming Conventions section in the Downloading Civil SDK topic.
  2. Run the sample with appropriate arguments:
    ExTcCopy <source file> <target file> [target type] [target version]
source file Full path to a drawing file to read input data from.
target file Full path to a target file.
target type Optional. Can be any of the following: DWG, BMP. Default is DWG.
target version Optional. The ExTcCopy sample application supports saving in the latest version of the .dwg format only (ACAD2007). Default is ACAD2007.

If the application executed properly, the target file will appear with no additional messages displayed. In case you get the "usage" message, check the parameters. An error message indicates problems with the source file.

See also:

Using Sample Applications

Copyright © 2002 – 2021. Open Design Alliance. All rights reserved.
Send feedback about this topic