SoMFVec2s(3)

📦
version 4.0.10 · 4 versions
, in fedora 43, fedora 44

🎀 SoMFVec2s — the Coin manual, but make it make sense 🎀

okay bestie, welcome to SoMFVec2s, page 3 of the Coin manual. yes, that Coin. we're doing C++ 3D scene-graph fields today and honestly? iconic. 💅

🌸 NAME 🌸

SoMFVec2s</p> — the class that's a whole container for SbVec2s vectors. that's it, that's the name. multi-field, vec2, short. the S is for short, keep up 🫶

✨ SYNOPSIS ✨

#include <Inventor/fields/SoMFVec2s.h>

and it inherits SoMField. yes, the M stands for multi. we love a family tree. 🌳

💖 Public Member Functions 💖

  • virtual SoType getTypeId (void) const
  • virtual void copyFrom (const SoField &field)
  • const SoMFVec2s & operator= (const SoMFVec2s &field)
  • virtual SbBool isSame (const SoField &field) const
  • SbVec2s operator[] (const int idx) const
  • const SbVec2s * getValues (const int start) const
  • int find (SbVec2s value, SbBool addifnotfound=FALSE)
  • void setValues (const int start, const int num, const SbVec2s *newvals)
  • void set1Value (const int idx, SbVec2s value)
  • void setValue (SbVec2s value)
  • SbVec2s operator= (SbVec2s val)
  • SbBool operator== (const SoMFVec2s &field) const
  • SbBool operator!= (const SoMFVec2s &field) const
  • SbVec2s * startEditing (void)
  • void finishEditing (void)
  • void setValuesPointer (const int num, const SbVec2s *userdata)
  • void setValuesPointer (const int num, SbVec2s *userdata)
  • void setValuesPointer (const int num, const short *userdata)
  • void setValuesPointer (const int num, short *userdata)
  • void setValues (int start, int num, const short xy[][2])
  • void set1Value (int idx, short x, short y)
  • void set1Value (int idx, const short xy[2])
  • void setValue (short x, short y)
  • void setValue (const short xy[2])

🌈 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 💜

  • SbVec2s * 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 tea: SoMFVec2s is a container for SbVec2s vectors. multi-value field, two-element vectors, short values. no cap. 🍓

you reach for this field any time a node, an engine, or literally any other field container needs to hold an array of vectors with two elements. that's the whole job. and it does it beautifully. ✨

this field also supports application data sharing through a setValuesPointer() method. so if you wanna know how to actually use that function, go read the SoMField docs, bestie, that's where the details live. 📚

See also — SbVec2s, SoSFVec2s.

⚠️ heads up: 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 on ancient SGI vibes, this one's not invited to the party. 😭

Since — Coin 2.5. vintage but thriving. 💅

🔥 Member Function Documentation 🔥

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

this API member is considered internal to the library, because it is not likely to be of interest to the application programmer.

it creates a new instance of the class type corresponding to the SoType object. that's the whole thing. 🙈

SoType SoMFVec2s::getClassTypeId (void ) [static]

this static method returns the SoType object associated with objects of this class. one job, done slayfully. 👑

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

returns the type identification of an object derived from a class inheriting SoField. this is what powers runtime type checking and "downward" casting. iykyk.

Implements SoField.

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

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

Implements SoField.

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

check for equal type and value(s). both. not one or the other. 💖

Implements SoField.

void SoMFVec2s::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 SoMFVec2s::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. very responsible of it honestly. 🧚

Implements SoMField.

const SbVec2s * SoMFVec2s::getValues (const int start) const [inline]

returns a pointer to the values array. pointer. array. go. 🔥

void SoMFVec2s::initClass (void ) [static]

internal method called upon initialization of the library — specifically from SoDB::init() — to set up the type system. behind the scenes main character energy. 🌟

void SoMFVec2s::setValues (int start, int numarg, const short xy[][2])

set num vector array elements from xy, starting at index start. so start is where you begin, num is how many, xy is the source. no notes. ✨

void SoMFVec2s::set1Value (int idx, short x, short y)

set the vector at idx. 🎯

void SoMFVec2s::set1Value (int idx, const short xy[2])

set the vector at idx. (yes, again — different signature, same energy.) 🎯

void SoMFVec2s::setValue (short x, short y)

set this field to contain a single vector with the given element values. just one. singular. 💅

void SoMFVec2s::setValue (const short xy[2])

set this field to contain a single vector with the given element values. same deal, array flavored. 💅

📝 Author 📝

generated automatically by Doxygen for Coin, straight from the source code. not a human, just a very diligent robot. 🤖💖

and that's the page, bestie!! Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and it's filed right there in section 3 as SoMFVec2s(3). go forth and store your two-element short vectors. you got this. 🦋✨💜

📦 where this page comes from