Layout and View XML Syntax

 
 
 

Layouts and views are defined by an XML-based format:

You can edit the layout and view files in a text editor or XML editor to set options that you cannot control through the layout or view editor in the Softimage interface. Some features you can set in this way are:

For additional examples, take a look at the .xsily files installed in the factory location to see how they were put together. There are also some sample .xsivw files in the SDK Examples workgroup (see SDK Example Workgroup).

NoteYou may find additional keywords in the factory views and layouts that are not described here. These may work in specific situations but have not been tested more generally and are unsupported.

Format Overview

Here is an overview of the .xsily/.xsivw format. Note that this is not an actual example — some elements and attributes are valid only for layouts and others are valid only for views. Each element (tag) and its attributes are described in more detail later. Note that all attribute values are strings and are enclosed in double quotes.

<?xml version="1.0" encoding="iso-8859-1"?>
<xsi_file type="Layout" xsi_version="7.0" syntax_version="1.1">
	<relationalview clsid="{1ECE3500-ED3A-4A74-8999-0D301347AB5E}" name="Fluffy's Workspace" height="1141" width="3198" nbscreen="2">
		<definition maxinstances="10000" acceptfocus="true" private="false" defaultsize="100,100,500,500" cmdmap="{00000000-0000-0000-0000-000000000000}" supportedtypes="6" category="Fluffy"> </definition>
		<bitmaps>
			<bitmap name="fluffy" path="fluffy.bmp" highlightpath="fluffy_highlight.bmp"> </bitmap>
			<!-- Etc., etc., etc. -->
		</bitmaps>
		<relations>
			<relation driver="explorer1" driven="objview1" event="selectionproc" cmd="my_selproc"> </relation>
			<!-- Etc., etc., etc. -->
		</relations>
		<viewdefaultpos>
			<view type="Animation Editor" position="113,532,1137,859"> </view>
			<!-- Etc., etc., etc. -->
		</viewdefaultpos>
		<frameset orientation="horizontal" name="Frameset1" splitter="movable" sizechild="160,*">
			<frame name="explorer1" type="Explorer" primary="true" toolbar="own"> </frame>
			<frameset orientation="vertical" name="Frameset2" splitter="movable" sizechild="*,100">
				<switcher type="tray" buttonside="bottom" active="0" orientation="horizontal" name="Tray4" buttonsize="80,30" splitter="none" sizechild="*,*,*">
					<frameset orientation="vertical" name="Frameset3" bitmap="fluffy" splitter="movable" sizechild="*,50">
						<frame name="objview1" type="Object View" primary="false" toolbar="own">
							<properties>
								<displaymode>shaded</displaymode>
								<!-- Etc., etc., etc. -->
							</properties>
						</frame>
						<!-- Etc., etc., etc. -->
					</frameset>
					<frame name="rtree1" bitmap="rtree" type="Render Tree" primary="false" toolbar="own"> </frame>
					<!-- Etc., etc., etc. -->
				</switcher>
				<!-- Etc., etc., etc. -->
			</frameset>
		</frameset>
		<autohide>
			<section side="left" activation="10,0,50%;10,50%,100%">
				<view viewsize="105,0,100%">
					<frameset orientation="vertical" name="ah_frameset1" splitter="none" sizechild="30,*">
						<!-- Etc., etc., etc. -->
					</frameset>
				</view>
				<!-- Etc., etc., etc. -->
			</section>
			<!-- Etc., etc., etc. -->
		</autohide>
		<script language="JScript">
			<![CDATA[
			function RV_Init( in_rv)
			{
				AddProp("My_Custom_Property", "Scene_Root", "", "", null);
			}
	
			function RV_Term( in_rv)
			{
			DeleteObj("Scene_Root.My_Custom_Property");
			}
	
			function my_selproc( in_list, in_driverName, in_drivenName, in_rv )
			{
				// This example simply shows how to populate the driven pane.
				// It is equivalent to event="selection".
				in_rv.Views(in_drivenName).SetAttributeValue("targetcontent", in_list.GetAsText());
			}
			]]>
		</script>
		<floatingwindows>
			<view name="Explorer1" type="Explorer" position="128,81,500,563">
				<properties>
					<scope>Passes</scope>
					<!-- Etc., etc., etc. -->
				</properties>
			</view>
			<!-- Etc., etc., etc. -->
		</floatingwindows>
	</relationalview>
