# Copyright 2009 Autodesk, Inc.  All rights reserved.
# Use of this software is subject to the terms of the Autodesk license agreement 
# provided at the time of installation or download, or which otherwise accompanies
# this software in either electronic or hard copy form.
#
# Script description:
# Shows how to use FBFolder to organize datas in Navigator window
#
# Topic: FBFolder, FBPlug
#

from pyfbsdk import *

# D I S C L A I M E R :
# It is not possible to create a folder in the "Scene" element of the Navigator
# It is the same limitation as MotionBuilder UI (right-click on Scene and see that
# that NO "Insert Folder" item appear.

# The second parameters to FBFolder is an object decide whose type 
# will decide which type of folder to create. This object will also
# be added to the folder.

cam1 = FBCamera("my cam")
cam_folder = FBFolder("cam folder", cam1)

light = FBLight("my light")
light_folder = FBFolder("light folder", light)

# If you want to add new elements to a folder you use connection methods:

cam2 = FBCamera("my cam")
cam3 = FBCamera("my cam")

# You can use Folder.ConnectSrc(object) to add "object" to "folder"
cam_folder.ConnectSrc(cam2)

# Or you can use Object.ConnectDst(folder) to add "object" to "folder"
cam3.ConnectDst(cam_folder)