Difference between revisions of "Activities/VisualMatch"

From Sugar Labs
Jump to navigation Jump to search
(Migrate to GitHub)
 
(101 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[Image:Activity-VisualMatch.png|600px]]
+
== Dimensions ==
  
==The basics==
+
Read at https://help.sugarlabs.org/dimensions.html
  
How to play:
+
The source file has been moved to [https://github.com/godiard/help-activity/blob/master/source/dimensions.rst GitHub]
* 12 cards are on the playing surface at any time.
 
* Click on three cards to make a match.
 
* The most recent match is displayed on the left.
 
 
 
==About Visual Match==
 
 
 
Visual Match is a pattern-matching game written for Sugar; it is included as part of the Honey collection of Sugar add-ons. The object of the game is to find sets of three cards where each attribute—color, shape, number of elements, and shading—either match on all three cards or are different on all three cards. The current version doesn't yet support sharing with multiple players or saving to the Journal, but it can be played by a single player.
 
 
 
[http://activities.sugarlabs.org/en-US/sugar/addon/4246 Version 10]
 
 
 
=== i18n ===
 
 
 
Visual Match has not yet been translated into any languages other than English.
 
 
 
(See [https://dev.laptop.org/translate/ our Pootle server] for details about how to translate Visual Match into your language.)
 
 
 
==More details==
 
* Cards have four different attributes: color, shape, fill texture, and number of elements.
 
::The number version works with prime factors instead of shapes and textures.
 
::The word version works with semantic groupings.
 
 
 
* '''Play''' by clicking on three cards to make a match. If it is a valid match, it will be moved on the left (in the blank-card zone.) It will be replaced by new cards from the deck.
 
 
 
* A valid match is defined by cards where each attribute is either the same on each card or different on each card, e.g, all three red cards or one red, one green, and one blue card.
 
 
 
* An invalid match is when two cards share and attribute and the third card does not, e.g., one red and two green cards.
 
 
 
* Matches must be valid across all four attributes. Examples of [[#Examples of valid matches|valid]] and [[#Examples of invalid matches|invalid]] matches are shown below.
 
 
 
* At the end of the game, all of the matches are displayed in a simple animation.
 
 
 
* As of Version 16, a simple cooperative sharing model is supported.
 
::Everyone works cooperatively to find matches.
 
::Only the initiator of the shared session can start new games, change game type or level.
 
 
 
* Also as of Version 16, the game state is saved to the Journal and restored upon resume. ('''Note:''' Restore is currently broken on Sugar pre-0.82.)
 
 
 
'''Note:'''
 
* The grid layout is arbitrary; there is ''no'' need to pick in rows or columns, or one from each column.
 
* The blank cards on the left are a place to display the most recent match; they can be otherwise ignored.
 
 
 
''Watch out, because VisualMatch can be very addictive.''
 
 
 
===Examples of valid matches===
 
 
 
[[Image:Two-red-circles.png]] [[Image:One-red-circle.png]] [[Image:Three-red-circles.png]] colors, shapes, and shade match; numbers are different
 
 
 
[[Image:One-blue-check.png]] [[Image:One-green-ex.png]] [[Image:One-red-circle.png]] numbers match; colors, shapes and shade are different
 
 
 
[[Image:One-red-circle.png]] [[Image:Three-blue-checks.png]] [[Image:Two-green-exes.png]] everything is different
 
 
 
===Examples of invalid matches===
 
 
 
[[Image:One-red-circle.png]] [[Image:Two-red-circles.png]] [[Image:Three-green-circles.png]] two of the same colors (red)
 
 
 
[[Image:One-green-ex.png]] [[Image:One-blue-ex.png]] [[Image:One-red-circle.png]] two of the same shape (X)
 
 
 
[[Image:Three-blue-checks.png]] [[Image:One-red-circle.png]] [[Image:Two-green-exes-solid.png]] two of the same shade (solid)
 
 
 
[[Image:Two-blue-circles.png]] [[Image:Two-green-circles.png]] [[Image:One-red-circle.png]] two of the same number (2)
 
 
 
===When there is no match===
 
 
 
[[Image:Activity-VisualMatch15.png|600px]]
 
 
 
On occasion, there is no match. If there is no match, three additional cards are dealt as illustrated in the figure above.
 
 
 
===The toolbars===
 
 
 
[[Image:Activity-VisualMatch-Toolbar.png|600px]]
 
 
 
From left to right:
 
:(a) The standard Sugar 'activity' button used to access the activity menu, which includes sharing (the latter not yet implemented);
 
:(b) The 'new pattern game' button used to start a new pattern game;
 
:(c) The 'new number game' button used to start a new number game;
 
:(d) The 'new word game' button used to start a new word game;
 
:(e) The toolbar used to access the computer assistant and the number-game variants
 
:(f) The number of cards remaining in the deck is displayed;
 
:(g) The number of matches found is displayed;
 
:(h) The number of seconds that have elapsed since the last match was found is displayed;
 
:(i) The current status is displayed; Once all of the matches have been found, the total elapsed time is displayed. Note that there may be some cards left on the playing field at the end of the game that do not make a match.
 
:(j) The 'stop' button is used to exit the activity.
 
 
 
[[Image:Activity-VisualMatch-Tools-Toolbar.png|600px]]
 
 
 
From left to right:
 
:(a) The level button switches between beginner (Level 1) and expert (Level 2) modes;
 
:(b) The robot button is used to turn on/off computer assistance;
 
:(c) The time (in seconds) before computer assistance starts;
 
Number card options:
 
:products, Roman numerals, words, Chinese, hash marks, dots in circles, points on a star, dice, dots in rows
 
 
 
[[Image:Activity-VisualMatch-Project-Toolbar.png|600px]]
 
 
 
From left to right:
 
:(a) Sugar Activity title;
 
:(b) Sharing button;
 
:(c) Sugar Keep button;
 
:(d) Journal-entry update button.
 
 
 
'''Note:''' In older versions of Sugar, these buttons appear under the 'Project' tab.
 
 
 
[[Image:Activity-VisualMatch-Toolbar84.png|600px]]
 
 
 
===New features===
 
 
 
* As of Version 9, Visual Match includes number-search and word-search games in addition to the pattern-search game.
 
::'''Note:''' Prior to Version 9, you needed to click the "+3" button for extra cards to be dealt when there are no matches on the board.
 
 
 
* As of Version 14, Visual Match includes a computer (robot) assistant.  The robot will help you find matches. It operates on a timer—finding matches after an adjustable number of seconds. The robot is enabled/disabled by clicking on the button the the Tool menu.
 
 
 
* As of Version 15, Visual Match includes Beginner and Expert Modes. In Beginner Mode, there are only 27 (3<sup>3</sup>) cards and only three card characteristics. In Expert Mode, there are 81 (3<sup>4</sup>) cards and four card characteristics.
 
 
 
* As of Version 16, Visual Match supports sharing.
 
 
 
[[Image:Red-number-5.png]] [[Image:Green-number-7.png]] [[Image:Blue-number-11.png]]
 
 
 
[[Image:Purple-word-moon.png]] [[Image:Red-word-cheese.png]] [[Image:Green-word-moon.png]]
 
 
 
<gallery>
 
File:Visualmatch-numbers1.png|Prime factors (1,2,3,5,7 and 11) are used to determine matches
 
File::isualmatch-numbers2.png|There are a variety of representations used in the number-match game.
 
File:Visualmatch-numbers3.png|Roman numerals and dots in a circle
 
File:Visualmatch-numbers4.png|Hashes and products
 
File:Visualmatch-words1.png|semantic word groups (animal, food, celestial objects) are used to determine matches
 
File:Visualmatch-level-1.png|beginner mode (color, number, and shape)
 
File:Visualmatch-level-2.png|expert mode mode (color, number, shape, and fill)
 
</gallery>
 
 
 
===Show me the code===
 
You can explore the Visual Match source code [[http://git.sugarlabs.org/projects/visualmatch/repos/mainline cloning the project]] directly from git.
 
 
 
 
 
[[Category:Activity]]
 

Latest revision as of 08:58, 25 June 2018

Dimensions

Read at https://help.sugarlabs.org/dimensions.html

The source file has been moved to GitHub