Defining and Running a Query

When you run a query for the first time, you decide which criteria will be used for searching through the project. These criteria are saved automatically so you can save time when you run the same query again in the future.

[Note] Note

Query results take into account object-level properties that are not currently in use because they are being overridden by a parent. If you encounter unexpected results in the Query Editor, you can look for hidden object-level properties by temporarily enabling the Override parent option in the Property Editor.

To define the contents of a query:

  1. Load a query into the Query Editor.

  2. Type any additional information about the query in the Notes field.

  3. In the Query From list, do one of the following:

    • Select the type of object or other project element you want to search for. If you do not want to search for a specific type of object, select All Objects.

      To specify a location in the hierarchy from which your query will begin, do the following:

      • Next to the Start From Here box, click the Browse button (...).

      • The Project Explorer - Browser dialog box opens.

      • Navigate to the folder where you want Wwise to begin searching.

      • Click OK.

        [Note] Note

        To clear the starting location you have selected, click Reset.

    • Select WAQL Query if you want to perform a WAQL query. The WAQL Query field becomes available and the Start From field becomes unavailable. Refer to Understanding the Wwise Authoring Query Language (WAQL) for details on creating a WAQL query.

  4. From the Platform list, select one of the following options:

    • All to search for objects that are used on any platform included in the project.

    • Current to search for objects that are used on the currently selected platform.

  5. In the browser list, select each criterion on which you want to base your query. Do the following:

    Double-click a criterion to load it into the Criteria list.

    Type or select a condition for the criterion. You can use the wildcard operator (*) to replace part of a word when you are typing a criterion.

    [Note] Note

    To delete a criterion, right-click it and select Remove.

  6. From the Operator list, select one of the following:

    And to return results for which all your criteria are true.

    Or to return results for which at least one of your criteria are true.

    [Note] Note

    If you need to create a more sophisticated query that contains both operators, you can create a criteria group. For more information on criteria groups, refer to Creating Advanced Queries Using Criteria Groups.

  7. Click Run Query.

    The query results are displayed. You can sort these results by clicking each column heading.

    [Tip] Tip

    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 any entry in the Results list 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.

  8. To keep the results of your query for use in another application, click Copy to Clipboard.

  9. To clear your criteria and search results, click Clear.

[Note] Note

In Wwise, objects have inherent properties that persist even if these are replaced by those of parent objects. If you are finding false positives in your results, that is, results that do not contain the criteria for which you were searching, these objects might have inherent properties that are being overridden with the Override parent option.

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise