SoVRMLTextureCoordinate(3)

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

✨ SoVRMLTextureCoordinate ✨

okay bestie, welcome to the SoVRMLTextureCoordinate(3) page from Coin 💖 this is part 1 of 2 so don't go anywhere, there's more coming. she's the class that binds texture coordinates to vertex-based geometry, and honestly? iconic behaviour. matchmaking vertices to textures like it's her whole job 🦋

💖 NAME 💖

SoVRMLTextureCoordinate — binds texture coordinates to vertex-based geometry. literally the wingwoman of your VRML geometry, no cap 💅

🎀 SYNOPSIS 🎀

#include <Inventor/VRMLnodes/SoVRMLTextureCoordinate.h>

Inherits SoNode. periodt 🌸

🌈 Public Member Functions 🌈

  • virtual SoType getTypeId (void) const — hands you back the SoType for this class, the classic "who am I" check 🪞
  • SoVRMLTextureCoordinate (void) — the constructor, she's right there ready to build you a fresh one ✨
  • virtual void doAction (SoAction *action) — the general "do the thing with this SoAction" entry point 🔥
  • virtual void callback (SoCallbackAction *action) — runs the callback action, she's on it 💫
  • virtual void GLRender (SoGLRenderAction *action) — the render pass, this is where she shows up for SoGLRenderAction 👑
  • virtual void pick (SoPickAction *action) — handles picking with SoPickAction, for when you need to know what's under the cursor 🎯
  • virtual void getPrimitiveCount (SoGetPrimitiveCountAction *action) — answers the SoGetPrimitiveCountAction roll call 🔢

🌟 Public Member Functions inherited from SoNode 🌟

  • void setOverride (const SbBool state) — sets the override state 💜
  • SbBool isOverride (void) const — asks whether override is on 🙋
  • void setNodeType (const NodeType type) — sets the node type 🏷️
  • NodeType getNodeType (void) const — reads back the node type 🔍
  • virtual SoNode * copy (SbBool copyconnections=FALSE) const — copies the node, with copyconnections defaulting to FALSE 📋
  • virtual SbBool affectsState (void) const — whether this node messes with state 🫧
  • virtual void GLRenderBelowPath (SoGLRenderAction *action) — render, below-path flavour 🌊
  • virtual void GLRenderInPath (SoGLRenderAction *action) — render, in-path flavour 🛤️
  • virtual void GLRenderOffPath (SoGLRenderAction *action) — render, off-path flavour 🚫
  • virtual void getBoundingBox (SoGetBoundingBoxAction *action) — bounding box time 📦
  • virtual void getMatrix (SoGetMatrixAction *action) — matrix time 🧮
  • virtual void handleEvent (SoHandleEventAction *action) — event handling 🎪
  • virtual void rayPick (SoRayPickAction *action) — ray picking 🕹️
  • virtual void search (SoSearchAction *action) — search 🔎
  • virtual void write (SoWriteAction *action) — write ✍️
  • virtual void audioRender (SoAudioRenderAction *action) — audio render 🔊
  • virtual void grabEventsSetup (void) — sets up event grabbing 🫴
  • virtual void grabEventsCleanup (void) — cleans up event grabbing 🧹
  • virtual void startNotify (void) — kicks off notification 📣
  • virtual void notify (SoNotList *l) — notifies 🛎️
  • SbUniqueId getNodeId (void) const — the node's unique id 🆔
  • virtual SoChildList * getChildren (void) const — the children list 👶
  • virtual void writeInstance (SoOutput *out) — writes the instance 📤
  • virtual SoNode * addToCopyDict (void) const — adds to the copy dictionary 🗂️
  • virtual void copyContents (const SoFieldContainer *from, SbBool copyconnections) — copies contents over, copyconnections and all 📥
  • virtual SoFieldContainer * copyThroughConnection (void) const — copies through a connection 🔗

