This is an old revision of the document!
Perspective
Summary
The perspective function is used to move the camera so it looks at one or more assets.
You can nominate the name (or ARDI asset ID) of the asset, or one or more special names that allow you to look at multiple assets simultaniously.
You can also choose which angle to view the asset(s) from, or allow ARDI to choose a suitable perspective for you.
It takes approx. 1 second for the camera to move from its current position to the new location.
Parameters
Target (string)
Specifies the name or ARDI ID of the asset you would like to view. If using an asset ID, begin the target with the '#' character.
You can also use the following parameters instead of nominating a specific asset…
| Parameter | Meaning |
|---|---|
| everything | View everything in the scene, including any environmental objects (this doesn't include environmental objects that are currently hidden). |
| all | All assets in the scene. This normally won't include any mobile assets. Note that if you are using the Autofocus effect, this will then restrict this behaviour to only focus on the assets marked with the effect. |
Angle (string)
Default: auto
Specifies the angle from which to view the asset(s). This value should be one of the following…
| Parameter | Meaning |
|---|---|
| auto | ARDI calculates the angle. This is usually roughly 20 degrees to the right and above the asset, looking to the front. This function is aware of neighbouring objects and will attempt to avoid them. |
| front | Looking back at the object directly from the front. |
| back | Looking at the object from directly behind it. |
| above | Looking at the object from directly above it. |
| below | Looking at the object from directly below it. |
| left | Looking at the object from the left to the right |
| right | Looking at the object from right to the left |
Examples
<perspective target="all"/>
This is the function called when you don't have a default camera and you open an ARDI environment. The camera is moved so that all assets are in view.