Function gorrosion_gtp::command::setup::place_free_handicap

pub fn place_free_handicap() -> Command

Engine: Place your own free hadicap.

Effects

Handicap stones are placed on the board on the vertices the engine prefers. See also section 4.1.2.

The relevant part of Section 4.1.2 is

[W]hen the number of handicap stones becomes very high there is no benefit in additional stones. Therefore, when asked to choose handicap placement, an engine is allowed to return a smaller number of stones than requested. This provision should only be used if the requested number of stones is so high that a smaller number of stones is believed to guarantee that the engine cannot possibly lose against any opponent.

Fails

• Syntax error
• Invalid number of stones (At least two)
• Board not empty
• Bad vertex list (I do not understand this one. It might have been mistakenly copied from set_free_handicap.)

Comments

This command is only valid if the board is empty. The engine may place fewer than the requested number of stones on the board under certain circumstances, as discussed in section 4.1.2. The controller can check this by counting the number of vertices in the response. The handicap stones are not included in the move history. Vertices must not be repeated or include “pass”.