add README.md

roundabout,
created on Saturday, 22 November 2025, 19:24:14 (1763839454), received on Saturday, 22 November 2025, 19:24:16 (1763839456)
Author identity: vlad <vlad.muntoiu@gmail.com>

                                
                                
                                
                            
                                
                                    
                                        1 +
                                        # Material shading for Inkscape
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        2 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        3 +
                                        This is an Inkscape extension that applies, to any path or path-convertible
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        4 +
                                        element, a highlighted top edge and a shaded bottom edge (of 1px each),
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        5 +
                                        conforming to the Material icon style.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        6 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        7 +
                                        To use it, select the path(s) you want to apply it to and engage the extension
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        8 +
                                        from the menu. It doesn't have configuration because it would end up having a
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        9 +
                                        very cumbersome format and lots of special cases, and it should also be fast to
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        10 +
                                        use for making icon themes.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        11 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        12 +
                                        Sadly it has to call another Inkscape to do the set operations, so it is slow.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        13 +
                                        However, if you do multiple paths at once, the time doesn't multiply. In any
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        14 +
                                        case it saves a lot of time when doing icon themes in the material style,
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        15 +
                                        probably reducing it by more than half, given that, otherwise, for each surface
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        16 +
                                        you'd need to duplicate it two times, shift a duplicate above, precisely set the
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        17 +
                                        colour of the unmoved duplicate, invoke the set operation and repeat this for
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        18 +
                                        the other edge as well.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        19 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        20 +
                                        ## Example
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        21 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        22 +
                                        ![example](https://roundabout-host.com/roundabout/material-shading-inkscape/example.svg)
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                            
                                

                                
                                
                                
                            
                                
                                    
                                        1 +
                                        <?xml version="1.0" encoding="UTF-8" standalone="no"?>
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        2 +
                                        <!-- Created with Inkscape (http://www.inkscape.org/) -->
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        3 +
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        4 +
                                        <svg
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        5 +
                                           width="48"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        6 +
                                           height="48"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        7 +
                                           viewBox="0 0 12.7 12.7"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        8 +
                                           version="1.1"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        9 +
                                           id="svg1"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        10 +
                                           sodipodi:docname="example.svg"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        11 +
                                           inkscape:version="1.4.2 (ebf0e940d0, 2025-05-08)"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        12 +
                                           xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        13 +
                                           xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        14 +
                                           xmlns="http://www.w3.org/2000/svg"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        15 +
                                           xmlns:svg="http://www.w3.org/2000/svg">
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        16 +
                                          <sodipodi:namedview
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        17 +
                                             id="namedview1"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        18 +
                                             pagecolor="#ffffff"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        19 +
                                             bordercolor="#000000"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        20 +
                                             borderopacity="0.25"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        21 +
                                             inkscape:showpageshadow="2"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        22 +
                                             inkscape:pageopacity="0.0"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        23 +
                                             inkscape:pagecheckerboard="0"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        24 +
                                             inkscape:deskcolor="#d1d1d1"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        25 +
                                             inkscape:document-units="px"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        26 +
                                             inkscape:zoom="17.567437"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        27 +
                                             inkscape:cx="15.312421"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        28 +
                                             inkscape:cy="21.374774"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        29 +
                                             inkscape:current-layer="svg1"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        30 +
                                             showguides="true" />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        31 +
                                          <defs
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        32 +
                                             id="defs1" />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        33 +
                                          <g
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        34 +
                                             inkscape:label="Strat 1"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        35 +
                                             inkscape:groupmode="layer"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        36 +
                                             id="layer1" />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        37 +
                                          <circle
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        38 +
                                             style="fill:#f06292;fill-opacity:1;stroke-width:1.00012;stroke-linecap:square"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        39 +
                                             id="path23"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        40 +
                                             cx="4.2333331"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        41 +
                                             cy="3.7041667"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        42 +
                                             r="2.6458333" />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        43 +
                                          <path
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        44 +
                                             id="circle8415"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        45 +
                                             style="fill:#ffffff;fill-opacity:0.2;stroke-width:1.00012;stroke-linecap:square"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        46 +
                                             d="M 4.2333333 1.0583333 A 2.6458333 2.6458333 0 0 0 1.5875 3.7041667 A 2.6458333 2.6458333 0 0 0 1.596285 3.8364583 A 2.6458333 2.6458333 0 0 1 4.2333333 1.3229167 A 2.6458333 2.6458333 0 0 1 6.8703817 3.8364583 A 2.6458333 2.6458333 0 0 0 6.8791667 3.7041667 A 2.6458333 2.6458333 0 0 0 4.2333333 1.0583333 z " />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        47 +
                                          <path
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        48 +
                                             id="circle8743"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        49 +
                                             style="fill:#3E2723;fill-opacity:0.2;stroke-width:1.00012;stroke-linecap:square"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        50 +
                                             d="M 1.596285 3.571875 A 2.6458333 2.6458333 0 0 0 1.5875 3.7041667 A 2.6458333 2.6458333 0 0 0 4.2333333 6.35 A 2.6458333 2.6458333 0 0 0 6.8791667 3.7041667 A 2.6458333 2.6458333 0 0 0 6.8703817 3.571875 A 2.6458333 2.6458333 0 0 1 4.2333333 6.0854167 A 2.6458333 2.6458333 0 0 1 1.596285 3.571875 z " />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        51 +
                                          <rect
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        52 +
                                             style="fill:#8bc34a;fill-opacity:1;stroke-width:1.00013;stroke-linecap:square"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        53 +
                                             id="rect23"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        54 +
                                             width="6.3499999"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        55 +
                                             height="4.2333336"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        56 +
                                             x="4.2333336"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        57 +
                                             y="4.4979167" />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        58 +
                                          <path
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        59 +
                                             id="rect1404"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        60 +
                                             style="fill:#ffffff;fill-opacity:0.2;stroke-width:1.00013;stroke-linecap:square"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        61 +
                                             d="M 4.2333333 4.4979167 L 4.2333333 4.7625 L 10.583333 4.7625 L 10.583333 4.4979167 L 4.2333333 4.4979167 z " />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        62 +
                                          <path
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        63 +
                                             id="rect7019"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        64 +
                                             style="fill:#263238;fill-opacity:0.2;stroke-width:1.00013;stroke-linecap:square"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        65 +
                                             d="M 4.2333333 8.4666667 L 4.2333333 8.73125 L 10.583333 8.73125 L 10.583333 8.4666667 L 4.2333333 8.4666667 z " />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        66 +
                                          <path
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        67 +
                                             id="rect24"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        68 +
                                             style="fill:#0097a7;stroke-width:1.00013;stroke-linecap:square"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        69 +
                                             d="M 2.1166668,7.1437502 8.4666667,11.377084 H 2.1166668 Z"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        70 +
                                             sodipodi:nodetypes="cccc" />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        71 +
                                          <path
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        72 +
                                             id="path1579"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        73 +
                                             style="fill:#ffffff;stroke-width:1.00013;stroke-linecap:square;fill-opacity:0.2"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        74 +
                                             d="M 2.1166667 7.14375 L 2.1166667 7.4083333 L 8.0697917 11.377083 L 8.4666667 11.377083 L 2.1166667 7.14375 z " />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        75 +
                                          <path
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        76 +
                                             id="path1827"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        77 +
                                             style="fill:#263238;stroke-width:1.00013;stroke-linecap:square;fill-opacity:0.2"
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        78 +
                                             d="M 2.1166667 11.1125 L 2.1166667 11.377083 L 8.4666667 11.377083 L 8.0697917 11.1125 L 2.1166667 11.1125 z " />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        79 +
                                        </svg>