hodasemi/rfactor_sm_reader
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Wiki Activity Actions
rfactor_sm_reader/rfactor_plugin/InternalsPlugin.hpp

750 lines
40 KiB
C++
Raw Blame History

//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
//<2F> <20>
//<2F> Module: Header file for internals plugin <20>
//<2F> <20>
//<2F> Description: Interface declarations for internals plugin <20>
//<2F> <20>
//<2F> This source code module, and all information, data, and algorithms <20>
//<2F> associated with it, are part of isiMotor Technology (tm). <20>
//<2F> PROPRIETARY AND CONFIDENTIAL <20>
//<2F> Copyright (c) 1996-2015 Image Space Incorporated. All rights reserved. <20>
//<2F> <20>
//<2F> Change history: <20>
//<2F> tag.2005.11.29: created <20>
//<2F> <20>
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
#ifndef _INTERNALS_PLUGIN_HPP_
#define _INTERNALS_PLUGIN_HPP_
#include "PluginObjects.hpp" // base class for plugin objects to derive from
#include <cmath> // for sqrt()
// rF and plugins must agree on structure packing, so set it explicitly here ... whatever the current
// packing is will be restored at the end of this include with another #pragma.
#pragma pack( push, 4 )
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ
//<2F> Version01 Structures <20>
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
struct TelemVect3
{
double x, y, z;
void Set( const double a, const double b, const double c ) { x = a; y = b; z = c; }
// Allowed to reference as [0], [1], or [2], instead of .x, .y, or .z, respectively
double &operator[]( int i ) { return( ( &x )[ i ] ); }
const double &operator[]( int i ) const { return( ( &x )[ i ] ); }
};
struct TelemQuat
{
double w, x, y, z;
// Convert this quaternion to a matrix
void ConvertQuatToMat( TelemVect3 ori[3] ) const
{
const double x2 = x + x;
const double xx = x * x2;
const double y2 = y + y;
const double yy = y * y2;
const double z2 = z + z;
const double zz = z * z2;
const double xz = x * z2;
const double xy = x * y2;
const double wy = w * y2;
const double wx = w * x2;
const double wz = w * z2;
const double yz = y * z2;
ori[0][0] = (double) 1.0 - ( yy + zz );
ori[0][1] = xy - wz;
ori[0][2] = xz + wy;
ori[1][0] = xy + wz;
ori[1][1] = (double) 1.0 - ( xx + zz );
ori[1][2] = yz - wx;
ori[2][0] = xz - wy;
ori[2][1] = yz + wx;
ori[2][2] = (double) 1.0 - ( xx + yy );
}
// Convert a matrix to this quaternion
void ConvertMatToQuat( const TelemVect3 ori[3] )
{
const double trace = ori[0][0] + ori[1][1] + ori[2][2] + (double) 1.0;
if( trace > 0.0625f )
{
const double sqrtTrace = sqrt( trace );
const double s = (double) 0.5 / sqrtTrace;
w = (double) 0.5 * sqrtTrace;
x = ( ori[2][1] - ori[1][2] ) * s;
y = ( ori[0][2] - ori[2][0] ) * s;
z = ( ori[1][0] - ori[0][1] ) * s;
}
else if( ( ori[0][0] > ori[1][1] ) && ( ori[0][0] > ori[2][2] ) )
{
const double sqrtTrace = sqrt( (double) 1.0 + ori[0][0] - ori[1][1] - ori[2][2] );
const double s = (double) 0.5 / sqrtTrace;
w = ( ori[2][1] - ori[1][2] ) * s;
x = (double) 0.5 * sqrtTrace;
y = ( ori[0][1] + ori[1][0] ) * s;
z = ( ori[0][2] + ori[2][0] ) * s;
}
else if( ori[1][1] > ori[2][2] )
{
const double sqrtTrace = sqrt( (double) 1.0 + ori[1][1] - ori[0][0] - ori[2][2] );
const double s = (double) 0.5 / sqrtTrace;
w = ( ori[0][2] - ori[2][0] ) * s;
x = ( ori[0][1] + ori[1][0] ) * s;
y = (double) 0.5 * sqrtTrace;
z = ( ori[1][2] + ori[2][1] ) * s;
}
else
{
const double sqrtTrace = sqrt( (double) 1.0 + ori[2][2] - ori[0][0] - ori[1][1] );
const double s = (double) 0.5 / sqrtTrace;
w = ( ori[1][0] - ori[0][1] ) * s;
x = ( ori[0][2] + ori[2][0] ) * s;
y = ( ori[1][2] + ori[2][1] ) * s;
z = (double) 0.5 * sqrtTrace;
}
}
};
struct TelemWheelV01
{
double mSuspensionDeflection; // meters
double mRideHeight; // meters
double mSuspForce; // pushrod load in Newtons
double mBrakeTemp; // Celsius
double mBrakePressure; // currently 0.0-1.0, depending on driver input and brake balance; will convert to true brake pressure (kPa) in future
double mRotation; // radians/sec
double mLateralPatchVel; // lateral velocity at contact patch
double mLongitudinalPatchVel; // longitudinal velocity at contact patch
double mLateralGroundVel; // lateral velocity at contact patch
double mLongitudinalGroundVel; // longitudinal velocity at contact patch
double mCamber; // radians (positive is left for left-side wheels, right for right-side wheels)
double mLateralForce; // Newtons
double mLongitudinalForce; // Newtons
double mTireLoad; // Newtons
double mGripFract; // an approximation of what fraction of the contact patch is sliding
double mPressure; // kPa (tire pressure)
double mTemperature[3]; // Kelvin (subtract 273.15 to get Celsius), left/center/right (not to be confused with inside/center/outside!)
double mWear; // wear (0.0-1.0, fraction of maximum) ... this is not necessarily proportional with grip loss
char mTerrainName[16]; // the material prefixes from the TDF file
unsigned char mSurfaceType; // 0=dry, 1=wet, 2=grass, 3=dirt, 4=gravel, 5=rumblestrip, 6=special
char mFlat; // whether tire is flat
char mDetached; // whether wheel is detached
double mVerticalTireDeflection;// how much is tire deflected from its (speed-sensitive) radius
double mWheelYLocation; // wheel's y location relative to vehicle y location
double mToe; // current toe angle w.r.t. the vehicle
double mTireCarcassTemperature; // rough average of temperature samples from carcass (Kelvin)
double mTireInnerLayerTemperature[3]; // rough average of temperature samples from innermost layer of rubber (before carcass) (Kelvin)
unsigned char mExpansion[ 24 ];// for future use
};
// Our world coordinate system is left-handed, with +y pointing up.
// The local vehicle coordinate system is as follows:
// +x points out the left side of the car (from the driver's perspective)
// +y points out the roof
// +z points out the back of the car
// Rotations are as follows:
// +x pitches up
// +y yaws to the right
// +z rolls to the right
// Note that ISO vehicle coordinates (+x forward, +y right, +z upward) are
// right-handed. If you are using that system, be sure to negate any rotation
// or torque data because things rotate in the opposite direction. In other
// words, a -z velocity in rFactor is a +x velocity in ISO, but a -z rotation
// in rFactor is a -x rotation in ISO!!!
struct TelemInfoV01
{
// Time
int mID; // slot ID (note that it can be re-used in multiplayer after someone leaves)
double mDeltaTime; // time since last update (seconds)
double mElapsedTime; // game session time
int mLapNumber; // current lap number
double mLapStartET; // time this lap was started
char mVehicleName[64]; // current vehicle name
char mTrackName[64]; // current track name
// Position and derivatives
TelemVect3 mPos; // world position in meters
TelemVect3 mLocalVel; // velocity (meters/sec) in local vehicle coordinates
TelemVect3 mLocalAccel; // acceleration (meters/sec^2) in local vehicle coordinates
// Orientation and derivatives
TelemVect3 mOri[3]; // rows of orientation matrix (use TelemQuat conversions if desired), also converts local
// vehicle vectors into world X, Y, or Z using dot product of rows 0, 1, or 2 respectively
TelemVect3 mLocalRot; // rotation (radians/sec) in local vehicle coordinates
TelemVect3 mLocalRotAccel; // rotational acceleration (radians/sec^2) in local vehicle coordinates
// Vehicle status
int mGear; // -1=reverse, 0=neutral, 1+=forward gears
double mEngineRPM; // engine RPM
double mEngineWaterTemp; // Celsius
double mEngineOilTemp; // Celsius
double mClutchRPM; // clutch RPM
// Driver input
double mUnfilteredThrottle; // ranges 0.0-1.0
double mUnfilteredBrake; // ranges 0.0-1.0
double mUnfilteredSteering; // ranges -1.0-1.0 (left to right)
double mUnfilteredClutch; // ranges 0.0-1.0
// Filtered input (various adjustments for rev or speed limiting, TC, ABS?, speed sensitive steering, clutch work for semi-automatic shifting, etc.)
double mFilteredThrottle; // ranges 0.0-1.0
double mFilteredBrake; // ranges 0.0-1.0
double mFilteredSteering; // ranges -1.0-1.0 (left to right)
double mFilteredClutch; // ranges 0.0-1.0
// Misc
double mSteeringShaftTorque; // torque around steering shaft (used to be mSteeringArmForce, but that is not necessarily accurate for feedback purposes)
double mFront3rdDeflection; // deflection at front 3rd spring
double mRear3rdDeflection; // deflection at rear 3rd spring
// Aerodynamics
double mFrontWingHeight; // front wing height
double mFrontRideHeight; // front ride height
double mRearRideHeight; // rear ride height
double mDrag; // drag
double mFrontDownforce; // front downforce
double mRearDownforce; // rear downforce
// State/damage info
double mFuel; // amount of fuel (liters)
double mEngineMaxRPM; // rev limit
unsigned char mScheduledStops; // number of scheduled pitstops
char mOverheating; // whether overheating icon is shown
char mDetached; // whether any parts (besides wheels) have been detached
char mHeadlights; // whether headlights are on
unsigned char mDentSeverity[8];// dent severity at 8 locations around the car (0=none, 1=some, 2=more)
double mLastImpactET; // time of last impact
double mLastImpactMagnitude; // magnitude of last impact
TelemVect3 mLastImpactPos; // location of last impact
// Expanded
double mEngineTorque; // current engine torque (including additive torque) (used to be mEngineTq, but there's little reason to abbreviate it)
int mCurrentSector; // the current sector (zero-based) with the pitlane stored in the sign bit (example: entering pits from third sector gives 0x80000002)
unsigned char mSpeedLimiter; // whether speed limiter is on
unsigned char mMaxGears; // maximum forward gears
unsigned char mFrontTireCompoundIndex; // index within brand
unsigned char mRearTireCompoundIndex; // index within brand
double mFuelCapacity; // capacity in liters
unsigned char mFrontFlapActivated; // whether front flap is activated
unsigned char mRearFlapActivated; // whether rear flap is activated
unsigned char mRearFlapLegalStatus; // 0=disallowed, 1=criteria detected but not allowed quite yet, 2=allowed
unsigned char mIgnitionStarter; // 0=off 1=ignition 2=ignition+starter
char mFrontTireCompoundName[18]; // name of front tire compound
char mRearTireCompoundName[18]; // name of rear tire compound
unsigned char mSpeedLimiterAvailable; // whether speed limiter is available
unsigned char mAntiStallActivated; // whether (hard) anti-stall is activated
unsigned char mUnused[2]; //
float mVisualSteeringWheelRange; // the *visual* steering wheel range
double mRearBrakeBias; // fraction of brakes on rear
double mTurboBoostPressure; // current turbo boost pressure if available
float mPhysicsToGraphicsOffset[3]; // offset from static CG to graphical center
float mPhysicalSteeringWheelRange; // the *physical* steering wheel range
// Future use
unsigned char mExpansion[152]; // for future use (note that the slot ID has been moved to mID above)
// keeping this at the end of the structure to make it easier to replace in future versions
TelemWheelV01 mWheel[4]; // wheel info (front left, front right, rear left, rear right)
};
struct CameraControlInfoV01
{
// Cameras
int mID; // slot ID to view
int mCameraType; // see GraphicsInfoV02 comments for values
// Replays (note that these are asynchronous)
char mReplayActive; // This variable is an *input* filled with whether the replay is currently active (as opposed to realtime).
char mReplayUnused; //
unsigned char mReplayCommand; // 0=do nothing, 1=begin, 2=end, 3=rewind, 4=fast backwards, 5=backwards, 6=slow backwards, 7=stop, 8=slow play, 9=play, 10=fast play, 11=fast forward
char mReplaySetTime; // Whether to skip to the following replay time:
float mReplaySeconds; // The replay time in seconds to skip to (note: the current replay maximum ET is passed into this variable in case you need it)
//
unsigned char mExpansion[120]; // for future use (possibly camera name & positions/orientations)
};
struct MessageInfoV01
{
char mText[128]; // message to display
unsigned char mDestination; // 0 = message center, 1 = chat (can be used for multiplayer chat commands)
unsigned char mTranslate; // 0 = do not attempt to translate, 1 = attempt to translate
unsigned char mExpansion[126]; // for future use (possibly what color, what font, and seconds to display)
};
struct VehicleScoringInfoV01
{
int mID; // slot ID (note that it can be re-used in multiplayer after someone leaves)
char mDriverName[32]; // driver name
char mVehicleName[64]; // vehicle name
short mTotalLaps; // laps completed
signed char mSector; // 0=sector3, 1=sector1, 2=sector2 (don't ask why)
signed char mFinishStatus; // 0=none, 1=finished, 2=dnf, 3=dq
double mLapDist; // current distance around track
double mPathLateral; // lateral position with respect to *very approximate* "center" path
double mTrackEdge; // track edge (w.r.t. "center" path) on same side of track as vehicle
double mBestSector1; // best sector 1
double mBestSector2; // best sector 2 (plus sector 1)
double mBestLapTime; // best lap time
double mLastSector1; // last sector 1
double mLastSector2; // last sector 2 (plus sector 1)
double mLastLapTime; // last lap time
double mCurSector1; // current sector 1 if valid
double mCurSector2; // current sector 2 (plus sector 1) if valid
// no current laptime because it instantly becomes "last"
short mNumPitstops; // number of pitstops made
short mNumPenalties; // number of outstanding penalties
char mIsPlayer; // is this the player's vehicle
signed char mControl; // who's in control: -1=nobody (shouldn't get this), 0=local player, 1=local AI, 2=remote, 3=replay (shouldn't get this)
char mInPits; // between pit entrance and pit exit (not always accurate for remote vehicles)
unsigned char mPlace; // 1-based position
char mVehicleClass[32]; // vehicle class
// Dash Indicators
double mTimeBehindNext; // time behind vehicle in next higher place
int mLapsBehindNext; // laps behind vehicle in next higher place
double mTimeBehindLeader; // time behind leader
int mLapsBehindLeader; // laps behind leader
double mLapStartET; // time this lap was started
// Position and derivatives
TelemVect3 mPos; // world position in meters
TelemVect3 mLocalVel; // velocity (meters/sec) in local vehicle coordinates
TelemVect3 mLocalAccel; // acceleration (meters/sec^2) in local vehicle coordinates
// Orientation and derivatives
TelemVect3 mOri[3]; // rows of orientation matrix (use TelemQuat conversions if desired), also converts local
// vehicle vectors into world X, Y, or Z using dot product of rows 0, 1, or 2 respectively
TelemVect3 mLocalRot; // rotation (radians/sec) in local vehicle coordinates
TelemVect3 mLocalRotAccel; // rotational acceleration (radians/sec^2) in local vehicle coordinates
// tag.2012.03.01 - stopped casting some of these so variables now have names and mExpansion has shrunk, overall size and old data locations should be same
unsigned char mHeadlights; // status of headlights
unsigned char mPitState; // 0=none, 1=request, 2=entering, 3=stopped, 4=exiting
unsigned char mServerScored; // whether this vehicle is being scored by server (could be off in qualifying or racing heats)
unsigned char mIndividualPhase;// game phases (described below) plus 9=after formation, 10=under yellow, 11=under blue (not used)
int mQualification; // 1-based, can be -1 when invalid
double mTimeIntoLap; // estimated time into lap
double mEstimatedLapTime; // estimated laptime used for 'time behind' and 'time into lap' (note: this may changed based on vehicle and setup!?)
char mPitGroup[24]; // pit group (same as team name unless pit is shared)
unsigned char mFlag; // primary flag being shown to vehicle (currently only 0=green or 6=blue)
char mUnderYellow; // whether this car has taken a full-course caution flag at the start/finish line
unsigned char mCountLapFlag; // 0 = do not count lap or time, 1 = count lap but not time, 2 = count lap and time
char mInGarageStall; // appears to be within the correct garage stall
unsigned char mUpgradePack[16]; // Coded upgrades
// Future use
// tag.2012.04.06 - SEE ABOVE!
unsigned char mExpansion[60]; // for future use
};
struct ScoringInfoV01
{
char mTrackName[64]; // current track name
int mSession; // current session (0=testday 1-4=practice 5-8=qual 9=warmup 10-13=race)
double mCurrentET; // current time
double mEndET; // ending time
int mMaxLaps; // maximum laps
double mLapDist; // distance around track
char *mResultsStream; // results stream additions since last update (newline-delimited and NULL-terminated)
int mNumVehicles; // current number of vehicles
// Game phases:
// 0 Before session has begun
// 1 Reconnaissance laps (race only)
// 2 Grid walk-through (race only)
// 3 Formation lap (race only)
// 4 Starting-light countdown has begun (race only)
// 5 Green flag
// 6 Full course yellow / safety car
// 7 Session stopped
// 8 Session over
unsigned char mGamePhase;
// Yellow flag states (applies to full-course only)
// -1 Invalid
// 0 None
// 1 Pending
// 2 Pits closed
// 3 Pit lead lap
// 4 Pits open
// 5 Last lap
// 6 Resume
// 7 Race halt (not currently used)
signed char mYellowFlagState;
signed char mSectorFlag[3]; // whether there are any local yellows at the moment in each sector (not sure if sector 0 is first or last, so test)
unsigned char mStartLight; // start light frame (number depends on track)
unsigned char mNumRedLights; // number of red lights in start sequence
char mInRealtime; // in realtime as opposed to at the monitor
char mPlayerName[32]; // player name (including possible multiplayer override)
char mPlrFileName[64]; // may be encoded to be a legal filename
// weather
double mDarkCloud; // cloud darkness? 0.0-1.0
double mRaining; // raining severity 0.0-1.0
double mAmbientTemp; // temperature (Celsius)
double mTrackTemp; // temperature (Celsius)
TelemVect3 mWind; // wind speed
double mMinPathWetness; // minimum wetness on main path 0.0-1.0
double mMaxPathWetness; // maximum wetness on main path 0.0-1.0
// Future use
unsigned char mExpansion[256];
// keeping this at the end of the structure to make it easier to replace in future versions
VehicleScoringInfoV01 *mVehicle; // array of vehicle scoring info's
};
struct CommentaryRequestInfoV01
{
char mName[32]; // one of the event names in the commentary INI file
double mInput1; // first value to pass in (if any)
double mInput2; // first value to pass in (if any)
double mInput3; // first value to pass in (if any)
char mSkipChecks; // ignores commentary detail and random probability of event
// constructor (for noobs, this just helps make sure everything is initialized to something reasonable)
CommentaryRequestInfoV01() { mName[0] = 0; mInput1 = 0.0; mInput2 = 0.0; mInput3 = 0.0; mSkipChecks = false; }
};
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ
//<2F> Version02 Structures <20>
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
struct PhysicsOptionsV01
{
unsigned char mTractionControl; // 0 (off) - 3 (high)
unsigned char mAntiLockBrakes; // 0 (off) - 2 (high)
unsigned char mStabilityControl; // 0 (off) - 2 (high)
unsigned char mAutoShift; // 0 (off), 1 (upshifts), 2 (downshifts), 3 (all)
unsigned char mAutoClutch; // 0 (off), 1 (on)
unsigned char mInvulnerable; // 0 (off), 1 (on)
unsigned char mOppositeLock; // 0 (off), 1 (on)
unsigned char mSteeringHelp; // 0 (off) - 3 (high)
unsigned char mBrakingHelp; // 0 (off) - 2 (high)
unsigned char mSpinRecovery; // 0 (off), 1 (on)
unsigned char mAutoPit; // 0 (off), 1 (on)
unsigned char mAutoLift; // 0 (off), 1 (on)
unsigned char mAutoBlip; // 0 (off), 1 (on)
unsigned char mFuelMult; // fuel multiplier (0x-7x)
unsigned char mTireMult; // tire wear multiplier (0x-7x)
unsigned char mMechFail; // mechanical failure setting; 0 (off), 1 (normal), 2 (timescaled)
unsigned char mAllowPitcrewPush; // 0 (off), 1 (on)
unsigned char mRepeatShifts; // accidental repeat shift prevention (0-5; see PLR file)
unsigned char mHoldClutch; // for auto-shifters at start of race: 0 (off), 1 (on)
unsigned char mAutoReverse; // 0 (off), 1 (on)
unsigned char mAlternateNeutral; // Whether shifting up and down simultaneously equals neutral
// tag.2014.06.09 - yes these are new, but no they don't change the size of the structure nor the address of the other variables in it (because we're just using the existing padding)
unsigned char mAIControl; // Whether player vehicle is currently under AI control
unsigned char mUnused1; //
unsigned char mUnused2; //
float mManualShiftOverrideTime; // time before auto-shifting can resume after recent manual shift
float mAutoShiftOverrideTime; // time before manual shifting can resume after recent auto shift
float mSpeedSensitiveSteering; // 0.0 (off) - 1.0
float mSteerRatioSpeed; // speed (m/s) under which lock gets expanded to full
};
struct EnvironmentInfoV01
{
// TEMPORARY buffers (you should copy them if needed for later use) containing various paths that may be needed. Each of these
// could be relative ("UserData\") or full ("C:\BlahBlah\rFactorProduct\UserData\").
// mPath[ 0 ] points to the UserData directory.
// mPath[ 1 ] points to the CustomPluginOptions.JSON filename.
// mPath[ 2 ] points to the latest results file
// (in the future, we may add paths for the current garage setup, fully upgraded physics files, etc., any other requests?)
const char *mPath[ 16 ];
unsigned char mExpansion[256]; // future use
};
struct CustomControlInfoV01
{
// The name passed through CheckHWControl() will be the mUntranslatedName prepended with an underscore (e.g. "Track Map Toggle" -> "_Track Map Toggle")
char mUntranslatedName[ 64 ]; // name of the control that will show up in UI (but translated if available)
int mRepeat; // 0=registers once per hit, 1=registers once, waits briefly, then starts repeating quickly, 2=registers as int as key is down
unsigned char mExpansion[ 64 ]; // future use
};
struct WeatherControlInfoV01
{
// The current conditions are passed in with the API call. The following ET (Elapsed Time) value should typically be far
// enough in the future that it can be interpolated smoothly, and allow clouds time to roll in before rain starts. In
// other words you probably shouldn't have mCloudiness and mRaining suddenly change from 0.0 to 1.0 and expect that
// to happen in a few seconds without looking crazy.
double mET; // when you want this weather to take effect
// mRaining[1][1] is at the origin (2013.12.19 - and currently the only implemented node), while the others
// are spaced at <trackNodeSize> meters where <trackNodeSize> is the maximum absolute value of a track vertex
// coordinate (and is passed into the API call).
double mRaining[ 3 ][ 3 ]; // rain (0.0-1.0) at different nodes
double mCloudiness; // general cloudiness (0.0=clear to 1.0=dark), will be automatically overridden to help ensure clouds exist over rainy areas
double mAmbientTempK; // ambient temperature (Kelvin)
double mWindMaxSpeed; // maximum speed of wind (ground speed, but it affects how fast the clouds move, too)
char mApplyCloudinessInstantly; // preferably we roll the new clouds in, but you can instantly change them now
char mUnused1; //
char mUnused2; //
char mUnused3; //
unsigned char mExpansion[ 508 ]; // future use (humidity, pressure, air density, etc.)
};
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ
//<2F> Version07 Structures <20>
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
struct CustomVariableV01
{
char mCaption[ 128 ]; // Name of variable. This will be used for storage. In the future, this may also be used in the UI (after attempting to translate).
int mNumSettings; // Number of available settings. The special value 0 should be used for types that have limitless possibilities, which will be treated as a string type.
int mCurrentSetting; // Current setting (also the default setting when returned in GetCustomVariable()). This is zero-based, so: ( 0 <= mCurrentSetting < mNumSettings )
// future expansion
unsigned char mExpansion[ 256 ];
};
struct CustomSettingV01
{
char mName[ 128 ]; // Enumerated name of setting (only used if CustomVariableV01::mNumSettings > 0). This will be stored in the JSON file for informational purposes only. It may also possibly be used in the UI in the future.
};
struct MultiSessionParticipantV01
{
// input only
int mID; // slot ID (if loaded) or -1 (if currently disconnected)
char mDriverName[ 32 ]; // driver name
char mVehicleName[ 64 ]; // vehicle name
unsigned char mUpgradePack[ 16 ]; // coded upgrades
float mBestPracticeTime; // best practice time
int mQualParticipantIndex; // once qualifying begins, this becomes valid and ranks participants according to practice time if possible
float mQualificationTime[ 4 ]; // best qualification time in up to 4 qual sessions
float mFinalRacePlace[ 4 ]; // final race place in up to 4 race sessions
float mFinalRaceTime[ 4 ]; // final race time in up to 4 race sessions
// input/output
char mServerScored; // whether vehicle is allowed to participate in current session
int mGridPosition; // 1-based grid position for current race session (or upcoming race session if it is currently warmup), or -1 if currently disconnected
// int mPitIndex;
// int mGarageIndex;
// future expansion
unsigned char mExpansion[ 128 ];
};
struct MultiSessionRulesV01
{
// input only
int mSession; // current session (0=testday 1-4=practice 5-8=qual 9=warmup 10-13=race)
int mSpecialSlotID; // slot ID of someone who just joined, or -2 requesting to update qual order, or -1 (default/general)
char mTrackType[ 32 ]; // track type from GDB
int mNumParticipants; // number of participants (vehicles)
// input/output
MultiSessionParticipantV01 *mParticipant; // array of partipants (vehicles)
int mNumQualSessions; // number of qualifying sessions configured
int mNumRaceSessions; // number of race sessions configured
int mMaxLaps; // maximum laps allowed in current session (LONG_MAX = unlimited) (note: cannot currently edit in *race* sessions)
int mMaxSeconds; // maximum time allowed in current session (LONG_MAX = unlimited) (note: cannot currently edit in *race* sessions)
char mName[ 32 ]; // untranslated name override for session (please use mixed case here, it should get uppercased if necessary)
// future expansion
unsigned char mExpansion[ 256 ];
};
enum TrackRulesCommandV01 //
{
TRCMD_ADD_FROM_TRACK = 0, // crossed s/f line for first time after full-course yellow was called
TRCMD_ADD_FROM_PIT, // exited pit during full-course yellow
TRCMD_ADD_FROM_UNDQ, // during a full-course yellow, the admin reversed a disqualification
TRCMD_REMOVE_TO_PIT, // entered pit during full-course yellow
TRCMD_REMOVE_TO_DNF, // vehicle DNF'd during full-course yellow
TRCMD_REMOVE_TO_DQ, // vehicle DQ'd during full-course yellow
TRCMD_REMOVE_TO_UNLOADED, // vehicle unloaded (possibly kicked out or banned) during full-course yellow
TRCMD_MOVE_TO_BACK, // misbehavior during full-course yellow, resulting in the penalty of being moved to the back of their current line
TRCMD_LONGEST_LINE, // misbehavior during full-course yellow, resulting in the penalty of being moved to the back of the longest line
//------------------
TRCMD_MAXIMUM // should be last
};
struct TrackRulesActionV01
{
// input only
TrackRulesCommandV01 mCommand; // recommended action
int mID; // slot ID if applicable
double mET; // elapsed time that event occurred, if applicable
};
enum TrackRulesColumnV01
{
TRCOL_LEFT_LANE = 0, // left (inside)
TRCOL_MIDLEFT_LANE, // mid-left
TRCOL_MIDDLE_LANE, // middle
TRCOL_MIDRIGHT_LANE, // mid-right
TRCOL_RIGHT_LANE, // right (outside)
//------------------
TRCOL_MAX_LANES, // should be after the valid static lane choices
//------------------
TRCOL_INVALID = TRCOL_MAX_LANES, // currently invalid (hasn't crossed line or in pits/garage)
TRCOL_FREECHOICE, // free choice (dynamically chosen by driver)
TRCOL_PENDING, // depends on another participant's free choice (dynamically set after another driver chooses)
//------------------
TRCOL_MAXIMUM // should be last
};
struct TrackRulesParticipantV01
{
// input only
int mID; // slot ID
short mFrozenOrder; // 0-based place when caution came out (not valid for formation laps)
short mPlace; // 1-based place (typically used for the initialization of the formation lap track order)
float mYellowSeverity; // a rating of how much this vehicle is contributing to a yellow flag (the sum of all vehicles is compared to TrackRulesV01::mSafetyCarThreshold)
double mCurrentRelativeDistance; // equal to ( ( ScoringInfoV01::mLapDist * this->mRelativeLaps ) + VehicleScoringInfoV01::mLapDist )
// input/output
int mRelativeLaps; // current formation/caution laps relative to safety car (should generally be zero except when safety car crosses s/f line); this can be decremented to implement 'wave around' or 'beneficiary rule' (a.k.a. 'lucky dog' or 'free pass')
TrackRulesColumnV01 mColumnAssignment;// which column (line/lane) that participant is supposed to be in
int mPositionAssignment; // 0-based position within column (line/lane) that participant is supposed to be located at (-1 is invalid)
char mAllowedToPit; // whether the rules allow this particular vehicle to enter pits right now
char mUnused[ 3 ]; //
double mGoalRelativeDistance; // calculated based on where the leader is, and adjusted by the desired column spacing and the column/position assignments
char mMessage[ 96 ]; // a message for this participant to explain what is going on (untranslated; it will get run through translator on client machines)
// future expansion
unsigned char mExpansion[ 192 ];
};
enum TrackRulesStageV01 //
{
TRSTAGE_FORMATION_INIT = 0, // initialization of the formation lap
TRSTAGE_FORMATION_UPDATE, // update of the formation lap
TRSTAGE_NORMAL, // normal (non-yellow) update
TRSTAGE_CAUTION_INIT, // initialization of a full-course yellow
TRSTAGE_CAUTION_UPDATE, // update of a full-course yellow
//------------------
TRSTAGE_MAXIMUM // should be last
};
struct TrackRulesV01
{
// input only
double mCurrentET; // current time
TrackRulesStageV01 mStage; // current stage
TrackRulesColumnV01 mPoleColumn; // column assignment where pole position seems to be located
int mNumActions; // number of recent actions
TrackRulesActionV01 *mAction; // array of recent actions
int mNumParticipants; // number of participants (vehicles)
char mYellowFlagDetected; // whether yellow flag was requested or sum of participant mYellowSeverity's exceeds mSafetyCarThreshold
char mYellowFlagLapsWasOverridden; // whether mYellowFlagLaps (below) is an admin request
char mSafetyCarExists; // whether safety car even exists
char mSafetyCarActive; // whether safety car is active
int mSafetyCarLaps; // number of laps
float mSafetyCarThreshold; // the threshold at which a safety car is called out (compared to the sum of TrackRulesParticipantV01::mYellowSeverity for each vehicle)
double mSafetyCarLapDist; // safety car lap distance
float mSafetyCarLapDistAtStart; // where the safety car starts from
float mPitLaneStartDist; // where the waypoint branch to the pits breaks off (this may not be perfectly accurate)
float mTeleportLapDist; // the front of the teleport locations (a useful first guess as to where to throw the green flag)
// future input expansion
unsigned char mInputExpansion[ 256 ];
// input/output
signed char mYellowFlagState; // see ScoringInfoV01 for values
short mYellowFlagLaps; // suggested number of laps to run under yellow (may be passed in with admin command)
int mSafetyCarInstruction; // 0=no change, 1=go active, 2=head for pits
float mSafetyCarSpeed; // maximum speed at which to drive
float mSafetyCarMinimumSpacing; // minimum spacing behind safety car (-1 to indicate no limit)
float mSafetyCarMaximumSpacing; // maximum spacing behind safety car (-1 to indicate no limit)
float mMinimumColumnSpacing; // minimum desired spacing between vehicles in a column (-1 to indicate indeterminate/unenforced)
float mMaximumColumnSpacing; // maximum desired spacing between vehicles in a column (-1 to indicate indeterminate/unenforced)
float mMinimumSpeed; // minimum speed that anybody should be driving (-1 to indicate no limit)
float mMaximumSpeed; // maximum speed that anybody should be driving (-1 to indicate no limit)
char mMessage[ 96 ]; // a message for everybody to explain what is going on (which will get run through translator on client machines)
TrackRulesParticipantV01 *mParticipant; // array of partipants (vehicles)
// future input/output expansion
unsigned char mInputOutputExpansion[ 256 ];
};
struct PitMenuV01
{
int mCategoryIndex; // index of the current category
char mCategoryName[ 32 ]; // name of the current category (untranslated)
int mChoiceIndex; // index of the current choice (within the current category)
char mChoiceString[ 32 ]; // name of the current choice (may have some translated words)
int mNumChoices; // total number of choices (0 <= mChoiceIndex < mNumChoices)
unsigned char mExpansion[ 256 ]; // for future use
};
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ
//<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
// See #pragma at top of file
#pragma pack( pop )
#endif // _INTERNALS_PLUGIN_HPP_
Reference in a new issue View git blame Copy permalink