player.h

/*
 * See Licensing and Copyright notice in naev.h
 */
#pragma once
 
#include <time.h>
 
#include "nstring.h"
#include "pilot.h"
 
enum {
   PLAYER_TURN_LEFT,    
   PLAYER_TURN_RIGHT,   
   PLAYER_REVERSE,      
   PLAYER_ACCEL,        
   PLAYER_DESTROYED,    
   PLAYER_FACE,         
   PLAYER_PRIMARY,      
   PLAYER_PRIMARY_L,    
   PLAYER_SECONDARY,    
   PLAYER_SECONDARY_L,  
   PLAYER_LANDACK,      
   PLAYER_CREATING,     
   PLAYER_AUTONAV,      
   PLAYER_NOLAND,       
   PLAYER_CINEMATICS,   
   PLAYER_CINEMATICS_GUI,
   PLAYER_CINEMATICS_2X,
   PLAYER_HOOK_LAND,    
   PLAYER_HOOK_JUMPIN,  
   PLAYER_HOOK_HYPER,   
   PLAYER_MFLY,         
   PLAYER_NOSAVE,       
   PLAYER_FLAGS_MAX     
};
 
enum {
   PLAYER_LAND_OK,      
   PLAYER_LAND_AGAIN,   
   PLAYER_LAND_DENIED,  
};
 
typedef char PlayerFlags[ PLAYER_FLAGS_MAX ];
 
/* flag functions */
#define player_isFlag(f)   (player.flags[f])
#define player_setFlag(f)  (player.flags[f] = 1)
#define player_rmFlag(f)   (player.flags[f] = 0)
 
/* Control restoration reasons. */
enum {
   PINPUT_NULL,     
   PINPUT_MOVEMENT, 
   PINPUT_AUTONAV,  
   PINPUT_BRAKING   
};
 
#include "player_autonav.h"
 
typedef struct PlayerOutfit_s {
   const Outfit *o;  
   int q;            
} PlayerOutfit_t;
 
typedef struct PlayerShip_s {
   Pilot *p;      
   PilotWeaponSet weapon_sets[PILOT_WEAPON_SETS]; 
   int autoweap;  
   int favourite; 
   /* Fleet data. */
   int deployed;  
   /* Some meta-data. */
   double time_played;        
   char *acquired;            
   time_t acquired_date;      
   double dmg_done_shield;    
   double dmg_done_armour;    
   double dmg_taken_shield;   
   double dmg_taken_armour;   
   unsigned int ships_destroyed[SHIP_CLASS_TOTAL]; 
   unsigned int jumped_times; 
   unsigned int landed_times; 
   unsigned int death_counter;
} PlayerShip_t;
 
typedef struct Player_s {
   /* Player intrinsics. */
   Pilot *p;         
   PlayerShip_t ps;  
   char *name;       
   /* Player data. */
   PlayerFlags flags;
   int autonav;      
   double mousex;    
   double mousey;    
   double speed;     
   char *chapter;    
   char *difficulty; 
   int discover_off; 
   /* Loaded game version. */
   char *loaded_version;
   /* Options that we save. */
   char *gui;        
   double radar_res; 
   int eq_outfitMode;
   int map_minimal;  
   /* Player fleets. */
   int fleet_used; 
   int fleet_capacity; 
   /* Meta-data. */
   time_t last_played; 
   double time_played; 
   time_t date_created; 
   double dmg_done_shield; 
   double dmg_done_armour; 
   double dmg_taken_shield; 
   double dmg_taken_armour; 
   unsigned int ships_destroyed[SHIP_CLASS_TOTAL]; 
   unsigned int jumped_times; 
   unsigned int landed_times; 
   unsigned int death_counter; 
   /* Meta-meta-data. */
   time_t time_since_save; 
} Player_t;
 
/*
 * Local player.
 */
extern Player_t player; 
/*
 * Common player sounds.
 */
extern int snd_target; 
extern int snd_jump; 
extern int snd_nav; 
extern int snd_hail; 
extern int snd_hypPowUp; 
extern int snd_hypEng; 
extern int snd_hypPowDown; 
extern int snd_hypPowUpJump; 
extern int snd_hypJump; 
/*
 * creation/cleanup
 */
int player_init (void);
void player_new (void);
PlayerShip_t* player_newShip( const Ship* ship, const char *def_name,
      int trade, const char *acquired, int noname );
