turtle.Turtle.pen¶

Turtle.pen(pen=None, **pendict)¶

Return or set the pen’s attributes.

Arguments:

pen – a dictionary with some or all of the below listed keys. **pendict – one or more keyword-arguments with the below

listed keys as keywords.

Return or set the pen’s attributes in a ‘pen-dictionary’ with the following key/value pairs:

“shown” : True/False “pendown” : True/False “pencolor” : color-string or color-tuple “fillcolor” : color-string or color-tuple “pensize” : positive number “speed” : number in range 0..10 “resizemode” : “auto” or “user” or “noresize” “stretchfactor”: (positive number, positive number) “outline” : positive number “tilt” : number

This dictionary can be used as argument for a subsequent pen()-call to restore the former pen-state. Moreover one or more of these attributes can be provided as keyword-arguments. This can be used to set several pen attributes in one statement.

Examples (for a Turtle instance named turtle): >>> turtle.pen(fillcolor=”black”, pencolor=”red”, pensize=10) >>> turtle.pen() {‘pensize’: 10, ‘shown’: True, ‘resizemode’: ‘auto’, ‘outline’: 1, ‘pencolor’: ‘red’, ‘pendown’: True, ‘fillcolor’: ‘black’, ‘stretchfactor’: (1,1), ‘speed’: 3} >>> penstate=turtle.pen() >>> turtle.color(“yellow”,””) >>> turtle.penup() >>> turtle.pen() {‘pensize’: 10, ‘shown’: True, ‘resizemode’: ‘auto’, ‘outline’: 1, ‘pencolor’: ‘yellow’, ‘pendown’: False, ‘fillcolor’: ‘’, ‘stretchfactor’: (1,1), ‘speed’: 3} >>> p.pen(penstate, fillcolor=”green”) >>> p.pen() {‘pensize’: 10, ‘shown’: True, ‘resizemode’: ‘auto’, ‘outline’: 1, ‘pencolor’: ‘red’, ‘pendown’: True, ‘fillcolor’: ‘green’, ‘stretchfactor’: (1,1), ‘speed’: 3}