SoMFVec4f(3)

💅 SoMFVec4f — the Coin manual page, but make it make sense

okay bestie, you found SoMFVec4f(3) in the Coin manual and you're like "what is this" — don't worry, I got you. sit down, hydrate, and let's get into it 🫶

---

✨ NAME ✨

SoMFVec4f — the class that's literally just a container for SbVec4f vectors. that's it. that's the whole job. and she ate 💅

---

🦋 SYNOPSIS 🦋

first things first, you gotta pull her in:

#include <Inventor/fields/SoMFVec4f.h>

and she Inherits SoMField, so everything SoMField can do, she can do too. generational wealth fr fr 👑

🌸 Public Member Functions 🌸

here's every single one, no skips, no cuts:

virtual SoType getTypeId (void) const
virtual void copyFrom (const SoField &field)
const SoMFVec4f & operator= (const SoMFVec4f &field)
virtual SbBool isSame (const SoField &field) const
const SbVec4f & operator[] (const int idx) const
const SbVec4f * getValues (const int start) const
int find (const SbVec4f &value, SbBool addifnotfound=FALSE)
void setValues (const int start, const int num, const SbVec4f *newvals)
void set1Value (const int idx, const SbVec4f &value)
void setValue (const SbVec4f &value)
const SbVec4f & operator= (const SbVec4f &val)
SbBool operator== (const SoMFVec4f &field) const
SbBool operator!= (const SoMFVec4f &field) const
SbVec4f * startEditing (void)
void finishEditing (void)
void setValuesPointer (const int num, const SbVec4f *userdata)
void setValuesPointer (const int num, SbVec4f *userdata)
void setValuesPointer (const int num, const float *userdata)
void setValuesPointer (const int num, float *userdata)
void setValues (int start, int num, const float xyzw[][4])
void set1Value (int idx, float x, float y, float z, float w)
void set1Value (int idx, const float xyzw[4])
void setValue (float x, float y, float z, float w)
void setValue (const float xyzw[4])

💖 Public Member Functions inherited from SoMField 💖

she got it from her mama:

virtual ~SoMField ()
int getNum (void) const
void setNum (const int num)
virtual void deleteValues (int start, int num=-1)
virtual void insertSpace (int start, int num)
SbBool set1 (const int index, const char *const valuestring)
void get1 (const int index, SbString &valuestring)
virtual void enableDeleteValues (void)
virtual SbBool isDeleteValuesEnabled (void) const

💜 Public Member Functions inherited from SoField 💜

and her grandma too, the whole family is iconic:

virtual ~SoField ()
void setIgnored (SbBool ignore)
SbBool isIgnored (void) const
void setDefault (SbBool defaultVal)
SbBool isDefault (void) const
SbBool isOfType (const SoType type) const
void enableConnection (SbBool flag)
SbBool isConnectionEnabled (void) const
SbBool connectFrom (SoEngineOutput *master, SbBool notnotify=FALSE,
    SbBool append=FALSE)
SbBool appendConnection (SoEngineOutput *master, SbBool notnotify=FALSE)
void disconnect (SoEngineOutput *engineoutput)
SbBool isConnectedFromEngine (void) const
SbBool getConnectedEngine (SoEngineOutput *&master) const
SbBool connectFrom (SoField *master, SbBool notnotify=FALSE, SbBool
    append=FALSE)
SbBool appendConnection (SoField *master, SbBool notnotify=FALSE)
void disconnect (SoField *field)
SbBool isConnectedFromField (void) const
SbBool getConnectedField (SoField *&master) const
int getNumConnections (void) const
int getForwardConnections (SoFieldList &slavelist) const
int getConnections (SoFieldList &masterlist) const
void disconnect (void)
SbBool isConnected (void) const
void setContainer (SoFieldContainer *cont)
SoFieldContainer * getContainer (void) const
SbBool set (const char *valuestring)
void get (SbString &valuestring)
SbBool shouldWrite (void) const
virtual void touch (void)
virtual void startNotify (void)
virtual void notify (SoNotList *nlist)
SbBool enableNotify (SbBool on)
SbBool isNotifyEnabled (void) const
void addAuditor (void *f, SoNotRec::Type type)
void removeAuditor (void *f, SoNotRec::Type type)
int operator== (const SoField &f) const
int operator!= (const SoField &f) const
virtual void connectionStatusChanged (int numconnections)
SbBool isReadOnly (void) const
virtual void fixCopy (SbBool copyconnections)
virtual SbBool referencesCopy (void) const
void copyConnection (const SoField *fromfield)
virtual SbBool read (SoInput *input, const SbName &name)
virtual void write (SoOutput *out, const SbName &name) const
virtual void countWriteRefs (SoOutput *out) const
void setFieldType (int type)
int getFieldType (void) const
SbBool getDirty (void) const
void setDirty (SbBool dirty)
void evaluate (void) const

⭐ Static Public Member Functions ⭐

the ones you don't even need an object for, they just show up:

static void * createInstance (void)
static SoType getClassTypeId (void)
static void initClass (void)

