Documentation Center public:dson_spec:object_definitions:graft
/
2026-04-14T19:36:12+00:00Documentation Center
/
/lib/tpl/dazdoccenter/images/favicon.icotext/html2012-04-02T21:22:53+00:00graft
/public/dson_spec/object_definitions/graft/start
<h1 id="graft">graft</h1>
<div class="level1">
<!-- EDIT1 PLUGIN_WRAP_START [0-] --><div class="wrap_center wrap_round wrap_todo plugin_wrap" style="width: 80%;">
<p>
* = Details
</p>
</div><!-- EDIT2 PLUGIN_WRAP_END [0-] -->
</div>
<h2 id="description">Description</h2>
<div class="level2">
<p>
Definition for how to graft one figure's geometry to another.
</p>
</div>
<h2 id="parent_objects">Parent Objects</h2>
<div class="level2">
<ul>
<li class="level1"><div class="li"> <a href="/public/dson_spec/object_definitions/geometry/start" class="wikilink1" title="public:dson_spec:object_definitions:geometry:start">geometry</a></div>
</li>
</ul>
</div>
<h2 id="properties">Properties</h2>
<div class="level2">
<div class="table sectionedit3"><table class="inline">
<thead>
<tr class="row0">
<th class="col0"> Name </th><th class="col1"> Description </th><th class="col2"> Default </th><th class="col3"> Required </th>
</tr>
</thead>
<tr class="row1">
<td class="col0"> vertex_count </td><td class="col1"> The number of vertices expected to exist in the target geometry. </td><td class="col2"> None </td><td class="col3"> yes </td>
</tr>
<tr class="row2">
<td class="col0"> poly_count </td><td class="col1"> The number of polygons expected to exist in the target geometry. </td><td class="col2"> None </td><td class="col3"> yes </td>
</tr>
<tr class="row3">
<td class="col0"> vertex_pairs </td><td class="col1"> A <a href="/public/dson_spec/format_description/data_types/start" class="wikilink1" title="public:dson_spec:format_description:data_types:start">int2_array</a> of vertex index pairs. The first index being the index into the source vertex list and the second index being the index into the target geometry vertex list. </td><td class="col2"> N/A </td><td class="col3"> yes </td>
</tr>
<tr class="row4">
<td class="col0"> hidden_polys </td><td class="col1"> A <a href="/public/dson_spec/format_description/data_types/start" class="wikilink1" title="public:dson_spec:format_description:data_types:start">int_array</a> of polygon indices on the target geometry that should be hidden. </td><td class="col2"> N/A </td><td class="col3"> yes </td>
</tr>
</table></div>
<!-- EDIT3 TABLE [272-932] -->
</div>
<h2 id="details">Details</h2>
<div class="level2">
<p>
The <em>vertex_pairs</em> property is composed of an array of vertex pairs where the first element in each pair is the index into the source geometry vertex array (i.e. the geometry that contains this snap_target definition), and the second element in each pair is the index into the vertex array for the target geometry.
</p>
<p>
The <em>hidden_polys</em> indices indicate which polygons on the target geometry should be hidden when the geometry for the snapping is attached.
</p>
</div>
<h2 id="example">Example</h2>
<div class="level2">
<pre class="code">{
"vertex_count" : 345,
"poly_count" : 321,
"vertex_pairs" : {
"count" : 3,
"values" : [ [ 2, 334 ], [ 3, 723 ], [ 6, 219 ] ]
},
"hidden_polys" : {
"count" : 6,
"values" : [ 67, 23, 87, 89, 12, 90 ]
}
}</pre>
</div>