Panda3D
Public Member Functions | List of all members
AdaptiveLruPage Class Reference

One atomic piece that may be managed by a AdaptiveLru chain. More...

Inheritance diagram for AdaptiveLruPage:
IndexBufferContext TextureContext VertexBufferContext

Public Member Functions

 __init__ (const AdaptiveLruPage copy)
 
 __init__ (int lru_size)
 
 dequeueLru ()
 Removes the page from its AdaptiveLru. More...
 
 enqueueLru (AdaptiveLru lru)
 Adds the page to the LRU for the first time, or marks it recently-accessed if it has already been added. More...
 
 evictLru ()
 Evicts the page from the LRU. More...
 
AdaptiveLru getLru ()
 Returns the LRU that manages this page, or NULL if it is not currently managed by any LRU. More...
 
int getLruSize ()
 Returns the size of this page as reported to the LRU, presumably in bytes. More...
 
unsigned int getNumFrames ()
 Returns the number of frames since the page was first added to its LRU. More...
 
unsigned int getNumInactiveFrames ()
 Returns the number of frames since the page was last accessed on its LRU. More...
 
 markUsedLru ()
 To be called when the page is used; this will move it to the tail of the AdaptiveLru queue it is already on. More...
 
 markUsedLru (AdaptiveLru lru)
 To be called when the page is used; this will move it to the tail of the specified AdaptiveLru queue. More...
 
AdaptiveLruPage operator= (const AdaptiveLruPage copy)
 
 output (Ostream out)
 
 setLruSize (int lru_size)
 Specifies the size of this page, presumably in bytes, although any unit is possible. More...
 
 write (Ostream out, int indent_level)
 

Detailed Description

One atomic piece that may be managed by a AdaptiveLru chain.

To use this class, inherit from it and override evict_lru().

This class multiply inherits from two classes which in turn both inherit from LinkedListNode. This is just a sneaky C++ trick to allow this class to inherit from LinkedListNode twice, so that pages can be stored on two different linked lists simultaneously. The AdaptiveLru class depends on this; it maintains its pages in two different lists, one grouped by priority, and one in order by next partial update needs.

Member Function Documentation

◆ __init__() [1/2]

__init__ ( const AdaptiveLruPage  copy)

◆ __init__() [2/2]

__init__ ( int  lru_size)

◆ dequeueLru()

dequeueLru ( )

Removes the page from its AdaptiveLru.

◆ enqueueLru()

enqueueLru ( AdaptiveLru  lru)

Adds the page to the LRU for the first time, or marks it recently-accessed if it has already been added.

If lru is NULL, it means to remove this page from its LRU.

◆ evictLru()

evictLru ( )

Evicts the page from the LRU.

Called internally when the LRU determines that it is full. May also be called externally when necessary to explicitly evict the page.

It is legal for this method to either evict the page as requested, do nothing (in which case the eviction will be requested again at the next epoch), or requeue itself on the tail of the queue (in which case the eviction will be requested again much later).

◆ getLru()

AdaptiveLru getLru ( )

Returns the LRU that manages this page, or NULL if it is not currently managed by any LRU.

◆ getLruSize()

int getLruSize ( )

Returns the size of this page as reported to the LRU, presumably in bytes.

◆ getNumFrames()

unsigned int getNumFrames ( )

Returns the number of frames since the page was first added to its LRU.

Returns 0 if it does not have an LRU.

◆ getNumInactiveFrames()

unsigned int getNumInactiveFrames ( )

Returns the number of frames since the page was last accessed on its LRU.

Returns 0 if it does not have an LRU.

◆ markUsedLru() [1/2]

markUsedLru ( )

To be called when the page is used; this will move it to the tail of the AdaptiveLru queue it is already on.

This method is const because it's not technically modifying the contents of the page itself.

◆ markUsedLru() [2/2]

markUsedLru ( AdaptiveLru  lru)

To be called when the page is used; this will move it to the tail of the specified AdaptiveLru queue.

◆ operator=()

AdaptiveLruPage operator= ( const AdaptiveLruPage  copy)

◆ output()

output ( Ostream  out)

◆ setLruSize()

setLruSize ( int  lru_size)

Specifies the size of this page, presumably in bytes, although any unit is possible.

◆ write()

write ( Ostream  out,
int  indent_level 
)