GraphicsStateGuardian

Inheritance:

Methods of GraphicsStateGuardian:

Methods of GraphicsStateGuardianBase:

Methods of TypedWritableReferenceCount:

Methods of TypedWritable:

Methods of TypedObject:

Methods of ReferenceCount:

getClassType
static TypeHandle GraphicsStateGuardian::get_class_type(void);

Undocumented function.

getColorScaleViaLighting
bool GraphicsStateGuardian::get_color_scale_via_lighting(void) const;

Description: Returns true if this particular GSG can implement (or would prefer to implement) set color and/or color scale using materials and/or ambient lights, or false if we need to actually munge the color.

getCoordinateSystem
CoordinateSystem GraphicsStateGuardian::get_coordinate_system(void) const;

Description: Returns the coordinate system in effect on this particular gsg. Normally, this will be the default coordinate system, but it might be set differently at runtime.

getCopyTextureInverted
bool GraphicsStateGuardian::get_copy_texture_inverted(void) const;

Description: Returns true if this particular GSG has the property that any framebuffer-to-texture copy results in a texture that is upside-down and backwards from Panda's usual convention; that is, it copies into a texture from the bottom up instead of from the top down.
If this is true, then on offscreen GraphicsBuffer created for the purposes of rendering into a texture should be created with the invert flag set true, to compensate. Panda will do this automatically if you create an offscreen buffer using GraphicsOutput::make_texture_buffer().

getEngine
GraphicsEngine *GraphicsStateGuardian::get_engine(void) const;

Description: Returns the graphics engine that created this GSG.

getGlobalGsg
static GraphicsStateGuardian *GraphicsStateGuardian::get_global_gsg(void);

Description: Returns the "global" GSG, which is to say, the GraphicsStateGuardian object that has most recently had make_global_gsg() called for it. It may return NULL if there is no such GSG.
This object should be used for optimization hints where appropriate, for instance by operations like NodePath::flatten_strong().

getMax3dTextureDimension
int GraphicsStateGuardian::get_max_3d_texture_dimension(void) const;

Description: Returns the largest possible texture size in any one dimension for a 3-d texture, or -1 if there is no particular limit. Returns 0 if 3-d textures are not supported.
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxClipPlanes
int GraphicsStateGuardian::get_max_clip_planes(void) const;

Description: Returns the maximum number of simultaneous clip planes that may be applied to geometry, or -1 if there is no particular limit.
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxCubeMapDimension
int GraphicsStateGuardian::get_max_cube_map_dimension(void) const;

Description: Returns the largest possible texture size in any one dimension for a cube map texture, or -1 if there is no particular limit. Returns 0 if cube map textures are not supported.
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxLights
int GraphicsStateGuardian::get_max_lights(void) const;

Description: Returns the maximum number of simultaneous lights that may be rendered on geometry, or -1 if there is no particular limit.
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxTextureDimension
int GraphicsStateGuardian::get_max_texture_dimension(void) const;

Description: Returns the largest possible texture size in any one dimension supported by the GSG, or -1 if there is no particular limit.
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxTextureStages
int GraphicsStateGuardian::get_max_texture_stages(void) const;

Description: Returns the maximum number of simultaneous textures that may be applied to geometry with multitexturing, as supported by this particular GSG. If you exceed this number, the lowest-priority texture stages will not be applied. Use TextureStage::set_priority() to adjust the relative importance of the different texture stages.
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxVertexTransformIndices
int GraphicsStateGuardian::get_max_vertex_transform_indices(void) const;

Description: Returns the maximum number of transforms there may be in a single TransformTable for this graphics hardware. If this number is 0 (but get_max_transforms() is nonzero), then the graphics hardware (or API) doesn't support indexed transforms, but can support direct transform references.
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxVertexTransforms
int GraphicsStateGuardian::get_max_vertex_transforms(void) const;

Description: Returns the maximum number of transform matrices that may be simultaneously used to transform any one vertex by the graphics hardware. If this number is 0, then the hardware (or the graphics backend) doesn't support soft-skinned vertices (in which case Panda will animate the vertices in software).
The value returned may not be meaningful until after the graphics context has been fully created (e.g. the window has been opened).

getMaxVerticesPerArray
int GraphicsStateGuardian::get_max_vertices_per_array(void) const;

Description: Returns the maximum number of vertices that should be put into any one GeomVertexData object for use with this GSG.

getMaxVerticesPerPrimitive
int GraphicsStateGuardian::get_max_vertices_per_primitive(void) const;

Description: Returns the maximum number of vertex indices that should be put into any one GeomPrimitive object for use with this GSG.

getPipe
GraphicsPipe *GraphicsStateGuardian::get_pipe(void) const;

Description: Returns the graphics pipe on which this GSG was created.

getProperties
FrameBufferProperties const &GraphicsStateGuardian::get_properties(void) const;

Description: Returns the frame buffer properties requested for this GSG. All windows created for this GSG must be created with the same properties.

getSupports3dTexture
bool GraphicsStateGuardian::get_supports_3d_texture(void) const;

Description: Returns true if this GSG can render 3-d (volumetric) textures.

getSupportsBasicShaders
bool GraphicsStateGuardian::get_supports_basic_shaders(void) const;

Description: Returns true if this particular GSG supports arbfp1+arbvp1 or above.

getSupportsCubeMap
bool GraphicsStateGuardian::get_supports_cube_map(void) const;

Description: Returns true if this GSG can render cube map textures.

