/* GTK - The GIMP Toolkit * Copyright (C) 2012 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see . */ #include "config.h" #include "gtkcolorswatchprivate.h" #include "gtkcolorchooserprivate.h" #include "gtkdnd.h" #include "gtkicontheme.h" #include "gtkmain.h" #include "gtkmenu.h" #include "gtkmenuitem.h" #include "gtkmenushell.h" #include "gtkprivate.h" #include "gtkintl.h" #include "gtkrenderprivate.h" #include "gtkiconhelperprivate.h" #include "gtkcssnodeprivate.h" #include "gtkcsscustomgadgetprivate.h" #include "gtkwidgetprivate.h" #include "gtkstylecontextprivate.h" #include "a11y/gtkcolorswatchaccessibleprivate.h" /* * GtkColorSwatch has two CSS nodes, the main one named colorswatch * and a subnode named overlay. The main node gets the .light or .dark * style classes added depending on the brightness of the color that * the swatch is showing. * * The color swatch has the .activatable style class by default. It can * be removed for non-activatable swatches. */ struct _GtkColorSwatchPrivate { GdkRGBA color; gdouble radius[4]; gchar *icon; guint has_color : 1; guint use_alpha : 1; guint selectable : 1; guint has_menu : 1; GdkWindow *event_window; GtkGesture *long_press_gesture; GtkGesture *multipress_gesture; GtkCssGadget *gadget; GtkCssGadget *overlay_gadget; GtkWidget *popover; }; enum { PROP_ZERO, PROP_RGBA, PROP_SELECTABLE, PROP_HAS_MENU }; enum { ACTIVATE, CUSTOMIZE, LAST_SIGNAL }; static guint signals[LAST_SIGNAL]; G_DEFINE_TYPE_WITH_PRIVATE (GtkColorSwatch, gtk_color_swatch, GTK_TYPE_WIDGET) static gboolean swatch_draw (GtkWidget *widget, cairo_t *cr) { gtk_css_gadget_draw (GTK_COLOR_SWATCH (widget)->priv->gadget, cr); return FALSE; } #define INTENSITY(r, g, b) ((r) * 0.30 + (g) * 0.59 + (b) * 0.11) static gboolean gtk_color_swatch_render (GtkCssGadget *gadget, cairo_t *cr, int x, int y, int width, int height, gpointer data) { GtkWidget *widget; GtkColorSwatch *swatch; GtkStyleContext *context; widget = gtk_css_gadget_get_owner (gadget); swatch = GTK_COLOR_SWATCH (widget); context = gtk_widget_get_style_context (widget); if (swatch->priv->has_color) { cairo_pattern_t *pattern; cairo_matrix_t matrix; GtkAllocation allocation, border_allocation; gtk_widget_get_allocation (widget, &allocation); gtk_css_gadget_get_border_allocation (gadget, &border_allocation, NULL); border_allocation.x -= allocation.x; border_allocation.y -= allocation.y; gtk_render_content_path (context, cr, border_allocation.x, border_allocation.y, border_allocation.width, border_allocation.height); if (swatch->priv->use_alpha) { cairo_save (cr); cairo_clip_preserve (cr); cairo_set_source_rgb (cr, 0.33, 0.33, 0.33); cairo_fill_preserve (cr); pattern = _gtk_color_chooser_get_checkered_pattern (); cairo_matrix_init_scale (&matrix, 0.125, 0.125); cairo_pattern_set_matrix (pattern, &matrix); cairo_set_source_rgb (cr, 0.66, 0.66, 0.66); cairo_mask (cr, pattern); cairo_pattern_destroy (pattern); cairo_restore (cr); gdk_cairo_set_source_rgba (cr, &swatch->priv->color); } else { cairo_set_source_rgb (cr, swatch->priv->color.red, swatch->priv->color.green, swatch->priv->color.blue); } cairo_fill (cr); } gtk_css_gadget_draw (swatch->priv->overlay_gadget, cr); return gtk_widget_has_visible_focus (widget); } static void drag_set_color_icon (GdkDragContext *context, const GdkRGBA *color) { cairo_surface_t *surface; cairo_t *cr; surface = cairo_image_surface_create (CAIRO_FORMAT_RGB24, 48, 32); cr = cairo_create (surface); gdk_cairo_set_source_rgba (cr, color); cairo_paint (cr); cairo_surface_set_device_offset (surface, -4, -4); gtk_drag_set_icon_surface (context, surface); cairo_destroy (cr); cairo_surface_destroy (surface); } static void swatch_drag_begin (GtkWidget *widget, GdkDragContext *context) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); GdkRGBA color; gtk_color_swatch_get_rgba (swatch, &color); drag_set_color_icon (context, &color); } static void swatch_drag_data_get (GtkWidget *widget, GdkDragContext *context, GtkSelectionData *selection_data, guint info, guint time) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); guint16 vals[4]; GdkRGBA color; gtk_color_swatch_get_rgba (swatch, &color); vals[0] = color.red * 0xffff; vals[1] = color.green * 0xffff; vals[2] = color.blue * 0xffff; vals[3] = color.alpha * 0xffff; gtk_selection_data_set (selection_data, gdk_atom_intern_static_string ("application/x-color"), 16, (guchar *)vals, 8); } static void swatch_drag_data_received (GtkWidget *widget, GdkDragContext *context, gint x, gint y, GtkSelectionData *selection_data, guint info, guint time) { gint length; guint16 *vals; GdkRGBA color; length = gtk_selection_data_get_length (selection_data); if (length < 0) return; /* We accept drops with the wrong format, since the KDE color * chooser incorrectly drops application/x-color with format 8. */ if (length != 8) { g_warning ("Received invalid color data"); return; } vals = (guint16 *) gtk_selection_data_get_data (selection_data); color.red = (gdouble)vals[0] / 0xffff; color.green = (gdouble)vals[1] / 0xffff; color.blue = (gdouble)vals[2] / 0xffff; color.alpha = (gdouble)vals[3] / 0xffff; gtk_color_swatch_set_rgba (GTK_COLOR_SWATCH (widget), &color); } static void gtk_color_swatch_measure (GtkCssGadget *gadget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline, gpointer unused) { GtkWidget *widget; GtkColorSwatch *swatch; gint w, h, min; widget = gtk_css_gadget_get_owner (gadget); swatch = GTK_COLOR_SWATCH (widget); gtk_css_gadget_get_preferred_size (swatch->priv->overlay_gadget, orientation, -1, minimum, natural, NULL, NULL); gtk_widget_get_size_request (widget, &w, &h); if (orientation == GTK_ORIENTATION_HORIZONTAL) min = w < 0 ? 48 : w; else min = h < 0 ? 32 : h; *minimum = MAX (*minimum, min); *natural = MAX (*natural, min); } static gboolean swatch_key_press (GtkWidget *widget, GdkEventKey *event) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); if (event->keyval == GDK_KEY_space || event->keyval == GDK_KEY_Return || event->keyval == GDK_KEY_ISO_Enter|| event->keyval == GDK_KEY_KP_Enter || event->keyval == GDK_KEY_KP_Space) { if (swatch->priv->has_color && swatch->priv->selectable && (gtk_widget_get_state_flags (widget) & GTK_STATE_FLAG_SELECTED) == 0) gtk_widget_set_state_flags (widget, GTK_STATE_FLAG_SELECTED, FALSE); else g_signal_emit (swatch, signals[ACTIVATE], 0); return TRUE; } if (GTK_WIDGET_CLASS (gtk_color_swatch_parent_class)->key_press_event (widget, event)) return TRUE; return FALSE; } static gboolean swatch_enter_notify (GtkWidget *widget, GdkEventCrossing *event) { gtk_widget_set_state_flags (widget, GTK_STATE_FLAG_PRELIGHT, FALSE); return FALSE; } static gboolean swatch_leave_notify (GtkWidget *widget, GdkEventCrossing *event) { gtk_widget_unset_state_flags (widget, GTK_STATE_FLAG_PRELIGHT); return FALSE; } static void emit_customize (GtkColorSwatch *swatch) { g_signal_emit (swatch, signals[CUSTOMIZE], 0); } static void do_popup (GtkColorSwatch *swatch) { if (swatch->priv->popover == NULL) { GtkWidget *box; GtkWidget *item; swatch->priv->popover = gtk_popover_new (GTK_WIDGET (swatch)); box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0); gtk_container_add (GTK_CONTAINER (swatch->priv->popover), box); g_object_set (box, "margin", 10, NULL); item = g_object_new (GTK_TYPE_MODEL_BUTTON, "text", _("C_ustomize"), NULL); g_signal_connect_swapped (item, "clicked", G_CALLBACK (emit_customize), swatch); gtk_container_add (GTK_CONTAINER (box), item); gtk_widget_show_all (box); } gtk_popover_popup (GTK_POPOVER (swatch->priv->popover)); } static gboolean swatch_primary_action (GtkColorSwatch *swatch) { GtkWidget *widget = (GtkWidget *)swatch; GtkStateFlags flags; flags = gtk_widget_get_state_flags (widget); if (!swatch->priv->has_color) { g_signal_emit (swatch, signals[ACTIVATE], 0); return TRUE; } else if (swatch->priv->selectable && (flags & GTK_STATE_FLAG_SELECTED) == 0) { gtk_widget_set_state_flags (widget, GTK_STATE_FLAG_SELECTED, FALSE); return TRUE; } return FALSE; } static void hold_action (GtkGestureLongPress *gesture, gdouble x, gdouble y, GtkColorSwatch *swatch) { do_popup (swatch); gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_CLAIMED); } static void tap_action (GtkGestureMultiPress *gesture, gint n_press, gdouble x, gdouble y, GtkColorSwatch *swatch) { guint button; button = gtk_gesture_single_get_current_button (GTK_GESTURE_SINGLE (gesture)); if (button == GDK_BUTTON_PRIMARY) { if (n_press == 1) swatch_primary_action (swatch); else if (n_press > 1) g_signal_emit (swatch, signals[ACTIVATE], 0); } else if (button == GDK_BUTTON_SECONDARY) { if (swatch->priv->has_color && swatch->priv->has_menu) do_popup (swatch); } } static void swatch_map (GtkWidget *widget) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); GTK_WIDGET_CLASS (gtk_color_swatch_parent_class)->map (widget); if (swatch->priv->event_window) gdk_window_show (swatch->priv->event_window); } static void swatch_unmap (GtkWidget *widget) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); if (swatch->priv->event_window) gdk_window_hide (swatch->priv->event_window); GTK_WIDGET_CLASS (gtk_color_swatch_parent_class)->unmap (widget); } static void swatch_realize (GtkWidget *widget) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); GtkAllocation allocation; GTK_WIDGET_CLASS (gtk_color_swatch_parent_class)->realize (widget); gtk_widget_get_allocation (widget, &allocation); swatch->priv->event_window = gdk_window_new_input (gtk_widget_get_window (widget), gtk_widget_get_events (widget) | GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK | GDK_ENTER_NOTIFY_MASK | GDK_LEAVE_NOTIFY_MASK | GDK_TOUCH_MASK, &allocation); gtk_widget_register_window (widget, swatch->priv->event_window); } static void swatch_unrealize (GtkWidget *widget) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); if (swatch->priv->event_window) { gtk_widget_unregister_window (widget, swatch->priv->event_window); gdk_window_destroy (swatch->priv->event_window); swatch->priv->event_window = NULL; } GTK_WIDGET_CLASS (gtk_color_swatch_parent_class)->unrealize (widget); } static void swatch_size_allocate (GtkWidget *widget, GtkAllocation *allocation) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); GtkAllocation clip, clip2; gtk_widget_set_allocation (widget, allocation); gtk_css_gadget_allocate (swatch->priv->gadget, allocation, gtk_widget_get_allocated_baseline (widget), &clip); gtk_css_gadget_allocate (swatch->priv->overlay_gadget, allocation, gtk_widget_get_allocated_baseline (widget), &clip2); gdk_rectangle_union (&clip, &clip2, &clip); gtk_widget_set_clip (widget, &clip); if (gtk_widget_get_realized (widget)) { GtkAllocation border_allocation; gtk_css_gadget_get_border_allocation(swatch->priv->gadget, &border_allocation, NULL); gdk_window_move_resize (swatch->priv->event_window, border_allocation.x, border_allocation.y, border_allocation.width, border_allocation.height); } } static void gtk_color_swatch_measure_ (GtkWidget *widget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline) { gtk_css_gadget_get_preferred_size (GTK_COLOR_SWATCH (widget)->priv->gadget, orientation, for_size, minimum, natural, minimum_baseline, natural_baseline); } static gboolean swatch_popup_menu (GtkWidget *widget) { do_popup (GTK_COLOR_SWATCH (widget)); return TRUE; } static void update_icon (GtkColorSwatch *swatch) { GtkIconHelper *icon_helper = GTK_ICON_HELPER (swatch->priv->overlay_gadget); if (swatch->priv->icon) _gtk_icon_helper_set_icon_name (icon_helper, swatch->priv->icon, GTK_ICON_SIZE_BUTTON); else if (gtk_widget_get_state_flags (GTK_WIDGET (swatch)) & GTK_STATE_FLAG_SELECTED) _gtk_icon_helper_set_icon_name (icon_helper, "object-select-symbolic", GTK_ICON_SIZE_BUTTON); else _gtk_icon_helper_clear (icon_helper); } static void swatch_state_flags_changed (GtkWidget *widget, GtkStateFlags previous_state) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (widget); gtk_css_gadget_set_state (swatch->priv->gadget, gtk_widget_get_state_flags (widget)); gtk_css_gadget_set_state (swatch->priv->overlay_gadget, gtk_widget_get_state_flags (widget)); update_icon (swatch); GTK_WIDGET_CLASS (gtk_color_swatch_parent_class)->state_flags_changed (widget, previous_state); } /* GObject implementation {{{1 */ static void swatch_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (object); GdkRGBA color; switch (prop_id) { case PROP_RGBA: gtk_color_swatch_get_rgba (swatch, &color); g_value_set_boxed (value, &color); break; case PROP_SELECTABLE: g_value_set_boolean (value, gtk_color_swatch_get_selectable (swatch)); break; case PROP_HAS_MENU: g_value_set_boolean (value, swatch->priv->has_menu); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void swatch_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (object); switch (prop_id) { case PROP_RGBA: gtk_color_swatch_set_rgba (swatch, g_value_get_boxed (value)); break; case PROP_SELECTABLE: gtk_color_swatch_set_selectable (swatch, g_value_get_boolean (value)); break; case PROP_HAS_MENU: swatch->priv->has_menu = g_value_get_boolean (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void swatch_finalize (GObject *object) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (object); g_free (swatch->priv->icon); g_clear_object (&swatch->priv->gadget); g_clear_object (&swatch->priv->overlay_gadget); G_OBJECT_CLASS (gtk_color_swatch_parent_class)->finalize (object); } static void swatch_dispose (GObject *object) { GtkColorSwatch *swatch = GTK_COLOR_SWATCH (object); if (swatch->priv->popover) { gtk_widget_destroy (swatch->priv->popover); swatch->priv->popover = NULL; } g_clear_object (&swatch->priv->long_press_gesture); g_clear_object (&swatch->priv->multipress_gesture); G_OBJECT_CLASS (gtk_color_swatch_parent_class)->dispose (object); } static void gtk_color_swatch_class_init (GtkColorSwatchClass *class) { GtkWidgetClass *widget_class = (GtkWidgetClass *)class; GObjectClass *object_class = (GObjectClass *)class; object_class->get_property = swatch_get_property; object_class->set_property = swatch_set_property; object_class->finalize = swatch_finalize; object_class->dispose = swatch_dispose; widget_class->measure = gtk_color_swatch_measure_; widget_class->draw = swatch_draw; widget_class->drag_begin = swatch_drag_begin; widget_class->drag_data_get = swatch_drag_data_get; widget_class->drag_data_received = swatch_drag_data_received; widget_class->key_press_event = swatch_key_press; widget_class->popup_menu = swatch_popup_menu; widget_class->enter_notify_event = swatch_enter_notify; widget_class->leave_notify_event = swatch_leave_notify; widget_class->realize = swatch_realize; widget_class->unrealize = swatch_unrealize; widget_class->map = swatch_map; widget_class->unmap = swatch_unmap; widget_class->size_allocate = swatch_size_allocate; widget_class->state_flags_changed = swatch_state_flags_changed; signals[ACTIVATE] = g_signal_new (I_("activate"), GTK_TYPE_COLOR_SWATCH, G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkColorSwatchClass, activate), NULL, NULL, NULL, G_TYPE_NONE, 0); signals[CUSTOMIZE] = g_signal_new (I_("customize"), GTK_TYPE_COLOR_SWATCH, G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkColorSwatchClass, customize), NULL, NULL, NULL, G_TYPE_NONE, 0); g_object_class_install_property (object_class, PROP_RGBA, g_param_spec_boxed ("rgba", P_("RGBA Color"), P_("Color as RGBA"), GDK_TYPE_RGBA, GTK_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_SELECTABLE, g_param_spec_boolean ("selectable", P_("Selectable"), P_("Whether the swatch is selectable"), TRUE, GTK_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_HAS_MENU, g_param_spec_boolean ("has-menu", P_("Has Menu"), P_("Whether the swatch should offer customization"), TRUE, GTK_PARAM_READWRITE)); gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_COLOR_SWATCH_ACCESSIBLE); gtk_widget_class_set_css_name (widget_class, "colorswatch"); } static void gtk_color_swatch_init (GtkColorSwatch *swatch) { GtkCssNode *widget_node; swatch->priv = gtk_color_swatch_get_instance_private (swatch); swatch->priv->use_alpha = TRUE; swatch->priv->selectable = TRUE; swatch->priv->has_menu = TRUE; gtk_widget_set_can_focus (GTK_WIDGET (swatch), TRUE); gtk_widget_set_has_window (GTK_WIDGET (swatch), FALSE); swatch->priv->long_press_gesture = gtk_gesture_long_press_new (GTK_WIDGET (swatch)); gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (swatch->priv->long_press_gesture), TRUE); g_signal_connect (swatch->priv->long_press_gesture, "pressed", G_CALLBACK (hold_action), swatch); swatch->priv->multipress_gesture = gtk_gesture_multi_press_new (GTK_WIDGET (swatch)); gtk_gesture_single_set_button (GTK_GESTURE_SINGLE (swatch->priv->multipress_gesture), 0); g_signal_connect (swatch->priv->multipress_gesture, "pressed", G_CALLBACK (tap_action), swatch); widget_node = gtk_widget_get_css_node (GTK_WIDGET (swatch)); swatch->priv->gadget = gtk_css_custom_gadget_new_for_node (widget_node, GTK_WIDGET (swatch), gtk_color_swatch_measure, NULL, gtk_color_swatch_render, NULL, NULL); gtk_css_gadget_add_class (swatch->priv->gadget, "activatable"); swatch->priv->overlay_gadget = gtk_icon_helper_new_named ("overlay", GTK_WIDGET (swatch)); _gtk_icon_helper_set_force_scale_pixbuf (GTK_ICON_HELPER (swatch->priv->overlay_gadget), TRUE); gtk_css_node_set_parent (gtk_css_gadget_get_node (swatch->priv->overlay_gadget), widget_node); } /* Public API {{{1 */ GtkWidget * gtk_color_swatch_new (void) { return (GtkWidget *) g_object_new (GTK_TYPE_COLOR_SWATCH, NULL); } static const GtkTargetEntry dnd_targets[] = { { (char *) "application/x-color", 0 } }; void gtk_color_swatch_set_rgba (GtkColorSwatch *swatch, const GdkRGBA *color) { GtkStyleContext *context; context = gtk_widget_get_style_context (GTK_WIDGET (swatch)); if (!swatch->priv->has_color) { gtk_drag_source_set (GTK_WIDGET (swatch), GDK_BUTTON1_MASK | GDK_BUTTON3_MASK, dnd_targets, G_N_ELEMENTS (dnd_targets), GDK_ACTION_COPY | GDK_ACTION_MOVE); } swatch->priv->has_color = TRUE; swatch->priv->color = *color; if (INTENSITY (swatch->priv->color.red, swatch->priv->color.green, swatch->priv->color.blue) > 0.5) { gtk_style_context_add_class (context, "light"); gtk_style_context_remove_class (context, "dark"); } else { gtk_style_context_add_class (context, "dark"); gtk_style_context_remove_class (context, "light"); } gtk_widget_queue_draw (GTK_WIDGET (swatch)); g_object_notify (G_OBJECT (swatch), "rgba"); } gboolean gtk_color_swatch_get_rgba (GtkColorSwatch *swatch, GdkRGBA *color) { if (swatch->priv->has_color) { color->red = swatch->priv->color.red; color->green = swatch->priv->color.green; color->blue = swatch->priv->color.blue; color->alpha = swatch->priv->color.alpha; return TRUE; } else { color->red = 1.0; color->green = 1.0; color->blue = 1.0; color->alpha = 1.0; return FALSE; } } void gtk_color_swatch_set_icon (GtkColorSwatch *swatch, const gchar *icon) { swatch->priv->icon = g_strdup (icon); update_icon (swatch); gtk_widget_queue_draw (GTK_WIDGET (swatch)); } void gtk_color_swatch_set_can_drop (GtkColorSwatch *swatch, gboolean can_drop) { if (can_drop) { gtk_drag_dest_set (GTK_WIDGET (swatch), GTK_DEST_DEFAULT_HIGHLIGHT | GTK_DEST_DEFAULT_MOTION | GTK_DEST_DEFAULT_DROP, dnd_targets, G_N_ELEMENTS (dnd_targets), GDK_ACTION_COPY); } else { gtk_drag_dest_unset (GTK_WIDGET (swatch)); } } void gtk_color_swatch_set_use_alpha (GtkColorSwatch *swatch, gboolean use_alpha) { swatch->priv->use_alpha = use_alpha; gtk_widget_queue_draw (GTK_WIDGET (swatch)); } void gtk_color_swatch_set_selectable (GtkColorSwatch *swatch, gboolean selectable) { if (selectable == swatch->priv->selectable) return; swatch->priv->selectable = selectable; g_object_notify (G_OBJECT (swatch), "selectable"); } gboolean gtk_color_swatch_get_selectable (GtkColorSwatch *swatch) { return swatch->priv->selectable; } /* vim:set foldmethod=marker: */