Space Engineers
Classes | Public Member Functions | Protected Member Functions | Protected Attributes | Properties | List of all members
Sandbox.Game.Entities.MyHandToolBase Class Reference
Inheritance diagram for Sandbox.Game.Entities.MyHandToolBase:
VRage.Game.Entity.MyEntity Sandbox.Game.Entities.IMyHandheldGunObject< MyToolBase > Sandbox.Game.Entities.IStoppableAttackingTool VRage.ModAPI.IMyEntity VRage.Game.ModAPI.Ingame.IMyEntity

Classes

class  MyBlockingBody
 

Public Member Functions

 MyHandToolBase ()
 
override void Init (MyObjectBuilder_EntityBase objectBuilder)
 
override MyObjectBuilder_EntityBase GetObjectBuilder (bool copy=false)
 Gets object builder from object. More...
 
virtual bool CanShoot (MyShootActionEnum action, long shooter, out MyGunStatusEnum status)
 
virtual void Shoot (MyShootActionEnum shootAction, VRageMath.Vector3 direction, Vector3D?overrideWeaponPos, string gunAction)
 
virtual void OnControlAcquired (Sandbox.Game.Entities.Character.MyCharacter owner)
 
virtual void OnControlReleased ()
 
override void UpdateAfterSimulation ()
 
override void UpdateAfterSimulation10 ()
 
void DrawHud (IMyCameraController camera, long playerId)
 
VRageMath.Vector3 DirectionToTarget (VRageMath.Vector3D target)
 
virtual void EndShoot (MyShootActionEnum action)
 
void BeginFailReaction (MyShootActionEnum action, MyGunStatusEnum status)
 
void BeginFailReactionLocal (MyShootActionEnum action, MyGunStatusEnum status)
 
void ShootFailReactionLocal (MyShootActionEnum action, MyGunStatusEnum status)
 
int GetAmmunitionAmount ()
 
void StopShooting (MyEntity attacker)
 
void UpdateSoundEmitter ()
 
- Public Member Functions inherited from VRage.Game.Entity.MyEntity
void DebugDraw ()
 
void DebugDrawInvalidTriangles ()
 
void AddDebugRenderComponent (MyDebugRenderComponentBase render)
 
void ClearDebugRenderComponents ()
 
MyEntity GetTopMostParent (Type type=null)
 Return top most parent of this entity More...
 
virtual List< MyHudEntityParamsGetHudParams (bool allowBlink)
 
 MyEntity ()
 
 MyEntity (bool initComponents=true)
 Initializes a new instance of the MyEntity class. More...
 
void CreateSync ()
 
MyEntitySubpart GetSubpart (string name)
 
bool TryGetSubpart (string name, out MyEntitySubpart subpart)
 
virtual void UpdateOnceBeforeFrame ()
 
virtual void UpdateBeforeSimulation ()
 
virtual void UpdatingStopped ()
 
virtual void UpdateBeforeSimulation10 ()
 Called each 10th frame if registered for update10 More...
 
virtual void UpdateBeforeSimulation100 ()
 Called each 100th frame if registered for update100 More...
 
virtual void UpdateAfterSimulation100 ()
 
virtual string GetFriendlyName ()
 
virtual MatrixD GetViewMatrix ()
 
void SetSpeedsAccordingToServerValues ()
 
virtual void SetWorldMatrix (MatrixD worldMatrix, bool forceUpdate=false, bool updateChildren=true)
 
virtual void DebugDrawPhysics ()
 Draw physical representation of entity More...
 
virtual bool GetIntersectionWithLine (ref LineD line, out Vector3D?v, bool useCollisionModel=true, IntersectionFlags flags=IntersectionFlags.ALL_TRIANGLES)
 
virtual bool GetIntersectionWithLine (ref LineD line, out VRage.Game.Models.MyIntersectionResultLineTriangleEx?t, IntersectionFlags flags=IntersectionFlags.ALL_TRIANGLES)
 
virtual Vector3D GetIntersectionWithLineAndBoundingSphere (ref LineD line, float boundingSphereRadiusMultiplier)
 
virtual bool GetIntersectionWithSphere (ref BoundingSphereD sphere)
 
void GetTrianglesIntersectingSphere (ref BoundingSphereD sphere, Vector3?referenceNormalVector, float?maxAngle, List< MyTriangle_Vertex_Normals > retTriangles, int maxNeighbourTriangles)
 
