COS · RedM · Native Atlas

Property	Value
Native Name	`COS`
Hash	`0xD0FFB162F40A139C`
Return Type	`float`
Build	`1207`
Parameters	`value` (float)

Description: Returns the cosine of the given number.

Parameters

value (float) — The number of degrees (in degrees, not radians)

Usage

Lua (Direct):

local result = Cos(value)

Lua (Hash):

local result = Citizen.InvokeNative(0xD0FFB162F40A139C, value)

Examples

-- Get the heading
local heading = GetEntityHeading(PlayerPedId())
local cos = Cos(heading)

-- equivalent in lua
local cosLua = math.cos(heading * (math.pi / 180))

Before you call

Citizen.InvokeNative in CitizenFX Lua does not auto-marshal float/Vector3 returns — the result comes back wrong (community reports both a plain boolean and only-the-x-component-as-a-number); for these returns use the named Lua wrapper (e.g. GetEntityVelocity, GetPedBoneCoords, GetOffsetFromEntityInWorldCoords) or append Citizen.ResultAsVector() / Citizen.ResultAsFloat() as the final InvokeNative argument, and in JS/TS (no wrapper exists) Citizen.resultAsVector() / resultAsFloat() is mandatory; plain int/handle and void returns are unaffected. (see findings: learning:3, learning:17, learning:19, learning:24, learning:83 — fetch via get_document)