Metadata-Version: 2.4
Name: generativepy
Version: 50.0
Summary: Generative art library
Home-page: https://github.com/martinmcbride/generativepy
Author: Martin McBride
Author-email: martin@axlesoft.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=2.5.1
Requires-Dist: pycairo>=1.27.0
Requires-Dist: pillow>=10.4.0
Requires-Dist: imageio>=2.37.0
Requires-Dist: moviepy>=2.2.1
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: summary

# generativepy

Generative art and graphing library for creating images and animations.

## Version 50.00

* Move to semantic versioning (Major.Minor) rather than date versioning (YY.MM) starting from 50.00
* Make *AxesAppearance* fields consistent with *Axis* settings in graph module
* Use *of_points* to define scatter charts in graph module
* Remove deprecated market classes and geometry functions in geometry module
* Case insensitive CSS names in color module
* Move geometry related constants from drawing module to geometry module
* Merge shape2d module into math module
* Remove povray and moderngl modules (geometry3d and drawing 3d) to separate project, genpy3d
* Fix minor bugs in formula rendering
* Add matplotlib module, create matplotlib graphs from genertativepy
* Add dot product to Vector class
* Add BookColorScheme, suitable for print and web
* Add axis positions (axes can be drawn on boundary or on axis)
* Update for latest moviepy version

## Version 24.11
 
* Fix bug is extents for `of_xy_function`.
* Axes.transform_from_graph can accept a point or a sequence of points.
* Allow axes labels to be positioned around edges of graph if required. 

## Version 24.04

3D drawing is likely to change in a future release. The rest of the library is reasonably stable. 

* Most shapes can now optionally accept `FillParameters` and `StrokeParameters` to control fill and stroke styles. This makes it easier to share styles amongst different objects.
* Add scatter plots, including stalk and connected styles.
* Add a basic `Vector3` implementation to `math` module. 
* New `Markers` class to rationalise line markers (ticks, paraticks, parallel markers), adding new markers and allowing position to be controlled.
* New `overlay_nparrays` function in `nparray` module allows two images to be overlaid, treating pure white as transparent.
* Add 3D charts (z against xy) using `povray`. Also added `complex` module to `genpygoodies` to help with plotting complex graphs
* Add `povray` module with capability of drawing 3D shapes using vapory module.
* `Plot` now has a `close` parameter that creates a polygon area based on a section of the curve that can then be filled. This can be the area under the curve, or above the curve, or any area created be extending the curve with additional points.
* Update docstrings of all modules to support autogenerated documentation on generativepy.com

## Usage

generativepy is a library rather an application. It provides useful functions and example code that allow you to
create images and videos by writing simple Python scripts.

The library requires:

* Pycairo
* NumPy
* Pillow
* MoviePy
* ImageIO
* Command line application gifsicle (only needed for GIF creation)
* Commandline applications latex and divpng (for formula formatting)

Main functionality:

* A simple framework for creating images, image sequences, and gifs, using pycairo.
* Support for bitmap processing using PIL and NumPy.
* Colour module that supports RGB, HSL and CSS colours, transparency, lerping, colormaps.
* A simple tweening module to help with animation.
* Geometry module for drawing shapes.
* A graphing library for plotting 2D functions.
* MovieBuilder supports creating video files from separate scenes.
* Latex formula rendering
* Math module for vectors, matrices and abstract shapes. 

## Website

Visit [graphicmaths.com](http://www.graphicmaths.com/) for details:

* [generativepy API reference](https://graphicmaths.com/generativepy/generativepy-api/).
* [generativepy tutorials](https://graphicmaths.com/generativepy/generativepy-book/color/).

For detailed information of pycairo see the [Computer graphics in Python](https://leanpub.com/computergraphicsinpython) ebook.
