ACOS(3clc)

✨ ACOS(3clc) — the OpenCL Manual's arc cosine era ✨

okay bestie, so you found yourself in the OpenCL Manual (yes, that's the manual name, we're not gatekeeping) and you're here for the arc cosine girls 💅. Buckle up, this is a short one but it's iconic.

---

🌸 NAME 🌸

acos, acosh, acospi — the arc cosine functions, fr fr.

gentype acos(gentype );

gentype acosh(gentype );

gentype acospi(gentype x);

not me noticing acos and acosh just... don't show a parameter name in the synopsis. that's how the original wrote it, so that's how we're writing it. no cap.

---

💖 DESCRIPTION 💖

• acos — it's the arc cosine function. the classic. the moment.
• acosh — the inverse hyperbolic cosine function. hyperbolic, dramatic, main character energy.
• acospi — this one computes acos (x) / π. that's it. that's the whole vibe. divide by pi and slay 🥧

---

🎀 NOTES 🎀

okay this is the important part, bestie, don't skip it:

• the vector versions of the math functions operate component-wise. the description is per-component. so like, every lane does its own lil thing 🦋
• the built-in math functions are not affected by the prevailing rounding mode in the calling environment, and they always return the same value as they would if called with the round to nearest even rounding mode. periodt.
• the built-in math functions take scalar or vector arguments. for any specific use of these functions, the actual type has to be the same for all arguments and the return type, unless otherwise specified. consistency is the vibe check ✅
• the generic type name gentype is used to indicate that the function can take float, float2, float3, float4, float8, float16, double, double2, double3, double4, double8, or double16 as the type for the arguments. that's a lot of types and honestly? obsessed.
• if extended with cl_khr_fp16(3clc), the generic type name gentype may indicate half and half{2|3|4|8|16} as arguments and return values. half precision girlies, we see you 🧚
• the generic type name gentypef is used to indicate that the function can take float, float2, float3, float4, float8, or float16 as the type for the arguments.
• the generic type name gentyped is used to indicate that the function can take double, double2, double3, double4, double8, or double16 as the type for the arguments.

---

🌈 SPECIFICATION 🌈

OpenCL Specification[1] — that's the source of truth, babe 📜

---

👑 SEE ALSO 👑

• mathFunctions(3clc) — go read it, iykyk

---

🫶 AUTHORS 🫶

The Khronos Group — the icons who wrote this. respect. 🙌

---

💜 COPYRIGHT 💜

Copyright © 2007-2011 The Khronos Group Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or associated documentation files (the "Materials"), to deal in the Materials without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to the condition that this copyright notice and permission notice shall be included in all copies or substantial portions of the Materials.

---

🍓 NOTES 🍓

1. OpenCL Specification — page 244, section 6.12.2 - Math Functions. exact citation, no guessing 💅

---

and that's the whole page, bestie. it's from The Khronos Group, dated 01/14/2021 — shoutout to the source and version, they ate and left no crumbs ✨🦋💖