TheCloud/panda3d
1
0
Fork 0
mirror of https://github.com/panda3d/panda3d.git synced 2025-09-30 08:44:19 -04:00
Code Issues Packages Projects Releases Wiki Activity

update comment

Browse Source
This commit is contained in:
David Rose 2003-01-13 16:16:20 +00:00
parent 9ac12dbe92
commit 48ac976821
2 changed files with 32 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
panda/src/gobj/texture.I
View File

@ -90,6 +90,27 @@ uses_mipmaps() const {
// Description: Returns true if the Texture has its image contents
// available in main RAM, false if it exists only in
// texture memory or in the prepared GSG context.
// Note that this has nothing to do with whether
// get_ram_image() will fail or not. Even if
// has_ram_image() returns false, get_ram_image() may
// still return a valid RAM image, because
// get_ram_image() will automatically load the texture
// from disk if necessary. The only thing
// has_ram_image() tells you is whether the texture is
// available right now without hitting the disk first.
//
// Note also that if an application uses only one GSG,
// it may appear that has_ram_image() returns true if
// the texture has not yet been loaded by the GSG, but
// this correlation is not true in general and should
// not be depended on. Specifically, if an application
// ever uses multiple GSG's in its lifetime (for
// instance, by opening more than one window, or by
// closing its window and opening another one later),
// then has_ram_image() may well return false on
// textures that have never been loaded on the current
// GSG.
////////////////////////////////////////////////////////////////////
INLINE bool Texture::
has_ram_image() const {

14
panda/src/gobj/texture.cxx
View File

@ -503,9 +503,17 @@ clear_gsg(GraphicsStateGuardianBase *gsg) {
// false, and we have previously prepared this texture
// with a GSG.
//
// It is possible that the RAM image is still
// unavailable. If that happens, this function returns
// NULL.
// Note that it is not correct to call has_ram_image()
// first to test whether this function will fail. A
// false return value from has_ram_image() indicates
// only that get_ram_image() may need to reload the
// texture from disk, which it will do automatically.
//
// On the other hand, it is possible that the texture
// cannot be found on disk or is otherwise unavailable.
// If that happens, this function returns NULL. There
// is no way to predict whether get_ram_image() will
// return NULL without calling it first.
////////////////////////////////////////////////////////////////////
PixelBuffer *Texture::
get_ram_image() {