Section 3: library functions
NAME get_sound_input_cap_parm – Detects if the specified recording parameters are supported. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_sound_input_cap_parm(int rate, int bits, int stereo); DESCRIPTION Checks whether the specified recording frequency, number of bits, and mono/stereo mode are supported (and how) by the current audio driver. RETURN VALUE The function returns one of the…
NAME get_sound_input_cap_bits – Checks which audio input sample formats are supported. Allegro game programming library. SYNOPSIS #include <allegro.h> int get_sound_input_cap_bits(); DESCRIPTION Checks which sample formats are supported by the current audio input driver, returning one of the bitfield values: 0 = audio input not supported 8 = eight bit audio input is supported 16 =…
NAME get_scaling_matrix, get_scaling_matrix_f – Constructs a scaling matrix. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_scaling_matrix(MATRIX *m, fixed x, fixed y, fixed z); void get_scaling_matrix_f(MATRIX_f *m, float x, float y, float z); DESCRIPTION Constructs a scaling matrix, storing it in m. When applied to the point (px, py, pz), this matrix will produce the…
NAME get_scaling_matrix, get_scaling_matrix_f – Constructs a scaling matrix. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_scaling_matrix(MATRIX *m, fixed x, fixed y, fixed z); void get_scaling_matrix_f(MATRIX_f *m, float x, float y, float z); DESCRIPTION Constructs a scaling matrix, storing it in m. When applied to the point (px, py, pz), this matrix will produce the…
NAME get_rotation_matrix, get_rotation_matrix_f – Constructs X, Y, Z rotation matrices. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_rotation_matrix(MATRIX *m, fixed x, fixed y, fixed z); void get_rotation_matrix_f(MATRIX_f *m, float x, float y, float z); DESCRIPTION Constructs a transformation matrix which will rotate points around all three axes by the specified amounts (given in binary,…
NAME get_rotation_matrix, get_rotation_matrix_f – Constructs X, Y, Z rotation matrices. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_rotation_matrix(MATRIX *m, fixed x, fixed y, fixed z); void get_rotation_matrix_f(MATRIX_f *m, float x, float y, float z); DESCRIPTION Constructs a transformation matrix which will rotate points around all three axes by the specified amounts (given in binary,…
NAME get_rle_sprite – Creates an RLE sprite using a bitmap as source. Allegro game programming library. SYNOPSIS #include <allegro.h> RLE_SPRITE *get_rle_sprite(BITMAP *bitmap); DESCRIPTION Creates an RLE sprite based on the specified bitmap (which must be a memory bitmap). Remember to free this RLE sprite later to avoid memory leaks. Example: RLE_SPRITE *rle; BITMAP *bmp; ……
NAME dirfile_reference, get_reference — retrieve or set the reference field for a dirfile SYNOPSIS #include <getdata.h> const char *dirfile_reference(DIRFILE *dirfile, const char *field_code); const char *get_reference(DIRFILE *dirfile); DESCRIPTION The dirfile_reference() function sets or retrieves the reference field (see dirfile(5)) associated with the dirfile specified by dirfile. If the field_code argument is non-NULL, the reference field…
NAME get_raw_filename — retrieve the pathname of a binary file in a dirfile SYNOPSIS #include <getdata.h> const char *get_raw_filename(DIRFILE *dirfile, const char *field_code); DESCRIPTION The get_raw_filename() function retrieves the pathname of the file backing the RAW field specified by field_code in the dirfile specified by dirfile. If field_code contains a valid representation suffix, it will…
NAME get_protection — report the protection level of a dirfile fragment SYNOPSIS #include <getdata.h> int get_protection(DIRFILE *dirfile, int fragment_index); DESCRIPTION The get_protection() function queries a dirfile(5) database specified by dirfile and returns the advisory protection level for the fragment indexed by fragment_index. RETURN VALUE Upon successful completion, get_protection() returns the advisory protection level of the…
NAME get_phys_pages, get_avphys_pages – get total and available physical page counts SYNOPSIS #include <sys/sysinfo.h> long get_phys_pages(void); long get_avphys_pages(void); DESCRIPTION The function get_phys_pages() returns the total number of physical pages of memory available on the system. The function get_avphys_pages() returns the number of currently available physical pages of memory on the system. RETURN VALUE On success,…
NAME get_parent_fragment — retrieve the parent fragment of a fragment in a dirfile SYNOPSIS #include <getdata.h> int get_parent_fragment(const DIRFILE *dirfile, int fragment_index); DESCRIPTION The get_parent_fragment() function queries a dirfile(5) database specified by dirfile and returns the index of the fragment which contains the INCLUDE directive for the fragment indexed by fragment_index. Since the primary format…
NAME get_palette – Retrieves the entire palette of 256 colors. Allegro game programming library. SYNOPSIS #include <allegro.h> void get_palette(PALETTE p); DESCRIPTION Retrieves the entire palette of 256 colors. You should provide an array of 256 RGB structures to store it in. Example: PALETTE pal; … get_palette(pal); SEE ALSO get_palette_range(3), get_color(3), set_palette(3) Index
NAME get_ordered_context_list, get_ordered_context_list_with_level, get_default_context, get_default_context_with_level, get_default_context_with_role, get_default_context_with_rolelevel, query_user_context, manual_user_enter_context, get_default_role – determine SELinux context(s) for user sessions SYNOPSIS #include <selinux/selinux.h> #include <selinux/get_context_list.h> int get_ordered_context_list(const char *user, char *fromcon, char ***list); int get_ordered_context_list_with_level(const char *user, const char *level, char *fromcon, char ***list); int get_default_context(const char *user, char *fromcon, char **newcon); int get_default_context_with_level(const char *user, const char…
NAME get_ordered_context_list, get_ordered_context_list_with_level, get_default_context, get_default_context_with_level, get_default_context_with_role, get_default_context_with_rolelevel, query_user_context, manual_user_enter_context, get_default_role – determine SELinux context(s) for user sessions SYNOPSIS #include <selinux/selinux.h> #include <selinux/get_context_list.h> int get_ordered_context_list(const char *user, char *fromcon, char ***list); int get_ordered_context_list_with_level(const char *user, const char *level, char *fromcon, char ***list); int get_default_context(const char *user, char *fromcon, char **newcon); int get_default_context_with_level(const char *user, const char…
NAME get_nvectors — report the number of vector fields in a dirfile SYNOPSIS #include <getdata.h> unsigned int get_nvectors(DIRFILE *dirfile); DESCRIPTION The get_nvectors() function queries a dirfile(5) database specified by dirfile and returns the number of vector fields defined in the database (i.e. fields of types BIT,~LINCOM,~LINTERP,~MULTIPLY,~PHASE,~POLYNOM,~RAW, SBIT). Notably, this count does not include /META fields….
NAME get_nprocs, get_nprocs_conf – get number of processors SYNOPSIS #include <sys/sysinfo.h> int get_nprocs(void); int get_nprocs_conf(void); DESCRIPTION The function get_nprocs_conf() returns the number of processors configured by the operating system. The function get_nprocs() returns the number of processors currently available in the system. This may be less than the number returned by get_nprocs_conf() because processors may…
NAME get_nprocs, get_nprocs_conf – get number of processors SYNOPSIS #include <sys/sysinfo.h> int get_nprocs(void); int get_nprocs_conf(void); DESCRIPTION The function get_nprocs_conf() returns the number of processors configured by the operating system. The function get_nprocs() returns the number of processors currently available in the system. This may be less than the number returned by get_nprocs_conf() because processors may…
NAME get_nmvectors — report the number of vector fields in a dirfile SYNOPSIS #include <getdata.h> unsigned int get_nmvectors(DIRFILE *dirfile); DESCRIPTION The get_nmvectors() function queries a dirfile(5) database specified by dirfile and returns the number of vector metafields defined in the database (i.e. fields of types BIT, LINCOM, LINTERP, MULTIPLY, PHASE, and RAW)for the supplied parent…
NAME get_nmfields_by_type — report the number of fields of a given type in a dirfile SYNOPSIS #include <getdata.h> unsigned int get_nmfields_by_type(DIRFILE *dirfile, const char *parent, gd_entype_t type); DESCRIPTION The get_nmfields_by_type() function queries a dirfile(5) database specified by dirfile and returns the number of metafields defined in the database for the supplied parent field. The dirfile…