3D window plays the role of a placeholder for 3D animation. It defines the area on the presentation diagram where 3D animation will be shown at runtime. If you want 3D animation to be displayed for your agent, you must add 3D window onto its diagram.
There can be several 3D windows on one diagram, each one displaying a particular part of the common 3D scene (analogous to several displays on operator's console showing different views shot by different cameras).
You can configure your 3D window to display a certain part of the 3D scene by default by choosing a camera that will shoot the window's content. Just direct your camera in the graphical editor at the shapes that you want to see in 3D window on model startup. This option is exceptionally useful since it is easier to position a camera once rather than navigating to the required part of 3D scene every time a model is launched.To add a 3D window onto a diagram of agent
Note: Changing grid and background color settings affects not only this particular 3D window, but all 3D windows of this agent type, since all of them share common 3D animation scene.
Name – The name of the window. It is used to identify and access the element from code.
Ignore – If selected, the window will be excluded from the model.
Camera – Here you can select a camera that will "shoot" pictures for this window, i.e. you define, the part of the presentation that will get into this window.
Follow camera – [Disabled if Camera is Not specified] Here you can choose whether this window should follow the camera while it is moving at the model runtime. If the option is selected, the window will always show the picture that is getting into the moving focus of the camera.
– Here you can choose the navigation type that defines the freedom level of camera manipulation via mouse.
Properties on the
page are applied to the whole 3D animation scene (and not to this
particular 3D window only) that is common for all 3D windows of this
agent. Therefore, if you set the grid to be shown for a 3D window, turn
the grid on for all other 3D windows of the same agent type.
Grid color – Grid color of the 3D animation scene. The grid is turned off by default (No color is chosen).
– Background color of the 3D animation scene.
X – The x-coordinate of the window's upper left corner.
Y – The y-coordinate of the window's upper left corner.
Width – The width of the window (in pixels).
Height – The height of the window (in pixels).
Create view area at runtime – If selected, a view area containing this 3D window will be automatically created to enable easy navigation to/from this 3D window at model runtime. This view area will not be visible at design time, you will be able only to navigate to it using common navigation tools. The view area will have the name of the corresponding 3D window defined as its title.
Show name – If selected, the name of the window will be displayed on the presentation diagram.
Far clipping distance - The distance (in pixels) that regulates the visibility depth of the 3D animation scene (i.e., the distance from the camera at which the scene can be seen). The part of the 3D scene that is located beyond the far clipping distance will not be visible. Refer to the Far clipping distance section for details.
API Reference: ShapeWindow3D Class