Category Feature element trees, Object ProDtmcsys

Function ProDtmcsysTransformfileRead


Description
Allocates required steps of the element tree to create CSYS from transformation file.

Attention: the created csys may be different from releases prior to Pro/E Wildfire 1.0.

Note: format of transformation file

The input file name to ProDtmcsysTransformfileRead should have the name of a .trf file, with the extension. The name must be lowercase only. The file should contain a coordinate transform such as:

X1 X2 X3 Tx

Y1 Y2 Y3 Ty

Z1 Z2 Z3 Tz

where X1 Y1 Z1 is the X-axis direction, X2 Y2 Z2 is the Y-axis direction, X3 Y3 Z3 is not used (the right hand rule determines the Z direction), and Tx Ty Tz is the origin of the coordinate system.
Synopsis
#include <ProDtmCsys.h>
ProErrorProDtmcsysTransformfileRead(
wchar_t* file_name
/* (In)
Name of the transformation file (with the extension .trf). Both absolute and relative paths are supported.
*/
ProElement elem_tree
/* (In)
Element tree root element
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully allocated the elements.
PRO_TK_BAD_INPUTSThe input argument is invalid.
PRO_TK_NOT_FOUNDThe transform file could not be read.

Manual References:

  1. Element Trees: Datum Features: Feature Elements