C/C++

The GX API can be accessed from the 64-bit C++ language programs.




Installed Files

The GX Developer repository contains the following related to the C/C++ development:

LIB Files

The library files included with GX Developer are produced by Microsoft Visual Studio and are intended to be used with that environment. Other compilers may or may not use the same format. Microsoft's format is known as COFF format, an older specification known as OMF format is still used by compilers created by Embarcadero (some versions), Digital Mars & some Fortran companies. If your compiler toolchain is windows based they will probably include a tool to convert from COFF if necessary. 


lib\geogx.lib

This is the main library file that contains all functions in the GX Developer .  This library files should be included in your list of link libraries.

lib\geogx_u.lib

Unicode (UTF-16) version of geogx.lib library

lib\geogx_utf8.lib

UTF-8 version of geogx.lib library

lib\geodist.lib

This library is required for external applications. It provides the very small set of methods in the External API.

C Header Files


include\gx_lib.h

C header file for all GX functions in the current release.  This header file is only for the purpose of providing prototypes to C compilers. The original GXH files (gxdev\gxh\*.gxh) should be referred to for information on actual function usage.  Note that there are both standard calling convention (GX_STANDARD_FUNC) and C calling convention (GX_WRAPPER_FUNC) wrappers for every function.  C programmers should use the GX_WRAPPER_FUNC functions. 

include\gx_define.hdefine statements for all defined constants in the GX Developer GXH files.  These are for use in your programs, but the original GXH files should be used to obtain information on usage.  If the constant definitions conflict with definitions used in your programs you should not include this file and instead use the explicit form of the constants. 
include\gx_extern.hC header file includes functions to create and destroy the GX Object Pointer, and display or retrieve error message.  These functions are required by stand-alone programs. 

C Examples


examples\c\gridcopyConsole program to copy/convert grids using IMG class interface.
examples\c\chanaddConsole program to add a value to a database channel.
examples\c\chanstdIdentical to chanadd but uses the “stdcall” function interface.
examples\c\callfuncA sample DLL that is called from a GX running under Oasis montaj.
examples\c\licensecheckConsole program to detect if a license is present. Works in conjunction with Oasis montaj .
examples\c\OMScriptGUI program that can execute GS Scripts and GX’s in GUI mode.

C++ Header Files


include\gxcpp_geogx.h

C++ header file for GX API. This header file is only for the purpose of providing implementation of class-wrappers to C++ compilers.


C++ Examples


examples\cpp\gridcopy

Console program to copy/modify grids using GXIMG class interface, this example also shows how to get the actual grid data.

examples\cpp\chanadd

Console program to work with database channels, this example also shows how to get the actual data from a channel.

examples\cpp\gridstatConsole program to get statistics for a grid, this example also shows how to get the actual grid data