<!DOCTYPE html
  PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<!--
Copyright (c) 2006 UGS Corp.

All Rights Reserved.

This software and related documentation are proprietary to UGS Corp.
-->
<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <title>Options for output of assemblies</title>
      <script language="javaScript">
        abridged="false";
        displayConditions=new Array();
      </script>
      <link type="text/css" href="../css/main_styles.css" rel="stylesheet">
   </head>
   <body class="bodydocs" onload="top.pageLoader()" bgcolor="#FFFFFF">
      <div class="title_topic3" id="xps10_pagetitle">Options for output of assemblies</div>
      <hr noshade="true">
      <p class="para_topic">The options for output of assemblies are:</p>
      <ul>
         <li>
            <p class="para_item">-generate_bookmark</p>
         </li>
         <li>
            <p class="para_item">-generate_assy_jt</p>
         </li>
         <li>
            <p class="para_item">-nopopulate</p>
         </li>
         <li>
            <p class="para_item">-include_empty</p>
         </li>
         <li>
            <p class="para_item">-useRefsets</p>
         </li>
         <li>
            <p class="para_item">-usePreferredRefSets</p>
         </li>
         <li>
            <p class="para_item">-XTbrep</p>
         </li>
         <li>
            <p class="para_item">-UGTess </p>
         </li>
      </ul>
      <table border="0" cellspacing="2" width="100%" align="center">
         <tr bgcolor="#E0E0E0" valign="top">
            <th colspan="1" rowspan="1" width="17%">
               <p class="para_th">Option</p>
            </th>
            <th colspan="1" rowspan="1" width="82%">
               <p class="para_th">Description</p>
            </th>
         </tr>
         <tr bgcolor="#F7F7F7" valign="top">
            <td colspan="1" rowspan="1" width="17%">
               <p class="para_td">-generate_bookmark</p>
            </td>
            <td colspan="1" rowspan="1" width="82%">
               <p class="para_td">Produces a bookmark file for the assembly. This bookmark can then be opened directly inside Teamcenter Visualization.</p>
               <p class="para_td">The default name for the bookmark is the name of the assembly being translated, and it is created in the current directory. However, this can be overridden by adding a &quot;=[bookmark file spec]&quot; argument.</p>
               <p class="para_td">The option to generate a bookmark is only supported when you have identified a single part or top assembly to translate. It is not supported with the directory or file containing a list of parts as input parameters.</p>
            </td>
         </tr>
         <tr bgcolor="#F7F7F7" valign="top">
            <td colspan="1" rowspan="1" width="17%">
               <p class="para_td">-generate_assy_jt</p>
            </td>
            <td colspan="1" rowspan="1" width="82%">
               <p class="para_td">Produces a JT assembly file for the assembly. If the assembly is a native part file, the default name for the JT file is the name of the assembly being translated. It's created in the current directory. However, this can be overridden by adding a &quot;=[assy jt file spec]&quot; argument.</p>
               <p class="para_td">If the assembly is located in Teamcenter Engineering, the JT file is stored in Teamcenter Engineering, unless the -save_outside_iman option is used.</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-nopopulate</p>
            </td>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Does not generate component JT files. This option is useful for generating a bookmark or assembly JT file based on already translated component parts.</p>
               <table border="0">
                  <tr>
                     <td valign="top" align="left"><img align="left" src="../graphics/note.gif" alt="Note" title="Note"></td>
                     <td valign="bottom" align="left" width="100%">
                        <div class="para_note">
                           <p class="para_note_body">This option doesn't ensure that you get the latest JT files.</p>
                        </div>
                     </td>
                  </tr>
               </table>
               <p class="para_td">This option doesn't regenerate the JT file. It just creates an assembly structure with placeholders. If the .prt file is updated and this option is used, the JT file could become out of sync with the .prt file.</p>
               <p class="para_td">To regenerate the JT file (where it already exists) when the .prt file is updated, use the save option in NX (<b class="uiTerm">File</b>&rarr;<b class="uiTerm">Options</b>&rarr;<b class="uiTerm">Save Options</b>&rarr;<b class="uiTerm">Save JT Data</b>) 
               </p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-include_empty</p>
            </td>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Includes components that belong to empty reference sets in the assembly being translated. You can also use this option to include components in empty reference sets when generating bookmark files.</p>
               <p class="para_td">This option does not change the JT files that are produced. It only alters the product structure that you see in the assembly JT or bookmark files.</p>
               <p class="para_td">You can also use this where an assembly is saved without loading the components. The bookmark files contain references to the JT components that were not loaded in NX.</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-useRefsets</p>
            </td>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Specifies what reference sets to translate in the JT files.</p>
               <ul>
                  <li>
                     <p class="para_item">-useRefsets=&ldquo;DEFAULT&rdquo;: Translates only those reference sets that are defined in the CUSTOMER DEFAULTS. This is the default value in the configuration file.</p>
                  </li>
                  <li>
                     <p class="para_item">-useRefsets=&ldquo;ALL&rdquo;: Translates all reference sets of the part.</p>
                  </li>
               </ul>
               <p class="para_td">This option is supported only in the following translation modes:</p>
               <ul>
                  <li>
                     <p class="para_item"><b class="uiTerm">File</b>&rarr;<b class="uiTerm">Options</b>&rarr;<b class="uiTerm">Save Options</b>&rarr;<b class="uiTerm">Save JT</b></p>
                  </li>
                  <li>
                     <p class="para_item">ugtopv (batch mode)</p>
                  </li>
                  <li>
                     <p class="para_item">ugtopv -generate_assy_jt (batch mode)</p>
                  </li>
               </ul>
            </td>
         </tr>
         <tr>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-usePreferredRefSets</p>
            </td>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">If set to true, the load_options.def file is used to get a list of preferred reference sets. The file is located by:</p>
               <ul>
                  <li>
                     <p class="para_item">The UGII_LOAD_OPTIONS environment variable points to the file.</p>
                  </li>
                  <li>
                     <p class="para_item">The load_options.def file is in the current working directory.</p>
                  </li>
               </ul>
               <p class="para_td">If the file is not found, the default order of preference is used for reference sets.</p>
               <p class="para_td">In the following cases, the preferred reference sets are used when creating an assembly JT file.</p>
               <ul>
                  <li>
                     <p class="para_item">Geometry JT files are searched in order of preference. The first one found is referenced for a particular component.</p>
                  </li>
                  <li>
                     <p class="para_item">If the excludeViaRefSet option is set to true, the preferred reference set is used to determine whether to include a child reference.</p>
                  </li>
               </ul>
            </td>
         </tr>
         <tr>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">transform</p>
            </td>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Where -transform={&lt;transform&gt;}.</p>
               <p class="para_td">Allows you to specify a transform to be applied to the geometry in the output JT files. The transform is applied to the top node in the JT file for all JT files produced.</p>
               <p class="para_td">The transform is of the form: {X1, X2, X3, Tx, Y1, Y2, Y3, Ty, Z1, Z2, Z3, Tz}. This is the same format used by NX.</p>
               <table border="0">
                  <tr>
                     <td valign="top" align="left"><img align="left" src="../graphics/note.gif" alt="Note" title="Note"></td>
                     <td valign="bottom" align="left" width="100%">
                        <div class="para_note">
                           <p class="para_note_body">Scaling is not supported</p>
                           <p class="para_note_body">If you're using this option on a UNIX system, enclose the transform string in single quotes to prevent processing of the &quot;{&quot; and &quot;,&quot; characters. For example, use '{X1, X2, ....}' in UNIX.</p>
                        </div>
                     </td>
                  </tr>
               </table>
            </td>
         </tr>
         <tr>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-XTbrep</p>
            </td>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Writes XT Brep data to the JT file, when you specify this option.</p>
               <p class="para_td">When you do not specify this option, the translator outputs JT Brep data to the JT file, provided UGTess is set to false.</p>
               <table border="0">
                  <tr>
                     <td valign="top" align="left"><img align="left" src="../graphics/note.gif" alt="Note" title="Note"></td>
                     <td valign="bottom" align="left" width="100%">
                        <div class="para_note">
                           <p class="para_note_body">You can view JT files with XT Brep using Teamcenter Visualization Viewer 5.0 and later.</p>
                        </div>
                     </td>
                  </tr>
               </table>
            </td>
         </tr>
         <tr>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-UGTess</p>
            </td>
            <td bgcolor="#F7F7F7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">If set to true, the translator uses the NX tessellator, which improves translation performance and provides better quality surface tessellation in most cases.</p>
               <p class="para_td">If set to false, the translator uses the DM tessellator.</p>
            </td>
         </tr>
      </table><br></body>
</html>