</xsi_file>

<?xml>

The XML declaration is required by the XML parser. It must always be the first line and should never be modified.

Example:

<?xml version="1.0" encoding="iso-8859-1"?>

Applies to: layouts and views (required)

Parent: none

Children: none

<xsi_file>

The <xsi_file> element is the root element for layouts and views. There can be only one per file.

Example:

<xsi_file type="Layout" xsi_version="5.0" syntax_version="1.1">

Applies to: layouts and views (required)

Parent: none

Children: <relationalview> (required, one only)

type

Identifies the type of file.

Value

Meaning

Layout

The file defines the configuration of the views and panels in the main Softimage window.

RelationalView

The file defines a view that can contain relations between panes.

xsi_version

The version of Softimage in which the view or layout was created or modified. This value may be used in the future to provide backwards compatibility.

syntax_version

The version of the xsi_file XML syntax used. This value may be used in the future to provide backwards compatibility. The current version is "1.1".

<relationalview>

Defines the basic characteristics of a layout or view, and contains all its components. There should be exactly one.

Example:

<relationalview clsid="{1ECE3500-ED3A-4A74-8999-0D301347AB5E}" name="Fluffy's Workspace" height="1141" width="3198" nbscreen="2">

Applies to: layouts and views (required, one only)

Parent: <xsi_file>

Children: <definition> (required, views only, one only), <bitmaps> (optional, one only), <relations> (optional, views only, one only), <viewdefaultpos> (optional, layouts only, one only), <frameset> (required, one only as a direct child of <relationalview>), <autohide> (optional, layouts only, one only), <script> (optional, views only, one only), <floatingwindows> (optional, layouts only, one only)

clsid

An identifier for the view or layout. The value must be unique across all existing layouts and views. If necessary, use a GUID generator.

name

The name of the view or layout as it appears in menus and other parts of the Softimage interface. The name can also be used in scripts and plug-ins, for example, with the OpenView command. The name must be unique across all existing layouts and views.

height

The default height for views in pixels. A layout can also store default size and position values for views (see <viewdefaultpos> below), which overrides the value set here for that layout.

This attribute is ignored in layout definitions. Layouts use the entire screen space when maximized.

width

The default width for views in pixels. A layout can store default size and position values for views (see <viewdefaultpos> below), which overrides the value set here for that layout.

This attribute is ignored in layout definitions. Layouts use the entire screen space when maximized.

nbscreen

Whether a layout spans multiple screens:

  • If this value is "1", the layout uses only one screen on Windows systems. This may not be supported by all graphics cards.

  • If this value is anything else, the layout uses all available screen space when maximized.

This attribute is ignored for views.

<definition>

Defines some basic properties of views.

Example:

<definition maxinstances="10000" acceptfocus="true" private="false" defaultsize="100,100,500,500" cmdmap="{00000000-0000-0000-0000-000000000000}" supportedtypes="6" category="Fluffy"> </definition>

Applies to: views only (required)

Parent: <relationalview>

Children: none

maxinstances

The maximum number of views of that type that can be opened at once.

If this attribute is set to 1, the view is considered to be a single-instance view. If such a view is contained in a layout but hidden by a switcher displaying a different pane, then displaying the view by a key press or other mechanism will activate the corresponding pane in the switcher.

acceptfocus

Used internally by the factory views. Not used for custom views and layouts.

private

Controls whether the view appears in menus. This allows you to define views that can be opened programmatically or instanced inside other view and layout definitions but that don't clutter the menus.

Value

Meaning

true

The view does not appear in menus.

false

The view appears in menus.

