[Customized] Customized Vehicle Turret Rotation

[CrimRecya]

• When ExpandTurretRotation is set to true, the following functions will be enabled.
• Units with turret without TurretSpins=true can looks more vivid when it is in idle.
  • Turret.IdleRotate controls whether units can rotate their turrets when in idle. Defaults to [AudioVisual] -> Turret.IdleRotate.
  • Turret.PointToMouse controls whether units will turn their turrets to your mouse when in idle. Defaults to [AudioVisual] -> Turret.PointToMouse.
  • Turret.IdleRestartMin and Turret.IdleRestartMax control the delay from idle to action occurrence together.
  • Turret.IdleIntervalMin and Turret.IdleIntervalMax control the delay between every idle actions together.
• The turret and body of the units can now be rotated under control.
  • Turret.Restriction defines the angle at which the turret can be turned to both sides.
  • Turret.ExtraAngle defines the additional rotation angle of the turret, and Turret.Restriction will also rotate with this value. The positive number is clockwise and the negative number is counterclockwise, that is, what angle the turret should use by default or face the target.
  • Turret.BodyOrientation controls whether the body needs to aim at the target when firing.
  • Turret.BodyOrientationAngle defines the additional rotation angle of the body when aiming at the target. The positive number is clockwise and the negative number is counterclockwise, that is, what angle the body should use to face the target.
  • Turret.BodyOrientationSymmetric controls whether both sides of the additional body rotation angle can be used.

In rulesmd.ini:

[General]
ExpandTurretRotation=no             ; boolean

[AudioVisual]
Turret.IdleRotate=false             ; boolean
Turret.PointToMouse=false           ; boolean
Turret.IdleRestartMin=150           ; integer, number of frames
Turret.IdleRestartMax=300           ; integer, number of frames
Turret.IdleIntervalMin=150          ; integer, number of frames
Turret.IdleIntervalMax=450          ; integer, number of frames

[SOMEUNIT]                          ; VehicleType, `Turret=yes`
Turret.IdleRotate=                  ; boolean
Turret.PointToMouse=                ; boolean
Turret.Restriction=180.0            ; floating point value
Turret.ExtraAngle=0                 ; floating point value
Turret.BodyOrientation=no           ; boolean
Turret.BodyOrientationAngle=0       ; floating point value
Turret.BodyOrientationSymmetric=yes ; boolean

Update for #1308 .

[github-actions]

Nightly build for this pull request:

• compiled-dll-96bf36d7d2f375aa276958de30480cb6e6aa993c.zip
  These artifacts will expire in 90 days and will not be available for download after that time.

This comment is automatic and is meant to allow guests to get latest nightly builds for this pull request without registering. It is updated on every successful build.

[Metadorius]

I am pretty sure this can be handled with the code @secsome has written for Binary Angle Measurement, see Dir.h and Facing.h in YRpp.

[CrimRecya]

I think I may have missed something? I did notice that it can use radian to raw, but I didn't see angle to raw.

[Metadorius]

Oh, I see where the issue is. I think most angle values parsed from INI are DirType, not degrees, so I would use this here too. See RotationAdjust here for example: https://github.com/Phobos-developers/Phobos/pull/352/files

[CrimRecya]

Get it!

[CrimRecya]

I looked at it, but I thought it might be troublesome.
Because if you use DirType, INIer need to fill in the value of 0-255, which is not very intuitive.
But if you use the angle directly, it is very easy to understand.

[Metadorius]

There is already such a usage in vanilla game. PoseDir takes DirType. I think it's better to stay consistent in this case. Personally I don't feel much issue with using 0-255 instead od 0-360.

[CrimRecya]

OK, I will consider modifying it later.