Class BindableObject
source code
object --+
|
GLObject --+
|
object --+ |
| |
StateMixin --+
|
BindableObject
- Known Subclasses:
-
Base class for objects that can be bound.
When the object is bound, it returns the object that was previously
bound to the same target.
BindableObject instances can be used in with
statements so that binding and resetting the previous state happens
automatically.
If subclasses define the methods _on_bind or _on_release, these will be
called by the binding handler in the context whenever the instance is
bound or unbound, respectively.
If subclasses define a property _bind_value, this value
will be passed to the binding function instead of self.
Binding of an object to different targets (e.g. buffers that are bound
to different targets, framebuffers that are bound for reading or drawing,
and textures that are bound to different texture image units) is not
covered by the BindableObject class.
|
|
|
|
|
bind(self)
Bind the object and return the previously bound object. |
source code
|
|
|
|
|
|
|
|
|
Inherited from StateMixin:
__call__
Inherited from object:
__delattr__,
__format__,
__getattribute__,
__hash__,
__new__,
__reduce__,
__reduce_ex__,
__repr__,
__setattr__,
__sizeof__,
__str__,
__subclasshook__
|
|
|
_binding = NotImplemented
Name of the corresponding property in the Context.
|
|
|
_on_bind = NotImplemented
Function to call before binding.
|
|
|
_on_release = NotImplemented
Function to call after releasing.
|
|
|
_bind_value = NotImplemented
Value to pass to the _binding property.
|
|
|
_stack
A stack for storing previous bindings within with
statements.
|
|
|
|
Create a new BindableObject.
- Parameters:
context (Context) - The parent context. - Overrides:
object.__init__
|
|
Bind the object and return the previously bound object.
Binding is executed by setting the parent Context's property named in _binding.
- Returns:
- The previous value of the property.
|
|
Called when a with statement is entered.
Activates the parent Context, calls bind and stores the returned value on the _stack.
|
|
Called when a with statement is exited.
Restores the previous binding from the _stack by setting the
attribute named in _binding in the parent Context and deactivates the parent Context.
|
_binding
Name of the corresponding property in the Context.
Example: "array_buffer_binding"
- Value:
-
|
_on_bind
Function to call before binding.
ShaderPrograms, for example, bind textures here.
- Value:
-
|
_on_release
Function to call after releasing.
ShaderPrograms, for example, release textures here.
- Value:
-
|
_bind_value
Value to pass to the _binding property.
If NotImplemented, self will be used.
- Value:
-
|