AttrShape

class AttrShape(*args, **kwargs)

The PangoAttrShape structure is used to represent attributes which impose shape restrictions.

Methods

class AttrShape
new(ink_rect: Rectangle, logical_rect: Rectangle) → Attribute

Create a new shape attribute.

A shape is used to impose a particular ink and logical rectangle on the result of shaping a particular glyph. This might be used, for instance, for embedding a picture or a widget inside a PangoLayout.

Parameters:

  • ink_rect – ink rectangle to assign to each character

  • logical_rect – logical rectangle to assign to each character

new_with_data(ink_rect: Rectangle, logical_rect: Rectangle, data: None, copy_func: Callable[[...], None] | None = None, destroy_func: Callable[[None], None] | None = None) → Attribute

Creates a new shape attribute.

Like new, but a user data pointer is also provided; this pointer can be accessed when later rendering the glyph.

Added in version 1.8.

Parameters:

  • ink_rect – ink rectangle to assign to each character

  • logical_rect – logical rectangle to assign to each character

  • data – user data pointer

  • copy_func – function to copy data when the attribute is copied. If None, data is simply copied as a pointer

  • destroy_func – function to free data when the attribute is freed

Fields

class AttrShape
attr

The common portion of the attribute

copy_func

Copy function for the user data

data

User data set (see new_with_data)

destroy_func

Destroy function for the user data

ink_rect

The ink rectangle to restrict to

logical_rect

The logical rectangle to restrict to