virtual bool DoOverlapSphereTest (float sphereRadius, Vector3D spherePos)
 
double GetSmallestDistanceBetweenCameraAndBoundingSphere ()
 
double GetLargestDistanceBetweenCameraAndBoundingSphere ()
 
double GetDistanceBetweenCameraAndBoundingSphere ()
 
double GetDistanceBetweenPlayerPositionAndBoundingSphere ()
 
double GetDistanceBetweenCameraAndPosition ()
 
virtual MyEntity GetBaseEntity ()
 
virtual void OnAddedToScene (object source)
 Called when [activated] which for entity means that was added to scene. More...
 
virtual void OnRemovedFromScene (object source)
 
void AddToGamePruningStructure ()
 
void RemoveFromGamePruningStructure ()
 
void UpdateGamePruningStructure ()
 
void RaisePhysicsChanged ()
 
void HackyComponentInitByMiroPleaseDontUseEver (MyDefinitionId id)
 DONT USE THIS METHOD, EVER! More...
 
virtual void Init (StringBuilder displayName, string model, MyEntity parentObject, float?scale, string modelCollision=null)
 
virtual void RefreshModels (string model, string modelCollision)
 
void Delete ()
 Every object must have this method, but not every phys object must necessarily have something to cleanup More...
 
void Close ()
 This method marks this entity for close which means, that Close will be called after all entities are updated More...
 
virtual void BeforeSave ()
 Called before method GetObjectBuilder, when saving sector More...
 
virtual void PrepareForDraw ()
 Method is called defacto from Update, preparation fo Draw More...
 
virtual void BeforePaste ()
 
virtual void AfterPaste ()
 
void SetEmissiveParts (string emissiveName, Color emissivePartColor, float emissivity)
 Sets the emissive value of a specific emissive material on entity. More...
 
void SetEmissivePartsForSubparts (string emissiveName, Color emissivePartColor, float emissivity)
 Sets the emissive value of a specific emissive material on all entity subparts. More...
 
override string ToString ()
 
virtual MyInventoryBase GetInventoryBase (int index)
 Search for inventory component with maching index. More...
 
MyInventoryBase GetInventoryBase ()
 Simply get the MyInventoryBase component stored in this entity. More...
 
delegate MyObjectBuilder_EntityBase MyEntityFactoryCreateObjectBuilderDelegate (MyEntity entity)
 
delegate MySyncComponentBase CreateDefaultSyncEntityDelegate (MyEntity thisEntity)
 
delegate bool MyWeldingGroupsGroupExistsDelegate (MyEntity entity)
 
virtual void SerializeControls (BitStream stream)
 
virtual void DeserializeControls (BitStream stream, bool outOfOrder)
 
virtual void ApplyLastControls ()
 
- Public Member Functions inherited from VRage.ModAPI.IMyEntity
bool GetIntersectionWithLine (ref LineD line, out VRage.Game.Models.MyIntersectionResultLineTriangleEx?tri, IntersectionFlags flags)
 
void GetTrianglesIntersectingSphere (ref BoundingSphereD sphere, Vector3?referenceNormalVector, float?maxAngle, System.Collections.Generic.List< MyTriangle_Vertex_Normals > retTriangles, int maxNeighbourTriangles)
 

Protected Member Functions

virtual void InitToolComponents ()
 
bool CanHit (IMyHandToolComponent toolComponent, MyCharacterDetectorComponent detectorComponent, ref bool isBlock, out float hitEfficiency)
 
- Protected Member Functions inherited from VRage.Game.Entity.MyEntity
virtual bool CanBeAddedToRender ()
 
virtual MySyncComponentBase OnCreateSync ()
 
virtual void ClampToWorld ()
 
virtual void BeforeDelete ()
 
virtual void Closing ()
 
virtual void OnInventoryComponentAdded (MyInventoryBase inventory)
 
virtual void OnInventoryComponentRemoved (MyInventoryBase inventory)
 

Protected Attributes

Dictionary< string, IMyHandToolComponentm_toolComponents = new Dictionary<string, IMyHandToolComponent>()
 
MyTimeSpan m_lastShot = MyTimeSpan.Zero
 
MyToolItemDefinition m_toolItemDef
 