🌟 Public Member Functions inherited from SoFieldContainer 🌟

  • void setToDefaults (void) — back to defaults, reset era 🧼
  • SbBool hasDefaultValues (void) const — are we at default values? 🤔
  • SbBool fieldsAreEqual (const SoFieldContainer *container) const — field-by-field comparison with container ⚖️
  • void copyFieldValues (const SoFieldContainer *container, SbBool copyconnections=FALSE) — copies field values from container, copyconnections defaults to FALSE 📎
  • SbBool set (const char *const fielddata) — sets from a fielddata string 🧵
  • void get (SbString &fielddata) — reads out into fielddata 📖
  • virtual int getFields (SoFieldList &l) const — grabs the fields into l 🗃️
  • virtual int getAllFields (SoFieldList &l) const — grabs all the fields into l, yes all of them 💯
  • virtual SoField * getField (const SbName &name) const — looks up a field by name 🏷️
  • virtual SoField * getEventIn (const SbName &name) const — looks up an event-in by name 📨
  • virtual SoField * getEventOut (const SbName &name) const — looks up an event-out by name 📮
  • SbBool getFieldName (const SoField *const field, SbName &name) const — gets the name of field into name 🔖
  • SbBool enableNotify (const SbBool flag) — toggles notification with flag 🔔
  • SbBool isNotifyEnabled (void) const — is notification enabled? 🧐
  • SbBool set (const char *fielddata, SoInput *input) — sets from fielddata using an SoInput 📥
  • void get (SbString &fielddata, SoOutput *out) — reads out into fielddata using an SoOutput 📤
  • virtual SbBool validateNewFieldValue (SoField *field, void *newval) — validates a new value for field ✅
  • virtual void addWriteReference (SoOutput *out, SbBool isfromfield=FALSE) — adds a write reference, isfromfield defaults to FALSE 🖇️
  • SbBool getIsBuiltIn (void) const — is it built in? 🏠
  • virtual void getFieldsMemorySize (size_t &managed, size_t &unmanaged) const — reports memory size into managed and unmanaged 🧠
  • void setUserData (void *userdata) const — stashes your userdata 🎒
  • void * getUserData (void) const — gets your userdata back 🎁

🌟 Public Member Functions inherited from SoBase 🌟

  • void ref (void) const — refs her up, refcount goes brrr ⬆️
  • void unref (void) const — unrefs, and may delete 🗑️
  • void unrefNoDelete (void) const — unrefs but doesn't delete, the polite version 🙅
  • int32_t getRefCount (void) const — how many refs we got 🔢
  • void touch (void) — touch her, wake the notification chain up ⚡
  • SbBool isOfType (SoType type) const — Returns TRUE if the type of this object is either of the same type or inherited from type. 👑
  • virtual SbName getName (void) const — the name 🏷️
  • virtual void setName (const SbName &newname) — sets the name to newname ✏️
  • void addAuditor (void *const auditor, const SoNotRec::Type type) — adds an auditor 🕵️
  • void removeAuditor (void *const auditor, const SoNotRec::Type type) — removes an auditor 🚪
  • const SoAuditorList & getAuditors (void) const — the auditor list 📜
  • SbBool shouldWrite (void) — should she write? 🤷
  • void assertAlive (void) const — asserts she's alive, dramatic but necessary 💀

💫 Static Public Member Functions 💫

  • static SoType getClassTypeId (void) — the static SoType for this class 🆔
  • static void initClass (void) — sets up the class, the whole "hey Coin type system, we exist" moment ✨

