GstarCAD 2020 GRX Upgrade Guide

Contents

Literature/GSTARCAD/2020/03 API Guides/GRX/assets/GRX Upgrade Guide assets/7b238917d33d2cc6ac227141

Development Environment

  • Microsoft Visual Studio Enterprise 2017(Version 15.9.17)

  • CPU:

Basic Requirement:1.6 GHz CUP,Recommend:3.0 GHz CPU and above

  • RAM:

Basic Requirement:2 GB,Recommend:8 GB and above

  • Operation System

Windows 10 version 1507 and advanced version:Including home version, professional version, education version and enterprise version(not support LTSC and Windows 10 S)

Windows 8.1(with updated 2919355): Core version, professional version and enterprise version

Windows 7 SP1(with latest Windows updated): Including home version, professional version, enterprise version and Ultimate version

  • Monitor Resolution:

Traditional monitor:1028 x 800 and above CRT monitor, High resolution and 4K (3840 x 2160) monitor

  • GRX SDK 2020

  • GstarCAD 2020

  • .NET Framework 4.8 and above

Original Code

GRX Project: GRX2019 (or below) application source code needs to be migrated to VS2017 compile environment first, then compile it in the form of multi-byte character sets and multi-thread, including non-ARX public module.

Install SDK

Download GstarCAD SDK package from our official website: https://www.gstarcad.net/download/

After you get the GRXSDK.ZIP file, please extract it to your disk directory, for instance, C:\grxsdk. Afterwards you will get 6 files, which they are inc,inc-x64,inc-x86,lib-x64,lib-x86 and samples.

  • The Inc file includes header files

  • The inc-x64 file includes the files used in COM and .NET for 64 bit

  • The inc-x86 file includes the files used in COM and .NET for 32 bit

  • The lib-x64 file includes the files referenced from GRX library

  • The lib-x86 file includes the files referenced from GRX library

  • Samples includes project files, they are dotnet,fact_dg,HelloADS,HelloARX,SimplePalette, etc.

The instruction of sample projects:

  • Dotnet includes multiple dotnet samples,including addline,hello,vbhello, etc.
  1. Addline includes .NET example for adding solid line.

  2. Hello includes .NET example for prompting the information of output.

  3. Vbhello includes VB.NET example for how to develop with .NET API.

  • fact_dg includes example for defining LSP function.

  • HelloADS includes the project for how to develop the type of ADS.

  • HelloARX includes includes the example for how to develop with ARX API.

  • SimplePalette includes the example for how to develop the type modules for palette.

GstarCAD 2020 GRX Project Upgrade Process

  1. Open the project with VS 2017, click OK button when the "Review Solution Actions" dialog box pops up.
Literature/GSTARCAD/2020/03 API Guides/GRX/assets/GRX Upgrade Guide assets/b508de9f6f8b6f220d0df194
  1. In Visual Studio 2017 "Solution Explore", right click on the project and click Properties from context menu. Then the "HelloArx Property Pages" dialog box will be opened as shown below.
Literature/GSTARCAD/2020/03 API Guides/GRX/assets/GRX Upgrade Guide assets/5d75c7e71c20355ff6174a30
  1. Select the C/C++ Node under Configuration Properties and set Additional Include Directories of General as C:\grxsdk\inc\arx

  2. Select Linker and set the configurations as below:

General-Additional Library Directories set to (If 32-Bit): C:\grxsdk\lib-x86

General-Additional Library Directories set to (If 64-Bit):C:\grxsdk\lib-x64

Input-Module Definition File set to:C:\grxsdk\inc\arx\RxExport.def

  1. Click Bulid-Build Solution from menu in Vs 2017, and you will get a HelloARX.grx file after compiling. Which means the upgrade process complete.

  2. Run GstarCAD 2020, input APPLOAD command to load HelloARX.grx generated from above step, and then input HelloWorld in the command line. After that "Hello World" will output at the command line.

Literature/GSTARCAD/2020/03 API Guides/GRX/assets/GRX Upgrade Guide assets/29f0a91f243e4823cb53ddf6 Literature/GSTARCAD/2020/03 API Guides/GRX/assets/GRX Upgrade Guide assets/4551e13ca9e5c65f2af56982

Copyright reserved: Xi’an Gstarsoft Co.,Ltd

Usage License: Allows copying, quote any part of this document. Changes of any part of this document are forbidden without authorization. Please keep this statement when copying and quoting it, otherwise it will be held liable.

  • AutoCAD® is a product of Autodesk® Company which is one of the CAD software solution providers. ARX is an abbreviated name of ObjectARX, which is AutoCAD® Runtime eXtension, and C++ SDK provided by Autodesk®