🌈 Static Public Member Functions inherited from SoMField 🌈

static SoType getClassTypeId (void)
static void atexit_cleanup (void)
static void initClass (void)

🧚 Static Public Member Functions inherited from SoField 🧚

static void initClass (void)
static void initClasses (void)
static void cleanupClass (void)
static SoType getClassTypeId (void)

🎀 Protected Member Functions 🎀

the backstage crew, protected but still doing the work:

virtual void deleteAllValues (void)
virtual void copyValue (int to, int from)
virtual int fieldSizeof (void) const
virtual void * valuesPtr (void)
virtual void setValuesPtr (void *ptr)
virtual void allocValues (int num)

🍓 Protected Member Functions inherited from SoMField 🍓

SoMField (void)
virtual void makeRoom (int newnum)
virtual SoNotRec createNotRec (SoBase *container)
void setChangedIndex (const int chgidx)
void setChangedIndices (const int chgidx=-1, const int numchgind=0)

🌸 Protected Member Functions inherited from SoField 🌸

SoField (void)
void valueChanged (SbBool resetdefault=TRUE)
virtual void evaluateConnection (void) const
virtual SbBool readConnection (SoInput *in)
virtual void writeConnection (SoOutput *out) const
SbBool isDestructing (void) const

💫 Protected Attributes 💫

SbVec4f * values

🦋 Protected Attributes inherited from SoMField 🦋

int num
int maxNum
SbBool userDataIsUsed

👑 Additional Inherited Members 👑

Public Types inherited from SoField

enum FieldType { NORMAL_FIELD = 0, EVENTIN_FIELD, EVENTOUT_FIELD,
    EXPOSED_FIELD }

---

💖 Detailed Description 💖

okay so the whole tea: the SoMFVec4f class is a container for SbVec4f vectors. that's the vibe. she holds vectors, four elements each, all day, every day, no complaints ✨

this field is used where nodes, engines or other field containers need to store an array of vectors with four elements. so like, not one vector — an array of them. main character with a whole entourage 💅

and here's the fun part: this field supports application data sharing through a setValuesPointer() method. see the SoMField documentation for information on how to use this function. yes bestie, go read that one too, i'm not doing your homework for you 😭

See also

• SbVec4f
• SoSFVec4f

---

🧚 Member Function Documentation 🧚

void * SoMFVec4f::createInstance (void ) [static]

this API member is considered internal to the library, as it is not likely to be of interest to the application programmer. ngl she's a bit of a secret. don't worry about her unless you're in the walls of the library itself 🙈

creates a new instance of the class type corresponding to the SoType object.

SoType SoMFVec4f::getClassTypeId (void ) [static]

this static method returns the SoType object associated with objects of this class. like a little name tag but for types ✨

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

returns the type identification of an object derived from a class inheriting SoField. this is used for runtime type checking and "downward" casting. it's giving detective energy 🔍

implements SoField.

void SoMFVec4f::copyFrom (const SoField & f) [virtual]

copy value(s) from f into this field. f must be of the same type as this field. no mixing, no matching, no chaos. periodt 💅

implements SoField.

SbBool SoMFVec4f::isSame (const SoField & f) const [virtual]

check for equal type and value(s). the vibe check, basically.

implements SoField.

void SoMFVec4f::deleteAllValues (void ) [protected], [virtual]

this API member is considered internal to the library, as it is not likely to be of interest to the application programmer. again, backstage business 🎀

implements SoMField.

void SoMFVec4f::copyValue (int to, int from) [protected], [virtual]

this method is used for moving values around internally within a multivalue field. it needs to be overridden in each field so it automatically takes care of running copy constructors where necessary. so yeah, she shuffles the values and handles the copy constructors herself, very responsible of her 🫶

implements SoMField.

const SbVec4f * SoMFVec4f::getValues (const int start) const [inline]

returns a pointer to the values array. boom. pointer. array. you're welcome 💜

void SoMFVec4f::initClass (void ) [static]

internal method called upon initialization of the library (from SoDB::init()) to set up the type system. she wakes up when the library does 🌅

void SoMFVec4f::setValues (int start, int numarg, const float xyzw[][4])

set num vector array elements from xyzw, starting at index start.

void SoMFVec4f::set1Value (int idx, float x, float y, float z, float w)

set the vector at idx.

void SoMFVec4f::set1Value (int idx, const float xyzw[4])

set the vector at idx.

void SoMFVec4f::setValue (float x, float y, float z, float w)

set this field to contain a single vector with the given element values.

void SoMFVec4f::setValue (const float xyzw[4])

set this field to contain a single vector with the given element values.

---

🌟 Author 🌟

generated automatically by Doxygen for Coin from the source code. no human typed this out by hand, she was born in a build pipeline 😭✨

---

okay that's the whole page bestie, you're officially fluent in SoMFVec4f. go forth and store your four-element vectors with confidence 💅🌸

---

and the little sign-off at the bottom, so you know exactly which version you're reading: this is Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and yes, it's still SoMFVec4f(3). slay 👑