Add support for "top" option to icon_position rule and hide_text rule

docs/dunst.5.pod

@@ -364,7 +364,7 @@ Hide the count of stacked duplicate notifications.
 Show an indicator if a notification contains actions and/or open-able URLs. See
 ACTIONS below for further details.
 
-=item B<icon_position> (values: [left/right/off], default: off)
+=item B<icon_position> (values: [left/right/top/off], default: off)
 
 Defines the position of the icon in the notification window. Setting it to off
 disables icons.
@@ -884,6 +884,13 @@ Specifies where truncated lines should be ellipsized.
 
 Defines how the text should be aligned within the notification.
 
+=item B<hide_text> (values: [true/false], default: false)
+
+Setting this to true will skip displaying any text related to the notification.
+The notification icon and progress bar will still be displayed. This option may
+be useful for notifications where an icon or progress bar may be sufficient
+information for the notification, such as audio volume or brightness level.
+
 =item B<markup> (values: [full/strip/no], default: no)
 
 Defines how markup in notifications is handled.

dunstrc

@@ -184,7 +184,7 @@
 
     ### Icons ###
 
-    # Align icons left/right/off
+    # Align icons left/right/top/off
     icon_position = left
 
     # Scale small icons up to this size, set to 0 to disable. Helpful
@@ -339,12 +339,14 @@
 #    set_category
 #    timeout
 #    urgency
+#    icon_position
 #    skip_display
 #    history_ignore
 #    action_name
 #    word_wrap
 #    ellipsize
 #    alignment
+#    hide_text
 #
 # Shell-like globbing will get expanded.
 #

src/draw.c

@@ -167,7 +167,7 @@ static struct color layout_get_sepcolor(struct colored_layout *cl,
         }
 }
 
-static int get_text_icon_padding()
+static int get_horizontal_text_icon_padding()
 {
         if (settings.text_icon_padding) {
                 return settings.text_icon_padding;
@@ -176,6 +176,15 @@ static int get_text_icon_padding()
         }
 }
 
