PLcircleui

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - PL/Point Lists
Introduced first in SolidGeometry 4.6, Creation date: 2019-06-10, Last change: 2025-08-18

returns a PL for a circle interactively defined

Description

written in Tokyo visiting Hajime Asama's Lab at The University of Tokyo


See Also: PLcircle , VLui , CPSlineui , CPLui , CPSui , PLui , PLsquareui , VLFLui , SGui , CPLsplitui , Poseofimageui , Poseui

Example Illustration

 missing image of PLcircleui

Syntax

PL=PLcircleui

Output Parameter

PL: Point List

Examples


PLsquare(30,10); PLcircleui % interactively creating a Point list for a circle




Copyright 2019-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, PLcircleui, is designed to interactively create a point list (PL) for a circle. It is part of the SolidGeometry library and was developed by Tim Lueth in 2019.

Input Parameters

The function does not take any input parameters directly when called. Instead, it relies on user interaction to define the circle's parameters.

Output

The function returns a point list (PL) representing the circle.

Algorithm Steps

  1. The function calls ginput2Dcircle, which allows the user to interactively define a circle in a 2D space. This function returns two values:
    • cc: The center coordinates of the circle.
    • cr: The radius of the circle.
  2. Next, the function calls PLcircle(cr), which generates a point list for a circle with the specified radius cr.
  3. The center coordinates cc are added to the point list to position the circle correctly in the 2D space.
  4. If the function is called without an output argument, it automatically plots the circle using PLplot(PL,'r-'), which displays the circle in red.

Additional Information

The function is part of a larger library that includes various utilities for creating and manipulating geometric shapes. It is specifically designed for interactive use, allowing users to define shapes visually.

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