UMULEXTENDED(3G)

✨ UMULEXTENDED(3G) ✨

okay bestie, gather round, because we're about to talk about umulExtended 💖 this is a 3G manpage, which is giving "OpenGL shading language" energy, and honestly? it's a whole vibe. no cap.

---

🌸 NAME 🌸

umulExtended — the girl who performs a 32- by 32-bit multiply to produce a 64-bit result ✨ like, she takes two smol numbers and makes one big number. iconic behavior tbh.

---

🎀 DECLARATION 🎀

here's the literal signature, verbatim, don't come for me:

void umulExtended(genUType x, genUType y, out genUType msb,
                  out genUType lsb);

void imulExtended(genIType x, genIType y, out genIType msb,
                  out genIType lsb);

look at her. two functions. one unsigned, one signed. slay 💅

---

🦋 PARAMETERS 🦋

• x — the first multiplicand, aka the first number we're multiplying. she's the main character of the left side 🫶
• y — the second multiplicand. yes, the original really does have two periods there and honestly? relatable, she's just excited. 💀
• msb — the variable that receives the most significant word of the product. that's the fancy high part, the top 32 bits, the VIP section 👑
• lsb — the variable that receives the least significant word of the product. the bottom 32 bits, the humble queen doing the groundwork 🌸

---

💜 DESCRIPTION 💜

so, umulExtended and imulExtended perform multiplication of the two 32-bit integer quantities x and y, producing a 64-bit integer result. like, two 32-bit girlies walk in, one 64-bit result walks out. the way that math just works 😭

the 32 least significant bits of this product are returned in lsb, and the 32 most significant bits are returned in msb. so the product gets split in half and handed out like friendship bracelets 🎀

umulExtended and imulExtended perform unsigned and signed multiplication, respectively. so pick your fighter: unsigned for the unbothered, signed for the ones who have feelings about negative numbers. periodt.

---

🌈 VERSION SUPPORT 🌈

this is the part where we vibe check which OpenGL Shading Language versions let umulExtended into the club. the original had a whole grid situation, but here's the tea in list form, same facts, cuter delivery:

OpenGL Shading Language Version columns were: 1.10, 1.20, 1.30, 1.40, 1.50, 3.30, 4.00, 4.10, 4.20, 4.30, 4.40, 4.50.

• Function Name: umulExtended
  • 1.10 — - (not invited 💀)
  • 1.20 — - (still not invited 💀)
  • 1.30 — - (nope 💀)
  • 1.40 — - (nope 💀)
  • 1.50 — - (nope 💀)
  • 3.30 — - (nope 💀)
  • 4.00 — ✔ (she's here!! 🔥)
  • 4.10 — ✔ (still here ✨)
  • 4.20 — ✔ (still here ✨)
  • 4.30 — ✔ (still here ✨)
  • 4.40 — ✔ (still here ✨)
  • 4.50 — ✔ (still here ✨)

so basically she didn't exist until 4.00 and then she showed up and stayed. glow up arc complete 🌟

---

👑 SEE ALSO 👑

• uaddCarry() — go say hi to her too, she's also part of the extended-math friend group 🫶

---

💖 COPYRIGHT 💖

Copyright © 2011-2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

---

🎀 COPYRIGHT (again, but shorter) 🎀

Copyright © 2011-2014 Khronos Group

---

and that's the whole page bestie, we ate and left no crumbs 🍓

this iconic little writeup came from the [FIXME: source] of the manual, dated 01/03/2018, and it's the UMULEXTENDED(3G) page through and through — no facts were harmed, no options were dropped, we just gave her a wardrobe change 💅✨