Function point3D

Lib/pagebot/toolbox/units.py:58–84

Answers `p` as a 3D point. If it is already a list of 3 elements, then don't change and answer the original. If it's a smaller or larger list / tuple, then extend it. >>> point3D() # Default 3D origin (0pt, 0pt, 0pt) >>> point3D(pt(20, -40)) # Add z = pt(0) (20pt, -40pt, 0pt

(p=None)

# P O I N T

def point3D(p=None):
    """Answers `p` as a 3D point. If it is already a list of 3 elements, then
    don't change and answer the original. If it's a smaller or larger list /
    tuple, then extend it.

    >>> point3D() # Default 3D origin
    (0pt, 0pt, 0pt)
    >>> point3D(pt(20, -40)) # Add z = pt(0)
    (20pt, -40pt, 0pt)
    >>> point3D(mm(30)) # One value defaults to x == y
    (30mm, 30mm, 0pt)
    >>> point3D(p(2,3,4,5)) # Trim tuple to 3 coordinates.
    (2p, 3p, 4p)
    """
    if not p: # None or zero.
        return pt(0, 0, 0) # Undefined 3D point as list.

    if isinstance(p, (list, tuple)):
        if len(p) > 3:
            p = p[:3]
        while len(p) < 3:
            p += (pt(0),) # Value undefined, add origin as z value.
        p = tuple(p)
    else:
        p = p, p, pt(0)

    return p

def point2D(p=None):
    """Answers the 2D point from a 2D or 3D point.