getSupportsDepthTexture
bool GraphicsStateGuardian::get_supports_depth_texture(void) const;

Description: Returns true if this particular GSG supports textures whose format is F_depth_component.

getSupportsGenerateMipmap
bool GraphicsStateGuardian::get_supports_generate_mipmap(void) const;

Description: Returns true if this particular GSG can generate mipmaps for a texture automatically, or if they must be generated in software. If this is true, then mipmaps can safely be enabled for rendered textures (e.g. using the MultitexReducer).

getSupportsRenderTexture
bool GraphicsStateGuardian::get_supports_render_texture(void) const;

Description: Returns true if this particular GSG can render directly into a texture, or false if it must always copy-to-texture at the end of each frame to achieve this effect.

getSupportsShadowFilter
bool GraphicsStateGuardian::get_supports_shadow_filter(void) const;

Description: Returns true if this particular GSG supports the filter mode FT_shadow for depth textures.

getSupportsTextureCombine
bool GraphicsStateGuardian::get_supports_texture_combine(void) const;

Description: Returns true if this particular GSG can use the TextureStage::M_combine mode, which includes all of the texture blend modes specified by set_combine_rgb() and/or set_combine_alpha(). If this is false, you must limit yourself to using the simpler blend modes.

getSupportsTextureDot3
bool GraphicsStateGuardian::get_supports_texture_dot3(void) const;

Description: Returns true if this GSG can use the TextureStage::CM_dot3_rgb or CM_dot3_rgba combine modes.

getSupportsTextureSavedResult
bool GraphicsStateGuardian::get_supports_texture_saved_result(void) const;

Description: Returns true if this GSG can use the TextureStage::CS_last_saved_result source, which allows you to save the result of a TextureStage and re-use it for multiple inputs.

getThreadingModel
GraphicsThreadingModel const &GraphicsStateGuardian::get_threading_model(void) const;

Description: Returns the threading model that was used to create this GSG.

isActive
bool GraphicsStateGuardian::is_active(void) const;

Description: Returns the active flag associated with the GraphicsStateGuardian.

isValid
bool GraphicsStateGuardian::is_valid(void) const;

Description: Returns true if the GSG has been correctly initialized within a graphics context, false if there has been some problem or it hasn't been initialized yet.

makeGlobalGsg
void GraphicsStateGuardian::make_global_gsg(void);

Description: Marks this particular GraphicsStateGuardian as the "global" GSG, which is used for optimization hints by operations like NodePath::flatten_strong().

prefersTriangleStrips
bool GraphicsStateGuardian::prefers_triangle_strips(void) const;

Description: Returns true if this GSG strongly prefers triangle strips to individual triangles (such as SGI), or false if it prefers to minimize the number of primitive batches, even at the expense of triangle strips (such as most PC hardware).

releaseAll
void GraphicsStateGuardian::release_all(void);

Description: Releases all prepared objects.

releaseAllGeoms
int GraphicsStateGuardian::release_all_geoms(void);

Description: Frees the resources for all geoms associated with this GSG.

releaseAllIndexBuffers
int GraphicsStateGuardian::release_all_index_buffers(void);

Description: Frees the resources for all index buffers associated with this GSG.

releaseAllTextures
int GraphicsStateGuardian::release_all_textures(void);

Description: Frees the resources for all textures associated with this GSG.

releaseAllVertexBuffers
int GraphicsStateGuardian::release_all_vertex_buffers(void);

Description: Frees the resources for all vertex buffers associated with this GSG.

setActive
void GraphicsStateGuardian::set_active(bool active);

Description: Sets the active flag associated with the GraphicsStateGuardian. If the GraphicsStateGuardian is marked inactive, nothing is rendered. This is not normally turned off unless there is a problem with the rendering detected at a low level.

setCoordinateSystem
void GraphicsStateGuardian::set_coordinate_system(CoordinateSystem cs);

Description: Changes the coordinate system in effect on this particular gsg. This is also called the "external" coordinate system, since it is the coordinate system used by the scene graph, external to to GSG.
Normally, this will be the default coordinate system, but it might be set differently at runtime.

getClassType
static TypeHandle GraphicsStateGuardianBase::get_class_type(void);

Undocumented function.

getSupportedGeomRendering
virtual int GraphicsStateGuardianBase::get_supported_geom_rendering(void) const = 0;

Undocumented function.

getSupportsMultisample
virtual bool GraphicsStateGuardianBase::get_supports_multisample(void) const = 0;

Undocumented function.

getClassType
static TypeHandle TypedWritableReferenceCount::get_class_type(void);

Undocumented function.

getClassType
static TypeHandle TypedWritable::get_class_type(void);

Undocumented function.

getBestParentFromSet
int TypedObject::get_best_parent_from_Set(set< int > const &) const;

Description: Returns true if the current object is the indicated type exactly.

getClassType
static TypeHandle TypedObject::get_class_type(void);

Undocumented function.

getType
virtual TypeHandle TypedObject::get_type(void) const = 0;

Derived classes should override this function to return get_class_type().

getTypeIndex
int TypedObject::get_type_index(void) const;

Description: Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. This is equivalent to get_type().get_index().

isExactType
bool TypedObject::is_exact_type(TypeHandle handle) const;

Description: Returns true if the current object is the indicated type exactly.

isOfType
bool TypedObject::is_of_type(TypeHandle handle) const;

Description: Returns true if the current object is or derives from the indicated type.

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
int 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.
The return value is the new reference count.

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.

unref
int 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 the new reference count.