defaultsize

Defines the default position of the view window. This attribute should be set to a string of four integers separated by commas (no spaces). The first two integers are the offsets in pixels of the view window from the left and top of the main Softimage window. The other two values are unused — the height and width defined in <relationalview> are used instead.

Layouts can store default size and position values for views (see <viewdefaultpos> below), which overrides the value set here for that layout.

cmdmap

Used internally by the factory views. Not used for custom views and layouts.

supportedtypes

Used internally by the factory views. Not used for custom views and layouts.

category

The submenu of the View menu on which the view appears. You can set this to a new string to place your view on your own custom submenu.

If this attribute does not exist or if it is set to the empty string, the view appears on the View Others submenu.

<bitmaps>

Contains a list of bitmaps that can be used as buttons in switchers.

Example:

<bitmaps>
	<bitmap name="fluffy" path="fluffy.bmp" highlightpath="fluffy_highlight.bmp"> </bitmap>
	<!-- Etc., etc., etc. -->
</bitmaps>

Applies to: layouts and views (optional)

Parent: <relationalview>

Children: <bitmap> (optional, one or more)

<bitmap>

Defines a bitmap that can be used as a button in a switcher. Button images can be in any supported image format.

Example:

<bitmap name="fluffy" path="fluffy.bmp" highlightpath="fluffy_highlight.bmp"> </bitmap>

Applies to: layouts and views (optional)

Parent: <bitmaps>

Children: none

name

The name of the bitmap, as used when specifying bitmaps for buttons in switchers.

path

The path to the image file to use for a button's inactive state.

highlightpath

The path to the image file to use for a button's active state. This attribute is optional. If it is not defined, the path attribute is used for both states but a white outline is drawn around the button when it is active.

<relations>

Contains a list of driver/driven relations between panes in a view.

Example:

<relations>
	<relation driver="explorer1" driven="objview1" event="selectionproc" cmd="my_selproc"> </relation>
	<!-- Etc., etc., etc. -->
</relations>

Applies to: views only (optional)

Parent: <relationalview>

Children: <relation> (optional, one or more)

<relation>

Defines a driver/driven relation between panes in a view. Selecting elements in the driving pane causes the driven pane to update.

Example:

<relation driver="explorer1" driven="objview1" event="selectionproc" cmd="my_selproc"> </relation>

Applies to: views only (optional)

Parent: <relations>

Children: none

driver

The name of the pane that is driving the relation. This is the name that is defined in the corresponding <frame> element. Selections made in this pane affect the driven pane.

driven

The name of the pane that is driven by the relation. Again, this is the name that is defined in the corresponding <frame> element. The contents of this pane are affected by selections made in the driving pane, but not by selections made elsewhere.

event

The relation type.

Value

Meaning

selection

If one or more elements are selected in the driver pane, they are sent directly to the driven pane as target. The driven pane displays the selected elements only.

For example, if the driven pane is an explorer, it displays the selected elements in the Selection scope; if it is an Object view, it isolates the selection; if it is a render tree, it shows the selection's material, etc.

selectionfilter

This is similar to selection, but the collection of selected elements is filtered before being sent to the driven pane.

For example, if you use "PolygonMesh" as the filter, the driven pane receives only polygon meshes no matter what mixture of object types is selected in the driver pane.

selectionfunc

This allows you to write your own function to control the elements received by the driven pane. Your function receives the collection of elements selected in the driver pane, and is responsible for returning a collection of elements to send to the driven pane. The function can also use the object model to modify the view, such as to set the active tab in a shelf.

selectionproc

This is similar to selectionfunc except that your routine does not return a collection. Instead, it must use the object model to control the target content of the driven pane.

cmd

The filter or subroutine that implements the relation:

If event is "selection", this attribute is ignored.

If event is "selectionfilter", this value should be the name of the filter to use. You can use any filter that appears on the Filters menu of the Select panel or explorer. Make sure you specify the scripting name of the filter, rather than the display name (which may contain spaces, etc.).

