pytha.create_dado - pytha-3d-cad/pytha-lua-api GitHub Wiki
Creates a dado connection for two parts.
Similar to the Generators -> Dado function in the PYTHA user interface.
pytha.create_dado (element1, element2 [,options]])
| Parameter | Type | Description |
|---|---|---|
element1 |
element_handle |
First part of the dado connection |
element2 |
element_handle |
Second part of the dado connection |
options |
{...} |
Optional: a table that may contain the following options: |
options.depth_groove |
number |
Depth of the rabbet groove. Either relative to the board thickness or in construction units. Ignored if options.depth_type == "full" |
options.depth_tolerance |
number |
Extra clearance added to the pocket depth to ensure fit |
options.depth_type |
string |
"relative", "absolute", "full". Defines how options.depth_groove is interpreted |
options.distance_back |
number |
Dado offset from the back edge |
options.distance_front |
number |
Dado offset from the front edge |
options.maximum_distance |
number |
Maximum air gap between element1 and element2 for which a dado is still created |
options.number |
number |
Number of dados |
options.overlap_groove |
number |
Extra length of the dado machining pocket to compensate for tool diameter |
options.overlap_pocket |
number |
Extra length of the rabbet pocket to compensate for tool diameter |
options.position |
string |
"center", "inside", "outside", "bottom", "top", "left", "right", "front", "back". Defines the position of the dado |
options.thickness |
number |
Thickness of the dado. Either relative to the board thickness or in construction units. Ignored if options.thickness_type == "full" |
options.thickness_tolerance |
number |
Extra clearance added to the dado width to ensure fit |
options.thickness_type |
string |
"relative", "absolute", "full". Defines how options.thickness is interpreted |
Return value
| Type | Description |
|---|---|
boolean |
true if dado was created. false if parts don't touch. |
Remarks
The interpreation of options.position is influenced by the group vector of the parent group of part1 and part2.
Version Support:
Minimum PYTHA Version: V26