Tool class. More...

#include <pyfbsdk.h>

Inheritance diagram for FBTool:

[legend]

Public Member Functions
	FBTool (str pName=None)
	Constructor.

	FBTool (str pName, bool pRegisterTool)
	Constructor used when creating tools not in the Tools menu of MotionBuilder.

FBToolPossibleDockPosition	GetPossibleDockPosition ()
	Get the possible docking position for the tool (concatenated).

	SetPossibleDockPosition (FBToolPossibleDockPosition pFlags)
	Set the possible docking position for the tool.

Public Member Functions inherited from FBLayout
	FBLayout ()
	Constructor.

bool	AddRegion (str pName, str pTitle, int pX, FBAttachType pXType, str pXRelative, float pMultX, int pY, FBAttachType pYType, str pYRelative, float pMultY, int pW, FBAttachType pWType, str pWRelative, float pMultW, int pH, FBAttachType pHType, str pHRelative, float pMultH)
	Add a region to the layout.

	ClearControl (str pName)
	Remove a control from a region in a visual component.

FBVisualComponent	GetControl (str pName)
	Get control of a region in a visual component.

bool	GetRegion (str pName)
	Verify if a region with pName exists.

bool	GetRegionPositions (str pName, bool pComputed, int pX, int pY, int pW=None, int pH=None)
	Get region pName information (position and size)

FBSplitStyle	GetSplitStyle (str pName)
	Get a region's splitstyle.

bool	MoveRegion (str pName, int pX, int pY)
	Move a region.

bool	RemoveRegion (str pName)
	Remove a region.

bool	RenameRegion (str pOldName, str pNewName)
	Rename a region.

	Restructure (bool pNoMove)
	Force a recomputation of all region placements in the layout.

	SetAutoRestructure (bool pAutoRestructure)
	Suspend all automatic layout recomputation.

bool	SetBorder (str pName, FBBorderStyle pType, bool pShowTitle, bool pInSet, int pWidth, int pSpacing, float pMaxAngle, int pCornerRadius)
	Set border properties for a region.

bool	SetControl (str pName, FBVisualComponent pComponent)
	Set control of a region to a visual component.

bool	SetControl (str pName, FBVisualComponent pComponent)

bool	SetRegionTitle (str pName, str pTitle)
	Set a region's title.

bool	SetSplitStyle (str pName, FBSplitStyle pRegionType)
	Set a region's splitstyle.

bool	SetView (str pName, FBVisualComponent pComponent)
	Set view.

bool	SetView (str pName, FBVisualComponent pComponent)

bool	SizeRegion (str pName, int pW, int pH)
	Change a region's size.

Public Member Functions inherited from FBVisualComponent
	FBVisualComponent ()
	Constructor.

bool	AddChild (FBVisualComponent pChild, int pId=0)
	Add a child component.

FBVisualComponent	GetChild (int pId=0)
	Get a child component.

QWidget	GetQWidgetAddress ()
	Get internal QWidget.

bool	IsView ()
	Is component a view?

	Refresh (bool pNow=False)
	Refresh component.

	ViewExpose ()
	Exposed view callback function.

	ViewInput (int pMouseX, int pMouseY, FBInputType pAction, int pButtonKey, int pModifier)
	Input callback function.

Public Member Functions inherited from FBComponent
	FBComponent ()
	Constructor.

str	ClassName ()
	Get the class name.

	DisableObjectFlags (FBObjectFlag pFlags)
	Disable a specific Object Flags.

	EnableObjectFlags (FBObjectFlag pFlags)
	Enable a specific Object Flags.

bool	FBCreate ()
	Open Reality Creation function.

	FBDelete ()
	Open Reality deletion function.

	FBDestroy ()
	Open Reality destruction function.

FBObjectFlag	GetObjectFlags ()
	Get all Object Flags (concatenated).

bool	GetObjectStatus (FBObjectStatus pStatus)
	Check to see if an object status is enabled.

FBFileReference	GetOwnerFileReference (p0)
	Get the owner FileReference object.

	HardSelect ()
	HardSelect.

bool	HasObjectFlags (FBObjectFlag pFlags)
	Check whether a specific object flag is enabled.

bool	Is (int pTypeId)
	Returns true if object is of type TypeId.

bool	ProcessNamespaceHierarchy (FBNamespaceAction pNamespaceAction, str pNamespaceName, str pReplaceTo=None, bool pAddRight=True)
	ProcessNamespaceHierarchy.