If event is "selectionfunc" or "selectionproc", this value should be the name of the subroutine to run. The subroutine should be defined in the <script> block.

<viewdefaultpos>

Contains a list of the default sizes and positions for floating windows in a layout. If a view appears in this list, the values set here override the defaults set in the view's own .xsivw file.

This section is saved when you move a floating window, close it, and then save the layout (View Layouts Save Layouts).

Example:

<viewdefaultpos>
	<view type="Animation Editor" position="113,532,1137,859"> </view>
	<!-- Etc., etc., etc. -->
</viewdefaultpos>

Applies to: layouts only (optional)

Parent: <relationalview>

Children: <view> (child of <viewdefaultpos>) (optional, one or more)

<view> (child of <viewdefaultpos>)

Defines the size and position of a floating view in a layout.

Example:

<view type="Animation Editor" position="113,532,1137,859"> </view>

Applies to: layouts only (optional)

Parent: <viewdefaultpos>

Children: none

type

The name of a factory or custom view as defined by its .xsivw file.

position

A string containing four comma-separated integers with no spaces. These represent positions of the left, top, right, and bottom edges of the window in pixels, where (0, 0) is the top left corner of the layout.

<frameset>

Defines how a pane is divided into subpanes that can contain different views. Framesets can be nested arbitrarily deep to divide a window in complex ways. A frameset can have one or more children, each one being a frame, a switcher, or another frameset.

Example:

<frameset orientation="horizontal" name="Frameset1" splitter="movable" sizechild="160,*">
	<frame name="explorer1" type="Explorer" primary="true" toolbar="own"> </frame>
	<frameset orientation="vertical" name="Frameset2" splitter="movable" sizechild="*,100">
		<switcher type="tray" buttonside="bottom" active="0" orientation="horizontal" name="Tray4"buttonsize="80,30" splitter="none" sizechild="*,*,*">
			<frameset orientation="vertical" name="Frameset3" bitmap="fluffy" splitter="movable" sizechild="*,50">
				<frame name="objview1" type="Object View" primary="false" toolbar="own">
					<properties>
						<displaymode>shaded</displaymode>
						<!-- Etc., etc., etc. -->
					</properties>
				</frame>
				<!-- Etc., etc., etc. -->
			</frameset>
			<frame name="rtree1" bitmap="rtree" type="Render Tree" primary="false" toolbar="own"> </frame>
			<!-- Etc., etc., etc. -->
		</switcher>
		<!-- Etc., etc., etc. -->
	</frameset>
</frameset>

Applies to: layouts and views (at least one required)

Parent: <relationalview>, <frameset>, <switcher>, <view> (child of <section>)

Children: <frameset>, <switcher>, <frame> (at least one or more in any combination)

Note that <frameset> shares the same attributes as <switcher>, although those attributes that are specific to switcher functionality are ignored in framesets. Occasionally, switcher-only attributes appear in a <frameset> tag when editing views and layouts in the Softimage interface; these attributes can be safely ignored or removed. Only the attributes described in this section apply to <frameset>.

orientation

Controls how subpanes are arranged. To have both horizontal and vertical splits in a window, nest one frameset inside another.

Value

Meaning

horizontal

The child panes are arranged in a row from left to right. The splitters are vertical.

vertical

The child panes are arranged in a column from top to bottom. The splitters are horizontal.

name

A string to identify the frameset. This attribute is optional. If it exists, it must be unique within the view or layout. It is not case-sensitive. When the frameset is the child of a switcher, this string is displayed on the button if a displayname or bitmap is not specified. This string is also used on the View Optional Panels menu if the optional attribute exists and displayname does not exist.

optional

This attribute applies only to panes in a layout. If it appears in the tag, the pane is added to the View Optional Panels menu. When an optional pane is hidden, its size is considered to be 0 for the purpose of calculating the sizes of the other children in the parent pane. The menu uses the displayname if it exists, otherwise it falls back on the name.

Value

Meaning

visible

The pane is displayed when the layout is first opened.

