Struct TexturePixmapX11 

pub struct TexturePixmapX11(/* private fields */);

Implementations

impl TexturePixmapX11

pub fn new( context: &Context, pixmap: u32, automatic_updates: bool, ) -> Result<TexturePixmapX11, Error>

Creates a texture that contains the contents of pixmap. If automatic_updates is true then Cogl will attempt to listen for damage events on the pixmap and automatically update the texture when it changes.

context

A Context

pixmap

A X11 pixmap ID

automatic_updates

Whether to automatically copy the contents of the pixmap to the texture.

Returns

a new TexturePixmapX11 instance

pub fn new_left( context: &Context, pixmap: u32, automatic_updates: bool, ) -> Result<TexturePixmapX11, Error>

Creates one of a pair of textures to contain the contents of pixmap, which has stereo content. (Different images for the right and left eyes.) The left image is drawn using this texture; the right image is drawn using a texture created by calling TexturePixmapX11::new_right and passing in this texture as an argument.

In general, you should not use this function unless you have queried the GLX_STEREO_TREE_EXT attribute of the corresponding window using glXQueryDrawable() and determined that the window is stereo. Note that this attribute can change over time and notification is also provided through events defined in the EXT_stereo_tree GLX extension. As long as the system has support for stereo content, drawing using the left and right pixmaps will not produce an error even if the window doesn’t have stereo content any more, but drawing with the right pixmap will produce undefined output, so you need to listen for these events and re-render to avoid race conditions. (Recreating a non-stereo pixmap is not necessary, but may save resources.)

context

A Context

pixmap

A X11 pixmap ID

automatic_updates

Whether to automatically copy the contents of the pixmap to the texture.

Returns

a new TexturePixmapX11 instance

pub fn is_using_tfp_extension(&self) -> bool

Checks whether the given self is using the GLX_EXT_texture_from_pixmap or similar extension to copy the contents of the pixmap to the texture. This extension is usually implemented as zero-copy operation so it implies the updates are working efficiently.

Returns

true if the texture is using an efficient extension and false otherwise

pub fn new_right(&self) -> Option<TexturePixmapX11>

Creates a texture object that corresponds to the right-eye image of a pixmap with stereo content. self must have been created using TexturePixmapX11::new_left.

Returns

a new TexturePixmapX11 instance

pub fn set_damage_object( &self, damage: u32, report_level: TexturePixmapX11ReportLevel, )

Sets the damage object that will be used to track automatic updates to the self. Damage tracking can be disabled by passing 0 for damage. Otherwise this damage will replace the one used if true was passed for automatic_updates to TexturePixmapX11::new.

Note that Cogl will subtract from the damage region as it processes damage events.

damage

A X11 Damage object or 0

report_level

The report level which describes how to interpret the damage events. This should match the level that the damage object was created with.

pub fn update_area(&self, x: i32, y: i32, width: i32, height: i32)

Forces an update of the given self so that it is refreshed with the contents of the pixmap that was given to TexturePixmapX11::new.

x

x coordinate of the area to update

y

y coordinate of the area to update

width

width of the area to update

height

height of the area to update

pub fn error_quark() -> u32

Trait Implementations

impl Clone for TexturePixmapX11

fn clone(&self) -> TexturePixmapX11

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TexturePixmapX11

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

Formats the value using the given formatter.

impl Display for TexturePixmapX11

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

Formats the value using the given formatter.

impl Hash for TexturePixmapX11

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

Feeds this value into the given Hasher.

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 TexturePixmapX11

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

This method returns an Ordering between self and other.

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<T: ObjectType> PartialEq<T> for TexturePixmapX11

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

Tests for self and other values to be equal, and is used by ==.

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<T: ObjectType> PartialOrd<T> for TexturePixmapX11

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

This method returns an ordering between self and other values if one exists.

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 TexturePixmapX11

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for TexturePixmapX11

impl IsA<Object> for TexturePixmapX11