Texture Stats Browser Reference

Overview

The Texture Stats Browser allows to track memory usage of textures and browse the data conveniently in the editor. Tracking actual texture memory usage of a remotely connected game (PC or Xbox360) is possible. Tracking on disk usage is split into the level shared higher resolution mip levels and the lower mip resolution levels that are stored for each level (redundancy for faster loading). The data is presented in a table form and allows sorting by the various properties that are gathered with each texture asset. Individual assets or groups of can be marked and hidden to narrow down the scope to the ones that require attention. The browser tool also allows you to jump to the material or actor that required the texture to be loaded.

Opening the Texture Stats Browser

The Texture Stats Browser can be accessed through the View menu of the level editor. Selecting the Browser Windows > Texture Stats option will open the Texture Stats Browser directly. Another option is to click the Open the Content Browser button in the main level editor toolbar and then select the Texture Stats tab in the browser window that opens.

Texture Stats Browser Interface

The Texture Stats Browser is divided into four regions:

1. Menu Bar
2. Tool Bar
3. Stat List

Menu Bar

File

• Export - Exports the texture stats to a CSV file.

View

• Refresh - refresh the texture stats.

Docking

• Docked - This option will dock a currently floating browser into the main browser window. When the current browser is docked, this option appears checked.
• Floating - This option will undock a docked browser from the main browser window causing it to become a floating browser in its own window. When the current browser is floating, this option will be checked.
• Clone Browser - This option will create a duplicate of the current browser.
• Remove Browser - This option will remove or delete the current browser. This option is only enabled on cloned browser windows.

Tool Bar

	Changes the listing mode of the stat list.
	Shows the current and fully loaded texture memory usage.
	Hides the currently selected textures in the stat list.
	Unhides all hidden textures in the stat list.

How to use the "Remote Capture"

After starting the editor the remote connection target may need to be chosen.

Now in the texture stats the mode "Remote Capture" can be used:

Texture Listing Mode

The different modes explained:

Selected Actor(s)

This finds all texture assets that are directly or indirectly requested by the currently selected actor(s) in the viewport.

Note: Pay attention to the Uses number. 0 means the garbage collector found some connection which is useful to know because the asset will be cooked in but often this can be very indirect (e.g. decal spawned what the asset is hit). Often it's more useful to look at the Uses values bigger than 0. Those are more directly related.

Selected Material(s)

This finds all texture assets that are directly or indirectly requested by the material(s) currently selected in the content browser.

Current Streaming Level

This reports all texture assets required for the current level.

All Streaming Levels

This reports all texture assets required for all levels.

Cooker Statistics

This allows you to specify a file produced by the cooker called GlobalPersistentCookerData.upk. This file should be created by the build process. This is most useful to reduce disk size.

Remote Capture

This allows you to get the most accurate in game data as it connects to a real game on console or PC (can be the same machine). This is mostly useful to reduce video memory usage and find assets requested by code.

Stat List

Interaction with the list:

• Double-clicking the left mouse button on a line will jump to the texture in the Content Browser (if the texture path can be found in the available packages).
• Right-clicking on a line opens the stat list context menu.
• Clicking on the column labels sorts by that criteria, another click sorts in the opposite order. Two sort criteria are maintained to allow more convenient browsing.
• Left-clicking (shift and control for more option) allows to select assets.
• The selected assets can be hidden though the context menu or by the "Hide Selection" button.
• The hidden list of assets is maintained until the editor is quit or the hidden assets are revealed by clicking the "Unhide All" button.

Context Menu

• Find Actors using this texture - Selects any actors using the selected texture(s) and focuses the camera on them.
• Find Materials using this texture in the Content Browser - Opens the Content Browser and selects any materials which use the selected texture(s).
• Invert Selection - Clears the selection and then selects all textures in the stat list which were not previously selected.
• Hide Selection - Hides the currently selected textures in the stat list.
• Unhide All - Unhides all currently hidden textures in the stat list.