`typerig.proxy.objects.base`

typerig.proxy.objects.base (version 0.26.0)

# MODULE: Typerig / Proxy / Base (Objects)
# -----------------------------------------------------------
# (C) Vassil Kateliev, 2018-2020        (http://www.kateliev.com)
# (C) Karandash Type Foundry            (http://www.karandash.eu)
#------------------------------------------------------------
# www.typerig.com

Modules

fontgate
fontlab
math
PythonQt
random
typerig.core.objects

Classes

typerig.core.objects.cubicbezier.CubicBezier(__builtin__.object)
- Curve
typerig.core.objects.line.Line(__builtin__.object)
- Line
typerig.core.objects.line.Vector(typerig.core.objects.line.Line)
- Vector
typerig.core.objects.point.Point(__builtin__.object)
- Coord

class Coord(typerig.core.objects.point.Point)

# - FL Proxy model -------------------------------------------

Method resolution order:: Coord; typerig.core.objects.point.Point; __builtin__.object

Methods

__init__(self, *argv)

__repr__(self)

asQPoint(self)

asQPointF(self)

Methods from typerig.core.objects.point.Point

__abs__(self)

__add__(self, other)

# -- Operators

__and__(self, other)

self & other: Used as for Scalar product

__div__(self, other)

__mul__(self, other)

__neg__(self)

__or__(self, other)

self | other: Used as for Cross product

__rdiv__ = __div__(self, other)

__rmul__ = __mul__(self, other)

__sub__(self, other)

__truediv__ = __div__(self, other)

angle_to(self, other, add=90)

Angle to another point in radians

diff_to(self, other)

doFlip(self, sign=(True, True))

doSwap(self)

# -- Modifiers

doTransform(self, transform=None)

solve_width(self, y=0)

Get width - find adjacent X by opposite Y

solve_x(self, y)

solve_y(self, x)

Descriptors from typerig.core.objects.point.Point

__dict__

dictionary for instance variables (if defined)

__weakref__

list of weak references to the object (if defined)

angle

magnitude

slope

swap

tuple

unit

y_intercept

class Curve(typerig.core.objects.cubicbezier.CubicBezier)

Method resolution order:: Curve; typerig.core.objects.cubicbezier.CubicBezier; __builtin__.object

Methods

__init__(self, *argv)

Methods from typerig.core.objects.cubicbezier.CubicBezier

__repr__(self)

asList(self)

# -- Modifiers

doSwap(self)

doTransform(self, transform=None)

get_handle_length(self)

Returns handle length and radii from base points.

lerp_first(self, shift)

lerp_last(self, shift)

solve_curvature(self, time)

Find Curvature of on-curve point at given time

solve_derivative(self, time)

Returns point of on-curve point at given time and vector of 1st and 2nd derivative.

solve_distance_end(self, distance, timeStep=0.01)

Returns time at which the given distance to end of bezier is met. 
Probing is executed withing timeStep in range from 0 to 1. The finer the step the preciser the results.

solve_distance_start(self, distance, timeStep=0.01)

Returns time at which the given distance to beginning of bezier is met. 
Probing is executed withing timeStep in range from 0 to 1. The finer the step the preciser the results.

solve_extremes(self)

Finds curve extremes and returns [(extreme_01_x, extreme_01_y, extreme_01_t)...(extreme_n_x, extreme_n_y, extreme_n_t)]

solve_handle_distance_from_base(self, ratio=(0.5, 0.5))

Finds new handle positions for given ratio from base points.

solve_hobby(self, curvature=(0.9, 0.9))

Calculates and applies John Hobby's mock-curvature-smoothness by given curvature - tuple(float,float) or (float)
Based on Metapolator's Hobby Spline by Juraj Sukop, Lasse Fister, Simon Egli

solve_hobby_curvature(self)

Returns current curvature coefficients (complex(alpha), complex(beta)) for 
both handles according to John Hobby's mock-curvature calculation

solve_parallel(self, vector, fullOutput=False)

Finds the t value along a cubic Bezier where a tangent (1st derivative) is parallel with the direction vector.
vector: a pair of values representing the direction of interest (magnitude is ignored).
returns 0.0 <= t <= 1.0 or None