- Protected Attributes inherited from VRage.Game.Entity.MyEntity
List< MyHudEntityParamsm_hudParams
 
MyModel m_modelCollision
 

Properties

MyObjectBuilder_PhysicalGunObject PhysicalObject [get]
 
new MyPhysicsBody Physics [get, set]
 
bool IsShooting [get]
 
int ShootDirectionUpdateTime [get]
 
bool EnabledInWorldRules [get]
 
float BackkickForcePerSecond [get]
 
float ShakeAmount [get, protected set]
 
MyDefinitionId DefinitionId [get]
 
MyToolBase GunBase [get]
 
virtual bool ForceAnimationInsteadOfIK [get]
 
bool IsBlocking [get]
 
MyPhysicalItemDefinition PhysicalItemDefinition [get]
 
MyCharacter Owner [get]
 
int CurrentAmmunition [get, set]
 
int CurrentMagazineAmmunition [get, set]
 
- Properties inherited from VRage.Game.Entity.MyEntity
MyEntityComponentContainer Components [get]
 
MyPositionComponentBase PositionComp [get, set]
 
MyRenderComponentBase Render [get, set]
 
MyGameLogicComponent GameLogic [get, set]
 
long EntityId [get, set]
 Entity id, can be set by subclasses (for example when using pool...) More...
 
MySyncComponentBase SyncObject [get, protected set]
 
MyModStorageComponentBase Storage [get, set]
 
bool Closed [get, protected set]
 
bool MarkedForClose [get, protected set]
 
virtual float MaxGlassDistSq [get]
 
bool Save [get, set]
 
bool IsPreview [get, set]
 
bool IsReadyForReplication [get, set]
 
MyEntityUpdateEnum NeedsUpdate [get, set]
 
MatrixD WorldMatrix [get, set]
 
MyEntity Parent [get]
 Gets or sets the parent. More...
 
MyHierarchyComponent< MyEntityHierarchy [get, set]
 
MyPhysicsComponentBase Physics [get, set]
 Gets the physic component of the entity. More...
 
bool InvalidateOnMove [get, set]
 
bool SyncFlag [get, set]
 
bool InScene [get, set]
 
virtual bool IsVolumetric [get]
 
virtual Vector3D LocationForHudMarker [get]
 
MyModel Model [get]
 
MyModel ModelCollision [get]
 
string DisplayName [get, set]
 
string DebugName [get]
 
Dictionary< string, MyEntitySubpartSubparts [get]
 
virtual bool IsCCDForProjectiles [get]
 
int InventoryCount [get]
 Iterate through inventories and return their count. More...
 
bool HasInventory [get]
 Returns true if this entity has got at least one inventory. Note that one aggregate inventory can contain zero simple inventories => zero will be returned even if GetInventoryBase() != null. More...
 
virtual String DisplayNameText [get, set]
 Display Name for GUI etc. Override in descendant classes. Usually used to display in terminal or inventory controls. More...
 
EntityFlags Flags [get, set]
 
- Properties inherited from VRage.ModAPI.IMyEntity
MyEntityComponentContainer Components [get]
 
MyPhysicsComponentBase Physics [get, set]
 
MyPositionComponentBase PositionComp [get, set]
 
MyRenderComponentBase Render [get, set]
 
MyEntityComponentBase GameLogic [get, set]
 
MyHierarchyComponentBase Hierarchy [get, set]
 
MySyncComponentBase SyncObject [get]
 
MyModStorageComponentBase Storage [get, set]
 Custom storage for mods. Shared with all mods. More...
 
EntityFlags Flags [get, set]
 
long EntityId [get, set]
 
string Name [get, set]
 
bool MarkedForClose [get]
 
bool Closed [get]
 
bool DebugAsyncLoading [get]
 
bool Save [get, set]
 
MyPersistentEntityFlags2 PersistentFlags [get, set]
 
MyEntityUpdateEnum NeedsUpdate [get, set]
 
IMyEntity Parent [get]
 
Matrix LocalMatrix [get, set]
 
bool NearFlag [get, set]
 
bool CastShadows [get, set]
 
bool FastCastShadowResolve [get, set]
 
bool NeedsResolveCastShadow [get, set]
 
float MaxGlassDistSq [get]
 
bool NeedsDraw [get, set]
 
bool NeedsDrawFromParent [get, set]
 
