|  |  |  | GIMP Library Reference Manual |  | 
|---|---|---|---|---|
gchar* gimp_temp_name (const gchar *extension); gint32 gimp_file_load (GimpRunMode run_mode, const gchar *filename, const gchar *raw_filename); gboolean gimp_file_save (GimpRunMode run_mode, gint32 image_ID, gint32 drawable_ID, const gchar *filename, const gchar *raw_filename); gboolean gimp_register_magic_load_handler (const gchar *procedure_name, const gchar *extensions, const gchar *prefixes, const gchar *magics); gboolean gimp_register_load_handler (const gchar *procedure_name, const gchar *extensions, const gchar *prefixes); gboolean gimp_register_save_handler (const gchar *procedure_name, const gchar *extensions, const gchar *prefixes); gboolean gimp_register_file_handler_mime (const gchar *procedure_name, const gchar *mime_type); gboolean gimp_register_thumbnail_loader (const gchar *load_proc, const gchar *thumb_proc);
gchar* gimp_temp_name (const gchar *extension);
Generates a unique filename.
Generates a unique filename using the temp path supplied in the user's gimprc.
| extension: | The extension the file will have. | 
| Returns : | The new temp filename. | 
gint32 gimp_file_load (GimpRunMode run_mode, const gchar *filename, const gchar *raw_filename);
Loads a file by invoking the right load handler.
This procedure invokes the correct file load handler using magic if possible, and falling back on the file's extension and/or prefix if not. The name of the file to load is typically a full pathname, and the name entered is what the user actually typed before prepending a directory path. The reason for this is that if the user types http://www.xcf/~gimp/ he wants to fetch a URL, and the full pathname will not look like a URL.\"
| run_mode: | The run mode. | 
| filename: | The name of the file to load. | 
| raw_filename: | The name as entered by the user. | 
| Returns : | The output image. | 
gboolean gimp_file_save (GimpRunMode run_mode, gint32 image_ID, gint32 drawable_ID, const gchar *filename, const gchar *raw_filename);
Saves a file by extension.
This procedure invokes the correct file save handler according to the file's extension and/or prefix. The name of the file to save is typically a full pathname, and the name entered is what the user actually typed before prepending a directory path. The reason for this is that if the user types http://www.xcf/~gimp/ she wants to fetch a URL, and the full pathname will not look like a URL.
| run_mode: | The run mode. | 
| image_ID: | Input image. | 
| drawable_ID: | Drawable to save. | 
| filename: | The name of the file to save the image in. | 
| raw_filename: | The name as entered by the user. | 
| Returns : | TRUE on success. | 
gboolean    gimp_register_magic_load_handler
                                            (const gchar *procedure_name,
                                             const gchar *extensions,
                                             const gchar *prefixes,
                                             const gchar *magics);
Registers a file load handler procedure.
Registers a procedural database procedure to be called to load files of a particular file format using magic file information.
| procedure_name: | The name of the procedure to be used for loading. | 
| extensions: | comma separated list of extensions this handler can load (i.e. \"jpg,jpeg\"). | 
| prefixes: | comma separated list of prefixes this handler can load (i.e. \"http:,ftp:\"). | 
| magics: | comma separated list of magic file information this handler can load (i.e. \"0,string,GIF\"). | 
| Returns : | TRUE on success. | 
gboolean    gimp_register_load_handler      (const gchar *procedure_name,
                                             const gchar *extensions,
                                             const gchar *prefixes);
Registers a file load handler procedure.
Registers a procedural database procedure to be called to load files of a particular file format.
| procedure_name: | The name of the procedure to be used for loading. | 
| extensions: | comma separated list of extensions this handler can load (i.e. \"jpg,jpeg\"). | 
| prefixes: | comma separated list of prefixes this handler can load (i.e. \"http:,ftp:\"). | 
| Returns : | TRUE on success. | 
gboolean    gimp_register_save_handler      (const gchar *procedure_name,
                                             const gchar *extensions,
                                             const gchar *prefixes);
Registers a file save handler procedure.
Registers a procedural database procedure to be called to save files in a particular file format.
| procedure_name: | The name of the procedure to be used for saving. | 
| extensions: | comma separated list of extensions this handler can save (i.e. \"jpg,jpeg\"). | 
| prefixes: | comma separated list of prefixes this handler can save (i.e. \"http:,ftp:\"). | 
| Returns : | TRUE on success. | 
gboolean    gimp_register_file_handler_mime (const gchar *procedure_name,
                                             const gchar *mime_type);
Associates a MIME type with a file handler procedure.
Registers a MIME type for a file handler procedure. This allows GIMP to determine the MIME type of the file opened or saved using this procedure.
| procedure_name: | The name of the procedure to associate a MIME type with. | 
| mime_type: | A single MIME type, like for example \"image/jpeg\". | 
| Returns : | TRUE on success. | 
Since GIMP 2.2
gboolean    gimp_register_thumbnail_loader  (const gchar *load_proc,
                                             const gchar *thumb_proc);
Associates a thumbnail loader with a file load procedure.
Some file formats allow for embedded thumbnails, other file formats contain a scalable image or provide the image data in different resolutions. A file plug-in for such a format may register a special procedure that allows GIMP to load a thumbnail preview of the image. This procedure is then associated with the standard load procedure using this function.
| load_proc: | The name of the procedure the thumbnail loader with. | 
| thumb_proc: | The name of the thumbnail load procedure. | 
| Returns : | TRUE on success. | 
Since GIMP 2.2