Struct GLContext

pub struct GLContext { /* private fields */ }

GLContext is an object representing a platform-specific OpenGL draw context.

GLContexts are created for a surface using SurfaceExt::create_gl_context(), and the context will match the characteristics of the surface.

A GLContext is not tied to any particular normal framebuffer. For instance, it cannot draw to the surface back buffer. The GDK repaint system is in full control of the painting to that. Instead, you can create render buffers or textures and use [draw_from_gl()][crate::draw_from_gl()] in the draw function of your widget to draw them. Then GDK will handle the integration of your rendering with that of other widgets.

Support for GLContext is platform-specific and context creation can fail, returning None context.

A GLContext has to be made “current” in order to start using it, otherwise any OpenGL call will be ignored.

Creating a new OpenGL context

In order to create a new GLContext instance you need a Surface, which you typically get during the realize call of a widget.

A GLContext is not realized until either GLContextExt::make_current() or GLContextExt::realize() is called. It is possible to specify details of the GL context like the OpenGL version to be used, or whether the GL context should have extra state validation enabled after calling SurfaceExt::create_gl_context() by calling GLContextExt::realize(). If the realization fails you have the option to change the settings of the GLContext and try again.

Using a GdkGLContext

You will need to make the GLContext the current context before issuing OpenGL calls; the system sends OpenGL commands to whichever context is current. It is possible to have multiple contexts, so you always need to ensure that the one which you want to draw with is the current one before issuing commands:

⚠️ The following code is in c ⚠️

gdk_gl_context_make_current (context);

You can now perform your drawing using OpenGL commands.

You can check which GLContext is the current one by using current(); you can also unset any GLContext that is currently set by calling clear_current().

This is an Abstract Base Class, you cannot instantiate it.

Properties

allowed-apis

The allowed APIs.

Readable | Writeable

api

The API currently in use.

Readable

shared-context

Always None

As many contexts can share data now and no single shared context exists anymore, this function has been deprecated and now always returns None.

Readable | Writeable | Construct Only

DrawContext

display

The Display used to create the DrawContext.

Readable | Writeable | Construct Only

surface

The Surface the context is bound to.

Readable | Writeable | Construct Only

Implements

GLContextExt, DrawContextExt, DrawContextExtManual

GLib type: GObject with reference counted clone semantics.

Implementations

impl GLContext

pub const NONE: Option<&'static GLContext> = None

pub fn clear_current()

Clears the current GLContext.

Any OpenGL call after this function returns will be ignored until GLContextExt::make_current() is called.

pub fn current() -> Option<GLContext>

Retrieves the current GLContext.

Returns

the current GLContext

Trait Implementations

impl Clone for GLContext

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GLContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for GLContext

type ParamSpec = ParamSpecObject

type SetValue = GLContext

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, GLContext>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for GLContext

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for GLContext

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for GLContext

type Parent = DrawContext

impl<OT: ObjectType> PartialEq<OT> for GLContext

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for GLContext

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for GLContext

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for GLContext

impl IsA<DrawContext> for GLContext