SoNormalBundle(3)

💖 SoNormalBundle(3) 💖

okay so bestie, welcome to SoNormalBundle, a Coin manual page, and honestly? it's giving "quiet little helper class that just wants to make your normals make sense." 🦋

---

✨ NAME ✨

SoNormalBundle — the class that simplifies normal handling. periodt. 🎀

---

🌸 SYNOPSIS 🌸

#include <Inventor/bundles/SoNormalBundle.h>

Inherits SoBundle. yes bestie, it's a bundle. it's in the bundle 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 — a whole normal generator, just vibing out in the open as a public attribute. iconic. ✨

🌈 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. that's the whole description, she said what she said. 💀

---

🌟 Detailed Description 🌟

The SoNormalBundle class simplifies normal handling. that's the entire tagline, and honestly? it ate. 🔥

lowkey important tea, bestie: this class is currently not used in Coin but is provided for API compatibility. so it's giving "still here for the plot." 😭

---

💅 Constructor & Destructor Documentation 💅

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

Constructor. that's it, that's the description. short king behavior. 👑

SoNormalBundle::~SoNormalBundle ()

Destructor. she cleans up after herself. periodt. 🎀

---

⭐ 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 gets returned. so it's a little "do we even need to do this?" vibe check. 🦋

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 legally binding 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. every single one. no skipping, no shortcuts. 🫶

See also: beginPolygon(), endPolygon()

void SoNormalBundle::endPolygon (void )

Call to close a polygon. that's the closer, the grand finale, the mic drop. 🎤

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 triangles vertices. three points, one triangle, zero drama. ✨

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 to that field, gone but not forgotten 💀). addtostate should be true if the generated normals should be pushed onto the current state.

no cap: startindex = 0, always. don't be out here passing other numbers, bestie. 🙈

const SbVec3f * SoNormalBundle::getGeneratedNormals (void ) const

Returns the number of generated normals.

int SoNormalBundle::getNumGeneratedNormals (void ) const

Returns a pointer to the generated normals.

okay so yes, those two descriptions are swapped in the original docs and i am simply reporting the lore as written, don't shoot the messenger 😭 the manpage said what it said and i'm keeping every word of it.

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... it cleans up on the way out. main character energy. 👑

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. so technically the author is a robot. a slay robot. 🤖💖

---

and that's the whole page, bestie!! this was Version 4.0.10, dated Thu Jun 25 2026 00:00:00, straight from the Coin source, and it's been real, it's been fun, it's been SoNormalBundle(3). mwah, bye!! 💋🌈🦋