commit e9113670c5b27e5f5e9941e52c70e77e4b38336f · cduck.me/drawsvg

+19

README.md

···

       7
       7
        
       An interactive [Jupyter notebook](https://jupyter.org) widget, `drawSvg.widgets.DrawingWidget`, is included that can update drawings based on mouse events.

     

       8
       8
        
       

     

       9
       9
        
       # Install

     

       10
       10
       +
       

     

       10
       11
        
       drawSvg is available on PyPI:

     

       11
       12
        
       

     

       12
       13
        
       ```

     

       13
       14
        
       $ pip3 install drawSvg

     

       15
       15
       +
       ```

     

       16
       16
       +
       

     

       17
       17
       +
       ## Prerequisites

     

       18
       18
       +
       

     

       19
       19
       +
       Cairo needs to be installed separately. When Cairo is installed, drawSvg can output PNG or other image formats in addition to SVG. See platform-specific [instructions for Linux, Windows, and macOS from Cairo](https://www.cairographics.org/download/). Below are some examples for installing Cairo on Linux distributions and macOS.

     

       20
       20
       +
       

     

       21
       21
       +
       **Ubuntu**

     

       22
       22
       +
       

     

       23
       23
       +
       ```

     

       24
       24
       +
       $ sudo apt-get install libcairo2

     

       25
       25
       +
       ```

     

       26
       26
       +
       

     

       27
       27
       +
       **macOS**

     

       28
       28
       +
       

     

       29
       29
       +
       Using [homebrew](https://brew.sh/):

     

       30
       30
       +
       

     

       31
       31
       +
       ```

     

       32
       32
       +
       $ brew install cairo

     

       14
       33
        
       ```

     

       15
       34
        
       

     

       16
       35
        
       # Examples

+17 -4

drawSvg/raster.py

···

       1
       1
        
       

     

       2
       2
        
       import io

     

       3
       3
       +
       import warnings

     

       4
       4
       +
       from .missing import MissingModule

     

       5
       5
       +
       

     

       3
       6
        
       

     

       4
       7
        
       try:

     

       5
       8
        
           import cairosvg

     

       6
       6
       -
       except (ImportError, OSError):

     

       7
       7
       -
           import warnings

     

       8
       8
       -
           from .missing import MissingModule

     

       9
       9
       -
           msg = 'CairoSVG will need to be installed to rasterize images: Install with `pip3 install cairosvg`'

     

       9
       9
       +
       except OSError as e:

     

       10
       10
       +
           msg = (

     

       11
       11
       +
               'Failed to import CairoSVG. '

     

       12
       12
       +
               'drawSvg will be unable to output PNG or other raster image formats. '

     

       13
       13
       +
               'See https://github.com/cduck/drawSvg#prerequisites for more details.\n'

     

       14
       14
       +
               'Original OSError: {}'.format(e)

     

       15
       15
       +
           )

     

       16
       16
       +
           cairosvg = MissingModule(msg)

     

       17
       17
       +
           warnings.warn(msg, RuntimeWarning)

     

       18
       18
       +
       except ImportError as e:

     

       19
       19
       +
           msg = (

     

       20
       20
       +
               'CairoSVG will need to be installed to rasterize images: Install with `pip3 install cairosvg`\n'

     

       21
       21
       +
               'Original ImportError: {}'.format(e)

     

       22
       22
       +
           )

     

       10
       23
        
           cairosvg = MissingModule(msg)

     

       11
       24
        
           warnings.warn(msg, RuntimeWarning)

     

       12
       25