SGtransTui

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Kinematics and Frames
Introduced first in SolidGeometry 5.0, Creation date: 2020-11-30, Last change: 2025-09-15

interactive fnct to fix a surface to the ground or another solid's surface

See Also: SGtransT

Example Illustration

Syntax

A=SGtransTui(A,[TA,TB])

Input Parameter

`A`:		Frame A
`TA`:		Frame to attach; default is empty
`TB`:		Frame to attach to or Solid B; default is eye(4)

Output Parameter

A: Solid attached to x/y plane or to another frame

Copyright 2020-2025 Tim C. Lueth. All rights reserved. The code is the property of Tim C. Lueth and may not be redistributed or modified without explicit written permission. This software may be used free of charge for academic research and teaching purposes only. Commercial use, redistribution, modification, or reverse engineering is strictly prohibited. Access to source code is restricted and granted only under specific agreements. For licensing inquiries or commercial use, please contact: Tim C. Lueth

Algorithm (Workflow)

This function, SGtransTui, is designed to attach a solid object to the ground or another solid's surface. It is part of the SolidGeometry library and was introduced in version 5.0. The function takes in a frame A and optionally two transformation matrices, TA and TB.

Input Parameters

A: The frame of the solid object to be transformed.
TA: The frame to attach. If not provided, it defaults to an empty matrix.
TB: The frame to attach to or another solid object. If not provided, it defaults to the identity matrix with a rotation applied.

Output

A: The transformed solid object, now attached to the x/y plane or another frame.

Algorithm Steps

Retrieve TA and TB from the input parameters using getfuncparams. If TB is empty, set it to the identity matrix with a rotation of 180 degrees around the y-axis.
If TA is empty, use fiofselect3d to select a frame from A and determine the free boundary vertices using CVLfreeBoundaryVLFL.
Check if TB is a solid object using isSG. If true, perform the following:
- Assign TB to B and select a frame from B using fiofselect3d.
- Apply a 180-degree rotation around the y-axis to TA.
- Transform B using SGtransT with the inverse of TB.
- Set TB to the identity matrix and determine the free boundary vertices of B.
Transform A using SGtransT with the inverse of TA and then with TB.
Transform the free boundary vertices of A using VLtransT with the inverse of TA and TB.
If no output is requested, plot the transformed solid A and optionally B using SGplotalpha and CVLplot.

Algorithm explaination created using ChatGPT on 2025-08-19 07:24. (Please note: No guarantee for the correctness of this explanation)

Last html export of this page out of FM database by TL: 2025-09-21