Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_set_new...map_samples(3) Library Functions Manual al_set_new...map_samples(3)

NAME
     al_set_new_bitmap_samples - Allegro 5 API

SYNOPSIS
	    #include <allegro5/allegro.h>

	    void al_set_new_bitmap_samples(int samples)
	    SETTER(new_bitmap_samples, samples)

DESCRIPTION
     Sets  the multi-sampling samples used by newly created bitmaps (on the cur-
     rent thread) if  they  are  used  with  al_set_target_bitmap(3).	0  means
     multi-sampling  will not be used when drawing into the bitmap, which is the
     default.  1 means multi-sampling will be used but only using a single  sam-
     ple  per  pixel (so usually there will be no visual difference to not using
     multi-sampling at all).

	    Note: Some platforms have restrictions on  when  the  multi-sampling
	    buffer for a bitmap is realized, i.e. down-scaled back to the actual
	    bitmap dimensions.	This may only happen after a call to al_set_tar-
	    get_bitmap(3).  So for example:

	    al_set_target_bitmap(multisample);
	    al_clear_to_color(blue);
	    al_draw_line(0, 0, 100, 100, red, 1);
	    al_lock_bitmap(multisample, ...)
	    // ERROR: the contents of the bitmap will be undefined

	    al_set_target_bitmap(backbuffer);
	    al_lock_bitmap(multisample, ...)
	    // CORRECT: at this point, the bitmap contents are updated and
	    // there will be an anti-aliased line in it.

SINCE
     5.2.1

	    [Unstable  API]:  This is an experimental feature and currently only
	    works for the OpenGL backend.

Allegro reference manual			     al_set_new...map_samples(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_set_new_bitmap_samples&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help