SoVertexAttributeBinding(3)

📦
version 4.0.10 · 4 versions
, in fedora 43, fedora 44

✨ SoVertexAttributeBinding ✨

okay so bestie, welcome to the SoVertexAttributeBinding manual page, section 3, brought to you by Coin 💖. Yes the class name is a whole mouthful. Say it with me: So-Vertex-Attribute-Binding. Slay. Let's get into it.

🎀 NAME 🎀

SoVertexAttributeBinding — the node that sets up how vertex attributes are mapped to shapes. that's literally the whole vibe. no cap. 💅

🌸 SYNOPSIS 🌸

#include <Inventor/nodes/SoVertexAttributeBinding.h>

Inherits SoNode. so it's a node, she's in the family tree, we love that for her 🫶

🦋 Public Types 🦋

enum Binding { OVERALL = SoVertexAttributeBindingElement::OVERALL,
    PER_VERTEX = SoVertexAttributeBindingElement::PER_VERTEX,
    PER_VERTEX_INDEXED =
    SoVertexAttributeBindingElement::PER_VERTEX_INDEXED, DEFAULT =
    PER_VERTEX_INDEXED }
bestie note: DEFAULT is literally just PER_VERTEX_INDEXED in a trench coat. iconic behaviour. ✨

🦋 Public Types inherited from SoNode 🦋

enum NodeType { INVENTOR = 0x0000, VRML1 = 0x0001, VRML2 = 0x0002,
    INVENTOR_1 = 0x0004, INVENTOR_2_0 = 0x0008, INVENTOR_2_1 = 0x0010,
    INVENTOR_2_5 = 0x0020, INVENTOR_2_6 = 0x0040, COIN_1_0 = 0x0080,
    COIN_2_0 = 0x0100, EXTENSION = 0x0200, COIN_2_2 = 0x0400, COIN_2_3 =
    0x0800, COIN_2_4 = 0x1000, INVENTOR_5_0 = 0x2000, COIN_2_5 = 0x4000,
    COIN_3_0 = 0x8000, INVENTOR_6_0 = 0x10000, COIN_4_0 = 0x20000 }

look at all those bit flags. a whole buffet. she inherited the whole menu 😭

🌈 Public Member Functions 🌈

the main character's own moves, right here:

  • virtual SoType getTypeId (void) const
  • SoVertexAttributeBinding (void)
  • virtual void doAction (SoAction *action)
  • virtual void GLRender (SoGLRenderAction *action)
  • virtual void callback (SoCallbackAction *action)
  • virtual void pick (SoPickAction *action)
  • virtual void getPrimitiveCount (SoGetPrimitiveCountAction *action)

seven whole methods and every single one of them is doing something. obsessed. 💅

🌈 Public Member Functions inherited from SoNode 🌈

she didn't come here alone, she brought the whole friend group:

  • void setOverride (const SbBool state)
  • SbBool isOverride (void) const
  • void setNodeType (const NodeType type)
  • NodeType getNodeType (void) const
  • virtual SoNode * copy (SbBool copyconnections=FALSE) const
  • virtual SbBool affectsState (void) const
  • virtual void GLRenderBelowPath (SoGLRenderAction *action)
  • virtual void GLRenderInPath (SoGLRenderAction *action)
  • virtual void GLRenderOffPath (SoGLRenderAction *action)
  • virtual void getBoundingBox (SoGetBoundingBoxAction *action)
  • virtual void getMatrix (SoGetMatrixAction *action)
  • virtual void handleEvent (SoHandleEventAction *action)
  • virtual void rayPick (SoRayPickAction *action)
  • virtual void search (SoSearchAction *action)
  • virtual void write (SoWriteAction *action)
  • virtual void audioRender (SoAudioRenderAction *action)
  • virtual void grabEventsSetup (void)
  • virtual void grabEventsCleanup (void)
  • virtual void startNotify (void)
  • virtual void notify (SoNotList *l)
  • SbUniqueId getNodeId (void) const
  • virtual SoChildList * getChildren (void) const
  • virtual void writeInstance (SoOutput *out)
  • virtual SoNode * addToCopyDict (void) const
  • virtual void copyContents (const SoFieldContainer *from, SbBool copyconnections)
  • virtual SoFieldContainer * copyThroughConnection (void) const

that's a LOT of inherited lore. the way that she just gets all of this for free?? generational wealth fr fr 👑

