Line 1: |
Line 1: |
| ==Turtle in a Pond Activity== | | ==Turtle in a Pond Activity== |
| | | |
− | Turtle in a Pond is a strategy game. The goal is to surround the turtle before it runs of the screen.
| + | Read at https://help.sugarlabs.org/turtle_in_a_pond.html |
| | | |
− | [[File:Turtle-in-a-pond.png|300px]]
| + | The source file has been moved to [https://github.com/godiard/help-activity/blob/master/source/turtle_in_a_pond.rst GitHub] |
− | | |
− | === How to play Turtle in a Pond ===
| |
− | | |
− | Did you know that:
| |
− | * You can load your own strategy for the turtle
| |
− | | |
− | ==== The Toolbars ====
| |
− | | |
− | [[Image:TurtlePond_toolbar-1.png]]
| |
− | | |
− | :from left to right
| |
− | # the Activity toolbar button (shown in the open position)
| |
− | # the New-game button
| |
− | # an area for messages
| |
− | # the Load-new-strategy button
| |
− | # the Reload-the-default-strategy button
| |
− | # the Activity stop button
| |
− | | |
− | === Strategy ===
| |
− | | |
− | In this strategy, the turtle moves down, regardless of whether the dot is open.
| |
− | <pre>
| |
− | def _turtle_strategy(self, turtle):
| |
− | turtle[1] +=1
| |
− | return turtle
| |
− | </pre>
| |
− | | |
− | In this strategy, the turtle moves down until it is blocked.
| |
− | <pre>
| |
− | def _turtle_strategy(self, turtle):
| |
− | if not self._dots[self._grid_to_dot((turtle[0], turtle[1]+1))].type:
| |
− | turtle[1] +=1
| |
− | return turtle
| |
− | </pre>
| |
− | | |
− | In this strategy, the turtle searches for an open dot, looking clockwise.
| |
− | | |
− | <pre>
| |
− | def _turtle_strategy(self, turtle):
| |
− | c = turtle[1] % 2
| |
− | for i in range(6):
| |
− | col = turtle[0] + CIRCLE[c][i][0]
| |
− | row = turtle[1] + CIRCLE[c][i][1]
| |
− | if not self._dots[self._grid_to_dot((col, row))].type:
| |
− | return [col, row]
| |
− | return turtle
| |
− | </pre>
| |
− | | |
− | In the '''default strategy''', the turtle choose a random direction and goes there if the dot is open.
| |
− | | |
− | <pre>
| |
− | def _turtle_strategy(self, turtle):
| |
− | c = turtle[1] % 2
| |
− | n = int(uniform(0, 6))
| |
− | for i in range(6):
| |
− | col = turtle[0] + CIRCLE[c][(i + n) % 6][0]
| |
− | row = turtle[1] + CIRCLE[c][(i + n) % 6][1]
| |
− | if not self._dots[self._grid_to_dot((col, row))].type:
| |
− | return [col, row]
| |
− | return turtle
| |
− | </pre>
| |
− | | |
− | In this strategy, the turtle will go off the edge if it can.
| |
− | | |
− | <pre>
| |
− | def _turtle_strategy(self, turtle):
| |
− | c = turtle[1] % 2
| |
− | for i in range(6):
| |
− | col = turtle[0] + CIRCLE[c][i][0]
| |
− | row = turtle[1] + CIRCLE[c][i][1]
| |
− | if self._dots[self._grid_to_dot((col, row))].type is None:
| |
− | return [col, row]
| |
− | | |
− | n = int(uniform(0, 6))
| |
− | for i in range(6):
| |
− | col = turtle[0] + CIRCLE[c][(i + n) % 6][0]
| |
− | row = turtle[1] + CIRCLE[c][(i + n) % 6][1]
| |
− | if not self._dots[self._grid_to_dot((col, row))].type:
| |
− | return [col, row]
| |
− | return turtle
| |
− | </pre>
| |
− | | |
− | The dots are stored in a 13x13 array. Each dot has an attribute, 'type', that determines it status. The edges have a type=None. Occupied dots have a type=True. Unoccupied dots have a type=False.
| |
− | | |
− | Your strategy should start with:
| |
− | | |
− | def _turtle_strategy(self, turtle):
| |
− | | |
− | The turtle argument is a tuple containing the column and row of the current turtle position. That is, turtle[0] is the horizontal position and turtle[1] is the vertical position.
| |
− | | |
− | Your strategy should return a tuple containing the column and row of the new turtle position, e.g.,
| |
− | | |
− | return [col, row]
| |
− | | |
− | There are some resources that you can use in your program, including:
| |
− | | |
− | ;CIRCLE: a 2x6x2 array of offsets that can used to find the col and row of the dots surrounding the turtle.
| |
− | ;self._dots: the array of dots.
| |
− | ;self._pressed: the index of the most recent dot pressed by the user
| |
− | ;self._orientation:you can set the orientation of your turtle by assigning a number from 0-5 (clockwise beginning with 30 degrees from north)
| |
− | ;self._set_label('your message here'):you can write a message on the toolbar if you want to communicate what your turtle is thinking
| |
− | | |
− | === Where to get Turtle in a Pond ===
| |
− | | |
− | The Turtle in a Pond activity is available for download from the [http://activities.sugarlabs.org Sugar activity portal]: [http://activities.sugarlabs.org/en-US/sugar/addon/4516 Turtle in a Pond]
| |
− | | |
− | The source code is available on [http://git.sugarlabs.org/turtlepond the Sugar Labs Gitorious server].
| |
− | | |
− | [[Category:Activity]]
| |