|  |  |  | Shell Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
void shell_util_set_hidden_from_pick (ClutterActor *actor,gboolean hidden); void shell_util_get_transformed_allocation (ClutterActor *actor,ClutterActorBox *box); int shell_util_get_week_start (void); char * shell_util_normalize_and_casefold (const char *str); char * shell_util_format_date (const char *format,gint64 time_ms); gboolean shell_write_string_to_stream (GOutputStream *stream,const char *str,GError **error); char * shell_get_file_contents_utf8_sync (const char *path,GError **error); gboolean shell_session_is_active_for_systemd (void); gboolean shell_util_wifexited (int status,int *exit); GdkPixbuf * shell_util_create_pixbuf_from_data (const guchar *data,gsize len,GdkColorspace colorspace,gboolean has_alpha,int bits_per_sample,int width,int height,int rowstride);
void shell_util_set_hidden_from_pick (ClutterActor *actor,gboolean hidden);
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 actorshould be hidden from pick | 
void shell_util_get_transformed_allocation (ClutterActor *actor,ClutterActorBox *box);
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. [out] | 
int                 shell_util_get_week_start           (void);
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.
| Returns : | A number representing the first week day for the current locale | 
char * shell_util_format_date (const char *format,gint64 time_ms);
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
| 
 | 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() | 
| Returns : | 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. | 
gboolean shell_write_string_to_stream (GOutputStream *stream,const char *str,GError **error);
Write a string to a GOutputStream as UTF-8. This is a workaround for not having binary buffers in GJS.
| 
 | a GOutputStream | 
| 
 | a UTF-8 string to write to stream | 
| 
 | location to store GError | 
| Returns : | TRUEif write succeeded | 
char * shell_get_file_contents_utf8_sync (const char *path,GError **error);
Synchronously 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 | 
| 
 | a GError | 
| Returns : | File contents. [transfer full] | 
gboolean            shell_session_is_active_for_systemd (void);
Checks whether the session we are running in is currently active, i.e. in the foreground and ready for user input.
| Returns : | TRUE if session is active | 
gboolean shell_util_wifexited (int status,int *exit);
Implements libc standard WIFEXITED, that cannot be used JS code.
| 
 | the status returned by wait()orwaitpid() | 
| 
 | the actual exit status of the process. [out] | 
| Returns : | TRUE if the process exited normally, FALSE otherwise | 
GdkPixbuf * shell_util_create_pixbuf_from_data (const guchar *data,gsize len,GdkColorspace colorspace,gboolean has_alpha,int bits_per_sample,int width,int height,int rowstride);
Workaround for non-introspectability of gdk_pixbuf_from_data().
| 
 | . [array length=len][element-type guint8][transfer full] | 
| Returns : | . [transfer full] |