bool	ProcessObjectNamespace (FBNamespaceAction pNamespaceAction, str pNamespaceName, str pReplaceTo=None, bool pAddRight=True)
	ProcessObjectNamespace.

int	PropertyAdd (FBProperty pProperty)
	Add a property to the component's property manager.

bool	PropertyAddReferenceProperty (FBProperty pReferenceProperty)
	Add a reference property to the component's property manager.

FBProperty	PropertyCreate (str pName, FBType pType, str pDataType, bool pAnimatable, bool pIsUser=False, FBProperty pReferenceSource=None)
	Create user or dynamic property.

	PropertyGetModifiedList (FBArrayTemplate< FB > pPropList, FBPlugModificationFlag pModificationFlags)
	Get list of properties which have been modified since last loading.

	PropertyRemove (FBProperty pProperty)
	Remove a Property from the component's Property manager.

	SetObjectFlags (FBObjectFlag pFlags)
	SetObjectFlags.

	SetObjectStatus (FBObjectStatus pStatus, bool pValue)
	Enable/Disable a specific Object Status.

Public Attributes
int	StartSizeX
	Read Property: Starting Size. This is the initial size in X when the tool is opened. Default = 800

int	StartSizeY
	Read Property: Starting Size. This is the initial size in Y when the tool is opened. Default = 400

int	MaxSizeX
	Read Property: Maximum Size in X (Disabled in this version). A value of -1 means no maximum size.

int	MaxSizeY
	Maximum Size in Y (Disabled in this version). A value of -1 means no maximum size.

int	MinSizeX
	Read Property: Minimum Size in X. A value of -1 means no minimum value.

int	MinSizeY
	Read Property: Minimum Size in Y. A value of -1 means no minimum value.

int	StartPosX
	Read Property: Starting Position in X. This is the initial position when the tool is opened. Default = 450

int	StartPosY
	Read Property: Starting Position in Y. This is the initial position when the tool is opened. Default = 450

str	ToolName
	Read Property: Tool Name