🌟 Static Public Member Functions inherited from SoNode 🌟

  • static uint32_t getCompatibilityTypes (const SoType &nodetype) — compatibility types for nodetype 🧩
  • static SoType getClassTypeId (void) — the class SoType 🆔
  • static SoNode * getByName (const SbName &name) — look a node up by name 🔎
  • static int getByName (const SbName &name, SoNodeList &l) — look nodes up by name into l 📚
  • static void initClass (void) — Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system. 🛠️
  • static void initClasses (void) — inits all the classes, plural, she's doing overtime 🏭
  • static SbUniqueId getNextNodeId (void) — the next node id, coming right up 🔢
  • static int getActionMethodIndex (const SoType type) — the action method index for type 📇
  • static void getBoundingBoxS (SoAction *action, SoNode *node) — static bounding box helper 📦
  • static void GLRenderS (SoAction *action, SoNode *node) — static GL render helper 🎨
  • static void callbackS (SoAction *action, SoNode *node) — static callback helper 📞
  • static void getMatrixS (SoAction *action, SoNode *node) — static matrix helper 🧮
  • static void handleEventS (SoAction *action, SoNode *node) — static event helper 🎪
  • static void pickS (SoAction *action, SoNode *node) — static pick helper 🎯
  • static void rayPickS (SoAction *action, SoNode *node) — static ray pick helper 🕹️
  • static void searchS (SoAction *action, SoNode *node) — static search helper 🔍
  • static void writeS (SoAction *action, SoNode *node) — static write helper ✍️
  • static void audioRenderS (SoAction *action, SoNode *node) — static audio render helper 🔊
  • static void getPrimitiveCountS (SoAction *action, SoNode *node) — static primitive count helper 🔢

🌟 Static Public Member Functions inherited from SoFieldContainer 🌟

  • static void initClass (void) — Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system. 🛠️
  • static SoType getClassTypeId (void) — This static method returns the SoType object associated with objects of this class. 🆔
  • static void cleanupClass (void) — cleanup duty 🧽
  • static void initCopyDict (void) — sets up the copy dictionary 🗂️
  • static void addCopy (const SoFieldContainer *orig, const SoFieldContainer *copy) — registers copy as the copy of orig 📑
  • static SoFieldContainer * checkCopy (const SoFieldContainer *orig) — checks the copy for orig 🔎
  • static SoFieldContainer * findCopy (const SoFieldContainer *orig, const SbBool copyconnections) — finds the copy of orig, with copyconnections in the mix 🧭
  • static void copyDone (void) — copying is done, wrap it up 🎬

🌟 Static Public Member Functions inherited from SoBase 🌟

  • static void initClass (void) — Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system. 🛠️
  • static SoType getClassTypeId (void) — This static method returns the SoType object associated with objects of this class. 🆔
  • static void addName (SoBase *const base, const char *const name) — adds name for base 🏷️
  • static void removeName (SoBase *const base, const char *const name) — removes name from base ❌
  • static void incrementCurrentWriteCounter (void) — bump the write counter ⬆️
  • static void decrementCurrentWriteCounter (void) — drop the write counter ⬇️
  • static SoBase * getNamedBase (const SbName &name, SoType type) — get the base named name of type 🔍
  • static int getNamedBases (const SbName &name, SoBaseList &baselist, SoType type) — get all the bases named name of type into baselist 📚
  • static SbBool read (SoInput *input, SoBase *&base, SoType expectedtype) — reads into base, expecting expectedtype 📖
  • static void setInstancePrefix (const SbString &c) — sets the instance prefix to c 🔤
  • static void setTraceRefs (SbBool trace) — toggles ref tracing with trace 🐛
  • static SbBool getTraceRefs (void) — reads the ref-tracing setting 🐛
  • static SbBool connectRoute (SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname) — wires a route from fromnodename.fromfieldname to tonodename.tofieldname 🔌
  • static SbBool readRoute (SoInput *input) — reads a route 📥

🍓 Public Attributes 🍓

  • SoMFVec2f point — the multi-field of 2D vectors holding the points. she's the main character here, honestly 👑

🧚 Protected Member Functions 🧚

  • virtual const SoFieldData * getFieldData (void) const — the field data 🗃️
  • virtual ~SoVRMLTextureCoordinate () — the destructor, protected, so don't just delete her directly 🙈

🌟 Protected Member Functions inherited from SoNode 🌟

  • SoNode (void) — the SoNode constructor 🏗️
  • virtual ~SoNode () — the SoNode destructor ⚰️
  • virtual SbBool readInstance (SoInput *in, unsigned short flags) — reads an instance from in with flags 📥

🌟 Protected Member Functions inherited from SoFieldContainer 🌟

  • SoFieldContainer (void) — the SoFieldContainer constructor 🏗️
  • virtual ~SoFieldContainer () — the SoFieldContainer destructor ⚰️

