Version
The Query Editor is where you create and run queries. A query is basically a request to display a subset of information in your project. You can create very specific queries when looking for particular objects, or more general queries to find all sound objects in a particular platform, for example. The Query Editor also supports WAQL queries. Refer to Understanding the Wwise Authoring Query Language (WAQL) for details on WAQL queries.
All project elements that match your query criteria are displayed in the Results list. When you select an entry in the Results list, it automatically gets loaded into the Transport Control and is ready for playback. You can right-click a selection of entries in the Results list to access a series of commands, such as Edit, Show in Multi Editor, Show in Schematic View, and Convert. You can double-click an entry in the Results list at any time to display it in the Property Editor. You can also drag project elements from the Results list to the Project Explorer. For example, you can drag one or more sound objects from the Results list into an Actor-Mixer or container within the Project Explorer.
Working with search results
When the results of your search are displayed, you can select an entry to automatically load it into the Transport Control for immediate playback. If the corresponding view is not open, double-click the object.
You can also select one or more entries in the results list and then right-click to display the shortcut menu commands. Many of these, including Show in Multi Editor (Ctrl+M), Show in Schematic View (Ctl+Shift+S), and Convert (Shift+C), are common to a variety of objects. There are, however, a few specific to the search and query views:
Refresh All Sizes: Refreshes all Preview Sizes in the results list.
Refresh Size: Refreshes only the Preview Sizes of the selected objects.
Remove From View: Removes the selected objects from the current search's results list.
To choose which columns (properties) are displayed:
When different types of objects appear in the list, all of the columns possible for those objects are shown.
Both of the following methods open the Object Property Settings.
Right-click the list header and select Configure Columns.
Click View Settings (Ctrl+Alt+H) in the title bar.
To view and edit effects:
Click View Settings (Ctrl+Alt+H) in the title bar.
In the Object Property Settings list, navigate to Audio > Effects, and choose the effect properties to view and click OK.
An Effects folder appears under any appropriate object. Expand it to view the effects in rows and their properties in columns. This displays the same properties as the Effects Tab: Actor-Mixer and Interactive Music Objects.
To edit properties of multiple items:
Modifying a property (slider, combo, or check box) sets the property to the same value for all selected objects.
Holding the Alt key and dragging a slider offsets the selected objects' values instead of setting them to an absolute value.
Interface Element |
Description | |||
---|---|---|---|---|
Click the View Settings icon in the upper right corner of the view. The Object Property Settings dialog opens. Select the individual properties for every possible Wwise object type that you want to display. | ||||
Name |
The name of the query. | |||
Opens the selector menu, where you can create a new query or select an existing one. | ||||
Clears all criteria and search results from the Query Editor. | ||||
Notes |
Any additional information used to describe the query. | |||
Query From |
The type of object or other project element for which you are searching, for example, sound, Audio Bus, SoundBank, and so on. Alternatively, you can select WAQL Query from the list to enable the WAQL Query field. | |||
Start From |
The location in the project hierarchy where your query will begin. | |||
Opens the Project Explorer - Browser dialog where you can navigate to the location where you want your query to begin. | ||||
Resets the Start From Here location. | ||||
WAQL Query |
The WAQL query you would like to execute. Refer to Understanding the Wwise Authoring Query Language (WAQL) for details on WAQL queries.
| |||
Platform |
The platform or platforms that you want to include in your search. | |||
Searches through the project for the objects and other project elements that meet your search criteria. | ||||
Criteria | ||||
Browser |
A list of criteria on which you can base your query, such as Name or Output Bus. | |||
Opens a search field where standard alphanumeric entries filter out unmatching elements from the view. Learn more in Using tables. Click the Close icon to the left of the search icon to close the search field and remove the filter.
| ||||
Criteria |
A list of criteria you have selected for your query. | |||
Operator |
The logical operator used when your query contains multiple criteria. The following operators are available: And for items that match all criteria. Or for items that match at least one criteria. | |||
Right-click the table header to open the Configure Columns dialog where you can specify which columns to display and their order. See Using tables. | ||||
Name |
The name and category of the criterion on which you are basing your search. | |||
Condition |
The specific details of the criterion on which you are basing your search. For some criteria, you can use a wildcard operator, which is the asterisk (*) in Wwise, to replace part of a word when you are trying to find different project elements that contain, start with, or end with certain letters or numbers. | |||
Results | ||||
Click the Configure Columns shortcut (right-click) option from the column header band. The Object Property Settings dialog opens. Select the individual properties for every possible Wwise object type that you want to display as a column. | ||||
Opens a search field where standard alphanumeric entries filter out unmatching elements from the view. Learn more in Using tables. Click the Close icon to the left of the search icon to close the search field and remove the filter.
|
Common Columns: If the following properties are selected in the Object Property Settings, they are always present as columns in the results area. Other columns display according to which types of objects are listed in the Results area. | |||||||
Name |
The name of the object or project element that matches your search criteria. | ||||||
Path |
The location in the project hierarchy of the object or project element. | ||||||
Notes |
Defines the notes or comments specified for the object or project element. | ||||||
Type |
The type of object or project element included in your results. For example: sound, bus, SoundBank, Query, Effect, and so on. Default value: All Objects | ||||||
Controls the Mute and Solo states for the object and shows the implicit mute and solo states for the object. Muting an object silences this object for the current monitoring session. Soloing an object silences all the other objects in the project except this one. A bold M or S indicates that the Mute or Solo state has been explicitly set for the object. A non-bold M or S with faded color indicates that the object's Mute or Solo state was implicitly set from another object's state. Muting an object implicitly mutes the descendant objects. Soloing an object implicitly mutes the sibling objects and implicitly solos the descendant and ancestor objects.
|
Platform |
The platform on which the object or project element is located. |
Size Previews: All the Size Preview values are calculated when opening the view. They will, however, auto-refresh when there are fundamental changes, such as changing the platform.
| |||||||
Total Size |
The sum of the element's Media Size and Structure Size, which approximates the total size that they will take up in a SoundBank. | ||||||
Media Size |
An approximation of the total size that a Wwise object's media files, including converted source files, Events, and Effects, will take up within a SoundBank.
The parent object will only display the size of the normally smaller audio buffer files if its media files are set to stream with Zero latency. No size displays for the parent object if its media files stream without Zero latency.
| ||||||
Object Size |
An approximation of the size Wwise objects, excluding the size of sound files on disk, will take up within a SoundBank.
| ||||||
Structure Size |
An approximation of the size an object (Object Size) and its structural descendants will take up within a SoundBank. |
Other Columns: Apart from the columns listed above, many object-type-specific properties can be added as columns. These will display according to your results, when the query returns a configured column's property. | |
Copies query results to the Windows clipboard so you can paste them into another application. |
Questions? Problems? Need more info? Contact us, and we can help!
Visit our Support pageRegister your project and we'll help you get started with no strings attached!
Get started with Wwise