SoPrimitiveVertex(3)

💖 SoPrimitiveVertex(3) — the Library Functions Manual glow-up 💖

okay bestie, gather round, because today we're talking about SoPrimitiveVertex(3) from the Library Functions Manual, and honestly? she's a little icon. a single vertex of a generated primitive. that's her whole job and she does it flawlessly. 🦋

---

✨ NAME ✨

SoPrimitiveVertex — the SoPrimitiveVertex class represents a single vertex of a generated primitive. no cap, that's literally it, and that's enough.

---

🌸 SYNOPSIS 🌸

#include <Inventor/SoPrimitiveVertex.h>

🎀 Public Member Functions 🎀

SoPrimitiveVertex (void)
SoPrimitiveVertex (const SoPrimitiveVertex &pv)
~SoPrimitiveVertex (void)
SoPrimitiveVertex & operator= (const SoPrimitiveVertex &pv)
const SbVec3f & getPoint (void) const
const SbVec3f & getNormal (void) const
const SbVec4f & getTextureCoords (void) const
int getMaterialIndex (void) const
uint32_t getPackedColor (void) const
const SoDetail * getDetail (void) const
void setPoint (const SbVec3f &pt)
void setPoint (float x, float y, float z)
void setNormal (const SbVec3f &n)
void setNormal (float nx, float ny, float nz)
void setTextureCoords (const SbVec2f &tex)
void setTextureCoords (float tx, float ty)
void setTextureCoords (const SbVec3f &tex)
void setTextureCoords (float tx, float ty, float tz)
void setTextureCoords (const SbVec4f &tex)
void setTextureCoords (float tx, float ty, float tz, float tw)
void setMaterialIndex (int index)
void setPackedColor (uint32_t rgba)
void setDetail (SoDetail *d)

look at that list. she has range. 💅

---

👑 Detailed Description 👑

The SoPrimitiveVertex class represents a single vertex of a generated primitive.

So here's the tea: instances of SoPrimitiveVertex are constructed when generating primitive data, primarily during an SoCallbackAction traversal. Depending on the context, the vertex could represent a single 3D point, one of the two vertices in a line, or one of the three vertices in a triangle. main character energy in every single one of those contexts, fr fr. 🌈

---

🧚 Constructor & Destructor Documentation 🧚

SoPrimitiveVertex::SoPrimitiveVertex (void )

Default constructor, sets up a "void" instance. she's empty, she's fresh, she's ready for whatever you're about to put in her. 🫶

SoPrimitiveVertex::SoPrimitiveVertex (const SoPrimitiveVertex & pv)

Copy constructor. Does a shallow copy. keep that in mind, bestie, because shallow means shallow.

See also: SoPrimitiveVertex::operator=()

SoPrimitiveVertex::~SoPrimitiveVertex (void )

Destructor. Important detail alert 🚨 — the detail instance is owned by client code and will not be destructed here. so don't come for her when your detail leaks, that's a you problem.

---

💜 Member Function Documentation 💜

SoPrimitiveVertex & SoPrimitiveVertex::operator= (const SoPrimitiveVertex & pv)

Copy operator.

When pv is copied into this instance, a shallow copy is made. Ie, only the reference to the detail instance is copied (if any), not the detail itself. so you get the pointer, not the whole personality. 🫠

const SbVec3f & SoPrimitiveVertex::getPoint (void ) const [inline]

Returns vertex coordinates, positioned in object space. 📍

const SbVec3f & SoPrimitiveVertex::getNormal (void ) const [inline]

Returns normal vector, oriented in object space. perpendicular queen. ✨

const SbVec4f & SoPrimitiveVertex::getTextureCoords (void ) const [inline]

Returns texture coordinates for vertex, specified in object space. 🧵

int SoPrimitiveVertex::getMaterialIndex (void ) const [inline]

Returns index of the vertex into the currently active material, if any.

uint32_t SoPrimitiveVertex::getPackedColor (void ) const [inline]

Returns the rgba packed color for the given vertex.

Since: Coin 3.0 ⭐

const SoDetail * SoPrimitiveVertex::getDetail (void ) const [inline]

Returns pointer to detail instance with more information about the vertex. A detail instance may not be available, and if so NULL is returned. so like, check before you dereference, okay? 😭

void SoPrimitiveVertex::setPoint (const SbVec3f & pt) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance. 🛠️

void SoPrimitiveVertex::setPoint (float x, float y, float z) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance. 🛠️

void SoPrimitiveVertex::setNormal (const SbVec3f & n) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance. 🛠️

void SoPrimitiveVertex::setNormal (float nx, float ny, float nz) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance. 🛠️

void SoPrimitiveVertex::setTextureCoords (const SbVec2f & texcoords) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance.

Covenience function. Will fill in 0 and 1 in the last two texture coords in the internal SbVec4f texture coordinate instance. 🍓

void SoPrimitiveVertex::setTextureCoords (float tx, float ty) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance.

Covenience function. Will fill in 0 and 1 in the last two texture coords in the internal SbVec4f texture coordinate instance. 🍓

void SoPrimitiveVertex::setTextureCoords (const SbVec3f & texcoords) [inline]

Covenience function. Will fill in 1 in the last coord.

heads up bestie 💀 — this function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.

Since: Coin 2.0 ⭐

void SoPrimitiveVertex::setTextureCoords (float tx, float ty, float tz) [inline]

Covenience function. Will fill in 1 in the last coord.

same warning, no cap 💀 — this is a Coin extension and it is not available in the original SGI Open Inventor v2.1 API.

Since: Coin 2.5 ⭐

void SoPrimitiveVertex::setTextureCoords (const SbVec4f & texcoords) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance. 🛠️

void SoPrimitiveVertex::setMaterialIndex (int index) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance. 🛠️

void SoPrimitiveVertex::setPackedColor (uint32_t rgba) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance. 🛠️

void SoPrimitiveVertex::setDetail (SoDetail * detail) [inline]

Used internally from library client code setting up an SoPrimitiveVertex instance.

🚨 IMPORTANT, READ IT TWICE 🚨 — note that it's the client's responsibility to do the deallocation of the detail instance after the SoPrimitiveVertex instance has gone out of scope. she is not your babysitter, she is not your memory manager, she is a vertex. free your own detail. 😤

---

🌟 Author 🌟

Generated automatically by Doxygen for Coin from the source code. yes, a robot wrote this. a very good robot. we love her. 🤖💖

---

and that's the whole page, bestie!! this was Coin, Version 3.1.3, straight out of the SoPrimitiveVertex(3) manual, and you read all of it like the academic weapon you are. slay, periodt, go build something gorgeous with your vertices. 🎀✨💅🌈🦋👑