camofT

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Visualization
Introduced first in SolidGeometry 4.2, Creation date: 2018-04-18, Last change: 2025-09-14

set camera to look on a given HT matrix using current zoom

Description

just calls tcamera of 2012

See Also: camplot , camset , Tofgca , Tofcam , tcamera

Example Illustration

Syntax

camofT(T)

Input Parameter

T: HT matrix, the figure axes camera should look on

Examples


SGbox; camofT(TofPez([0 0 100],[0 0 -1]))
SGbox; camofT(TofPez([0 0 100],[0 0 +1]))

Copyright 2018-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)

The function camofT is designed to set the camera view of a figure's axes to focus on a specified homogeneous transformation (HT) matrix. This function is part of the SolidGeometry library and primarily serves as a wrapper for the tcamera function.

Input Parameters

T: This is the homogeneous transformation matrix that defines the position and orientation the camera should focus on. The matrix is typically a 4x4 matrix used in 3D graphics to represent transformations including translation, rotation, and scaling.

Function Workflow

The function camofT takes a single input parameter, T, and directly calls the tcamera function with this parameter. The tcamera function is responsible for adjusting the camera settings of the current figure to align with the transformation specified by T.

Example Usage

The function is typically used in conjunction with other SolidGeometry functions. For example:

SGbox; camofT(TofPez([0 0 100],[0 0 -1])): This example first calls SGbox to create a 3D box, then uses camofT to set the camera to look at a point 100 units along the z-axis, facing in the negative z-direction.
SGbox; camofT(TofPez([0 0 100],[0 0 +1])): Similar to the previous example, but the camera is set to face in the positive z-direction.

Related Functions

The function is related to several other functions in the SolidGeometry library:

camplot: Likely used for plotting camera views.
camset: Used for setting camera parameters.
Tofgca, Tofcam: Functions related to obtaining transformation matrices for graphics objects or cameras.
tcamera: The core function that camofT calls to adjust the camera view.

Algorithm explaination created using ChatGPT on 2025-08-18 22:16. (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