Creates a thumbnail for a certain frame, where 'frame' is somewhat vaguely defined as 'suitable point to show while single-stepping through the slideshow'. the newly created thumbnail or or NULL if frame_num is out of bounds. Create a surface that can be set as background for @window. %NULL on error (e.g. out of X connections) GnomeBG a #GdkPixbuf showing the background as a thumbnail Creates a new object to manage crossfading a window background between two #cairo_surface_ts. the new #GnomeBGCrossfade The width of the crossfading window The height of the crossfading window This function reveals whether or not @fade is currently running on a window. See gnome_bg_crossfade_start() for information on how to initiate a crossfade. %TRUE if fading, or %FALSE if not fading a #GnomeBGCrossfade Before initiating a crossfade with gnome_bg_crossfade_start() a start and end surface have to be set. This function sets the surface shown at the end of the crossfade effect. %TRUE if successful, or %FALSE if the surface could not be copied. a #GnomeBGCrossfade The cairo surface to fade to Before initiating a crossfade with gnome_bg_crossfade_start() a start and end surface have to be set. This function sets the surface shown at the beginning of the crossfade effect. %TRUE if successful, or %FALSE if the surface could not be copied. a #GnomeBGCrossfade The cairo surface to fade from This function initiates a quick crossfade between two surfaces on the background of @window. Before initiating the crossfade both gnome_bg_crossfade_start() and gnome_bg_crossfade_end() need to be called. If animations are disabled, the crossfade is skipped, and the window background is set immediately to the end surface. a #GnomeBGCrossfade The #GdkWindow to draw crossfade on This function stops any in progress crossfades that may be happening. It's harmless to call this function if @fade is already stopped. a #GnomeBGCrossfade When a crossfade is running, this is height of the fading surface. When a crossfade is running, this is width of the fading surface. When a crossfade finishes, @window will have a copy of the end surface as its background, and this signal will get emitted. the #GdkWindow the crossfade happend on. Creates a new object to manage a slide show. window background between two #cairo_surface_ts. the new #GnomeBGSlideShow The filename of the slide show Returns the current slides progress. a #GnomeBGSlideShow monitor width monitor height slide progress slide duration if slide is fixed first file in slide second file in slide gets whether or not the slide show has multiple sizes for different monitors %TRUE if multiple sizes a #GnomeBGSlideShow Returns number of slides in slide show a #GnomeBGSlideShow Retrieves slide by frame number %TRUE if successful a #GnomeBGSlideShow frame number monitor width monitor height slide progress slide duration if slide is fixed first file in slide second file in slide gets the start time of the slide show a timestamp a #GnomeBGSlideShow gets the total duration of the slide show a timestamp a #GnomeBGSlideShow Tries to load the slide show. %TRUE if successful a #GnomeBGSlideShow Tries to load the slide show asynchronously. a #GnomeBGSlideShow a #GCancellable the callback user data Creates a new #GnomeDesktopThumbnailFactory. This function must be called on the main thread and is non-blocking. a new #GnomeDesktopThumbnailFactory The thumbnail size to use Returns TRUE if this GnomeDesktopThumbnailFactory can (at least try) to thumbnail this file. Thumbnails or files with failed thumbnails won't be thumbnailed. Usage of this function is threadsafe and does blocking I/O. TRUE if the file can be thumbnailed. a #GnomeDesktopThumbnailFactory the uri of a file the mime type of the file the mtime of the file Creates a failed thumbnail for the file so that we don't try to re-thumbnail the file later. Usage of this function is threadsafe and does blocking I/O. a #GnomeDesktopThumbnailFactory the uri of a file the modification time of the file Asynchronous version of gnome_desktop_thumbnail_factory_create_failed_thumbnail() Since 42.0 a #GnomeDesktopThumbnailFactory the uri of a file the modification time of the original file a Cancellable object a function that will be called when the task has ended user data Since 42.0 a #GnomeDesktopThumbnailFactory the result of the operation Tries to generate a thumbnail for the specified file. If it succeeds it returns a pixbuf that can be used as a thumbnail. Usage of this function is threadsafe and does blocking I/O. thumbnail pixbuf if thumbnailing succeeded, %NULL otherwise. a #GnomeDesktopThumbnailFactory the uri of a file the mime type of the file Asynchronous version of gnome_desktop_thumbnail_factory_generate_thumbnail() Since 42.0 a #GnomeDesktopThumbnailFactory the URI of a file the MIME type of the file a Cancellable object a function that will be called when the task has ended user data thumbnail pixbuf if thumbnailing succeeded, %NULL otherwise. Since 42.0 a #GnomeDesktopThumbnailFactory the result of the operation Tries to locate an failed thumbnail for the file specified. Writing and looking for failed thumbnails is important to avoid to try to thumbnail e.g. broken images several times. Usage of this function is threadsafe and does blocking I/O. TRUE if there is a failed thumbnail for the file. a #GnomeDesktopThumbnailFactory the uri of a file the mtime of the file Tries to locate an existing thumbnail for the file specified. Usage of this function is threadsafe and does blocking I/O. The absolute path of the thumbnail, or %NULL if none exist. a #GnomeDesktopThumbnailFactory the uri of a file the mtime of the file Saves @thumbnail at the right place. If the save fails a failed thumbnail is written. Usage of this function is threadsafe and does blocking I/O. a #GnomeDesktopThumbnailFactory the thumbnail as a pixbuf the uri of a file the modification time of the original file Asynchronous version of gnome_desktop_thumbnail_factory_save_thumbnail() Since 42.0 a #GnomeDesktopThumbnailFactory the thumbnail as a pixbuf the uri of a file the modification time of the original file a Cancellable object a function that will be called when the task has ended user data Since 42.0 a #GnomeDesktopThumbnailFactory the result of the operation a new #GnomeIdleMonitor that tracks the server-global idletime for all devices. a watch id Adds a watch for a specific idle time. The callback will be called when the user has accumulated @interval_msec milliseconds of idle time. This function will return an ID that can either be passed to gnome_idle_monitor_remove_watch(), or can be used to tell idle time watches apart if you have more than one. Also note that this function will only care about positive transitions (user's idle time exceeding a certain time). If you want to know about when the user has become active, use gnome_idle_monitor_add_user_active_watch(). A #GnomeIdleMonitor The idletime interval, in milliseconds. It must be a strictly positive value (> 0). The callback to call when the user has accumulated @interval_msec milliseconds of idle time. The user data to pass to the callback A #GDestroyNotify a watch id Add a one-time watch to know when the user is active again. Note that this watch is one-time and will de-activate after the function is called, for efficiency purposes. It's most convenient to call this when an idle watch, as added by gnome_idle_monitor_add_idle_watch(), has triggered. A #GnomeIdleMonitor The callback to call when the user is active again. The user data to pass to the callback A #GDestroyNotify The current idle time, in milliseconds A #GnomeIdleMonitor Removes an idle time watcher, previously added by gnome_idle_monitor_add_idle_watch() or gnome_idle_monitor_add_user_active_watch(). A #GnomeIdleMonitor A watch ID Returns a reference to a #GnomePnpIds object, or creates a new one if none have been created. a #GnomePnpIds object. Find the full manufacturer name for the given PNP ID. a new string representing the manufacturer name, or %NULL when not found. a #GnomePnpIds object the PNP ID to look for whether at least two outputs are at (0, 0) offset and they have the same width/height. Those outputs are of course connected and on (i.e. they have a CRTC assigned). the output configuration for this #GnomeRRConfig the current mode of this crtc a #GnomeRRCrtc %TRUE for success a #GnomeRRCrtc the minimum width the maximum width the minimum height a #GnomeRRCrtc Returns TRUE if this mode is a tiled mode created for span a tiled monitor. a #GnomeRRMode The currently set backlight brightness a #GnomeRROutput the current mode of this output a #GnomeRROutput a #GnomeRROutput The minimum backlight step available in percent a #GnomeRROutput a #GnomeRROutput a #GnomeRROutput a #GnomeRROutput a #GnomeRROutput %TRUE for success the absolute value which is 0 >= this <= 100 the display name of this output Get the geometry for the monitor connected to the specified output. If the monitor is a tiled monitor, it returns the geometry for the complete monitor. a #GnomeRROutputInfo the output name a #GnomeRROutputInfo whether there is a CRTC assigned to this output (i.e. a signal is being sent to it) whether the output is physically connected to a monitor %TRUE if the specified output is connected to the primary tile of a monitor or to an untiled monitor, %FALSE if the output is connected to a secondary tile. a #GnomeRROutputInfo Set the geometry for the monitor connected to the specified output. If the monitor is a tiled monitor, it sets the geometry for the complete monitor. a #GnomeRROutputInfo x offset for monitor y offset for monitor monitor width monitor height Creates a unique #GnomeRRScreen instance for the specified @screen. a unique #GnomeRRScreen instance, specific to the @screen, or NULL if this could not be created, for instance if the driver does not support Xrandr 1.2. Each #GdkScreen thus has a single instance of #GnomeRRScreen. the #GdkScreen on which to operate the CRTC identified by @id The current #GnomeRRDpmsMode of this screen the output identified by @id the output identified by @name Get the ranges of the screen a #GnomeRRScreen the minimum width the maximum width the minimum height the maximum height List available XRandR clone modes List all CRTCs List available XRandR modes List all outputs Refreshes the screen configuration, and calls the screen's callback if it exists and if the screen's configuration changed. TRUE if the screen's configuration changed; otherwise, the function returns FALSE and a NULL error if the configuration didn't change, or FALSE and a non-NULL error if there was an error while refreshing the configuration. a #GnomeRRScreen This method also disables the DPMS timeouts. This signal is emitted when a display device is connected to a port, or a port is hotplugged with an active output. The latter can happen if a laptop is docked, and the dock provides a new active output. The @output value is not a #GObject. The returned @output value can only assume to be valid during the emission of the signal (i.e. within your signal handler only), as it may change later when the @screen is modified due to an event from the X server, or due to another place in the application modifying the @screen and the @output. Therefore, deal with changes to the @output right in your signal handler, instead of keeping the @output reference for an async or idle function. the #GnomeRROutput that was connected This signal is emitted when a display device is disconnected from a port, or a port output is hot-unplugged. The latter can happen if a laptop is undocked, and the dock provided the output. The @output value is not a #GObject. The returned @output value can only assume to be valid during the emission of the signal (i.e. within your signal handler only), as it may change later when the @screen is modified due to an event from the X server, or due to another place in the application modifying the @screen and the @output. Therefore, deal with changes to the @output right in your signal handler, instead of keeping the @output reference for an async or idle function. the #GnomeRROutput that was disconnected Creates a new #GnomeWallClock the new clock Returns the string representing the current time of this clock according to the user settings. the time of the clock as a string. This string points to internally allocated storage and must not be freed, modified or stored. a #GnomeWallClock Returns the current local time zone used by this clock. the #GTimeZone of the clock. a #GnomeWallClock a newly allocated string representing the date & time passed, with the options applied. A formatted string representing the current clock display. If %TRUE, the formatted clock will never include a date or the day of the week, irrespective of configuration. The timezone used for this clock a new #GnomeXkbInfo instance. the translated description for the group @group_id. a #GnomeXkbInfo identifier for group the translated description for the option @id. a #GnomeXkbInfo identifier for group containing the option option identifier Returns a list of all layout identifiers we know about. the list of layout names. The caller takes ownership of the #GList but not of the strings themselves, those are internally allocated and must not be modified. a #GnomeXkbInfo Returns a list of all option group identifiers we know about. the list of option group ids. The caller takes ownership of the #GList but not of the strings themselves, those are internally allocated and must not be modified. a #GnomeXkbInfo Returns a list of all languages supported by a layout, given by @layout_id. the list of ISO 639 code strings. The caller takes ownership of the #GList but not of the strings themselves, those are internally allocated and must not be modified. a #GnomeXkbInfo a layout identifier Retrieves information about a layout. Both @display_name and @short_name are suitable to show in UIs and might be localized if translations are available. Some layouts don't provide a short name (2 or 3 letters) or don't specify a XKB variant, in those cases @short_name or @xkb_variant are empty strings, i.e. "". If the given layout doesn't exist the return value is %FALSE and all the (out) parameters are set to %NULL. %TRUE if the layout exists or %FALSE otherwise. a #GnomeXkbInfo layout's identifier about which to retrieve the info location to store the layout's display name, or %NULL location to store the layout's short name, or %NULL location to store the layout's XKB name, or %NULL location to store the layout's XKB variant, or %NULL Returns a list of all layout identifiers we know about for @country_code. the list of layout ids. The caller takes ownership of the #GList but not of the strings themselves, those are internally allocated and must not be modified. a #GnomeXkbInfo an ISO 3166 code string Returns a list of all layout identifiers we know about for @language_code. the list of layout ids. The caller takes ownership of the #GList but not of the strings themselves, those are internally allocated and must not be modified. a #GnomeXkbInfo an ISO 639 code string Returns a list of all option identifiers we know about for group @group_id. the list of option ids. The caller takes ownership of the #GList but not of the strings themselves, those are internally allocated and must not be modified. a #GnomeXkbInfo group's identifier about which to retrieve the options Returns whether the thumbnail has the correct uri and mtime embedded in the png options. This function is threadsafe and does no blocking I/O. TRUE if the thumbnail has the right @uri and @mtime an loaded thumbnail #GdkPixbuf a uri the mtime Returns the filename that a thumbnail of size @size for @uri would have. This function is threadsafe and does no blocking I/O. an absolute filename an uri a thumbnail size Gets all locales. a newly allocated %NULL-terminated string array containing the all locales. Free with g_strfreev(). Gets the country name for @code. If @translation is provided the returned string is translated accordingly. the country name. Caller takes ownership. an ISO 3166 code string a locale string Gets the country description for @locale. If @translation is provided the returned string is translated accordingly. the country description. Caller takes ownership. a locale string a locale string Gets the default input source's type and identifier for a given locale. %TRUE if a input source exists or %FALSE otherwise. a locale string location to store the input source type location to store the input source identifier Gets the language name for @code. If @translation is provided the returned string is translated accordingly. the language name. Caller takes ownership. an ISO 639 code string a locale string Gets the language description for @locale. If @translation is provided the returned string is translated accordingly. the language description. Caller takes ownership. a locale string a locale string Gets a translation of the raw @modifier string. If @translation is provided the returned string is translated accordingly. the translated modifier string. Caller takes ownership. the modifier part of a locale name a locale string #GnomeDesktopThumbnailFactory allows generation and loading of thumbnails for local and remote files and directories. It uses a collection of programs called <firstterm>thumbnailers</firstterm>, each one generating thumbnails for a specific set of content-types of files. For example, <application>totem-video-thumbnailer</application> generates thumbnails for video files using GStreamer; <application>evince-thumbnailer</application> generates thumbnails for PDFs and other document files. If no specific thumbnailer exists for a file, or if the thumbnailer fails, gdk-pixbuf is used as a fallback. To generate a thumbnail, an appropriate thumbnailer program is selected then executed, passing it the URI of the file to thumbnail, plus a path to write the thumbnail image to. If thumbnailing succeeds, the thumbnailer should have written the image to disk before terminating; but if thumbnailing fails, no image should be written, and the thumbnailer should return a non-zero exit status. #GnomeDesktopThumbnailFactory will then fall back to using gdk-pixbuf to generate a thumbnail, if possible. Thumbnailers are chosen by examining a series of <filename>.thumbnailer</filename> files in <filename><replaceable>$PREFIX</replaceable>/share/thumbnailers</filename>. Each is in a simple key-file format: <informalexample><programlisting> [Thumbnailer Entry] Exec=evince-thumbnailer -s %s %u %o MimeType=application/pdf;application/x-bzpdf;application/x-gzpdf; </programlisting></informalexample> The <filename>.thumbnailer</filename> format supports three keys: <variablelist> <varlistentry><term><code>Exec</code></term><listitem><para> Required. The command to execute the thumbnailer. It supports a few different parameters which are replaced before calling the thumbnailer: <replaceable>%u</replaceable> is the URI of the file being thumbnailed; <replaceable>%i</replaceable> is its path; <replaceable>%o</replaceable> is the path of the image file to be written to; <replaceable>%s</replaceable> is the maximum desired size of the thumbnail image (the maximum width or height, in pixels); and <replaceable>%%</replaceable> is a literal percent character. </para></listitem></varlistentry> <varlistentry><term><code>MimeType</code></term><listitem><para> Required. A semicolon-separated list of MIME types which the thumbnailer supports generating thumbnails for. </para></listitem></varlistentry> </variablelist> So in the example <filename>.thumbnailer</filename> file above, the command passes the requested thumbnail size, then the input file’s URI, then the path for the output image file to <application>evince-thumbnailer</application>. The code to examine and call a thumbnailer is contained in #GnomeDesktopThumbnailFactory, which handles looking up the right thumbnailer script, building and executing the command for it, and loading the resulting thumbnail image into a #GdkPixbuf. Thumbnail caching is also supported by #GnomeDesktopThumbnailFactory. When calling a thumbnailer, the path passed for the output image file is in <filename><envar>$XDG_CACHE_HOME</envar>/thumbnails/ <replaceable>$SIZE</replaceable>/</filename>. The cached image file is given a (probably) unique filename, generated by hashing the original file’s URI, so the thumbnail can be looked up in future. #GnomeDesktopThumbnailFactory supports two sizes of thumbnails: %GNOME_DESKTOP_THUMBNAIL_SIZE_NORMAL and %GNOME_DESKTOP_THUMBNAIL_SIZE_LARGE. Normal thumbnails are up to 128×128 pixels, whereas large thumbnails are up to 256×256 pixels. Thumbnails which are larger than this are scaled down before being cached, and non-square thumbnails are scaled so their largest dimension is at most 128 or 256 pixels. #GnomeDesktopThumbnailFactory also handles failed thumbnails. If a thumbnailer can’t generate a thumbnail for a file (e.g. because the file is corrupt or because the right video codecs aren’t available), it returns a non-zero exit status. The thumbnail factory then writes an entry to <filename><envar>$XDG_CACHE_HOME</envar>/thumbnails/fail/ gnome-thumbnail-factory/</filename> which is named after the hash of the input file URI (just like a successful cached thumbnail). For future queries for thumbnails for that file, #GnomeDesktopThumbnailFactory can immediately return an error after looking up the fail entry. If a file changes content, #GnomeDesktopThumbnailFactory will generate a new thumbnail because each cached image has associated metadata (stored as PNG tEXt keys) storing the full URI of the thumbnailed file (to check for hash collisions) and its last modification time at the point of thumbnailing. If the stored modification time doesn’t match the file’s current one, a new thumbnail is generated. Returns %TRUE if there are translations for language @code. %TRUE if there are translations for language @code. an ISO 639 code string Gets the normalized locale string in the form [language[_country][.codeset][@modifier]] for @name. normalized locale string. Caller takes ownership. a locale string Extracts the various components of a locale string of the form [language[_country][.codeset][@modifier]]. See http://en.wikipedia.org/wiki/Locale. %TRUE if parsing was successful. a locale string location to store the language code, or %NULL location to store the country code, or %NULL location to store the codeset, or %NULL location to store the modifier, or %NULL Returns the #GQuark that will be used for #GError values returned by the GnomeRR API. a #GQuark used to identify errors coming from the GnomeRR API. If the current process is running inside a user systemd instance, then move the launched PID into a transient scope. The given @name will be used to create a unit name. It should be the application ID or the executable in all other cases. If a desktop-id is passed then the .desktop suffix will be stripped. It is advisable to use this function every time where the started application can be considered reasonably independent of the launching application. Placing it in a scope creates proper separation between the programs rather than being considered a single entity by systemd. It is always safe to call this function. Note that a successful return code does not imply that a unit has been created. It solely means that no error condition was hit sending the request. If @connection is %NULL then g_dbus_get() will be called internally. Note that most callers will not need to handle errors. As such, it is normal to pass a %NULL @callback. Name for the application The PID of the application A description to use for the unit, or %NULL An #GDBusConnection to the session bus, or %NULL #GCancellable to use Callback to call when the operation is done Data to be passed to @callback Finish an asynchronous operation to create a transient scope that was started with gnome_start_systemd_scope(). Note that a successful return code does not imply that a unit has been created. It solely means that no error condition was hit sending the request. %FALSE on error, %TRUE otherwise A #GAsyncResult