🌟 Protected Member Functions inherited from SoBase 🌟

  • SoBase (void) — the SoBase constructor 🏗️
  • virtual ~SoBase () — the SoBase destructor ⚰️
  • virtual void destroy (void) — destroys her 💥
  • SbBool hasMultipleWriteRefs (void) const — got multiple write refs? 🖇️
  • SbBool writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const — writes the header with isgroup and isengine 🏷️
  • void writeFooter (SoOutput *out) const — writes the footer 🔻
  • virtual const char * getFileFormatName (void) const — the file format name 📄
  • virtual SoNotRec createNotRec (void) — creates a notification record 📝

🦋 Static Protected Member Functions 🦋

  • static const SoFieldData ** getFieldDataPtr (void) — the field data pointer 🗃️

🌟 Static Protected Member Functions inherited from SoNode 🌟

  • static const SoFieldData ** getFieldDataPtr (void) — the field data pointer 🗃️
  • static void setNextActionMethodIndex (int index) — sets the next action method index to index 📇
  • static int getNextActionMethodIndex (void) — reads the next action method index 📇
  • static void incNextActionMethodIndex (void) — bumps the next action method index ⬆️
  • static void setCompatibilityTypes (const SoType &nodetype, const uint32_t bitmask) — sets compatibility types for nodetype with bitmask 🧩

🌟 Static Protected Member Functions inherited from SoBase 🌟

  • static uint32_t getCurrentWriteCounter (void) — reads the current write counter 🔢
  • static void staticDataLock (void) — locks the static data 🔒
  • static void staticDataUnlock (void) — unlocks the static data 🔓

💜 Additional Inherited Members 💜

🌟 Public Types inherited from SoNode 🌟

  • enum NodeType { INVENTOR = 0x0000, VRML1 = 0x0001, VRML2 = 0x0002, INVENTOR_1 = 0x0004, INVENTOR_2_0 = 0x0008, INVENTOR_2_1 = 0x0010, INVENTOR_2_5 = 0x0020, INVENTOR_2_6 = 0x0040, COIN_1_0 = 0x0080, COIN_2_0 = 0x0100, EXTENSION = 0x0200, COIN_2_2 = 0x0400, COIN_2_3 = 0x0800, COIN_2_4 = 0x1000, INVENTOR_5_0 = 0x2000, COIN_2_5 = 0x4000, COIN_3_0 = 0x8000, INVENTOR_6_0 = 0x10000, COIN_4_0 = 0x20000 } — the whole node-type roster, every flag present and accounted for 🌈

🌟 Protected Types inherited from SoBase 🌟

  • enum BaseFlags { IS_ENGINE = 0x01, IS_GROUP = 0x02 } — the base flags 🚩

🌟 Protected Attributes inherited from SoNode 🌟

  • SbUniqueId uniqueId — the unique id 🆔

🌟 Protected Attributes inherited from SoFieldContainer 🌟

  • SbBool isBuiltIn — the built-in flag 🏠

🌟 Static Protected Attributes inherited from SoNode 🌟

  • static SbUniqueId nextUniqueId = 1 — next unique id starts at 1 ✨
  • static int nextActionMethodIndex = 0 — next action method index starts at 0 ✨
💌 that's the end of part 1, bestie — stay tuned, there's more 💖

✨ DETAILED DESCRIPTION ✨

The SoVRMLTextureCoordinate class binds texture coordinates to vertex-based geometry. bestie that's literally its whole job and it does it flawlessly 💅

The detailed class documentation is taken verbatim from the VRML97 standard (ISO/IEC 14772-1:1997). It is copyright The Web3D Consortium, and is used by permission of the Consortium:

TextureCoordinate {
  exposedField MFVec2f point  []      # (-inf, inf)
}

