Vehicle.h

Go to the documentation of this file.

// Copyright (c) 2026 Computer Vision Center (CVC) at the Universitat Autonoma
// de Barcelona (UAB).
//
// This work is licensed under the terms of the MIT license.
// For a copy, see <https://opensource.org/licenses/MIT>.
 
#pragma once
 
#include "carla/client/Actor.h"
#include "carla/rpc/AckermannControllerSettings.h"
#include "carla/rpc/TrafficLightState.h"
#include "carla/rpc/VehicleAckermannControl.h"
#include "carla/rpc/VehicleControl.h"
#include "carla/rpc/VehicleDoor.h"
#include "carla/rpc/VehicleLightState.h"
#include "carla/rpc/VehiclePhysicsControl.h"
#include "carla/rpc/VehicleTelemetryData.h"
#include "carla/rpc/VehicleWheels.h"
#include "carla/trafficmanager/TrafficManager.h"
 
using carla::traffic_manager::constants::Networking::TM_DEFAULT_PORT;
 
namespace carla {
 
namespace traffic_manager {
  class TrafficManager;
}
 
namespace client {
 
  class TrafficLight;
 
  class Vehicle : public Actor {
  public:
 
    using Control = rpc::VehicleControl;
    using AckermannControl = rpc::VehicleAckermannControl;
    using PhysicsControl = rpc::VehiclePhysicsControl;
    using TelemetryData = rpc::VehicleTelemetryData;
    using LightState = rpc::VehicleLightState::LightState;
    using TM = traffic_manager::TrafficManager;
    using VehicleDoor = rpc::VehicleDoor;
    using WheelLocation = carla::rpc::VehicleWheelLocation;
 
 
    explicit Vehicle(ActorInitializer init);
 
    /// Switch on/off this vehicle's autopilot.
    void SetAutopilot(bool enabled = true, uint16_t tm_port = TM_DEFAULT_PORT);
 
    /// Switch on/off this vehicle's autopilot.
    void ShowDebugTelemetry(bool enabled = true);
 
    /// Apply @a control to this vehicle.
    void ApplyControl(const Control &control);
 
    /// Apply @a control to this vehicle.
    void ApplyAckermannControl(const AckermannControl &control);
 
    /// Return the last Ackermann controller settings applied to this vehicle.
    ///
    /// @warning This function does call the simulator.
    rpc::AckermannControllerSettings GetAckermannControllerSettings() const;
 
    /// Apply Ackermann control settings to this vehicle
    void ApplyAckermannControllerSettings(const rpc::AckermannControllerSettings &settings);
 
    /// Apply physics control to this vehicle.
    void ApplyPhysicsControl(const PhysicsControl &physics_control);
 
    /// Open a door in this vehicle
    void OpenDoor(const VehicleDoor door_idx);
 
    /// Close a door in this vehicle
    void CloseDoor(const VehicleDoor door_idx);
 
    /// Sets a @a LightState to this vehicle.
    void SetLightState(const LightState &light_state);
 
    /// Sets a @a Rotation to a wheel of the vehicle (affects the bone of the car skeleton, not the physics)
    void SetWheelSteerDirection(WheelLocation wheel_location, float angle_in_deg);
 
    /// Return a @a Rotation from a wheel of the vehicle
    ///
    /// @note The function returns the rotation of the vehicle based on the it's physics
    float GetWheelSteerAngle(WheelLocation wheel_location);
 
    /// Sets the spin angle of a wheel, in degrees (affects the bone of the car skeleton, not the physics)
    void SetWheelPitchAngle(WheelLocation wheel_location, float angle_in_deg);
 
    /// Return the spin angle of a wheel, in degrees
    float GetWheelPitchAngle(WheelLocation wheel_location);
 
    /// Sets the suspension compression of a wheel, in meters (affects the bone of the car skeleton, not the physics)
    void SetWheelSuspensionOffset(WheelLocation wheel_location, float offset);
 
    /// Return the suspension compression of a wheel, in meters
    float GetWheelSuspensionOffset(WheelLocation wheel_location);
 
    /// Enables or disables the wheel animation override, in which the wheels
    /// show only the values set through the wheel setters (affects the bones
    /// of the car skeleton, not the physics)
    void SetWheelAnimationOverride(bool enabled);
 
    /// Return the control last applied to this vehicle.
    ///
    /// @note This function does not call the simulator, it returns the data
    /// received in the last tick.
    Control GetControl() const;
 
    /// Return the physics control last applied to this vehicle.
    ///
    /// @warning This function does call the simulator.
    PhysicsControl GetPhysicsControl() const;
 
    /// Return the runtime telemetry of this vehicle: forward speed, last
    /// applied control inputs, engine RPM, current gear, and per-wheel
    /// lateral slip, longitudinal slip, and angular velocity sourced from
    /// the Chaos vehicle physics state.
    ///
    /// @warning This function does call the simulator.
    TelemetryData GetTelemetryData() const;
 
    /// Return the current open lights (LightState) of this vehicle.
    ///
    /// @note This function does not call the simulator, it returns the data
    /// received in the last tick.
    LightState GetLightState() const;
 
    /// Return the speed limit currently affecting this vehicle.
    ///
    /// @note This function does not call the simulator, it returns the data
    /// received in the last tick.
    float GetSpeedLimit() const;
 
    std::vector<geom::Transform> GetVehicleBoneWorldTransforms() const;
 
    /// Return the state of the traffic light currently affecting this vehicle.
    ///
    /// @return Green If no traffic light is affecting the vehicle.
    ///
    /// @note This function does not call the simulator, it returns the data
    /// received in the last tick.
    rpc::TrafficLightState GetTrafficLightState() const;
 
    /// Return whether a traffic light is affecting this vehicle.
    ///
    /// @note This function does not call the simulator, it returns the data
    /// received in the last tick.
    bool IsAtTrafficLight();
 
    /// Retrieve the traffic light actor currently affecting this vehicle.
    SharedPtr<TrafficLight> GetTrafficLight() const;
 
    /// Enables CarSim simulation if it is availiable
    void EnableCarSim(std::string simfile_path);
 
    /// Enables the use of CarSim internal road definition instead of unreal's
    void UseCarSimRoad(bool enabled);
 
    void EnableChronoPhysics(
        uint64_t MaxSubsteps,
        float MaxSubstepDeltaTime,
        std::string VehicleJSON = "",
        std::string PowertrainJSON = "",
        std::string TireJSON = "",
        std::string BaseJSONPath = "");
 
    /// Returns the failure state of the vehicle
    rpc::VehicleFailureState GetFailureState() const;
 
  private:
 
    const bool _is_control_sticky;
 
    Control _control;
  };
 
} // namespace client
} // namespace carla