@tlua/gmod 1.0.1

package/physobj.d.tlua

@@ -0,0 +1,799 @@
+// AUTO-GENERATED tlua declarations. Do not edit by hand.
+
+/**
+ * This is the object returned by [Entity:GetPhysicsObject](https://wiki.facepunch.com/gmod/Entity:GetPhysicsObject), [Entity:GetPhysicsObjectNum](https://wiki.facepunch.com/gmod/Entity:GetPhysicsObjectNum) and [Vehicle:GetWheel](https://wiki.facepunch.com/gmod/Vehicle:GetWheel).
+ *
+ * It represents a physics object. An entity can have multiple physics objects (ragdolls), one physics objects (props), or none. (NPCs, non physics entities, etc.)
+ *
+ * Physics objects are usually simulated by the physics engine and usually dictate the position of the entity, and not the other way around.
+ *
+ * @source https://wiki.facepunch.com/gmod/PhysObj
+ */
+interface PhysObj {}
+
+interface PhysObj {
+    /**
+     * Adds the specified [angular velocity](https://en.wikipedia.org/wiki/Angular_velocity) velocity to the current [PhysObj](https://wiki.facepunch.com/gmod/PhysObj).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:AddAngleVelocity
+     */
+    AddAngleVelocity(self: PhysObj, angularVelocity: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Adds one or more bit flags.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:AddGameFlag
+     */
+    AddGameFlag(self: PhysObj, flags: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Adds the specified velocity to the current.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:AddVelocity
+     */
+    AddVelocity(self: PhysObj, velocity: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Rotates the object so that it's angles are aligned to the ones inputted.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:AlignAngles
+     */
+    AlignAngles(self: PhysObj, from: Angle, to: Angle): Angle;
+}
+
+interface PhysObj {
+    /**
+     * Applies the specified impulse in the mass center of the physics object.
+     *
+     * **NOTE**: This will not work on players, use [Entity:SetVelocity](https://wiki.facepunch.com/gmod/Entity:SetVelocity) instead.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:ApplyForceCenter
+     */
+    ApplyForceCenter(self: PhysObj, impulse: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Applies the specified impulse on the physics object at the specified position.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:ApplyForceOffset
+     */
+    ApplyForceOffset(self: PhysObj, impulse: Vector, position: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Applies the specified angular impulse to the physics object. See [PhysObj:CalculateForceOffset](https://wiki.facepunch.com/gmod/PhysObj:CalculateForceOffset)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:ApplyTorqueCenter
+     */
+    ApplyTorqueCenter(self: PhysObj, angularImpulse: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Calculates the linear and angular impulse on the object's center of mass for an offset impulse.The outputs can be used with [PhysObj:ApplyForceCenter](https://wiki.facepunch.com/gmod/PhysObj:ApplyForceCenter) and [PhysObj:ApplyTorqueCenter](https://wiki.facepunch.com/gmod/PhysObj:ApplyTorqueCenter), respectively.
+     *
+     * **Be careful to convert the angular impulse to world frame ([PhysObj:LocalToWorldVector](https://wiki.facepunch.com/gmod/PhysObj:LocalToWorldVector)) if you are going to use it with ApplyTorqueCenter.**
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:CalculateForceOffset
+     */
+    CalculateForceOffset(self: PhysObj, impulse: Vector, position: Vector): (Vector, Vector);
+}
+
+interface PhysObj {
+    /**
+     * Calculates the linear and angular velocities on the center of mass for an offset impulse. The outputs can be directly passed to [PhysObj:AddVelocity](https://wiki.facepunch.com/gmod/PhysObj:AddVelocity) and [PhysObj:AddAngleVelocity](https://wiki.facepunch.com/gmod/PhysObj:AddAngleVelocity), respectively.
+     *
+     * **WARNING**: This will return zero length vectors if the physics object's motion is disabled. See [PhysObj:IsMotionEnabled](https://wiki.facepunch.com/gmod/PhysObj:IsMotionEnabled).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:CalculateVelocityOffset
+     */
+    CalculateVelocityOffset(self: PhysObj, impulse: Vector, position: Vector): (Vector, Vector);
+}
+
+interface PhysObj {
+    /**
+     * Removes one of more specified flags.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:ClearGameFlag
+     */
+    ClearGameFlag(self: PhysObj, flags: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Allows you to move a PhysObj to a point and angle in 3D space. Works with any PhysObj, not just physics shadows.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:ComputeShadowControl
+     */
+    ComputeShadowControl(self: PhysObj, shadowparams: ShadowControlParams): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets whether the physics object should collide with anything or not, including world.
+     *
+     * **WARNING**: This function currently has major problems with player collisions, and as such should be avoided at all costs.
+     *
+     *
+     *
+     * A better alternative to this function would be using [Entity:SetCollisionGroup](https://wiki.facepunch.com/gmod/Entity:SetCollisionGroup)( COLLISION_GROUP_WORLD ).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:EnableCollisions
+     */
+    EnableCollisions(self: PhysObj, enable: boolean): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets whenever the physics object should be affected by drag.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:EnableDrag
+     */
+    EnableDrag(self: PhysObj, enable: boolean): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets whether the PhysObject should be affected by gravity
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:EnableGravity
+     */
+    EnableGravity(self: PhysObj, enable: boolean): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets whether the physobject should be able to move or not.
+     *
+     * This is the exact method the Physics Gun uses to freeze props. If a motion-disabled physics object is grabbed with the physics gun, the object will be able to move again. To disallow this, use [GM:PhysgunPickup](https://wiki.facepunch.com/gmod/GM:PhysgunPickup).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:EnableMotion
+     */
+    EnableMotion(self: PhysObj, enable: boolean): void;
+}
+
+interface PhysObj {
+    /**
+     * Returns the mins and max of the physics object Axis-Aligned Bounding Box.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetAABB
+     */
+    GetAABB(self: PhysObj): (Vector | nil, Vector);
+}
+
+interface PhysObj {
+    /**
+     * Gets the angular velocity of the object in degrees per second as a local vector. You can use dot product to read the magnitude from a specific axis.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetAngleVelocity
+     */
+    GetAngleVelocity(self: PhysObj): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns the angles of the physics object in degrees.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetAngles
+     */
+    GetAngles(self: PhysObj): Angle;
+}
+
+interface PhysObj {
+    /**
+     * Returns the buoyancy ratio of the physics object. (How well it floats in water).
+     *
+     * **NOTE**: This feature is not available on x86-64 beta and on MacOS version of the game.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetBuoyancyRatio
+     */
+    GetBuoyancyRatio(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the contents flag of the [PhysObj](https://wiki.facepunch.com/gmod/PhysObj).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetContents
+     */
+    GetContents(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the linear and angular damping of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetDamping
+     */
+    GetDamping(self: PhysObj): (number, number);
+}
+
+interface PhysObj {
+    /**
+     * Returns the sum of the linear and rotational kinetic energies of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetEnergy
+     */
+    GetEnergy(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the parent entity of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetEntity
+     */
+    GetEntity(self: PhysObj): Entity;
+}
+
+interface PhysObj {
+    /**
+     * Returns the friction snapshot of this physics object. This is useful for determining if an object touching ground for example.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetFrictionSnapshot
+     */
+    GetFrictionSnapshot(self: PhysObj): table;
+}
+
+interface PhysObj {
+    /**
+     * Returns the index this physics object is on its [PhysObj:GetEntity](https://wiki.facepunch.com/gmod/PhysObj:GetEntity).
+     *
+     * Useful for [Entity:TranslateBoneToPhysBone](https://wiki.facepunch.com/gmod/Entity:TranslateBoneToPhysBone).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetIndex
+     */
+    GetIndex(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the principal moments of inertia `(Ixx, Iyy, Izz)` of the physics object, in the local frame, with respect to the center of mass.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetInertia
+     */
+    GetInertia(self: PhysObj): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns 1 divided by the angular inertia. See [PhysObj:GetInertia](https://wiki.facepunch.com/gmod/PhysObj:GetInertia)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetInvInertia
+     */
+    GetInvInertia(self: PhysObj): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns 1 divided by the physics object's mass (in kilograms).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetInvMass
+     */
+    GetInvMass(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the mass of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetMass
+     */
+    GetMass(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the center of mass of the physics object as a local vector.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetMassCenter
+     */
+    GetMassCenter(self: PhysObj): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns the [physical material](https://developer.valvesoftware.com/wiki/Material_surface_properties) ($surfaceprop) of the physics object.
+     *
+     * See [util.GetSurfaceData](https://wiki.facepunch.com/gmod/util.GetSurfaceData) for a function that adds these types as well as further explanation of what they are.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetMaterial
+     */
+    GetMaterial(self: PhysObj): string;
+}
+
+interface PhysObj {
+    /**
+     * Returns the physics mesh of the object which is used for physobj-on-physobj collision.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetMesh
+     */
+    GetMesh(self: PhysObj): table;
+}
+
+interface PhysObj {
+    /**
+     * Returns all convex physics meshes of the object. See [Entity:PhysicsInitMultiConvex](https://wiki.facepunch.com/gmod/Entity:PhysicsInitMultiConvex) for more information.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetMeshConvexes
+     */
+    GetMeshConvexes(self: PhysObj): table;
+}
+
+interface PhysObj {
+    /**
+     * Returns the name of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetName
+     */
+    GetName(self: PhysObj): string;
+}
+
+interface PhysObj {
+    /**
+     * Returns the position of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetPos
+     */
+    GetPos(self: PhysObj): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns the position and angle of the physics object as a 3x4 matrix ([VMatrix](https://wiki.facepunch.com/gmod/VMatrix) is 4x4 so the fourth row goes unused). The first three columns store the angle as a [rotation matrix](https://en.wikipedia.org/wiki/Rotation_matrix), and the fourth column stores the position vector.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetPositionMatrix
+     */
+    GetPositionMatrix(self: PhysObj): VMatrix;
+}
+
+interface PhysObj {
+    /**
+     * Returns the rotation damping of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetRotDamping
+     */
+    GetRotDamping(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the angles of the [PhysObj](https://wiki.facepunch.com/gmod/PhysObj) shadow. See [PhysObj:UpdateShadow](https://wiki.facepunch.com/gmod/PhysObj:UpdateShadow).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetShadowAngles
+     */
+    GetShadowAngles(self: PhysObj): Angle;
+}
+
+interface PhysObj {
+    /**
+     * Returns the position of the [PhysObj](https://wiki.facepunch.com/gmod/PhysObj) shadow. See [PhysObj:UpdateShadow](https://wiki.facepunch.com/gmod/PhysObj:UpdateShadow).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetShadowPos
+     */
+    GetShadowPos(self: PhysObj): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns the speed damping of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetSpeedDamping
+     */
+    GetSpeedDamping(self: PhysObj): number;
+}
+
+interface PhysObj {
+    /**
+     * Returns the internal and external stress of the entity.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetStress
+     */
+    GetStress(self: PhysObj): (number, number);
+}
+
+interface PhysObj {
+    /**
+     * Returns the surface area of the physics object in source-units². Or nil if the PhysObj is a generated sphere or box.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetSurfaceArea
+     */
+    GetSurfaceArea(self: PhysObj): number | nil;
+}
+
+interface PhysObj {
+    /**
+     * Returns the absolute directional velocity of the physobject.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetVelocity
+     */
+    GetVelocity(self: PhysObj): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns the world velocity of a point in world coordinates about the object. This is useful for objects rotating around their own axis/origin.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetVelocityAtPoint
+     */
+    GetVelocityAtPoint(self: PhysObj, point: Vector): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Returns the volume in source units³. Or nil if the PhysObj is a generated sphere or box.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:GetVolume
+     */
+    GetVolume(self: PhysObj): number | nil;
+}
+
+interface PhysObj {
+    /**
+     * Returns whenever the specified flag(s) is/are set.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:HasGameFlag
+     */
+    HasGameFlag(self: PhysObj, flags: number): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns whether the physics object is "sleeping".
+     *
+     * See [PhysObj:Sleep](https://wiki.facepunch.com/gmod/PhysObj:Sleep) for more information.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsAsleep
+     */
+    IsAsleep(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns whenever the entity is able to collide or not.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsCollisionEnabled
+     */
+    IsCollisionEnabled(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns whenever the entity is affected by drag.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsDragEnabled
+     */
+    IsDragEnabled(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns whenever the entity is affected by gravity.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsGravityEnabled
+     */
+    IsGravityEnabled(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns if the physics object can move itself (by velocity, acceleration)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsMotionEnabled
+     */
+    IsMotionEnabled(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns whenever the entity is able to move.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsMoveable
+     */
+    IsMoveable(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns whenever the physics object is penetrating another physics object.
+     *
+     * This is internally implemented as `PhysObj:HasGameFlag( FVPHYSICS_PENETRATING )` and thus is only updated for non-static physics objects.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsPenetrating
+     */
+    IsPenetrating(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Returns if the physics object is valid/not NULL.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:IsValid
+     */
+    IsValid(self: PhysObj): boolean;
+}
+
+interface PhysObj {
+    /**
+     * Translates a vector in the physics object's local space into worldspace coordinates.
+     *
+     * **NOTE**: Internally transforms the vector by the [PhysObj:GetPositionMatrix](https://wiki.facepunch.com/gmod/PhysObj:GetPositionMatrix).
+     *
+     * So in GLua it approximates to:
+     * ```
+     * local matrixWorldTransform = PhysObj:GetPositionMatrix()
+     * local vecWorldspaced = Vector()
+     * vecWorldspaced:Set( vecLocal )
+     * vecWorldspaced:Mul( matrixWorldTransform )
+     *
+     * return vecWorldspaced
+     * ```
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:LocalToWorld
+     */
+    LocalToWorld(self: PhysObj, vecLocal: Vector): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Rotationally transforms a vector in the physics object's local space by the [PhysObj:GetPositionMatrix](https://wiki.facepunch.com/gmod/PhysObj:GetPositionMatrix).
+     *
+     * **NOTE**: In contrast to [PhysObj:LocalToWorld](https://wiki.facepunch.com/gmod/PhysObj:LocalToWorld), this function doesn't translate the vector.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:LocalToWorldVector
+     */
+    LocalToWorldVector(self: PhysObj, vecLocal: Vector): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Prints debug info about the state of the physics object to the console.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:OutputDebugInfo
+     */
+    OutputDebugInfo(self: PhysObj): void;
+}
+
+interface PhysObj {
+    /**
+     * Call this when the collision filter conditions change due to this object's state (e.g. changing solid type or collision group)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:RecheckCollisionFilter
+     */
+    RecheckCollisionFilter(self: PhysObj): void;
+}
+
+interface PhysObj {
+    /**
+     * A convinience function for [Angle:RotateAroundAxis](https://wiki.facepunch.com/gmod/Angle:RotateAroundAxis).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:RotateAroundAxis
+     */
+    RotateAroundAxis(self: PhysObj, dir: Vector, ang: number): Angle;
+}
+
+interface PhysObj {
+    /**
+     * Sets the amount of [drag](https://en.wikipedia.org/wiki/Drag_(physics)) to apply to a physics object when attempting to rotate.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetAngleDragCoefficient
+     */
+    SetAngleDragCoefficient(self: PhysObj, coefficient: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the specified [angular velocity](https://en.wikipedia.org/wiki/Angular_velocity) on the [PhysObj](https://wiki.facepunch.com/gmod/PhysObj)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetAngleVelocity
+     */
+    SetAngleVelocity(self: PhysObj, angularVelocity: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the specified instantaneous [angular velocity](https://en.wikipedia.org/wiki/Angular_velocity) on the [PhysObj](https://wiki.facepunch.com/gmod/PhysObj)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetAngleVelocityInstantaneous
+     */
+    SetAngleVelocityInstantaneous(self: PhysObj, angularVelocity: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the angles of the physobject in degrees.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetAngles
+     */
+    SetAngles(self: PhysObj, angles: Angle): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the buoyancy ratio of the physics object. (How well it floats in water)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetBuoyancyRatio
+     */
+    SetBuoyancyRatio(self: PhysObj, buoyancy: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the contents flag of the [PhysObj](https://wiki.facepunch.com/gmod/PhysObj).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetContents
+     */
+    SetContents(self: PhysObj, contents: CONTENTS): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the linear and angular damping of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetDamping
+     */
+    SetDamping(self: PhysObj, linearDamping: number, angularDamping: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Modifies how much drag (air resistance) affects the object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetDragCoefficient
+     */
+    SetDragCoefficient(self: PhysObj, drag: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the angular inertia. See [PhysObj:GetInertia](https://wiki.facepunch.com/gmod/PhysObj:GetInertia).
+     *
+     * **NOTE**: This does not affect linear inertia.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetInertia
+     */
+    SetInertia(self: PhysObj, angularInertia: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the mass of the physics object.
+     *
+     * **WARNING**: This resets [PhysObj:SetBuoyancyRatio](https://wiki.facepunch.com/gmod/PhysObj:SetBuoyancyRatio) (Recalculated based materials' and the physics objects' densities, latter of which is dependent on mass).
+     *
+     * If you used a custom ratio, you will have to re-set it again after `SetMass`.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetMass
+     */
+    SetMass(self: PhysObj, mass: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the material of the physobject.
+     *
+     * **NOTE**: Impact sounds will only change if this is called on client
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetMaterial
+     */
+    SetMaterial(self: PhysObj, materialName: string): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the position of the physobject.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetPos
+     */
+    SetPos(self: PhysObj, position: Vector, teleport?: boolean): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the velocity of the physics object for the next iteration.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetVelocity
+     */
+    SetVelocity(self: PhysObj, velocity: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Sets the velocity of the physics object.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:SetVelocityInstantaneous
+     */
+    SetVelocityInstantaneous(self: PhysObj, velocity: Vector): void;
+}
+
+interface PhysObj {
+    /**
+     * Makes the physics object "sleep". The physics object will no longer be moving unless it is "woken up" by either a collision with another moving object, or by [PhysObj:Wake](https://wiki.facepunch.com/gmod/PhysObj:Wake).
+     *
+     * This is an optimization feature of the physics engine. Normally physics objects will automatically "sleep" when not moving for a short while, to save resources, but it can be used for other purposes, for example to temporarily suspend an object mid air.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:Sleep
+     */
+    Sleep(self: PhysObj): void;
+}
+
+interface PhysObj {
+    /**
+     * Unlike [PhysObj:SetPos](https://wiki.facepunch.com/gmod/PhysObj:SetPos) and [PhysObj:SetAngles](https://wiki.facepunch.com/gmod/PhysObj:SetAngles), this allows the movement of a physobj while leaving physics interactions intact.
+     * This is used internally by the motion controller of the Gravity Gun , the +use pickup and the Physics Gun, and entities such as the crane.
+     *
+     * **NOTE**: This is the ideal function to move a physics shadow created with [Entity:PhysicsInitShadow](https://wiki.facepunch.com/gmod/Entity:PhysicsInitShadow) or [Entity:MakePhysicsObjectAShadow](https://wiki.facepunch.com/gmod/Entity:MakePhysicsObjectAShadow).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:UpdateShadow
+     */
+    UpdateShadow(self: PhysObj, targetPosition: Vector, targetAngles: Angle, frameTime: number): void;
+}
+
+interface PhysObj {
+    /**
+     * Wakes the physics object, so that it will continue to simulate physics/gravity.
+     *
+     * See [PhysObj:Sleep](https://wiki.facepunch.com/gmod/PhysObj:Sleep) for more information.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:Wake
+     */
+    Wake(self: PhysObj): void;
+}
+
+interface PhysObj {
+    /**
+     * Translates a worldspace vector into the physics object's local space.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:WorldToLocal
+     */
+    WorldToLocal(self: PhysObj, vec: Vector): Vector;
+}
+
+interface PhysObj {
+    /**
+     * Rotationally transforms a worldspace vector into the physics object's local space by the inverted [PhysObj:GetPositionMatrix](https://wiki.facepunch.com/gmod/PhysObj:GetPositionMatrix).
+     *
+     * For example, in GMod this is used in thrusters, for working out linear force for local acceleration.
+     *
+     * **NOTE**: In contrast to [PhysObj:WorldToLocal](https://wiki.facepunch.com/gmod/PhysObj:WorldToLocal), this function doesn't translate the vector.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PhysObj:WorldToLocalVector
+     */
+    WorldToLocalVector(self: PhysObj, vec: Vector): Vector;
+}
+