void player_cleanup (void);
 
/*
 * Hook voodoo.
 */
void player_runHooks (void);
 
/*
 * Rendering.
 */
void player_renderUnderlay( double dt );
void player_render( double dt );
 
/*
 * Message stuff, in gui.c
 */
void player_messageToggle( int enable );
NONNULL( 1 ) PRINTF_FORMAT( 1, 2 ) void player_message( const char *fmt, ... );
NONNULL( 1 ) void player_messageRaw ( const char *str );
 
/*
 * Misc.
 */
void player_resetSpeed (void);
void player_restoreControl( int reason, const char *str );
void player_checkLandAck (void);
void player_nolandMsg( const char *str );
void player_clear (void);
void player_warp( double x, double y );
int player_hasCredits( credits_t amount );
credits_t player_modCredits( credits_t amount );
void player_hailStart (void);
/* Sounds. */
void player_soundPlay( int sound, int once );
void player_soundPlayGUI( int sound, int once );
void player_soundStop (void);
void player_soundPause (void);
void player_soundResume (void);
 
/*
 * Player ships.
 */
int player_ships( char** sships, glTexture** tships );
void player_shipsSort (void);
const PlayerShip_t* player_getShipStack (void);
int player_nships (void);
int player_hasShip( const char *shipname );
Pilot *player_getShip( const char *shipname );
PlayerShip_t* player_getPlayerShip( const char *shipname );
void player_swapShip( const char *shipname, int move_cargo );
credits_t player_shipPrice( const char *shipname, int count_unique );
void player_rmShip( const char *shipname );
void player_rmPlayerShip( PlayerShip_t *ps );
 
/*
 * Player outfits.
 */
int player_outfitOwned( const Outfit *o );
int player_outfitOwnedTotal( const Outfit* o );
const PlayerOutfit_t* player_getOutfits (void);
int player_getOutfitsFiltered( const Outfit ***outfits,
      int(*filter)( const Outfit *o ), const char *name );
int player_numOutfits (void);
int player_addOutfit( const Outfit *o, int quantity );
int player_rmOutfit( const Outfit *o, int quantity );
 
/*
 * Player missions.
 */
void player_missionFinished( int id );
int player_missionAlreadyDone( int id );
int* player_missionsDoneList (void); /* Returns array that should not be freed. */
 
/*
 * Player events.
 */
void player_eventFinished( int id );
int player_eventAlreadyDone( int id );
int* player_eventsDoneList (void); /* Returns array that should not be freed. */
 
/*
 * Licenses.
 */
NONNULL( 1 ) void player_addLicense( const char *license );
int player_hasLicense( const char *license );
const char **player_getLicenses (void);
 
/*
 * Escorts.
 */
int player_addEscorts (void);
 
/*
 * Pilot related stuff.
 */
void player_dead (void);
void player_destroyed (void);
void player_think( Pilot* pplayer, const double dt );
void player_update( Pilot *pplayer, const double dt );
void player_updateSpecific( Pilot *pplayer, const double dt );
void player_brokeHyperspace (void);
void player_hyperspacePreempt( int );
int player_getHypPreempt(void);
double player_dt_default (void);
 
/*
 * Targeting.
 */
/* Clearing. */
void player_targetClear (void);
void player_targetClearAll (void);
/* Spobs. */
void player_targetSpobSet( int id );
void player_targetSpob (void);
/* Asteroids. */
void player_targetAsteroidSet( int id_field, int id );
/* Hyperspace. */
void player_targetHyperspaceSet( int id, int autonavcont );
void player_targetHyperspace (void);
/* Pilots. */
void player_targetSet( unsigned int id );
void player_targetHostile (void);
void player_targetNext( int mode );
void player_targetPrev( int mode );
void player_targetNearest (void);
void player_targetEscort( int prev );
 
/*
 * Keybind actions.
 */
void player_weapSetPress( int id, double value, int repeat );
int player_land( int loud );
void player_approach (void);
int player_jump (void);
void player_screenshot (void);
void player_accel( double acc );
void player_accelOver (void);
void player_hail (void);
void player_hailSpob (void);
void player_autohail (void);
void player_toggleMouseFly (void);
void player_cooldownBrake (void);
void player_stealth (void);