================================================================

    PyV2D
    Pythonで動作する2Dバーチャル配信アバターアプリ

================================================================

_/_/_/_/ 動作環境のインストールと起動 _/_/_/_/

■Windowsの場合
(1) 以下のURLのページから最新版(バージョン3.10)のPython実行環境をダウンロードしてインストールします
    https://www.python.org/downloads/
    このとき、インストーラーの下部に表示される「Add Python 3.10 to PATH」のチェックボックスにチェックが入った状態にしてください

(2) Windowsに標準でインストールされているシステムツールの「コマンドプロンプト」を開き、以下のコマンドをコピーして貼り付け、エンターキーで実行します
    py -m pip install numpy sounddevice keyboard
    ※黄色の文字で表示される警告メッセージはPyV2Dの動作には影響しません

(3) ダウンロードしたPyV2Dのファイルを適当な場所に展開し、その中の「pyv2d_win」をダブルクリックすると、コマンドプロンプトと共にPyV2Dが起動します

※拡張子「.py」をPython実行環境のpythonw.exeに関連付けてから「pyv2d.py」をダブルクリックすることでPyV2Dを起動した場合はコマンドプロンプトは開きません。


■Fedoraの場合
(1) 管理者権限のあるユーザーとしてログインした状態で以下のコマンドを実行します
    sudo dnf install python3-tkinter python3-numpy portaudio

(2) 続けて、以下のコマンドを実行します
    pip3 install sounddevice

(3) ダウンロードしたファイルを任意の場所に展開します。

(4) pyv2d.desktopをテキストエディターで開き、「■PyV2Dフォルダまでのパス■」を展開したフォルダのパスに書き換えます

(5) pyv2d.desktopをダブルクリックしてPyV2Dを起動します

※pyv2d.desktopをにコピーしてデスクトップに再ログインすると、PyV2Dがスタートメニューに追加されます。
GNOMEの場合 /home/(ユーザー名)/.local/share/applications
KDEの場合 /usr/local/share/applications


_/_/_/_/ 自作アバターの設定 _/_/_/_/

アバターに使用する画像ファイルを入れたフォルダに以下の設定ファイルを設置すると自作アバターが作成できます。
なお、画像ファイルはPNG形式のみに対応しています。

設定ファイル「avatar.json」
{
    "width" : 使用するアバター画像の幅(px)
    "height" : 使用するアバター画像の高さ(px)
    
    "base" : 目と口のないアバター画像のファイル名
    
    "closed_eyes" : 閉じた目の画像のファイル名
    "opened_eyes" : 開いた目の画像のファイル名
    
    "closed_mouth" : 閉じた口の画像のファイル名
    "opened_mouth"[] : 開いた口の画像のファイル名(閉じ気味のものから開ききったものへの順で1枚以上の任意の枚数を登録可能)
    
    "special_faces"[] : 特別な表情のときの顔のパーツの画像のファイル名(任意の枚数を登録可能)
        {
        上記"base"〜"opened_mouth"の各項目を指定可能。指定しない項目はnullとしてください
        ※"opened_eyes"を指定して"closed_eyes"を指定しない場合はまばたき機能が無効化されます
        ※"closed_mouth"を指定して"opened_mouth"を指定しない場合は口の動きが無効化されます
        }
}


_/_/_/_/ ライセンス _/_/_/_/

本アプリケーションは無権利創作宣言(https://www.2pd.jp/license/)の条件に従って著作権放棄されています。
営利・非営利を問わず、本アプリケーションは無料でご利用いただけます。


_/_/_/_/ お問い合わせ _/_/_/_/

本ソフトウェアに関するお問い合わせはMidari Create(https://create.2pd.jp/)までお願いします。
