- Generated on Sun Aug 12 2012 18:40:48 for Open Inventor Reference by
1.7.4
|
Open Inventor Reference
|
#include <Inventor/system/SbSystem.h>#include <Inventor/fields/SoField.h>#include <Inventor/SoInput.h>#include <Inventor/SoOutput.h>Go to the source code of this file.
Defines | |
| #define | SO__FIELD_HEADER(className) |
| =========================================================================== | |
| #define | SO__SFIELD_RW_HEADER(className) |
| #define | SO__MFIELD_RW_HEADER(className) |
| #define | SO__FIELD_INIT_CLASS(className, classPrintName, parentClass) |
| #define | SO__FIELD_ID_SOURCE(className) |
| #define | SO__FIELD_EQ_SAME_SOURCE(className) |
| #define | SO_SFIELD_REQUIRED_HEADER(className) SO__FIELD_HEADER(className) |
| =========================================================================== | |
| #define | SO_SFIELD_CONSTRUCTOR_HEADER(className) |
| This declares a constructor and destructor for a single-value field class. | |
| #define | SO_SFIELD_VALUE_HEADER(className, valueType, valueRef) |
| This declares value processing methods and variables for a single-value field class. | |
| #define | SO_SFIELD_DERIVED_VALUE_HEADER(className, valueType, valueRef) |
| This is like the above macro, but can be used by a field class derived from another (non-abstract) field class. | |
| #define | SO_SFIELD_HEADER(className, valueType, valueRef) |
| This macro is all that is needed for most single-value field classes. | |
| #define | SO_SFIELD_DERIVED_HEADER(className, valueType, valueRef) |
| This macro is all that is needed for most single-value field classes that are derived from other field classes. | |
| #define | SO_MFIELD_REQUIRED_HEADER(className) SO__FIELD_HEADER(className) |
| =========================================================================== | |
| #define | SO_MFIELD_CONSTRUCTOR_HEADER(className) |
| This declares a constructor and destructor for a multiple-value field class. | |
| #define | SO_MFIELD_VALUE_HEADER(className, valueType, valueRef) |
| This declares value processing methods and variables for a multiple-value field class. | |
| #define | SO_MFIELD_DERIVED_VALUE_HEADER(className, valueType, valueRef) |
| This is like the above macro, but can be used by a field class derived from another (non-abstract) field class. | |
| #define | SO_MFIELD_HEADER(className, valueType, valueRef) |
| This macro is all that is needed for most multiple-value field classes. | |
| #define | SO_MFIELD_DERIVED_HEADER(className, valueType, valueRef) |
| This macro is all that is needed for most multiple-value field classes that are derived from other field classes. | |
| #define | SO_SFIELD_INIT_CLASS(className, parentClass) SO__FIELD_INIT_CLASS(className, SO__QUOTE(className), parentClass) |
| =========================================================================== | |
| #define | SO_SFIELD_REQUIRED_SOURCE(className) |
| This defines the variables and methods declared in SO_SFIELD_REQUIRED_HEADER(). | |
| #define | SO_SFIELD_CONSTRUCTOR_SOURCE(className) |
| This defines the constructor and destructor. | |
| #define | SO_SFIELD_VALUE_SOURCE(className, valueType, valueRef) |
| This defines the variables and methods declared in SO_SFIELD_VALUE_HEADER(). | |
| #define | SO_SFIELD_SOURCE(className, valueType, valueRef) |
| This macro is all that is needed for most single-value field classes. | |
| #define | SO_SFIELD_DERIVED_SOURCE(className, valueType, valueRef) |
| This macro is all that is needed for most single-value field classes that are derived from other field classes. | |
| #define | SO_MFIELD_INIT_CLASS(className, parentClass) SO__FIELD_INIT_CLASS(className, SO__QUOTE(className), parentClass) |
| =========================================================================== | |
| #define | SO_MFIELD_REQUIRED_SOURCE(className) |
| This defines the variables and methods declared in SO_MFIELD_REQUIRED_HEADER(). | |
| #define | SO_MFIELD_CONSTRUCTOR_SOURCE(className) |
| This defines a constructor and destructor that work with the variables and methods defined in SO_MFIELD_VALUE_HEADER(). | |
| #define | SO_MFIELD_DERIVED_CONSTRUCTOR_SOURCE(className) |
| This defines an empty constructor and destructor for classes derived from other field classes, since they inherit value processing. | |
| #define | SO_MFIELD_VALUE_SOURCE(className, valueType, valueRef) |
| This defines the variables and methods declared in SO_MFIELD_VALUE_HEADER(). | |
| #define | SO_MFIELD_ALLOC_SOURCE(className, valueType) |
| This allocates/reallocates room for values, using the "new" and "delete" operators, so the constructor and destructor are called for new and deleted values. | |
| #define | SO_MFIELD_MALLOC_SOURCE(className, valueType) |
| This allocates/reallocates room for values, using malloc() and realloc(). | |
| #define | SO_MFIELD_SOURCE(className, valueType, valueRef) |
| This macro is all that is needed for most multiple-value field classes. | |
| #define | SO_MFIELD_SOURCE_MALLOC(className, valueType, valueRef) |
| This is like the above macro, but uses the allocation macro that uses malloc() and realloc(). | |
| #define | SO_MFIELD_DERIVED_SOURCE(className, valueType, valueRef) |
| This macro is all that is needed for most multiple-value field classes that are derived from other field classes. | |
| #define SO__FIELD_EQ_SAME_SOURCE | ( | className | ) |
\ void \ className::copyFrom(const SoField &f) \ { \ *this = * (const className *) &f; \ } \ \ SbBool \ className::isSame(const SoField &f) const \ { \ return (getTypeId() == f.getTypeId() && \ (*this) == (const className &) f); \ }
Definition at line 196 of file SoSubField.h.
| #define SO__FIELD_HEADER | ( | className | ) |
public: \ virtual SoType getTypeId() const; \ static SoType getClassTypeId() { return classTypeId; } \ \ /* Copy from another field of same type */ \ const className & operator =(const className &f); \ \ SoINTERNAL public: \ /* Copy from another field of unknown type (assumed to be same type) */ \ virtual void copyFrom(const SoField &f); \ \ static void * createInstance(); /* for SoType */ \ \ /* Returns TRUE if fields are same type and have same values */ \ virtual SbBool isSame(const SoField &f) const; \ \ private: \ static SoType classTypeId
These are all internal macros used by some of the public ones.
===========================================================================
Definition at line 140 of file SoSubField.h.
| #define SO__FIELD_ID_SOURCE | ( | className | ) |
\ SoType className::classTypeId; \ \ SoType \ className::getTypeId() const \ { \ return classTypeId; \ } \ void * \ className::createInstance() \ { \ return (void *)(new className); \ }
Definition at line 181 of file SoSubField.h.
| #define SO__FIELD_INIT_CLASS | ( | className, | |
| classPrintName, | |||
| parentClass | |||
| ) |
classTypeId = SoType::createType(parentClass::getClassTypeId(), \ classPrintName, \ &className::createInstance)
Definition at line 176 of file SoSubField.h.
| #define SO__MFIELD_RW_HEADER | ( | className | ) |
private: \ /* Reads indexed value of field from file */ \ virtual SbBool read1Value(SoInput *in, int index); \ \ /* Writes one (indexed) value to file */ \ virtual void write1Value(SoOutput *out, int index) const
Definition at line 168 of file SoSubField.h.
| #define SO__SFIELD_RW_HEADER | ( | className | ) |
private: \ /* Reads value of field from file */ \ virtual SbBool readValue(SoInput *in); \ \ /* Writes value of field to file */ \ virtual void writeValue(SoOutput *out) const
Definition at line 160 of file SoSubField.h.
| #define SO_MFIELD_ALLOC_SOURCE | ( | className, | |
| valueType | |||
| ) |
void \ className::allocValues(int newNum) \ { \ if (values == NULL) { \ if (newNum > 0) \ values = new valueType[newNum]; \ } \ else { \ valueType *oldValues = values; \ int i; \ \ if (newNum > 0) { \ values = new valueType[newNum]; \ for (i = 0; i < num && i < newNum; i++) \ values[i] = oldValues[i]; \ } \ else \ values = NULL; \ delete [] oldValues; \ } \ \ num = maxNum = newNum; \ }
Definition at line 702 of file SoSubField.h.
| #define SO_MFIELD_CONSTRUCTOR_HEADER | ( | className | ) |
public: \ className(); \ virtual ~className()
Definition at line 327 of file SoSubField.h.
| #define SO_MFIELD_CONSTRUCTOR_SOURCE | ( | className | ) |
\
className::className() \
{ \
values = NULL; \
} \
\
className::~className() \
{ \
deleteAllValues(); \
}
If you define your own value processing differently, you may not be able to use these.
Definition at line 578 of file SoSubField.h.
| #define SO_MFIELD_DERIVED_CONSTRUCTOR_SOURCE | ( | className | ) |
\
className::className() \
{ \
} \
\
className::~className() \
{ \
}
Definition at line 598 of file SoSubField.h.
| #define SO_MFIELD_DERIVED_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_MFIELD_REQUIRED_HEADER(className); \ SO_MFIELD_CONSTRUCTOR_HEADER(className); \ SO_MFIELD_DERIVED_VALUE_HEADER(className, valueType, valueRef)
It includes the relevant macros.
Definition at line 429 of file SoSubField.h.
| #define SO_MFIELD_DERIVED_SOURCE | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_MFIELD_REQUIRED_SOURCE(className); \ SO_MFIELD_DERIVED_CONSTRUCTOR_SOURCE(className)
It includes the relevant macros.
Definition at line 792 of file SoSubField.h.
| #define SO_MFIELD_DERIVED_VALUE_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO__MFIELD_RW_HEADER(className); \ public: \ /* Since = operator is not inherited, we redefine it here */ \ valueRef operator =(valueRef newValue) \ { setValue(newValue); return newValue; }
It will inherit most of the field processing stuff.
Definition at line 402 of file SoSubField.h.
| #define SO_MFIELD_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_MFIELD_REQUIRED_HEADER(className); \ SO_MFIELD_CONSTRUCTOR_HEADER(className); \ SO_MFIELD_VALUE_HEADER(className, valueType, valueRef)
It includes the relevant macros.
Definition at line 416 of file SoSubField.h.
| #define SO_MFIELD_INIT_CLASS | ( | className, | |
| parentClass | |||
| ) | SO__FIELD_INIT_CLASS(className, SO__QUOTE(className), parentClass) |
Macros to be called within the source file for a multiple-value field subclass:
===========================================================================
This initializes type identifer variables. It should be called from within initClass().
Definition at line 545 of file SoSubField.h.
| #define SO_MFIELD_MALLOC_SOURCE | ( | className, | |
| valueType | |||
| ) |
void \ className::allocValues(int newNum) \ { \ if (values == NULL) { \ if (newNum > 0) \ values = (valueType *) malloc(sizeof(valueType) * newNum); \ } \ else { \ if (newNum > 0) \ values = (valueType *) realloc(values, sizeof(valueType)*newNum); \ else { \ free((char *) values); \ values = NULL; \ } \ } \ \ num = maxNum = newNum; \ }
This means that constructors and destructors will NOT be called for values. Therefore, this macro should not be used for any value types that have constructors or destructors! (It is used for fields that have simple types, like shorts and floats.)
Definition at line 737 of file SoSubField.h.
| #define SO_MFIELD_REQUIRED_HEADER | ( | className | ) | SO__FIELD_HEADER(className) |
Macros to be called within the class definition header for a multiple-value field subclass:
===========================================================================
This declares all header info required for a multiple-value field class.
Definition at line 318 of file SoSubField.h.
| #define SO_MFIELD_REQUIRED_SOURCE | ( | className | ) |
\
SO__FIELD_ID_SOURCE(className); \
SO__FIELD_EQ_SAME_SOURCE(className) \
\
const className & \
className::operator =(const className &f) \
{ \
if (f.getNum() < getNum()) \
deleteAllValues(); \
setValues(0, f.getNum(), f.getValues(0)); \
return *this; \
}
Definition at line 555 of file SoSubField.h.
| #define SO_MFIELD_SOURCE | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_MFIELD_REQUIRED_SOURCE(className) \ SO_MFIELD_CONSTRUCTOR_SOURCE(className) \ SO_MFIELD_VALUE_SOURCE(className, valueType, valueRef) \ SO_MFIELD_ALLOC_SOURCE(className, valueType)
It includes the relevant macros, including the allocation macro that uses new and delete.
Definition at line 765 of file SoSubField.h.
| #define SO_MFIELD_SOURCE_MALLOC | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_MFIELD_REQUIRED_SOURCE(className) \ SO_MFIELD_CONSTRUCTOR_SOURCE(className) \ SO_MFIELD_VALUE_SOURCE(className, valueType, valueRef) \ SO_MFIELD_MALLOC_SOURCE(className, valueType)
Definition at line 778 of file SoSubField.h.
| #define SO_MFIELD_VALUE_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
Definition at line 339 of file SoSubField.h.
| #define SO_MFIELD_VALUE_SOURCE | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
Definition at line 615 of file SoSubField.h.
| #define SO_SFIELD_CONSTRUCTOR_HEADER | ( | className | ) |
public: \ className(); \ virtual ~className()
Definition at line 233 of file SoSubField.h.
| #define SO_SFIELD_CONSTRUCTOR_SOURCE | ( | className | ) |
\
className::className() \
{ \
} \
className::~className() \
{ \
}
Definition at line 476 of file SoSubField.h.
| #define SO_SFIELD_DERIVED_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_SFIELD_REQUIRED_HEADER(className); \ SO_SFIELD_CONSTRUCTOR_HEADER(className); \ SO_SFIELD_DERIVED_VALUE_HEADER(className, valueType, valueRef)
It includes the relevant macros.
Definition at line 300 of file SoSubField.h.
| #define SO_SFIELD_DERIVED_SOURCE | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_SFIELD_REQUIRED_SOURCE(className); \ SO_SFIELD_CONSTRUCTOR_SOURCE(className)
It includes the relevant macros.
Definition at line 527 of file SoSubField.h.
| #define SO_SFIELD_DERIVED_VALUE_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO__SFIELD_RW_HEADER(className); \ public: \ /* Since = operator is not inherited, we redefine it here */ \ valueRef operator =(valueRef newValue) \ { setValue(newValue); return value; }
It will inherit most of the field processing stuff.
Definition at line 273 of file SoSubField.h.
| #define SO_SFIELD_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_SFIELD_REQUIRED_HEADER(className); \ SO_SFIELD_CONSTRUCTOR_HEADER(className); \ SO_SFIELD_VALUE_HEADER(className, valueType, valueRef)
It includes the relevant macros.
Definition at line 287 of file SoSubField.h.
| #define SO_SFIELD_INIT_CLASS | ( | className, | |
| parentClass | |||
| ) | SO__FIELD_INIT_CLASS(className, SO__QUOTE(className), parentClass) |
Macros to be called within the source file for a single-value field subclass:
===========================================================================
This initializes type identifer variables. It should be called from within initClass().
Definition at line 448 of file SoSubField.h.
| #define SO_SFIELD_REQUIRED_HEADER | ( | className | ) | SO__FIELD_HEADER(className) |
Macros to be called within the class definition header for a single-value field subclass:
===========================================================================
This declares all header info required for a single-value field class.
Definition at line 224 of file SoSubField.h.
| #define SO_SFIELD_REQUIRED_SOURCE | ( | className | ) |
\
SO__FIELD_ID_SOURCE(className); \
SO__FIELD_EQ_SAME_SOURCE(className) \
\
const className & \
className::operator =(const className &f) \
{ \
setValue(f.getValue()); \
return *this; \
}
Definition at line 458 of file SoSubField.h.
| #define SO_SFIELD_SOURCE | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO_SFIELD_REQUIRED_SOURCE(className); \ SO_SFIELD_CONSTRUCTOR_SOURCE(className); \ SO_SFIELD_VALUE_SOURCE(className, valueType, valueRef)
It includes the relevant macros.
Definition at line 514 of file SoSubField.h.
| #define SO_SFIELD_VALUE_HEADER | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
SO__SFIELD_RW_HEADER(className); \ public: \ /* Get the value */ \ valueRef getValue() const \ { evaluate(); return value; } \ \ /* Set value from a value of the appropriate type */ \ void setValue(valueRef newValue); \ valueRef operator =(valueRef newValue) \ { setValue(newValue); return value; } \ \ /* Equality/inequality test for fields of same type */ \ int operator ==(const className &f) const; \ int operator !=(const className &f) const \ { return ! ((*this) == f); } \ \ protected: \ valueType value
Definition at line 245 of file SoSubField.h.
| #define SO_SFIELD_VALUE_SOURCE | ( | className, | |
| valueType, | |||
| valueRef | |||
| ) |
\ void \ className::setValue(valueRef newValue) \ { \ value = newValue; \ valueChanged(); \ } \ \ int \ className::operator ==(const className &f) const \ { \ return getValue() == f.getValue(); \ }
Definition at line 492 of file SoSubField.h.
1.7.4