bool Transparent [get, set]
 
bool ShadowBoxLod [get, set]
 
bool SkipIfTooSmall [get, set]
 
bool Visible [get, set]
 
bool InScene [get, set]
 
bool InvalidateOnMove [get]
 
new VRageMath.MatrixD WorldMatrix [get, set]
 
VRageMath.MatrixD WorldMatrixInvScaled [get]
 
VRageMath.MatrixD WorldMatrixNormalizedInv [get]
 
bool IsVolumetric [get]
 
BoundingBox LocalAABB [get, set]
 
BoundingBox LocalAABBHr [get]
 
BoundingSphere LocalVolume [get, set]
 
Vector3 LocalVolumeOffset [get, set]
 
Vector3 LocationForHudMarker [get]
 
bool IsCCDForProjectiles [get]
 
string DisplayName [get, set]
 
- Properties inherited from VRage.Game.ModAPI.Ingame.IMyEntity
MyEntityComponentContainer Components [get]
 
long EntityId [get]
 
VRageMath.BoundingBoxD WorldAABB [get]
 
VRageMath.BoundingBoxD WorldAABBHr [get]
 
VRageMath.MatrixD WorldMatrix [get]
 
VRageMath.BoundingSphereD WorldVolume [get]
 
VRageMath.BoundingSphereD WorldVolumeHr [get]
 
- Properties inherited from Sandbox.Game.Entities.IMyHandheldGunObject< MyToolBase >
MyObjectBuilder_PhysicalGunObject PhysicalObject [get]
 
MyPhysicalItemDefinition PhysicalItemDefinition [get]
 
bool ForceAnimationInsteadOfIK [get]
 
bool IsBlocking [get]
 
int CurrentAmmunition [get, set]
 
int CurrentMagazineAmmunition [get, set]
 

Additional Inherited Members

- Public Attributes inherited from VRage.Game.Entity.MyEntity
MyDefinitionId DefinitionId = null
 
string Name
 
bool DebugAsyncLoading
 
DebugCreatedBy DebugCreatedBy
 
float m_massChangeForCollisions = 1f
 
Vector3D m_serverPosition = new Vector3D()
 
Quaternion m_serverOrientation = new Quaternion()
 
MatrixD m_serverWorldMatrix = new MatrixD()
 
Vector3 m_serverLinearVelocity
 
Vector3 m_serverAngularVelocity
 
bool m_positionResetFromServer
 
bool SentFromServer
 
int GamePruningProxyId = MyVRageConstants.PRUNING_PROXY_ID_UNITIALIZED
 
int TopMostPruningProxyId = MyVRageConstants.PRUNING_PROXY_ID_UNITIALIZED
 
bool StaticForPruningStructure = false
 
int TargetPruningProxyId = MyVRageConstants.PRUNING_PROXY_ID_UNITIALIZED
 
Dictionary< IMyReplicable, Action > ReadyForReplicationAction = new Dictionary<IMyReplicable, Action>()
 
- Static Public Attributes inherited from VRage.Game.Entity.MyEntity
static Action< MyEntityAddToGamePruningStructureExtCallBack = null
 
static Action< MyEntityRemoveFromGamePruningStructureExtCallBack = null
 
static Action< MyEntityUpdateGamePruningStructureExtCallBack = null
 
static MyEntityFactoryCreateObjectBuilderDelegate MyEntityFactoryCreateObjectBuilderExtCallback = null
 
static CreateDefaultSyncEntityDelegate CreateDefaultSyncEntityExtCallback
 
static Action< MyEntityMyWeldingGroupsAddNodeExtCallback = null
 
static Action< MyEntityMyWeldingGroupsRemoveNodeExtCallback = null
 
static Action< MyEntity, List< MyEntity > > MyWeldingGroupsGetGroupNodesExtCallback = null
 
static MyWeldingGroupsGroupExistsDelegate MyWeldingGroupsGroupExistsExtCallback = null
 
static Action< MyEntityMyProceduralWorldGeneratorTrackEntityExtCallback = null
 
static Action< MyEntityCreateStandardRenderComponentsExtCallback = null
 
static Action< MyComponentContainer, MyObjectBuilderType, MyStringHash, MyObjectBuilder_ComponentContainerInitComponentsExtCallback = null
 
