Clarisse is built upon a smart memory manager that detects and eliminates, automatically redundant data. This data can be of any kinds so that they are not only limited to geometries and images. These data are called Resources and can represent any arbitrary data that can be potentially shared by the items of the application.
There can be several thousand of resources in a typical production scene. Since Resources are automatically created or loaded during evaluations, Clarisse provides, the Resource View, a dedicated widget to manage and monitor them. The Resource View allows to manage, sort, track and clear resources that are currently in Clarisse memory. It is divided into two parts: the resource toolbar and the resource list.
(1) Empty Resource Visibility Toggle (2) Display File Resource only Toggle (3) Show Shared Resources (4) Clear Resource (5) Reload Resource (6) Resource Information (7) Resource Memory Statistic (8) Resource List
The resource list (8) is where resources and their information are displayed. Here, you can sort items either by Path, Class, Tag, Size and Requester Count.
|Path||As Resources have no name, it displays the path of the first item declaring the resource.|
|Class||Object class declaring the resource.|
|Tag||Optional description of the resource.|
|Size||Memory size used by the resource.|
|Requester Count||Number of requester using this resource. The higher the number, the higher the de-duplication.|
When you select one or multiple resources, the Resource View selects all items sharing those resources.
The Resource View displays memory statistics related to what is currently loaded in memory. These statistics only cover resource memory consumption. To have more complete statistics please use Help > Log Statistics... or press Ctrl+Shift+F1.
Resource count is the total number of resources declared in the memory (empty or not). The Requester count displays the number of items requesting resources. An item can request one or more different resources.
For example, geometries can request over 20 different resources.
At the right is located memory usage statistics. The first digit displays a good approximation of the physical memory used by all resources. The second digit displays the amount of RAM Clarisse would virtually need if there were no de-duplication. Finally the last digit, in percentage, is the ratio between real memory usage over the total virtual memory usage. Lower values mean high level of de-duplication.
When an item is created without being evaluated (not rendered or seen...), its resources are likely to be empty since Clarisse allocates data only when necessary. The Hide Empty Resources (1) toggle button allows you to filter the display of declared empty resources in the Resource List (8).
In this scene we've created only an empty implicit Box. It has only empty resources as no widgets required any of its data.
After displaying a 3D View showing the Box, 3 of its resources have been automatically created.
Renabling Hide empty resource displays only 3 resources.
There are two kind of resources: generated resources or resources originating from a file. Using the Resource View you can filter the resource list to display only file resources by clicking on the disk icon (2).
File filter enabled, the Resource View displays only file resources
If a file has been modified, you can reload file resources at any time and even during an evaluation. To reload one or more resources, just select them in the resource list and press Reload (5). Clarisse reloads files only if they are modified. Alternatively, you can use Reload All (5) to reload any modified file resources or use File > Reload Resources or Ctrl+R.
You can clear any existing resources at any time and even during an evaluation. To clear a resource, either select it in the resource list (8) or select an object in Clarisse using the browser for example.
Then press Clear (3). An easy way to clear all resources used by an item, is to select this item in Clarisse. When you select an object in Clarisse, all its resources are selected in the Resource View.
If you wish to free memory, you can also sort the resource list (8) by memory usage. click on the Size column to sort items in ascending or descending order.
Resources sorted by memory usage
You can also clear all resources that are in memory by pressing Clear All (3).