A new version is available:

• The launch time is now at lightning speed!

• Added a new keyword argument center for the rotate(), scale(), and skew() functions.

The optional center argument will make the transformation be centered around the given point:

rotate(20, center=(500, 500)) # rotate around (500, 500)
rect(250, 250, 500, 500)

Just for reference: the extra argument does the same as this example but is a lot more convenient:

# define a center point
centerX, centerY = 500, 500
# translate to that center point
translate(centerX, centerY)
# do the transformation
rotate(20)
# translate back 
translate(-centerX, -centerY)
# draw something
rect(250, 250, 500, 500)

Download and Play!!!

that is possible you can use:

from drawBot.context.tools.gifTools import generateGif

generateGif(gifPaths, destinationPath, frameRates)
# gifPaths: a list of paths to gif files
# destinationPath: a path where to save the animated gif
# frameRates: a list with the same length as the gifPaths of ints in 1/100sec

see https://github.com/typemytype/drawbot/blob/master/drawBot/context/tools/gifTools.py#L11

hope this works!

• Adding bezierPath.expandStroke(width, lineCap="round", lineJoin="round", miterLimit=10) (thanks to Bahman Eslami)

• Improved internal OpenType feature tags setting

• Improved complex formattedString type setting

• Improved alignment with text() and FormattedString

• Added a DrawBot frontend for pip/PyPI to make it super easy to install third-party packages: see menu Python -> Install Python Packages...

  

• Fixed text stroke behavior (but is a breaking change): strokeWidth on text no longer scales with the fontSize

• Removed support for .mov export on 10.15 and up (QTKit is no longer supported there)

• Fixed extracting single frames from .gif files

• Improved setup.py, so drawbot-as-a-module can be easily installed with pip using a github URL

• All test now run on Travis CI (and soon also on GitHub Actions)

• Removed Python 2 code

• Many small issues were fixed

• Jumping to python 3.7

  If you use external packages you will need to install them for python 3.7. If you don't have python 3.7 installed you will need to do that first.

• Improved syntax highlighting for python 3

• Fallback fonts are also used in a svg context.

• listNamedInstances() lists all named instances for a variable font.

• BezierPath objects have bezierPath.line(pt1, pt2) and bezierPath.polygon(pt1, pt2, ...) methods.

• Update internal packages!

you could save the result to disk and open the result in an specified app with:

from drawBot import *

fill(random(), random(), random())
rect(10, 10, 100, 100)

path = "~/Desktop/test.pdf"
saveImage("~/Desktop/test.pdf")

import os
os.system(f"open --background -a Preview {path}")

I understand the confusion

a much better explanation:

The created arc is defined by a circle inscribed inside the angle specified by three points: the current point, the fromPoint parameter, and the toPoint parameter (in that order). The arc itself lies on the perimeter of the circle, whose radius is specified by the radius parameter. The arc is drawn between the two points of the circle that are tangent to the two legs of the angle.
The arc usually does not contain the points in the fromPoint and toPoint parameters. If the starting point of the arc does not coincide with the current point, a line is drawn between the two points. The starting point of the arc lies on the line defined by the current point and the fromPoint parameter.

https://developer.apple.com/documentation/appkit/nsbezierpath/1520737-appendbezierpathwitharcfrompoint

I will adjust the drawBot documentation

This is savedState() http://www.drawbot.com/content/canvas/state.html#drawBot.savedState

with savedState():
    # do something

This is more readable and clearer then wrapping code inside a save / restore statement.

For beginners there is not such a big difference:

Strings

All strings are unicode string, so no converting back and forth, but this is actually the best thing!!

print

print('hello world') requires brackets ( and )

divisions

Divisions are always floats so no more rounding, this is also a good thing: 1/3-> 0.333333 instead of 0

You keep the old behaviour with 1//3

If you dive deeper:

dictionaries

dict.keys(), dict.values(), dict.items() are not a lists anymore

Looping (a for loop or a while loop) over a dictionary and changing content of that dictionary is tricky:

