Home → Operators → Line/C,Atangl

Line/C,Atangl

Tangent to Circle at Angle

Creates a tangent line to a circle at a specified angle. The direction selector (XL/XS/YL/YS) must match the quadrant the angle falls in — if not, XyzPilot returns an error and no line is created.

What It Does

The Line/C,Atangl operator creates a line tangent to a circle at a specified angle. The direction selector (XL/XS/YL/YS) determines which of the two possible tangent solutions is created. The angle must fall within the correct quadrant for the chosen selector — if it does not, XyzPilot returns an error and no line is created:

Error example: Angle 45.0° does not fall inside the quadrant for position XLarge. No tangent line created.
This means the angle 45° is not valid for the XLarge selector — choose a different selector or adjust the angle.

Syntax

Line/XLarge|XSmall|YLarge|YSmall, C, Atangl, A

Quick Input

C: 0 Ang: 45 Dir: XL XS YL YS
Quick Input panel

Quick Input panel — XyzPilot interface

Direction Selector

The selector specifies which quadrant the tangent line angle must fall in. The angle you enter must be within the valid range for the chosen selector — if not, XyzPilot returns an error and no line is created.

SelectorValid angle quadrantApproximate range
XL (XLarge)Tangent line pointing in positive X direction~315°–360° / 0°–45°
XS (XSmall)Tangent line pointing in negative X direction~135°–225°
YL (YLarge)Tangent line pointing in positive Y direction~45°–135°
YS (YSmall)Tangent line pointing in negative Y direction~225°–315°
Quadrant mismatch error: If the angle does not fall inside the quadrant for the chosen selector, XyzPilot returns:
Angle X° does not fall inside the quadrant for position XLarge. No tangent line created.
Solution: choose the correct selector for your angle, or adjust the angle to match the selector.

Worked Examples

Setup: C0 = Centre (0,0), radius 100 // Angle 134° — falls in YLarge quadrant C: 0 Ang: 134 Dir: YL → L6: start (-69.466, 71.934) end (-141.400, 2.468) Angle: 224.00° // Wrong selector for same angle — returns error C: 0 Ang: 45 Dir: XL → Error: Angle 45.0° does not fall inside the quadrant for position XLarge. No tangent line created. C: 0 Ang: 136 Dir: YL → Error: Angle 136.0° does not fall inside the quadrant for position YLarge. No tangent line created. // Rule: choose the Dir that matches the quadrant // your angle falls in.

Analytic Rule

The angle defines the direction of the tangent line. The selector (XL/XS/YL/YS) defines which quadrant that angle must fall in. If angle is outside the selector quadrant: → Error returned, no line created. If angle is valid for the selector: Tangent direction: (cos A, sin A) Normal direction: (-sin A, cos A) Tangent point: centre + r * normal (selector side) Result: Exact analytic tangent line.

FAQ

How is the angle measured?

The angle specifies the direction of the tangent line in degrees. The chosen direction selector (XL/XS/YL/YS) must match the quadrant that angle falls in. If the angle does not fall inside the correct quadrant, XyzPilot returns an error: Angle X° does not fall inside the quadrant for position XLarge. No tangent line created.

What happens if I choose the wrong selector?

XyzPilot returns an error and no line is created. Choose the selector that matches the quadrant your angle falls in: XL for ~0°–45°, YL for ~45°–135°, XS for ~135°–225°, YS for ~225°–315°.

What is the difference between this and Line/P,Tanto,C?

Line/C,Atangl creates a tangent at a specified angle (direction). Line/P,Tanto,C creates a tangent through a specified point.