| CdLblFaceNew | CdMacRunString | CdTargObjName |
int
CdLblFaceNew(VsApplTopTable
*,int,int,int *,int *)
VsApplTopTable
*tt |
i |
pointer to topology table
|
int
shell_indx |
i |
top-table index of face's parent shell
|
int
face_indx |
i |
face's top-table index
|
int
*idx |
i |
database index of parent entity (or NULL)
|
int
*code |
i |
unique position code != 0 (or NULL)
|
Description
Add a persistent label to the face identified by "shell_indx" and "face_indx". If the face already has a label, the existing label is replaced.
If the face was derived from another entity (e.g. extruded from curve, fillet edge, fillet vertex), pass in the database index of the entity via "idx". This is the "idx" stored in a "VsCrvEnt" or "VsDbIdxObj" structure. If the face was not derived from an entity, pass in "*idx=NULL". It is assumed that "idx" resides in TRG_BIN (if defined). If the face was derived from an entity which is not yet in the database, pass in the label. The label must begin with -VFACE or -VCOMPOUND or it will be treated as an error.
If the face was not derived from an entity, or if multiple faces were derived from the same entity, pass in a non-zero integer code that uniquely identifies the face relative to other faces that belong to the same feature or that have the same parent entity (idx). This integer is passed in via "*code". If it's not necessary, pass in "*code=NULL". This function assumes the index of the feature actively being created is stored in global "int VgFtrIndex".
If the global variable "VgLblIgnoreParIdx" is non-zero, the parent entity referenced by "idx" is not encoded in the label. Return 1 if error, else 0.
Memory-Management
Caveats
int
CdMacRunString(char
*,char **,int *)
char
*sIn |
i |
null-terminated ascii string of macro commands
|
char
**sOut |
o |
pointer to null-terminated ascii string of output data
|
int
*iLen |
o |
length of "sOut", including the null-terminator
|
Description
"sIn" is interpreted as a string of one or more newline-delimted macro command strings -- without the macro/endmacro keywords. A new macro is started, the encoded macro commands are executed and the macro is terminated.
The contents of variables created by the macro commands are output via "sOut" as a single comma-delimited, null-terminated ascii string. The first item in the string is the total number of variables encoded in the string. This is followed by an encoding of each variable. Each variable is encoded with its name first, followed by the number of array elements in the variable, followed by the array values. Values are either ascii-encoded floating point numbers, or strings enclosed in double quotemarks.
The following is an example: # variables Num = 25 Strings = {"hello dolly", "hello world"} Array = {100,125,150} # ascii-encoded variable data 3,Num,1,25,Strings,2,"hello dolly","hello world",Array,3,100,125,150
Memory for "sOut" is allocated by this function. The memory must be deallocated by the calling procedure. If there is no output data, "*sOut=NULL" and "iLen=0" will be output. If this function errors out anywhere along the way, the string "ERROR" will be output via "sOut" and this function will return 1. Otherwise, it will return 0.
Memory-Management
Caveats
int
CdTargObjName(VeCdObjName,
OmName)
VeCdObjName
class |
i |
name class
|
OmName
name |
o |
null-terminated ascii name
|
Description
Compose a name of the specified class for an object that will be added to the active target object.
This function returns without doing anything if name[] is already defined.
Return 1 if error, else 0.
Memory-Management
Caveats
