PawnLibs/scramble

Summary

A helper library that facilitates level initialization.

Description

This library contains several useful utilities which simulate cube twists. An application can initialize its inner state data with wining condition and do some virtual twists to prepare initial arrangement for player like deck shuffling or Rubik'c cube scramble.

To use this library several functions have to be defined:

• RememberDataBeforeTwist()
• SetDataAfterTwist(moduleTo, screenTo, moduleFrom, screenFrom)
• VirtualTwist(twist[TOPOLOGY_TWIST_INFO])

TBD - add detailed descriptions of required functions

Example

TBD - add example description

1     new mapping[MODULES_MAX][SCREENS_MAX];
2     new mappingTemp[MODULES_MAX][SCREENS_MAX];
3 
4     RememberDataBeforeTwist() {
5       // Back up current mapping
6       mappingTemp = mapping;
7     }
8 
9     SetDataAfterTwist(moduleTo, screenTo, moduleFrom, screenFrom) {
10       // Fill mapping according to the new topology after twise
11       mapping[moduleTo][screenTo] = mappingTemp[moduleFrom][screenFrom];
12     }
13 
14     VirtualTwist(twist[TOPOLOGY_TWIST_INFO]) {
15       // Additional handling of virtual twist if necessary
16       myTwist = twist;
17     }
18 

PawnLibs/scramble/Scramble

Summary

Scramble the cube randomly the specified number of times.

Synopsis

1Scramble(twistsCount)
2 

Inputs

• twistsCount - how many times to twist the cube for scramble

PawnLibs/scramble/ScrambleRotate

Summary

Twist the cube around some screen in a specified direction.

Synopsis

1ScrambleRotate(scr, dir)
2 

Inputs

• scr - a screen to twist around
• dir - a direction of the twist