Skip to main content

Searching

Search for Objects in a Solution

This chapter describes how to use the "Search" panel for advanced searching for objects in a solution.

Specify Search Criteria

Make the Search tab visible in Scene panel. This can be done through the menu "View" - "Search". The select box "Search of Type" allows limiting the search to a specific type of object.

Objects of the following types can be distinguished (listed in alphabetical order):

Any object

Any node

2D Camera

2D Node

3D Camera

3D Node

Animation

Appearance

Behavior

Bitmap

Control

Control Node 2D

Control Node 3D

Effect

Folder

Light

Material

Mesh

Render Node

Render Target

Scene

Script Component

Texture

Vertex Buffer

Widget

In the list below the search type and the search button, specific search criteria can be defined related to a specific property of the selected object type. In the example below, a search for all Bitmaps is defined, where the name contains "Gauge".

drawing-5-1717147737.pngdrawing-5-1717147737.png
  1. Adds additional search criteria. The search function will consider an "AND" operation between several search criteria.  
  2. Deletes an existing search criterion.  
  3. Triggers search action. Pressing the Enter key has the same effect.  

It is possible to search nodes referred by a widget having property types "Node" and to search widgets which use a node or its descendant as widget properties. For convenience purpose this functionality is also offered as a context menu on widgets and nodes in the Solution Explorer.

drawing-5-1700223802.pngdrawing-5-1700223802.png

Any referencing widget can be found by using the context menu via Scene Tree.

drawing-5-1717161051.pngdrawing-5-1717161051.png

If a node is referenced by a widget, the node can be found by using the context menu via Widgets panel.

Search Results

Search results are listed at the right area of the Search panel. Double-click on an object from the result list and it will be highlighted in the Scene tree. If the searched value cannot be converted to the property type selected, a warning message is displayed.

Multiple Selection and Editing

In the result list, multiple objects can be selected. The Properties panel will display all the common properties of the selected items:

  • The value column is filled only for properties with the same value for all selected items. 
  • For the rest of the properties the value column will stay empty. 

It is possible to change the value of a property for all the selected items at once, by editing the property value in the Properties panel.

drawing-5-1717149611.pngdrawing-5-1717149611.png


"Text Search" is a feature that provides the possibility to search a desired text inside a whole solution or just in a single scene. 
Make the Search tab visible in Libraries panel via the menu "View" > "Text Search".

drawing-5-1717149701.pngdrawing-5-1717149701.png

From a logical point of view, the first field that should be set is "Look in". You can select a single scene or the entire solution.

As soon as the "Find what" field is completed, the "Find Next" button becomes active. When the desired word is found, all the other buttons become active. In this way it is possible to find a previous text, or to go forward and find the next one. Replace any of the texts which are found in a solution by: 

  • using the "Replace" button this action is done for a single entry. 
  • using "Replace All" button this action is done for all the places where the desired word is found. 
drawing-5-1717149940.pngdrawing-5-1717149940.png

If the "Match case" check box is checked, only words that match the case of the word or phrase that you typed in the "Find what" field are found. For example, if you search for "Car" (with a capital "C"), the result includes "Car" but not "car".

All the search events are displayed in the SCML Editor.


In SceneComposer every search field offers the possibility to progressively search for and filter through text. When the text is typed, one or more possible matches for the text are found instantly and immediately presented to the user. This feedback allows stopping short of typing the entire word or phrase they were looking for. You may also choose a closely related option from the presented list.

drawing-5-1717152651.pngdrawing-5-1717152651.png

To increase the flexibility and efficiency of searching it is possible to use different wildcards - characters that can be used as a substitute for any of a class of characters.

  • The "Star wildcard" is the most frequently employed and the most useful wildcard, which is the same as an asterisk (*). The star wildcard can represent zero characters, all single characters or any string. For instance, we can use "c*rs" to find "cars" string. 
  • The "Question Mark" wildcard (?) is used to represent exactly one character, which can be any single character. Thus, two question marks in succession would represent any two characters in succession, and three question marks in succession would represent any string consisting of three characters. For example, it is possible to use five question marks in a row (?????) to find all the scenes that have names which contain five characters. 
  • The "Slash" (/) character can be used to follow a given path. 

 

