AntialiasAttrib

class AntialiasAttrib

Bases: RenderAttrib

Specifies whether or how to enable antialiasing, if supported by the backend renderer.

Inheritance diagram

enum Mode

enumerator M_none = 0

enumerator M_point = 1

enumerator M_line = 2

enumerator M_polygon = 4

enumerator M_multisample = 8

enumerator M_auto = 31

enumerator M_type_mask = 31

enumerator M_faster = 32

Extra add-on bits for performancequality hints.

enumerator M_better = 64

enumerator M_dont_care = 96

static int get_class_slot(void)

static TypeHandle get_class_type(void)

unsigned short int get_mode(void) const

Returns the specified antialias mode.

unsigned short int get_mode_quality(void) const

Returns the specified antialias mode, with the type bits masked out. This therefore indicates only the requested quality settings: one of M_faster, M_better, M_dont_care, or zero (unspecified).

unsigned short int get_mode_type(void) const

Returns the specified antialias mode, with the quality bits masked out. This therefore indicates only the requested type of antialiasing: M_none, M_auto, or some specific combination.

static ConstPointerTo<RenderAttrib> make(unsigned short int mode)

Constructs a new AntialiasAttrib object.

The mode should be either M_none, M_auto, or a union of any or all of M_point, M_line, M_polygon, and M_multisample. Also, in addition to the above choices, it may include either of M_better of M_faster to specify a performance/quality tradeoff hint.

If M_none is specified, no antialiasing is performed.

If M_multisample is specified, it means to use the special framebuffer multisample bits for antialiasing, if it is available. If so, the M_point, M_line, and M_polygon modes are ignored. This advanced antialiasing mode is only available on certain graphics hardware. If it is not available, the M_multisample bit is ignored (and the other modes may be used instead, if specified).

M_point, M_line, and/or M_polygon specify per-primitive smoothing. When enabled, M_point and M_line may force transparency on. M_polygon requires a frame buffer that includes an alpha channel, and it works best if the primitives are sorted front-to-back.

If M_auto is specified, M_multisample is selected if it is available, otherwise M_polygon is selected, unless drawing lines or points, in which case M_line or M_point is selected (these two generally produce better results than M_multisample)

static ConstPointerTo<RenderAttrib> make_default(void)

Returns a RenderAttrib that corresponds to whatever the standard default properties for render attributes of this type ought to be.