The distributed files are listed below:
1.) DIRECTORY STRUCTURE
2.) DCS_INCL DIRECTORY
3.) DCS_LIB DIRECTORY
4.) EX_MEAS_DLL DIRECTORY
5.) EX_MOVE_DLL DIRECTORY
6.) EX_MTM_DLL DIRECTORY
7.) EX_TOLE_DLL DIRECTORY
8.) HELP DIRECTORY
1.) DIRECTORY STRUCTURE
The 3-Dcs software comes with a directory called 'writing_DLLs'. This directory will contain all of the files needed to create a user-DLL routine library. Except for the userfunc.cpp file, the structure of this directory, any sub-directories and files contained within, should not be changed. There are links between files in the various sub-directories that could be damaged causing the user-DLLs to malfunction. The following is a brief explanation of the files.
2.) DCS_INCL DIRECTORY
dcs_incl – These files are header files. They contain information used in other files.
dcs_api.h – This is the 3DCS API (Application Programming Interface) file. It contains function prototypes that are included in the dcsdll.cpp file. Do not edit this file.
dcs_defn.h – This file contains some common definitions. Do not edit this file.
dcs_ufnc.h – This file has the 3DCS user structures and function prototype definitions for moves, tolerances and measurements. It contains common function prototypes with a brief description. These functions can be used in the code written by the user. Do not edit this file. See User-DLL Structures for more information.
Note: Editing the above files is not recommended. Changes made will be lost when an updated version of 3DCS is received.
3.) DCS_LIB DIRECTORY
dcs_lib
dcs_api.lib – This file links your user-DLL to the dcs_api library module. Do not modify this file.
dcs_ufnc.lib – This file links your user-DLL to the dcs_ufnc library module. Do not modify this file.
4.) EX_MEAS_DLL DIRECTORY
ex_meas – This is an example user-DLL measurement for True Distance.
dcsdll.cpp – This file registers the measure function in 3DCS.
userfunc.cpp – This is the main file that contains the name of the function being created as well as the code for the routine. The user modifies this file. It can contain code for multiple routines.
ex_meas.dsp – Developer Studio Project file. This file contains the compiler and linker setup for the user-DLL library.
resource.h – This is a resource header file. This file is optional and only used by the .rc file.
userfunc.h – This is a header file for the functions in userfunc.cpp. It is currently set up to hold one measurement function. It can be modified to have more moves, tolerances and/or measures.
ex_meas.rc – Resource file. This file is optional. It is only needed if version control is desired.
TrueDistance.w3d – This is an example model for this user-DLL.
5.) EX_MOVE_DLL DIRECTORY
ex_move - This is an example user-DLL move for Translation.
dcsdll.cpp – This file registers the example move function in 3DCS.
userfunc.cpp – This is the main file that contains the name of the function being created as well as the code for the routine. The user modifies this file. It can contain code for multiple routines.
ex_move.dsp – Developer Studio Project file. This file contains the compiler and linker setup for the user-DLL library.
resource.h – This is a resource header file. This file is optional and only used by the .rc file.
userfunc.h – This is a header file for the functions in userfunc.cpp. It is currently set up to hold one move function. It can be modified to have more moves, tolerances and/or measures.
ex_move.rc – Resource file. This file is optional. It is only needed if version control is desired.
Translation.w3d – This is an example model for this user-DLL.
6.) EX_MTM_DLL DIRECTORY
x_mtm - This is an example user-DLL setup for moves, tolerances, and measures.
dcsdll.cpp – This file registers the example move function in 3DCS.
userfunc.cpp – This is the main file that contains the name of the function being created as well as the code for the routine. The user modifies this file. It can contain code for multiple routines.
mtm.dsp – Developer Studio Project file. This file contains the compiler and linker setup for the user-DLL library.
resource.h – This is a resource header file. This file is optional and only used by the .rc file.
userfunc.h – This is a header file for the functions in userfunc.cpp. It is currently set up to hold two tolerances, two moves and two measurement functions. It can be modified to have more moves, tolerances and/or measures.
mtm.rc – Resource file. This file is optional. It is only needed if version control is desired.
MtmSetup.w3d – This is an example model for this user-DLL.
7.) EX_TOLE_DLL DIRECTORY
ex_tole - This is an example user-DLL tolerance for Linear Deviation.
dcsdll.cpp – This file registers the example tolerance function in 3DCS.
userfunc.cpp – This is the main file that contains the name of the function being created as well as the code for the routine(s). The user modifies this file. It can contain code for multiple routines.
ex_tole.dsp – Developer Studio Project file. This file contains the compiler and linker setup for the user-DLL library.
resource.h – This is a resource header file. This file is optional and only used by the .rc file.
userfunc.h – This is a header file for the functions in userfunc.cpp. It is currently set up to hold one tolerance function. It can be modified to have more moves, tolerances and/or measures.
ex_tole.rc – Resource file. This file is optional. It is only needed if version control is desired.
Linear deviation.w3d – This is an example model for this user-DLL.
8.) HELP DIRECTORY
help - This is the help directory for user-DLL code writing.
user_dlls.htm – This file is the main page for user-DLL code writing help.
using_user_dlls.htm – This file describes the procedure for using a user-DLL function from a user's point of view.
creating_user_dlls.htm – This file describes the procedure for creating a user-DLL function from a developer's point of view.
creating_user_dlls.htm – This file describes the data structures used in user-DLL function development.
gif files – These graphics files are used in the help documentation.