1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
Version 0.2.4
There are two way to use pykig.py:
- as a program:
$ pykig.py <nameprog>.kpy
- as a Python library within a Python program:
from pykig import *
A ".kpy" file is a "python" script.
A new object is created by callig a python "constructor";
the result can be stored in a python variable for later
use. E.g.:
a = Point(0.5, 1.5, name="A")
to create a point with coordinates (0.5, 1.5), give it a
the name "A" (at kig level) and recall it in the python
variable a. See the examples for practical use.
All constructors accept some optional parameters:
shown = HIDDEN | VISIBLE default value: VISIBLE
name = string a name to refer to the object within
kig
internal = bool this object is internal and cannot be
made visible
width = integer the line width
pointstyle = "Round"|"RoundEmpty"|"Rectangular"|"RectangularEmpty"|"Cross"
linestyle = "SolidLine"|"DashLine"|"DashDotLine"|"DashDotDotLine"|"DotLine"
color = "#RRGGBB" where RR, GG, BB are three numbers
wich represent the red, green, blue
components
The kigdocument is a global object to allow two methods for modify Kig look and
default behaviour:
kigdocument.noaxes()
kigdocument.nogrid()
kigdocument.hideobjects()
kigdocument.showobjects()
kigdocument.setwidth()
kigdocument.setpointstyle()
kigdocument.setname()
kigdocument.setlinestyle()
kigdocument.setshown()
kigdocument.setcolor()
kigdocument.setinternal()
Generic methods for objects:
obj.hide()
obj.show() hide/show given object
obj.setwidth(width) set obj width
obj.setpointstyle(self, pointstyle) set obj point style
obj.setlinestyle(self, linestyle) set obj line style
obj.setcolor(self, color) set obj color
obj.setname() set obj name
obj.type() return obj type
Some objects have other methods:
obj.coordinate() for points
obj.xcoord()
obj.ycoord()
obj.midpoint() for segments
obj.endpointA()
obj.endpointB()
obj.length()
obj.equation()
obj.slope()
obj.numofsides() for polygons
obj.perimeter()
obj.surface()
obj.centerofmass()
obj.windingnumber()
obj.center() for circles
obj.bisector() for angles
obj.support()
====================================================================
Properties:
Type(object) type of object
Coordinate(point) coordinate of point
XCoord(point)
YCoord(point)
MidPoints(a, b) midpoint of two points a and b
MidPoint(segment) midpoint of a segment
EndPointA(segment)
EndPointB(segment)
Length(segment)
Equation(segment)
Slope(segment)
NumOfSides(poly)
Perimeter(poly)
Surface(poly)
CenterOfMass(poly)
WindingNumber(poly)
Center(circle)
Bisector(angle)
Support(object)
====================================================================
Objects:
Point(x, y) free (unconstrained) point
ConstrainedPoint(t, curve) constrained point on 'curve'; t
*must* be in [0,1]; for segments and
arcs the position of the point is
proportional to the value of t
Line(a, b) straight line through a and b
Ray(a, b) halfline starting in a through b
Segment(a, b) segment from a to b
Orthogonal(line, point) line through 'point' orthogonal to
'line'
Circle(center, point)
CircleByCenterRadius(center, radius)
CircleBy3Points(p1, p2, p3)
ArcBy3Points(p1, p2, p3)
ArcByCenterPointAngle(center, point, angle)
ParabolaByDirectrixFocus(directrix, focus)
VerticalCubic(p1, p2, p3, p4)
ConicArc(p1, p2, p3, center)
LineLineIntersection(line1, line2) produces a point
CircleCircleIntersection(c1, c2, which) c1 and c2 are two circles, 'which'
is an integer that can only be +1
or -1 and tells which one of the
two intersections has to be created.
To have both you must call this
function twice.
ConicLineIntersection(conic, line, which) conic can also be a circle; which
has the same meaning as for the
CircleCircleIntersection
Polygon((p1, p2,..., pn)) A polygon with the given vertices
PolygonBCV(center, vertex, n) A regular polygon with 'n' sides
PolygonVertex(polygon, i) Generate the i-th vertex of the
given polygon
PolygonSide(polygon, i) Generate the i-th side of the given
polygon
Vector(p1, p2)
Angle(p1, center, p2)
Text(point, string, boxed) point is a Point or a tuple of
two numbers
boxed is a integer in [0, 1] telling
if we want the frame
VarText(point, string, vars, boxed) point is a Point or a tuple of
two numbers
vars hold variables parts
Label(obj, displ, string, boxed) is a Text connected tu a object
VarLabel(obj, displ, string, vars, boxed)
PythonScript(script, argvec) "script" is a string containing the
python script
Translate(object, vector) The result is an object of the same
kind as 'object'
CentralSymmetry(object, center)
AxialSymmetry(object, line)
Rotate(object,center, angle)
Scale(object,center, segment) The length of the segment is the
scaling ratio
Scale2(object, center, s1, s2) The ratio of the lengths of s1 and
s2 is the scaling ratio
InvertPoint(point, circle) Circular invertion of: a point
InvertLine(line, circle) ... an other object
InvertCircle(circle, circle)
InvertArc(arc, circle)
InvertSegment(segment, circle)
CircularInversion(object, circle)
-------------------------------------------------------------------------------
|
