Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SoMFRotation(3IV)()					   SoMFRotation(3IV)()

NAME
       SoMFRotation  --	 Multiple-value	field containing any number of SbRota-
       tions.

INHERITS FROM
       SoField > SoMField > SoMFRotation

SYNOPSIS
       #include	<Inventor/fields/SoMFRotation.h>

	  Methods from class SoMFRotation:

     void		 set1Value(int index, const SbVec3f &axis,  float  an-
			      gle)
     void		 setValue(const	SbVec3f	&axis, float angle)
     void		 set1Value(int	index,	float  q0, float q1, float q2,
			      float q3)
     void		 set1Value(int index, const float q[4])
     void		 setValue(float	q0, float q1, float q2,	float q3)
     void		 setValue(float	q[4])
     static SoType	 getClassTypeId()
     virtual void	 getTypeId() const
     const SbRotation &	 operator [](int i) const
     const SbRotation *	 getValues(int start) const
     int		 find(const SbRotation & targetValue, SbBool addIfNot-
			      Found = FALSE)
     void		 setValues(int	start, int num,	const SbRotation *new-
			      Values)
     void		 set1Value(int index, const SbRotation & newValue)
     const SbRotation &	 operator =(const SbRotation & newValue)
     void		 setValue(const	SbRotation & newValue)
     int		 operator ==(const SoMFRotation	&f) const
     int		 operator !=(const SoMFRotation	&f) const
     SbRotation	*	 startEditing()
     void		 finishEditing()

	  Methods from class SoMField:

     int		 getNum() const
     void		 setNum(int num)
     virtual void	 deleteValues(int start, int num = -1)
     virtual void	 insertSpace(int start,	int num)
     SbBool		 set1(int index, const char *valueString)
     void		 get1(int index, SbString &valueString)

	  Methods from class SoField:

     void		 setIgnored(SbBool ignore)
     SbBool		 isIgnored() const
     SbBool		 isDefault() const
     virtual SbBool	 isOfType(SoType type) const
     SbBool		 set(const char	*valueString)
     void		 get(SbString &valueString)
     void		 touch()
     SbBool		 connectFrom(SoField *fromField)
     SbBool		 connectFrom(SoEngineOutput *fromEngine)
     void		 disconnect()
     SbBool		 isConnected() const
     SbBool		 isConnectedFromField()	const
     SbBool		 getConnectedField(SoField *&writingField) const
     SbBool		 isConnectedFromEngine() const
     SbBool		 getConnectedEngine(SoEngineOutput     *&engineOutput)
			      const
     void		 enableConnection(SbBool flag)
     SbBool		 isConnectionEnabled() const
     int		 getForwardConnections(SoFieldList &list) const
     SoFieldContainer *	 getContainer()	const

DESCRIPTION
       multiple-value field that contains any number of	SbRotations.

       SoMFRotations  are written to file as one or more sets of four floating
       point values. Each set of 4 values is an	axis of	rotation  followed  by
       the amount of right-handed rotation about that axis, in radians.

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

	  [ 1 0	0 0, -.707 -.707 0 1.57	]

METHODS
     void		 set1Value(int index, const SbVec3f &axis,  float  an-
			      gle)
	  Sets the index'th value to the given axis/angle.

     void		 setValue(const	SbVec3f	&axis, float angle)
	  Makes	this field have	exactly	one value, given by axis and angle.

     void		 set1Value(int	index,	float  q0, float q1, float q2,
			      float q3)
     void		 set1Value(int index, const float q[4])
	  Sets the index'th value to the given quaternion.

     void		 setValue(float	q0, float q1, float q2,	float q3)
     void		 setValue(float	q[4])
	  Makes	this field have	exactly	one value, given by the	quaternion.

     static SoType	 getClassTypeId()
     virtual void	 getTypeId() const
	  Returns the type for this class  or  a  particular  object  of  this
	  class.

     const SbRotation &	 operator [](int i) const
	  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 SbRotation *	 getValues(int start) const
	  Returns a pointer into the array of values in	the field, starting at
	  index	 start.	 The values are	read-only; see the startEditing()/fin-
	  ishEditing() methods for a way of modifying values in	place.

     int		 find(const SbRotation & targetValue, SbBool addIfNot-
			      Found = 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		 setValues(int start, int num, const SbRotation	 *new-
			      Values)
	  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		 set1Value(int index, const SbRotation & newValue)
	  Sets	the index'th value in the array	to newValue. The array will be
	  automatically	expanded, if necessary.

     const SbRotation &	 operator =(const SbRotation & newValue)
     void		 setValue(const	SbRotation & newValue)
	  Sets the first value in the array to newValue, and deletes the  sec-
	  ond and subsequent values.

     int		 operator ==(const SoMFRotation	&f) const
     int		 operator !=(const SoMFRotation	&f) const
	  Returns TRUE if all of the values of this field equal	(do not	equal)
	  those	of 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 and the other is	an SoMFInt with	a value	of 1, for  ex-
	  ample).

     SbRotation	*	 startEditing()
     void		 finishEditing()
	  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  startEditing()  and	finishEditing()	 (e.g.
	  set1Value(), setValue(), etc).

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

SEE ALSO
       SbRotation

							   SoMFRotation(3IV)()

NAME | INHERITS FROM | SYNOPSIS | DESCRIPTION | METHODS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SoMFRotation&sektion=3iv&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help