Construct 3 icon

Construct 3

Documentation

The debugger 'Inspect' tab

Published 14 Aug, 2017
419 words
~2-3 mins

The Inspect tab is used to view and edit values in the game, such as an object's position.

The Inspect view is divided in to two sections. On the left appears a list of all the object types in the project, including the System object. On the right appears a list of tables of values relating to the selected object, similar to the Properties Bar.

The object list

Click the name of an object type in the object list to expand it. The number of instances of that object type appears in brackets after the object name. If the object type only has one instance, or is a global object like the System object or Audio object, it will immediately start inspecting the object. Otherwise it expands a dropdown with a list of all the object instances sorted by their index ID (IID). Clicking a particular instance will then inspect just that instance.

The values view

As with the Properties Bar, the values view shows a categorised list of tables displaying all the information about the currently inspected object. The displayed values depend on what is being inspected; for example the Sprite object displays information about its current animation frame, the Audio object displays information about currently playing sound and music, and the System object displays information about the engine, layout, and layers. Most often these values correspond to object properties from the Properties bar, as well as the object's expressions.

Instance variables and behavior values are also shown if the selected object has any.

It is often useful to view these values while running the game. However, they can also be edited. As with the Properties Bar, simply click on a value and type in a new value to change it. Edited values appear in bold. This can be an excellent way to experiment with how your project works. Note that not all values are editable - those with a light grey background are read-only.

The eye icon to the right of values can be used to add the value to the Watch tab Paid plans only. This is described in more detail later on.

The Tools section gives you the ability to destroy the inspected object. By default the inspected object is also outlined with a dotted rectangle in the game to help identify it. If this is distracting, uncheck the Highlight checkbox.

Objects in a container also provide a list of links to inspect the other instances in the container with the currently inspected object.