🌈 Public Member Functions inherited from SoFieldContainer 🌈

  • void setToDefaults (void)
  • SbBool hasDefaultValues (void) const
  • SbBool fieldsAreEqual (const SoFieldContainer *container) const
  • void copyFieldValues (const SoFieldContainer *container, SbBool copyconnections=FALSE)
  • SbBool set (const char *const fielddata)
  • void get (SbString &fielddata)
  • virtual int getFields (SoFieldList &l) const
  • virtual int getAllFields (SoFieldList &l) const
  • virtual SoField * getField (const SbName &name) const
  • virtual SoField * getEventIn (const SbName &name) const
  • virtual SoField * getEventOut (const SbName &name) const
  • SbBool getFieldName (const SoField *const field, SbName &name) const
  • SbBool enableNotify (const SbBool flag)
  • SbBool isNotifyEnabled (void) const
  • SbBool set (const char *fielddata, SoInput *input)
  • void get (SbString &fielddata, SoOutput *out)
  • virtual SbBool validateNewFieldValue (SoField *field, void *newval)
  • virtual void addWriteReference (SoOutput *out, SbBool isfromfield=FALSE)
  • SbBool getIsBuiltIn (void) const
  • virtual void getFieldsMemorySize (size_t &managed, size_t &unmanaged) const
  • void setUserData (void *userdata) const
  • void * getUserData (void) const

fields, fields, and more fields. it's giving "my ancestors left me everything" 💀

🌈 Public Member Functions inherited from SoBase 🌈

  • void ref (void) const
  • void unref (void) const
  • void unrefNoDelete (void) const
  • int32_t getRefCount (void) const
  • void touch (void)
  • SbBool isOfType (SoType type) const
    • Returns TRUE if the type of this object is either of the same type or inherited from type.
  • virtual SbName getName (void) const
  • virtual void setName (const SbName &newname)
  • void addAuditor (void *const auditor, const SoNotRec::Type type)
  • void removeAuditor (void *const auditor, const SoNotRec::Type type)
  • const SoAuditorList & getAuditors (void) const
  • SbBool shouldWrite (void)
  • void assertAlive (void) const

isOfType is the "are you even in my bloodline" check and honestly? respect. 🌸

⭐ Static Public Member Functions ⭐

  • static SoType getClassTypeId (void)
  • static void initClass (void)
    • Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system.

⭐ Static Public Member Functions inherited from SoNode ⭐

  • static uint32_t getCompatibilityTypes (const SoType &nodetype)
  • static SoType getClassTypeId (void)
  • static SoNode * getByName (const SbName &name)
  • static int getByName (const SbName &name, SoNodeList &l)
  • static void initClass (void)
    • Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system.
  • static void initClasses (void)
  • static SbUniqueId getNextNodeId (void)
  • static int getActionMethodIndex (const SoType type)
  • static void getBoundingBoxS (SoAction *action, SoNode *node)
  • static void GLRenderS (SoAction *action, SoNode *node)
  • static void callbackS (SoAction *action, SoNode *node)
  • static void getMatrixS (SoAction *action, SoNode *node)
  • static void handleEventS (SoAction *action, SoNode *node)
  • static void pickS (SoAction *action, SoNode *node)
  • static void rayPickS (SoAction *action, SoNode *node)
  • static void searchS (SoAction *action, SoNode *node)
  • static void writeS (SoAction *action, SoNode *node)
  • static void audioRenderS (SoAction *action, SoNode *node)
  • static void getPrimitiveCountS (SoAction *action, SoNode *node)

notice how all the S suffixed ones are the static versions of the action callbacks? cute symmetry, ate that honestly 🍓

⭐ Static Public Member Functions inherited from SoFieldContainer ⭐

  • static void initClass (void)
    • Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system.
  • static SoType getClassTypeId (void)
    • This static method returns the SoType object associated with objects of this class.
  • static void cleanupClass (void)
  • static void initCopyDict (void)
  • static void addCopy (const SoFieldContainer *orig, const SoFieldContainer *copy)
  • static SoFieldContainer * checkCopy (const SoFieldContainer *orig)
  • static SoFieldContainer * findCopy (const SoFieldContainer *orig, const SbBool copyconnections)
  • static void copyDone (void)

