Normal to rotation

[Demigod916]

this small addition allows developers to pass in a surface normal and get a rotation vector in return. this function has been useful in object placement, spray paints, decals, etc.

docs are done as well here

RegisterCommand("testnormalrot", function()
  lib.requestModel(`prop_mp_cone_01`)

  local playerCoords = GetEntityCoords(cache.ped)

  local object = CreateObject(`prop_mp_cone_01`, playerCoords.x, playerCoords.y, playerCoords.z, false, false, false)

  SetEntityAlpha(object, 200)
  SetEntityRotation(object, rot.x, rot.y, rot.z, 1)
  DisableCamCollisionForEntity(object)
  SetEntityCollision(object, false, false)
  SetEntityDrawOutlineColor(10, 170, 210, 200)
  SetEntityDrawOutlineShader(0)
  SetEntityDrawOutline(object, true)
  while true do
      _, _, endCoords, surfaceNormal = lib.raycast.cam()
      rot = lib.math.normaltorotation(surfaceNormal)
      SetEntityCoords(object, endCoords)
      SetEntityRotation(object, rot.x, rot.y, rot.z, 1)

      if IsControlJustPressed(0, 18) then
          return
      end
  end
end)