Jolt Physics
A multi core friendly Game Physics Engine
Loading...
Searching...
No Matches
RotatedTranslatedShape.h
Go to the documentation of this file.
1// Jolt Physics Library (https://github.com/jrouwe/JoltPhysics)
2// SPDX-FileCopyrightText: 2021 Jorrit Rouwe
3// SPDX-License-Identifier: MIT
4
5#pragma once
6
9
11
13
16{
17public:
19
20
22
24 RotatedTranslatedShapeSettings(Vec3Arg inPosition, QuatArg inRotation, const ShapeSettings *inShape) : DecoratedShapeSettings(inShape), mPosition(inPosition), mRotation(inRotation) { }
25
27 RotatedTranslatedShapeSettings(Vec3Arg inPosition, QuatArg inRotation, const Shape *inShape): DecoratedShapeSettings(inShape), mPosition(inPosition), mRotation(inRotation) { }
28
29 // See: ShapeSettings
30 virtual ShapeResult Create() const override;
31
34};
35
39{
40public:
42
46 RotatedTranslatedShape(Vec3Arg inPosition, QuatArg inRotation, const Shape *inShape);
47
49 Quat GetRotation() const { return mRotation; }
50
52 Vec3 GetPosition() const { return mCenterOfMass - mRotation.InverseRotate(mInnerShape->GetCenterOfMass()); }
53
54 // See Shape::GetCenterOfMass
55 virtual Vec3 GetCenterOfMass() const override { return mCenterOfMass; }
56
57 // See Shape::GetLocalBounds
58 virtual AABox GetLocalBounds() const override;
59
60 // See Shape::GetWorldSpaceBounds
61 virtual AABox GetWorldSpaceBounds(Mat44Arg inCenterOfMassTransform, Vec3Arg inScale) const override;
63
64 // See Shape::GetInnerRadius
65 virtual float GetInnerRadius() const override { return mInnerShape->GetInnerRadius(); }
66
67 // See Shape::GetMassProperties
68 virtual MassProperties GetMassProperties() const override;
69
70 // See Shape::GetSubShapeTransformedShape
71 virtual TransformedShape GetSubShapeTransformedShape(const SubShapeID &inSubShapeID, Vec3Arg inPositionCOM, QuatArg inRotation, Vec3Arg inScale, SubShapeID &outRemainder) const override;
72
73 // See Shape::GetSurfaceNormal
74 virtual Vec3 GetSurfaceNormal(const SubShapeID &inSubShapeID, Vec3Arg inLocalSurfacePosition) const override;
75
76 // See Shape::GetSupportingFace
77 virtual void GetSupportingFace(const SubShapeID &inSubShapeID, Vec3Arg inDirection, Vec3Arg inScale, Mat44Arg inCenterOfMassTransform, SupportingFace &outVertices) const override;
78
79 // See Shape::GetSubmergedVolume
80 virtual void GetSubmergedVolume(Mat44Arg inCenterOfMassTransform, Vec3Arg inScale, const Plane &inSurface, float &outTotalVolume, float &outSubmergedVolume, Vec3 &outCenterOfBuoyancy JPH_IF_DEBUG_RENDERER(, RVec3Arg inBaseOffset)) const override;
81
82#ifdef JPH_DEBUG_RENDERER
83 // See Shape::Draw
84 virtual void Draw(DebugRenderer *inRenderer, RMat44Arg inCenterOfMassTransform, Vec3Arg inScale, ColorArg inColor, bool inUseMaterialColors, bool inDrawWireframe) const override;
85
86 // See Shape::DrawGetSupportFunction
87 virtual void DrawGetSupportFunction(DebugRenderer *inRenderer, RMat44Arg inCenterOfMassTransform, Vec3Arg inScale, ColorArg inColor, bool inDrawSupportDirection) const override;
88
89 // See Shape::DrawGetSupportingFace
90 virtual void DrawGetSupportingFace(DebugRenderer *inRenderer, RMat44Arg inCenterOfMassTransform, Vec3Arg inScale) const override;
91#endif // JPH_DEBUG_RENDERER
92
93 // See Shape::CastRay
94 virtual bool CastRay(const RayCast &inRay, const SubShapeIDCreator &inSubShapeIDCreator, RayCastResult &ioHit) const override;
95 virtual void CastRay(const RayCast &inRay, const RayCastSettings &inRayCastSettings, const SubShapeIDCreator &inSubShapeIDCreator, CastRayCollector &ioCollector, const ShapeFilter &inShapeFilter = { }) const override;
96
97 // See: Shape::CollidePoint
98 virtual void CollidePoint(Vec3Arg inPoint, const SubShapeIDCreator &inSubShapeIDCreator, CollidePointCollector &ioCollector, const ShapeFilter &inShapeFilter = { }) const override;
99
100 // See Shape::CollectTransformedShapes
101 virtual void CollectTransformedShapes(const AABox &inBox, Vec3Arg inPositionCOM, QuatArg inRotation, Vec3Arg inScale, const SubShapeIDCreator &inSubShapeIDCreator, TransformedShapeCollector &ioCollector, const ShapeFilter &inShapeFilter) const override;
102
103 // See Shape::TransformShape
104 virtual void TransformShape(Mat44Arg inCenterOfMassTransform, TransformedShapeCollector &ioCollector) const override;
105
106 // See Shape::GetTrianglesStart
107 virtual void GetTrianglesStart(GetTrianglesContext &ioContext, const AABox &inBox, Vec3Arg inPositionCOM, QuatArg inRotation, Vec3Arg inScale) const override { JPH_ASSERT(false, "Cannot call on non-leaf shapes, use CollectTransformedShapes to collect the leaves first!"); }
108
109 // See Shape::GetTrianglesNext
110 virtual int GetTrianglesNext(GetTrianglesContext &ioContext, int inMaxTrianglesRequested, Float3 *outTriangleVertices, const PhysicsMaterial **outMaterials = nullptr) const override { JPH_ASSERT(false, "Cannot call on non-leaf shapes, use CollectTransformedShapes to collect the leaves first!"); return 0; }
111
112 // See Shape
113 virtual void SaveBinaryState(StreamOut &inStream) const override;
114
115 // See Shape::GetStats
116 virtual Stats GetStats() const override { return Stats(sizeof(*this), 0); }
117
118 // See Shape::GetVolume
119 virtual float GetVolume() const override { return mInnerShape->GetVolume(); }
120
121 // See Shape::IsValidScale
122 virtual bool IsValidScale(Vec3Arg inScale) const override;
123
124 // Register shape functions with the registry
125 static void sRegister();
126
127protected:
128 // See: Shape::RestoreBinaryState
129 virtual void RestoreBinaryState(StreamIn &inStream) override;
130
131private:
132 // Helper functions called by CollisionDispatch
133 static void sCollideRotatedTranslatedVsShape(const Shape *inShape1, const Shape *inShape2, Vec3Arg inScale1, Vec3Arg inScale2, Mat44Arg inCenterOfMassTransform1, Mat44Arg inCenterOfMassTransform2, const SubShapeIDCreator &inSubShapeIDCreator1, const SubShapeIDCreator &inSubShapeIDCreator2, const CollideShapeSettings &inCollideShapeSettings, CollideShapeCollector &ioCollector, const ShapeFilter &inShapeFilter);
134 static void sCollideShapeVsRotatedTranslated(const Shape *inShape1, const Shape *inShape2, Vec3Arg inScale1, Vec3Arg inScale2, Mat44Arg inCenterOfMassTransform1, Mat44Arg inCenterOfMassTransform2, const SubShapeIDCreator &inSubShapeIDCreator1, const SubShapeIDCreator &inSubShapeIDCreator2, const CollideShapeSettings &inCollideShapeSettings, CollideShapeCollector &ioCollector, const ShapeFilter &inShapeFilter);
135 static void sCastRotatedTranslatedVsShape(const ShapeCast &inShapeCast, const ShapeCastSettings &inShapeCastSettings, const Shape *inShape, Vec3Arg inScale, const ShapeFilter &inShapeFilter, Mat44Arg inCenterOfMassTransform2, const SubShapeIDCreator &inSubShapeIDCreator1, const SubShapeIDCreator &inSubShapeIDCreator2, CastShapeCollector &ioCollector);
136 static void sCastShapeVsRotatedTranslated(const ShapeCast &inShapeCast, const ShapeCastSettings &inShapeCastSettings, const Shape *inShape, Vec3Arg inScale, const ShapeFilter &inShapeFilter, Mat44Arg inCenterOfMassTransform2, const SubShapeIDCreator &inSubShapeIDCreator1, const SubShapeIDCreator &inSubShapeIDCreator2, CastShapeCollector &ioCollector);
137
139 inline Vec3 TransformScale(Vec3Arg inScale) const
140 {
141 // We don't need to transform uniform scale or if the rotation is identity
142 if (mIsRotationIdentity || ScaleHelpers::IsUniformScale(inScale))
143 return inScale;
144
145 return ScaleHelpers::RotateScale(mRotation, inScale);
146 }
147
148 bool mIsRotationIdentity;
149 Vec3 mCenterOfMass;
150 Quat mRotation;
151};
152
#define JPH_NAMESPACE_END
Definition: Core.h:240
#define JPH_IF_DEBUG_RENDERER(...)
Definition: Core.h:378
#define JPH_NAMESPACE_BEGIN
Definition: Core.h:234
#define JPH_ASSERT(...)
Definition: IssueReporting.h:33
#define JPH_OVERRIDE_NEW_DELETE
Macro to override the new and delete functions.
Definition: Memory.h:29
#define JPH_DECLARE_SERIALIZABLE_VIRTUAL(class_name)
Definition: SerializableObject.h:100
EShapeSubType
This enumerates all shape types, each shape can return its type through Shape::GetSubType.
Definition: Shape.h:71
Axis aligned box.
Definition: AABox.h:16
Settings to be passed with a collision query.
Definition: CollideShape.h:94
Virtual interface that allows collecting multiple collision results.
Definition: CollisionCollector.h:45
Class that holds an RGBA color with 8-bits per component.
Definition: Color.h:16
Simple triangle renderer for debugging purposes.
Definition: DebugRenderer.h:25
Base class for shapes that decorate another shape with extra functionality (e.g. scale,...
Definition: DecoratedShape.h:29
RefConst< Shape > mInnerShape
Definition: DecoratedShape.h:67
Class that constructs a DecoratedShape.
Definition: DecoratedShape.h:13
Class that holds 3 floats. Used as a storage class. Convert to Vec3 for calculations.
Definition: Float3.h:13
Describes the mass and inertia properties of a body. Used during body construction only.
Definition: MassProperties.h:16
Holds a 4x4 matrix of floats, but supports also operations on the 3x3 upper left part of the matrix.
Definition: Mat44.h:13
Definition: PhysicsMaterial.h:23
An infinite plane described by the formula X . Normal + Constant = 0.
Definition: Plane.h:11
Definition: Quat.h:33
JPH_INLINE Vec3 InverseRotate(Vec3Arg inValue) const
Rotate a vector by the inverse of this quaternion.
Definition: Quat.inl:282
Specialization of cast result against a shape.
Definition: CastResult.h:27
Settings to be passed with a ray cast.
Definition: RayCast.h:64
Definition: RotatedTranslatedShape.h:39
virtual MassProperties GetMassProperties() const override
Calculate the mass and inertia of this shape.
Definition: RotatedTranslatedShape.cpp:60
virtual void RestoreBinaryState(StreamIn &inStream) override
This function should not be called directly, it is used by sRestoreFromBinaryState.
Definition: RotatedTranslatedShape.cpp:236
virtual void DrawGetSupportingFace(DebugRenderer *inRenderer, RMat44Arg inCenterOfMassTransform, Vec3Arg inScale) const override
Draw the results of the GetSupportingFace function to show any errors introduced by this process (onl...
Definition: RotatedTranslatedShape.cpp:125
virtual TransformedShape GetSubShapeTransformedShape(const SubShapeID &inSubShapeID, Vec3Arg inPositionCOM, QuatArg inRotation, Vec3Arg inScale, SubShapeID &outRemainder) const override
Definition: RotatedTranslatedShape.cpp:79
virtual float GetInnerRadius() const override
Definition: RotatedTranslatedShape.h:65
JPH_OVERRIDE_NEW_DELETE RotatedTranslatedShape()
Constructor.
Definition: RotatedTranslatedShape.h:44
virtual int GetTrianglesNext(GetTrianglesContext &ioContext, int inMaxTrianglesRequested, Float3 *outTriangleVertices, const PhysicsMaterial **outMaterials=nullptr) const override
Definition: RotatedTranslatedShape.h:110
virtual Stats GetStats() const override
Get stats of this shape. Use for logging / data collection purposes only. Does not add values from ch...
Definition: RotatedTranslatedShape.h:116
virtual float GetVolume() const override
Definition: RotatedTranslatedShape.h:119
virtual void GetSubmergedVolume(Mat44Arg inCenterOfMassTransform, Vec3Arg inScale, const Plane &inSurface, float &outTotalVolume, float &outSubmergedVolume, Vec3 &outCenterOfBuoyancy JPH_IF_DEBUG_RENDERER(, RVec3Arg inBaseOffset)) const override
Definition: RotatedTranslatedShape.cpp:105
Quat GetRotation() const
Access the rotation that is applied to the inner shape.
Definition: RotatedTranslatedShape.h:49
virtual void TransformShape(Mat44Arg inCenterOfMassTransform, TransformedShapeCollector &ioCollector) const override
Definition: RotatedTranslatedShape.cpp:173
virtual Vec3 GetCenterOfMass() const override
All shapes are centered around their center of mass. This function returns the center of mass positio...
Definition: RotatedTranslatedShape.h:55
virtual void GetTrianglesStart(GetTrianglesContext &ioContext, const AABox &inBox, Vec3Arg inPositionCOM, QuatArg inRotation, Vec3Arg inScale) const override
Definition: RotatedTranslatedShape.h:107
virtual void Draw(DebugRenderer *inRenderer, RMat44Arg inCenterOfMassTransform, Vec3Arg inScale, ColorArg inColor, bool inUseMaterialColors, bool inDrawWireframe) const override
Draw the shape at a particular location with a particular color (debugging purposes)
Definition: RotatedTranslatedShape.cpp:115
static void sRegister()
Definition: RotatedTranslatedShape.cpp:259
virtual void CollectTransformedShapes(const AABox &inBox, Vec3Arg inPositionCOM, QuatArg inRotation, Vec3Arg inScale, const SubShapeIDCreator &inSubShapeIDCreator, TransformedShapeCollector &ioCollector, const ShapeFilter &inShapeFilter) const override
Definition: RotatedTranslatedShape.cpp:164
virtual void DrawGetSupportFunction(DebugRenderer *inRenderer, RMat44Arg inCenterOfMassTransform, Vec3Arg inScale, ColorArg inColor, bool inDrawSupportDirection) const override
Draw the results of the GetSupportFunction with the convex radius added back on to show any errors in...
Definition: RotatedTranslatedShape.cpp:120
Vec3 GetPosition() const
Access the translation that has been applied to the inner shape.
Definition: RotatedTranslatedShape.h:52
virtual bool IsValidScale(Vec3Arg inScale) const override
Definition: RotatedTranslatedShape.cpp:245
virtual void GetSupportingFace(const SubShapeID &inSubShapeID, Vec3Arg inDirection, Vec3Arg inScale, Mat44Arg inCenterOfMassTransform, SupportingFace &outVertices) const override
Definition: RotatedTranslatedShape.cpp:99
virtual bool CastRay(const RayCast &inRay, const SubShapeIDCreator &inSubShapeIDCreator, RayCastResult &ioHit) const override
Definition: RotatedTranslatedShape.cpp:131
virtual void SaveBinaryState(StreamOut &inStream) const override
Saves the contents of the shape in binary form to inStream.
Definition: RotatedTranslatedShape.cpp:228
virtual AABox GetLocalBounds() const override
Get local bounding box including convex radius, this box is centered around the center of mass rather...
Definition: RotatedTranslatedShape.cpp:68
virtual void CollidePoint(Vec3Arg inPoint, const SubShapeIDCreator &inSubShapeIDCreator, CollidePointCollector &ioCollector, const ShapeFilter &inShapeFilter={ }) const override
Definition: RotatedTranslatedShape.cpp:153
virtual AABox GetWorldSpaceBounds(Mat44Arg inCenterOfMassTransform, Vec3Arg inScale) const override
Definition: RotatedTranslatedShape.cpp:73
virtual Vec3 GetSurfaceNormal(const SubShapeID &inSubShapeID, Vec3Arg inLocalSurfacePosition) const override
Definition: RotatedTranslatedShape.cpp:89
Class that constructs a RotatedTranslatedShape.
Definition: RotatedTranslatedShape.h:16
Quat mRotation
Rotation of the sub shape.
Definition: RotatedTranslatedShape.h:33
RotatedTranslatedShapeSettings(Vec3Arg inPosition, QuatArg inRotation, const Shape *inShape)
Variant that uses a concrete shape, which means this object cannot be serialized.
Definition: RotatedTranslatedShape.h:27
Vec3 mPosition
Position of the sub shape.
Definition: RotatedTranslatedShape.h:32
virtual ShapeResult Create() const override
Create a shape according to the settings specified by this object.
Definition: RotatedTranslatedShape.cpp:26
Settings to be passed with a shape cast.
Definition: ShapeCast.h:92
Filter class.
Definition: ShapeFilter.h:17
Base class for all shapes (collision volume of a body). Defines a virtual interface for collision det...
Definition: Shape.h:170
ShapeSettings::ShapeResult ShapeResult
Definition: Shape.h:174
virtual float GetInnerRadius() const =0
virtual float GetVolume() const =0
virtual Vec3 GetCenterOfMass() const
All shapes are centered around their center of mass. This function returns the center of mass positio...
Definition: Shape.h:195
StaticArray< Vec3, 32 > SupportingFace
Type definition for a supporting face.
Definition: Shape.h:235
virtual AABox GetWorldSpaceBounds(Mat44Arg inCenterOfMassTransform, Vec3Arg inScale) const
Definition: Shape.h:206
Definition: Shape.h:135
Result< Ref< Shape > > ShapeResult
Definition: Shape.h:139
Simple binary input stream.
Definition: StreamIn.h:11
Simple binary output stream.
Definition: StreamOut.h:11
Definition: SubShapeID.h:108
A sub shape id contains a path to an element (usually a triangle or other primitive type) of a compou...
Definition: SubShapeID.h:23
Definition: TransformedShape.h:26
Definition: Vec3.h:16
Vec3 RotateScale(QuatArg inRotation, Vec3Arg inScale)
Definition: ScaleHelpers.h:60
bool IsUniformScale(Vec3Arg inScale)
Test if a scale is uniform.
Definition: ScaleHelpers.h:21
Definition: RayCast.h:41
An opaque buffer that holds shape specific information during GetTrianglesStart/Next.
Definition: Shape.h:318
Class that holds information about the shape that can be used for logging / data collection purposes.
Definition: Shape.h:377
Definition: ShapeCast.h:69