⭐ Static Public Member Functions inherited from SoBase ⭐

  • static void initClass (void)
    • Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system.
  • static SoType getClassTypeId (void)
    • This static method returns the SoType object associated with objects of this class.
  • static void addName (SoBase *const base, const char *const name)
  • static void removeName (SoBase *const base, const char *const name)
  • static void incrementCurrentWriteCounter (void)
  • static void decrementCurrentWriteCounter (void)
  • static SoBase * getNamedBase (const SbName &name, SoType type)
  • static int getNamedBases (const SbName &name, SoBaseList &baselist, SoType type)
  • static SbBool read (SoInput *input, SoBase *&base, SoType expectedtype)
  • static void setInstancePrefix (const SbString &c)
  • static void setTraceRefs (SbBool trace)
  • static SbBool getTraceRefs (void)
  • static SbBool connectRoute (SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname)
  • static SbBool readRoute (SoInput *input)

🦋 Public Attributes 🦋

  • SoSFEnum value

one (1) public attribute and she is carrying this entire node on her back. main character energy fr 🫶

💜 Protected Member Functions 💜

  • virtual const SoFieldData * getFieldData (void) const
  • virtual ~SoVertexAttributeBinding ()

💜 Protected Member Functions inherited from SoNode 💜

  • SoNode (void)
  • virtual ~SoNode ()
  • virtual SbBool readInstance (SoInput *in, unsigned short flags)

💜 Protected Member Functions inherited from SoFieldContainer 💜

  • SoFieldContainer (void)
  • virtual ~SoFieldContainer ()

💜 Protected Member Functions inherited from SoBase 💜

  • SoBase (void)
  • virtual ~SoBase ()
  • virtual void destroy (void)
  • SbBool hasMultipleWriteRefs (void) const
  • SbBool writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const
  • void writeFooter (SoOutput *out) const
  • virtual const char * getFileFormatName (void) const
  • virtual SoNotRec createNotRec (void)

the protected zone 💅 only the family gets in, that's the rule

🧚 Static Protected Member Functions 🧚

  • static const SoFieldData ** getFieldDataPtr (void)

🧚 Static Protected Member Functions inherited from SoNode 🧚

  • static const SoFieldData ** getFieldDataPtr (void)
  • static void setNextActionMethodIndex (int index)
  • static int getNextActionMethodIndex (void)
  • static void incNextActionMethodIndex (void)
  • static void setCompatibilityTypes (const SoType &nodetype, const uint32_t bitmask)

🧚 Static Protected Member Functions inherited from SoBase 🧚

  • static uint32_t getCurrentWriteCounter (void)
  • static void staticDataLock (void)
  • static void staticDataUnlock (void)

🌟 Additional Inherited Members 🌟

the "you also get all of this and we're not explaining it again" section. iconic. 🙈

🌟 Protected Types inherited from SoBase 🌟

enum BaseFlags { IS_ENGINE = 0x01, IS_GROUP = 0x02 }

🌟 Protected Attributes inherited from SoNode 🌟

  • SbUniqueId uniqueId

🌟 Protected Attributes inherited from SoFieldContainer 🌟

  • SbBool isBuiltIn

🌟 Static Protected Attributes inherited from SoNode 🌟

  • static SbUniqueId nextUniqueId = 1
  • static int nextActionMethodIndex = 0
okay that's the whole class reference, every last inherited crumb, no detail left behind. there's more of this page coming so don't go anywhere bestie 💖

💖 Detailed Description 💖

The SoVertexAttributeBinding class is a node for setting up how vertex attributes are mapped to shapes. Basically it's the vibe coordinator between your attribute data and your geometry, bestie. 🫶

See also SoVertexAttribute

The material binding specified in nodes of this type decides how the vertex attribute values of SoVertexAttribute nodes are mapped on the built-in geometry shape nodes.

Here is a simple usage example:

#Inventor V2.1 ascii

ShaderProgram {
  shaderObject [
    VertexShader {
      sourceProgram "vertex.glsl"
    }
  ]
}

Coordinate3 {
  point [ 0 0 0, 1 0 0, 1 1 0 ]
}

VertexAttributeBinding { value OVERALL }

VertexAttribute {
  typeName "SoMFVec3f"
  name "color"
  values [ 1.0 0.0 0.0 ]
}

IndexedFaceSet {
  coordIndex [ 0, 1, 2, -1 ]
}

The vertex shader (vertex.glsl):

attribute vec3 color;

void main(void)
{
  gl_Position = ftransform();
  fragcolor = color;
}