hidden

The pane is hidden when the layout is first opened.

displayname

A string that appears on switcher buttons if there is no bitmap attribute. It allows you to display mixed-case characters on buttons. If this attribute is omitted and there is no bitmap attribute, the name attribute is displayed on buttons. This value also appears on the View Optional Panels menu if the optional attribute exists.

description

A string that appears on the tooltip when users hover the mouse over a button in a switcher. If this attribute is not defined, the tooltip falls back on displayname and then on name. This attribute has an effect only when the pane is the child of a switcher.

bitmap

The name of a bitmap as defined in the <bitmaps> section. This is used on switcher buttons. This attribute has no effect if the pane is not the child of a switcher. If this attribute is omitted, then the displayname or name attribute is used on switcher buttons instead.

splitter

Controls the display and behavior of the splitter bar that divides panes.

Value

Meaning

none

No visible splitter bar appears between the child panes. The panes cannot be resized.

fixed

A visible splitter bar appears between the child panes and the panes cannot be resized.

movable

A visible splitter bar appears between the child panes and users can click and drag it to resize the panes.

sizechild

The sizes of the subpanes in order. This is a comma-separated string (no spaces). The sizes are interpreted horizontally or vertically, depending on the orientation. The number of items in the string is the number of subpanes and should be the same as the number of child elements. Each item in the string can be:

  • An integer. This represents an absolute size in pixels. This is useful for portions of the window that you don't want to be resized, like toolbars.

  • A percentage. The pane retains its relative proportion when users change the window size.

  • An asterisk "*". The pane uses all free space remaining. This is useful to ensure that the sizes of all panes in a frameset add up correctly no matter how the window is resized. Typically, there should always be one subpane with a size of "*".

Remember that users may change the sizes once a view is displayed, depending on whether the splitter bars are movable.

Some additional notes about setting sizes:

  • If you use all absolute sizes, there may be unused space or hidden areas if the sizes do not add up to the size of the parent frameset.

  • If you have two or more panes set to free (*) in the same frameset, the leftmost or topmost one takes all the available space.

  • If you mix absolute with relative and/or free size, the relative values are based on what's left of the parent frameset's size after the absolute sizes are considered.

  • If relative sizes do not add up to 100% and there is no pane with a free size, then the relative values are normalized.

<frame>

Specifies the view to be displayed in a pane, for example, an explorer, animation editor, or custom view.

Example:

<frame name="objview1" type="Object View" primary="false" toolbar="own">
	<properties>
		<displaymode>shaded</displaymode>
		<!-- Etc., etc., etc. -->
	</properties>
</frame>

Applies to: layouts and views

Parent: <frameset>, <switcher>, <view> (child of <section>)

Children: <properties> (optional)

name

An identifier that represents the instance of the view contained in the frame. It must be unique within a layout or view. It is not case-sensitive. This is the name that is used in relations, and also the name that is used in the SDK to get a pointer to that view in order to get or set view attributes. The name is also used on switcher buttons if there is no displayname or bitmap attribute. This string is also used on the View Optional Panels menu if the optional attribute exists and displayname does not exist.

optional

This attribute applies only to panes in a layout. If it appears in the tag, the pane is added to the View Optional Panels menu. When an optional pane is hidden, its size is considered to be 0 for the purpose of calculating the sizes of the other children in the parent pane. The menu uses the displayname if it exists, otherwise it falls back on the name.

Value

Meaning

visible

The pane is displayed when the layout is first opened.

hidden

The pane is hidden when the layout is first opened.

displayname

A string that appears on switcher buttons if there is no bitmap attribute. It allows you to display mixed-case characters on buttons. If this attribute is omitted and there is no bitmap attribute, the name attribute is displayed on buttons. This value also appears on the View Optional Panels menu if the optional attribute exists.

description

A string that appears on the tooltip when users hover the mouse over a button in a switcher. If this attribute is not defined, the tooltip falls back on displayname and then on name. This attribute has an effect only when the pane is the child of a switcher.

