Processing Mode and Hybrid Coding

[hx2A]

This is a major release with big improvements to py5's functionality. This release was a lot of work!

What Changed?

You can read about all of the changes and the reasons behind them on the maintainers blog. The main highlights are:

• Processing Mode - gives Processing users a new callPython() method to make arbitrary calls to Python. Here, py5 functions as a bridge from Java to the Python world
• Hybrid Programming - augment your py5 Sketches with Java code
• Attribute Errors now provide coding suggestions. For example:

    py5 encountered an error in your code:

    File "<ipython-input-6-b7441cc777da>", line 2, in setup
        1    def setup():
    --> 2        c = py5.colorr(255)
        3        py5.background(c)
        ..................................................
        py5.colorr = # AttributeError
            py5 = <module 'py5' from '/Users/jim/INSTALL/anaconda3/envs/
            py5/lib/python3.8/site-packages/py5/__init__.py'>
        ..................................................

    AttributeError: py5 has no function or field named "colorr". Did you mean "color"?

• Small changes to Py5Vector to make it more consistent with Processing's PVector class
• The create_image_from_numpy() method now supports BGR and BGRA color channel ordering

API changes

• The get() method has been renamed get_pixels() and a new method set_pixels() has been added
• The random_choice() method has been renamed random_sample() and a new implementation of random_choice() has been created

New Contributors

• @dmorenog01 made their first contribution in Fixed Error in py5.exit_sketch() example code #246 #249
• @AsadNizami made their first contribution in str and repr implementation for the py5 class. #251

Bug Fixes

• How to deal with vertices(), and other functions that expect collections, when arguments provided are empty? #195
• set_pixel() and get_pixel() methods #198
• random_choice() returns a numpy array, is this by design? #199
• random_choice() on a list of Py5Vector returns a list of numpy.ndarray #200
• Need to update run_sketch() documentation - OSX blocking info is incorrect #201
• Processing mode keys can't map to class instances #203
• py5_tools.save_frames() is useful but makes my browser tab crash for large numbers of frames #207
• py5 class objects should implement __str__() and __repr__() #209
• py5 Attribute errors could provide useful suggestions #224
• Vertices method should accept generators #229
• Parameterize blocking in imported.run_code() #231
• Improvements to callback handling for select_file(), select_folder(), etc #233
• Python exceptions for Processing mode function calls are not handled properly #234
• Small changes to Py5Vector set_mag() and normalize() to make it more consistent with PVector & Processing #243
• Error in py5.exit_sketch() example code #246
• create_image_from_numpy() should support 'BGR' color channel ordering #247
• Sketch window assets not being disposed of properly when an error is thrown #254
• Attribute Error suggestions don't work in imported mode #276

Full Changelog: py5-1286-0018-0.8.3a1...py5-1292-0019-0.9.0a0

---

This discussion was created from the release Processing Mode and Hybrid Coding.