===============================
Introduction to PyEasyGraphics
===============================
A Borland Graphics Interface like Grahics library for python
`Borland Graphics Interface <https://en.wikipedia.org/wiki/Borland_Graphics_Interface />`_, also known
as `Turbo C Graphics <http://www.softwareandfinance.com/Turbo_C/Graphics/>`_, is an easy-to-use graphics library
bundled with Turbo C/Turbo C++/Borland C++.
Because it is easy to learn and use, it is very good for using for kids and beginners to learn basic programming ,
computer graphics.
.. image:: https://badge.fury.io/py/easygraphics.png
:target: http://badge.fury.io/py/easygraphics
.. image:: https://pypip.in/d/easygraphics/badge.png
:target: https://pypi.python.org/pypi/easygraphics
* Free software: BSD license
* Documentation: https://pyeasygraphics.readthedocs.io/en/latest/
* Documentation (Chinese Version): http://easygraphics.royqh.net
Sample program
----------------------
The following code shows a moving ellipse.
.. code-block:: python
from easygraphics import *
def mainloop():
x = 0
set_color(Color.BLUE)
set_fill_color(Color.GREEN)
while is_run():
x = (x + 1) % 440
if delay_jfps(60):
clear_device()
draw_ellipse(x + 100, 200, 100, 100)
def main():
init_graph(640, 480)
set_render_mode(RenderMode.RENDER_MANUAL)
mainloop()
close_graph()
easy_run(main)
Special Thanks
---------------
Some code is taken from `easygui_qt <https://github.com/aroberge/easygui_qt/>`_ and
`qtutils <https://bitbucket.org/philipstarkey/qtutils>`_, thanks a lot!
History
===========
2.0.1.1
* fix: bug in image.draw_arc
* remove: flood_fill
2.0.0-alpha2
------------
* optimize: polygon drawing functions
* change: we don't reset pen/brush for each draw_* methods
* add: circle drawing methods to Image
* add some comments
* add: KeyMessage now have type property, to distinguish key release and key press message
2.0.0-alpha1
------------
* turn on anti-alias by default
* remove floodfill() method (slow, and not working with shapes drawn with anti-aliasing. we shouldn't use it)
* remove background mask (it's seldom used and will slow down the drawing speed)
* set image's default background color to TRANSPARENT
1.0.20
-----------
* add: Image.copy() method
* change: draw_image() add width/height parameters ( can copy image with scale)
* change: only create direct image buffer view when using floodfill()
1.0.19
-----------
* add: Image.scaled() method
1.0.18
-----------
* add: put_image()
* change: capture_screen()'s 3rd and 4th parameter to width and height
* add: more FillStyle consts
1.0.17
-----------
* fix: dialogs dosen't work in normal pyqt program
* change: contains_control() -> contains_ctrl()
* add: load_image() throw value error if the image file is not exist
* fix: get_mouse_msg() / get_char() / get_key() not quit correctly when the graphics window is closed
1.0.16
-----------
* add: set_antialiasing()
* add: contains_control()/contains_alt()/contains_shit()/contains_meta()
* change: get_mouse_message() now return a MouseMessage object
* change: get_key() now return a KeyMessage object
1.0.15
-----------
* change: use queue to store keyboard/mouse message
* remove: set_message_outdate_duration()
* change: now get_message() return 5 results instead of 4
* add: clear_mouse_msg(), clear_key_msg(), clear_char_msg()
* add: create_image_from_file()
1.0.14
-----------
* fix: processing not working
* fix: get_key() and has_kb_msg() not working
* add: set_message_outdate_duration()
* add: bezier_point and bezier_tangent functions
* add: curve_point and curve_tanget functions
* add more documents and examples
1.0.13.1
-----------
* fix: immediate mode not work
* fix: set_flip_y() dosen't work when reused after reset_transform()
1.0.13
----------
* add easy_run mode
* now the easy_run mode is the preferred mode to run easygraphics. It can work under Linux, macOS and windows.
1.0.12
----------
* fix: the drawing is not stopped immediately after the turtle window is closed()
1.0.11
----------
* fix: dialog get_username_password() hangs.
* fix: dialog get_color() not work
* fix: dialog show_html()/show_code()/show_text() not work
1.0.10
----------
* add: show_objects() now can show a DataFrame.
1.0.9
----------
* add: enable_sorting parameter in show_objects()
1.0.8
-----------
* fix: crash when show_objects() called successively.
* dialogs will close the auto-started qapplication instance when exception raised.
1.0.7
-----------
* fix: show_objects() don't show non-primitive-type properties correctly
1.0.6
------------
* change: get_open_file_name()/get_file_names()/get_save_file_name() now use native dialogs, to avoid
crash on pyqt >= 5.11.3
* add: FileFilter const class, and filter parameter in get_open_file_name()/get_file_names()/get_save_file_name()
1.0.5
------------
* add: get_open_file_name() to dialog package.
* fix: get_open_file_name()/get_file_names()/get_save_file_name() not work
* change: get_open_file_name()/get_file_names()/get_save_file_name() return filename(s), instead of tuple
1.0.4
------------
* remove the y-flip setting in ortho_look_at(). If you want to flip y, use set_flip_y() instead
1.0.3
------------
* add: ortho_look_at() function to map 3d point to 2d
* add: isometric_projection() function to map 3d point to 2d from 45degree view port
1.0.2
------------
* add: press ctrl+shift+alt+F10 will create a snapshot of the graphics window.
The snapshot is saved in the running folder.
* change: close turtle window will automatically close the animation of turtle moving.
1.0.1
-----------
* add: fps settings in easygraphics.processing module
* update: translations
* change: easygraphics.processing module now use functions in easygraphics modules to draw. (Remove duplication defines.)
1.0.0
-----------
* fix: hangs in inactive shell when init_graph again after close_graph()
0.10.1
-----------
* add: color_gray() function.
* change: change lines/polylines/polygon functions parameters
* add: curve() / draw_curve() to draw Catmull-Rom splines.
* add: curve_vertex() to define curve vertices.
* fix: crash when close_graph() and init_graph() again
0.10.0
------------
* change: reimplement close_graph(), simplifies graphics window close event processing.
* add: add begin_shape()/vertex()/bezier_vertex()/quadratic_vertex()/end_shape() functions to easygraphics.
0.9.24
------------
* add begin_recording()/add_record()/save_recording()/end_recording() to create animated png files.
* add ShapeMode consts
* add set_ellipse_mode() and set_rect_mode() to Image class
* add easygraphics.processing module
* fix: Image's save_settings()/restore_settings() now save most settings.
* update: ellipse_mode apply to arc/chord/pie shape drawings.
* add quadratic()/draw_quadratic() function to Image class and easygraphics.processing subpackage
* add begin_shape()/vertex()/bezier_vertex()/quadratic_vertex()/end_shape() function to Image class and easygraphics.processing subpackage
* change: bezier()/draw_bezier now use seperate coordinate values as paramter instead of list.
* add VertexType consts
* add: begin_shape() 's type parameter
* add: end_shape()'s close parameter
* fix: succesive dialog calls may crash the program
* add: fill_image() function to Image class
0.9.23
------------
* fix: frame jumping because of errors in delay_jfps()
0.9.22
-------------
* fix: turtle icon position error when translated.
* fix: hangs when running in qtconsole and spyder
0.9.21
-------------
* add: show_lists_table() to display data lists in table
* add: get_transform()/set_transform()/push_transform()/pop_transform()
* change to BSD license
* fix: close graphics window when drawing in is_run() and delay_fps()/delay_jfps() loops not throw exception
0.9.20
-------------
* fix: successive dialog calls may crash program.
0.9.19.2
-------------
* fix: license description in readme
0.9.19.1
-------------
* fix: license description in setup.py
0.9.19
-------------
* change to MIT License
0.9.18
-------------
* add ImageWidget and TurtleWidget classes, to embed easygraphics in Qt Applications
0.9.17
-------------
easygraphics.turtle:
* add: is_out_of_window() to check if the turtle is out of the graphics window
0.9.16
-------------
* redefine pause() in turtle
* redefine is_run() in turtle
* fix: default turtle speed
* change: meaning of the turtle's move_arc() function's parameters
* add: move_ellipse() function in easygraphics.turtle package
0.9.15
-------------
* fix package error in setup.py
* change turtle's default speed to 10
0.9.14
-------------
* add: move_arc() function to move turtle in arc
0.9.13
-------------
* add: set_fill_rule() / get_fill_rule() function, to control how the polygons
are filled.
* add: FillRule consts
* Finish chinese translations for apis.
* fix: filling glitches in end_fill()
0.9.12
-------------
* Revert 0.9.11 's angle system change. Keep arc/pie/chord compatible with BGI.
* add show_image() function, to display drawings in the jupyter qtconsole or notebook.
* add show_image_dialog() function, to display a qimage in the dialog.
0.9.11
-------------
* fix: now arc/pie/chord drawing functions has the same angle system with rotate()
0.9.10
-------------
* add: easygraphics.turtle package which implements the turtle graphics.
* change: now rotate()/skew() can transform around any point
* change: now reflect() can using lines not passing the origin as the reflecting axis.
0.9.9
-------------
* add set_flip_y() to make y-axis grows bottom-up. (use reflect() will make texts
get reflected too.)
0.9.8.1
-------------
* fix: legacy and music subpackage not packed in the binary distributions.
0.9.8
-------------
* fix: delay_fps() now work properly in Manual render mode
* finish chinese translations for tutorials
0.9.7
-------------
* add: load_image() to load image from files
* add: to_alpha() to make a transparently color
* change: use Source Over as the default composition mode (the same with Qt)
* more tutorials
* add: show_table() to display table infomation in a dialog
* change: rename mouse_msg() to has_mouse_msg()
* change: rename kb_hit() to has_kb_hit()
* change: rename get_mouse() to get_mouse_msg()
* change: rename kb_msg() to has_kb_msg()
* finish the tutorials.
0.9.6
-------------
* add: reflection (mirror/flip) and shear (skew) operations.
0.9.5
-------------
* add: headless mode support (no graphics window mode, use it to draw pictures)
0.9.4
-------------
* add: easygraphics.legacy package to better compatible with old BGI programs.
* add: get_click() function to get mouse click event
* change: background implementation to make set_background_color() work correctly
* add: now can use name ("red"), color string ("#ff0000), integer color rgb value (0xff0000) \
in set_color(), set_fill_color(), set_background_color() functions
* add: cymk() and hsv() to get CYMK and HSV format color
* more tutorials
0.9.3
-------------
* fix : Readme
0.9.2
-------------
* add: easygraphics functions can run in the interactive mode (eg. IPython) correctly
* add: dialogs (in **easygraphics.dialog** package, adopted from
`easygui_qt <https://github.com/aroberge/easygui_qt/>`_ )
* add: create and save to/from file
* add image transforms (translate/rotate/scale)
* add view port support
* add sphinx docs
* upload docs to readthedocs.org
0.9.1
-------------
* add readme text
* add delay_fps() and rgb() functions
0.9.0
-------------
* add keyboard and mouse message check and handle
* add simple dialogs ( from EasyGUI-Qt (https://github.com/aroberge/easygui_qt) and qtutils (https://bitbucket.org/philipstarkey/qtutils))
0.1.0
-------------
* First release on github