Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

file_select_ex(3alleg4) [opendarwin man page]

file_select_ex(3alleg4) 					  Allegro manual					   file_select_ex(3alleg4)

NAME

       file_select_ex - Displays the Allegro file selector with a caption.

SYNOPSIS

       #include <allegro.h>

       int file_select_ex(const char *message, char *path, const char *ext, int size, int w, int h);

DESCRIPTION

       Displays  the  Allegro file selector, with the message as caption. The path parameter contains the initial filename to display (this can be
       used to set the starting directory, or to provide a default filename for a save-as operation). The user selection is returned  by  altering
       the path buffer, whose maximum capacity in bytes is specified by the size parameter.  Note that it should have room for at least 80 charac-
       ters (not bytes), so you should reserve 6x that amount, just to be sure. The list of files is filtered according to the file extensions	in
       the ext parameter.  Passing NULL includes all files; "PCX;BMP" includes only files with ".PCX" or ".BMP" extensions. If you wish to control
       files by their attributes, one of the fields in the extension list can begin with a slash, followed by a set of attribute  characters.  Any
       attribute  written on its own, or with a '+' before it, indicates to include only files which have that attribute set. Any attribute with a
       '-' before it indicates to leave out any files with that attribute. The flag characters are "r" (read-only), "h"  (hidden),  "s"  (system),
       "d"  (directory)  and  "a" (archive). For example, an extension string of "PCX;BMP;/+r-h" will display only PCX or BMP files that are read-
       only and not hidden. The directories are not affected in the same way as the other files by the extension string: the extensions are  never
       taken  into  account for them and the other attributes are taken into account only when 'd' is mentioned in the string; in other words, all
       directories are included when 'd' is not mentioned in the string. The file selector is stretched to the width and height specified in the w
       and  h parameters, and to the size of the standard Allegro font.  If either the width or height argument is set to zero, it is stretched to
       the corresponding screen dimension. This function returns zero if it was closed with the Cancel button or non-zero if it was OK'd.

SEE ALSO

       gui_fg_color(3alleg4)

Allegro 							   version 4.4.2					   file_select_ex(3alleg4)

Check Out this Related Man Page

load_bitmap(3alleg4)						  Allegro manual					      load_bitmap(3alleg4)

NAME

       load_bitmap - Loads any supported bitmap from a file. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       BITMAP *load_bitmap(const char *filename, RGB *pal);

DESCRIPTION

       Loads  a  bitmap  from  a file. The palette data will be stored in the second parameter, which should be an array of 256 RGB structures. At
       present this function supports BMP, LBM, PCX, and TGA files, determining the type from the file extension.

       If the file contains a truecolor image, you must set the video mode or call set_color_conversion() before loading it. In this case, if  the
       destination  color  depth  is  8-bit,  the  palette will be generated by calling generate_optimized_palette() on the bitmap; otherwise, the
       returned palette will be generated by calling generate_332_palette().

       The pal argument may be NULL. In this case, the palette data are simply not returned. Additionally, if the file is a  truecolor	image  and
       the destination color depth is 8-bit, the color conversion process will use the current palette instead of generating an optimized one.

       Example:

	  BITMAP *bmp;
	  PALETTE palette;
	  ...
	  bmp = load_bitmap("image.pcx", palette);
	  if (!bmp)
	     abort_on_error("Couldn't load image.pcx!");
	  ...
	  destroy_bitmap(bmp);

RETURN VALUE

       Returns a pointer to the bitmap or NULL on error. Remember that you are responsible for destroying the bitmap when you are finished with it
       to avoid memory leaks.

SEE ALSO

       load_bmp(3alleg4), load_lbm(3alleg4), load_pcx(3alleg4), load_tga(3alleg4),  destroy_bitmap(3alleg4),  save_bitmap(3alleg4),  register_bit-
       map_file_type(3alleg4),	set_color_depth(3alleg4),  set_color_conversion(3alleg4),  generate_optimized_palette(3alleg4),  generate_332_pal-
       ette(3alleg4)

Allegro 							   version 4.4.2					      load_bitmap(3alleg4)
Man Page