Changes

<div class="visualClear"></div>

<div class="visualClear"></div>

There has been a discussion on the OLPC-sur list about the need for a square root function in Turtle Art. Below, I have documented the process I used for adding this functionality with the hope that others may feel comfortable in emulating me in regard to making changes and enhancements to Sugar and Sugar Activities and sharing those enhancements with the community.

There has been a discussion on the OLPC-sur list about the need for a square root function in Turtle Art. Below, I have documented the process I used for adding this functionality with the hope that others may feel comfortable in emulating me in regard to making changes and enhancements to Sugar and Sugar Activities and sharing those enhancements with the community. Beginners may find [[Activity_Team/Modifing_an_Activity]] useful.

You can download the unofficial [http://wiki.laptop.org/images/9/9e/Turtleart-11.xo Turtleart-11.xo here]. The .xo archive can be opened by relabeling it(for example) to a .zip file.

You can download the unofficial [http://wiki.laptop.org/images/9/9e/Turtleart-11.xo Turtleart-11.xo here].  

 

The .xo archive can be opened by relabeling it(for example) to a .zip file.

Within the archive you find the files to be edited, Python source files talogo.py and tasetup.py and the images directory images/en/numbers . Python source files can be edited with [http://www.python.org/ Python].

Within the archive you find the files to be edited, Python source files talogo.py and tasetup.py and the images directory images/en/numbers . Python source files can be edited with [http://www.python.org/ Python].

   

   

  from math import sqrt

  from math import sqrt

and

and

    defprim(lc,'sqrt', 1, lambda lc,x: int(sqrt(x)))

defprim(lc,'sqrt', 1, lambda lc,x: int(sqrt(x)))

* And I had to define a new brick for square root in tasetup.py and describe the bricks attributes: its size; how it connects to other bricks; and default values.  

* And I had to define a new brick for square root in tasetup.py and describe the bricks attributes: its size; how it connects to other bricks; and default values.  

    ('sqrt','sqrt','sqrt',100),

('sqrt','sqrt','sqrt',100),

and

and

  'sqrt':    (('num',True,0,20),('num',False,42,20)),

'sqrt':    (('num',True,0,20),('num',False,42,20)),

* Finally, I had to create a graphic for the brick (images/en/numbers/sqrt.gif) and modify the panel for numbers (images/en/numbers/numbersgroup,gif and numbersmask.gif). I made similar changes to the Spanish version (images/es) and French version (images/fr).

* Finally, I had to create a graphic for the brick (images/en/numbers/sqrt.gif) and modify the panel for numbers (images/en/numbers/numbersgroup,gif and numbersmask.gif). I made similar changes to the Spanish version (images/es) and French version (images/fr).

[[Image:Sqrt.gif|thumb|left|sqrt.gif]]

[[Image:Sqrt.gif|thumb|left|sqrt.gif]]

:and modified images/en/numbers/numbersgroup.gif and numbersmask.gif

:and modified images/en/numbers/numbersgroup.gif and numbersmask.gif

:(I also made corresponding changes in the images/es and images/fr trees)

:(I also made corresponding changes in the images/es and images/fr trees)

* I made an .xo bundle so I could let other people easily install and test my changes

* I made an .xo bundle so I could let other people easily install and test my changes (the following command will create TurtleArt-NN.xo in turtleart-activity/dist):

zip -r turtleart.xo turtleart-activity

* and generate a patch

* and generate a patch

  git diff -U > patch

  git diff -U > patch

* and sent the patch to the maintainer (Brian Silverman) for review

* and sent the patch to the project maintainer (Brian Silverman) for review

  mailto:bss...

  mailto:bss...

* The maintainer made one suggestion:

* The maintainer made one suggestion:

* I made the change and did some more testing.

* I made the change and did some more testing.

  defprim(lc,'sqrt', 1, lambda lc,x: sqrt(x))

  defprim(lc,'sqrt', 1, lambda lc,x: sqrt(x))

* next: "commit" and "push" the patch

* Brian asked me to take over as the maintainer of the Python version of Turtle Art, so I needed to "add" my new files, then "commit" and "push" my patch:

 

  git-commit -a

  git-commit -a

  Created commit fa7a12f: new file:  images/en/numbers/sqrt.gif

  Created commit fa7a12f: new file:  images/en/numbers/sqrt.gif

  Total 29 (delta 20), reused 0 (delta 0)

  Total 29 (delta 20), reused 0 (delta 0)

  refs/heads/master: 18f37394242044f5104de7f40249caed440cdfa2 -> 1536a4ce43096395e5572ee61dbc87c88daa72ad

  refs/heads/master: 18f37394242044f5104de7f40249caed440cdfa2 -> 1536a4ce43096395e5572ee61dbc87c88daa72ad

  To ssh://dev.laptop.org/git/projects/turtleart-activity

  To ssh://dev.laptop.org/git/projects/turtleart-activity/

     18f3739..1536a4c  master -> master

     18f3739..1536a4c  master -> master

==The patch==

==The patch==