CAD/CAM Developer's Kit/3D

 

Reference Guide

 

1. Introduction

 

2. 2D Geometry

 

3. 3D Geometry

 

4. DXF

 

5. Display

 

6. Lists

 

7. Home

 

 

Copyright (c) 1988-2009 Building Block Software, Inc. All rights reserved.

 

CAD/CAM Developer's Kit/3D

 

 

Introduction

============

 

Welcome to the Building Block Software CAD/CAM Developer's Kit / 3D!

 

The CAD/CAM Developer's Kit / 3D (CCDK/3D) provides four key software components

needed for any type of CAD/CAM application.   These components are:

 

* DXF input and output

 

* geometry display

 

* 2D and 3D geometric computations, such as transformations  and intersections

 

* list management

 

These software "building blocks" enable programmers to quickly develop

CAD/CAM applications without being distracted by the basic issues  handled by

these routines.

 

Applications that can be created using CCDK/3D include:

 

* DXF viewers for database programs

 

* parametric design programs

 

* NC code generators

 

* finite element mesh generators

 

* printed circuit board design and analysis

 

 

CCDK/3D Organization

====================

 

CCDK/3D is divided into five parts:

 

* 2D geometry

 

* 3D geometry

 

* DXF

 

* Display

 

* Lists

 

Each of these parts has its own section in the manual.  Each section

provides a discussion of fundamental concepts, a listing of object  types

defined, a listing of functions and macros by category, and  an alphabetized

reference for each function.  Each function description  in the alphabetized

reference includes a sample program or subroutine  using the function.

 

Each section is divided into the following chapters:

 

* Overview

 

* Fundamental Concepts

 

* Object Types

 

* Functions and Macros by Category

 

* Alphabetized Reference

 

The Overview chapter contains some comments about the section.

 

The Fundamental Concepts chapter presents key concepts and  definitions that

apply to objects and operations provided by that  part of CCDK/3D.

 

The Object Types chapter lists the object types and the macros  that "access"

the attributes of the objects.

 

Functions and Macros by Category chapter provides groups of  functions and

macros.  Use this chapter to locate the name of the  function or macro that

performs a specified operation.  The table  of contents at the beginning of

the section provides the page number  where detailed information about the

function can be found.

 

The Alphabetized Reference consists of these detailed descriptions.  It

devotes a page or more to each function, providing a description of  the

operation the function performs, a listing of the types and meanings  of its

arguments and return value, and an example of a program or  subroutine that

uses the function.

 

 

Programming Information

=======================

 

Compiler Options

----------------

 

__WIN32__, __WINDOWS__, __MCRSFTC__

-----------------------------------

 

The symbols __WIN32__, __WINDOWS__, __MCRSFTC__ must be defined when using

any version of Microsoft Developer Studio.

 

 

 

Building Libraries with MS-DEV

------------------------------

 

To build the CCDK/3D object libraries, open the buildlib solution in the buildtools folder, and build the buildlib and buildlib_spline projects.

Be sure to build the buildlib and buildlib_spline projects one at a time.  Each of these projects generates object code that is not compatible with the object code from the other project.  Building them at the same time with the "Build Solution" command causes object code to be mixed, and the resulting libraries to be unusable.  Therefore, it is important to first build, for example, the buildlib project with the "Build buildlib" command. When it completes, switch to the the buildlib_spline project and build it with the "Build buildlib_spline" command.

 

An alternate way to build the CCDK/3D libraries is to run the CCMS91SW.BAT batch file in the source subdirectory.  It will build both the spline and non-spline libraries.

 

For the CCMS91SW.BAT batch file to run successfully, you will need to add or modify certain environment variables.  Use the VCVARS32.BAT batch file in the VC\bin folder in your MS-DEV installation to make all environment variable changes needed to run CCMS91SW.BAT.

 

 

 

SPLINE

------

 

By default, spline code is excluded.  Therefore, without the  -DSPLINE

directive, constants and function declarations that  pertain to splines

appear not to be defined.

 

If you want to include spline code, you must #define a symbol  SPLINE that

instructs the compiler to include the spline code.

 

To define this symbol, use the -D option on the command line when  invoking

the compiler to compile your files. 

 

Make certain that you compile all of your files for a single program  with

the same SPLINE option.  An executable composed of some objects  with spline

code included, and other objects with spline code excluded  will not work.

 

When linking a program, select the library that corresponds with the  way you

compiled your source files. 

 

When splines are disabled in a program, the ellipses are also disabled.