Changes

Activities/Turtle Art/Plugins (view source)

Revision as of 10:36, 15 January 2015

5,362 bytes added , 10:36, 15 January 2015

m

Line 4: Line 4:

The plugin mechanism is currently used to provide support for sensors, the camera, RFID, and the Media, Extras, and Portfolio palettes. A plugin has been [http://lists.sugarlabs.org/archive/iaep/2011-March/012715.html developed for WeDo] [http://tonyforster.blogspot.com/2012/01/wedo-plugin-for-turtle-art.html (and here)] and additional plugins are being developed for Arduino, NXT, and GoGo.

+

'''NOTE''': As of Version 193, it is necessary to use a set of refactored plugins. These will be posted to the wiki ASAP.

===How to install a plugin===

Line 50: Line 52:

* turtleart-sensors

* rfid (This plugin allows interfacing with a RFID reader)

+

====Xevents====

+

Xevents it's a plugin for make accesibility interfaces in an easy way.

+

[[File:Xpalette1.png]]

+

=====GIT code=====

+

http://sourceforge.net/p/butia/code/ci/master/tree/turtlebots/xevents/

+

=====Download=====

+

http://www.fing.edu.uy/inco/proyectos/butia/mediawiki/index.php/Archivo:Xevents.tar.gz

+

=====Wiki=====

+

http://wiki.sugarlabs.org/go/Xevents

====Butia====

Line 55: Line 71:

Add a palette to control the Butiá robot

−

[[File:butia_palette.png|~~900px~~]]

+

[[File:butia_palette.png|1050px]]

+

And a extra palette to control the hacks pin of USB4Butiá board and special sensors:

+

[[File:butia_palette_extra.png|1050px]]

Andrés Aguirre is part of the Butiá team in Montevideo:

Line 63: Line 83:

Butiá is also featured in a short film by Antel [http://www.adinettv.com.uy/video/2932] (go to 1:30).

−

[http://www.fing.edu.uy/inco/proyectos/butia Proyecto Butiá]

+

[http://www.fing.edu.uy/inco/proyectos/butia Proyecto Butiá] (in Spanish) , [[Activities/TurtleBots]] (in English)

=====GIT code=====

Line 71: Line 91:

=====Download=====

−

[http://www.fing.edu.uy/inco/proyectos/butia/files/butia_plugin.tar.gz butia_plugin.tar.gz]

+

[http://www.fing.edu.uy/inco/proyectos/butia/files/plugins/butia_plugin.tar.gz butia_plugin.tar.gz]

====FollowMe====

Line 77: Line 97:

This plugin uses the camera and get the position of an object of a color.

The plugin add this palette:

−

[[File:turtleart-followme-palette2.png|~~800px~~]]

+

[[File:turtleart-followme-palette2.png|1050px]]

=====Examples=====

Line 105: Line 125:

=====Download=====

−

[http://www.fing.edu.uy/inco/proyectos/butia/files/followme_plugin.tar.gz followme_plugin.tar.gz]

+

[http://www.fing.edu.uy/inco/proyectos/butia/files/plugins/followme_plugin.tar.gz followme_plugin.tar.gz]

+

====Pattern detection====

+

Add a palette to enable pattern detection with the camera.

+

[[File:PatternDetectionPalette.png]]

+

Translation:

+

* "Viendo Señal": Pattern in sight

+

* "Distancia Señal" Pattern distance

+

This palette adds blocks to detect ARToolkit patterns and the distance to them. This plugin is an ARToolkit wrapper, and comes with several traffic signals already configured.

+

=====Examples=====

+

Here are some samples and videos on how to use the palette blocks.

+

[[File:PatternDetectionSampleStop.png | top]] {{#widget:YouTube|id=vF9ZhQYIwVg}}

+

[[File:PatternDetectionSampleYield.png | top]] {{#widget:YouTube|id=vF9ZhQYIwVg}}

+

[[File:PatternDetectionSampleWrongWay.png | top]] {{#widget:YouTube|id=vF9ZhQYIwVg}}

+

[http://www.fing.edu.uy/inco/proyectos/butia/mediawiki/index.php/Butia_reconocimiento_marcas Pattern detection plugin] (in Spanish)

+

=====GIT code=====

+

Hosted with the Butiá source

+

[http://sourceforge.net/p/butia/code/ci/dcc226276a565a54bbdf1807c30ff50aa648f70f/tree/turtle_art_plugin/pattern_detection/ Pattern Detection in SourceForge (part of Butia project)]

+

=====Download=====

+

[http://www.fing.edu.uy/inco/proyectos/butia/files/plugins/pattern_detection.tar.gz pattern_detection.tar.gz]

====WeDo====

−

Tony Forster created a [http://tonyforster.blogspot.com/2012/01/wedo-plugin-for-turtle-art.html WeDo plugin] based on the [https://github.com/itdaniher/WeDoMore/tree/master/TurtleArt work of I.T. Daniher].

+

Tony Forster created a [http://tonyforster.blogspot.com/2012/01/wedo-plugin-for-turtle-art.html WeDo plugin] based on the [https://github.com/itdaniher/WeDoMore/tree/master/TurtleArt work of I.T. Daniher]. Alan Aguiar has also helped with the plugin.

The source code repository is available here: [https://github.com/itdaniher/wedomore].

Line 116: Line 169:

=====Download=====

−

[[File:~~Wedo_plugin~~.tar.gz]] WeDo ~~plugin~~

+

* [[File:Wedo_plugin_2.tar.gz]] Version 2, which supports multiple WeDo devices.

+

* [http://www.fing.edu.uy/inco/proyectos/butia/files/plugins/wedo_plugin.tar.gz /wedo_plugin.tar.gz]

'''Note:''' Check out https://github.com/itdaniher/WeDoMore/tree/master/udev for instructions on how to setup the proper permissions talk to the device. In the new versions of Sugar the udev is included.

Line 122: Line 177:

====LEGO NxT====

−

[[File:turtleart-lego-nxt-palette.png|~~900px~~]]

+

Motors palette:

+

[[File:turtleart-lego-nxt-palette.png|1050px]]

+

Sensors palette:

+

[[File:turtleart-lego-nxt-palette-sensors.png|1050px]]

=====Examples=====

Line 143: Line 204:

=====Downloads=====

−

LEGO NxT Plugin [~~[File~~:nxt_plugin.tar.gz]]

+

LEGO NxT Plugin [http://www.fing.edu.uy/inco/proyectos/butia/files/plugins/nxt_plugin.tar.gz nxt_plugin.tar.gz]

+

====Expeyes====

+

The Expeyes Plugin:

+

[https://github.com/walterbender/expeyes]

+

[[Image:Expeyes.png|300px]]

+

This is a first pass at a plugin for the ExpEyes Junior. For more info, see [http://expeyes.in].

+

Note that you need to set up the udev rules for the device before first using this plugin by running the postinst script bundled with the plugin:

+

sudo sh ~/Activities/TurtleArt.activity/plugins/eyes/postinst

====Arduino====

+

The Arduino is an inexpensive single board computer which can be controlled by Turtle Art and used for robotics experiments. The XO-4 touchscreen laptop comes with two unpopulated circuit boards, the [http://wiki.laptop.org/go/XO_Stick XOstick] and the [http://wiki.laptop.org/go/XOrduino XOrduino].

The Arduino Plugin:

−

[[File:turtleart-arduino-palette.png|~~800px~~]]

+

[[File:turtleart-arduino-palette.png|1050px]]

There are several efforts to develop Turtle Art support for Arduino.

Line 163: Line 239:

* Auto detection of ttyUSBx port for FTDI device (Arduino board uses this for USB)

−

It requires the Firmata protocol to be uploaded to the Arduino board. (see [~~[arduino]~~]

+

It requires the Firmata protocol to be uploaded to the Arduino board. (see [http://wiki.laptop.org/go/Arduino here])

Use the latest Firmata version (2.1 as of now) downloaded from the Firmata page (firmata.org)

The Firmata version included with the Arduino IDE has some inconsistencies.

Line 177: Line 253:

=====Downloads=====

−

The plugin file can be downloaded from [~~[File~~:~~arduino~~.tar.gz]].

+

The plugin file can be downloaded from [http://www.fing.edu.uy/inco/proyectos/butia/files/plugins/arduino_plugin.tar.gz arduino_plugin.tar.gz].

====Currency====

Line 211: Line 287:

Use these blocks to create objects that are added to the bodylist and jointlist of a Box2d database used by the Physics Activity. Objects are positioned by the turtle x,y and colored based on the current pen attributes. From left to right:

+

* density: set the object density (0 is light; 1 is heavy)

+

* friction: set the object friction (0 is slippery; 1 is sticky)

+

* bounciness: set the object restitution (0 is rigid; 1 is bouncy)

* start polygon: use the current turtle x,y position to specify the first vertex of a polygon

* add point: use the current turtle x,y position to add a vertex to a polygon

Line 220: Line 299:

* rectangle: add a rectangle object at the current turtle x,y position

* gear: add a gear object at the current turtle x,y position with the number of teeth as the argument

+

* gear radius: returns the radius of a gear with the number of teeth as the argument (useful for positioning gears)

* motor: add a motor at the current turtle x,y position (attached to the object at this position)

−

* pin: add a pin at the current turtle x,y position (attached to the object at this position)

+

* pin: add a pin at the current turtle x,y position (attached to the object at this position) to prevent movement

+

* pen: add a pen at the current turtle x,y position (attached to the object at this position) to trace motion

* joint: add a joint between the object at the current turtle x,y position and the object at x, y

−

* density: set the object density (0 is light; 1 is heavy)

−

* friction: set the object friction (0 is slippery; 1 is sticky)

−

* bounciness: set the object restitution (0 is rigid; 1 is bouncy)

* save as Physics project: save the current bodylist and jointlist as a Physics project in the Journal

'''Note:''' The current model is cleared whenever the Erase button is pressed or a Clean block is run.

Line 235: Line 313:

[[File:TAGear.png|300px]]

+

'''For Turtle Blocks versions 107 - 183'''

[[File:TAgear.ta]] [[File:Gear.physics]]

+

'''For Turtle Blocks verisons 184 - '''

+

[http://people.sugarlabs.org/walter/physics-plugin.tar.gz]

+

'''A chain'''

+

[[File:Chain.png|300px]]

+

Turtle Blocks project file: [http://people.sugarlabs.org/walter/chain.tb]

=====Downloads=====

Line 241: Line 329:

[[File:Physics-plugin.tar.gz]] Physics plugin

+

[http://github.com/walterbender/physics-plugin git repository]

+

==== Logic ====

+

This plugin provides logical bit operations in Turtle Art, such as AND, OR, XOR, NOT, logical shift left, logical shift right.

+

[[File:Logic.png]]

+

===== Example =====

+

[[File:And.png|300px]]

+

[[File:Lsl2.png|300px]]

+

=====Downloads=====

+

[[File:Logic.tar.gz]] Logic plugin

+

==== Math ====

+

The math plugin allows to use advanced mathematical functions in your program.

+

[[File:Tb-math.png|800px]]

+

===== Download =====

+

http://people.sugarlabs.org/francis/tb-math-plugin/

+

===== Source code =====

+

https://github.com/sdanielf/turtleblocks-math

+

==== Mashape ====

+

This plugins enable the mashape palette (plugins using web APIs)

+

The mashape palette is easy to detect, its use a sugarized icon of original mashape icon. (A monkey ''':)''')

+

Also, this version include Translate plugin.

+

[[File:Tb-mashape-palette.png|800px]]

+

[[File:Tb-mashape-plugin.png|800px]]

+

===== Download =====

+

[[File:TA-Mashape.tar.gz]]

+

===== Source code =====

+

https://github.com/ignaciouy/mashape-plugin

+

=== GNOME plugins ===

+

There are some plugins that are specific to running Turtle Art from the GNOME desktop. These include mechanisms for uploading projects to Facebook (See [[Activities/TurtleArt/Fb_plugin.py]] and http://turtleartsite.appspot.com/

+

([[File:Turtleblocks-167.1.xo]] is the Alpha version of Turtle Art for GTK3. It requires GTK3 and GST1 (both available in Sugar 0.98 on [http://wiki.laptop.org/go/13.1.0 OLPC 13.1.0 builds]) This version includes the Facebook plugin.

===TurtleArt + icaro = Tortucaro===

Line 246: Line 375:

See http://proyectofedora.org/argentina/?p=320

+

(The above link is down. The cached version of the page can be found at [http://webcache.googleusercontent.com/search?q=cache:Vab9UyzE61MJ:proyectofedora.org/argentina/%3Fp%3D320+&cd=1&hl=es&ct=clnk&gl=ar])

===How to write a plugin===

Ignacio Rodríguez

56

edits

Changes

Activities/Turtle Art/Plugins (view source)

Revision as of 10:36, 15 January 2015

Navigation menu

Search