Controls in which Cinnamon states an action (like keybindings and gestures) should be handled. block action allow action when in window mode, e.g. when the focus is in an application window allow action while the overview is active allow action when the screen is locked, e.g. when the screen shield is shown allow action in the unlock dialog allow action in the login screen allow action when a system modal dialog (e.g. authentication or session dialogs) is open allow action in looking glass allow action while a shell menu is open always allow action Like cinnamon_app_activate_full(), but using the default workspace and event timestamp. a #CinnamonApp Perform an appropriate default action for operating on this application, dependent on its current state. For example, if the application is not currently running, launch it. If it is running, activate the most recently used NORMAL window (or if that window has a transient, the most recently used transient for that window). a #CinnamonApp launch on this workspace, or -1 for default. Ignored if activating an existing window Event timestamp Bring all windows for the given app to the foreground, but ensure that @window is on top. If @window is %NULL, the window with the most recent user time for the app will be used. This function has no effect if @app is not currently running. a #CinnamonApp Window to be focused Event timestamp Returns %TRUE if the app supports opening a new window through cinnamon_app_open_new_window() (ie, if calling that function will result in actually opening a new window and not something else, like presenting the most recently active one) a #CinnamonApp Look up the icon for this application, and create a #ClutterActor for it at the given size. A floating #ClutterActor Look up the icon for this application, and create a #ClutterTexture for it at the given size. If for_window is NULL, it bases the icon off the most-recently-used window for the app, otherwise it attempts to use for_window for determining the icon. A floating #ClutterActor a #CinnamonApp the size of the icon to create Optional - the backing MetaWindow to look up for. The #GMenuDesktopAppInfo for this app, or %NULL if backed by a window a #CinnamonApp TRUE if #app is a flatpak app, FALSE if not a #CinnamonApp An unordered list of process identifiers associated with this application. a #CinnamonApp State of the application a #CinnamonApp The #GMenuTreeEntry for this app, or %NULL if backed by a window a #CinnamonApp Get the toplevel, interesting windows which are associated with this application. The returned list will be sorted first by whether they're on the active workspace, then by whether they're visible, and finally by the time the user last interacted with them. List of windows A window backed application is one which represents just an open window, i.e. there's no .desktop file association, so we don't know how to launch it again. Event timestamp, or 0 for current event timestamp List of uris to pass to application Start on this workspace, or -1 for default Returned startup notification ID, or %NULL if none Launch an application using the dedicated gpu (if available) Event timestamp, or 0 for current event timestamp List of uris to pass to application Start on this workspace, or -1 for default Returned startup notification ID, or %NULL if none Request that the application create a new window. a #CinnamonApp open on this workspace, or -1 for default Initiate an asynchronous request to quit this application. The application may interact with the user, and the user might cancel the quit request from the application UI. This operation may not be supported for all applications. %TRUE if a quit request is supported for this application A #CinnamonApp The high-level state of the application, effectively whether it's running or not, or transitioning between those states. The global #CinnamonAppSystem singleton All installed applications Returns the set of applications which currently have at least one open window in the given context. Active applications A #CinnamonAppSystem The #GMenuTree for apps Find a #CinnamonApp corresponding to an id. The #CinnamonApp for id, or %NULL if none Find a valid application whose .desktop file, without the extension and properly canonicalized, matches @wmclass. A #CinnamonApp for @wmclass a #CinnamonAppSystem A WM_CLASS value Find a #CinnamonApp corresponding to a flatpak app id. The #CinnamonApp for app_id, or %NULL if none Find a valid application whose .desktop file contains a StartupWMClass entry matching @wmclass. A #CinnamonApp for @wmclass a #CinnamonAppSystem A WM_CLASS value Abstract interface type for the D-Bus interface <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link>. Gets a machine-readable description of the <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link> D-Bus interface. A #GDBusInterfaceInfo. Do not free. Overrides all #GObject properties in the #CinnamonCalendarServer interface for a concrete class. The properties are overridden in the order they are defined. The last property id. The class structure for a #GObject derived class. The property id to assign to the first overridden property. Handler for the #CinnamonCalendarServer::client-disappeared signal. Handler for the #CinnamonCalendarServer::events-added-or-updated signal. Handler for the #CinnamonCalendarServer::events-removed signal. Gets the value of the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Since">"Since"</link> D-Bus property. Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. The property value. A #CinnamonCalendarServer. Gets the value of the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Status">"Status"</link> D-Bus property. Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. The property value. A #CinnamonCalendarServer. Gets the value of the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Until">"Until"</link> D-Bus property. Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. The property value. A #CinnamonCalendarServer. Handler for the #CinnamonCalendarServer::handle-exit signal. Handler for the #CinnamonCalendarServer::handle-set-time-range signal. Asynchronously invokes the <link linkend="gdbus-method-org-cinnamon-CalendarServer.Exit">Exit()</link> D-Bus method on @proxy. When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call cinnamon_calendar_server_call_exit_finish() to get the result of the operation. See cinnamon_calendar_server_call_exit_sync() for the synchronous, blocking version of this method. A #CinnamonCalendarServerProxy. A #GCancellable or %NULL. A #GAsyncReadyCallback to call when the request is satisfied or %NULL. User data to pass to @callback. Finishes an operation started with cinnamon_calendar_server_call_exit(). %TRUE if the call succeeded, %FALSE if @error is set. A #CinnamonCalendarServerProxy. The #GAsyncResult obtained from the #GAsyncReadyCallback passed to cinnamon_calendar_server_call_exit(). Synchronously invokes the <link linkend="gdbus-method-org-cinnamon-CalendarServer.Exit">Exit()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. See cinnamon_calendar_server_call_exit() for the asynchronous version of this method. %TRUE if the call succeeded, %FALSE if @error is set. A #CinnamonCalendarServerProxy. A #GCancellable or %NULL. Asynchronously invokes the <link linkend="gdbus-method-org-cinnamon-CalendarServer.SetTimeRange">SetTimeRange()</link> D-Bus method on @proxy. When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call cinnamon_calendar_server_call_set_time_range_finish() to get the result of the operation. See cinnamon_calendar_server_call_set_time_range_sync() for the synchronous, blocking version of this method. A #CinnamonCalendarServerProxy. Argument to pass with the method invocation. Argument to pass with the method invocation. Argument to pass with the method invocation. A #GCancellable or %NULL. A #GAsyncReadyCallback to call when the request is satisfied or %NULL. User data to pass to @callback. Finishes an operation started with cinnamon_calendar_server_call_set_time_range(). %TRUE if the call succeeded, %FALSE if @error is set. A #CinnamonCalendarServerProxy. The #GAsyncResult obtained from the #GAsyncReadyCallback passed to cinnamon_calendar_server_call_set_time_range(). Synchronously invokes the <link linkend="gdbus-method-org-cinnamon-CalendarServer.SetTimeRange">SetTimeRange()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. See cinnamon_calendar_server_call_set_time_range() for the asynchronous version of this method. %TRUE if the call succeeded, %FALSE if @error is set. A #CinnamonCalendarServerProxy. Argument to pass with the method invocation. Argument to pass with the method invocation. Argument to pass with the method invocation. A #GCancellable or %NULL. Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-cinnamon-CalendarServer.Exit">Exit()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. This method will free @invocation, you cannot use it afterwards. A #CinnamonCalendarServer. A #GDBusMethodInvocation. Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-cinnamon-CalendarServer.SetTimeRange">SetTimeRange()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. This method will free @invocation, you cannot use it afterwards. A #CinnamonCalendarServer. A #GDBusMethodInvocation. Emits the <link linkend="gdbus-signal-org-cinnamon-CalendarServer.ClientDisappeared">"ClientDisappeared"</link> D-Bus signal. A #CinnamonCalendarServer. Argument to pass with the signal. Emits the <link linkend="gdbus-signal-org-cinnamon-CalendarServer.EventsAddedOrUpdated">"EventsAddedOrUpdated"</link> D-Bus signal. A #CinnamonCalendarServer. Argument to pass with the signal. Emits the <link linkend="gdbus-signal-org-cinnamon-CalendarServer.EventsRemoved">"EventsRemoved"</link> D-Bus signal. A #CinnamonCalendarServer. Argument to pass with the signal. Gets the value of the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Since">"Since"</link> D-Bus property. Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. The property value. A #CinnamonCalendarServer. Gets the value of the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Status">"Status"</link> D-Bus property. Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. The property value. A #CinnamonCalendarServer. Gets the value of the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Until">"Until"</link> D-Bus property. Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. The property value. A #CinnamonCalendarServer. Sets the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Since">"Since"</link> D-Bus property to @value. Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. A #CinnamonCalendarServer. The value to set. Sets the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Status">"Status"</link> D-Bus property to @value. Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. A #CinnamonCalendarServer. The value to set. Sets the <link linkend="gdbus-property-org-cinnamon-CalendarServer.Until">"Until"</link> D-Bus property to @value. Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. A #CinnamonCalendarServer. The value to set. Represents the D-Bus property <link linkend="gdbus-property-org-cinnamon-CalendarServer.Since">"Since"</link>. Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. Represents the D-Bus property <link linkend="gdbus-property-org-cinnamon-CalendarServer.Status">"Status"</link>. Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. Represents the D-Bus property <link linkend="gdbus-property-org-cinnamon-CalendarServer.Until">"Until"</link>. Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-cinnamon-CalendarServer.ClientDisappeared">"ClientDisappeared"</link> is received. On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal. Argument. On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-cinnamon-CalendarServer.EventsAddedOrUpdated">"EventsAddedOrUpdated"</link> is received. On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal. Argument. On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-cinnamon-CalendarServer.EventsRemoved">"EventsRemoved"</link> is received. On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal. Argument. Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-cinnamon-CalendarServer.Exit">Exit()</link> D-Bus method. If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call cinnamon_calendar_server_complete_exit() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. %G_DBUS_METHOD_INVOCATION_HANDLED or %TRUE if the invocation was handled, %G_DBUS_METHOD_INVOCATION_UNHANDLED or %FALSE to let other signal handlers run. A #GDBusMethodInvocation. Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-cinnamon-CalendarServer.SetTimeRange">SetTimeRange()</link> D-Bus method. If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call cinnamon_calendar_server_complete_set_time_range() or e.g. g_dbus_method_invocation_return_error() on it) and no other signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. %G_DBUS_METHOD_INVOCATION_HANDLED or %TRUE if the invocation was handled, %G_DBUS_METHOD_INVOCATION_UNHANDLED or %FALSE to let other signal handlers run. A #GDBusMethodInvocation. Argument passed by remote caller. Argument passed by remote caller. Argument passed by remote caller. Virtual table for the D-Bus interface <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link>. The parent interface. Handler for the #CinnamonCalendarServer::handle-exit signal. Handler for the #CinnamonCalendarServer::handle-set-time-range signal. Getter for the #CinnamonCalendarServer:since property. The property value. A #CinnamonCalendarServer. Getter for the #CinnamonCalendarServer:status property. The property value. A #CinnamonCalendarServer. Getter for the #CinnamonCalendarServer:until property. The property value. A #CinnamonCalendarServer. Handler for the #CinnamonCalendarServer::client-disappeared signal. Handler for the #CinnamonCalendarServer::events-added-or-updated signal. Handler for the #CinnamonCalendarServer::events-removed signal. The #CinnamonCalendarServerProxy structure contains only private data and should only be accessed using the provided API. Finishes an operation started with cinnamon_calendar_server_proxy_new(). The constructed proxy object or %NULL if @error is set. The #GAsyncResult obtained from the #GAsyncReadyCallback passed to cinnamon_calendar_server_proxy_new(). Finishes an operation started with cinnamon_calendar_server_proxy_new_for_bus(). The constructed proxy object or %NULL if @error is set. The #GAsyncResult obtained from the #GAsyncReadyCallback passed to cinnamon_calendar_server_proxy_new_for_bus(). Like cinnamon_calendar_server_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. The calling thread is blocked until a reply is received. See cinnamon_calendar_server_proxy_new_for_bus() for the asynchronous version of this constructor. The constructed proxy object or %NULL if @error is set. A #GBusType. Flags from the #GDBusProxyFlags enumeration. A bus name (well-known or unique). An object path. A #GCancellable or %NULL. Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link>. See g_dbus_proxy_new_sync() for more details. The calling thread is blocked until a reply is received. See cinnamon_calendar_server_proxy_new() for the asynchronous version of this constructor. The constructed proxy object or %NULL if @error is set. A #GDBusConnection. Flags from the #GDBusProxyFlags enumeration. A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. An object path. A #GCancellable or %NULL. Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link>. See g_dbus_proxy_new() for more details. When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call cinnamon_calendar_server_proxy_new_finish() to get the result of the operation. See cinnamon_calendar_server_proxy_new_sync() for the synchronous, blocking version of this constructor. A #GDBusConnection. Flags from the #GDBusProxyFlags enumeration. A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. An object path. A #GCancellable or %NULL. A #GAsyncReadyCallback to call when the request is satisfied. User data to pass to @callback. Like cinnamon_calendar_server_proxy_new() but takes a #GBusType instead of a #GDBusConnection. When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). You can then call cinnamon_calendar_server_proxy_new_for_bus_finish() to get the result of the operation. See cinnamon_calendar_server_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. A #GBusType. Flags from the #GDBusProxyFlags enumeration. A bus name (well-known or unique). An object path. A #GCancellable or %NULL. A #GAsyncReadyCallback to call when the request is satisfied. User data to pass to @callback. Class structure for #CinnamonCalendarServerProxy. The parent class. The #CinnamonCalendarServerSkeleton structure contains only private data and should only be accessed using the provided API. Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link>. The skeleton object. Class structure for #CinnamonCalendarServerSkeleton. The parent class. This section contains code for working with the <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link> D-Bus interface in C. short_description: Record from a #ClutterStage The #CinnamonRecorder object is used to make recordings ("screencasts") of a #ClutterStage. Recording is done via #GStreamer. The default is to encode as a Theora movie and write it to a file in the current directory named after the date, but the encoding and output can be configured. The global #CinnamonDocSystem singleton Returns the currently cached set of recent files. Recent files are read initially from the underlying #GtkRecentManager, and updated when it changes. This function does not perform I/O. Cached recent file infos A #CinnamonDocSystem Callback type for cinnamon_get_file_contents_utf8() The contents of the file Data passed to cinnamon_get_file_contents_utf8() Adds a GLSL snippet to the pipeline used for drawing the effect texture. See #CoglSnippet for details. This is only valid inside the a call to the build_pipeline() virtual function. a #CinnamonGLSLEffect where to insert the code GLSL declarations GLSL code whether Cogl code should be replaced by the custom shader the location of the uniform named @name, that can be passed to cinnamon_glsl_effect_set_uniform_float(). a #CinnamonGLSLEffect the uniform name a #CinnamonGLSLEffect the uniform location (as returned by cinnamon_glsl_effect_get_uniform_location()) the number of components in the uniform (eg. 3 for a vec3) the total number of floats in @value the array of floats to set @uniform Number of children which will not be painted. A #CinnamonGenericContainer Gets whether or not @actor is skipped when painting. %TRUE or %FALSE A #CinnamonGenericContainer Child #ClutterActor Set whether or not we should skip painting @actor. Workaround for lack of gjs ability to override _paint vfunc. A #CinnamonGenericContainer Child #ClutterActor %TRUE if we should skip painting Emitted when @self is allocated, after chaining up to the parent allocate method. Note that @box is @self's content box (qv st_theme_node_get_content_box()), NOT its allocation. @self's content box the allocation flags. Emitted when clutter_actor_get_preferred_height() is called on @self. You should fill in the fields of @alloc with the your minimum and natural heights. #CinnamonGenericContainer will deal with taking its borders and padding into account for you. @alloc's fields are initialized to 0, so unless you have a fixed height specified (via #ClutterActor:height or CSS), you must connect to this signal and fill in the values. as in clutter_actor_get_preferred_height() a #CinnamonGenericContainerAllocation to be filled in Emitted when clutter_actor_get_preferred_width() is called on @self. You should fill in the fields of @alloc with the your minimum and natural widths. #CinnamonGenericContainer will deal with taking its borders and padding into account for you. @alloc's fields are initialized to 0, so unless you have a fixed width specified (via #ClutterActor:width or CSS), you must connect to this signal and fill in the values. as in clutter_actor_get_preferred_width() a #CinnamonGenericContainerAllocation to be filled in Gets the singleton global object that represents the desktop. the singleton global object Request mb megabytes allocated. This is just for debugging. the #CinnamonGlobal How many mb to leak Grabs the keyboard and mouse to the stage window. The stage will receive all keyboard and mouse events until cinnamon_global_end_modal() is called. This is used to implement "modes" for the shell, such as the overview mode or the "looking glass" debug overlay, that block application and normal key shortcuts. %TRUE if we successfully entered the mode. %FALSE if we couldn't enter the mode. Failure may occur because an application has the pointer or keyboard grabbed, because Mutter is in a mode itself like moving a window or alt-Tab window selection, or because cinnamon_global_begin_modal() was previously called. a #CinnamonGlobal Marks that we are currently doing work. This is used to to track whether we are busy for the purposes of cinnamon_global_run_at_leisure(). A count is kept and cinnamon_global_end_work() must be called exactly as many times as cinnamon_global_begin_work(). the #CinnamonGlobal Create a #GAppLaunchContext set up with the correct timestamp, and targeted to activate on the current workspace. A new #GAppLaunchContext A #CinnaamonGlobal Prints out the gjs stack A #CinnamonGlobal Undoes the effect of cinnamon_global_begin_modal(). a #CinnamonGlobal Marks the end of work that we started with cinnamon_global_begin_work(). If no other work is ongoing and functions have been added with cinnamon_global_run_at_leisure(), they will be run at the next opportunity. the #CinnamonGlobal the current X server time from the current Clutter, Gdk, or X event. If called from outside an event handler, this may return %Clutter.CURRENT_TIME (aka 0), or it may return a slightly out-of-date timestamp. A #CinnamonGlobal The default #MetaDisplay the MD5 sum for the given string input string the pid of the cinnamon process. Gets the pointer coordinates and current modifier key state. This is a wrapper around gdk_display_get_pointer() that strips out any un-declared modifier flags, to make gjs happy; see https://bugzilla.gnome.org/show_bug.cgi?id=597292. the #CinnamonGlobal the X coordinate of the pointer, in global coordinates the Y coordinate of the pointer, in global coordinates the current set of modifier keys that are pressed down The (Meta) CinnamonScreen Get the global GSettings instance. The GSettings object A #CinnamonGlobal The default #ClutterStage Gets the list of #MetaWindowActor for the plugin's screen the list of windows Show a system error notification. Use this function when a user-initiated action results in a non-fatal problem from causes that may not be under system control. For example, an application crash. a #CinnamonGlobal Error message Error details Restart the current process. A #CinnamonGlobal Initiates the shutdown sequence. A #CinnamonGlobal Schedules a function to be called the next time Cinnamon is idle. Idle means here no animations, no redrawing, and no ongoing background work. Since there is currently no way to hook into the Clutter master clock and know when is running, the implementation here is somewhat approximation. Animations done through Cinnamon's Tweener module will be handled properly, but other animations may be detected as terminating early if they can be drawn fast enough so that the event loop goes idle between frames. The intent of this function is for performance measurement runs where a number of actions should be run serially and each action is timed individually. Using this function for other purposes will interfere with the ability to use it for performance measurement so should be avoided. the #CinnamonGlobal function to call at leisure data to pass to @func function to call to free @user_data Crashes Cinnamon by causing a segfault the #CinnamonGlobal Set the cursor on the stage window. A #CinnamonGlobal the type of the cursor Sets the pointer coordinates. the #CinnamonGlobal the X coordinate of the pointer, in global coordinates the Y coordinate of the pointer, in global coordinates Sets the input mode of the stage; when @mode is %CINNAMON_STAGE_INPUT_MODE_NONREACTIVE, then the stage does not absorb any clicks, but just passes them through to underlying windows. When it is %CINNAMON_STAGE_INPUT_MODE_NORMAL, then the stage accepts clicks in the region defined by cinnamon_global_set_stage_input_region() but passes through clicks outside that region. When it is %CINNAMON_STAGE_INPUT_MODE_FULLSCREEN, the stage absorbs all input. When the input mode is %CINNAMON_STAGE_INPUT_MODE_FOCUSED, the pointer is handled as with %CINNAMON_STAGE_INPUT_MODE_NORMAL, but additionally the stage window has the keyboard focus. If the stage loses the focus (eg, because the user clicked into a window) the input mode will revert to %CINNAMON_STAGE_INPUT_MODE_NORMAL. Note that whenever a muffin-internal Gtk widget has a pointer grab, Cinnamon behaves as though it was in %CINNAMON_STAGE_INPUT_MODE_NONREACTIVE, to ensure that the widget gets any clicks it is expecting. the #CinnamonGlobal the stage input mode Sets the area of the stage that is responsive to mouse clicks when the stage mode is %CINNAMON_STAGE_INPUT_MODE_NORMAL (but does not change the current stage mode). the #CinnamonGlobal a list of #MetaRectangle describing the input region. Ensures that clutter is aware of the current pointer position, causing enter and leave events to be emitted if the pointer moved behind our back (ie, during a pointer grab). the #CinnamonGlobal Unset the cursor on the stage window. A #CinnamonGlobal Create new internal prompt base new internal prompt Called by implementation when the prompt is cancelled. the internal prompt Called by the implementation when the prompt completes. There are various checks done. %TRUE is returned if the prompt actually should complete. whether the prompt completed the internal prompt Get the prompt password text actor the password actor the internal prompt Get the prompt password text actor the password actor the internal prompt Set the prompt password confirmation text actor the internal prompt the confirm password actor Set the prompt password text actor the internal prompt the password actor Whether the choice check box is visible or not. Text field for confirmation password Whether the password confirm entry is visible or not. Text field for password Whether the password entry is visible or not. Whether the warning label is visible or not. The found plugin or %NULL Gets the global singleton performance log. This is initially disabled and must be explicitly enabled with cinnamon_perf_log_set_enabled(). the global singleton performance log Adds a function that will be called before statistics are recorded. The function would typically compute one or more statistics values and call a function such as cinnamon_perf_log_update_statistic_i() to update the value that will be recorded. a #CinnamonPerfLog function to call before recording statistics data to pass to @callback function to call when @user_data is no longer needed Calls all the update functions added with cinnamon_perf_log_add_statistics_callback() and then records events for all statistics, followed by a perf.statisticsCollected event. a #CinnamonPerfLog Defines a performance event for later recording. a #CinnamonPerfLog name of the event. This should of the form '<namespace>.<specific event>', for example 'clutter.stagePaintDone'. human readable description of the event. signature defining the arguments that event takes. This is a string of type characters, using the same characters as D-Bus or GVariant. Only a very limited number of signatures are supported: , '', 's', 'i', and 'x'. This mean respectively: no arguments, one string, one 32-bit integer, and one 64-bit integer. Defines a statistic. A statistic is a numeric value that is stored by the performance log and recorded periodically or when cinnamon_perf_log_collect_statistics() is called explicitly. Code that defines a statistic should update it by calling the update function for the particular data type of the statistic, such as cinnamon_perf_log_update_statistic_i(). This can be done at any time, but would normally done inside a function registered with cinnamon_perf_log_add_statistics_callback(). These functions are called immediately before statistics are recorded. a #CinnamonPerfLog name of the statistic and of the corresponding event. This should follow the same guidelines as for cinnamon_perf_log_define_event() human readable description of the statistic. The type of the data stored for statistic. Must currently be 'i' or 'x'. Dump the definition of currently defined events and statistics, formatted as JSON, to the specified output stream. The JSON output is an array, with each element being a dictionary of the form: { name: <name of event>, description: <description of string>, statistic: true } (only for statistics) %TRUE if the dump succeeded. %FALSE if an IO error occurred a #CinnamonPerfLog output stream into which to write the event definitions Writes the performance event log, formatted as JSON, to the specified output stream. For performance reasons, the output stream passed in should generally be a buffered (or memory) output stream, since it will be written to in small pieces. The JSON output is an array with the elements of the array also being arrays, of the form '[' <time>, <event name> [, <event_arg>... ] ']'. %TRUE if the dump succeeded. %FALSE if an IO error occurred a #CinnamonPerfLog output stream into which to write the event log Records a performance event with no arguments. a #CinnamonPerfLog name of the event Records a performance event with one 32-bit integer argument. a #CinnamonPerfLog name of the event the argument Records a performance event with one string argument. a #CinnamonPerfLog name of the event the argument Records a performance event with one 64-bit integer argument. a #CinnamonPerfLog name of the event the argument Replays the log by calling the given function for each event in the log. a #CinnamonPerfLog function to call for each event in the log data to pass to @replay_function Sets whether events are currently being recorded. a #CinnamonPerfLog whether to record events Updates the current value of an 32-bit integer statistic. a #CinnamonPerfLog name of the statistic new value for the statistic Updates the current value of an 64-bit integer statistic. a #CinnamonPerfLog name of the statistic new value for the statistic Create a new #CinnamonRecorder to record movies of a #ClutterStage The newly created #CinnamonRecorder object The #ClutterStage Stops recording. It's possible to call cinnamon_recorder_record() again to reopen a new recording stream, but unless change the recording filename, this may result in the old recording being overwritten. the #CinnamonRecorder Determine if recording is currently in progress. (The recorder is not paused or closed.) %TRUE if the recorder is currently recording. Starts recording, Starting the recording may fail if the output file cannot be opened, or if the output stream cannot be created for other reasons. In that case a warning is printed to stderr. There is no way currently to get details on how recording failed to start. An extra reference count is added to the recorder if recording is successfully started; the recording object will not be freed until recording is stopped even if the creator no longer holds a reference. Recording is automatically stopped if the stage is destroyed. %TRUE if recording was successfully started the #CinnamonRecorder actual filename used for recording Sets the filename that will be used when creating output files. This is only used if the configured pipeline has an unconnected source pad (as the default pipeline does). If the pipeline is complete, then the filename is unused. The provided string is used as a template.It can contain the following escapes: %d: The current date as YYYYYMMDD %%: A literal percent The default value is 'cinnamon-%d%u-%c.ogg'. the #CinnamonRecorder the filename template to use for output files, or %NULL for the default value. Sets the number of frames per second we try to record. Less frames will be recorded when the screen doesn't need to be redrawn this quickly. (This value will also be set as the framerate for the GStreamer pipeline; whether that has an effect on the resulting video will depend on the details of the pipeline and the codec. The default encoding to webm format doesn't pay attention to the pipeline framerate.) The default value is 30. the #CinnamonRecorder Framerate used for resulting video in frames-per-second. Sets the GStreamer pipeline used to encode recordings. It follows the syntax used for gst-launch. The pipeline should have an unconnected sink pad where the recorded video is recorded. It will normally have a unconnected source pad; output from that pad will be written into the output file. (See cinnamon_recorder_set_file_template().) However the pipeline can also take care of its own output - this might be used to send the output to an icecast server via shout2send or similar. The default value is 'vp8enc min_quantizer=13 max_quantizer=13 cpu-used=5 deadline=1000000 threads=%T ! queue ! webmmux' the #CinnamonRecorder the GStreamer pipeline used to encode recordings or %NULL for the default value. Append a new workspace to the screen and (optionally) switch to that screen. the newly appended workspace. a #CinnamonScreen %TRUE if the workspace should be switched to after creation if switching to a new workspace, timestamp to be used when focusing a window on the new workspace. (Doesn't hurt to pass a valid timestamp when available even if not switching workspaces.) The current workspace Gets the index of the monitor that currently has the mouse pointer. a monitor index a #CinnamonScreen Retrieve the display associated with screen. Display A #CinnamonScreen Stores the location and size of the indicated monitor in @geometry. a #CinnamonScreen the monitor number location to store the monitor geometry Determines whether there is a fullscreen window obscuring the specified monitor. If there is a fullscreen window, the desktop environment will typically hide any controls that might obscure the fullscreen window. You can get notification when this changes by connecting to CinnamonScreen::in-fullscreen-changed. %TRUE if there is a fullscreen window covering the specified monitor. a #CinnamonScreen the monitor number Gets the #MetaWindow pointed by the mouse the #MetaWindow pointed by the mouse %NULL when window not found a cinnamon-screen. window to be excluded Gets the number of monitors that are joined together to form @screen. the number of monitors a #CinnamonScreen Gets the index of the primary monitor on this @screen. a monitor index a #CinnamonScreen Retrieve the size of the screen. A #CinnamonScreen The width of the screen The height of the screen Gets the workspace object for one of a screen's workspaces given the workspace index. It's valid to call this function with an out-of-range index and it will robustly return %NULL. the workspace object with specified index, or %NULL if the index is out of range. a #CinnamonScreen index of one of the screen's workspaces The workspaces for @screen a #CinnamonScreen Explicitly set the layout of workspaces. Once this has been called, the contents of the _NET_DESKTOP_LAYOUT property on the root window are completely ignored. a #CinnamonScreen the corner at which the first workspace is found if %TRUE the workspaces are laid out in columns rather than rows number of rows of workspaces, or -1 to determine the number of rows from @n_columns and the total number of workspaces number of columns of workspaces, or -1 to determine the number of columns from @n_rows and the total number of workspaces Picks the pixel at @x, @y and returns its color as #ClutterColor in callback. the #CinnamonScreenshot The X coordinate to pick The Y coordinate to pick function to call when finished Takes a screenshot of the whole screen in @filename as png image. the #CinnamonScreenshot Whether to include the cursor or not The filename for the screenshot function to call returning success or failure of the async grabbing Takes a screenshot of the passed in area and saves it in @filename as png image. the #CinnamonScreenshot The X coordinate of the area The Y coordinate of the area The width of the area The height of the area The filename for the screenshot function to call returning success or failure of the async grabbing Takes a screenshot of the focused window (optionally omitting the frame) in @filename as png image. the #CinnamonScreenshot Whether to include the frame or not Whether to include the cursor or not The filename for the screenshot function to call returning success or failure of the async grabbing Temporary hack to work around Cogl not exporting CoglSnippetHook in the 1.0 API. Don't use. Converts a ClutterEvent into an XEvent. Whether to continue the event chain. a #CinnamonTrayIcon a #ClutterEventType the #ClutterEvent Creates a new window management interface by hooking into @plugin. the new window-management interface the #MetaPlugin The plugin must call this after the user responded to the confirmation dialog. the CinnamonWM if the new configuration was OK The plugin must call this when it has completed a window destroy effect. the CinnamonWM the MetaWindowActor actor The plugin must call this when it has completed a window map effect. the CinnamonWM the MetaWindowActor actor The plugin must call this when it has completed a window minimize effect. the CinnamonWM the MetaWindowActor actor The plugin must call this when it has finished switching the workspace. the CinnamonWM The plugin must call this when it has completed a window unminimize effect. the CinnamonWM the MetaWindowActor actor Creates a close dialog for the given window. The close dialog instance. The window to create the dialog for Creates an inhibit shortcuts dialog for the given window. The inhibit shortcuts dialog instance. The window to create the dialog for The global #CinnamonWindowTracker instance @self; A #CinnamonAppSystem Look up the application corresponding to a process. A #CinnamonApp, or %NULL if none A Unix process identifier Currently active startup sequences Application associated with window An app monitor instance A #MetaWindow The CinnamonWindowTracker associates certain kinds of windows with applications; however, others we don't want to appear in places where we want to give a list of windows for an application, such as the alt-tab dialog. An example of a window we don't want to show is the root desktop window. We skip all override-redirect types, and also exclude other window types like tooltip explicitly, though generally most of these should be override-redirect. %TRUE if a window is "interesting" the CinnamonWindowTracker a #MetaWindow Using G_BREAKPOINT(), interrupt the current process. This is useful in conjunction with a debugger such as gdb. Gets a machine-readable description of the <link linkend="gdbus-interface-org-cinnamon-CalendarServer.top_of_page">org.cinnamon.CalendarServer</link> D-Bus interface. A #GDBusInterfaceInfo. Do not free. Overrides all #GObject properties in the #CinnamonCalendarServer interface for a concrete class. The properties are overridden in the order they are defined. The last property id. The class structure for a #GObject derived class. The property id to assign to the first overridden property. This object wraps a #GMenuTreeEntry, providing methods and signals primarily useful for running applications. Wraps #GtkRecentManager, caching recently used document information, and adds APIs for asynchronous queries. #CinnamonGenericContainer is mainly a workaround for the current lack of GObject subclassing + vfunc overrides in gjs. We implement the container interface, but proxy the virtual functions into signals, which gjs can catch. #CinnamonGenericContainer is an #StWidget, and automatically takes its borders and padding into account during size request and allocation. A #CinnamonGLSLEffect is #ClutterOffscreenEffect that allows running custom GLSL to the vertex fragment stages of the graphic pipeline. CinnamonPerfLog provides a way for different parts of the code to record information for subsequent analysis and interactive exploration. Events exist of a timestamp, an event ID, and arguments to the event. Emphasis is placed on storing recorded events in a compact fashion so log recording disturbs the execution of the program as little as possible, however events should not be recorded at too fine a granularity - an event that is recorded once per frame or once per user action is appropriate, an event that occurs many times per frame is not. Arguments are identified by a D-Bus style signature; at the moment only a limited number of event signatures are supported to simplify the code. The #CinnamonScreenshot object is used to take screenshots of screen areas or windows and write them out as png files. A #StBin that has 0 minimum size, and will clip its child in the middle. A #CinnamonStack draws its children on top of each other, aligned to the top left. It will be sized in width/height according to the largest such dimension of its children, and all children will be allocated that size. This differs from #ClutterGroup which allocates its children their natural size, even if that would overflow the size allocated to the stack. Maintains a mapping from windows to applications (.desktop file ids). It currently implements this with some heuristics on the WM_CLASS X11 property (and some static override regexps); in the future, we want to have it also track through startup-notification. Gets the current state of the event (the set of modifier keys that are pressed down). This is a wrapper around clutter_event_get_state() that strips out any un-declared modifier flags, to make gjs happy; see https://bugzilla.gnome.org/show_bug.cgi?id=597292. the state from the event a #ClutterEvent Asynchronously load the contents of a file as a NUL terminated string, validating it as UTF-8. Embedded NUL characters count as invalid content. UTF-8 encoded filename path The callback to call when finished data to pass with the callback Synchronously load the contents of a file as a NUL terminated string, validating it as UTF-8. Embedded NUL characters count as invalid content. File contents UTF-8 encoded filename path %TRUE on success description of provider location to store a display name location to store template of url list of supported languages location to store uri Set a double uniform on a ClutterShaderEffect. The problem here is that JavaScript doesn't have more than one number type, and gjs tries to automatically guess what type we want to set a GValue to. If the number is "1.0" or something, it will use an integer, which will cause errors in GLSL. The #ClutterShaderEffect The name of the uniform The value to set it to. Formats a date for the current locale. This should be used instead of the Spidermonkey Date.toLocaleFormat() extension because Date.toLocaleFormat() is buggy for Unicode format strings: https://bugzilla.mozilla.org/show_bug.cgi?id=508783 the formatted date. If the date is outside of the range of a GDateTime (which contains any plausible dates we actually care about), will return an empty string. a strftime-style string format, as parsed by g_date_time_format() milliseconds since 1970-01-01 00:00:00 UTC; the value returned by Date.getTime() a new #ClutterContent a #MetaWindowActor a #MetaRectangle Look up the icon that should be associated with a given URI. Handles various special GNOME-internal cases like x-nautilus-search, etc. A new #GIcon A URI This function is similar to a combination of clutter_actor_get_transformed_position(), and clutter_actor_get_transformed_size(), but unlike clutter_actor_get_transformed_size(), it always returns a transform of the current allocation, while clutter_actor_get_transformed_size() returns bad values (the transform of the requested size) if a relayout has been queued. This function is more convenient to use than clutter_actor_get_abs_allocation_vertices() if no transformation is in effect and also works around limitations in the GJS binding of arrays. a #ClutterActor location to store returned box in stage coordinates Gets the first week day for the current locale, expressed as a number in the range 0..6, representing week days from Sunday to Saturday. A number representing the first week day for the current locale If @hidden is %TRUE, hide @actor from pick even with a mode of %CLUTTER_PICK_ALL; if @hidden is %FALSE, unhide @actor. A #ClutterActor Whether @actor should be hidden from pick Implements libc standard WIFEXITED, that cannot be used JS code. TRUE if the process exited normally, FALSE otherwise the status returned by wait() or waitpid() the actual exit status of the process Write a string to a GOutputStream as UTF-8. This is a workaround for not having binary buffers in GJS. %TRUE if write succeeded a #GOutputStream a UTF-8 string to write to @stream