bbox implemtation in the internal abc and titles

Author: pratiman-91

proplot/axes/base.py

@@ -809,6 +809,11 @@ def format(
             positioned inside the axes. This can help them stand out on top
             of artists plotted inside the axes. Defaults are
             :rc:`abc.border` and :rc:`title.border`
+        abcbbox, titlebbox : bool, optional
+            Whether to draw a white bbox around titles and a-b-c labels
+            positioned inside the axes. This can help them stand out on top
+            of artists plotted inside the axes. Defaults are
+            :rc:`abc.bbox` and :rc:`title.bbox`
         abovetop : bool, optional
             Whether to try to put the title and a-b-c label above the top panel
             (if it exists), or to always put them above the main subplot.
@@ -921,6 +926,10 @@ def sanitize_kw(kw, loc):
             if loc in ('left', 'right', 'center'):
                 kw.pop('border', None)
                 kw.pop('borderwidth', None)
+                kw.pop('bbox', None)
+                kw.pop('bboxcolor', None)
+                kw.pop('bboxstyle', None)
+                kw.pop('bboxalpha', None)
             return kw
 
         # A-b-c labels
@@ -943,6 +952,10 @@ def sanitize_kw(kw, loc):
                 {
                     'border': 'abc.border',
                     'borderwidth': 'abc.borderwidth',
+                    'bbox': 'abc.bbox',
+                    'bboxcolor': 'abc.bboxcolor',
+                    'bboxstyle': 'abc.bboxstyle',
+                    'bboxalpha': 'abc.bboxalpha', 
                 },
                 context=True,
             )
@@ -1009,6 +1022,10 @@ def sanitize_kw(kw, loc):
             {
                 'border': 'title.border',
                 'borderwidth': 'title.borderwidth',
+                'bbox': 'title.bbox',
+                'bboxcolor': 'title.bboxcolor',
+                'bboxstyle': 'title.bboxstyle',
+                'bboxalpha': 'title.bboxalpha', 
             },
             context=True,
         )

proplot/axes/plot.py

@@ -2169,7 +2169,7 @@ def _get_transform(self, transform):
 
 def _update_text(self, props):
     """
-    Monkey patch that adds pseudo "border" properties to text objects
+    Monkey patch that adds pseudo "border" and "bbox" properties to text objects
     without wrapping the entire class. We override update to facilitate
     updating inset titles.
     """
@@ -2191,6 +2191,18 @@ def _update_text(self, props):
             'color': facecolor,
             'path_effects': [mpatheffects.Stroke(**kwargs), mpatheffects.Normal()],
         })
+
+    bbox = props.pop('bbox', None)
+    bboxcolor = props.pop('bboxcolor', 'w')
+    bboxstyle = props.pop('bboxstyle', 'round')
+    bboxalpha = props.pop('bboxalpha', 0.5)
+
+    if bbox:
+        self.set_bbox(dict(facecolor=bboxcolor,
+        edgecolor='black',
+        boxstyle=bboxstyle,
+        alpha=bboxalpha))
+
     return type(self).update(self, props)
 
 
@@ -2199,11 +2211,12 @@ def text_wrapper(
     x=0, y=0, text='', transform='data',
     family=None, fontfamily=None, fontname=None, fontsize=None, size=None,
     border=False, bordercolor='w', borderwidth=2, borderinvert=False,
+    bbox=False, bboxcolor='w', bboxstyle='round', bboxalpha=0.5,
     **kwargs
 ):
     """
     Enables specifying `tranform` with a string name and adds a feature for
-    drawing borders around text.
+    drawing borders and bbox around text.
 
     Note
     ----
@@ -2238,7 +2251,14 @@ def text_wrapper(
         The color of the text border. Default is ``'w'``.
     borderinvert : bool, optional
         If ``True``, the text and border colors are swapped.
-
+    bbox : bool, optional
+        Whether to draw bbox around text.
+    bboxcolor : color-spec, optional
+        The color of the text bbox. Default is ``'w'``.
+    bboxstyle : boxstyle, optional
+        The style of the bbox. Default is ``'round'``.
+    bboxalpha : float, optional
+        The alpha for the bbox. Default is ``'0.5'``.
     Other parameters
     ----------------
     **kwargs
@@ -2277,6 +2297,10 @@ def text_wrapper(
         'bordercolor': bordercolor,
         'borderinvert': borderinvert,
         'borderwidth': borderwidth,
+        'bbox' : bbox,
+        'bboxcolor': bboxcolor,
+        'bboxstyle' : bboxstyle,
+        'bboxalpha' : bboxalpha,
     })
     return obj
 

proplot/internals/rcsetup.py

@@ -265,6 +265,22 @@
         1.5,
         'Width of the white border around a-b-c labels.'
     ),
+    'abc.bbox': (
+        True,
+        'Boolean, whether to draw semi-transparent bbox around the a-b-c.'
+    ),
+    'abc.bboxcolor': (
+        'w',
+        'color-spec, the color of the a-b-c bbox.'
+    ),
+    'abc.bboxstyle': (
+        'round',
+        'boxstyle, the style of the a-b-c bbox.'
+    ),
+    'abc.bboxalpha': (
+        0.5,
+        'float, The alpha for the a-b-c bbox.'
+    ),
     'abc.color': (
         'black',
         'a-b-c label color.'
@@ -851,6 +867,23 @@
         1.5,
         'Width of the white border around titles.'
     ),
+    'title.bbox': (
+        True,
+        'Boolean, whether to draw semi-transparent bbox around the title.'
+        'when :rcraw:`title.loc` is inside the axes.'
+    ),
+    'title.bboxcolor': (
+        'w',
+        'color-spec, the color of the title bbox.'
+    ),
+    'title.bboxstyle': (
+        'round',
+        'boxstyle, the style of the title bbox.'
+    ),
+    'title.bboxalpha': (
+        0.5,
+        'float, The alpha for the title bbox.'
+    ),
     'title.color': (
         'black',
         'Axes title color.'