for key in list(myDict.keys()):
    myDict[key] = "changed" + myDict[key]

There is of course more

• Python2 or Python3
• What's New
• google it

@thundernixon ssssht py3.6

there are plainly of references in generative art, going from artist like Sol Lewit to graphic designers Juriaan Schrofer and many more.

good luck!!

If you use a path in font(filePath) then the path is relative to the current directory (which is not always the the directory of the python file)

DrawBot the app set the current directory to the .py file directory. When used as module this does not happen.

So either set the a correct current directory or get a absolute path from the .py file: os.path.join(os.path.basename(__file__), "font.otf")

cool way to make a rounded rect!

there are already a roundedRect example in the repository: see https://github.com/typemytype/drawbot/blob/master/examples/roundedRect.py

I would encourage you to make a python package out of your helper tools that you import when you needed it...

# a separate file with the name "roundedRect.py"
def roundedRect(...):
    # draw your stuff here

# an other file in the same directory

#  name of the file/module  name of the function 
from roundedRect import roundedRect

# call it
roundedRect(...)

hope this makes sense!

that is way to complex

Variable works fine with the UI of drawBot... dont use it outside a drawBot document

You will have more control when you build it with vanilla and use this in a drawBot packages.

import vanilla


class MyController:
    
    def __init__(self):
        self.w = vanilla.Window((150, 40), "My Tool Name")
        self.w.slider = vanilla.Slider((10, 10, -10, 22), callback=self.sliderCallback)
        self.w.open()
    
    def sliderCallback(self, sender):        
        x = sender.get()
        newDrawing()
        fill(random(), random(), random())
        oval(x, 0, 1000, 1000)
        saveImage('/Users/frederik/Desktop/issueDrawBotPackage/test.pdf')
        endDrawing()
    

MyController()

this script wrapped in a .drawBot package

this should work!

You can open the debugger in drawBot by hitten alt with the help menu open.

If drawBot is installed as a module you can access it anywhere!

If Variable(..) is a key thing in your script, use a drawBot package, where you can set a main script that gets executed when the file is opened in DrawBot.app.

yes, thanks @jo

possible with cmd + arrows keys or cmd + click when ever True or False is selected

Some parts of drawBots api don't work automatically outside the application, mainly parts where an UI is involved.

But first why building an app?

I would recommend UI parts to build separately. Build a window with vanilla, add some sliders and callback whenever that slider will change.

DrawBot has a drawBot package, so drawBot code can be shared without looking a complex script folder structure: https://www.drawbot.com/content/drawBotApp/drawBotPackage.html

expanding Gustavo's example:

import colorsys

path = bytes('http://www.drawbot.com/', 'utf-8')

w, h = 31, 31
s = 10

size(w*s, h*s)

img = ImageObject()
img.QRCodeGenerator((w, h), path, 'Q')

iw, ih = img.size()

t = ""

for y in reversed(range(int(ih))):
    for x in range(int(iw)):
        r, g, b, a = imagePixelColor(img, (x, y))
        _, l, _ = colorsys.rgb_to_hls(r, g, b)
        if l < 0.51:
            fill(0)            
            rect(x*s, y*s, s, s)
            t += "W"
        else:
            t += " "
    
    t += "\n"

newPage()
font("Menlo", 16)
lineHeight(10)
textBox(t, (0, 0, width(), height()))
print(t)

and the corners are always the same

DrawBot is using CoreText to layout text. This is the same engine as TextEdit.app, and it seems this is also not possible there...

this works...

from fontTools.misc.bezierTools import calcCubicArcLength


pt1 = 100, 100
pt2 = 200, 100
pt3 = 400, 150
pt4 = 400, 400

l = calcCubicArcLength(pt1, pt2, pt3, pt4)

path = BezierPath()
path.moveTo(pt1)
path.curveTo(pt2, pt3, pt4)

text(str(l), pt3)

fill(None)
stroke(0)
drawPath(path)