Advanced sample programs

Advanced sample program	Description
Common	Functions used by other sample programs to initializing objects, destroying objects, loading scenes, and saving scenes.
MyOwnWriterReader	Functions used by other sample programs to write and read files in a custom file format.
ExportScene01	Creates and exports an animated scene containing a cylinder deformed by a skeleton made of two segments.
ExportScene02	Creates and exports an animated scene containing a sphere morphed by two shapes.
ExportScene03	Creates and exports an animated scene containing a textured cube, and a pyramid with materials mapped on its faces.
ExportScene04	Creates and exports a scene containing a group of lights, a marker, and a camera. The animation rotates the lights and moves the camera.
ExportScene05	In FBX, the position of a node is expressed in coordinates relative to the node’s parent. This example shows how to convert between FBX coordinates and a global coordinate system.
ImportScene	Displays the content of any FBX file.
Layers	Creates a scene containing a cube with layered textures and materials mapped on each of the cube’s faces. Illustrates how to use layers.
UserProperties	Illustrates how to create user properties, attach the properties to a cube, and then animate the properties; how to create a constraint between a pyramid and a cube.
ViewScene	Shows how to evaluate the animation data and compute deformations. This is necessary for displaying the content of any FBX SDK-supported file in a graphical window.Uses the OpenGL Utility Toolkit (GLUT). A menu lets you select the view, the current camera, the current take, etc.

Folders for each of these programs are located in \examples. Each folder contains Visual Studio project files (Windows only) or makefiles (Mac OS or Linux) to help you build and run the program.

Common

The Common folder does not contain a standalone example. All examples use the common.cxx file found within the Common folder to take care of common creation, initialization, loading, and saving methods.

The common.cxx file illustrates common methods for using the FBX SDK including initializing objects, destroying objects, loading scenes, and saving scenes.

MyOwnWriterReader

This sample code shows how to use FBX SDK to write and read files in a custom file format, i.e., a file format not directly supported by FBX SDK. The sample code reads and writes "CustomWriter" files.

The MyOwnWriterReader folder does not contain a standalone sample program. Instead, it contains sample functions that support CustomWriter files. The sample functions are in turn used by other sample programs (ExportScene05, ImportScene, and ViewScene) to write and read CustomWriter files.

For more information, see Supporting additional file formats.

ExportScene01

The scene created in this example is a cylinder linked to a skeleton made of two segments. Two takes of animation show the influence of the skeleton segments over the cylinder. ExportScene01 illustrates how to:

Create a patch.
Create a skeleton segment.
Create a link.
Store the Bind pose.
Store one arbitrary Rest pose.
Create multiple takes of animation.
Create meta-data for a scene.
Export a scene in an .fbx file (in ASCII mode).

ExportScene02

The scene created in this example is a sphere morphed by two shapes. A take of animation shows the influence of the shapes over the sphere. ExportScene02 illustrates how to:

Create a NURBS.
Map a shape over NURBS.
Map a texture over NURBS on material channel Diffuse and Ambient.
Map a material over a NURB.
Create a take of animation.
Export a scene in an .fbx file.

ExportScene03

The scene created in this example is a textured cube and a pyramid with materials mapped on its faces. A take of animation displays six different angles of both models. ExportScene03 illustrates how to:

Create a mesh.
Extend the SDK by creating your own version of the KFbxMesh.
Map a texture over a mesh or your own mesh type.
Map a material over a mesh or your own mesh type.
Extend the SDK by applying your own user-defined Layer Element on a mesh.
Use your own mesh type with your own User Data Layer Element.
Create a vertex cache deformer to deform a simple model.
Create a take of animation.
Animate the vertex cache.
Export a scene in an .fbx file.

ExportScene04

The scene created in this example contains a group of lights, a marker, and a camera. A take of animation rotates the lights and moves the camera. ExportScene04 illustrates how to:

Create a light and assign a gobo.
Set global light settings.
Create a marker.
Create a camera and link it to a point of interest.
Create a take of animation.
Export a scene in an .fbx file.

ExportScene05

The scene created in this example contains a skeleton made of three segments. The position of a node in an .fbx file is expressed in coordinates relative to its parent. This example shows how to convert to and from a global position. ExportScene05 illustrates how to:

Use a custom memory allocator.
Create a skeleton segment.
Get the global default position of a node.
Set the global default position of a node.
Set limits, rotation order, and pre/post pivots.
Export a scene in an .fbx file.

ImportScene

This example illustrates how to detect if a scene is password protected, and how to import and browse the scene to access node and animation information. This example displays the content of an .fbx file that is passed as program argument. It shows how to traverse an FBX scene graph and retrieve its content. You can try this example using any of the FBX SDK-supported files output by the export examples.

UserProperties

In this example, a scene is created containing a cube, a pyramid, and user properties. This example illustrates how to:

Create user properties
Attach user properties to a cube.
Animate attached user properties.
Create a constraint that constrains a pyramid to a cube.

NoteUser properties are also called custom properties.

ViewScene

This example illustrates how to display the content of an .fbx or .obj file in a graphical window. This program is based on the OpenGL^® Utility Toolkit (GLUT). Start the program on the command line by providing the name of any FBX SDK-supported file. A menu opens letting you select the current camera and the current take. The ViewScene example illustrates how to:

Import a scene from .fbx or .obj files.
Convert the NURBS and patch attribute types of a scene into mesh node attributes.
Get the list of all the cameras in the scene.
Find the current camera.
Get the relevant settings of a camera depending on its projection type and aperture mode.
Compute the local and global positions of each node.
Compute the shape deformation of mesh vertices.
Compute the cluster deformation of mesh vertices.
Display the point cache simulation of a mesh.
Get a list of all poses in the scene.
Display the scene with a specific pose.