Point¶
Description¶
Point
represents one single point with a particular coordinate in a contour. It is used to access off-curve and on-curve points alike. Its cousin BPoint
also provides access to incoming and outgoing bcps. Point
is exclusively only one single point.
glyph = CurrentGlyph()
for contour in glyph:
for point in contour.points:
print(point)
Overview¶
Copy¶
Copy this object into a new object of the same type. |
Parents¶
The point's parent |
|
The point's parent |
|
The point's parent |
|
The point's parent |
Identification¶
The name of the point. |
|
The unique identifier for the object. This value will be an Identifier or a |
|
The index of the point within the ordered list of the parent glyph's point. This attribute is read only. ::. |
Coordinate¶
The x coordinate of the point. It must be an Integer/Float. ::. |
|
The y coordinate of the point. It must be an Integer/Float. ::. |
Type¶
The point type defined with a String. |
|
A |
Transformations¶
Transform the object. |
|
Move the object. |
|
Scale the object. |
|
Rotate the object. |
|
Skew the object. |
Normalization¶
Round the point's coordinate. |
Environment¶
Return the environment's native object that has been wrapped by this object. |
|
Tell the environment that something has changed in the object. |
Reference¶
- class fontParts.base.BasePoint(*args, **kwargs)[source]¶
A point object. This object is almost always created with
BaseContour.appendPoint
, the pen returned byBaseGlyph.getPen
or the point pen returned byBaseGLyph.getPointPen
. An orphan point can be created like this:>>> point = RPoint()
Copy¶
- BasePoint.copy()¶
Copy this object into a new object of the same type. The returned object will not have a parent object.
Parents¶
- BasePoint.contour¶
The point’s parent
BaseContour
.
Identification¶
- BasePoint.name¶
The name of the point. This will be a String or
None
.>>> point.name 'my point' >>> point.name = None
- BasePoint.identifier¶
The unique identifier for the object. This value will be an Identifier or a
None
. This attribute is read only.>>> object.identifier 'ILHGJlygfds'
To request an identifier if it does not exist use object.getIdentifier()
- BasePoint.index¶
The index of the point within the ordered list of the parent glyph’s point. This attribute is read only.
>>> point.index 0
Coordinate¶
- BasePoint.x¶
The x coordinate of the point. It must be an Integer/Float.
>>> point.x 100 >>> point.x = 101
- BasePoint.y¶
The y coordinate of the point. It must be an Integer/Float.
>>> point.y 100 >>> point.y = 101
Type¶
- BasePoint.type¶
The point type defined with a String. The possible types are:
move
An on-curve move to.
line
An on-curve line to.
curve
An on-curve cubic curve to.
qcurve
An on-curve quadratic curve to.
offcurve
An off-curve.
- BasePoint.smooth¶
A
bool
indicating if the point is smooth or not.>>> point.smooth False >>> point.smooth = True
Transformations¶
- BasePoint.transformBy(matrix, origin=None)¶
Transform the object.
>>> obj.transformBy((0.5, 0, 0, 2.0, 10, 0)) >>> obj.transformBy((0.5, 0, 0, 2.0, 10, 0), origin=(500, 500))
matrix must be a Transformation Matrix. origin defines the point at with the transformation should originate. It must be a Coordinate or
None
. The default is(0, 0)
.
- BasePoint.moveBy(value)¶
Move the object.
>>> obj.moveBy((10, 0))
value must be an iterable containing two Integer/Float values defining the x and y values to move the object by.
- BasePoint.scaleBy(value, origin=None)¶
Scale the object.
>>> obj.scaleBy(2.0) >>> obj.scaleBy((0.5, 2.0), origin=(500, 500))
value must be an iterable containing two Integer/Float values defining the x and y values to scale the object by. origin defines the point at with the scale should originate. It must be a Coordinate or
None
. The default is(0, 0)
.
- BasePoint.rotateBy(value, origin=None)¶
Rotate the object.
>>> obj.rotateBy(45) >>> obj.rotateBy(45, origin=(500, 500))
value must be a Integer/Float values defining the angle to rotate the object by. origin defines the point at with the rotation should originate. It must be a Coordinate or
None
. The default is(0, 0)
.
- BasePoint.skewBy(value, origin=None)¶
Skew the object.
>>> obj.skewBy(11) >>> obj.skewBy((25, 10), origin=(500, 500))
value must be rone of the following:
single Integer/Float indicating the value to skew the x direction by.
iterable cointaining type Integer/Float defining the values to skew the x and y directions by.
origin defines the point at with the skew should originate. It must be a Coordinate or
None
. The default is(0, 0)
.
Normalization¶
Environment¶
- BasePoint.naked()¶
Return the environment’s native object that has been wrapped by this object.
>>> loweLevelObj = obj.naked()
- BasePoint.changed(*args, **kwargs)¶
Tell the environment that something has changed in the object. The behavior of this method will vary from environment to environment.
>>> obj.changed()