Merge CAX Files
VCollab Pro users can merge two CAX files into a single CAX file in the batch mode as well.
The input is an XML file which consists of all the information for merging.
There are two XML files, one is basic format and the other is advanced.
Syntax:
Prompt :VCollabPro.exe file folder> VCollabPro.exe -b <input xml file path>
Example:
C:Program FilesVCollabVCollabPro64> VCollabPro.exe -b “C:testbatch.xml”
Sample Batch File
File Name: VCollabProBatch_MergeCAX.xml
Location: “..SamplesBatchMode Inputs"
<?xml version=”1.0” encoding=”utf-8” ?>
<!– BatchVersion 1.0 –>
<!– VCollab Pro : Allows batch mode execution using
-b option from command line. –>
<!– Sample Usage : C:VCollabAppPath>VCollabPro.exe
-b this.xml –>
<!– Copyright (C) 2010 Visual Collaboration
Technologies Inc. –>
<!– This xml format is alpha and it can be improved
or changed by VCollab at the time of release VCollab
Pro –>
<!– Purpose : This sample explains, How to merge
another cax file and generate new cax –>
<!– Here, ‘sInputFile’ and ‘sInputMergeCaxFile’ are
input cax files and ‘sOutputFile’ is the merged file
–>
< VCollabBatch fVersion = “0.1”
sInputFile = “..SamplesBatchMode Inputsairbag.cax”
>
<Output sOutputFile =”C:output.cax” />
<!– Note : Set either ‘bCombinedPalette’ or
‘bMultiPalette’ as TRUE at once, only if needed –>
<!– Note iMergePosition value is 0-AsIs; 1-left;
2-right; 3-top; 4-bottom; 5-Relative translate;
6-Absolute position; Default is 0–>
<MergeAsNewDataSet ENABLE = “TRUE”
sInputMergeCaxFile = “..SamplesBatchMode
Inputsaudi.cax”
bCombinedPalette = “FALSE”
bMultiPalette = “FALSE”
bShowDataSetLabels = “TRUE”
bApplyCurentSettings =”FALSE”
iMergePosition =”1”
ENABLE_TRANSLATION = “FALSE”
fTranslationX = “3”
fTranslationY = “0”
fTranslationZ = “0”
ENABLE_ROTATION = “FALSE”
fRotationX = “0”
fRotationY = “1”
fRotationZ = “0”
fRotationAngle = “0”
ENABLE_SCALE = “FALSE”
fScaleX = “1”
fScaleY = “1”
fScaleZ = “1”
/>
<!– Merged file can be repositioned from its
original coordinate system using ENABLE_TRANSLATION,
ENABLE_ROTATION or ENABLE_SCALE –>
<!– Note: Translation, Rotation and Scale will work
only when iMergePosition=”5” or “6” otherwise they are
ignored.–>
</VCollabBatch>
|
Dynamic Arguments
Arguments can also be set dynamically in batch mode. This feature is useful for repeated operations without having to edit values in the input XML file.
The XML file is thus used as a template and its values are set externally through command line arguments.
E.g.
C:Program FilesVCollabVCollabPro64> VCollabPro.exe -b “C:testbatch.xml” “..SamplesBatchMode Inputsairbag.cax” “..SamplesBatchMode Inputsaudi.cax” “C:output.cax”
In this example the names of two CAX files and the output file are provided dynamically through the command line.
The arguments are denoted as @arg#N where N is the index of the argument in the command line. Dynamic arguments can be used in any field and in any order, but @arg#N has to match with the command line input index.
In this example,
@arg#0 = VCollabPro.exe
@arg#1= -b
@arg#2 = C:/test/batch.xml
@arg#3= ..SamplesBatchMode Inputsairbag.cax which is assigned to sInputFile
@arg#4=..SamplesBatchMode Inputsaudi.cax which is assigned to sInputMergeCaxFile
@arg#5=C:output.cax which is assigned to sOutputFile
Modified XML
Fields that take values from command line arguments are highlighted.
<?xml version=”1.0” encoding=”utf-8” ?>
<!– BatchVersion 1.0 –>
<!– VCollab Pro : Allows batch mode execution using -b option from command line. –>
<!– Sample Usage : C:VCollabAppPath>VCollabPro.exe -b this.xml –>
<!– Copyright (C) 2010 Visual Collaboration Technologies Inc. –>
<!– This xml format is alpha and it can be improved or changed by VCollab at the time of release VCollab Pro –>
<!– Purpose : This sample explains, How to merge another cax file and generate new cax –>
<!– Here, ‘sInputFile’ and ‘sInputMergeCaxFile’ are input cax files and ‘sOutputFile’ is the merged file –>
<VCollabBatch fVersion = “0.1”
sInputFile = “@arg#3” >
<Output sOutputFile = “@arg#5” />
<!– Note : Set either ‘bCombinedPalette’ or ‘bMultiPalette’ as TRUE at once, only if needed –>
<!– Note iMergePosition value is 0-AsIs; 1-left; 2-right; 3-top; 4-bottom; 5-Relative translate; 6-Absolute position; Default is 0–>
<MergeAsNewDataSet ENABLE = “TRUE”
sInputMergeCaxFile = “@arg#4”
bCombinedPalette = “FALSE”
bMultiPalette = “FALSE”
bShowDataSetLabels = “TRUE”
bApplyCurentSettings =”FALSE”
iMergePosition = “1”
ENABLE_TRANSLATION = “FALSE”
fTranslationX = “3”
fTranslationY = “0”
fTranslationZ = “0”
ENABLE_ROTATION = “FALSE”
fRotationX = “0”
fRotationY = “1”
fRotationZ = “0”
fRotationAngle = “0”
ENABLE_SCALE = “FALSE”
fScaleX = “1”
fScaleY = “1”
fScaleZ = “1”
/>
<!– Merged file can be repositioned from its original coordinate system using ENABLE_TRANSLATION, ENABLE_ROTATION or ENABLE_SCALE –>
<!–NOTE: Translation, Rotation & Scale will work only when iMergePosition=”5” or “6” other wise they are ignored.–>
</VCollabBatch>
Note
Dynamic arguments can be used in any field and in any order, but @arg#Number has to match with command line input index.