SoSFMatrix(3)

📦 version 3.1.3, in fedora 43, fedora 44

💖 SoSFMatrix 💖

okay bestie, welcome to the glow-up page for SoSFMatrix — straight out of the Library Functions Manual, and yes it's the SoSFMatrix(3) one, we love a named section. she's a whole class, she's a container for an SbMatrix, and she ate. let's get into it 🎀

✨ NAME ✨

SoSFMatrix — the class that is a container for an SbMatrix. that's it, that's the name section, short and iconic 💅

🌸 SYNOPSIS 🌸

#include <Inventor/fields/SoSFMatrix.h>

Inherits SoSField. the family tree is giving legacy, and we respect it 🫶

🌈 Public Member Functions

  • virtual SoType getTypeId (void) const
  • virtual void copyFrom (const SoField &field)
  • const SoSFMatrix & operator= (const SoSFMatrix &field)
  • virtual SbBool isSame (const SoField &field) const
  • const SbMatrix & getValue (void) const
  • void setValue (const SbMatrix &newvalue)
  • const SbMatrix & operator= (const SbMatrix &newvalue)
  • int operator== (const SoSFMatrix &field) const
  • int operator!= (const SoSFMatrix &field) const
  • 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 SoSField

  • virtual ~SoSField ()

🦋 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 SoSField

  • static void initClass (void)
  • static SoType getClassTypeId (void)
  • static void atexit_cleanup (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 Attributes

  • SbMatrix value

🧚 Additional Inherited Members

Public Types inherited from SoField:

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

Protected Member Functions inherited from SoSField:

  • SoSField (void)

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

👑 Detailed Description 👑

okay so SoSFMatrix is a container for an SbMatrix. periodt 💅

this field is the one you reach for whenever nodes, engines or other field containers need to store a 4x4 matrix. lowkey essential, highkey underrated.

and here's the tea bestie: fields of this type store their value to file as a set of 16 floating point values, written from the matrix in row-major mode. write that down 📝

See also

  • SoMFMatrix — her multi-field sister, go say hi 🫶

💅 Member Function Documentation 💅

🦋 SoType SoSFMatrix::getTypeId (void ) const [virtual]

returns the type identification instance which uniquely identifies the Coin field class the object belongs to. it's literally the class's birth chart, no cap ✨

See also

  • getClassTypeId(), SoType

Implements SoField.

💖 void SoSFMatrix::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, bestie, this is not a fusion situation.

Implements SoField.

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

checks for equal type and value(s). it's the vibe check: are y'all actually the same? 👀

Implements SoField.

🌸 void SoSFMatrix::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 matrix elements. that's sixteen floats and she wants all of them, every single one, no skips 💅

🌈 Author 🌈

generated automatically by Doxygen for Coin, from the source code. the robots did this one, and honestly? they ate 🤖✨

and that's the whole page bestie, ty for reading to the end, you're the main character fr fr 🫶💖

Coin — Version 3.1.3 — that's the source and version stamp, keeping it cute and keeping it exact. byeee 🎀👑

📦 where this page comes from