The TextureCoordinate node specifies a set of 2D texture coordinates used by vertex-based geometry nodes (e.g., SoVRMLIndexedFaceSet and SoVRMLElevationGrid) to map textures to vertices. Textures are two dimensional colour functions that, given an (s, t) coordinate, return a colour value colour(s, t). Texture map values (SoVRMLImageTexture, SoVRMLMovieTexture, and SoVRMLPixelTexture) range from [0.0, 1.0] along the S-axis and T-axis. However, TextureCoordinate values, specified by the point field, may be in the range (-inf,inf). Texture coordinates identify a location (and thus a colour value) in the texture map. The horizontal coordinate s is specified first, followed by the vertical coordinate t.

If the texture map is repeated in a given direction (S-axis or T-axis), a texture coordinate C (s or t) is mapped into a texture map that has N pixels in the given direction as follows:

Texture map location = (C - floor(C)) × N

If the texture map is not repeated, the texture coordinates are clamped to the 0.0 to 1.0 range as follows:

Texture map location = N, if C > 1.0,
                     = 0.0, if C < 0.0,
                     = C × N, if 0.0 <= C <= 1.0.

Details on repeating textures are specific to texture map node types described in SoVRMLImageTexture, SoVRMLMovieTexture, and SoVRMLPixelTexture.

🎀 CONSTRUCTOR & DESTRUCTOR DOCUMENTATION 🎀

SoVRMLTextureCoordinate::SoVRMLTextureCoordinate (void )

Constructor. it's giving new-beginning energy ✨

SoVRMLTextureCoordinate::~SoVRMLTextureCoordinate () [protected], [virtual]

Destructor. bye bestie 🦋

💖 MEMBER FUNCTION DOCUMENTATION 💖

SoType SoVRMLTextureCoordinate::getClassTypeId (void ) [static]

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

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

Returns the type identification of an object derived from a class inheriting SoBase. This is used for runtime type checking and "downward" casting.

Implements SoBase.

const SoFieldData ** SoVRMLTextureCoordinate::getFieldDataPtr (void ) [static], [protected]

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer. iykyk 🙈

Returns the SoFieldData class which holds information about fields in this node.

const SoFieldData * SoVRMLTextureCoordinate::getFieldData (void ) const [protected], [virtual]

Returns a pointer to the class-wide field data storage object for this instance. If no fields are present, returns NULL.

Reimplemented from SoFieldContainer.

void SoVRMLTextureCoordinate::initClass (void ) [static]

void SoVRMLTextureCoordinate::doAction (SoAction * action) [virtual]

This function performs the typical operation of a node for any action.

Reimplemented from SoNode.

void SoVRMLTextureCoordinate::callback (SoCallbackAction * action) [virtual]

Action method for SoCallbackAction.

Simply updates the state according to how the node behaves for the render action, so the application programmer can use the SoCallbackAction for extracting information about the scene graph.

Reimplemented from SoNode.

void SoVRMLTextureCoordinate::GLRender (SoGLRenderAction * action) [virtual]

Action method for the SoGLRenderAction.

This is called during rendering traversals. Nodes influencing the rendering state in any way or want to throw geometry primitives at OpenGL override this method.

Reimplemented from SoNode.

void SoVRMLTextureCoordinate::pick (SoPickAction * action) [virtual]

Action method for SoPickAction.

Does common processing for SoPickAction action instances.

Reimplemented from SoNode.

void SoVRMLTextureCoordinate::getPrimitiveCount (SoGetPrimitiveCountAction * action) [virtual]

Action method for the SoGetPrimitiveCountAction.

Calculates the number of triangle, line segment and point primitives for the node and adds these to the counters of the action.

Nodes influencing how geometry nodes calculate their primitive count also override this method to change the relevant state variables.

Reimplemented from SoNode.

🌈 MEMBER DATA DOCUMENTATION 🌈

SoMFVec2f SoVRMLTextureCoordinate::point

The texture coordinates. Empty by default.

👑 AUTHOR 👑

Generated automatically by Doxygen for Coin from the source code.

okay that's the whole page, bestie, you made it to the end 🫶 this was Coin Version 4.0.10, dated Thu Jun 25 2026 00:00:00 — so yeah, SoVRMLTextureCoordinate(3) is officially a wrap. go map some textures, you absolute icon 💅✨

📦 where this page comes from