Rooba
/
kivy
mirror of https://github.com/kivy/kivy.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

fix bezier doc in Line documentation 

closed #784
This commit is contained in:
tshirtman 2012-12-09 02:41:29 +01:00
parent f49f9e650e
commit 12fbfa88e3
1 changed files with 11 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
kivy/graphics/vertex_instructions_line.pxi
View File

@ -963,7 +963,7 @@ cdef class Line(VertexInstruction):
self._points = points self._points = points
property rectangle: property rectangle:
'''Use this property to build a rectangle, without calculate the '''Use this property to build a rectangle, without calculating the
:data:`points`. You can only set this property, not get it. :data:`points`. You can only set this property, not get it.
The argument must be a tuple of (x, y, width, height) The argument must be a tuple of (x, y, width, height)
@ -1011,28 +1011,26 @@ cdef class Line(VertexInstruction):
self._close = 1 self._close = 1
property bezier: property bezier:
'''Use this property to build a rectangle, without calculate the '''Use this property to build a bezier line, without calculating the
:data:`points`. You can only set this property, not get it. :data:`points`. You can only set this property, not get it.
The argument must be a tuple of (x, y, width, height) The argument must be a tuple of 2n elements, n being the number of points.
angle_end, segments):
* x and y represent the bottom-left position of the rectangle
* width and height represent the size
The line is automatically closed.
Usage:: Usage::
Line(rectangle=(0, 0, 200, 200)) Line(bezier=(x1, y1, x2, y2, x3, y3)
.. versionadded:: 1.4.2 .. versionadded:: 1.4.2
.. note:: Bezier lines calculations are inexpensive for a low number of
points, but complexity is quadratic, so lines with a lot of points
can be very expensive to build, use with care!
''' '''
def __set__(self, args): def __set__(self, args):
if args == None: if args == None or len(args) % 2:
raise GraphicException( raise GraphicException(
'Invalid rectangle value: {0!r}'.format(args)) 'Invalid bezier value: {0!r}'.format(args))
self._mode_args = tuple(args) self._mode_args = tuple(args)
self._mode = LINE_MODE_BEZIER self._mode = LINE_MODE_BEZIER
self.flag_update() self.flag_update()
@ -1049,7 +1047,7 @@ cdef class Line(VertexInstruction):
# as the list is in the form of (x1, y1, x2, y2...) iteration is # as the list is in the form of (x1, y1, x2, y2...) iteration is
# done on each item and the current item (xn or yn) in the list is # done on each item and the current item (xn or yn) in the list is
# replaced with a calculation of "xn + x(n+1) - xn" x(n+1) is # replaced with a calculation of "xn + x(n+1) - xn" x(n+1) is
# placed at n+2. each iteration makes the list one item shorter # placed at n+2. Each iteration makes the list one item shorter
for i in range(1, len(T)): for i in range(1, len(T)):
for j in xrange(len(T) - 2*i): for j in xrange(len(T) - 2*i):
T[j] = T[j] + (T[j+2] - T[j]) * l T[j] = T[j] + (T[j+2] - T[j]) * l