pub struct TransformFeedbackSession<'a> { /* private fields */ }
Expand description
Transform feedback allows you to obtain in a buffer the list of the vertices generated by the vertex shader, geometry shader, or tessellation evaluation shader of your program. This is usually used to cache the result in order to draw the vertices multiple times with multiple different fragment shaders.
To use transform feedback, you must create a transform feedback session. A transform feedback session mutably borrows the buffer where the data will be written. Each draw command submitted with a session will continue to append data after the data written by the previous draw command. You can only use the data when the session is destroyed.
§Notes
Here are a few things to note if you aren’t familiar with transform feedback:
-
The program you use must have transform feedback enabled, either with attributes in the vertex shader’s source code (for recent OpenGL versions only) or by indicating a list of vertex attributes when building the program.
-
A transform feedback session is bound to a specific program and buffer. You can’t switch them once the session has been created. An error is generated if you draw with a different program than the one you created the session with.
-
The transform feedback process doesn’t necessarily fill the whole buffer. To retrieve the number of vertices that are written to the buffer, use a query object (see the
draw_parameters
module). It is however usually easy to determine in advance the number of vertices that will be written based on the input data. -
The buffer will obtain either a list of points, a list of lines (two vertices), or a list of triangles (three vertices). If you draw a triangle strip or a triangle fan for example, individual triangles will be written to the buffer (meaning that some vertices will be duplicated).
-
You can use the same session multiple times in a row, in which case the data will continue to be pushed in the buffer after the existing data. However you must always use the same type of primitives and the same program.
§Example
#[derive(Copy, Clone, Debug, PartialEq)]
struct Vertex {
output_val: (f32, f32),
}
implement_vertex!(Vertex, output_val);
let mut out_buffer: glium::VertexBuffer<Vertex> = glium::VertexBuffer::empty(&display, 6).unwrap();
{
let session = glium::vertex::TransformFeedbackSession::new(&display, &program,
&mut out_buffer).unwrap();
let params = glium::DrawParameters {
transform_feedback: Some(&session),
.. Default::default()
};
display.draw().draw(&vb, &ib, &program, &uniform!{}, ¶ms).unwrap();
}
let result: Vec<Vertex> = out_buffer.read().unwrap();
println!("List of generated vertices: {:?}", result);
Implementations§
Source§impl<'a> TransformFeedbackSession<'a>
impl<'a> TransformFeedbackSession<'a>
Sourcepub fn new<F, V>(
facade: &F,
program: &'a Program,
buffer: &'a mut Buffer<[V]>,
) -> Result<TransformFeedbackSession<'a>, TransformFeedbackSessionCreationError>
pub fn new<F, V>( facade: &F, program: &'a Program, buffer: &'a mut Buffer<[V]>, ) -> Result<TransformFeedbackSession<'a>, TransformFeedbackSessionCreationError>
Builds a new transform feedback session.
TODO: this constructor should ultimately support passing multiple buffers of different types
Trait Implementations§
Source§impl<'a> Debug for TransformFeedbackSession<'a>
impl<'a> Debug for TransformFeedbackSession<'a>
Auto Trait Implementations§
impl<'a> Freeze for TransformFeedbackSession<'a>
impl<'a> !RefUnwindSafe for TransformFeedbackSession<'a>
impl<'a> !Send for TransformFeedbackSession<'a>
impl<'a> !Sync for TransformFeedbackSession<'a>
impl<'a> Unpin for TransformFeedbackSession<'a>
impl<'a> !UnwindSafe for TransformFeedbackSession<'a>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<T> SetParameter for T
impl<T> SetParameter for T
Source§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
Source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read moreSource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).Source§unsafe fn to_subset_unchecked(&self) -> SS
unsafe fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.Source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.