gripper_node.h

浏览该文件的文档.

#ifndef AUBO_SCOPE_GRIPPER_NODE_H
#define AUBO_SCOPE_GRIPPER_NODE_H
 
#include <aubo_caps/domain/device/gripper_device.h>
#include <aubo_caps/domain/program/nodes/program_node.h>
#include <aubo_caps/domain/undoredo/undo_redo_manager.h>
 
namespace arcs {
namespace aubo_scope {
ARCS_CLASS_FORWARD(GripperNode);
 
/**
 * \chinese
 * <p>此接口表示一个程序节点，可用于编程所选夹爪设备的夹取和释放动作。</p>
 * <p>此接口的实例可使用 GripperNodeFactory 接口构建。</p>
 * \endchinese
 * \english
 * <p>This interface represents a program node which can be used for programming
 * grip and release actions with a selected gripper device.</p>
 * <p>An instance of this interface can be built using the {@link
 * GripperNodeFactory} interface and is returned as a result when {@link
 * GripperNodeFactory#createGripperNode(GripperDevice)} is called.</p>
 * \endenglish
 */
class ARCS_ABI_EXPORT GripperNode : public ProgramNode
{
public:
    /**
     * The configuration type used to determine which type of configuration this
     * instance is.
     */
    enum ConfigType
    {
 
        /**
         * <p>
         * A Gripper action (i.e. grip or release) has not been selected
         * </p>
         *
         * The config instance can be cast to {@link UndefinedActionConfig}.
         * This is only relevant if the Gripper node uses a multi-gripper
         * device, i.e. a gripper device supporting the multi-gripper capability
         * (see the
         * {@link MultiGripperSupport} interface). The instance will provide
         * access to the individual gripper selection.
         */
        UNDEFINED,
 
        /**
         * <p>
         * The gripper is configured for a grip action
         * </p>
         *
         * The config instance can be cast to {@link GripActionConfig}.
         */
        GRIP_ACTION,
 
        /**
         * <p>
         * The gripper is configured for a release action
         * </p>
         *
         * The config instance can be cast to {@link ReleaseActionConfig}.
         */
        RELEASE_ACTION
    };
 
    GripperNode(GripperNode &f);
    GripperNode(GripperNode &&f);
    virtual ~GripperNode();
 
    /**
     * \chinese
     * 返回配置类型。适当转换此实例以访问特定的 getter。
     * @return 此配置的类型
     * \endchinese
     * \english
     * This method returns the type of configuration. Cast this instance
     * appropriately to have access to specific getters.
     * @return The type of this config.
     * \endenglish
     */
    ConfigType getConfigType();
 
    void setConfigType(ConfigType type);
 
    /**
     * \chinese
     * @return 此夹爪节点使用的夹爪设备
     * \endchinese
     * \english
     * @return The gripper device used by this Gripper node
     * \endenglish
     */
    GripperDevicePtr getGripperDevice();
 
    /**
     * The setting type used to determine which type of setting this instance
     * is.
     */
    enum SettingType
    {
 
        /**
         * <p>
         * No selection has been made.
         * </p>
         */
        UNDEFINED0,
 
        /**
         * <p>
         * A payload (from the installation) is selected.
         * </p>
         *
         * The setting instance can be cast to {@link PayloadSelection}.
         */
        PAYLOAD_SELECTION,
 
        /**
         * <p>
         * Custom payload parameters are specified.
         * </p>
         *
         * The setting instance can be cast to {@link CustomPayloadParameters}.
         */
        CUSTOM_PARAMETERS
    };
 
    /**
     * \chinese
     * 返回设置类型。适当转换此实例以访问特定的 getter。
     * @return 此负载设置的类型
     * \endchinese
     * \english
     * This method returns the type of setting. Cast this instance appropriately
     * to have access to specific getters.
     * @return The type of this payload setting.
     * \endenglish
     */
    SettingType getSettingType();
 
private:
    friend class DataSwitch;
    GripperNode();
    void *d_{ nullptr };
};
} // namespace aubo_scope
} // namespace arcs
 
#endif