With SoVertexAttributeBinding::value set to PER_VERTEX_INDEXED above, the attribute indices will be taken from the SoIndexedFaceSet::coordIndex field when rendering. 🔥

If SoVertexAttributeBinding::value is set to PER_VERTEX, attributes will be fetched in a monotonically increasing manner from the SoVertexAttribute::value field, starting at index 0.

If SoVertexAttributeBinding::value is set to OVERALL, the first attribute value from SoVertexAttribute::value will be sent to OpenGL before rendering.

FILE FORMAT/DEFAULTS:

VertexAttributeBinding {
    value PER_VERTEX_INDEXED
}

See also SoVertexAttribute — Be aware that this class is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API. 👀

Since Coin 3.0

🌸 Member Enumeration Documentation 🌸

enum SoVertexAttributeBinding::Binding

Enumeration of available types of material binding. (Yes, it really says material binding in here, we're just quoting the source, no cap. 😭)

  • OVERALL — Apply the same material to the complete shape.
  • PER_VERTEX — Get a new material from the pool of material values for each polygon, line or point vertex of the shape.

Attributes are fetched from index 0 and onwards, incrementing the index into the attribute pool by 1 for each new vertex of the shape node.

  • PER_VERTEX_INDEXED — Get a new attribute from the pool of attribute values for each polygon, line or point vertex of the shape.

Attributes are fetched by the index value settings of the shape.

🎀 Constructor & Destructor Documentation 🎀

SoVertexAttributeBinding::SoVertexAttributeBinding (void )

Constructor. ✨

SoVertexAttributeBinding::~SoVertexAttributeBinding () [protected], [virtual]

Destructor. 💅

🦋 Member Function Documentation 🦋

SoType SoVertexAttributeBinding::getClassTypeId (void ) [static]

This static method returns the SoType object associated with objects of this class.

SoType SoVertexAttributeBinding::getTypeId (void ) const [virtual]

Returns the type identification of an object derived from a class inheriting SoBase. This is used for runtime type checking and "downward" casting.

Implements SoBase.

const SoFieldData ** SoVertexAttributeBinding::getFieldDataPtr (void ) [static], [protected]

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

Returns the SoFieldData class which holds information about fields in this node.

const SoFieldData * SoVertexAttributeBinding::getFieldData (void ) const [protected], [virtual]

Returns a pointer to the class-wide field data storage object for this instance. If no fields are present, returns NULL.

Reimplemented from SoFieldContainer.

void SoVertexAttributeBinding::doAction (SoAction * action) [virtual]

This function performs the typical operation of a node for any action.

Reimplemented from SoNode.

void SoVertexAttributeBinding::GLRender (SoGLRenderAction * action) [virtual]

Action method for the SoGLRenderAction.

This is called during rendering traversals. Nodes influencing the rendering state in any way or want to throw geometry primitives at OpenGL override this method. 🔥

Reimplemented from SoNode.

void SoVertexAttributeBinding::callback (SoCallbackAction * action) [virtual]

Action method for SoCallbackAction.

Simply updates the state according to how the node behaves for the render action, so the application programmer can use the SoCallbackAction for extracting information about the scene graph.

Reimplemented from SoNode.

void SoVertexAttributeBinding::pick (SoPickAction * action) [virtual]

Action method for SoPickAction.

Does common processing for SoPickAction action instances.

Reimplemented from SoNode.

void SoVertexAttributeBinding::getPrimitiveCount (SoGetPrimitiveCountAction * action) [virtual]

Action method for the SoGetPrimitiveCountAction.

Calculates the number of triangle, line segment and point primitives for the node and adds these to the counters of the action.

Nodes influencing how geometry nodes calculate their primitive count also override this method to change the relevant state variables.

Reimplemented from SoNode.

👑 Member Data Documentation 👑

SoSFEnum SoVertexAttributeBinding::value

The attribute binding to use for subsequent shape nodes in the scene graph. The default binding is SoVertexAttributeBinding::PER_VERTEX_INDEXED 💖

💜 Author 💜

Generated automatically by Doxygen for Coin from the source code.

okay bestie that's the whole page 🎀 this was pulled straight from the Coin 4.0.10 source docs, dated Thu Jun 25 2026 00:00:00, and it lives in section SoVertexAttributeBinding(3) of the manual. go forth and bind those attributes, you absolute icon 💅✨

📦 where this page comes from