֦i< d Z ddlZddlZddl ddlmZmZ ddlmZ ddl m
Z
ddl Z ddl m Z
ej dk( r
dd lmZ e ej" j% ej" j' e Zej d
k( Zd Zd Zd
ZdZdZdde fZ dZ g dZ dZ dZ!g dZ"d Z#de fde
fde j ffZ$ G d d e% Z&d Z'e(d k( r e' yy) a
----------------------------------------------
turtleDemo - Help
----------------------------------------------
This document has two sections:
(1) How to use the demo viewer
(2) How to add your own demos to the demo repository
(1) How to use the demo viewer.
Select a demoscript from the example menu.
The (syntax colored) source code appears in the left
source code window. IT CANNOT BE EDITED, but ONLY VIEWED!
The demo viewer windows can be resized. The divider between text
and canvas can be moved by grabbing it with the mouse. The text font
size can be changed from the menu and with Control/Command '-'/'+'.
It can also be changed on most systems with Control-mousewheel
when the mouse is over the text.
Press START button to start the demo.
Stop execution by pressing the STOP button.
Clear screen by pressing the CLEAR button.
Restart by pressing the START button again.
SPECIAL demos, such as clock.py are those which run EVENTDRIVEN.
Press START button to start the demo.
- Until the EVENTLOOP is entered everything works
as in an ordinary demo script.
- When the EVENTLOOP is entered, you control the
application by using the mouse and/or keys (or it's
controlled by some timer events)
To stop it you can and must press the STOP button.
While the EVENTLOOP is running, the examples menu is disabled.
- Only after having pressed the STOP button, you may
restart it or choose another example script.
* * * * * * * *
In some rare situations there may occur interferences/conflicts
between events concerning the demo script and those concerning the
demo-viewer. (They run in the same process.) Strange behaviour may be
the consequence and in the worst case you must close and restart the
viewer.
* * * * * * * *
(2) How to add your own demos to the demo repository
- Place the file in the same directory as turtledemo/__main__.py
IMPORTANT! When imported, the demo should not modify the system
by calling functions in other modules, such as sys, tkinter, or
turtle. Global variables should be initialized in main().
- The code must contain a main() function which will
be executed by the viewer (see provided example scripts).
It may return a string which will be displayed in the Label below
the source code window (when execution has finished.)
- In order to run mydemo.py by itself, such as during development,
add the following at the end of the file:
if __name__ == '__main__':
main()
mainloop() # keep window open
python -m turtledemo.mydemo # will then run it
- If the demo is EVENT DRIVEN, main must return the string
"EVENTLOOP". This informs the demo viewer that the script is
still running and must be stopped by the user!
If an "EVENTLOOP" demo runs by itself, as with clock, which uses
ontimer, or minimal_hanoi, which loops by recursion, then the
code should catch the turtle.Terminator exception that will be
raised when the user presses the STOP button. (Paint is not such
a demo; it only acts in response to mouse clicks and movements.)
N)*)ColorDelegator color_config)
Percolator) view_text)__doc__win32)
fix_win_hidpidarwin Arial )r r bold)zLucida Console
normal d ) r r c t j t D cg c] } | j d r
| d dk7 r| d d " c} S c c} w )Nz.pyr _)oslistdirdemo_direndswith)entrys ,/usr/lib64/python3.12/turtledemo/__main__.pygetExampleEntriesr* v sL $&JJx$8 7$85 NN5 !eAh#o
#2J$8 7 7 7s %AzTurtledemo helpzAbout turtledemozAbout turtle modulec e Zd ZddZd Zd Zd Zd ZddZddZ d Z
dd
Z d Z d Z
d
Zd Zd Zd Zd Zd Zd Zy)
DemoWindowNc
N t x| _ x}t _ |j d |j d| j t rTdd l}|j dddddj t j ddg|j |j |j dd
|j dd
|j d
d d
|j dd d
|j dd d
t! |t" d | _ | j$ j' | j) | j$ dd | j$ j' | j+ | j$ dd | j$ j' | j- | j$ dd | j$ |d< t/ |t0 dt2 d }|j5 | j7 | |j5 | j9 | |j; ddd t= |d
d d d dt> | _ t rjtC |d tD d!| jF " | _$ tC |d#tD d!| jJ " | _& tC |d$tD d!| jN " | _( nltC |d tD d%d&| jF ' | _$ tC |d#tD d%d&| jJ ' | _& tC |d$tD d%d&| jN ' | _( | j@ j; d
ddd() | jH j; d
d
d*+ | jL j; d
dd*+ | jP j; d
dd*+ tS | jT jW tY d,| _- d,| _. |r| j_ | | ja tb tb tb d-d. td | _3 y )/Nz Python turtle-graphics examplesWM_DELETE_WINDOWr osascriptz-ez tell application "System Events"z>set frontmost of the first process whose unix id is {} to truezend tell)stderrstdoutr )weightZ )minsizer2 r
r )relief borderwidthExamples)menulabel underlineFontsizeHelpr8 r z#ddd)orient sashwidth
sashreliefbgr news)row
columnspanstickyz --- z#ddf)r r )heighttextr@ fontr6 r5 z START z#00cc22)rG rH fgcommandz STOP z CLEAR whitez#fed)rG rH rI disabledforegroundrJ )r r )rB columnrD padxew)rB rM rD FzChoose example from menublack)4Tkrootturtle_roottitle wm_protocol_destroyr
subprocessrunformatr$ getpidDEVNULLgrid_rowconfiguregrid_columnconfigureMenuRAISEDmBar add_cascademakeLoadDemoMenu makeFontMenu makeHelpMenu PanedWindow
HORIZONTALSOLIDadd
makeTextFramemakeGraphFramegridLabelRIDGE
output_lblButtonbtnfont startDemo start_btnstopItstop_btn clearCanvas clear_btnr rG insertfilterr dirtyexitflagloadfile configGUIDISABLEDSTARTUPstate)selffilenamerR rX panes r) __init__zDemoWindow.__init__ s *,$. .D6<
45 +T]];
NN# @ 66.> @DN
1V% H !D9
q48 !D9499 **>+;<
MM( # x817 <
c L | j j }| j j }| j j d| j |z
z | j z | j j d| j |z
z | j z y )Ng ?)canvas winfo_width winfo_height xview_moveto canvwidth yview_moveto
canvheight)r eventcwidthcheights r) onResizezDemoWindow.onResize sx ((*++**, dnnV&;!t!NOr c t | x| _ }t |dddd x| _ }t | t |d x| _ }|j |d< |j t t t |d
t x| _ }|j |d< |j t t |j |d < |j |d
< t# t$ |d< t& rdnd}|j) d|z | j* |j) d|z | j* |j) d|z | j, |j) d|z | j, |j/ d| j0 |j/ d| j, |j/ d| j* |j t t2 d |S )NrG r none- )namerN wrapwidthvbar)r rJ )sidefillhbar)r r= yscrollcommandxscrollcommandrH CommandControlz
<%s-minus>z<%s-underscore>z
<%s-equal>z <%s-plus>zzzr )r r expand)Frame
text_frameTextrG r Scrollbarr yviewpackLEFTYrg r xviewBOTTOMXsettupletxtfontr bind_all
decrease_size
increase_sizebindupdate_mousewheelBOTH)r rR r rG r r shortcuts r) rj zDemoWindow.makeTextFrame s ',T{2*
a%+2 7 7 DT$Zf== D **Y t! $$ZfZPP D **Y vA &!%
!%
W~V &9I
lX-t/A/AB
'(2D4F4FG
lX-t/A/AB
kH,d.@.@A ($*@*@A &(:(:; &(:(:; t$q 1r c
|t j _ d| _ d| _ t j
|dd| j | j xt j _ x| _ }|j |j j d| j d|j d< t j x| _
}t j j || |gt j _ |S )Ni i iX z r r6 )rS _ScreenrT r r ScrolledCanvas_canvasr
adjustScrolls _rootwindowr r Screenscreen TurtleScreenr RawTurtlescreens)r rR r r s r) rk zDemoWindow.makeGraphFrame s
$ 8>8M8Mc39A A Av
t}}=()}% %}}. f$$VV4$*8
r c r |t d< t t | j d< d|z | j d< y )Nr rH z Font size %drG )r r rG ro )r sizes r) set_txtsizezDemoWindow.set_txtsize s0
!'N &"04"7 r c V | j t t d dz
t yNr break)r maxr MINIMUM_FONT_SIZEr dummys r) r zDemoWindow.decrease_size
# WQZ!^->?@r c V | j t t d dz t yr )r minr MAXIMUM_FONT_SIZEr s r) r zDemoWindow.increase_size r r c p |j dk t k( r| j S | j S )Nr )deltar r r )r r s r) r z DemoWindow.update_mousewheel s4
KK!OV ,%%' '%%' 'r c t rU| j j | | j j | | j j | nx| j j ||t
k( rdnd | j j ||t
k( rdnd | j j ||t
k( rdnd | j j || y )N)r z#d00z#fca)r r@ )rG rI )r rs configru rw NORMALro )r startstopcleartxtcolors r) r| zDemoWindow.configGUI s NN ! ! ! . MM t , NN ! ! ! . NN ! !/4VF
"
L MM t.2fnF&
!
J NN ! !/4VF
"
L CE 2r c | t | }t D ]" }|f fd }|j |dt | $ |S )Nc ( j | y N)r{ )r( r s r) loadz)DemoWindow.makeLoadDemoMenu..load, s
e$r r r9 r: rH rJ )r_ r* add_commandmenufont)r masterr8 r( r s ` r) rc zDemoWindow.makeLoadDemoMenu( sD F|&(E
% 5A"*D
: )
r c . t | }|j d j t |j d j t |j t D ]+ }|f fd }|j t | dt | - |S )NzDecrease (C-'-'))r9 rJ rH zIncrease (C-'+')c ( j | y r )r )r r s r) resizez'DemoWindow.makeFontMenu..resize; s &r r r )r_ r r r r
add_separator
font_sizesstr)r r r8 r r s ` r) rd zDemoWindow.makeFontMenu2 s F| 14;M;M & ( 14;M;M & ( D
' 3t9"*F
<
r c z t | }t D ]% \ }}||f fd }|j |t | ' |S )Nc 4 t j | | y r )r rR )
help_label help_filer s r) showz%DemoWindow.makeHelpMenu..showE s $))Z;r )r9 rH rJ )r_ help_entriesr r )r r r8 r r r s ` r) re zDemoWindow.makeHelpMenuA sA F|%1 !J *i
< :Hd K &2 r c ` | j r"| j j d| _ y y NF)ry r r r s r)
refreshCanvaszDemoWindow.refreshCanvasJ s% :: KK DJ r c , | j dt j _ d|z }t | t
j | | _ t | j j d 5 }|j }d d d | j j dd | j j d | j j |dz | j! t" t$ t$ dd t& | _ y # 1 sw Y xY w) NFz turtledemo.rz1.0endz# - a Python turtle graphics examplezPress start buttonred)rv rS r _RUNNING
__import__sysmodulesmoduleopen__file__readrG deleteinsertrR rU r| r r} READYr )r r modnamefcharss r) r{ zDemoWindow.loadfileO s ',$ (*7kk'*
$++&&
,FFHE - & & #HHI vx+U 4
-
,s .D
Dc | j d| _ dt j _ | j t t t dd | j j | j j d t | _ | j j }|dk( r t | _ n t | _ | j t k( r!| j t t t | y | j t k( r)d| _ | j t t t dd y y # t j" $ r | j$ Y y t | _ d}Y w xY w) NTzdemo running...rP standard EVENTLOOPzstopped!zuse mouse/keys or STOPr )r ry rS r r r| r} r r r modeRUNNINGr r main EVENTDRIVENDONE
TerminatorrR rz )r results r) rr zDemoWindow.startDemo^ s
'+$ x(' 3 $
[[%%'F$ (
!
:: NN68V!
#
ZZ;
& DM NN8VX3U
< ' yy DJ F s 6D6 6 E'
E'&E'c | j | j j d | j j d | j t t t y )Nall )cursor)r r _deleter r r| r r} r s r) rv zDemoWindow.clearCanvas{ sE E" "% vx2r c | j r8| j d| _ | j t t t dd dt
j _ y )NFzSTOPPED!r )rz rv r| r r} rS r r r s r) rt zDemoWindow.stopIt sA == !DM NN68X%u
.',$r c p dt j _ | j j d | _ y r )rS r r rR destroyr s r) rW zDemoWindow._destroy s' ',$ r r )r blue)__name__
__module__ __qualname__r r rj rk r r r r r| rc rd re r r{ rr rv rt rW r r) r, r, s_ I XP 8(8
( 3
<:3 -r r, c L t } | j j y r )r, rR mainloop)demos r) r r s r) s Tj : ) &
2<<7*O
77??277??84 5 !
R
*
7
7
)*FNN+ K K\ zF r