Force Field: Ring

A force field that applies forces to rotate rigid bodies around a ring, defined by a normal axis through the center of the ring and radius from that axis. The two sets of coefficients describe the attraction force to the ring and the tangential force that rotated bodies around the ring. The net force on the rigid body is calculated using f_ring = constant + linear ‘*’ r + inverseSquare / r^2. f_spin = spinConstant + spinLinear ‘*’ r + spinInverseSquare / r^2.

The ring force field attracts or repels rigid body objects toward a force field that is shaped like a ring. Objects will circulate around the ring.

Installation

To use this Node, you must enable omni.physx.forcefields in the Extension Manager.

Inputs

Name	Type	Description	Default
execution	execution	Connection to evaluate this node.	0
primPaths	token[]	Apply forces to this list of Prims. Must be rigid bodies for the forces to have any effect.
enabled	bool	Enable or disable this ForceField. Overrides all other settings.	True
position	pointd[3]	The location of the force field.	[0.0, 0.0, 0.0]
range	float[2]	Forces are not applied when the distance to the force field is outside of this (minimum, maximum) range. Each force field can have a different definition of distance, e.g. for a spherical fore field, the distance is to the center, for a plane, the distance is to the closest point on the surface, for a line, it is to the closest point on the line. The minimum or maximum range is ignored if the value is negative.	[-1.0, -1.0]
surfaceSampleDensity	float	Number of rays to cast per square unit of cross sectional area. When Surface Sample Density is disabled, by setting this value to 0, all forces act through the Center of Mass of the Rigid Body and no rotational torques will be applied. Any positive value will enable Surface Sampling. Ray casts are performed against the Collision Object of the Rigid Body in order to apply forces on the surface along the direction of the surface normal. This will apply torques on the Rigid Body that will induce rotation. Higher densities will cast more rays over the surface and spread the same force over the surface area. More ray casts will generate more accurate forces and torques, but will take additional compute time.	0.0
surfaceAreaScaleEnabled	bool	Enable or disable scaling of forces by the surface area that faces in the direction of the applied force.	True
normalAxis	normalf[3]	The normal axis through the center of the ring in world coordinates.
radius	float	The distance from the normal axis to the center of the ring.	0.0
shape	token[]	Derive the position input from this prim instead.
constant	float	constant applies a steady force.	0.0
linear	float	linear sets a force that varies with distance to the center.	0.0
inverseSquare	float	inverseSquare sets a force that varies with the reciprocal of the square of the distance to the center.	0.0
spinConstant	float	spinConstant applies a steady force that rotates bodies around the ring.	0.0
spinLinear	float	spinLinear applies a force that rotates bodies around the ring and varies with distance to the ring.	0.0
spinInverseSquare	float	spinInverseSquare sets a force that rotates bodies around the ring and varies with the reciprocal of the square of the distance to the ring.	0.0