.TH "SoPrimitiveVertex" 3 "Tue Dec 26 2023 17:59:22" "Version 4.0.2" "Coin" \" -*- nroff -*- .ad l .nh .SH NAME SoPrimitiveVertex \- The \fBSoPrimitiveVertex\fP class represents a single vertex of a generated primitive\&. .SH SYNOPSIS .br .PP .PP \fC#include \fP .SS "Public Member Functions" .in +1c .ti -1c .RI "\fBSoPrimitiveVertex\fP (\fBvoid\fP)" .br .ti -1c .RI "\fBSoPrimitiveVertex\fP (\fBconst\fP \fBSoPrimitiveVertex\fP &\fBpv\fP)" .br .ti -1c .RI "\fB~SoPrimitiveVertex\fP (\fBvoid\fP)" .br .ti -1c .RI "\fBSoPrimitiveVertex\fP & \fBoperator=\fP (\fBconst\fP \fBSoPrimitiveVertex\fP &\fBpv\fP)" .br .ti -1c .RI "\fBconst\fP \fBSbVec3f\fP & \fBgetPoint\fP (\fBvoid\fP) \fBconst\fP" .br .ti -1c .RI "\fBconst\fP \fBSbVec3f\fP & \fBgetNormal\fP (\fBvoid\fP) \fBconst\fP" .br .ti -1c .RI "\fBconst\fP \fBSbVec4f\fP & \fBgetTextureCoords\fP (\fBvoid\fP) \fBconst\fP" .br .ti -1c .RI "int \fBgetMaterialIndex\fP (\fBvoid\fP) \fBconst\fP" .br .ti -1c .RI "uint32_t \fBgetPackedColor\fP (\fBvoid\fP) \fBconst\fP" .br .ti -1c .RI "\fBconst\fP \fBSoDetail\fP * \fBgetDetail\fP (\fBvoid\fP) \fBconst\fP" .br .ti -1c .RI "\fBvoid\fP \fBsetPoint\fP (\fBconst\fP \fBSbVec3f\fP &\fBpt\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetPoint\fP (float x, float y, float z)" .br .ti -1c .RI "\fBvoid\fP \fBsetNormal\fP (\fBconst\fP \fBSbVec3f\fP &\fBn\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetNormal\fP (float \fBnx\fP, float \fBny\fP, float \fBnz\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetTextureCoords\fP (\fBconst\fP \fBSbVec2f\fP &\fBtex\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetTextureCoords\fP (float \fBtx\fP, float \fBty\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetTextureCoords\fP (\fBconst\fP \fBSbVec3f\fP &\fBtex\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetTextureCoords\fP (float \fBtx\fP, float \fBty\fP, float \fBtz\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetTextureCoords\fP (\fBconst\fP \fBSbVec4f\fP &\fBtex\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetTextureCoords\fP (float \fBtx\fP, float \fBty\fP, float \fBtz\fP, float \fBtw\fP)" .br .ti -1c .RI "\fBvoid\fP \fBsetMaterialIndex\fP (int index)" .br .ti -1c .RI "\fBvoid\fP \fBsetPackedColor\fP (uint32_t rgba)" .br .ti -1c .RI "\fBvoid\fP \fBsetDetail\fP (\fBSoDetail\fP *d)" .br .in -1c .SH "Detailed Description" .PP The \fBSoPrimitiveVertex\fP class represents a single vertex of a generated primitive\&. Instances of \fBSoPrimitiveVertex\fP are constructed when generating primitive data, primarily during an \fBSoCallbackAction\fP traversal\&. Depending on the context the vertex could represent a single 3D point, one of the two vertices in a line or one of the three vertices in a triangle\&. .SH "Constructor & Destructor Documentation" .PP .SS "SoPrimitiveVertex::SoPrimitiveVertex (\fBvoid\fP)" Default constructor, sets up a 'void' instance\&. .SS "SoPrimitiveVertex::SoPrimitiveVertex (\fBconst\fP \fBSoPrimitiveVertex\fP & pv)" Copy constructor\&. Does a shallow copy\&. .PP \fBSee also\fP .RS 4 \fBSoPrimitiveVertex::operator=()\fP .RE .PP .SS "SoPrimitiveVertex::~SoPrimitiveVertex (\fBvoid\fP)" Destructor\&. The detail instance is owned by client code and will not be destructed here\&. .SH "Member Function Documentation" .PP .SS "\fBSoPrimitiveVertex\fP & SoPrimitiveVertex::operator= (\fBconst\fP \fBSoPrimitiveVertex\fP & pv)" Copy operator\&. .PP When \fIpv\fP is copied into this instance, a \fIshallow\fP copy is made\&. I\&.e\&., only the reference to the detail instance is copied (if any), not the detail itself\&. .SS "\fBconst\fP \fBSbVec3f\fP & SoPrimitiveVertex::getPoint (\fBvoid\fP) const\fC [inline]\fP" Returns vertex coordinates, positioned in object space\&. .SS "\fBconst\fP \fBSbVec3f\fP & SoPrimitiveVertex::getNormal (\fBvoid\fP) const\fC [inline]\fP" Returns normal vector, oriented in object space\&. .SS "\fBconst\fP \fBSbVec4f\fP & SoPrimitiveVertex::getTextureCoords (\fBvoid\fP) const\fC [inline]\fP" Returns texture coordinates for vertex, specified in object space\&. .SS "int SoPrimitiveVertex::getMaterialIndex (\fBvoid\fP) const\fC [inline]\fP" Returns index of the vertex into the currently active material, if any\&. .SS "uint32_t SoPrimitiveVertex::getPackedColor (\fBvoid\fP) const\fC [inline]\fP" Returns the RGBA packed color for the given vertex\&. .PP \fBSince\fP .RS 4 Coin \fB3\&.0\fP .RE .PP .SS "\fBconst\fP \fBSoDetail\fP * SoPrimitiveVertex::getDetail (\fBvoid\fP) const\fC [inline]\fP" Returns pointer to detail instance with more information about the vertex\&. A detail instance may not be available, and if so \fCNULL\fP is returned\&. .SS "\fBvoid\fP SoPrimitiveVertex::setPoint (\fBconst\fP \fBSbVec3f\fP & pt)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setPoint (float x, float y, float z)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setNormal (\fBconst\fP \fBSbVec3f\fP & n)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setNormal (float nx, float ny, float nz)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setTextureCoords (\fBconst\fP \fBSbVec2f\fP & texcoords)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .PP Convenience function\&. Will fill in 0 and 1 in the last two texture coordinates in the internal \fBSbVec4f\fP texture coordinate instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setTextureCoords (float tx, float ty)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .PP Convenience function\&. Will fill in 0 and 1 in the last two texture coordinates in the internal \fBSbVec4f\fP texture coordinate instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setTextureCoords (\fBconst\fP \fBSbVec3f\fP & texcoords)\fC [inline]\fP" Convenience function\&. Will fill in 1 in the last coordinate\&. .PP This function is an extension for Coin, and it is not available in the original SGI Open Inventor \fBv2\&.1\fP API\&. .br .PP \fBSince\fP .RS 4 Coin \fB2\&.0\fP .RE .PP .SS "\fBvoid\fP SoPrimitiveVertex::setTextureCoords (float tx, float ty, float tz)\fC [inline]\fP" Convenience function\&. Will fill in 1 in the last coordinate\&. .PP This function is an extension for Coin, and it is not available in the original SGI Open Inventor \fBv2\&.1\fP API\&. .br \fBSince\fP .RS 4 Coin \fB2\&.5\fP .RE .PP .SS "\fBvoid\fP SoPrimitiveVertex::setTextureCoords (\fBconst\fP \fBSbVec4f\fP & texcoords)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setTextureCoords (float tx, float ty, float tz, float tw)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .PP This function is an extension for Coin, and it is not available in the original SGI Open Inventor \fBv2\&.1\fP API\&. .br \fBSince\fP .RS 4 Coin \fB2\&.5\fP .RE .PP .SS "\fBvoid\fP SoPrimitiveVertex::setMaterialIndex (int index)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setPackedColor (uint32_t rgba)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .SS "\fBvoid\fP SoPrimitiveVertex::setDetail (\fBSoDetail\fP * detail)\fC [inline]\fP" Used internally from library client code setting up an \fBSoPrimitiveVertex\fP instance\&. .PP Note that it is the client's responsibility to do the deallocation of the detail instance after the \fBSoPrimitiveVertex\fP instance has gone out of scope\&. .SH "Author" .PP Generated automatically by Doxygen for Coin from the source code\&.