Chinny
10-13-2006, 10:43 PM
I have put this is the sticky plugins thread, but I thought I would make an announcement too.
Download it here
http://www.xsibase.com/tools/plugins.php?detail=1291 (http://www.xsibase.com/tools/plugins.php?detail=1291)
This plugin works in XSI 5.11 on Windows and Linux
Viewport Controls Overview
XSI has the concept of the “Active Viewport”.
This plugin has many commands to assist
artists’ workflow as well as new commands
to access the viewports and their layout.
During the creation of this plugin I wrote many useful
commands and functions. When this plugin is installed
scripters have access to these day-to-day commands
Viewport Controls Breakdown
This plugin installs 3 top level menu items:
1. Camera
2. Visibility
3. Viewports
This addon consists of:
ViewportControls.vbs – Commands for artists
ViewportControlsAPI.vbs - Commands for scripters
Isolated.xsivw – Control view for isolating objects
4 x .presets files for Custom Preferences
ViewportControls
Isolate
QuickFlix
ViewSwitcher
ViewportControls Synoptic
ViewSwitcher Synoptic
ViewportControlsHelp.htm
New commands for artists
Viewport and Camera Commands
KeyCamera
KeySpot
TearOffCamera
CameraFromView
ToggleStats
ToggleCustomInfo
ToggleHeadlight
LoopShading
LoopShadingActive
Isolate
TurnTableCreate
RotoscopeOffAll
RotoscopeClearAll
ResetDisplayMode
DisplayGeometryOnly
DisplayGeometryOnlyAll
ResetVisibilityOptions
ResetVisibilityOptionsAll
ResetDisplayOptions
ResetDisplayOptionsAll
View Switching Commands:
FrontView
RightView
UserView
TopView
LeftView
BackView
BottomView
CameraView
General Commands
LoopViews
QuickFlix
QuickCapture:
QuickRender
Synoptics
ViewportSynoptic
ViewSwitcher
There are a number of additional menu items in this plugin
that are not listed here as they are self-explanatory
Overview of some new artist commands
KeyCamera
If the active viewport is a scene camera this will key:
the local rotation and translation and the
field of view, projection and focal length.
If the camera has an interest this will key:
The interest’s local rotation and translation
Note: In the ViewportOptions property page
there is an option to key selected cameras
When Key Selected Cameras is on
ONLY if your selection contains:
Any Cameras, Camera Roots, Interests
or Groups (with any of the above in them)
KeyCamera will find and key the:
Cameras and Interests in this selection.
This will ignore the active viewport.
BUT if no camera elements are selected it
will behave as normal
Spot Light View Menu
Any viewport can look through a spotlight.
As with cameras, SpotLights have a dedicated menu.
Key SpotLight will key the rotation and translation and
on its interest if it has one.
Tear Off Camera
This will work for any camera viewport type.
It will create on Object View and copy all parameter
values.
Create Light from View
If the viewport is a Scene Camera a spot light is created
and the cone angle matching the camera’s field of view.
If the viewport is a View Camera an infinite is created
If the viewport is already a spot light it will log an error
Create Camera from View
This works for Scene Cameras and SpotLights
with or without an interest.
If the viewport is a View Camera a camera is created
without an interest or a parent. This is useful for camera
texture projections, as the camera can be animated.
On creation the viewport switches to the new camera,
which inherits the name from the view or light source
LoopShading
This should be mapped to a hotkey
This uses the position of the curser under the mouse
Whichever viewport it is over it will loop through
wireframe, shaded, hiddenline and textured
LoopShadingActive
As above but uses the active viewport
LoopViews
This should be mapped to a hotkey
Whichever viewport active it will loop through
Right, Top, Front, User, Camera (the first camera in the scene it finds)
Isolate
AKA Isolate With Options
This opens a mini ppg which has a few more options than the
normal Isolate Selected
When the mini ppg is closed it will Un-Isolate all Views
TurnTableCreate
Creates a turntable camera and a controls PPG
The controls PPG can be found under the turntable model
This can be used from any view
This will also work on a sub-component selection
View Switching Commands:
FrontView
RightView
UserView
TopView
LeftView (this is actually a Right view with a Left view values)
BackView (this is actually a Front view with a Back view values)
BottomView (this is actually a Top view with a Bottom view values)
CameraView
QuickFlix (custom preference)
QuickCapture
One click to capture the viewport playback
QuickRender
One click to render the active viewport (includes audio)
QuickCaptureOptions
A few settings not found in the normal capture options
Synoptics
ViewportSynoptic
A synoptic toolbar for the most common viewport commands
ViewSwitcher
A mini synoptic for switching between Right, Top, Front, User, Camera
New commands for scripting
GetViewport
SetViewport
SetViewportLayout
GetViewportNumber
GetLightFromViewport
CopyViewport
GetSelFilter
StringList
StringTrim
DeleteBranch
GetSceneName
GetScenePath
CamerasFromSelection
Have fun!
Chinny
Download it here
http://www.xsibase.com/tools/plugins.php?detail=1291 (http://www.xsibase.com/tools/plugins.php?detail=1291)
This plugin works in XSI 5.11 on Windows and Linux
Viewport Controls Overview
XSI has the concept of the “Active Viewport”.
This plugin has many commands to assist
artists’ workflow as well as new commands
to access the viewports and their layout.
During the creation of this plugin I wrote many useful
commands and functions. When this plugin is installed
scripters have access to these day-to-day commands
Viewport Controls Breakdown
This plugin installs 3 top level menu items:
1. Camera
2. Visibility
3. Viewports
This addon consists of:
ViewportControls.vbs – Commands for artists
ViewportControlsAPI.vbs - Commands for scripters
Isolated.xsivw – Control view for isolating objects
4 x .presets files for Custom Preferences
ViewportControls
Isolate
QuickFlix
ViewSwitcher
ViewportControls Synoptic
ViewSwitcher Synoptic
ViewportControlsHelp.htm
New commands for artists
Viewport and Camera Commands
KeyCamera
KeySpot
TearOffCamera
CameraFromView
ToggleStats
ToggleCustomInfo
ToggleHeadlight
LoopShading
LoopShadingActive
Isolate
TurnTableCreate
RotoscopeOffAll
RotoscopeClearAll
ResetDisplayMode
DisplayGeometryOnly
DisplayGeometryOnlyAll
ResetVisibilityOptions
ResetVisibilityOptionsAll
ResetDisplayOptions
ResetDisplayOptionsAll
View Switching Commands:
FrontView
RightView
UserView
TopView
LeftView
BackView
BottomView
CameraView
General Commands
LoopViews
QuickFlix
QuickCapture:
QuickRender
Synoptics
ViewportSynoptic
ViewSwitcher
There are a number of additional menu items in this plugin
that are not listed here as they are self-explanatory
Overview of some new artist commands
KeyCamera
If the active viewport is a scene camera this will key:
the local rotation and translation and the
field of view, projection and focal length.
If the camera has an interest this will key:
The interest’s local rotation and translation
Note: In the ViewportOptions property page
there is an option to key selected cameras
When Key Selected Cameras is on
ONLY if your selection contains:
Any Cameras, Camera Roots, Interests
or Groups (with any of the above in them)
KeyCamera will find and key the:
Cameras and Interests in this selection.
This will ignore the active viewport.
BUT if no camera elements are selected it
will behave as normal
Spot Light View Menu
Any viewport can look through a spotlight.
As with cameras, SpotLights have a dedicated menu.
Key SpotLight will key the rotation and translation and
on its interest if it has one.
Tear Off Camera
This will work for any camera viewport type.
It will create on Object View and copy all parameter
values.
Create Light from View
If the viewport is a Scene Camera a spot light is created
and the cone angle matching the camera’s field of view.
If the viewport is a View Camera an infinite is created
If the viewport is already a spot light it will log an error
Create Camera from View
This works for Scene Cameras and SpotLights
with or without an interest.
If the viewport is a View Camera a camera is created
without an interest or a parent. This is useful for camera
texture projections, as the camera can be animated.
On creation the viewport switches to the new camera,
which inherits the name from the view or light source
LoopShading
This should be mapped to a hotkey
This uses the position of the curser under the mouse
Whichever viewport it is over it will loop through
wireframe, shaded, hiddenline and textured
LoopShadingActive
As above but uses the active viewport
LoopViews
This should be mapped to a hotkey
Whichever viewport active it will loop through
Right, Top, Front, User, Camera (the first camera in the scene it finds)
Isolate
AKA Isolate With Options
This opens a mini ppg which has a few more options than the
normal Isolate Selected
When the mini ppg is closed it will Un-Isolate all Views
TurnTableCreate
Creates a turntable camera and a controls PPG
The controls PPG can be found under the turntable model
This can be used from any view
This will also work on a sub-component selection
View Switching Commands:
FrontView
RightView
UserView
TopView
LeftView (this is actually a Right view with a Left view values)
BackView (this is actually a Front view with a Back view values)
BottomView (this is actually a Top view with a Bottom view values)
CameraView
QuickFlix (custom preference)
QuickCapture
One click to capture the viewport playback
QuickRender
One click to render the active viewport (includes audio)
QuickCaptureOptions
A few settings not found in the normal capture options
Synoptics
ViewportSynoptic
A synoptic toolbar for the most common viewport commands
ViewSwitcher
A mini synoptic for switching between Right, Top, Front, User, Camera
New commands for scripting
GetViewport
SetViewport
SetViewportLayout
GetViewportNumber
GetLightFromViewport
CopyViewport
GetSelFilter
StringList
StringTrim
DeleteBranch
GetSceneName
GetScenePath
CamerasFromSelection
Have fun!
Chinny