NAME get_mfield_list — retrieve a list of fields in a dirfile SYNOPSIS #include <getdata.h> const char **get_mfield_list(DIRFILE *dirfile, const char *parent); DESCRIPTION The get_mfield_list() function queries a dirfile(5) database specified by dirfile and returns a read-only list of names of the all metafields for the specified parent field in the database. The dirfile argument must…
NAME get_mconstants — retrieve a list of constant values from a dirfile SYNOPSIS #include <getdata.h> const void *get_mconstants(DIRFILE *dirfile, gd_type_t return_type, const char *parent); DESCRIPTION The get_mconstants() function queries a dirfile(5) database specified by dirfile and returns a read-only list of values of the all CONST type metafields for the supplied parent field after type…
NAME get_hardware_volume – Retrieves the hardware sound output volume. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_hardware_volume(int *digi_volume, int *midi_volume); DESCRIPTION Retrieves the hardware sound output volume, both for digital samples and MIDI playback, as integers from 0 to 255, or -1 if the information is not available. Parameters digi_volume and midi_volume must be…
NAME get_gfx_mode_list – Obtains a list of available video modes. Allegro game programming library. SYNOPSIS #include <allegro.h> GFX_MODE_LIST *get_gfx_mode_list(int card); DESCRIPTION Attempts to create a list of all the supported video modes for a certain graphics driver, made up from the GFX_MODE_LIST structure, which has the following definition: typedef struct GFX_MODE_LIST { int num_modes; GFX_MODE…
NAME get_frameoffset64, dirfile_alter_frameoffset64 — report or change the frame offset of fields in a dirfile, with largefile support SYNOPSIS #define _LARGEFILE64_SOURCE #include <getdata.h> off64_t get_frameoffset(DIRFILE *dirfile, int fragment_index); int dirfile_alter_frameoffset64(DIRFILE *dirfile, off64_t offset, int fragment_index, int move); DESCRIPTION These version of get_frameoffset(3) and dirfile_alter_frameoffset(3) use a 64-bit offset type, even if off_t is a 32-bit…
NAME get_frameoffset — report the starting frame of fields in a dirfile SYNOPSIS #include <getdata.h> off_t get_frameoffset(DIRFILE *dirfile, int fragment_index); DESCRIPTION The get_frameoffset() function queries a dirfile(5) database specified by dirfile and returns the frame offset (see dirfile-format(5)) for the fragment indexed by fragment_index. The frame offset of a fragment indicate the frame number of…
NAME get_framenum_subset64 — perform a reverse look-up on a monotonic dirfile field SYNOPSIS #define _LARGEFILE64_SOURCE #include <getdata.h> double get_framenum_subset64(DIRFILE *dirfile, const char *field_code, double value, off64_t field_start, off64_t field_end); DESCRIPTION This version of get_framenum_subset(3) uses a 64-bit offset type, even if off_t is a 32-bit type. It is only available if one defines _LARGEFILE64_SOURCE. If…
NAME get_framenum_subset, get_framenum — perform a reverse look-up on a monotonic dirfile field SYNOPSIS #include <getdata.h> double get_framenum_subset(DIRFILE *dirfile, const char *field_code, double value, off_t field_start, off_t field_end); double get_framenum(DIRFILE *dirfile, const char *field_code, double value); DESCRIPTION The get_framenum_subset() function queries a dirfile(5) database specified by dirfile and returns the fractional frame number at which…
NAME get_fragmentname — retrieve a dirfile format file fragment name SYNOPSIS #include <getdata.h> const char* get_fragmentname(const DIRFILE *dirfile, int index); DESCRIPTION The get_fragmentname() function queries a dirfile(5) database specified by dirfile and returns the filename of the format file fragment indexed by the non-negative index. The dirfile argument must point to a valid DIRFILE object…
NAME get_fragment_index — retrieve the fragment containing a dirfile field SYNOPSIS #include <getdata.h> int get_fragment_index(const DIRFILE *dirfile, const char *field_code); DESCRIPTION The get_fragment_index() function queries a dirfile(5) database specified by dirfile and returns the index number of the fragment defining the field specified by field_code. If field_code contains a representation suffix, it will be ignored….
NAME get_font_ranges – Returns the number of character ranges in a font. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_font_ranges(FONT *f) DESCRIPTION Use this function to find out the number of character ranges in a font. You should query each of these ranges with get_font_range_begin() and get_font_range_end() to find out what characters are available…
NAME get_font_range_end – Returns the last character of a character range in a font. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_font_range_end(FONT *f, int range) DESCRIPTION This function allows you to find out the index to the last character of a character range for a font. You can pass -1 for the range parameter…
NAME get_font_range_begin – Returns the start of a character range in a font. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_font_range_begin(FONT *f, int range) DESCRIPTION This function allows you to find out the start of a specific character range for a font. You can pass -1 for the `range’ parameter if you want to…
NAME get_filename – Returns a pointer to the filename portion of a path. Allegro game programming library. SYNOPSIS #include <allegro.h> char *get_filename(const char *path); DESCRIPTION Finds out the filename portion of a completely specified file path. Both `\’ and `/’ are recognized as directory separators under DOS and Windows. However, only `/’ is recognized as…
NAME get_field_list_by_type — retrieve a list of fields in a dirfile SYNOPSIS #include <getdata.h> const char **get_field_list_by_type(DIRFILE *dirfile, gd_entype_t type); DESCRIPTION The get_field_list_by_type() function queries a dirfile(5) database specified by dirfile and returns a read-only list of names of the all fields of the indicated type which are defined in the database. Notably, this list…
NAME get_field_list — retrieve a list of fields in a dirfile SYNOPSIS #include <getdata.h> const char **get_field_list(DIRFILE *dirfile); DESCRIPTION The get_field_list() function queries a dirfile(5) database specified by dirfile and returns a read-only list of names of the all fields defined in the database. Notably, this list does not include /META subfields. The dirfile argument…
NAME get_extension – Returns a pointer to the extension of a filename. Allegro game programming library. SYNOPSIS #include <allegro.h> char *get_extension(const char *filename); DESCRIPTION Finds out the extension of the filename (with or without path information). Example: get_executable_name(name, sizeof(name)); allegro_message(“The binary has the extension `%s’ “, get_extension(name)); RETURN VALUE Returns a pointer to the portion…
NAME get_executable_name – Obtains the full path to the current executable. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_executable_name(char *buf, int size); DESCRIPTION Fills `buf’ with the full path to the current executable, writing at most `size’ bytes. This generally comes from `argv[0]’ but on Unix systems it tries to get the information from…
NAME get_error_string — report a getdata library error SYNOPSIS #include <getdata.h> char *get_error_string(const DIRFILE *dirfile, char *buffer, size_t buflen); DESCRIPTION The get_error_string() function returns a string describing the last dirfile error encountered while operating on dirfile. The string is written to the user-supplied buffer buffer. At most buflen characters will be written. This always includes…
NAME get_error — report a getdata library error SYNOPSIS #include <getdata.h> int get_error(const DIRFILE *dirfile); DESCRIPTION The get_error() function returns the numeric dirfile error associated with the dirfile dirfile which is set by many GetData library functions. The dirfile argument should point to a DIRFILE object previously created by a call to dirfile_open(3). A textual…