static Func< MyObjectBuilder_EntityBase, bool, MyEntityMyEntitiesCreateFromObjectBuilderExtCallback = null
 
- Static Protected Member Functions inherited from VRage.Game.Entity.MyEntity
static void UpdateNamedEmissiveParts (uint renderObjectId, string emissiveName, Color emissivePartColor, float emissivity)
 
- Events inherited from VRage.Game.Entity.MyEntity
Action< MyEntityOnMarkForClose
 This event may not be invoked at all, when calling MyEntities.CloseAll, marking is bypassed More...
 
Action< MyEntityOnClose
 
Action< MyEntityOnClosing
 
Action< MyEntityOnPhysicsChanged
 
- Events inherited from VRage.ModAPI.IMyEntity
Action< IMyEntityOnClose
 
Action< IMyEntityOnClosing
 
Action< IMyEntityOnMarkForClose
 
Action< IMyEntityOnPhysicsChanged
 

Detailed Description

Definition at line 41 of file MyHandToolBase.cs.

Constructor & Destructor Documentation

Sandbox.Game.Entities.MyHandToolBase.MyHandToolBase ( )
inline

Definition at line 191 of file MyHandToolBase.cs.

Member Function Documentation

void Sandbox.Game.Entities.MyHandToolBase.BeginFailReaction ( MyShootActionEnum  action,
MyGunStatusEnum  status 
)
inline

Definition at line 784 of file MyHandToolBase.cs.

void Sandbox.Game.Entities.MyHandToolBase.BeginFailReactionLocal ( MyShootActionEnum  action,
MyGunStatusEnum  status 
)
inline

Definition at line 786 of file MyHandToolBase.cs.

bool Sandbox.Game.Entities.MyHandToolBase.CanHit ( IMyHandToolComponent  toolComponent,
MyCharacterDetectorComponent  detectorComponent,
ref bool  isBlock,
out float  hitEfficiency 
)
inlineprotected

Definition at line 554 of file MyHandToolBase.cs.

virtual bool Sandbox.Game.Entities.MyHandToolBase.CanShoot ( MyShootActionEnum  action,
long  shooter,
out MyGunStatusEnum  status 
)
inlinevirtual

Definition at line 268 of file MyHandToolBase.cs.

VRageMath.Vector3 Sandbox.Game.Entities.MyHandToolBase.DirectionToTarget ( VRageMath.Vector3D  target)
inline

Definition at line 770 of file MyHandToolBase.cs.

void Sandbox.Game.Entities.MyHandToolBase.DrawHud ( IMyCameraController  camera,
long  playerId 
)
inline

Definition at line 734 of file MyHandToolBase.cs.

virtual void Sandbox.Game.Entities.MyHandToolBase.EndShoot ( MyShootActionEnum  action)
inlinevirtual

Definition at line 775 of file MyHandToolBase.cs.

int Sandbox.Game.Entities.MyHandToolBase.GetAmmunitionAmount ( )
inline

Definition at line 790 of file MyHandToolBase.cs.

override MyObjectBuilder_EntityBase Sandbox.Game.Entities.MyHandToolBase.GetObjectBuilder ( bool  copy = false)
inlinevirtual

Gets object builder from object.

Returns

Reimplemented from VRage.Game.Entity.MyEntity.

Definition at line 230 of file MyHandToolBase.cs.

override void Sandbox.Game.Entities.MyHandToolBase.Init ( MyObjectBuilder_EntityBase  objectBuilder)
inlinevirtual

Reimplemented from VRage.Game.Entity.MyEntity.

Definition at line 197 of file MyHandToolBase.cs.

virtual void Sandbox.Game.Entities.MyHandToolBase.InitToolComponents ( )
inlineprotectedvirtual

Definition at line 226 of file MyHandToolBase.cs.

virtual void Sandbox.Game.Entities.MyHandToolBase.OnControlAcquired ( Sandbox.Game.Entities.Character.MyCharacter  owner)
inlinevirtual

Definition at line 390 of file MyHandToolBase.cs.

virtual void Sandbox.Game.Entities.MyHandToolBase.OnControlReleased ( )
inlinevirtual

Definition at line 408 of file MyHandToolBase.cs.

virtual void Sandbox.Game.Entities.MyHandToolBase.Shoot ( MyShootActionEnum  shootAction,
VRageMath.Vector3  direction,
Vector3D overrideWeaponPos,
string  gunAction 
)
inlinevirtual

