# TexturePeeker

from pandac.PandaModules import TexturePeeker

Class : TexturePeeker
Description : An instance of this object is returned by
Texture::peek(). This object allows quick and easy inspection of a texture's texels by (u, v) coordinates.

## Inheritance:

TexturePeeker: ReferenceCount
ReferenceCount: MemoryBase
MemoryBase:

## Methods of TexturePeeker:

filterRect
getXSize
getYSize
getZSize
lookup

## Methods of ReferenceCount:

getClassType
getRefCount
ref
testRefCountIntegrity
testRefCountNonzero
unref

filterRect void TexturePeeker::filter_rect(LVecBase4f &color, float min_u, float min_v, float max_u, float max_v) const; Description: Fills "color" with the average RGBA color of the texels within the rectangle defined by the specified coordinate range. The texel color is linearly filtered over the entire region. u, v, and w will wrap around regardless of the texture's wrap mode.

getXSize int TexturePeeker::get_x_size(void) const; Description: Returns the width of the texture image that is contributing to the TexturePeeker's information. This may be either the Texture's full width, or its simple ram image's width.

getYSize int TexturePeeker::get_y_size(void) const; Description: Returns the height of the texture image that is contributing to the TexturePeeker's information. This may be either the Texture's full height, or its simple ram image's height.

getZSize int TexturePeeker::get_z_size(void) const; Description: Returns the depth of the texture image that is contributing to the TexturePeeker's information.

lookup void TexturePeeker::lookup(LVecBase4f &color, float u, float v) const; Description: Fills "color" with the RGBA color of the texel at point (u, v). The texel color is determined via nearest-point sampling (no filtering of adjacent pixels), regardless of the filter type associated with the texture. u, v, and w will wrap around regardless of the texture's wrap mode. Description: Fills "color" with the RGBA color of the texel at point (u, v, w).

getClassType static TypeHandle ReferenceCount::get_class_type(void); Undocumented function.

getRefCount int ReferenceCount::get_ref_count(void) const; Description: Returns the current reference count.

ref void ReferenceCount::ref(void) const; Description: Explicitly increments the reference count. User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically. This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

testRefCountIntegrity bool ReferenceCount::test_ref_count_integrity(void) const; Description: Does some easy checks to make sure that the reference count isn't completely bogus. Returns true if ok, false otherwise.

testRefCountNonzero bool ReferenceCount::test_ref_count_nonzero(void) const; Description: Does some easy checks to make sure that the reference count isn't zero, or completely bogus. Returns true if ok, false otherwise.

unref bool ReferenceCount::unref(void) const; Description: Explicitly decrements the reference count. Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic; plus, we don't have a virtual destructor anyway.) However, see the helper function unref_delete(). User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically. This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it. The return value is true if the new reference count is nonzero, false if it is zero.