purgePriority

Usage

-- Lingo syntax
memberObjRef.purgePriority

// JavaScript syntax
memberObjRef.purgePriority;

Description

Member property; specifies the purge priority of a cast member. Read/write.

A cast member's purge priorities determine the priority that Director follows to choose which cast members to delete from memory when memory is full. The higher the purge priority, the more likely that the cast member will be deleted. The following purgePriority settings are available:

• 0--Never
• 1--Last
• 2--Next
• 3--Normal (default)

The Normal setting lets Director purge cast members from memory at random. The Next, Last, and Never settings allow some control over purging, but Last or Never may cause your movie to run out of memory if several cast members are set to these values.

Setting purgePriority for cast members is useful for managing memory when the size of the movie's cast library exceeds the available memory. As a general rule, you can minimize pauses while the movie loads cast members and reduce the number of times Director reloads a cast member by assigning a low purge priority to cast members that are used frequently in the course of the movie.

Example

This statement sets the purge priority of cast member Background to 3, which makes it one of the first cast members to be purged when memory is needed:

-- Lingo syntax
member("Background").purgePriority = 3

// JavaScript syntax
member("Background").purgePriority = 3;

See also

Member

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/director/mx2004/release_en/09_pr504.htm

Add Comment