SoMFVec3i32(3)

💖 SoMFVec3i32 — the manual, but make it make sense 💖

okay bestie, so this is a page from the Library Functions Manual for SoMFVec3i32(3), and we're gonna get through it together. grab a boba, we're doing this. 🧋✨

---

🌸 NAME 🌸

SoMFVec3i32 — it's a container for SbVec3i32 vectors. that's it, that's the vibe. it holds a whole little army of them. 👑

---

✨ SYNOPSIS ✨

#include <Inventor/fields/SoMFVec3i32.h>

Inherits SoMField.

🫶 Public Member Functions

virtual SoType getTypeId (void) const
virtual void copyFrom (const SoField &field)
const SoMFVec3i32 & operator= (const SoMFVec3i32 &field)
virtual SbBool isSame (const SoField &field) const
const SbVec3i32 & operator[] (const int idx) const
const SbVec3i32 * getValues (const int start) const
int find (const SbVec3i32 &value, SbBool addifnotfound=FALSE)
void setValues (const int start, const int num, const SbVec3i32 *newvals)
void set1Value (const int idx, const SbVec3i32 &value)
void setValue (const SbVec3i32 &value)
const SbVec3i32 & operator= (const SbVec3i32 &val)
SbBool operator== (const SoMFVec3i32 &field) const
SbBool operator!= (const SoMFVec3i32 &field) const
SbVec3i32 * startEditing (void)
void finishEditing (void)
void setValuesPointer (const int num, const SbVec3i32 *userdata)
void setValuesPointer (const int num, SbVec3i32 *userdata)
void setValuesPointer (const int num, const int32_t *userdata)
void setValuesPointer (const int num, int32_t *userdata)
void setValues (int start, int num, const int32_t xyz[][3])
void set1Value (int idx, int32_t x, int32_t y, int32_t z)
void set1Value (int idx, const int32_t xyz[3])
void setValue (int32_t x, int32_t y, int32_t z)
void setValue (const int32_t xyz[3])

💅 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)

🧚 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

SbVec3i32 * 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 SoMFVec3i32 class is a container for SbVec3i32 vectors. yes, we said that already, but the docs said it too so we're saying it again. 💅

This field is used where nodes, engines or other field containers needs to store an array of vectors with three elements. it's giving "i have so many triplets of int32 and nowhere to put them." iconic.

This field supports application data sharing through a setValuesPointer() method. See SoMField documentation for information on how to use this function. (go read that one, bestie, i'm not gonna make stuff up.)

See also SbVec3i32, SoSFVec3i32

Be aware that this class is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API. so if you're time-traveling back to SGI land, this one is not coming with you. 😭

Since Coin 2.5 — it's been around a minute, lowkey a legend. 🫶

---

💀 Member Function Documentation 💀

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

Returns the type identification instance which uniquely identifies the Coin field class the object belongs to. it's the little name tag at the party. 🏷️

See also getClassTypeId(), SoType

Implements SoField.

void SoMFVec3i32::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 exceptions — type check first, bestie. ✨

Implements SoField.

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

Check for equal type and value(s). basically "are we the same person?" energy. 🪞

Implements SoField.

void SoMFVec3i32::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. (translation: not for you, bestie, that's library business. 🙈)

Implements SoMField.

void SoMFVec3i32::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 contructors where necessary. (yes, the original says "contructors", we're keeping it exactly as it is. 💀)

Implements SoMField.

const SbVec3i32 * SoMFVec3i32::getValues (const int start) const [inline]

Returns a pointer to the values array. pointy little guy. 👉✨

void SoMFVec3i32::setValues (int start, int numarg, const int32_t xyz[][3])

Set num vector array elements from the xyz array, reading from index 0 in the given float-triplet vector array and storing values from index start in this SoMFVec3f's array.

If start + num is larger than the current number of elements in the SoMFVec3f field, this method will automatically expand the field to accommodate all given float-vector element values. it just grows. slay. 🌱

void SoMFVec3i32::set1Value (int idx, int32_t x, int32_t y, int32_t z)

Set the vector at idx. one vector, one spot, three ints. periodt. 💅

void SoMFVec3i32::set1Value (int idx, const int32_t xyz[3])

Set the vector at idx. same thing but you're handing it an array instead. 🎁

void SoMFVec3i32::setValue (int32_t x, int32_t y, int32_t z)

Set this field to contain a single vector with the given element values. full reset, one vector, main character energy. 👑

void SoMFVec3i32::setValue (const int32_t xyz[3])

Set this field to contain a single vector with the given element values. array edition. 🌈

---

💜 Author 💜

Generated automatically by Doxygen for Coin from the source code. the robots wrote it, i just gave it a personality. 🫶

---

okay that's the whole page, bestie, you ate that. now go forth and store your triplets of int32_t with confidence. no cap. 🦋✨

Coin — Version 3.1.3 — SoMFVec3i32(3). mwah. 💋