str	DisplayName
	Read Write Property: Tool Display Name (Caption on the tool's title bar)

Public Attributes inherited from FBLayout
FBEvent	OnIdle
	Event: Idle.

FBEvent	OnInput
	Event: Input.

FBEvent	OnPaint
	Event: Paint layout.

FBEvent	OnResize
	Event: Resize layout.

FBEvent	OnShow
	Event: Show layout.

Public Attributes inherited from FBVisualComponent
str	RegionName
	Read Write Property: Region name.

int	RegionOffsetX
	Read Write Property: Region X offset.

int	RegionOffsetY
	Read Write Property: Region Y offset.

int	RegionOffsetWidth
	Read Write Property: Region width offset.

int	RegionOffsetHeight
	Read Write Property: Region height offset.

float	RegionRatioX
	Read Write Property: Ratio for X attachment.

float	RegionRatioY
	Read Write Property: Ratio for Y attachment.

float	RegionRatioWidth
	Read Write Property: Ratio for Width attachment.

float	RegionRatioHeight
	Read Write Property: Ratio for Height attachment.

FBAttachType	RegionAttachTypeX
	Read Write Property: X Attachment type.

FBAttachType	RegionAttachTypeY
	Read Write Property: Y Attachment type.

FBAttachType	RegionAttachTypeWidth
	Read Write Property: Width Attachment type.

FBAttachType	RegionAttachTypeHeight
	Read Write Property: Height Attachment type.

FBVisualComponent	RegionAttachToX
	Read Write Property X Attachment source.

FBVisualComponent	RegionAttachToY
	Read Write Property: Y Attachment source.

FBVisualComponent	RegionAttachToWidth
	Read Write Property: Width Attachment source.

FBVisualComponent	RegionAttachToHeight
	Read Write Property: Height Attachment source.

int	RegionPosMaxX
	Read Write Property: Region X position Max

int	RegionPosMinX
	Read Write Property: Region X position Min

int	RegionPosMaxY
	Read Write Property: Region Y position Max

int	RegionPosMinY
	Read Write Property: Region Y position Min

str	BorderCaption
	Read Write Property: Caption to display in border.

bool	BorderShowCaption
	Read Write Property: Show caption?

FBBorderStyle	BorderStyle
	Read Write Property: Style of border.

bool	BorderInSet
	Read Write Property: Is border inset?

int	BorderWidth
	Read Write Property: Width of border.

int	BorderSpacing
	Read Write Property: Spacing of border.

float	BorderMaxAngle
	Read Write Property: Max angle for rounding.

int	BorderCornerRadius
	Read Write Property: Corner radius (rounded).

str	Caption
	Property: Widget caption.

bool	Enabled
	Read Write Property: Is visual enabled?

int	Height
	Read Write Property: Height.

str	Hint
	Read Write Property: Hint to show.

int	Left
	Read Write Property: Left coordinate.

bool	ReadOnly
	Read Write Property: Is visual component read only?

int	Top
	Read Write Property: Top coordinate.

bool	Visible
	Read Write Property: Is visual component visible?

int	Width
	Read Write Property: Width.

Public Attributes inherited from FBComponent
FBListComponent	Components
	List: List of components.

str	LongName
	Read Write Property: Name and namespace for object.

str	Name
	Read Write Property: Unique name of object. See sample: RemoveSuffixFromNameOfSceneElements.py.

FBListComponent	Parents
	List: Parents.

FBManager	PropertyList
	Read Only Property: Manages all of the properties for the component.

bool	Selected
	Read Write Property: Selected property.

int	TypeInfo
	Contains the Type information of the object.

Public Attributes inherited from FBPlug
str	ClassGroupName
	ClassGroupName of the object.

int	TypeInfo
	TypeInfo.

Detailed Description

Tool class.

See samples: MBFileRefDemo.py, CloseTool.py, MoveResizeToolExample.py, SafeToolCreationExample.py, ToolCommunicationReceiver.py, ToolNativeWidgetHolder.py.

Constructor & Destructor Documentation

◆ FBTool() [1/2]

FBTool ( str pName = None )

Constructor.

Parameters

pName Name of tool.

◆ FBTool() [2/2]

FBTool	(	str	pName,
		bool	pRegisterTool
	)

Constructor used when creating tools not in the Tools menu of MotionBuilder.

Parameters

pName	Name of tool, must be an unique name.
pRegisterTool	Tells if we should register the tool on the toolmanager. You can later call Showtool to pop it.

Member Function Documentation

◆ GetPossibleDockPosition()

FBToolPossibleDockPosition GetPossibleDockPosition ( )

Get the possible docking position for the tool (concatenated).

Returns: Get all the docking flags in one call. Flags can be concatenated.

◆ SetPossibleDockPosition()

SetPossibleDockPosition ( FBToolPossibleDockPosition pFlags )

Set the possible docking position for the tool.

Be sure to call this function once the tool is visible, a good place to call it is when the OnShow event of the layout is called.

Parameters

pFlags Set the docking position flag values. Note: this function overwrites all flags with those passed in parameter.

Member Data Documentation

◆ DisplayName

str DisplayName

Read Write Property: Tool Display Name (Caption on the tool's title bar)

◆ MaxSizeX

int MaxSizeX

Read Property: Maximum Size in X (Disabled in this version). A value of -1 means no maximum size.

◆ MaxSizeY

int MaxSizeY

Maximum Size in Y (Disabled in this version). A value of -1 means no maximum size.

◆ MinSizeX

int MinSizeX

Read Property: Minimum Size in X. A value of -1 means no minimum value.

◆ MinSizeY

int MinSizeY

Read Property: Minimum Size in Y. A value of -1 means no minimum value.

◆ StartPosX

int StartPosX

Read Property: Starting Position in X. This is the initial position when the tool is opened. Default = 450

◆ StartPosY

int StartPosY

Read Property: Starting Position in Y. This is the initial position when the tool is opened. Default = 450

◆ StartSizeX

int StartSizeX

Read Property: Starting Size. This is the initial size in X when the tool is opened. Default = 800

◆ StartSizeY

int StartSizeY

Read Property: Starting Size. This is the initial size in Y when the tool is opened. Default = 400

◆ ToolName

str ToolName

Read Property: Tool Name

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ FBTool() [1/2]

◆ FBTool() [2/2]

Member Function Documentation

◆ GetPossibleDockPosition()

◆ SetPossibleDockPosition()

Member Data Documentation

◆ DisplayName

◆ MaxSizeX

◆ MaxSizeY

◆ MinSizeX

◆ MinSizeY

◆ StartPosX

◆ StartPosY

◆ StartSizeX

◆ StartSizeY

◆ ToolName