CircuitConstruction Visualization

To aid in the development of your submission, we are providing a visualization tool to competitors. The tool is packaged as an executable jar, which can be run either by double clicking it (in windows anyway) or from the command line as "java -jar Tester.jar".

As in previous contests, to use this visualization tool, you should create an application that communicates with the tool via standard in and standard out. Note that this does not effect the way your program should work when you submit it on the TopCoder website. The program that you write for the visualizer should implement the following pseudocode:
    
nextInt() -- reads an integer from standard in, delimited by whitespace

nextString() -- reads a string from standard in, delimited by whitespace

main()
    W = nextInt()
    H = nextInt()
    C = nextString()
    init(W,H,C)
    while(true)
        for(int i = 0; i<W*H; i++)
            board[i] = nextInt();
        ret = rotateSquare(board)
        println(ret[0]+" "+ret[1]+" "+ret[2])
        flush(stdout)

Using the visualizer

To use the visualizer, you must have Java 1.5 or greater installed. To run the visualizer, you can execute the command "java -jar Tester.jar". This will open up a new window containing the visualization, along with a number of controls. The first thing you will need to do is specify the executable you have made for your code. You may either enter its path, or select it via the button provided. If your executable requires arguments, enter them in the provided field. For example, if your executable is a Java class CircuitConstruction.class, you should enter something like "java CircuitConstruction" (without the quotes) in this field (replacing "java" with the full path to the Java executable if necessary). The exact details of what you enter here will depend on your language choice. In particular, in Java, you will need to make sure that the class file is in the same directory as Tester.jar, or else you will need to specify a classpath along with the executable location and class name. You may also play manually be selected the checkbox, and clicking on the pieces to rotate them (right click to rotate counter-clockwise)

You may customize the test case by entering any values for the parameters that you like. The field seed is a seed for the random number generator and will allow you to repeatedly generate the same test case. You can select new random values for all parameters by clicking "New Parameters". If you've changed the seed since you last generated parameters the new seed will be used to generate new parameters, otherwise a new seed will be generated along with new parameters. To test the examples from the problem statement, you may simply enter the appropriate seeds and click "New Parameters".

Once you've started the simulation, any output you write to standard error, along with messages from the visualization tool will appear in the visualization. You may control the speed with the slider on the top of the control panel.

Command Line Options

You can specify a number of parameters on the command line to simplify the automation of testing (though you don't need to use any of them). For example, "java -jar Tester.jar -seed 5" will set the seed to 5 when running the tool.
-W <W>
-H <H>
-C <C>
-seed <seed> Specify the initial seed
-exec <command> Specify the command to execute your code
-novisRun the test case without the visualizer (requires -exec, implies -go)
-goStart running immediately (requires -exec)
-onewindowRun in one window instead of 3

Final Notes