Syntax

  GetPerformanceMetric( numMetrictype, "optTagDescription" )  

numMetrictype

The type of performance metric to get, as shown in the table below:

Value of numMetrictype	Description, including the string that is written to optTagDescription
0	Memory Allocation Enabled How the virtual memory is currently allocated to shared objects: 0 = Disabled; 1 = Always; 2 = Dynamic; 3 = Critical. Disabled The Enable memory allocation option (Project Settings > Options > Performance Control) is not selected. Objects are loaded into memory only when they are actually used, and then they are immediately removed afterwards. Always Objects are always kept in memory, in order to increase run-time performance. Dynamic Objects are kept in memory until the memory is needed for new objects. If enough memory is freed, then the memory allocation state may return from Dynamic to Always. Critical All unused objects are cleared from memory and memory allocation is disabled until the project is restarted. This is effectively the same as Disabled (see above), except that the Enable memory allocation option is still selected.
1	Critical Free Memory Limit (KB) When the amount of free virtual memory (in KB) decreases to this limit, the memory allocation state is changed from Dynamic to Critical. This limit is set in Project Settings > Options > Performance Control.
2	Min Free Memory Limit (KB) When the amount of free virtual memory (in KB) decreases to this limit, the memory allocation state is changed from Always to Dynamic. This limit is set in Project Settings > Options > Performance Control.
3	Free Memory (KB) The amount of free virtual memory, in kilobytes.
4	Free Memory (%) The amount of free virtual memory, as a percentage of total virtual memory.
5	Total Allocation Allowed The maximum number of total shared objects that can be allocated.
6	Total Allocation Count The number of total shared objects that are currently allocated.
7	Total Allocation (%) The percentage ( count / allowed ) of total shared objects that are allocated.
8	Brush Allocation Allowed The maximum number of shared brush objects that can be allocated.
9	Brush Allocation Count The number of shared brush objects that are currently allocated.
10	Brush Allocation (%) The percentage ( count / allowed ) of shared brush objects that are allocated.
11	Brush Allocation State How the memory for shared brush objects is currently allocated: 0 = Disabled; 1 = Always; 2 = Dynamic; 3 = Critical.
12	Font Allocation Allowed The maximum number of shared font objects that can be allocated.
13	Font Allocation Count The number of shared font objects that are currently allocated.
14	Font Allocation (%) The percentage ( count / allowed ) of shared font objects that are allocated.
15	Font Allocation State How the memory for shared font objects is currently allocated: 0 = Disabled; 1 = Always; 2 = Dynamic; 3 = Critical.
16	Pen Allocation Allowed The maximum number of shared pen objects that can be allocated.
17	Pen Allocation Count The number of shared pen objects that are currently allocated.
18	Pen Allocation (%) The percentage ( count / allowed ) of shared pen objects that are allocated.
19	Pen Allocation State How the memory for shared pen objects is currently allocated: 0 = Disabled; 1 = Always; 2 = Dynamic; 3 = Critical.
20	Bitmap Allocation (%) The percentage ( count / allowed ) of shared bitmap objects that are allocated.
21	Bitmap Allocation Count The number of shared bitmap objects that are currently allocated.
22	Bitmap Allocation Allowed The maximum number of shared bitmap objects that can be allocated.
23	Bitmap Allocation State How the memory for shared bitmap objects is currently allocated: 0 = Disabled; 1 = Always; 2 = Dynamic; 3 = Critical.
24	Image Allocation Allowed The maximum number of shared image objects that can be allocated.
25	Image Allocation Count The number of shared image objects that are currently allocated.
26	Image Allocation (%) The percentage ( count / allowed ) of shared image objects that are allocated.
27	Image Allocation State How the memory for shared image objects is currently allocated: 0 = Disabled; 1 = Always; 2 = Dynamic; 3 = Critical.
28	Buffer Allocation Allowed The maximum number of shared buffer objects that can be allocated.
29	Buffer Allocation Count The number of shared buffer objects that are currently allocated.
30	Buffer Allocation (%) The percentage ( count / allowed ) of shared buffer objects that are allocated.
31	Buffer Allocation State How the memory for shared buffer objects is currently allocated: 0 = Disabled; 1 = Always; 2 = Dynamic; 3 = Critical.

optTagDescription

The name of a String tag that will receive a description of the selected metric. The description is the same as shown in the table for numMetrictype above.

Note: The tag name should be enclosed in quotes, as shown in the syntax diagram, or else the function will try to use the value of the tag.

This parameter is optional.

Returned value

Notes

For more information about memory allocation, see Configure the performance control settings.