SoSFMatrix(3)

📦 version 2.5.0, in fedora 43, fedora 44

🦋 SoSFMatrix 🦋

okay so bestie, welcome to the Library Functions Manual page for SoSFMatrix(3) — yes she's a section-3 manual page and yes she's iconic 💅

💖 NAME 💖

SoSFMatrix — the SoSFMatrix class is a container for an SbMatrix. that's it, that's the whole vibe ✨

🌸 SYNOPSIS 🌸

#include <Inventor/fields/SoSFMatrix.h>

She inherits SoSField 🫶

🎀 Public Member Functions

  • virtual SoType getTypeId (void) const — grabs the type id, we love a self-aware queen
  • virtual void copyFrom (const SoField &field) — copy that field over here
  • const SoSFMatrix & operator= (const SoSFMatrix &field) — assignment from another SoSFMatrix
  • virtual SbBool isSame (const SoField &field) const — are y'all the same? type + value check
  • const SbMatrix & getValue (void) const — hand over the matrix please
  • void setValue (const SbMatrix &newvalue) — set it from a whole SbMatrix
  • const SbMatrix & operator= (const SbMatrix &newvalue) — assignment straight from an SbMatrix
  • int operator== (const SoSFMatrix &field) const — equality, bestie style
  • int operator!= (const SoSFMatrix &field) const — and the not-equal counterpart, no cap
  • 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) — all sixteen floats, one by one, main character energy 💀

💜 Public Member Functions inherited from SoSField

  • virtual ~SoSField () — the destructor, she cleans up after herself

🌈 Public Member Functions inherited from SoField

  • virtual ~SoField ()
  • void setIgnored (SbBool ignore)
  • SbBool isIgnored (void) const
  • void setDefault (SbBool def)
  • SbBool isDefault (void) const
  • SbBool isOfType (const SoType type) const
  • void enableConnection (SbBool flag)
  • SbBool isConnectionEnabled (void) const
  • SbBool connectFrom (SoEngineOutput *master, SbBool notnotify=0, SbBool append=0)
  • SbBool appendConnection (SoEngineOutput *master, SbBool notnotify=0)
  • void disconnect (SoEngineOutput *engineoutput)
  • SbBool isConnectedFromEngine (void) const
  • SbBool getConnectedEngine (SoEngineOutput *&master) const
  • SbBool connectFrom (SoField *master, SbBool notnotify=0, SbBool append=0)
  • SbBool appendConnection (SoField *master, SbBool notnotify=0)
  • 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 *in, 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 Public Member Functions inherited from SoField

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

🍓 Protected Attributes

  • SbMatrix value — the actual matrix, sitting there being protected and mysterious

🧚 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=1)
  • virtual void evaluateConnection (void) const
  • virtual SbBool readConnection (SoInput *in)
  • virtual void writeConnection (SoOutput *out) const
  • SbBool isDestructing (void) const

✨ Detailed Description ✨

okay so, deep breath, here's the tea 🫖

The SoSFMatrix class is a container for an SbMatrix.

This field is used where nodes, engines or other field containers needs to store a 4x4 matrix. yes, a whole 4x4, she contains multitudes 💅

Fields of this type stores their value to file as a set of 16 floating point values, written from the matrix in row-major mode. that's the format bestie, don't fight it.

See also

  • SoMFMatrix — her multi-value cousin, 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.

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. (like, non-negotiable, she's picky and honestly? valid 💅)

Implements SoField.

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

Check for equal type and value(s). twin check, but make it technical ✨

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. all sixteen of them, one at a time, no shortcuts, no notes 👑

💜 Author 💜

Generated automatically by Doxygen for Coin from the source code. (so technically not a human author, but she ATE regardless 😭💖)

and that's the whole page bestie!! this one came from the Coin crew, Version 2.5.0, and it's filed as SoSFMatrix(3). go forth and store your 4x4 matrices, iykyk 🌸🦋💖

📦 where this page comes from