# Solving the dot product of cubic beziers first derivate to the vector given B'(t) x V. Two vectors are perpendicular if their dot product is zero. 
# So if you could find the (1) perpendicular of V it will be collinear == tangent of the curve so the equation to be solved is:
# B'(t) x V(x,y) = 0; -(a*t^2 + b*t + c)*x + (g*t^2 + h*t + i)*y = 0 solved for t, where a,b,c are coefs for X and g,h,i for Y B'(t) derivate of curve
# 
# Inspired by answer given by 'unutbu' on the stackoverflow question: http://stackoverflow.com/questions/20825173/how-to-find-a-point-if-any-on-quadratic-bezier-with-a-given-tangent-direction
# Recoded and recalculated for qubic beziers. Used 'Rearrange It' app at http://www.wolframalpha.com/widgets/view.jsp?id=4be4308d0f9d17d1da68eea39de9b2ce was invaluable.
#
# DOTO: Fix calculation optimization error - will yield false positive result in cases #1 and #2 if vector is 45 degrees

solve_point(self, time)

Find point on cubic bezier at given time

solve_proportional_handles(self, proportion=0.3)

Equalizes handle length to given float(proportion)

solve_slice(self, time)

Returns two segments representing cubic bezier sliced at given time. 
Output: list [(Start), (Start_BCP_out), (Slice_BCP_in), (Slice), (Slice_BCP_out), (End_BCP_in), (End)] of tuples (x,y)

solve_tunni(self)

Make proportional handles keeping curvature and on-curve point positions 
Based on modified Andres Torresi implementation of Eduardo Tunni's method for control points

Descriptors from typerig.core.objects.cubicbezier.CubicBezier

__dict__

dictionary for instance variables (if defined)

__weakref__

list of weak references to the object (if defined)

height

line

points

tuple

width

x

x_max

y

y_max

class Line(typerig.core.objects.line.Line)

Method resolution order:: Line; typerig.core.objects.line.Line; __builtin__.object

Methods

__init__(self, *argv)

asQLineF(self)

asQPoint(self)

Methods from typerig.core.objects.line.Line

__add__(self, other)

__and__(self, other)

__div__(self, other)

__mul__(self, other)

__repr__(self)

__rmul__ = __mul__(self, other)

__sub__(self, other)

doSwap(self)

# -- Modifiers

doTransform(self, transform=None)

intersect_line(self, other_line)

Find intersection point (X, Y) for two lines.
Returns (None, None) if lines do not intersect.

lerp(self, time)

lerp_xy(self, time_x, time_y)

shift(self, dx, dy)

Shift coordinates by dx, dy

solve_point(self, time)

Find point on the line at given time

solve_slice(self, time)

Slice line at given time

solve_x(self, y)

Solve line equation for X coordinate.

solve_y(self, x)

Solve line equation for Y coordinate.

Descriptors from typerig.core.objects.line.Line

__dict__

dictionary for instance variables (if defined)

__weakref__

list of weak references to the object (if defined)

angle

diff_x

diff_y

height

length

points

slope

tuple

width

x

x_max

y

y_intercept

Get the Y intercept of a line segment

y_max

class Vector(typerig.core.objects.line.Vector)

Method resolution order:: Vector; typerig.core.objects.line.Vector; typerig.core.objects.line.Line; __builtin__.object

Methods

__init__(self, *argv)

asQLineF(self)

asQPoint(self)

Methods from typerig.core.objects.line.Vector

__repr__(self)

getAngle(self)

getSlope(self)

# - Getters

Descriptors from typerig.core.objects.line.Vector

angle

slope

x

y

Methods from typerig.core.objects.line.Line

__add__(self, other)

__and__(self, other)

__div__(self, other)

__mul__(self, other)

__rmul__ = __mul__(self, other)

__sub__(self, other)

doSwap(self)

# -- Modifiers

doTransform(self, transform=None)

intersect_line(self, other_line)

Find intersection point (X, Y) for two lines.
Returns (None, None) if lines do not intersect.

lerp(self, time)

lerp_xy(self, time_x, time_y)

shift(self, dx, dy)

Shift coordinates by dx, dy

solve_point(self, time)

Find point on the line at given time

solve_slice(self, time)

Slice line at given time

solve_x(self, y)

Solve line equation for X coordinate.

solve_y(self, x)

Solve line equation for Y coordinate.

Descriptors from typerig.core.objects.line.Line

__dict__

dictionary for instance variables (if defined)

__weakref__

list of weak references to the object (if defined)

diff_x

diff_y

height

length

points

tuple

width

x_max

y_intercept

Get the Y intercept of a line segment

y_max