ROSConDemo/Project/Gem/Source/ApplePicker/PickingStructs.h

/*
 * Copyright (c) Contributors to the Open 3D Engine Project.
 * For complete copyright and license terms please see the LICENSE at the root of this distribution.
 *
 * SPDX-License-Identifier: Apache-2.0 OR MIT
 *
 */
#pragma once

#include <AzCore/Component/EntityId.h>
#include <AzCore/Math/Aabb.h>

namespace AppleKraken
{
    //! Important states of the Kraken effector (manipulator with a vacuum nozzle)
    enum class EffectorState
    {
        IDLE = 0, //!< Idle state / position, suitable for robot moving around the environment.
        PREPARED = 10, //!< State and position which are ready for picking tasks.
        PICKING = 20, //!< The effector is on its way to pick fruit.
        RETRIEVING = 30, //!< The effector is retrieving a fruit to storage position.
        INVALID = -1 //!< Invalid state. Requires an additional context that could help user understand what happened. @see PickingState.
    };

    //! A structure holding a state of effector, including optional progress and descriptive information.
    struct PickingState
    {
        EffectorState m_effectorState = EffectorState::IDLE; //!< Current state of effector.
        float m_taskProgress = 0.0f; //!< Optional field signalling progress within current state (picking/retrieving).
        AZStd::string m_description; //!< Optional descriptive field to inform the user.
    };

    //! A task to pick a single apple.
    struct PickAppleTask
    {
        AZ::EntityId m_appleEntityId; //!< EntityId of the apple. Can be Invalid if the information is not available (check IsValid()).
        AZ::Aabb m_appleBoundingBox; //!< Bounding box of the apple to pick.
    };
} // namespace AppleKraken