File indexing completed on 2024-05-19 04:04:53

 /*
     This file is part of the game 'KJumpingCube'
 
     SPDX-FileCopyrightText: 1998-2000 Matthias Kiefer <matthias.kiefer@gmx.de>
     SPDX-FileCopyrightText: 2012 Ian Wadham <iandw.au@gmail.com>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #ifndef AI_NEWTON_H
 #define AI_NEWTON_H
 
 #include "ai_base.h"
 
 /**
 * Class AI_Newton computes the priority of moving a cube and the value of the
 * resulting position.  It assists the main AI class.
 *
 * @short The Newton AI algorithms
 */
 class AI_Newton : public AI_Base
 {
 public:
    QString whoami() override { return QStringLiteral ("Newton"); } // IDW test.
 
    /**
    * The Newton AI constructor.
    */
    AI_Newton();
 
    /**
    * Assess the priority of playing a cube at a particular position.  The
    * highest priority cubes are used by the AI_Main class for look-ahead moves
    * and calculating the values of the positions reached.  The cube to be
    * assessed has to be neutral or owned by the player who is to move.
    *
    * @param index      The index-position of the cube to be assessed
    * @param player     The player who is to move
    * @param neighbors  The index-positions of the cube's neighbors (array),
    *                   where a value of -1 means no neighbor on that side
    * @param owners     The current owners of the cubes in the box (array)
    * @param values     The current point values of the cubes in the box (array)
    * @param maxValues  The maximum point values of the cubes in the box (array)
    *
    * @return           The priority of a move (always > 0): moves with priority
    *                   1 are best and those with priority >= HighValue (999) are
    *                   worst but may be forced (e.g. when defeat is imminent).
    */
    int assessCube (const int index,         const Player player,
                    const int neighbors [4], const Player owners[],
                    const int values[],      const int    maxValues[]) const override;
 };
 
 #endif // AI_NEWTON_H