bitmap

The name of a bitmap as defined in the <bitmaps> section. This is used on switcher buttons. This attribute has no effect if the pane is not the child of a switcher. If this attribute is omitted, then the displayname or name attribute is used on switcher buttons instead.

type

The pane contents. This must be the name of a factory or custom view as defined in its own .xsivw file.

primary

This attribute is obsolete.

toolbar

Controls how the the toolbar appears.

Value

Meaning

none

Hides the view's toolbar. This is not supported by all view types. For example if you don't want users to change settings, you can hide the toolbar of an Object view and either set the display type in its <properties> tag or control it using the SDK.

own

Displays the view's toolbar normally.

shared

Displays the view's toolbar in a special area across the top of the relational view. This is supported only for explorer views. Setting it for other views may produce undesirable artifacts.

Not working in current versions.

timeline

The name of a <frame> that exists in the same file and has type="Timeline". This synchronizes and aligns the view in this pane with that timeline. This works with the Animation Mixer, Dopesheet and Fcurve editor.

<properties>

Contains a list of view attributes and their values. Each view attribute that you want to set should be a child tag of this element, and its value should be that tag's content as in the following:

<properties>
	<attributename>value</attributename>
	<!-- Etc., etc., etc. -->
</properties>

The specific view attributes that are available depend on the view's type. The contents of each element should be a valid value for the corresponding view attribute. For a list of attributes and values for the various views, see View Attributes [SDK Guide].

Example:

<frame name="pane5" type="Object View" primary="false" toolbar="own">
	<properties>
		<displaymode>shaded</displaymode>
		<localview>true</localview>
	</properties>
</frame>

Applies to: layouts and views (optional)

Parent: <frame>, <view> (child of <floatingwindows>)

Children: any supported attribute of the view type

<switcher>

Creates a pane that can switch between different child panes using buttons. Each child can be a frame, a frameset, or another switcher. Switchers can be nested arbitrarily deep.

The buttons in a switcher display bitmap if it exists, and fall back on displayname and then name otherwise. If users hover the mouse pointer over a button, the tooltip uses description if it exists, and falls back on displayname and then name otherwise.

Example:

<switcher type="tray" buttonside="bottom" active="0" orientation="horizontal" name="Tray4" buttonsize="80,30" splitter="none" sizechild="*,*,*">
	<frameset orientation="vertical" name="Frameset3" bitmap="fluffy" splitter="movable" sizechild="*,50">
		<!-- Etc., etc., etc. -->
	</frameset>
	<frame name="rtree1" bitmap="rtree" type="Render Tree" primary="false" toolbar="own"> </frame>
	<!-- Etc., etc., etc. -->
</switcher>

Applies to: layouts and views

Parent: <frameset>, <switcher>, <view> (child of <section>)

Children: <frameset>, <switcher>, <frame>

type

The only value supported by custom views and layouts is "tray". Tray switchers display only one child pane at a time.

buttonside

Controls where the switcher buttons appear. Possible values are "top", "left", "bottom", or "right".

active

A string specifying the number (zero-based index) of the child that is active when the view or layout is first opened.

orientation

Not applicable to tray switchers.

name

A string to identify the switcher. This attribute is optional. If it exists, it must be unique within the view or layout. It is not case-sensitive. When the frameset is the child of a switcher, this string is displayed on the button if a displayname or bitmap is not specified. This string is also used on the View Optional Panels menu if the optional attribute exists and displayname does not exist.

optional

This attribute applies only to panes in a layout. If it appears in the tag, the pane is added to the View Optional Panels menu. When an optional pane is hidden, its size is considered to be 0 for the purpose of calculating the sizes of the other children in the parent pane. The menu uses the displayname if it exists, otherwise it falls back on the name.

Value

Meaning

visible

The pane is displayed when the layout is first opened.

hidden

The pane is hidden when the layout is first opened.

displayname

