select3dofcam

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Visualization
Introduced first in SolidGeometry 5.0, Creation date: 2020-09-23, Last change: 2025-08-19

creates all selectin information for the

Description

same as select3d but uses the center line of the current view

See Also: gcoofT , select3d , pixelofaxis , SGfigure , selectV3d

Example Illustration

Syntax

[pout,vout,viout,facevout,faceiout,handle]=select3dofcam

Output Parameter

`pout`:		point
`vout`:		next vertex
`viout`:		vertex list index
`facevout`:		touched facet
`faceiout`:		facet list index
`handle`:		handle to graphics object

Examples


SGsurfaces(SGcolorsample); % just plot something on the screen
select3dofcam

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, select3dofcam, is designed to select 3D objects in a graphical environment using the center line of the current view. It is part of the SolidGeometry library and was introduced in version 5.0. The function returns several outputs related to the selected 3D object.

Input Parameters

The function select3dofcam does not take any input parameters directly. It relies on the current graphical object and camera position obtained from the function gcoofT.

Output Parameters

pout: The point in 3D space that is selected.
vout: The next vertex in the selection process.
viout: The index of the vertex in the vertex list.
facevout: The facet that is touched or selected.
faceiout: The index of the facet in the facet list.
handle: A handle to the graphics object that is selected.

Algorithm Steps

Call the function gcoofT to get the current graphical object (go) and camera position (cp).
Invoke the function select3d with the graphical object and camera position as inputs to perform the selection process.
Assign the outputs of select3d to the respective output variables: pout, vout, viout, facevout, faceiout, and handle.
If no output arguments are specified (nargout==0), execute additional visualization steps:

Call SGtitle to set the title of the graphical environment.
Use VLplot to plot the camera position with a red asterisk ('r*') and a size of 2.

Example Usage

To use this function, first plot something on the screen using SGsurfaces(SGcolorsample), then call select3dofcam to perform the selection.

Algorithm explaination created using ChatGPT on 2025-08-19 00:06. (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