+static int get_vertical_text_icon_padding()
+{
+        if (settings.text_icon_padding) {
+                return settings.text_icon_padding;
+        } else {
+                return settings.padding;
+        }
+}
+
 static bool have_progress_bar(const struct colored_layout *cl)
 {
         return (cl->n->progress >= 0 && settings.progress_bar == true &&
@@ -220,8 +229,8 @@ static void layout_setup_pango(PangoLayout *layout, int width, int height,
 // @param height Height of the layout
 static void layout_setup(struct colored_layout *cl, int width, int height, double scale)
 {
-        int icon_width = cl->icon? get_icon_width(cl->icon, scale) + get_text_icon_padding() : 0;
-        int text_width = width - icon_width - 2 * settings.h_padding;
+        int icon_width = cl->icon? get_icon_width(cl->icon, scale) + get_horizontal_text_icon_padding() : 0;
+        int text_width = width - 2 * settings.h_padding - (cl->n->icon_position != ICON_TOP ? icon_width : 0);
         int progress_bar_height = have_progress_bar(cl) ? settings.progress_bar_height + settings.padding : 0;
         int max_text_height = MAX(0, settings.height - progress_bar_height - 2 * settings.padding);
         layout_setup_pango(cl->l, text_width, max_text_height, cl->n->word_wrap, cl->n->ellipsize, cl->n->alignment);
@@ -242,12 +251,26 @@ static struct dimensions calculate_notification_dimensions(struct colored_layout
         struct dimensions dim = { 0 };
         layout_setup(cl, settings.width.max, settings.height, scale);
 
-        int icon_width = cl->icon? get_icon_width(cl->icon, scale) + get_text_icon_padding() : 0;
+        int icon_width = cl->icon? get_icon_width(cl->icon, scale) + get_horizontal_text_icon_padding() : 0;
         int icon_height = cl->icon? get_icon_height(cl->icon, scale) : 0;
         int progress_bar_height = have_progress_bar(cl) ? settings.progress_bar_height + settings.padding : 0;
-        get_text_size(cl->l, &dim.text_width, &dim.text_height, scale);
 
-        dim.h = MAX(icon_height, dim.text_height);
+        int vertical_padding;
+        if (cl->n->hide_text) {
+                vertical_padding = 0;
+                dim.text_width = 0;
+                dim.text_height = 0;
+        } else {
+                get_text_size(cl->l, &dim.text_width, &dim.text_height, scale);
+                vertical_padding = get_vertical_text_icon_padding();
+        }
+
+        if (cl->n->icon_position == ICON_TOP && cl->n->icon) {
+                dim.h = icon_height + dim.text_height + vertical_padding;
+        } else {
+                dim.h = MAX(icon_height, dim.text_height);
+        }
+
         dim.h += progress_bar_height;
         dim.w = dim.text_width + icon_width + 2 * settings.h_padding;
 
@@ -335,7 +358,7 @@ static struct colored_layout *layout_from_notification(cairo_t *c, struct notifi
 
         struct colored_layout *cl = layout_init_shared(c, n);
 
-        if (settings.icon_position != ICON_OFF && n->icon) {
+        if (n->icon_position != ICON_OFF && n->icon) {
                 cl->icon = n->icon;
         } else {
                 cl->icon = NULL;
@@ -399,17 +422,30 @@ static GSList *create_layouts(cairo_t *c)
 
 static int layout_get_height(struct colored_layout *cl, double scale)
 {
-        int h;
+        int h_text = 0;
         int h_icon = 0;
         int h_progress_bar = 0;
-        get_text_size(cl->l, NULL, &h, scale);
+
+        int vertical_padding;
+        if (cl->n->hide_text) {
+                vertical_padding = 0;
+        } else {
+                get_text_size(cl->l, NULL, &h_text, scale);
+                vertical_padding = get_vertical_text_icon_padding();
+        }
+
         if (cl->icon)
                 h_icon = get_icon_height(cl->icon, scale);
         if (have_progress_bar(cl)){
                 h_progress_bar = settings.progress_bar_height + settings.padding;
         }
 
-        int res = MAX(h, h_icon) + h_progress_bar;
+        int res = MAX(h_text, h_icon) + h_progress_bar;
+
+        if (cl->n->icon_position == ICON_TOP && cl->n->icon) {
+                res = h_icon + h_text + h_progress_bar + vertical_padding;
+        }
+
         return res;
 }
 
@@ -594,37 +630,41 @@ static void render_content(cairo_t *c, struct colored_layout *cl, int width, dou
         const int h = layout_get_height(cl, scale);
         LOG_D("Layout height %i", h);
         int h_without_progress_bar = h;
-        if (have_progress_bar(cl)){
+        if (have_progress_bar(cl)) {
                  h_without_progress_bar -= settings.progress_bar_height + settings.padding;
         }
-        int h_text;
-        get_text_size(cl->l, NULL, &h_text, scale);
 
-        int text_x = settings.h_padding,
-            text_y = settings.padding + h_without_progress_bar / 2 - h_text / 2;
+        if (!cl->n->hide_text) {
+                int h_text = 0;
+                get_text_size(cl->l, NULL, &h_text, scale);
 
-        // text positioning
-        if (cl->icon) {
-                // vertical alignment
-                if (settings.vertical_alignment == VERTICAL_TOP) {
-                        text_y = settings.padding;
-                } else if (settings.vertical_alignment == VERTICAL_BOTTOM) {
-                        text_y = h_without_progress_bar + settings.padding - h_text;
-                        if (text_y < 0)
+                int text_x = settings.h_padding,
+                    text_y = settings.padding + h_without_progress_bar / 2 - h_text / 2;
+
+                // text positioning
+                if (cl->icon) {
+                        // vertical alignment
+                        if (settings.vertical_alignment == VERTICAL_TOP) {
                                 text_y = settings.padding;
-                } // else VERTICAL_CENTER
+                        } else if (settings.vertical_alignment == VERTICAL_BOTTOM) {
+                                text_y = h_without_progress_bar + settings.padding - h_text;
+                                if (text_y < 0)
+                                        text_y = settings.padding;
+                        } // else VERTICAL_CENTER
+
+                        // icon position
+                        if (cl->n->icon_position == ICON_LEFT) {
+                                text_x = get_icon_width(cl->icon, scale) + settings.h_padding + get_horizontal_text_icon_padding();
+                        } else if (cl->n->icon_position == ICON_TOP) {
+                                text_y = get_icon_height(cl->icon, scale) + settings.padding + get_vertical_text_icon_padding();
+                        } // else ICON_RIGHT
+                }
+                cairo_move_to(c, round(text_x * scale), round(text_y * scale));
 
-                // icon position
-                if (settings.icon_position == ICON_LEFT) {
-                        text_x = get_icon_width(cl->icon, scale) + settings.h_padding + get_text_icon_padding();
-                } // else ICON_RIGHT
+                cairo_set_source_rgba(c, cl->fg.r, cl->fg.g, cl->fg.b, cl->fg.a);
+                pango_cairo_update_layout(c, cl->l);
+                pango_cairo_show_layout(c, cl->l);
         }
-        cairo_move_to(c, round(text_x * scale), round(text_y * scale));
-
-        cairo_set_source_rgba(c, cl->fg.r, cl->fg.g, cl->fg.b, cl->fg.a);
-        pango_cairo_update_layout(c, cl->l);
-        pango_cairo_show_layout(c, cl->l);
-
 
         // icon positioning
         if (cl->icon) {
@@ -643,8 +683,11 @@ static void render_content(cairo_t *c, struct colored_layout *cl, int width, dou
                 } // else VERTICAL_CENTER
 
                 // icon position
-                if (settings.icon_position == ICON_LEFT) {
+                if (cl->n->icon_position == ICON_LEFT) {
                         image_x = settings.h_padding;
+                } else if (cl->n->icon_position == ICON_TOP) {
+                        image_y = settings.padding;
+                        image_x = width/2 - image_width/2;
                 } // else ICON_RIGHT
 
                 cairo_set_source_surface(c, cl->icon, round(image_x * scale), round(image_y * scale));
@@ -658,7 +701,7 @@ static void render_content(cairo_t *c, struct colored_layout *cl, int width, dou
                 unsigned int frame_width = settings.progress_bar_frame_width,
                              progress_width = MIN(width - 2 * settings.h_padding, settings.progress_bar_max_width),
                              progress_height = settings.progress_bar_height - frame_width,
-                             frame_x = settings.h_padding,
+                             frame_x = width/2 - progress_width/2,
                              frame_y = settings.padding + h - settings.progress_bar_height,
                              progress_width_without_frame = progress_width - 2 * frame_width,
                              progress_width_1 = progress_width_without_frame * progress / 100,

src/notification.c

@@ -417,6 +417,8 @@ struct notification *notification_create(void)
         n->word_wrap = true;
         n->ellipsize = PANGO_ELLIPSIZE_MIDDLE;
         n->alignment = PANGO_ALIGN_LEFT;
+        n->hide_text = false;
+        n->icon_position = settings.icon_position;
         n->icon_size = 32;
 
         n->script_run = false;

src/notification.h

@@ -11,6 +11,13 @@
 
 #define DUNST_NOTIF_MAX_CHARS 50000
 
+enum icon_position {
+        ICON_LEFT,
+        ICON_RIGHT,
+        ICON_TOP,
+        ICON_OFF
+};
+
 enum behavior_fullscreen {
         FS_NULL,      //!< Invalid value
         FS_DELAY,     //!< Delay the notification until leaving fullscreen mode
@@ -58,6 +65,7 @@ struct notification {
         char *icon_path;         /**< Full path to the notification's icon. */
         char *default_icon_name; /**< The icon that is used when no other icon is available. */
         int icon_size;           /**< Size of the icon used for searching the right icon. */
+        enum icon_position icon_position;       /**< Icon position (enum left,right,top,off). */
 
         gint64 start;      /**< begin of current display (in milliseconds) */
         gint64 timestamp;  /**< arrival time (in milliseconds) */
@@ -92,6 +100,7 @@ struct notification {
         bool word_wrap;
         PangoEllipsizeMode ellipsize;
         PangoAlignment alignment;
+        bool hide_text;
 
         /* derived fields */
         char *msg;            /**< formatted message */

src/rules.c

@@ -36,6 +36,8 @@ void rule_apply(struct rule *r, struct notification *n)
                 n->ellipsize = r->ellipsize;
         if (r->alignment != -1)
                 n->alignment = r->alignment;
+        if (r->hide_text != -1)
+                n->hide_text = r->hide_text;
         if (r->action_name) {
                 g_free(n->default_action_name);
                 n->default_action_name = g_strdup(r->action_name);
@@ -46,6 +48,8 @@ void rule_apply(struct rule *r, struct notification *n)
         }
         if (r->markup != MARKUP_NULL)
                 n->markup = r->markup;
+        if (r->icon_position != -1)
+                n->icon_position = r->icon_position;
         if (r->set_icon_size > 0)
                 n->icon_size = r->set_icon_size;
         if (r->fg) {

src/rules.h

@@ -39,6 +39,8 @@ struct rule {
         int word_wrap;
         int ellipsize;
         int alignment;
+        int hide_text;
+        int icon_position;
         int set_icon_size;
         char *new_icon;
         char *fg;
@@ -52,6 +54,7 @@ struct rule {
         enum behavior_fullscreen fullscreen;
         char *set_stack_tag; // this has to be the last action
         bool enabled;
+
 };
 
 extern GSList *rules;

src/settings.h

@@ -14,7 +14,6 @@
 #define LIST_END (-1)
 
 enum alignment { ALIGN_LEFT, ALIGN_CENTER, ALIGN_RIGHT };
-enum icon_position { ICON_LEFT, ICON_RIGHT, ICON_OFF };
 enum vertical_alignment { VERTICAL_TOP, VERTICAL_CENTER, VERTICAL_BOTTOM };
 enum separator_color { SEP_FOREGROUND, SEP_AUTO, SEP_FRAME, SEP_CUSTOM };
 enum follow_mode { FOLLOW_NONE, FOLLOW_MOUSE, FOLLOW_KEYBOARD };

src/settings_data.h

@@ -112,11 +112,13 @@ static const struct rule empty_rule = {
         .history_ignore  = -1,
         .match_transient = -1,
         .set_transient   = -1,
+        .icon_position   = -1,
         .set_icon_size   = -1,
         .skip_display    = -1,
         .word_wrap       = -1,
         .ellipsize       = -1,
         .alignment       = -1,
+        .hide_text       = -1,
         .new_icon        = NULL,
         .fg              = NULL,
         .bg              = NULL,
@@ -212,6 +214,7 @@ static const struct string_to_enum_def fullscreen_enum_data[] = {
 static const struct string_to_enum_def icon_position_enum_data[] = {
         {"left",  ICON_LEFT },
         {"right", ICON_RIGHT },
+        {"top",   ICON_TOP },
         {"off",   ICON_OFF },
         ENUM_END,
 };
@@ -608,6 +611,17 @@ static const struct setting allowed_settings[] = {
                 .parser_data = horizontal_alignment_enum_data,
                 .rule_offset = offsetof(struct rule, alignment),
         },
+        {
+                .name = "hide_text",
+                .section = "*",
+                .description = "Skip rendering summary and body text in notification window (keeps icon and progress bar)",
+                .type = TYPE_CUSTOM,
+                .default_value = "*",
+                .value = NULL,
+                .parser = string_parse_enum,
+                .parser_data = boolean_enum_data,
+                .rule_offset = offsetof(struct rule, hide_text),
+        },
         {
                 .name = "markup",
                 .section = "*",
@@ -619,6 +633,17 @@ static const struct setting allowed_settings[] = {
                 .parser_data = markup_mode_enum_data,
                 .rule_offset = offsetof(struct rule, markup),
         },
+        {
+                .name = "icon_position",
+                .section = "*",
+                .description = "Align icons left/right/top/off",
+                .type = TYPE_CUSTOM,
+                .default_value = "*",
+                .value = NULL,
+                .parser = string_parse_enum,
+                .parser_data = icon_position_enum_data,
+                .rule_offset = offsetof(struct rule, icon_position),
+        },
         {
                 .name = "icon_size",
                 .section = "*",
@@ -1049,7 +1074,7 @@ static const struct setting allowed_settings[] = {
         {
                 .name = "icon_position",
                 .section = "global",
-                .description = "Align icons left/right/off",
+                .description = "Default icon alignment (left/right/top/off)",
                 .type = TYPE_CUSTOM,
                 .default_value = "left",
                 .value = &settings.icon_position,