Definition at line 288 of file MyHandToolBase.cs.

void Sandbox.Game.Entities.MyHandToolBase.ShootFailReactionLocal ( MyShootActionEnum  action,
MyGunStatusEnum  status 
)
inline

Definition at line 788 of file MyHandToolBase.cs.

void Sandbox.Game.Entities.MyHandToolBase.StopShooting ( MyEntity  attacker)
inline

Implements Sandbox.Game.Entities.IStoppableAttackingTool.

Definition at line 797 of file MyHandToolBase.cs.

override void Sandbox.Game.Entities.MyHandToolBase.UpdateAfterSimulation ( )
inlinevirtual

Reimplemented from VRage.Game.Entity.MyEntity.

Definition at line 425 of file MyHandToolBase.cs.

override void Sandbox.Game.Entities.MyHandToolBase.UpdateAfterSimulation10 ( )
inlinevirtual

Reimplemented from VRage.Game.Entity.MyEntity.

Definition at line 623 of file MyHandToolBase.cs.

void Sandbox.Game.Entities.MyHandToolBase.UpdateSoundEmitter ( )
inline

Definition at line 853 of file MyHandToolBase.cs.

Member Data Documentation

MyTimeSpan Sandbox.Game.Entities.MyHandToolBase.m_lastShot = MyTimeSpan.Zero
protected

Definition at line 103 of file MyHandToolBase.cs.

Dictionary<string, IMyHandToolComponent> Sandbox.Game.Entities.MyHandToolBase.m_toolComponents = new Dictionary<string, IMyHandToolComponent>()
protected

Definition at line 101 of file MyHandToolBase.cs.

MyToolItemDefinition Sandbox.Game.Entities.MyHandToolBase.m_toolItemDef
protected

Definition at line 109 of file MyHandToolBase.cs.

Property Documentation

float Sandbox.Game.Entities.MyHandToolBase.BackkickForcePerSecond
get

Definition at line 153 of file MyHandToolBase.cs.

int Sandbox.Game.Entities.MyHandToolBase.CurrentAmmunition
getset

Definition at line 850 of file MyHandToolBase.cs.

int Sandbox.Game.Entities.MyHandToolBase.CurrentMagazineAmmunition
getset

Definition at line 851 of file MyHandToolBase.cs.

MyDefinitionId Sandbox.Game.Entities.MyHandToolBase.DefinitionId
get

Definition at line 164 of file MyHandToolBase.cs.

bool Sandbox.Game.Entities.MyHandToolBase.EnabledInWorldRules
get

Definition at line 148 of file MyHandToolBase.cs.

virtual bool Sandbox.Game.Entities.MyHandToolBase.ForceAnimationInsteadOfIK
get

Definition at line 170 of file MyHandToolBase.cs.

MyToolBase Sandbox.Game.Entities.MyHandToolBase.GunBase
get

Definition at line 168 of file MyHandToolBase.cs.

bool Sandbox.Game.Entities.MyHandToolBase.IsBlocking
get

Definition at line 171 of file MyHandToolBase.cs.

bool Sandbox.Game.Entities.MyHandToolBase.IsShooting
get

Definition at line 131 of file MyHandToolBase.cs.

MyCharacter Sandbox.Game.Entities.MyHandToolBase.Owner
get

Definition at line 180 of file MyHandToolBase.cs.

MyPhysicalItemDefinition Sandbox.Game.Entities.MyHandToolBase.PhysicalItemDefinition
get

Definition at line 175 of file MyHandToolBase.cs.

MyObjectBuilder_PhysicalGunObject Sandbox.Game.Entities.MyHandToolBase.PhysicalObject
get

Definition at line 122 of file MyHandToolBase.cs.

new MyPhysicsBody Sandbox.Game.Entities.MyHandToolBase.Physics
getset

Definition at line 125 of file MyHandToolBase.cs.

float Sandbox.Game.Entities.MyHandToolBase.ShakeAmount
getprotected set

Definition at line 158 of file MyHandToolBase.cs.

int Sandbox.Game.Entities.MyHandToolBase.ShootDirectionUpdateTime
get

Definition at line 143 of file MyHandToolBase.cs.


The documentation for this class was generated from the following file: