Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

								SoMFVec3f(3IV)

NAME
     SoMFVec3f (SoMVec3f) - multiple-value field containing any number of
     three-dimensional vectors

INHERITS FROM
     SoField > SoMField > SoMFVec3f

SYNOPSIS
     #include <Inventor_c/fields/SoMFVec3f.h>

     typedef SoMFVec3f	 SoMVec3f

	  Functions from class SoMFVec3f:

     void		 SoMVec3fSetXYZs(SoMVec3f *this, int start, int num,
			      const float xyz[][3])
     void		 SoMVec3fSet1X_Y_Z(SoMVec3f *this, int index, float x,
			      float y, float z)
     void		 SoMVec3fSet1XYZ(SoMVec3f *this, int index, const
			      float xyz[3])
     void		 SoMVec3fSetX_Y_Z(SoMVec3f *this, float x, float y,
			      float z)
     void		 SoMVec3fSetXYZ(SoMVec3f *this, const float xyz[3])
     SoType		 SoMVec3fGetClassTypeId()
     void		 SoMVec3fGetTypeId(const SoMVec3f *this)
     const SbVec3f *	 SoMVec3fGet(const SoMVec3f *this, int i)
     const SbVec3f *	 SoMVec3fGetN(const SoMVec3f *this, int start)
     int		 SoMVec3fFind(SoMVec3f *this, const SbVec3f *
			      targetValue, SbBool addIfNotFound = FALSE)
     void		 SoMVec3fSetN(SoMVec3f *this, int start, int num,
			      const SbVec3f *newValues)
     void		 SoMVec3fSet1(SoMVec3f *this, int index, const SbVec3f
			      * newValue)
     void		 SoMVec3fSet(SoMVec3f *this, const SbVec3f * newValue)
     int		 SoMVec3fIsEq(const SoMVec3f *this, const SoMFVec3f
			      *f)
     int		 SoMVec3fIsNEq(const SoMVec3f *this, const SoMFVec3f
			      *f)
     SbVec3f *		 SoMVec3fStartEdit(SoMVec3f *this)
     void		 SoMVec3fFinishEdit(SoMVec3f *this)

	  Functions from class SoMField:

     int		 SoMVec3fGetNum(const SoMVec3f *this)
     void		 SoMVec3fSetNum(SoMVec3f *this, int num)
     void		 SoMVec3fDel(SoMVec3f *this, int start, int num = -1)
     void		 SoMVec3fInsertSpace(SoMVec3f *this, int start, int
			      num)
     void		 SoMVec3fGet1(SoMVec3f *this, int index, SbString
			      *valueString)

	  Functions from class SoField:

Page 1

SoMFVec3f(3IV)

     void		 SoMVec3fSetIgnored(SoMVec3f *this, SbBool ignore)
     SbBool		 SoMVec3fIsIgnored(const SoMVec3f *this)
     SbBool		 SoMVec3fIsDflt(const SoMVec3f *this)
     SbBool		 SoMVec3fIsOfType(const SoMVec3f *this, SoType type)
     SbBool		 SoMVec3fSetFromStr(SoMVec3f *this, const char
			      *valueString)
     void		 SoMVec3fGetIntoStr(SoMVec3f *this, SbString
			      *valueString)
     void		 SoMVec3fTouch(SoMVec3f *this)
     SbBool		 SoMVec3fConnFromField(SoMVec3f *this, SoField
			      *fromField)
     SbBool		 SoMVec3fConnFrom(SoMVec3f *this, SoEngineOutput
			      *fromEngine)
     void		 SoMVec3fDisconn(SoMVec3f *this)
     SbBool		 SoMVec3fIsConn(const SoMVec3f *this)
     SbBool		 SoMVec3fIsConnFromField(const SoMVec3f *this)
     SbBool		 SoMVec3fGetConnField(const SoMVec3f *this, SoField
			      **writingField)
     SbBool		 SoMVec3fIsConnFromEngine(const SoMVec3f *this)
     SbBool		 SoMVec3fGetConnEngine(const SoMVec3f *this,
			      SoEngineOutput **engineOutput)
     void		 SoMVec3fEnableConn(SoMVec3f *this, SbBool flag)
     SbBool		 SoMVec3fIsConnEnabled(const SoMVec3f *this)
     int		 SoMVec3fGetForwardConn(const SoMVec3f *this,
			      SoFieldList *list)
     SoFieldContainer *	 SoMVec3fGetContainer(const SoMVec3f *this)

DESCRIPTION
     A multiple-value field that contains any number of three-dimensional
     vectors.

     SoMFVec3fs are written to file as one or more triples of floating point
     values separated by whitespace.

     When more than one value is present, all of the values are enclosed in
     square brackets and separated by commas; for example:

	  [ 0 0 0, 1.2 3.4 5.6, 98.6 -4e1 212 ]

FUNCTIONS
     void		 SoMVec3fSetXYZs(SoMVec3f *this, int start, int num,
			      const float xyz[][3])
	  Sets num values starting at index start to the given floating point
	  values. There must be num*3 values in the passed array.

     void		 SoMVec3fSet1X_Y_Z(SoMVec3f *this, int index, float x,
			      float y, float z)
     void		 SoMVec3fSet1XYZ(SoMVec3f *this, int index, const
			      float xyz[3])

Page 2

								SoMFVec3f(3IV)

	  Set the index'th value to the given floating point values.

     void		 SoMVec3fSetX_Y_Z(SoMVec3f *this, float x, float y,
			      float z)
     void		 SoMVec3fSetXYZ(SoMVec3f *this, const float xyz[3])
	  Sets the field to contain the given value and only the given value
	  (if the array had multiple values before, they are deleted).

     SoType		 SoMVec3fGetClassTypeId()
     void		 SoMVec3fGetTypeId(const SoMVec3f *this)
	  Returns the type for this class or a particular object of this
	  class.

     const SbVec3f *	 SoMVec3fGet(const SoMVec3f *this, int i)
	  Returns the i'th value of the field. Indexing past the end of the
	  field (passing in i greater than getNum()) will return garbage.

     const SbVec3f *	 SoMVec3fGetN(const SoMVec3f *this, int start)
	  Returns a pointer into the array of values in the field, starting at
	  index start. The values are read-only; see the
	  startEditing()/finishEditing() methods for a way of modifying values
	  in place.

     int		 SoMVec3fFind(SoMVec3f *this, const SbVec3f *
			      targetValue, SbBool addIfNotFound = FALSE)
	  Finds the given value in the array and returns the index of that
	  value in the array. If the value is not found, -1 is returned. If
	  addIfNotFound is set, then targetValue is added to the end of the
	  array (but -1 is still returned).

     void		 SoMVec3fSetN(SoMVec3f *this, int start, int num,
			      const SbVec3f *newValues)
	  Sets num values starting at index start to the values in newValues.
	  The array will be automatically be made larger to accomodate the new
	  values, if necessary.

     void		 SoMVec3fSet1(SoMVec3f *this, int index, const SbVec3f
			      * newValue)
	  Sets the index'th value in the array to newValue. The array will be
	  automatically expanded, if necessary.

     void		 SoMVec3fSet(SoMVec3f *this, const SbVec3f * newValue)
	  Sets the first value in the array to newValue, and deletes the
	  second and subsequent values.

     int		 SoMVec3fIsEq(const SoMVec3f *this, const SoMFVec3f
			      *f)
     int		 SoMVec3fIsNEq(const SoMVec3f *this, const SoMFVec3f
			      *f)
	  Returns TRUE if all of the values of this field equal (do not equal)
	  the given field. If the fields are different types FALSE will always
	  be returned (even if one field is an SoMFFloat with one value of 1.0

Page 3

SoMFVec3f(3IV)

	  and the other is an SoMFInt with a value of 1, for example).

     SbVec3f *		 SoMVec3fStartEdit(SoMVec3f *this)
     void		 SoMVec3fFinishEdit(SoMVec3f *this)
	  startEditing() returns a pointer to the internally-maintained array
	  that can be modified. The values in the array may be changed, but
	  values cannot be added or removed. It is illegal to call any other
	  editing methods between StartEdit() and FinishEdit() (e.g. Set1(),
	  Set(), etc).

	  Fields, engines or sensors connected to this field and sensors are
	  not notified that this field has changed until FinishEdit() is
	  called. Calling FinishEdit() always sets the IsDflt flag to FALSE
	  and informs engines and sensors that the field changed, even if none
	  of the values actually were changed.

Page 4

Vote for polarhome