Metadata-Version: 2.1
Name: canvasplus
Version: 1.3.0a1
Summary: Improved Canvas widget for tkinter with more functionality to display graphical elements like lines or text. 
Home-page: https://github.com/Luke-zhang-04/CanvasPlus
Author: Luke Zhang
Author-email: luke.zhang2004@gmail.com
License: UNKNOWN
Description: # Canvas Plus #
        ## V1.3.0-a ##
        [![forthebadge made-with-python](http://ForTheBadge.com/images/badges/made-with-python.svg)](https://www.python.org/)
        [![PyPI version shields.io](https://img.shields.io/pypi/v/canvasplus.svg)](https://pypi.python.org/pypi/canvasplus/)
        [![GitHub release](https://img.shields.io/github/release/Luke-zhang-04/CanvasPlus)](https://GitHub.com/Luke-zhang-04/CanvasPlus/releases/)
        [![GitHub license](https://img.shields.io/github/license/Luke-zhang-04/CanvasPlus)](https://github.com/Luke-zhang-04/CanvasPlus/blob/master/LICENSE)
        [![PyPI pyversions](https://img.shields.io/pypi/pyversions/CanvasPlus.svg)](https://pypi.python.org/pypi/CanvasPlus/)
        
        An improved Canvas widget for tkinter with more functionality to display graphical elements like lines or text. 
        
        Tkinter's Canvas widget has some limitations which are adressed in this package.
        
        Simmilar to the default tkinter Canvas widget, e.g canvas.create_rectangle, other canvas objects can be created.
        
        ## Availability ##
        To start, make sure you have CanvasPlus installed or cloned. You can do this with one of two methods.
        ### Option 1: Pip ###
        Pip install this package
        ```
        pip install CanvasPlus
        ```
        ### Option 2: Github ###
        Download a zip file containing all files.
        ```
        git clone https://github.com/Luke-zhang-04/CanvasPlus.git
        ```
        or<br/>
        Clone the latest stable Release
        [![Screen Shot 2020-04-15 at 11 26 54 PM](https://user-images.githubusercontent.com/55749227/79411325-991b7680-7f70-11ea-9415-84e978fb76ca.png)](https://github.com/Luke-zhang-04/CanvasPlus/releases)
        ## Importing ##
        There are a few ways to import the module. It is advised that you do not import the entire module.
        ### If an \_\_init__.py file exists with the source code in a seperate directory (recommended) ###
        ```python
        from CanvasPlus import CanvasPlus
        CanvasPlus()
        ```
        ```python
        import CanvasPlus
        CanvasPlus.CanvasPlus()
        ```
        ### If the source code is in the same directory as your project ###
        ```python
        from CanvasPlus.canvasplus import CanvasPlus
        CanvasPlus()
        ```
        ```python
        import CanvasPlus.canvasplus as CanvasPlus
        CanvasPlus.CanvasPlus()
        ```
        ### If there is no \_\_init__.py file and the source code is in a different directory as your project (why would you do this?) ###
        ```python
        from canvasplus import CanvasPlus
        CanvasPlus()
        ```
        ```python
        import canvasplus
        canvasplus.CanvasPlus()
        ```
        ## Usage ##
        Usage is very simple, especially for those with experience using tkinter canvas.
        
        For complete documentation, head over the [the wiki](https://github.com/Luke-zhang-04/CanvasPlus/wiki)
        
        ### Example: ###
        ```python
        #Imports
        from CanvasPlus import CanvasPLus
        from tkinter import Tk, StringVar, DoubleVar
        
        #set up canvas
        root = Tk()
        canvas = CanvasPlus(root, width=800, height=800, background = "white")
        canvas.pack()
        #create circle function
        canvas.create_circle(300, 600, 100, fill = "black", outline = "green", width = 3)
        
        #create rounded rectangle function
        canvas.create_round_rectangle(
            400, 550, 500, 650, radius = 75, fill = "blue", outline = "orange", width = 5
        )   
        
        #create arrow function and rotate it to by 310 degrees clockwise
        arrow = canvas.create_arrow(600, 600, 50, 50, 150, 20, fill = "grey", outline = "black")
        canvas.rotate(arrow, 600, 600, 310, unit="deg")
        
        #create a rectangle and convert it to a polygon; then rotate it by pi/4 radians (45 degrees)
        rect = canvas.create_rectangle(100, 550, 200, 650, fill = "#f7a8c6", width = 0)
        canvas.clone(rect)
        rect = canvas.poly(rect)
        canvas.rotate(rect, 150, 600, math.pi/4)
        
        #create an entry and set it's default value
        content = StringVar()
        canvas.create_entry(0, 0, anchor = "nw", textvariable = content, fg = "blue", bg = "gold")
        content.set("This is CanvasPlus %s" % _canvasPlusVersion)
        
        #create button to print the value in the previously cretaed entry
        canvas.create_button(
            5, 25, anchor = "nw", text = "button", width = 50, highlightbackground = "red",
            command = lambda e = content: print(e.get())
        )
        
        #create checkbutton and toggle it
        _, checkbutton = canvas.create_checkbutton(
            5, 50, anchor = "nw", bg = "brown", fg = "white", text = "My Checkbutton"
        )
        checkbutton.toggle()
        
        #create a label
        canvas.create_label(
            5, 75, font = ("Times", "24"), fg = "black", bg = "green", text = "By Luke-zhang-04", anchor = "nw"
        )
        
        #flip example
        aPrime = canvas.create_polygon(500, 10, 500, 20, 550, 25, 600, 20, 600, 10, fill = "yellow", outline = "black")
        a = canvas.clone(aPrime)
        canvas.flip(a, m = .5, b = -200)
        
        canvas.update()
        canvas.mainloop()
        ```
        
        ![Screen Shot 2020-04-12 at 4 40 53 PM](https://user-images.githubusercontent.com/55749227/79079310-60fc0580-7cdc-11ea-9452-ab0d625fb549.png)
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Tcl
Classifier: Topic :: Multimedia :: Graphics
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.3
Description-Content-Type: text/markdown