A string that appears on switcher buttons if there is no bitmap attribute. It allows you to display mixed-case characters on buttons. If this attribute is omitted and there is no bitmap attribute, the name attribute is displayed on buttons. This value also appears on the View Optional Panels menu if the optional attribute exists.

description

A string that appears on the tooltip when users hover the mouse over a button in a switcher. If this attribute is not defined, the tooltip falls back on displayname and then on name. This attribute has an effect only when the pane is the child of a switcher.

bitmap

The name of a bitmap as defined in the <bitmaps> section. This is used on switcher buttons. This attribute has no effect if the pane is not the child of a switcher. If this attribute is omitted, then the displayname or name attribute is used on switcher buttons instead.

buttonsize

A comma-separated string (no spaces) specifying the width and height of the switcher buttons in pixels.

splitter

Ignored by tray switchers.

sizechild

For tray switchers, this should be a comma-separated string of asterisks (no spaces) with as many asterisks as there are children of the switcher.

<autohide>

Contains a list of autohiding panes in a layout.

Example:

<autohide>
	<section side="left" activation="10,0,50%;10,50%,100%">
		<view viewsize="105,0,100%">
			<frameset orientation="vertical" name="ah_frameset1" splitter="none" sizechild="30,*">
				<!-- Etc., etc., etc. -->
			</frameset>
		</view>
		<!-- Etc., etc., etc. -->
	</section>
	<!-- Etc., etc., etc. -->
</autohide>

Applies to: layouts only (optional)

Parent: <relationalview>

Children: <section> (maximum 4)

<section>

Defines the activation zones on one of four sides in a layout.

Example:

<section side="left" activation="10,0,50%;10,50%,100%">
	<view viewsize="105,0,100%">
		<frameset orientation="vertical" name="ah_frameset1" splitter="none" sizechild="30,*">
			<!-- Etc., etc., etc. -->
		</frameset>
	</view>
<!-- Etc., etc., etc. -->
	</section>

Applies to: layouts only (optional)

Parent: <autohide>

Children: <view> (child of <section>)

side

Specifies one of the four sides of a layout. Possible values are "top", "left", "bottom", or "right".

activation

The activation zones on one side of a layout. An autohide pane is displayed when the mouse pointer enters an activation zone. There can be multiple activation zones, each one corresponding to a separate autohide pane defined in its own <view> tag.

This value is a list of triplets of numbers. Triplets are separated by semicolons (;), and numbers within a triplet are separated by commas (no spaces). There is one triplet for each <view> child of the <section>. In order, the numbers in a triplet represent:

  • The width (if the side is left or right) or the height (if the side is top or bottom) of the activation zone.

  • The top (if the side is left or right) or the left (if the side is top or bottom) of the activation zone.

  • The bottom (if the side is left or right) or the right (if the side is top or bottom) of the activation zone.

All numbers can be integers (pixels) or percentages, where (0, 0) is the top left corner of the layout.

If two or more activation zones overlap, the first one defined takes precedence. This is also true if the overlapping activation zones are defined in separate <section> elements.

<view> (child of <section>)

Defines the size and position of an autohide pane when it is displayed. There should be one view for every triplet in the activation attribute of the parent <section> element.

Example:

<view viewsize="105,0,100%">
	<frameset orientation="vertical" name="ah_frameset1" splitter="none" sizechild="30,*">
		<!-- Etc., etc., etc. -->
	</frameset>
</view>

Applies to: layouts only (optional)

Parent: <section>

Children: <frameset>, <frame>, <switcher> (maximum 1 direct child)

viewsize

A comma-separated list (no spaces) of three numbers that defines the size and position of the autohide pane. The pane disappears as soon as the mouse pointer leaves this area. Therefore it is important that the viewsize completely covers the corresponding activation size, otherwise the panel may disappear as soon as it is displayed.

As with the activation size, the numbers represent:

  • The width (if the side is left or right) or the height (if the side is top or bottom) of the autohide pane.

  • The top (if the side is left or right) or the left (if the side is top or bottom) of the autohide pane.

  • The bottom (if the side is left or right) or the right (if the side is top or bottom) of the autohide pane.

