Object Properties panel or property inspector, provides a set of behavior tools for the sound Objects.
Click any sound Object on the canvas or Object list to view the inspector panel.
Playback General Size Position Distance
- Size & Shape
- Distance Effect
- Events & Scripts
- Map Entries
Adjusts the overall volume of an Object in decibels. Changing a parent Object’s volume affects all of its children equally. Use the slider to adjust the volume or enter a numerical value in the text field “dB”.
When selected there will be no audio from the Object, though it will continue to render in the background.
Pushes the start of an Object forward to the desired time in seconds, relative to its parent start time. It can be used to play sounds at a specific time, or you can input a differing minimum and maximum start delay to introduce random timing. When a parent Object has a specified start delay, it will compound to its children. In this case, the child Object’s compounded (global) start delay amount will be shown by a globe next to its minimum value.
Checking this box will cause the Object to play in a loop. If that is the Scene Object, the entire Scene will be looped.
The number of times the Object will loop. A value of zero loops the Object indefinitely. Select infinite to have the Object loop indefinitely.
This will cause the Object to wait the entered value of seconds before looping again. A value of zero means it will loop without any time in between iterations.
The minimum amount of time in between loops.
Differing minimum and maximum values will introduce randomization in the loop timing within that range.
A calculated display of the length of each loop (in this case the length of the entire Scene) with an indicator of how many times it will be looped. This would be shown as “36.00 x 5” if the Scene is 36 seconds long and there are 5 loop iterations.
Displays the total length of time the Object will take to complete. If there are infinite loop iterations (or the value of the Iterations box is 0) the total duration will be ∞ as there is no effective end.
The Object is active when this box is checked.
Deactivate on complete
This action applies to triggered or input events. When this box is checked, the Object will switch off its active state once it finishes rendering all of its audio and will remain deactivated until triggered again.
Tags - Tags play a role in filtering the Object properties. Tags let you categorize and group Objects outside of the hierarchy. Tags are searchable words and Object behaviors that are saved with the Objects.
Preset Tags exist for the following Object properties and are searchable at the bottom of the Scene Overview.
|Muted||Search for all Objects that have “mute” enable.|
Search for all Objects that have "mute" disabled.
|Active||Search for all active Objects.|
|Inactive||Search for all inactive Objects. In this case, inactive Objects are those which do not have the “active” box checked, and therefore are not active.|
Any Object with a defined motion path or path. If you have not explicitly added a motion point, there is no motion path.
|Volume > 100%||
Search for any Object with volume set to 100% or greater or above 0 (zero) dB.
Search for any Object that has been assigned size in the property inspector.
Size & Shape
Object’s can be scaled to expand their aural reach in different ways. The length, width and height of an Object can be increased discreetly to cover the desired area of a Space. An Object’s sizing begins at 0, and cannot be decreased. The units of scale are always displayed in meters. When building a Scene, you may choose to have your Object scale automatically from Space to Space. This property is chosen individually for length, width or height.
Click the blue arrows to enable or disable Scale with Space. The size property can also be inherited by its parent or ultimately the Scene. This means that the Object’s size will automatically adapt to occupy the relative area of any Space it is played in along the selected axis.
Show acoustic size
Check this box to show a visual representation of the acoustic volume of an Object. When selected, the acoustic size of an Object will be displayed on the canvas in the form of an opaque cube. If the Object has not been resized, then no size representation is visible. The size of the Object does not equate to exactly where the sound emits to, that is called acoustic spread.
Show acoustic spread
The acoustic spread is a visual surrounding an Object that displays the audio reach. Surrounding speakers emit a piece of that sound to create the illusion that part of it exists in that area, this visualization gives the user an idea of how far the Object’s sound output will reach. The default spread for new Scenes is 3.
This is the amount of sharpness, or tightness, in an Object’s aural radius. If an Object is placed between two speakers, the volume it plays from each is based on the ratio of distance to the speakers. The spread parameter determines how far an Object's sound is played beyond the acoustic size and it will affect how gradually an Object pans between speakers.
If inherited is selected, the value is hierarchically inherited rather than explicitly set and will update its values automatically.
For example, a gentler spread value of 10 would gradually pan the sound across two speakers when moving an Object. A sharper spread of 1 would essentially snap the sound from one speaker to another, or use an immediate pan.
Adjusts the X, Y and Z coordinates of the center of an Object.
Click the blue arrows to enable or disable Scale with Space. This means that your Object’s position will adapt to occupy the same relative position of any Space it is played in, using only the selected direction(s).
Movement patterns are defined by motion points, which are placed around the canvas to indicate the order of the motion path. Any Object—or the entire Scene—can be automated to move in a Space. Motion is also hierarchical for parent Objects and their children.
Motion Type - Defines how the Object follows its motion points.
- Linear - An Object will move in a straight line.
- Curve - The path of the Object rounds itself to flow through the motion points with a smooth curvature, averaging its movement.
Note: Motion paths can also be scripted meaning the motions follows a Lua Script.
Impulse Type - Defines at what rate and time the Object follows the motion points.
- Duration - Length of time from one motion point coordinate to the next.
- Velocity - Speed between one motion point coordinate to the next.
Loop Type (v1.3.0 or newer)
Defines how a motion path will loop.
The motion path will continually repeat its course until a certain condition is reached.
- Ping Pong
Completes one course of the motion path, then reverses course and continues looping infinitely.
- One Shot
Completes one course of the motion path.
Motion points have the ability to deviate from their exact coordinates within a boundary at random. The values entered are relative to the units of the Object they’re affecting. For example, when an Object is working in meters, and you change Randomness from '0, 0, 0' to '1, 1, 1' - when the Object reaches that motion point it will differ up to one cubic meter in any direction. The functionality is using a random number generator within the platform.
Motion Path List
This displays the different motion points, start times, durations and coordinates. You can add “+” or remove “-” a motion point by clicking the gradient button.
Point “1” will always be the Object’s set location. There is no path without adding a second point. From there, a path can have multiple points.
Distance effects can manipulate the sound Object audible output based on rolloff and reverb effects due to positioning in a Space. Distance effects impact the frequency response of an Object.
Distance effects are automatically applied to Objects in a Scene unless otherwise specified.
You can specify distance effects:
Distance Effects can be Enable or disabled by selecting the toggle switch.
Custom Settings are revealed by expanding the Advanced section of Distance Effects:
Similar to Frequency rolloff in application, but changes the overall amplitude of the sound.
High Frequency Falloff
This effect causes the high frequency of an Object to be filtered out dynamically as the Object gets farther and farther away from the functioning Space.
Spatial’s reverb system functions with the general conventions of reverb effects, however it is also governed by Object placement.
Distance Reverb settings can be expanded by clicking Advanced:
Changes the size of the virtual room used to calculate and create the sound used for the Reverb effect.
The amount of decay for the reflections.
Affects the amount of Flutter, or quick echoes, audible in the effect.
Affects the amount of diffused reverberations, or drawn out noise, audible in the effect.
Applies a hi-cut filter to the Reverb. A value of 0 applies no filter. A value of 1 would essentially mean the Reverb’s low frequencies are all that are audible.
The following effects can be applied to each Object and are not inherently governed by the Object’s position.
You can add “+” or remove “-” an Effect by clicking the gradient button. The table displays the type of effect, name, property and value. Select the type of effect by clicking the pop-up button, click the text box to change the name or enter a new value.
A doppler effect is applied to a moving Object. The doppler effect can be summarized as a change in perceived pitch of an Object as it moves quickly towards and/or away from the listener in the real world.
Studio uses a smart encoder to transpose a sound file to a desired pitch change.
In some scenarios, a Scene will be solely one sound file. The Scene Object will have a soundset directly under it as its child. All effects can be applied to that soundset using the Scene properties.
Transform is mainly used to manipulate a group of child Objects by transforming their inherited properties from the parent Object that is selected. For instance, if a group of child Objects need to be positioned equally farther away from each other, therefore occupying a larger Space, using the scaling up function of Transform will do the trick. Transform has the ability to change position and rotation. You can manually adjust the coordinates by inputting numerical values and can adjust the scale by using the slider to increase and decrease the physical size of the Object.
Transform allows the object to be rotated, translated, and scaled hierarchically. Transform will affect all children of an object.
Adjusts the size of the area in which a parent Object’s children exist. Changes to scale do not affect Object size, rather the relative coordinates of its child Objects. Scaling up moves child Objects farther away in their respective directions, causing the parent Object to be scaled in its effective Space. It is viewable on the canvas.
This scaling feature follows the coordinate system that belongs to the parent Object and is always relative to the parent Object’s position.
Use the X, Y, and Z fields to set a specified Scale, or use the slider to scale up and down proportionately.
Rotating an Object will only affect the sound field if the Object has been resized to a non-cubical shape as an Object’s sound emanates equally in all directions by default. Rotation of an Object is irrelevant unless it is a parent Object. Rotating a parent Object rotates all of its children around it.
Rotation is based on the Euler angle convention using Pitch, Roll and Yaw. Use the wheels or enter a specific number in the value field.
Note: The Reset functionality in the transform section only applies to rotation. To reset Scale, enter the values 1,1,1 in the X,Y,Z fields.
As with most text fields in Spatial Studio’s inspector panel, you can click and drag the number up or down to change its value.
Events & Scripts
Global Lua Scope
This is an advanced functionality. Check the box to enable Global Lua Scope.
Event- Select an event from the pop-up button:
Map Entries allow for certain features to be automated. This is also how events from sensors are stored and mapped within Objects. Input Event map entries are automatic and not explicitly visible in Studio.
More information about Scripting.
Path - Shows the Path of a Map Entry.
Value - A dynamic text field for giving Entries a value.
Script - The following determine when a Script becomes active.