User Guide

purgePriority 939
When projection is #orthographic, the apparent size of objects does not depend on distance
from the camera, and the
orthoHeight property specifies how many world units fit vertically
into the sprite (which determines how much of the world you see). The orthographic projection
width is determined by the aspect ratio of the camera's
rect property.
Example
This statement sets the projection property of the camera of sprite 5 to #orthographic:
sprite(5).camera.projection = #orthographic
See also
fieldOfView (3D), orthoHeight, fieldOfView (3D)
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;