commit cf9abbd2021e47a1e1d95c124a90952242ad64e9 · cduck.me/drawsvg

+10 -6

README.md

···

       1
       -
       [![drawsvg logo](https://raw.githubusercontent.com/cduck/drawsvg/v2/examples/logo.svg)](https://github.com/cduck/drawSvg/blob/v2/examples/logo.ipynb)

     

       2
        
       

     

       3
        
       A Python 3 library for programmatically generating SVG images and animations that can render and display your drawings in a Jupyter notebook or Jupyter lab.

     

       4
        
       

     
···

       141
        
       d.display_inline()  # Display as interactive SVG

     

       142
        
       ```

     

       143
        
       

     

       144
       -
       [![Example animated image](https://raw.githubusercontent.com/cduck/drawsvg/master/examples/playback-controls.svg)](https://github.com/cduck/drawsvg/blob/master/examples/playback-controls.svg)

     

       145
        
       

     

       146
        
       Note: GitHub blocks the playback controls.

     

       147
        
       Download the above SVG and open it in a web browser to try.

     

       148
        
       

     

       149
       -
       ### Gradients

     

       150
        
       ```python

     

       151
        
       import drawsvg as draw

     

       152
        
       

     

       153
        
       d = draw.Drawing(1.5, 0.8, origin='center')

     

       154
        
       

     

       155
       -
       d.draw(draw.Rectangle(-0.75, -0.5, 1.5, 1, fill='#ddd'))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       156
        
       

     

       157
        
       # Create gradient

     

       158
        
       gradient = draw.RadialGradient(0, 0.35, 0.7*10)

     
···

       186
        
       d

     

       187
        
       ```

     

       188
        
       

     

       189
       -
       [![Example output image](https://raw.githubusercontent.com/cduck/drawsvg/master/examples/example2.png)](https://github.com/cduck/drawsvg/blob/master/examples/example2.svg)

     

       190
        
       

     

       191
       -
       ### Duplicate geometry, clip paths

     

       192
        
       ```python

     

       193
        
       import drawsvg as draw

     

       194

···

       1
       +
       [![drawsvg logo](https://raw.githubusercontent.com/cduck/drawsvg/v2/examples/logo.svg?sanitize=true)](https://github.com/cduck/drawSvg/blob/v2/examples/logo.ipynb)

     

       2
        
       

     

       3
        
       A Python 3 library for programmatically generating SVG images and animations that can render and display your drawings in a Jupyter notebook or Jupyter lab.

     

       4
        
       

     
···

       141
        
       d.display_inline()  # Display as interactive SVG

     

       142
        
       ```

     

       143
        
       

     

       144
       +
       [![Example animated image](https://raw.githubusercontent.com/cduck/drawsvg/master/examples/playback-controls.svg?sanitize=true)](https://github.com/cduck/drawsvg/blob/master/examples/playback-controls.svg)

     

       145
        
       

     

       146
        
       Note: GitHub blocks the playback controls.

     

       147
        
       Download the above SVG and open it in a web browser to try.

     

       148
        
       

     

       149
       +
       ### Patterns and gradients

     

       150
        
       ```python

     

       151
        
       import drawsvg as draw

     

       152
        
       

     

       153
        
       d = draw.Drawing(1.5, 0.8, origin='center')

     

       154
        
       

     

       155
       +
       # Background pattern (not supported by Cairo, rasterize will not show it)

     

       156
       +
       pattern = draw.Pattern(width=0.13, height=0.23)

     

       157
       +
       pattern.append(draw.Rectangle(0, 0, .1, .1, fill='yellow'))

     

       158
       +
       pattern.append(draw.Rectangle(0, .1, .1, .1, fill='orange'))

     

       159
       +
       d.draw(draw.Rectangle(-0.75, -0.5, 1.5, 1, fill=pattern, fill_opacity=0.4))

     

       160
        
       

     

       161
        
       # Create gradient

     

       162
        
       gradient = draw.RadialGradient(0, 0.35, 0.7*10)

     
···

       190
        
       d

     

       191
        
       ```

     

       192
        
       

     

       193
       +
       [![Example output image](https://raw.githubusercontent.com/cduck/drawsvg/master/examples/example2.svg?sanitize=true)](https://github.com/cduck/drawsvg/blob/master/examples/example2.svg)

     

       194
        
       

     

       195
       +
       ### Duplicate geometry and clip paths

     

       196
        
       ```python

     

       197
        
       import drawsvg as draw

     

       198

+15 -1

drawsvg/defs.py

···

       29
        
       

     

       30
        
       class RadialGradient(DrawingDef):

     

       31
        
           '''

     

       32
       -
           A radial gradient to use as a fill or other color

     

       33
        
       

     

       34
        
           Has <stop> nodes as children, added with `.add_stop()`.

     

       35
        
           '''

     
···

       48
        
           '''A control point for a radial or linear gradient.'''

     

       49
        
           TAG_NAME = 'stop'

     

       50
        
           has_content = False

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       51
        
       

     

       52
        
       class ClipPath(DrawingDef):

     

       53
        
           '''

···

       29
        
       

     

       30
        
       class RadialGradient(DrawingDef):

     

       31
        
           '''

     

       32
       +
           A radial gradient to use as a fill or other color.

     

       33
        
       

     

       34
        
           Has <stop> nodes as children, added with `.add_stop()`.

     

       35
        
           '''

     
···

       48
        
           '''A control point for a radial or linear gradient.'''

     

       49
        
           TAG_NAME = 'stop'

     

       50
        
           has_content = False

     

       51
       +
       

     

       52
       +
       class Pattern(DrawingDef):

     

       53
       +
           '''

     

       54
       +
           A repeating pattern of other drawing elements to use as a fill or other

     

       55
       +
           color.

     

       56
       +
       

     

       57
       +
           Width and height specify the repetition period.  Append regular drawing

     

       58
       +
           elements to create the pattern.

     

       59
       +
           '''

     

       60
       +
           TAG_NAME = 'pattern'

     

       61
       +
           def __init__(self, width, height, x=None, y=None,

     

       62
       +
                        patternUnits='userSpaceOnUse', **kwargs):

     

       63
       +
               super().__init__(width=width, height=height, x=x, y=y,

     

       64
       +
                                patternUnits=patternUnits, **kwargs)

     

       65
        
       

     

       66
        
       class ClipPath(DrawingDef):

     

       67
        
           '''

examples/example2.png

This is a binary file and will not be displayed.

+11 -7

examples/example2.svg

···

       1
        
       <?xml version="1.0" encoding="UTF-8"?>

     

       2
        
       <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"

     

       3
       -
            width="600" height="320.0" viewBox="-0.75 -0.4 1.5 0.8">

     

       4
        
       <defs>

     

       5
       -
       <radialGradient cx="0" cy="0.35" r="7.0" gradientUnits="userSpaceOnUse" id="d0">

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       6
        
       <stop offset="0.07142857142857142" stop-color="green" stop-opacity="1" />

     

       7
        
       <stop offset="0.1" stop-color="red" stop-opacity="0" />

     

       8
        
       </radialGradient>

     

       9
       -
       <linearGradient x1="0.1" y1="0.35" x2="0.7" y2="0.14999999999999997" gradientUnits="userSpaceOnUse" id="d1">

     

       10
        
       <stop offset="0" stop-color="green" stop-opacity="1" />

     

       11
        
       <stop offset="1" stop-color="red" stop-opacity="0" />

     

       12
        
       </linearGradient>

     

       13
        
       </defs>

     

       14
       -
       <rect x="-0.75" y="-0.5" width="1.5" height="1" fill="#ddd" />

     

       15
       -
       <path d="M0.6062177826491071,5.551115123125783e-17 A0.7,0.7,0,0,0,-0.3499999999999998,-0.2562177826491071 L-0.2499999999999999,-0.08301270189221943 A0.5,0.5,0,0,1,0.43301270189221935,0.1 Z" fill="url(#d0)" stroke="black" stroke-width="0.002" />

     

       16
       -
       <path d="M-0.48209070726490444,-0.22453333233923367 A0.75,0.75,0,0,0,-0.7047694655894312,0.09348489250574832 L0.0,0.35 A0,0,0,0,1,0.0,0.35 Z" fill="url(#d0)" stroke="red" stroke-width="0.002" />

     

       17
       -
       <rect x="0.1" y="0.14999999999999997" width="0.6" height="0.2" stroke="black" stroke-width="0.002" fill="url(#d1)" />

     

       18
        
       </svg>

···

       1
        
       <?xml version="1.0" encoding="UTF-8"?>

     

       2
        
       <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"

     

       3
       +
           width="600" height="320.0" viewBox="-0.75 -0.4 1.5 0.8">

     

       4
        
       <defs>

     

       5
       +
       <pattern width="0.13" height="0.23" patternUnits="userSpaceOnUse" id="d0">

     

       6
       +
       <rect x="0" y="0" width="0.1" height="0.1" fill="yellow" />

     

       7
       +
       <rect x="0" y="0.1" width="0.1" height="0.1" fill="orange" />

     

       8
       +
       </pattern>

     

       9
       +
       <radialGradient cx="0" cy="0.35" r="7.0" gradientUnits="userSpaceOnUse" id="d1">

     

       10
        
       <stop offset="0.07142857142857142" stop-color="green" stop-opacity="1" />

     

       11
        
       <stop offset="0.1" stop-color="red" stop-opacity="0" />

     

       12
        
       </radialGradient>

     

       13
       +
       <linearGradient x1="0.1" y1="0.35" x2="0.7" y2="0.55" gradientUnits="userSpaceOnUse" id="d2">

     

       14
        
       <stop offset="0" stop-color="green" stop-opacity="1" />

     

       15
        
       <stop offset="1" stop-color="red" stop-opacity="0" />

     

       16
        
       </linearGradient>

     

       17
        
       </defs>

     

       18
       +
       <rect x="-0.75" y="-0.5" width="1.5" height="1" fill="url(#d0)" fill-opacity="0.4" />

     

       19
       +
       <path d="M0.6062177826491071,5.551115123125783e-17 A0.7,0.7,0,0,0,-0.3499999999999998,-0.2562177826491071 L-0.2499999999999999,-0.08301270189221943 A0.5,0.5,0,0,1,0.43301270189221935,0.1 Z" fill="url(#d1)" stroke="black" stroke-width="0.002" />

     

       20
       +
       <path d="M-0.48209070726490444,-0.22453333233923367 A0.75,0.75,0,0,0,-0.7047694655894312,0.09348489250574832 L0.0,0.35 A0,0,0,0,1,0.0,0.35 Z" fill="url(#d1)" stroke="red" stroke-width="0.002" />

     

       21
       +
       <rect x="0.1" y="0.15" width="0.6" height="0.2" stroke="black" stroke-width="0.002" fill="url(#d2)" />

     

       22
        
       </svg>