Desktop CMU Graphics is an offline version of CMU Graphics, a persistent-object graphics package geared towards beginner computer science students. CMU Graphics and its desktop version are maintained by CMU CS Academy, a Carnegie Mellon University project which develops free-to-use middle and high school computer science curriculum.
This package, including its documentation, is licensed under the BSD 3-Clause license.
Installation
Choose zip or pip
There are two different ways to install Desktop CMU Graphics on a device:
- (Mac and Windows only) Use the zip file installer that is available for download on the CMU CS Academy website.
- (Mac, Windows, and Linux) Use pip, Python’s built-in package-managing software.
Both methods come with their own advantages and limitations. If you're in doubt about which to choose, the zip file installer is the most likely to succeed. It should work regardless of most restrictions in place on school-distributed devices.
For those using devices with Linux operating systems, or for those who are familiar with the command line/terminal, the pip version of the package offers a larger degree of versatility.
The remainder of these installation instructions are only for the pip version.
Install CMU Graphics
Run the following command:
pip install cmu-graphics
Getting Started
To run our graphics framework, include the following line at the top of your Python file:
from cmu_graphics import *
At the end of your Python file, add this line:
cmu_graphics.run()
From there, the syntax for using the graphics package is identical to the online version of the framework. You can find more details about how to use the graphics framework here on our documentation page.
Teacher Support and Documentation
If you are a teacher with a CMU CS Academy Account and you have questions about CMU Graphics, remember that you can reach out to us through the Support tab on the left side of the CMU CS Academy website:
If you are an educator but do not have an account with CMU CS Academy, you can register for an account here.
If you are a student, or you are exploring Desktop CMU Graphics, there are plenty of resources to help you get started with the framework. Students can reach out to their teachers for questions about CMU Graphics, and a full reference documentation for the graphics framework is available on our documentation page.
Features specific to Desktop CMU Graphics
app.cursorVisible
Setting app.cursorVisible = False in your code will cause the computer's mouse pointer to be hidden within your window. You can set app.cursorVisible = True to make it visible again.
Fullscreen mode
Your programs can call app.enableFullscreen() to use a fullscreen mode where the window contents fill the entire screen. Call app.disableFullscreen() to return to a normal window.
onResize
The event handler onResize is available in all projects. See the web CPCS documentation for details. (This event handler is only available in CPCS mode on the web.)
2 maintainers
Metadata
2 maintainers
Release files for cmu-graphics 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cmu_graphics-3.0.0.tar.gz | 235.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cmu_graphics-3.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 473.0 kB
Release files / cmu_graphics-3.0.0.tar.gz
| Download URL | cmu_graphics-3.0.0.tar.gz |
|---|---|
| Size | 235.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
21995986782449f3e1d106e42902ae93ccacd0f683edda30309299dab0e98558
|
|
BLAKE2b-256 checksum How to use checksums |
9d20a89b436e9e7cad8e871f1901c02721200d41e5e90973a4dae74df44111f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / cmu_graphics-3.0.0-py3-none-any.whl
| Download URL | cmu_graphics-3.0.0-py3-none-any.whl |
|---|---|
| Size | 237.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
12a39d75f1fdd027ec80c24df1413145c7cb89e84828ce0f4376c799e3423ff8
|
|
BLAKE2b-256 checksum How to use checksums |
5c37a1d622029a0eaa011afa15431c1315f916040f3e989527b39a6cc97e01b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
