SoMFMatrix(3)

👑 SoMFMatrix — the Coin manual, section 3 👑

okay bestie, gather round, because we're doing a Coin manpage and it's literally the cutest little container you ever met. this is SoMFMatrix(3) from the Coin library docs, and by the end of this you're gonna know it like the back of your hand. no cap. 💅

---

✨ NAME ✨

SoMFMatrix — the class that is a container for SbMatrix values. it's giving "box full of matrices" and honestly? iconic. 🎀

---

🌸 SYNOPSIS 🌸

#include <Inventor/fields/SoMFMatrix.h>

Inherits SoMField.

💖 Public Member Functions 💖

virtual SoType getTypeId (void) const
virtual void copyFrom (const SoField &field)
const SoMFMatrix & operator= (const SoMFMatrix &field)
virtual SbBool isSame (const SoField &field) const
const SbMatrix & operator[] (const int idx) const
const SbMatrix * getValues (const int start) const
int find (const SbMatrix &value, SbBool addifnotfound=FALSE)
void setValues (const int start, const int num, const SbMatrix *newvals)
void set1Value (const int idx, const SbMatrix &value)
void setValue (const SbMatrix &value)
const SbMatrix & operator= (const SbMatrix &val)
SbBool operator== (const SoMFMatrix &field) const
SbBool operator!= (const SoMFMatrix &field) const
SbMatrix * startEditing (void)
void finishEditing (void)
void setValue (const float a11, const float a12, const float a13, const
    float a14, const float a21, const float a22, const float a23, const
    float a24, const float a31, const float a32, const float a33, const
    float a34, const float a41, const float a42, const float a43, const
    float a44)

🌈 Public Member Functions inherited from SoMField 🌈

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 🦋

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 ⭐

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 🎀

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 🍓

SbMatrix * 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 💖

The SoMFMatrix class is a container for SbMatrix values.

so like. this field is the one you reach for when nodes, engines, or other field containers need to store matrices. plural. a whole lil squad of them. 🫶

👀 See also

SoSFMatrix

(that's the single-value version, the solo act. this one's the group chat. iykyk.)

---

📚 MEMBER FUNCTION DOCUMENTATION 📚

🌟 void * SoMFMatrix::createInstance (void ) [static]

okay so this API member is considered internal to the library, because it is not likely to be of interest to the application programmer. (translation: not your problem, bestie, it's housekeeping 🧹)

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

🌟 SoType SoMFMatrix::getClassTypeId (void ) [static]

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

🌟 SoType SoMFMatrix::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.

Implements SoField.

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

Copy value(s) from f into this field. f must be of the same type as this field.

Implements SoField.

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

Check for equal type and value(s).

Implements SoField.

🌟 void SoMFMatrix::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.

Implements SoMField.

🌟 void SoMFMatrix::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.

🌟 const SbMatrix * SoMFMatrix::getValues (const int start) const [inline]

Returns a pointer to the values array. 🎯

🌟 void SoMFMatrix::initClass (void ) [static]

Internal method called upon initialization of the library (from SoDB::init()) to set up the type system.

🌟 void SoMFMatrix::setValue (const float a11, const float a12, const float a13, const float a14, const float a21, const float a22, const float a23, const float a24, const float a31, const float a32, const float a33, const float a34, const float a41, const float a42, const float a43, const float a44)

Set field value array to a single matrix with the given components. all sixteen of them. yes, sixteen. count them. 💅

---

🫶 AUTHOR 🫶

Generated automatically by Doxygen for Coin from the source code.

---

okay that's the whole page, bestie, you ate that. 💖✨

this was the Coin manual, SoMFMatrix(3), Version 4.0.10, dated Thu Jun 25 2026 00:00:00. go forth and store your matrices. periodt. 👑🦋🌈