Printable Version

Table of Contents

1. Introduction
2. Features
3. Overview
4. Specification
   1. General Layout
   2. Materials
   3. Shapes
   4. Dynamics
   5. Scenegraph
   6. Animation

Introduction

I3D is an eXtensible Markup Language (XML) file format.

A vaild I3D file has up to seven parts: Textures, Materials, Shapes, Dynamics, Scene graph, Animation and Userdata. Dependent on application each part can be omitted.

The XML Schema language is used to describe the I3D feature set. Download: I3D 1.6 Schema

Features

• Scenegraph hierarchy with
  • TransformGroups/Bones: translation, rotation, scale and visibility
  • Lights: ambient, point, directional and spot lights
  • Cameras: field of view, near and far clipping plane
  • Shapes: meshes and nurbs curves (supports geometry instancing)
  • Particle Systems
• Animation
  • Animation sets
  • Clips
  • Keyframes: translation, rotation, scale and visibility
  • Morph Targets
• User Attributes
• Dynamics
  • Particle Systems (Sprite based)
    • Surface Emitter
    • Gravity Fields
    • Air Fields
• Meshes
  • Vertices
  • Normals
  • Vertex colors
  • Skin weights
  • Texture coordinates (including multiple uv sets)
  • Faces (vertex color, normals and texture coordinates per face)
• Curves
  • Nurbscurves
• Shader/Materials
  • Multitextures (arbitrary layered textures)
  • Lightmaps
  • Bumpmaps/Normalmaps
  • Environmentmaps
  • Specularmaps

Overview

Specification

General Layout

Coordinate Systems

I3D uses a right-handed coordinate system.

Files

All used file references are defined here. File handles are mapped to the corresponding filenames.

Materials

Materials used in the materials attribute of Shape nodes within the scenegraph section are defined in this section.

Shapes

Shapes are defined here and referenced from the scene graph section. This mechanism allows multiple instancing of shapes.

Dynamics

Dynamic objects are defined in this part and referenced from the Scene graph section.

Scenegraph

The Scene graph hierarchy (transformations, bones, joints, shapes, lights, cameras and particle systems) are stored in this section. Shapes, materials and particle systems are stored as references.

Scene graph node types

TransformGroup

Attribute	Description	Type	Optional
name	Name of TransformGroup	string	no
translation	Translation	complex	yes
rotation	Rotation, euler order ZY'X''	complex	yes
scale	Scale	complex	yes
visibility	Visibility	boolean	yes
kinematic	Kinematic object	boolean	yes
dynamic	Dynamic object	boolean	yes
static	Static object	boolean	yes
compound	Compound parent	boolean	yes
compoundChild	Compound child	boolean	yes
collision	Enable collision	boolean	yes
ccd	Continuous collision detection	boolean	yes
trigger	Trigger	boolean	yes
cloth	Cloth	boolean	yes
restitution	Restitution	float	yes
staticFriction	Static friction	float	yes
dynamicFriction	Dynamic friction	float	yes
skinWidth	Skin width	float	yes
density	Density	float	yes
collisionMask	Collision mask	integer	yes
joint	Joint	boolean	yes
breakableJoint	Breakable joint	boolean	yes
jointBreakForce	Joint break force	double	yes
jointBreakTorque	Joint break torque	double	yes
projection	Enable joint projection	boolean	yes
xAxisDrive	Enable x axis drive	boolean	yes
yAxisDrive	Enable y axis drive	boolean	yes
zAxisDrive	Enable z axis drive	boolean	yes
drivePos	Enable drive position	boolean	yes
projDistance	Projection distance	double	yes
driveForceLimit	Drive force limit	double	yes
driveSpring	Drive spring	double	yes
driveSpring	Drive spring	double	yes
solverIterationCount	Solver iteration count	integer	yes
rotMinX	Rotation minimum x	double	yes
rotMinY	Rotation minimum y	double	yes
rotMinZ	Rotation minimum z	double	yes
rotMaxX	Rotation maximum x	double	yes
rotMaxY	Rotation maximum y	double	yes
rotMaxZ	Rotation maximum z	double	yes
transMinX	Translation minimum x	double	yes
transMinY	Translation minimum y	double	yes
transMinZ	Translation minimum z	double	yes
transMaxX	Translation maximum x	double	yes
transMaxY	Translation maximum y	double	yes
transMaxZ	Translation maximum z	double	yes
objectMask	Object mask	integer	yes
nodeId	Node reference id, used for Animation and UserAttributes section	integer	no

Element	Description	Type	Cardinality
TransformGroup	Transform group node	complex	0..N
Shape	Shape node	complex	0..N
Camera	Camera node	complex	0..N
Light	Light node	complex	0..N
Dynamic	Dynamic node (eg. particle system)	complex	0..N

Shape

Attribute	Description	Type	Optional
shapeId	Shape reference id (reference to shapes section)	string	no
materialIds	List of used material ids (reference to materials section)	string	no
skinBindNodeIds	Skin bind node ids	string	yes
castsShadows	Casts shadows	boolean	yes
receiveShadows	Receive shadows	boolean	yes
clipDistance	Clip distance	double	yes
nonRenderable	Non renderable	boolean	yes

Camera

Attribute	Description	Type	Optional
fov	Field of view	double	no
nearClip	Near clipping plane	double	no
farClip	Far clipping plane	double	no

Light

Attribute	Description	Type	Optional
type	Light type	string	no
diffuseColor	Diffuse color	complex	yes
emitDiffuse	Emit diffuse	string	yes
specularColor	Specular color	complex	yes
emitSpecular	Emit specular	string	yes
castShadowMap	Cast shadow Map	boolean	yes
depthMapBias	Depth map bias	double	yes
depthMapResolution	Depth map resolution	integer	yes
shadowFarDistance	Shadow far fistance	double	yes
shadowTextureOffset	Shadow texture offset	double	yes
shadowExtrusionDistance	Shadow extrusion distance	double	yes
decayRate	Decay rate	integer	yes
coneAngle	coneAngle	double	yes
dropOff	dropOff	integer	yes
projTexture	Projective texture name	string	yes
range	Range	double	no

5 Dynamic

Attribute	Description	Type	Optional
dynamicId	Dynamic id (reference to dynamics section)	string	no

Example

Animation

Motions are defined in this part. Clips are the basic building block and allow Non-Linear Animation by composing multiple clips.