Changes

===Notes===

===Notes===

* The grid layout is arbitrary; there is ''no'' need to pick in rows or columns, or one from each column.

* 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.

* The blank cards on the left are a place to display the most recent match; they can be otherwise ignored.

* A count of number of matches found is shown in the toolbar; when the robot assistant is helping, the count is displayed as two numbers, where the number of matches found by the robot is in parentheses, e.g., 3(2) would indicate that the robot found 2 matches out of a total of 5 (3+2) found so far.

* A count of number of matches found is shown in the toolbar; when the robot assistant is helping, the count is displayed as two numbers, where the number of matches found by the robot is in parentheses, e.g., 3(2) would indicate that the robot found 2 matches out of a total of 5 (3+2) found so far.

* Visual Match keeps track of your best times (one for Beginner Mode and one for Expert Mode). These times are displayed next to the level-mode buttons on the [[#The toolbars|Tools Toolbar]].

* Dimensions keeps track of your best times (one for Beginner Mode and one for Expert Mode). These times are displayed next to the level-mode buttons on the [[#The toolbars|Tools Toolbar]].

* You can select cards using the keyboard:

* You can select cards using the keyboard:

{| border=0

{| border=0

==Learning with Dimensions==

==Learning with Dimensions==

==Extending Dimensions==

==Extending Dimensions==

=== Creating a custom game ===

=== Creating a custom game ===

You can create your own set of cards for Visual Match. Use your favorite program for creating images (Paint, Turtle Art, Record, etc.) to make sets of cards. You need to create at least 9 cards in order to play at the beginner level (3 cards each along 2 dimensions). You can also make a collection of 27 cards (3 cards each along 3 dimensions) or 81 cards (3 cards each along 4 dimensions). The cards must all have the same name in the journal with the exception of a number, beginning with 1 and incrementing by 1, e.g., card.1.png, card.2.png, ... card.9.png. Any image format supported by Sugar should work and you do not have to include the image-type suffix in the title, e.g., card.1, card.2, ... card.9 will also work. Just be sure that the order corresponds to the serialization of your multidimensional space, e.g.:

You can create your own set of cards for Dimensions. Use your favorite program for creating images (Paint, Turtle Art, Record, etc.) to make sets of cards. You need to create at least 9 cards in order to play at the beginner level (3 cards each along 2 dimensions). You can also make a collection of 27 cards (3 cards each along 3 dimensions) or 81 cards (3 cards each along 4 dimensions). The cards must all have the same name in the journal with the exception of a number, beginning with 1 and incrementing by 1, e.g., card.1.png, card.2.png, ... card.9.png. Any image format supported by Sugar should work and you do not have to include the image-type suffix in the title, e.g., card.1, card.2, ... card.9 will also work. Just be sure that the order corresponds to the serialization of your multidimensional space, e.g.:

{| border=1!

{| border=1!

</gallery>

</gallery>

==Programming==

==Modifying Dimensions==

===Show me the code===

===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.

You can explore the Dimensions source code [[http://git.sugarlabs.org/projects/visualmatch/repos/mainline cloning the project]] directly from git.

===Known bugs===

==Where to report problems==

There are several known problems with the current version of Visual Match:

There are several known problems with the current version of Dimensions:

* Restore from Journal does not work on pre-0.82 versions of Sugar.

* Restore from Journal does not work on pre-0.82 versions of Sugar.

* Chinese Cards don't display properly on some systems due to a missing font.

* Chinese Cards don't display properly on some systems due to a missing font.

You can [https://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=Visual+Match view the open tickets here].

You can [https://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=Visual+Match view the open tickets here].

[[Category:Activity]]

[[Category:Activity]]