xref: /third_party/python/Lib/turtle.py

31 the command turtle.forward(15), and it moves (on-screen!) 15 pixels in
60 - Fine control over turtle movement and screen updates via delay(),
167         "examplescreen": "screen",
808         Example (for a TurtleScreen instance named screen):
809         >>> screen.mainloop()
823         Example (for a TurtleScreen instance named screen):
824         >>> screen.textinput("NIM", "Name of first player:")
843         Example (for a TurtleScreen instance named screen):
844         >>> screen.numinput("Poker", "Your stakes:", 1000, minval=10, maxval=10000)
957     """Provides screen oriented methods like bgcolor etc.
1013         Example (for a TurtleScreen instance named screen):
1014         >>> screen.clear()
1079         This performs a screen.reset. If mode 'world' is already active,
1085         Example (for a TurtleScreen instance named screen):
1086         >>> screen.setworldcoordinates(-10,-0.5,50,1.5)
1127         Example (for a TurtleScreen instance named screen):
1128         >>> screen.register_shape("triangle", ((5,-3),(0,5),(-5,-3)))
1189         Example (for a TurtleScreen instance named screen):
1190         >>> screen.colormode()
1192         >>> screen.colormode(255)
1207         Example (for a TurtleScreen instance named screen):
1208         >>> screen.reset()
1215         """Return the list of turtles on the screen.
1217         Example (for a TurtleScreen instance named screen):
1218         >>> screen.turtles()
1229         Example (for a TurtleScreen instance named screen):
1230         >>> screen.bgcolor("orange")
1231         >>> screen.bgcolor()
1233         >>> screen.bgcolor(0.5,0,0.5)
1234         >>> screen.bgcolor()
1253         If n is given, only each n-th regular screen update is really performed.
1257         Example (for a TurtleScreen instance named screen):
1258         >>> screen.tracer(8, 25)
1280         Example (for a TurtleScreen instance named screen):
1281         >>> screen.delay(15)
1282         >>> screen.delay()
1312         Example (for a TurtleScreen instance named screen):
1313         >>> screen.window_width()
1321         Example (for a TurtleScreen instance named screen):
1322         >>> screen.window_height()
1332         Example (for a Screen instance named screen):
1333         >>> cv = screen.getcanvas()
1344         Example (for a TurtleScreen instance named screen):
1345         >>> screen.getshapes()
1358         Example (for a TurtleScreen instance named screen)
1360         >>> screen.onclick(goto)
1363         >>> screen.onclick(None)
1377         Example (for a TurtleScreen instance named screen):
1383         >>> screen.onkey(f, "Up")
1384         >>> screen.listen()
1408         Example (for a TurtleScreen instance named screen
1415         >>> screen.onkeypress(f, "Up")
1416         >>> screen.listen()
1436         Example (for a TurtleScreen instance named screen):
1437         >>> screen.listen()
1448         Example (for a TurtleScreen instance named screen):
1455         ...             screen.ontimer(f, 250)
1472         Example (for a TurtleScreen instance named screen):
1473         >>> screen.bgpic()
1475         >>> screen.bgpic("landscape.gif")
1476         >>> screen.bgpic()
2486     def __init__(self, screen, shapeIndex):
2487         self.screen = screen
2492         screen = self.screen
2494         if self._type == "polygon" == screen._shapes[shapeIndex]._type:
2496         if self._type == "image" == screen._shapes[shapeIndex]._type:
2499             screen._delete(self._item)
2502                 screen._delete(item)
2503         self._type = screen._shapes[shapeIndex]._type
2505             self._item = screen._createpoly()
2507             self._item = screen._createimage(screen._shapes["blank"]._data)
2509             self._item = [screen._createpoly() for item in
2510                                           screen._shapes[shapeIndex]._data]
2525             self.screen = canvas
2529             self.screen = canvas
2531             for screen in RawTurtle.screens:
2532                 if screen.cv == canvas:
2533                     self.screen = screen
2536                 self.screen = TurtleScreen(canvas)
2537                 RawTurtle.screens.append(self.screen)
2541         screen = self.screen
2542         TNavigator.__init__(self, screen.mode())
2544         screen._turtles.append(self)
2545         self.drawingLineItem = screen._createline()
2546         self.turtle = _TurtleImage(screen, shape)
2552         self.currentLineItem = screen._createline()
2565         Delete the turtle's drawings from the screen, re-center the turtle
2621             self.screen._delete(item)
2622         self.currentLineItem = self.screen._createline()
2632         """Delete the turtle's drawings from the screen. Do not move turtle.
2636         Delete the turtle's drawings from the screen. Do not move turtle.
2647         self.screen._incrementudc()
2648         if self.screen._updatecounter != 0:
2651             self.screen._drawline(self.currentLineItem, self.currentLine,
2657         screen = self.screen
2658         if screen._tracing == 0:
2660         elif screen._tracing == 1:
2663             screen._update()                  # TurtleScreenBase
2664             screen._delay(screen._delayvalue) # TurtleScreenBase
2667             if screen._updatecounter == 0:
2668                 for t in screen.turtles():
2670                 screen._update()
2679         If n is given, only each n-th regular screen update is really performed.
2691         return self.screen.tracer(flag, delay)
2694         return self.screen._color(args)
2697         return self.screen._colorstr(args)
2708         if self.screen._colormode == 1.0:
2726         screen = self.screen
2730         self.screen = None
2735         self.screen = screen
2738         q.screen = screen
2739         q.turtle = _TurtleImage(screen, self.turtle.shapeIndex)
2741         screen._turtles.append(q)
2742         ttype = screen._shapes[self.turtle.shapeIndex]._type
2744             q.turtle._item = screen._createpoly()
2746             q.turtle._item = screen._createimage(screen._shapes["blank"]._data)
2748             q.turtle._item = [screen._createpoly() for item in
2749                               screen._shapes[self.turtle.shapeIndex]._data]
2750         q.currentLineItem = screen._createline()
2776         if not name in self.screen.getshapes():
2973         screen = self.screen
2976         e = Vec2D(e0, e1 * screen.yscale / screen.xscale)
2978         return [(p0+(e1*x+e0*y)/screen.xscale, p1+(-e0*x+e1*y)/screen.yscale)
2993         shape = self.screen._shapes[self.turtle.shapeIndex]
3014         screen = self.screen
3015         shape = screen._shapes[self.turtle.shapeIndex]
3018         if self._shown and screen._updatecounter == 0 and screen._tracing > 0:
3027                 screen._drawpoly(titem, shape, fill=fc, outline=oc,
3030                 screen._drawimage(titem, self._position, tshape)
3034                     screen._drawpoly(item, poly, fill=self._cc(fc),
3040                 screen._drawpoly(titem, ((0, 0), (0, 0), (0, 0)), "", "")
3042                 screen._drawimage(titem, self._position,
3043                                           screen._shapes["blank"]._data)
3046                     screen._drawpoly(item, ((0, 0), (0, 0), (0, 0)), "", "")
3066         screen = self.screen
3067         shape = screen._shapes[self.turtle.shapeIndex]
3071             stitem = screen._createpoly()
3077             screen._drawpoly(stitem, shape, fill=fc, outline=oc,
3080             stitem = screen._createimage("")
3081             screen._drawimage(stitem, self._position, tshape)
3085                 item = screen._createpoly()
3090                 screen._drawpoly(item, poly, fill=self._cc(fc),
3102                     self.screen._delete(subitem)
3104                 self.screen._delete(stampid)
3171         screen = self.screen
3175                       screen._pointlist(self.currentLineItem),
3181         if self._speed and screen._tracing == 1:
3183             diffsq = (diff[0]*screen.xscale)**2 + (diff[1]*screen.yscale)**2
3193                     screen._drawline(self.drawingLineItem,
3198                 screen._drawline(self.drawingLineItem, ((0, 0), (0, 0)),
3220         screen = self.screen
3231         screen._drawline(cLI, pl, fill=usepc, width=ps)
3234                                        (screen._type(i) == "line")]
3236             screen._delete(i)
3240         if self._speed and screen._tracing == 1:
3242             diffsq = (diff[0]*screen.xscale)**2 + (diff[1]*screen.yscale)**2
3252                     screen._drawline(self.drawingLineItem,
3257                 screen._drawline(self.drawingLineItem, ((0, 0), (0, 0)),
3286         tracing = self.screen._tracing
3303             self.screen._drawline(self.currentLineItem, self.currentLine,
3305             self.currentLineItem = self.screen._createline()
3308             self.screen._drawline(self.currentLineItem, top=True)
3339             self._fillitem = self.screen._createpoly()
3361                 self.screen._drawpoly(self._fillitem, self._fillpath,
3394         if hasattr(self.screen, "_dot"):
3395             item = self.screen._dot(self._position, size, color)
3419         item, end = self.screen._write(self._position, txt, align, font,
3510         return self.screen
3533     ### screen oriented methods recurring to methods of TurtleScreen
3539         return self.screen.delay(delay)
3559         self.screen._onclick(self.turtle._item, fun, btn, add)
3584         self.screen._onrelease(self.turtle._item, fun, btn, add)
3602         across the screen thereby producing handdrawings (if pen is
3605         self.screen._ondrag(self.turtle._item, fun, btn, add)
3624             self.screen._delete(item)
3628             self.screen._drawpoly(item, ((0, 0),(0, 0),(0, 0)),
3634                 self.screen._delete(item)
3676     """Return the singleton screen object.
3716         width: as integer a size in pixels, as float a fraction of the screen.
3717           Default is 50% of screen.
3719           screen. Default is 75% of screen.
3721           edge of the screen, if negative from the right edge
3724           edge of the screen, if negative from the bottom edge
3727         Examples (for a Screen instance named screen):
3728         >>> screen.setup (width=200, height=200, startx=0, starty=0)
3730         sets window to 200x200 pixels, in upper left of screen
3732         >>> screen.setup(width=.75, height=0.5, startx=None, starty=None)
3734         sets window to 75% of screen by 50% of screen and centers
3761         Example (for a Screen instance named screen):
3762         >>> screen.title("Welcome to the turtle-zoo!")
3781         Example (for a TurtleScreen instance named screen):
3782         >>> screen.bye()
3801         Example (for a Screen instance named screen):
3802         >>> screen.exitonclick()

Indexes created Thu Nov 07 10:32:03 CST 2024