Vehicle.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/BorrowedRef.h"
#include "common/ECS.h"
#include "common/Module.h"
#include "common/Result.h"
#include "definitions/Definitions.h"
#include "vehicle/VehicleMobility.h"
#include "vehicle/VehicleTypes.h"
 
#include <string>
#include <vector>
 
namespace eve::weapon {
class WeaponMountEntity;
}
 
namespace eve::physics {
class World;
class World3D;
}  // namespace eve::physics
 
namespace eve::vehicle {
 
class EVENGINE_API_DOMAINS Vehicle : public Module {
public:
    Module_REG(Vehicle);
    Vehicle();
    ~Vehicle() override;
 
    int registerVehiclesFromJson(const std::string& json);
    void clearVehicleDefinitions();
    int getVehicleDefinitionCount();
    bool        hasVehicleDefinition(const std::string& id);
    std::string getVehicleDefinitionMobility(const std::string& id);
    float       getVehicleDefinitionMaxHealth(const std::string& id);
 
    [[nodiscard]] eve::definitions::DefinitionRegistry& definitionRegistry() noexcept { return definitionRegistry_; }
 
    static void registerMobility(IVehicleMobility* mobility);
    static int getMobilityCount();
 
    VehicleEntity* newVehicle(const std::string& defId, float x, float y, float heading = 0.f,
                              const std::string& faction = "");
 
    void moveTo(VehicleEntity* v, float x, float y);
    void attackMove(VehicleEntity* v, float x, float y);
    void attack(VehicleEntity* v, float x, float y, int targetId = 0);
    void stop(VehicleEntity* v);
    void hold(VehicleEntity* v);
    void clearOrders(VehicleEntity* v);
    int  orderCount(VehicleEntity* v);
    std::string getCurrentOrderType(VehicleEntity* v);
 
    void setInput(VehicleEntity* v, float throttle, float steer, float brake = 0.f, bool handbrake = false);
 
    float       getX(VehicleEntity* v);
    float       getY(VehicleEntity* v);
    float       getHeading(VehicleEntity* v);
    float       getSpeed(VehicleEntity* v);
    void        setPosition(VehicleEntity* v, float x, float y);
    void        setHeading(VehicleEntity* v, float deg);
    bool        isArrived(VehicleEntity* v);
    float       getHealth(VehicleEntity* v);
    void        setHealth(VehicleEntity* v, float hp);
    float       getMaxHealth(VehicleEntity* v);
    std::string getFaction(VehicleEntity* v);
    void        setFaction(VehicleEntity* v, const std::string& faction);
 
    bool        attachPhysics2D(VehicleEntity* v, eve::physics::World* world);
    bool        attachPhysics3D(VehicleEntity* v, eve::physics::World3D* world, float heightY = 1.f);
    bool        detachPhysics(VehicleEntity* v);
    bool        hasPhysics(VehicleEntity* v);
    std::string getPhysicsSpace(VehicleEntity* v);
    float getHeight(VehicleEntity* v);
 
    void applyDamage(VehicleEntity* v, float amount, const std::string& zone = "", int sourceId = 0);
    float getArmorZoneMult(VehicleEntity* v, const std::string& zone);
    bool isDestroyed(VehicleEntity* v);
 
    int         getSeatCount(VehicleEntity* v);
    std::string getSeatName(VehicleEntity* v, int seatIndex);
    std::string getSeatCameraMode(VehicleEntity* v, int seatIndex);
    bool        isSeatOccupied(VehicleEntity* v, int seatIndex);
    int         getSeatOccupant(VehicleEntity* v, int seatIndex);
    eve::weapon::WeaponMountEntity* getSeatMount(VehicleEntity* v, int seatIndex);
    bool                            enterSeat(VehicleEntity* v, int seatIndex, int playerId);
    bool                            exitSeat(VehicleEntity* v, int seatIndex);
    int                             exitSeatByPlayer(VehicleEntity* v, int playerId);
 
    void setPlayerControls(int playerId, float throttle, float steer, float brake, bool fire, float aimYaw,
                           float aimPitch);
 
    int                             getMountCount(VehicleEntity* v);
    eve::weapon::WeaponMountEntity* getMount(VehicleEntity* v, int index);
 
    void update(float dt);
 
    void        clearEvents();
    int         getEventCount() const;
    std::string getEventType(int index) const;
    std::string getEventVehicleId(int index) const;
    std::string getEventDefId(int index) const;
    std::string getEventOrderType(int index) const;
    float       getEventX(int index) const;
    float       getEventY(int index) const;
 
private:
    void                     autoAim(VehicleEntity& v);
    void                     updateSeats(VehicleEntity& v);
    [[nodiscard]] eve::Result<VehicleDefinition> findDef(const std::string& id) const;
 
    eve::definitions::DefinitionRegistry               definitionRegistry_;
    std::vector<ecs::EntityHandle>                     vehicles_;
    std::vector<VehicleEvent>                          events_;
    int                                                nextInstance_ = 1;
};
 
}  // namespace eve::vehicle