A single-value field that contains a mask of bit flags. Nodes that use
this field class define mnemonic names for the bit flags.
SFBitMasks are written to file as one or more mnemonic enumerated
type names, in this format:
( flag1 | flag2 | ... )
If only one flag is used in a mask, the parentheses are
optional. These names differ among uses of this field in various node
classes.
A field containing a single boolean (true or false) value.
SFBools may be written as 0 (representing FALSE), 1,
TRUE, or FALSE.
A single-value field containing a color. SFColors are written to file
as an RGB triple of floating point numbers in standard scientific
notation, in the range 0.0 to 1.0.
A single-value field that contains an enumerated type value. Nodes
that use this field class define mnemonic names for the values.
SFEnums are written to file as a mnemonic enumerated type name. The
name differs among uses of this field in various node classes.
A field that contains one single-precision floating point number.
SFFloats are written to file in standard scientific notation.
A field that contain an uncompressed 2-dimensional color or greyscale
image.
SFImages are written to file as three integers representing the width,
height and number of components in the image, followed by width*height
hexadecimal values representing the pixels in the image, separated by
whitespace. A one-component image will have one-byte hexadecimal
values representing the intensity of the image. For example, 0xFF is
full intensity, 0x00 is no intensity. A two-component image puts the
intensity in the first (high) byte and the transparency in the second
(low) byte. Pixels in a three-component image have the red component
in the first (high) byte, followed by the green and blue components
(so 0xFF0000 is red). Four-component images put the transparency byte
after red/green/blue (so 0x0000FF80 is semi-transparent blue). A value
of 1.0 is completely transparent, 0.0 is completely opaque. Note:
each pixel is actually read as a single unsigned number, so a
3-component pixel with value "0x0000FF" can also be written as "0xFF"
or "255" (decimal). Pixels are specified from left to right, bottom to top. The first
hexadecimal value is the lower left pixel of the image, and the last value
is the upper right pixel.
For example,
1 2 1 0xFF 0x00
is a 1 pixel wide by 2 pixel high greyscale image, with the bottom
pixel white and the top pixel black. And:
2 4 3 0xFF0000 0xFF00 0 0 0 0 0xFFFFFF 0xFFFF00
is a 2 pixel wide by 4 pixel high RGB image, with the bottom left
pixel red, the bottom right pixel green, the two middle rows of pixels
black, the top left pixel white, and the top right pixel yellow.
A field containing a single long (32-bit) integer.
SFLongs are written to file as an integer in decimal, hexadecimal
(beginning with '0x') or octal (beginning with '0') format.
A field containing a transformation matrix.
SFMatrices are written to file in row-major order as 16 floating point
numbers separated by whitespace. For example, a matrix expressing a
translation of 7.3 units along the X axis is written as:
1 0 0 0 0 1 0 0 0 0 1 0 7.3 0 0 1
A field containing an arbitrary rotation. SFRotations are written to
file as four floating point values separated by whitespace. The 4
values represent an axis of rotation followed by the amount of
right-handed rotation about that axis, in radians. For example, a 180
degree rotation about the Y axis is:
0 1 0 3.14159265
A field containing an ASCII string (sequence of characters).
SFStrings are written to file as a sequence of ASCII characters in
double quotes (optional if the string doesn't contain any
whitespace). Any characters (including newlines) may appear within
the quotes. To include a double quote character within the string,
precede it with a backslash. For example:
Testing
"One, Two, Three"
"He said, \"Immel did it!\""
are all valid strings.
Field containing a two-dimensional vector. SFVec2fs are written to
file as a pair of floating point values separated by whitespace.
Field containing a three-dimensional vector. SFVec3fs are written to
file as three floating point values separated by whitespace.