Search Helper

Search Helper is a feature that lets you build search criteria in natural language. When you describe what you want to find, Search Helper generates the corresponding search criteria, and you can apply them to the Search panel.

Search Helper does not answer questions about how to use the product. When you need an explanation of an operation or a feature, use the product documentation (this document) or the Docs Agent panel.

Search Helper communicates with the AI service through Candera Operator. For the settings, see Preferences > AI Service.

Opening and Closing Search Helper

Click the star icon in the Search panel. The Search Helper chat window appears and overlays the input area for the search criteria. To close the chat window, click the × button in the upper right corner.

drawing-4-1788939494.png
Panel Layout
drawing-4-1788939719.png
No Item Description 1 Suggested prompts Suggested instructions that appear when the chat history is empty. When you click one, Search Helper sends it as it is. 2 Input field Describe in words what you want to find. 3 Send button Sends what you entered. Pressing the Enter key has the same effect. 4 Search criteria Shows the generated search criteria in the same structure as the Search panel: search type, attribute, operator, and value. You can add, change, or delete them manually before you apply them. 5 Apply & Search Applies the generated search criteria to the Search panel and runs the search. After Search Helper applies them, the button changes to Undo. 6 Undo When you click Apply & Search, the button name changes to Undo. Click this button to revert the search criteria that you applied last. 7 SerchHelperRestore Appears at each break in the construction of the search criteria. When you click it, Search Helper restores the search criteria of that point and runs the search again. 8 Action buttons Appear when you hold the pointer over a message. They are hidden by default. You can copy the content and clear the chat history.
Basic Operations
    Click the star icon in the Search panel to open Search Helper.
    Enter what you want to find in the input field, and then press the Enter key or click the send button.
    Search Helper generates the search criteria. Check them and, if necessary, add, change, or delete criteria manually.
    Click Apply & Search. Search Helper overwrites the search criteria in the Search panel and runs the search.
      The search results appear at the right side of the Search Helper window. Check the search results. To return to the state before you applied the criteria, click Undo.
        If you have built and run several sets of search criteria, click the SerchHelperRestore of the set that you want instead of clicking Undo. The results for that set appear.

        The result of clicking Apply & Search appears in the search results at the right side of the Search panel. The display of the Search Helper chat window does not change.

        Refining the Criteria

        Search Helper knows the search criteria that exist at the moment you send an instruction. Therefore, you can instruct it to refine the criteria relative to the previous ones, for example, "of those, only the ones whose name contains Rect".

        If the Search panel cannot handle the criteria that you instruct, Search Helper tells you so. If it cannot determine the criteria from your instruction, it asks you to confirm.

        Checking the Generated Search Criteria

        If you instruct a condition that the operators of the Search panel cannot express directly, Search Helper might select an operator that does not match your intent. For example, if you instruct "the ones whose name does not contain Cluster" and Search Helper selects !=, the condition becomes "does not exactly match Cluster", and Search Helper does not exclude names such as Cluster_Speed.

        You can change the generated search criteria manually as long as you have not applied them. If they do not match your intent, correct the operator or the value, or give the instruction again.

        SerchHelperRestore

        Each time you send an instruction, Search Helper saves the search criteria of that moment as a checkpoint. When you click SerchHelperRestore, which appears at each break in the exchange, Search Helper restores the search criteria of that point and runs the search again.

        Action Chat history and checkpoints Close Search Helper and open it again Retained Close the Search panel and open it again Retained Restart Scene Composer Cleared
        Troubleshooting

        If Search Helper shows Client could not connect. in a red error box, Scene Composer cannot connect to Candera Operator. Open File > Preferences from the menu bar, go to Environment > AI Service, and check the settings and the connection.