All numbers can be integers (pixels) or percentages.

<script>

Contains scripts that can be used in the view.

The contents of this element should be enclosed in a <![CDATA[…]]> section, otherwise any XML markup characters like < and > in your script will prevent the file from parsing correctly.

There are two basic types of script that you can include here:

Remember that global code (i.e., code that is not within a function or procedure) runs automatically when the view is opened. This is a side-effect of parsing the script.

Example:

<script language="JScript">
	<![CDATA[
	function RV_Init( in_rv)
	{
		AddProp("My_Custom_Property", "Scene_Root", "", "", null);
	}
	
	function RV_Term( in_rv)
	{
		DeleteObj("Scene_Root.My_Custom_Property");
	}
	
	function my_selproc( in_list, in_driverName, in_drivenName, in_rv )
	{
		// This example simply shows how to populate the driven pane.
		// It is equivalent to event="selection".
		in_rv.Views(in_drivenName).SetAttributeValue("targetcontent", in_list.GetAsText());
	}
	]]>
</script>

Applies to: views only (optional)

Parent: <relationalview>

Children: none

language

Specifies the scripting language used in the <script> block. "VBScript", "JScript", and "Python" are supported by all installations of Softimage.

RV_Init and RV_Term

RV_Init and RV_Term are callbacks that are executed when a custom view is created and closed, respectively. They allow you to perform some set-up at the start and some clean-up at the end.

You must use the exact names RV_Init and RV_Term. Each function is passed a pointer to the view object.

selectionfunc and selectionproc

If you set the event parameter of a <relation> to "selectionfunc" or "selectionproc", you must use the cmd parameter to specify the name of a routine, and then create the named routine in the <script> block.

  • If you are using selectionfunc, your routine is responsible for returning a collection of elements to send to the driven pane. The function can also use the object model to modify the view in other ways, such as to set the active tab in a shelf.

  • If you are using selectionproc, your routine does not return a collection. Instead, it uses the object model to control the target content of the driven pane.

In both cases, the routine receives: a collection of objects selected in the driving pane, the name of the driving pane, the name of the driven pane, and a pointer to the relational view.

<floatingwindows>

Contains a list of floating windows that open automatically when a layout is first opened in a Softimage session. Note that during a Softimage session, the states of floating windows are persisted if you switch between layouts.

This section is saved if you have open floating windows when you save a layout (View Layouts Save Layouts).

Example:

<floatingwindows>
	<view name="Explorer1" type="Explorer" position="128,81,500,563">
		<!-- Etc., etc., etc. -->
	</view>
	<!-- Etc., etc., etc. -->
</floatingwindows>

Applies to: layouts only (optional)

Parent: <relationalview>

Children: <view> (child of <floatingwindows>) (optional, one or more)

<view> (child of <floatingwindows>)

Defines a floating window that opens automatically when you first open a layout.

<view name="Explorer1" type="Explorer" position="128,81,500,563">
	<properties>
		<scope>Passes</scope>
		<!-- Etc., etc., etc. -->
	</properties>
</view>

Applies to: layouts only (optional)

Parent: <floatingwindows>

Children: <properties>

name

A string that identifies the auto-created instance of the floating window. This name must be unique in a layout. It can be used to manipulate the view using the SDK.

type

The type of floating window. This must be the name of a factory or custom view as defined in its .xsivw file.

position

A string containing four comma-separated integers with no spaces. These represent positions of the left, top, right, and bottom edges of the window in pixels, where (0, 0) is the top left corner of the layout.

Comments

You can include standard XML comments in .xsily and .xsivw files. For example, you can include a general description or describe specific sections. Comments begin with:

<!--

and end with:

-->

Comments cannot appear inside tags (between < and >). In addition, comments cannot be nested.

To include comments in a script inside a <![CDATA[…]]> section, use the comment syntax of the scripting language rather than the XML comment syntax.

Creative Commons License Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License