Section 3: library functions
textprintf_right_ex – Formatted right aligned output of a string. Allegro game programming library. Synopsis #include <allegro.h> void textprintf_right_ex(BITMAP *bmp, const FONT *f, int x, y, color, bg, const char *fmt, …); Description Like textprintf_ex(), but interprets the x coordinate as the right rather than the left edge of the string. This function shares the text…
textprintf_justify_ex – Formatted justified output of a string. Allegro game programming library. Synopsis #include <allegro.h> void textprintf_justify_ex(BITMAP *bmp, const FONT *f, int x1, x2, y, diff, color, bg, const char *fmt, …); Description Like textout_justify_ex(), but using a printf() style format string. This function shares the text length limitation of textprintf_ex(). Example: char *lines[] =…
textprintf_ex – Formatted output of a string. Allegro game programming library. Synopsis #include <allegro.h> void textprintf_ex(BITMAP *bmp, const FONT *f, int x, int y, int color, int bg, const char *fmt, …); Description Formatted text output, using a printf() style format string. Due to an internal limitation, this function can’t be used for extremely long…
textprintf_centre_ex – Formatted centered output of a string. Allegro game programming library. Synopsis #include <allegro.h> void textprintf_centre_ex(BITMAP *bmp, const FONT *f, int x, int y, int color, int bg, const char *fmt, …); Description Like textprintf_ex(), but interprets the x coordinate as the centre rather than the left edge of the string. This function shares…
textout_right_ex – Writes a right aligned string on a bitmap. Allegro game programming library. Synopsis #include <allegro.h> void textout_right_ex(BITMAP *bmp, const FONT *f, const char *s, int x, int y, int color, int bg); Description Like textout_ex(), but interprets the x coordinate as the right rather than the left edge of the string. Example: textout_right_ex(screen,…
textout_justify_ex – Draws justified text within a region. Allegro game programming library. Synopsis #include <allegro.h> void textout_justify_ex(BITMAP *bmp, const FONT *f, const char *s, int x1, int x2, int y, int diff, int color, int bg); Description Draws justified text within the region x1-x2. If the amount of spare space is greater than the diff…
textout_ex – Writes a string on a bitmap. Allegro game programming library. Synopsis #include <allegro.h> void textout_ex(BITMAP *bmp, const FONT *f, const char *s, int x, int y, int color, int bg); Description Writes the string `s’ onto the bitmap at position x, y, using the specified font, foreground color and background color. If the…
textout_centre_ex – Writes a centered string on a bitmap. Allegro game programming library. Synopsis #include <allegro.h> void textout_centre_ex(BITMAP *bmp, const FONT *f, const char *s, int x, y, int color, int bg); Description Like textout_ex(), but interprets the x coordinate as the centre rather than the left edge of the string. Example: /* Important texts…
textdomain – set domain for future gettext() calls Synopsis #include <libintl.h> char *textdomain(const char *domainname); Description The textdomain function sets or retrieves the current message domain. A message domain is a set of translatable msgid messages. Usually, every software package has its own message domain. The domain name is used to determine the message catalog…
text_length – Returns the length of a string in pixels. Allegro game programming library. Synopsis #include <allegro.h> int text_length(const FONT *f, const char *str); Description Returns the length (in pixels) of a string in the specified font. Example: int width = text_length(font, "I love spam"); … bmp = create_bitmap(width, height); See Also text_height(3), ex12bit(3), exmidi(3),…
text_height – Returns the height of a font in pixels. Allegro game programming library. Synopsis #include <allegro.h> int text_height(const FONT *f) Description Returns the height (in pixels) of the specified font. Example: int height = text_height(font); … bmp = create_bitmap(width, height); See Also text_length(3), ex12bit(3), exmidi(3), expackf(3), expat(3), exsprite(3), exsyscur(3), exunicod(3)
tevent_tutorial – The Tutorial Introduction Tutorial describing working with tevent library. Table of contents Chapter 1: Tevent context Chapter 2: Tevent events Chapter 3: Accessing data Chapter 4: Tevent request Chapter 5: Tevent queue tevent_thread
The tevent request functions. – A tevent_req represents an asynchronous computation. Typedefs typedef void(* tevent_req_fn )(struct tevent_req *req) A tevent request callback function. typedef char *(* tevent_req_print_fn )(struct tevent_req *req, TALLOC_CTX *ctx) The print function which can be set for a tevent async request. typedef bool(* tevent_req_cancel_fn )(struct tevent_req *req) A typedef for a cancel…
tevent_queue_tutorial – The tevent_queue tutorial Introduction A tevent_queue is used to queue up async requests that must be serialized. For example writing buffers into a socket must be serialized. Writing a large lump of data into a socket can require multiple write(2) or send(2) system calls. If more than one async request is outstanding to…
The tevent queue functions – A tevent_queue is used to queue up async requests that must be serialized. Typedefs typedef void(* tevent_queue_trigger_fn_t )(struct tevent_req *req, void *private_data) A callback trigger function run by the queue. Functions struct tevent_queue * tevent_queue_create (TALLOC_CTX *mem_ctx, const char *name) Create and start a tevent queue. bool tevent_queue_add (struct tevent_queue…
The tevent operation functions – The following structure and registration functions are exclusively needed for people writing and pluggin a different event engine. Detailed Description The following structure and registration functions are exclusively needed for people writing and pluggin a different event engine. There is nothing useful for normal tevent user in here. Author Generated…
The tevent helper functiions – Functions int tevent_timeval_compare (const struct timeval *tv1, const struct timeval *tv2) Compare two timeval values. struct timeval tevent_timeval_zero (void) Get a zero timval value. struct timeval tevent_timeval_current (void) Get a timeval value for the current time. struct timeval tevent_timeval_set (uint32_t secs, uint32_t usecs) Get a timeval structure with the given…
tevent_events – Chapter 2: Tevent events Tevent events Ok, after reading previous chapter we can start doing something useful. So, the way of creating events is similar for all types – signals, file descriptors, time or immediate events. At the beginning it is good to know about some typedefs which are set in tevent library…
tevent_data – Chapter 3: Accessing data Accessing data with tevent A tevent request is (usually) created together with a structure for storing the data necessary for an asynchronous computation. For these private data, tevent library uses void (generic) pointers, therefore any data type can be very simply pointed at. However, this attitude requires clear and…
tevent_context – Chapter 1: Tevent context Tevent with threads Tevent context is an essential logical unit of tevent library. For working with events at least one such context has to be created – allocated, initialized. Then, events which are meant to be caught and handled have to be registered within this specific context. Reason for…