https://github.com/aais-lab/citam_pydraw
CIT Advanced Media : Python Drawing Library
https://github.com/aais-lab/citam_pydraw
drawing-library mac python python-library tkinter-python
Last synced: 2 months ago
JSON representation
CIT Advanced Media : Python Drawing Library
- Host: GitHub
- URL: https://github.com/aais-lab/citam_pydraw
- Owner: aais-lab
- License: bsd-3-clause
- Created: 2023-12-07T01:11:53.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-30T09:36:18.000Z (8 months ago)
- Last Synced: 2025-06-30T09:49:14.994Z (8 months ago)
- Topics: drawing-library, mac, python, python-library, tkinter-python
- Language: Python
- Homepage:
- Size: 106 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IntroductionPrograming-library: citam_pydraw
# Overview
千葉工業大学 先進工学部 知能メディア工学科の第2セメスター「プログラミング言語基礎」及び第3セメスター「プロジェクト1」において使用される、Pythonの図形描画ライブラリです。
tkinterのWrapperで、[Processing](https://processing.org/)ライクに動作させることを目指して作成されました。
# Requirement
## 必要環境
- MacOS
- Windowsでも使用可能ですが、音楽を再生する機能のみ使用不可です
- 今後のバージョンでは対応しなくなる可能性があります
- Linux環境も一応ですが対応しています
- Docker環境の用意があります -> [IPが導入されるPython環境(Docker版)](https://github.com/aais-lab/PythonEnv_docker)
- 音楽再生はmpvコマンドによって実装しています
- Python >3.10.5
- 動作確認済み >=3.12.2
- MacのSystem DefaultのPython環境にはライブラリを入れることができないため注意してください
- 必要なライブラリ
- tkinter 8.6以上
- Pillow 11.2以上
- brew + pyenv環境の場合、対応したpython-tkが必要です
- 音楽再生用コマンド
- MacOS: afplay
- Linux: mpv
## 開発・動作確認環境
- MacOS Ventura以降
- [Docker環境](https://github.com/aais-lab/PythonEnv_docker)
- Python
- brew + pyenv
- 3.10.5 <
- <= 3.12.2
- ライブラリ
- Python標準
- tkinter 8.6
- Pillow 11.2.1
## 環境構築の既知トラブル
### MacOSかつpython3.10系の場合
tkinter8.5がデフォルトで入っているようですが、[Pythonとtcl/tkの対応問題](https://www.python.org/download/mac/tcltk/)によって実行時にWindowが黒く表示される不具合が発生します。
```
import tkinter
tkinter.Tcl().eval('info patchlevel')
```
上記をPythonで実行するとtkinterのバージョンを確認することが可能です。
開発・動作確認環境と同様にbrew + pyenv環境の場合は
```
pyenv uninstall 3.10.x
brew install python-tk@3.10
pyenv install 3.10.x
```
でおおよその場合解決します。
### 実行時にImportErrorが出て、エラー箇所がImport _tkinterの場合
tkinterがうまく読み込めていません。
Python Build時にtkinterのリンクがちゃんといってない？詳細な原因は不明です。
開発・動作確認環境と同様にbrew + pyenv環境の場合は
```
pyenv uninstall 3.x.x
brew install python-tk@3.x
pyenv install 3.x.x
```
でおおよその場合解決します。
```
brew install python-tk@3.x
```
の際は、python-tkのバージョンをインストールしたいPythonのバージョンに合わせて指定してください。
### import IP 実行時にModuleNotFoundErrorが出て、エラー箇所がimport IP.IPの場合（旧）
他にも以下パターンは同様の原因です。
```
ModuleNotFoundError: No module named "IP.mouse"
ModuleNotFoundError: No module named "IP.keyboard"
```
パッケージのダウンロードもしくは展開時(zipでダウンロードした場合)にライブラリ内のIP.py等が欠損したことが原因です。
ダウンロードもしくは展開をやり直して、以下のファイルが全てあることを確認してください。
# Usage
## PyPIから
```
pip install citam_pydraw
```
## gitから
### クローン
```
git clone https://github.com/aais-lab/citam_pydraw.git
```
### ライブラリのフォルダへ移動して、pip install
```
cd citam_pydraw
pip install .
```
Successfully installed citam_pydraw-x.x.xと表示されれば導入完了です。
# Reference
関数等のリファレンス
[IntroductionPrograming-Reference](https://aais-lab.github.io/IntroductionPrograming-Reference/)
# Author
[Nao Yamanouchi](https://github.com/ClairdelunaEve)
# Licence
3-Clause BSD