SoNormalBundle(3)

💖 SoNormalBundle 💖 (the NAME section, bestie)

okay so SoNormalBundle — she's the class that simplifies normal handling. that's it, that's the whole vibe. normals? handled. simplified. slay. ✨

---

🦋 SYNOPSIS 🦋

she Inherits SoBundle btw, keep that in mind, she's got a whole family.

🌸 Public Member Functions 🌸

SoNormalBundle (SoAction *action, SbBool forrendering)
~SoNormalBundle ()
SbBool shouldGenerate (int numneeded)
void initGenerator (int initnum=100)
void beginPolygon (void)
void polygonVertex (const SbVec3f &v)
void endPolygon (void)
void triangle (const SbVec3f &p1, const SbVec3f &p2, const SbVec3f &p3)
void generate (int startindex=0, SbBool addtostate=TRUE)
const SbVec3f * getGeneratedNormals (void) const
int getNumGeneratedNormals (void) const
void set (int32_t num, const SbVec3f *normals)
const SbVec3f & get (int index) const
void send (int index) const

🎀 Public Attributes 🎀

• SoNormalGenerator * generator — yes she just has one, out in the open, living her truth 💅

🫶 Additional Inherited Members 🫶

Protected Member Functions inherited from SoBundle

SoBundle (SoAction *action)
~SoBundle ()

Protected Attributes inherited from SoBundle

• SoState * state — the state of the current action. iconic.

---

🔥 Detailed Description 🔥

SoNormalBundle simplifies normal handling. periodt.

lowkey important tea: this class is currently not used in Coin but is provided for API compatibility. so she's giving legacy icon, standing there, being compatible. we love her for that fr fr. 🫶

---

💅 Constructor & Destructor Documentation 💅

SoNormalBundle::SoNormalBundle (SoAction * action, SbBool forrendering)

Constructor. she's born. 💖

SoNormalBundle::~SoNormalBundle ()

Destructor. she's gone. 😭 (but make sure you call it, the set() docs below literally depend on it, iykyk)

---

👑 Member Function Documentation 👑

SbBool SoNormalBundle::shouldGenerate (int numneeded)

Returns FALSE if there are normals on the state. otherwise initGenerator() gets called with numneeded as its argument, and TRUE is returned. simple as that, no cap.

void SoNormalBundle::initGenerator (int initnum = 100)

Initializes the normal generator. initnum is a hint that should contain the approximate number of normals to be generated. it's a hint bestie, not a contract. 🎀

void SoNormalBundle::beginPolygon (void )

Start polygon specification. Call polygonVertex() for each vertex in the polygon, and then endPolygon() to close the polygon.

See also: polygonVertex(), endPolygon()

void SoNormalBundle::polygonVertex (const SbVec3f & v)

Call for each vertex in a polygon.

See also: beginPolygon(), endPolygon()

void SoNormalBundle::endPolygon (void )

Call to close a polygon.

See also: beginPolygon(), polygonVertex()

void SoNormalBundle::triangle (const SbVec3f & p1, const SbVec3f & p2, const SbVec3f & p3)

Convenience method to specify a triangle. p1, p2, and p3 are the triangle's vertices. three points, one shape, zero stress. 🔺✨

void SoNormalBundle::generate (int startindex = 0, SbBool addtostate = TRUE)

Generate normals for the shape. startindex should always be 0 (the SoNonIndexedShape::startIndex field is obsoleted — rip bozo, do not use it). addtostate should be true if the generated normals should be pushed onto the current state.

const SbVec3f * SoNormalBundle::getGeneratedNormals (void ) const

Returns the number of generated normals.

ngl bestie the docs say "number" here but the return type is const SbVec3f *. I'm just telling you exactly what the page says. 🙈

int SoNormalBundle::getNumGeneratedNormals (void ) const

Returns a pointer to the generated normals.

and yeah, this one says "pointer" while returning int. the manpage really said "we're matching energy, not types". 💀 I'm reporting it faithfully, that's the job.

void SoNormalBundle::set (int32_t num, const SbVec3f * normals)

Can be used by nodes that generate their own normals. the state will be updated with the new normals, and the state will be popped again when the SoNormalBundle destructor is called. so like… don't lose track of your destructor, that's the whole plot. 🫶

const SbVec3f & SoNormalBundle::get (int index) const

Returns the index'th normal from the state.

void SoNormalBundle::send (int index) const

Send the index'th normal to OpenGL. go little normal, go!! 🔥

---

🌈 Author 🌈

Generated automatically by Doxygen for Coin from the source code. (yes, a robot wrote her, and she still ate. 🤖💅)

---

okay that's the whole page bestie, hope normals make sense now. this was Coin, Version 3.1.3, and the page itself is dated the same — so like, shoutout to SoNormalBundle(3) for existing. bye pookie, go generate some normals 🦋💜