Pythonで進捗バーを表示する。

Pythonで処理する際に、どれだけ処理が完了したのかコンソール画面に表示します。
進捗バー（プログレスバー）を作成したい方に向けて、tqdmを使用した進捗表示の方法を解説します。

本記事では、tqdmの基本の使い方や実際のソースコードを例示し、
処理の進捗をわかりやすく表示する方法を紹介します。

tqdmとは

モジュールtqdmは、処理の進捗を視覚的に表示するための便利なライブラリです。

大量のデータや複数の処理を行う際、その進捗を表示することで、
開発者やユーザーに安心感を提供します。

進捗表示を使うことで、大規模なプロジェクトや複雑なタスクでも、
現在どの程度進行しているのかを一目で把握できるようになります。

例えば、データ処理の際にも、どれくらいの作業が完了したか、
予定に対してどれだけ進んでいるのかを視覚化することが可能です。

tqdmをインストールするには、pipを使用します。

pip install tqdm

基本的な機能

基本的な使い方としては、forループにtqdmを追加するだけで、
簡単に進捗バーを表示することができます。

tqdmは、処理の進行状況を正確に視覚化するだけでなく、
プログラムのパフォーマンスにほとんど負担をかけずに自然に表示できるので、非常に便利です。

また、進捗をリアルタイムで確認できるため、
長時間の処理でもユーザーに安心感を与えることができます。

from tqdm import tqdm
import time

for i in tqdm(range(10), desc="Processing"):
    time.sleep(0.5)  # 一時停止を作る

このコードでは、10回のループを繰り返している間に進捗バーが表示されます。

【Python】カウントダウンタイマー｜sleepでタイマー処理

Pythonでのタイマーとカウントダウンの作り方は、tkinterを使用してsleep関数とtimerを組み合わせ、使いやすいタイマーを実装できます。

alicia-ing.com

2025.08.11

descを使って処理内容を説明することで、
何をしているのかをユーザーにわかりやすく伝えることができます。

これにより、ユーザーにも進行状況が伝わり、処理が進んでいる感覚を共有できます。

すべての処理の完了率をゲージで表示

指定されたフォルダ内の画像ファイルをWebP形式に変換する処理を実行します。

処理は、フォルダ内のファイルを順次ループし、
PillowライブラリのImage関数を使って画像をWebP形式に変換します。

【Python】pngやjpgの画像をwebpに一括で画像変換

pngやjpeg、bmpを画像変換するためにフリーソフトを探しても求めるものがないときはPythonのpillow,osモジュールで一括でwebpにします。自作ならwindows、macの対応を気にせず、応用でheicやavifもできます。

alicia-ing.com

2025.08.11

その際、tqdmを用いて進捗状況を一歩ずつ表示し、処理の完了までの時間を視覚化しています。

これにより、処理がどの程度進んでいるかを簡単に把握することができ、
使用者や開発者が実行時間を予測したり、処理の進行を確認することが可能です。

また、処理中にエラーが発生した場合、どのファイルで問題が発生したのかを明確に特定できるため、トラブルシューティングも容易です。

ソースコード・解説

• モジュール名

「PIL (Pillow)」：Python Imaging Library（PIL）を拡張したPillowモジュールは、画像ファイルの読み込みや保存、編集を行うために必要です。インストールは「pip install Pillow」を使用します。
「os」：ファイルやディレクトリのパス操作を行うために必要です。特にフォルダの存在確認やファイルのパス取得に使用します。
「tqdm」：長時間実行する処理の進捗状況を視覚的に表示するために必要です。インストールは「pip install tqdm」を使用します。
「time」：処理に微小な遅延を持たせるために必要です。これにより進捗バーが滑らかに動くように見せる効果があります。

from PIL import Image
import os
from tqdm import tqdm
import time

• フィールド（メンバ変数）

「input_folder」：変換対象となる画像ファイルが格納されているフォルダのパスです。
「output_folder」：変換後の画像ファイルを保存するためのフォルダのパスです。
「file_list」：入力フォルダ内の変換対象画像ファイルのリストです。
「progress_bar」：tqdmによって生成される進捗バーオブジェクトで、処理の進捗を視覚的に表示するためのものです。
「input_path」：入力画像ファイルの絶対パスです。
「output_path」：変換後のWebP形式の画像ファイルの絶対パスです。

• convert_to_webp関数

この関数は、指定されたフォルダ内の画像ファイルをWebP形式に変換する処理を行います。

最初に出力フォルダが存在しない場合は新たに作成し、
入力フォルダ内の画像ファイルを拡張子でフィルタリングして取得します。

取得したファイルリストを使って、一つずつ画像ファイルを開き、
WebP形式に変換して出力フォルダに保存します。

処理の進捗状況はtqdmで表示し、
全てのファイルが処理されるとメッセージを表示します。

def convert_to_webp(input_folder, output_folder):
    # 出力フォルダが存在しない場合は作成する
    if not os.path.exists(output_folder):
        os.makedirs(output_folder)

    # フォルダ内のファイルを取得する
    file_list = [f for f in os.listdir(input_folder) if f.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.bmp'))]

    # ファイル数が0の場合、処理を終了
    if not file_list:
        print("画像ファイルが見つかりませんでした。")
        return

    # tqdmで進捗バーを作成
    progress_bar = tqdm(total=len(file_list), desc="変換中", unit="file", smoothing=0.1)

    for file_name in file_list:
        # ファイルの絶対パスを取得する
        input_path = os.path.join(input_folder, file_name)
        output_path = os.path.join(output_folder, os.path.splitext(file_name)[0] + '.webp')

        # 画像を開いてWebP形式で保存する
        try:
            with Image.open(input_path) as image:
                image.save(output_path, 'webp')
        except Exception as e:
            print(f"エラー: {file_name} ({e})")

        # 進捗バーを更新
        progress_bar.update(1)
        time.sleep(0.01)  # 流れる感覚を持たせるための微小な遅延

    progress_bar.close()
    print("全ての画像の変換が完了しました！")

# フォルダのパスを指定して変換を実行する
input_folder = 'Input'
output_folder = 'Output'

convert_to_webp(input_folder, output_folder)

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

実演

プログラムを実行すると、冒頭で示したような進捗バーが表示されます。

本記事での例では、画像変換なのであまり進捗バーの役割を成さないですが、
動画や人工知能などの大きいデータを扱う場合は進捗バーがあるとプログラムが動いているのか把握できます。

必要に応じて、プログレスバーを導入してください。

まとめ

本記事では、Pythonで進捗バーを作成するためのライブラリ、tqdmの使い方を解説しました。

既存のスクリプトにtqdmを実装することで、処理の進捗を視覚的に確認しながら、
効率的に作業を進めることが可能になります。

tqdmを使うことで、従来の処理に比べてよりユーザーフレンドリーな体験を提供し、
開発者は実行中の処理を可視化しやすくなり、デバッグや評価時の助けにもなります。

次回の開発では、さらに複雑な処理にもこの進捗表示を実装して、便利さを向上させていきましょう。

Google Text-to-SpeechをPythonから制御する。

GoogleのText-to-Speech APIを使えば、
Pythonを用いて簡単にテキストを音声に変換できます。

本記事では初めての方にも分かりやすく、
APIの取得方法からPythonでの実装までを詳しく解説していきます。

また、商用利用や料金、音声ファイルの保存方法など、
Pythonで自動音声生成を行う手順を完全に理解できる内容となっています。

Google Text-to-Speechとは

Google Text-to-Speechはテキストを音声に変換するサービスで、
無料で使える発話エンジンです。

日本語、英語、フランス語など、多くの言語に対応していて幅広い用途で利用できます。

Pythonと組み合わせることで、さまざまな音声アプリケーションを簡単に作成できます。
たとえば、ナビゲーションシステムや教育アプリ、自動応答システムなど用途は無限大です。

Google Text-to-SpeechはAI技術を駆使して、自然で高品質な音声を生成します。
これにより、ユーザーにとって使いやすく、聞き心地の良い音声を提供することが可能です。

また、Text-to-Speechはアクセントや話者のトーンなども調整可能なため、
さまざまな音声タイプをカスタマイズできます。

Google Text-to-Speechの使い方

Google Text-to-Speechを使うには、まずGoogle Cloudのアカウントを作成し、
Text-to-Speechを有効にする必要があります。

Pythonのプログラムから音声合成を行うためには、
Google Cloudの認証情報（APIキー）を取得して設定する必要があります。

Pythonコードを用いることで、指定したテキストを音声に変換し、
WAVやMP3形式で保存することが可能です。

これにより、手軽に音声ガイドやナレーションを自動生成することができます。
例えば、観光案内アプリでの音声案内や教育用の教材など、多種多様な用途で活用できます。

また、テキストの内容に基づいて発話速度やピッチも調整できるため、
さまざまなシチュエーションに対応した音声を生成することが可能です。

Google Text-to-Speechは商用利用できる？

Google Text-to-Speechは商用利用も可能です。
ただし、Google Cloudの使用量に応じた料金が発生するため、
商用プロジェクトで利用する際は料金体系に十分注意する必要があります。

また、Googleの利用規約に従って、適切に利用することが求められます。

商用利用する場合、特に注意すべきなのは利用料金と使用制限です。
料金は使用量に依存しているため、大量に音声を生成する場合は予算に応じて計画的に使うことが求められます。API使用数を確認しながら調整する必要があります。

また、商用利用に際しては、エンドユーザーに対する情報提供やプライバシーの保護に対しても責任を持つ必要があります。これらを十分に理解したうえで、商用利用を進めることが大切です。

pyttsx3との比較

合成音声pyttsx3の場合は、PC搭載の読み上げ機能を使うためAPIを必要としません。
ただし、pyttsx3自体は商用利用できますが、読み上げソフトが商用利用できません。

【Python】合成音声pyttsx3使い方-テキストを読み上げ

Pythonの合成音声ライブラリ「pyttsx3」の基本的な使い方とその機能について。pyttsx3は、テキストの読み上げから、音声ファイルの生成、プロパティの変更に対応します。さらに、商用利用可能（ソフトは別途）や日本語、英語に対応。

alicia-ing.com

2024.11.26

要するに、個人で合成音声を使いたい場合は、pyttsx3を使用して、
ゲームやアプリのナレーションに追加したい場合は、
Google Text-to-Speechを使う必要があります。

Google Text-to-Speechの料金（無料枠）は？

無料枠の利用では、月に400万文字（WaveNetは100万文字）まで音声合成が可能です。
それを超えた場合は従量課金制で料金が発生します。

商用利用を検討している場合、Google Cloudの料金表を確認し、
必要な予算を見積もっておくことが重要です。

料金は、使用する声の種類や文字数に依存します。
例えば、標準的な音声とWaveNet音声（より自然な音声）では料金が異なります。

WaveNet音声はより高品質ですが、その分料金が高くなります。
また、使用する言語や地域によっても料金が変動することがありますので、
事前に詳細を確認することをお勧めします。

Google Cloudの無料利用枠を活用することで、コストを抑えながらプロトタイプを作成したり、個人プロジェクトで利用する際には、無料枠で十分対応できるケースが多いです。

ビジネス規模での利用に関しては、必要な予算を正確に把握し、
適切なプランを選択することが重要です。

Google Text-to-SpeechはMP3保存できる？

Google Text-to-Speechの音声合成はをMP3形式で保存することが可能です。

Pythonからテキストを取得して、そのままMP3またはWAV形式で保存することができます。この機能を使うことで、簡単にナレーション用の音声ファイルを生成することが可能になります。

例えば、教育コンテンツやオーディオブックの自動生成にMP3保存機能を活用することができます。音声ファイルは高音質で保存され、聞き取りやすいものとなります。

また、MP3形式で保存することで、さまざまなデバイスで再生可能な音声ファイルを作成することができます。これにより、ユーザーの利便性を高めることができ、プロジェクトの成功に寄与します。

WAV形式に比べてMP3形式はファイルサイズが小さいため、
オンラインでの共有やストレージの節約にも有利です。

Pythonを使用してMP3形式に保存することで、
音声ファイルの管理が簡単になり、アプリケーションの効率的な運用が可能となります。

作成した動画にナレーションを入れたい場合、
moviepyを併用することで、簡単にナレーション音声を導入できます。

【Python】moviepyできること｜mp3・GIF編集変換

MoviePyで動画編集を自動化！Pythonでカット、結合、リサイズからGIF変換まで簡単に行えるMoviePyの基本から応用的な使い方を徹底解説。動画編集を効率化したいプログラマーやSNS素材作成に挑戦したい方におすすめのガイドです。

alicia-ing.com

2024.11.22

Google Text-to-Speechの登録方法

Google Text-to-Speechを使うにはまずGoogle Cloudのアカウントを作成します。
「Google Cloud」にアクセスして、アカウント情報や支払い方法を入力します。

Cloud Speech-to-Textを有効にして、APIを取得します。

アカウント作成

「Text-to-Speechの無料トライアル」にアクセスし、Googleアカウントを用いてログインします。

アカウント作成する際に、支払い方法を登録（クレジットカード・デビットカードなど）する必要があります。

既に、Google広告やアドセンスに登録している場合は、再度追加しなくてもよいです。

アカウント作成が完了したら、Google Cloudのさまざまなサービスを利用するための準備が整います。

プロジェクトの管理は、Google Cloudコンソールから簡単に行えます。
プロジェクトの概要や利用状況の確認、APIの有効化など、必要な操作を行うことで、プロジェクトをスムーズに進められます。

Text-to-Speechを有効にする

ハンバーガーメニューから「APIとサービス>ライブラリ」に移動して、
「Cloud Text-to-Speech API」を有効にします。

見つけることができない場合は、検索バーから探します。

APIの有効化後、実際に音声合成のリクエストを行えるようになります。APIの有効化は簡単に行うことができ、あとは必要な認証情報を設定することでPythonから操作が可能です。

.jsonのAPIを取得

サイドバーから「IAMと管理>サービスアカウント」に進み、
サービスアカウントを作成します。

詳細情報に、サービスアカウント名を設定します。
指定すると自動でサービスアカウントIDが生成されます。

そのほかの情報は省略可能ですので、そのままで大丈夫です。

作成後、「操作」の3点マークから「鍵を管理」に進みます。

「キー」タブから「鍵を追加」を選択して、
JSONファイルを作成します。

JSONファイルには、APIにアクセスするための認証情報が含まれています。

このファイルを適切に管理することで、安全にGoogle Cloudのサービスを利用することが可能です。Pythonスクリプトからこのファイルを参照することで、
音声合成のリクエストを安全に行うことができます。

PythonでGoogle Text-to-Speechを操作

Google Text-to-Speech APIをPythonで操作することで、
CSVファイルに格納したテキストを音声ファイルに変換することができます。

CSVのA列に英単語を格納してそれを一行ずつ読み込んで音声合成し、
WAVファイルとして保存することが可能です。

Pythonを使うことで、業務での自動化や学習教材の作成など、さまざまなシーンで活用できます。
特に、複数のテキストを一括で音声化したい場合に便利です。

例えば、数百行にわたるテキストデータを自動で音声ファイルに変換し、
ナレーションやガイドとして利用することができます。

手作業で音声を録音する手間を大幅に削減することができ、
生産性を向上させることができます。

また、教育機関での学習用資料の作成や、自動応答システムの開発にも応用できます。

ソースコード

import os
import csv
from google.cloud import texttospeech

# 認証情報のパスを設定
os.environ['GOOGLE_APPLICATION_CREDENTIALS'] = 'key.json'

# 音声生成関数
def generate_audio(csv_path):
    # 保存先ディレクトリをCSVファイルと同じ場所に設定
    save_directory = os.path.dirname(csv_path)

    # Google Cloud TTSクライアントの作成
    client = texttospeech.TextToSpeechClient()

    # CSVファイルの読み込み
    with open(csv_path, 'r', newline='', encoding='utf-8') as csvfile:
        reader = csv.reader(csvfile)

        # 各行のA列を順番に処理
        for index, row in enumerate(reader):
            if len(row) > 0:  # A列に値があるか確認
                word = row[0]  # A列の単語を取得

                # テキスト入力の設定
                synthesis_input = texttospeech.SynthesisInput(text=word)

                # 音声の設定（en-US-Standard-J話者を使用）
                voice = texttospeech.VoiceSelectionParams(
                    language_code="en-US",
                    name="en-US-Standard-J"
                )

                # オーディオ設定
                audio_config = texttospeech.AudioConfig(
                    audio_encoding=texttospeech.AudioEncoding.LINEAR16  # WAVフォーマット
                )

                # 音声合成のリクエスト
                response = client.synthesize_speech(
                    input=synthesis_input,
                    voice=voice,
                    audio_config=audio_config
                )

                # ファイル名をインデックスと単語で作成し、保存先パスを設定
                filename = os.path.join(save_directory, f'{index+1}_{word}.wav')

                # 音声データの保存
                with open(filename, 'wb') as out:
                    out.write(response.audio_content)
                    print(f'Saved: {filename}')

# メイン処理
if __name__ == "__main__":
    # CSVファイルのパスを指定
    csv_path = 'voice.csv'

    # ファイルが存在するか確認
    if os.path.exists(csv_path):
        generate_audio(csv_path)
        print("音声変換が完了しました。")
    else:
        print("エラー: 指定されたCSVファイルが存在しません。")

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• モジュール名

「os」：ファイルシステムのパスや環境変数を扱うために使用されている。ここでは環境変数を設定し、CSVファイルの場所を扱うために必要。
「csv」：CSVファイルを読み込むために使用される。スクリプトでは、各行のA列の内容を音声生成のために取得する必要がある。
「google.cloud.texttospeech」：Google Cloud Text-to-Speech APIを利用するために必要。音声合成のリクエストを送るために使用されている。

• フィールド（メンバ変数）

「csv_path」：CSVファイルのパスを保持する。音声生成対象のファイルの場所を指定するために必要。
「save_directory」：音声ファイルの保存先ディレクトリのパスを保持する。CSVファイルと同じ場所に音声ファイルを保存するために使用。
「client」：Google Cloud Text-to-Speech APIクライアントのインスタンス。音声合成を行うために必要。
「word」：CSVファイルのA列から読み取った単語を保持する。この単語が音声合成の対象となる。
「synthesis_input」：音声合成に使用するテキストを保持する。Google Cloud Text-to-Speech APIに渡すために作成される。
「voice」：音声の設定を保持する。使用する言語コードと話者の情報が含まれ、どの話者を使って音声を生成するか指定する。
「audio_config」：オーディオ出力の設定を保持する。生成する音声のフォーマット（WAV形式）を指定する。
「filename」：生成した音声ファイルの保存先パスを保持する。インデックスと単語を使ってファイル名を作成。

generate_audioクラス

「csv_path」からCSVファイルを読み込み、A列の単語に対して音声を生成する関数。Google Cloud Text-to-Speech APIを利用して、各単語を音声ファイル（WAV形式）に変換し、CSVファイルと同じディレクトリに保存する。
まず「save_directory」をCSVファイルのディレクトリに設定し、APIクライアント「client」を生成する。

次に、CSVファイルを読み込み、各行に対してA列の単語を取得する。取得した単語を「synthesis_input」として設定し、音声の設定「voice」とオーディオ出力の設定「audio_config」を指定して「synthesize_speech」メソッドを呼び出し、音声を生成する。

最後に、生成した音声データを「filename」に保存する。ファイル名にはインデックスと単語を使っており、保存先ディレクトリに「.wav」ファイルとして保存する。

本ソースコードでは、「voice.csv」と先に指定しているが、
Tkinterを使うことでユーザーの設定によって決めることもできる。

【Python】Tkinterエントリー作成、初期値の取得を解説

PythonのTkinterでエントリーボックス（Entry）の解説をします。配置や文字列の取得、初期値、クリアなど基本事項を解説しながらログインフォームの制作しています。

alicia-ing.com

2025.04.29

実演

スクリプトを実行すると、csv（voice.csv）にのA列にあるテキストを読み込み、
wav形式で保存します。

wavファイルの保存先は、実行したPythonのコードと同じ断層です。

まとめ

Google Text-to-Speechは、テキストを簡単に音声に変換する強力なツールです。
特にPythonと組み合わせることで、柔軟に自動音声生成を行うことが可能になります。

本記事では、APIの取得からPythonによる実装までを詳細に解説しました。
業務の効率化や教育コンテンツの作成など、さまざまな用途で活用してみてください。

Google Text-to-Speechを使うことで、ナレーション、案内、教育用途、さらには商用プロジェクトでの音声合成など、多彩なシーンで活用することができます。

また、Pythonのコードを使えば、複数のテキストを自動的に音声ファイルに変換するプロセスを効率化でき、生産性を向上させることができます。

APIの設定や実装手順は一見複雑に思えますが、
本記事を参考にすれば初めての方でも問題なく取り組むことができるでしょう。

Google Cloudの無料枠を上手に利用し、まずは個人プロジェクトから始めてみるのも良いでしょう。音声合成の楽しさと可能性をぜひ体験してみてください。

面倒な手作業をスクリプトに置き換えることで効率的に編集作業を進められるこのライブラリは、動画のカットや結合、テキスト追加からGIFへの変換まで多岐にわたる機能を提供します。

本記事では、MoviePyの基本的な使い方から応用的な操作までをわかりやすく解説します。

moviepy

MoviePyは、Pythonで動画や音声を編集するオープンソースライブラリです。

動画のカットや結合、オーバーレイ、
速度変更など多くの機能を持ち、
mp4からGIFやmp3など他の形式への変換も簡単に行えます。

自動化された動画編集ワークフローを作るのに非常に役立つツールです。

基本的な機能

MoviePyを使って、基本的な動画編集を簡単に行うことができます。
以下に、主な機能とそれぞれのコード例を紹介します。

動画のカット（トリミング）

動画の特定の部分を切り取ることで、必要なシーンだけを抽出できます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4").subclip(10, 30)  # 10秒から30秒の部分を切り取る
clip.write_videofile("output_trimmed.mp4")

input_video.mp4の10秒から30秒までの部分を切り取って、
新しい動画ファイルとして保存します。

複数クリップの結合

複数の動画を連結して1つの動画にすることも簡単です。

from moviepy.editor import VideoFileClip, concatenate_videoclips

clip1 = VideoFileClip("video1.mp4").subclip(0, 10)
clip2 = VideoFileClip("video2.mp4").subclip(5, 15)

final_clip = concatenate_videoclips([clip1, clip2])
final_clip.write_videofile("output_concatenated.mp4")

video1.mp4の最初の10秒間とvideo2.mp4の5秒から15秒の部分を結合して、
新しい動画を作成しています。

筆者

最近のYouTubeは、総集編が多いので、
これで自動編集ができる！

顔にランドマーク（3Dマスク）を付ける。

※画像の人物は、こちらからお借りしました。

Pythonで顔認識システムを作りたいと考えているけど、
どこから始めればいいか迷っている方も多いのではないでしょうか。

本記事では、CMakeとPythonを組み合わせて顔認証システムをゼロから作成する手順を解説します。
Pythonの強力なライブラリとCMakeのビルド自動化の力を駆使して、
実用的で高性能な顔認証システムを構築します。

cmakeとは

CMakeは、クロスプラットフォームのビルドシステムで、
ソースコードのコンパイルやビルドの自動化を行うツールです。

複雑なプロジェクトのビルドプロセスを簡潔にまとめて、環境に依存せずにコードを管理できる点で、
特に多くのライブラリを利用するC++プロジェクトやPython拡張モジュール開発において広く利用されています。

用途

CMakeは、主にC++プロジェクトで利用されますが、
Python拡張やライブラリのビルドにも非常に便利です。

顔認証システムのように、OpenCVやface_recognitionなどの外部ライブラリを統合するプロジェクトにおいて、CMakeを使うと環境に依存せず簡単にセットアップが可能です。

インストール方法

Python専用のライブラリを使う場合は、pipでインストールできますが、
cmakeはpipではなく、公式のウェブサイトからダウンロードします。

顔ランドマーク（3Dマスク）の検出

顔認識のさらなるステップとして、顔のランドマーク検出が重要です。

顔のランドマークとは、目、眉毛、鼻、口などの主要なパーツの位置を指します。

これにより、顔の特徴を捉えた3Dマスク風の画像処理が可能になります。
Pythonのface_recognitionライブラリを使うと、これらのランドマークを簡単に検出できます。

ソースコード

import cv2
import face_recognition
import numpy as np
from tkinter import filedialog
import os

# 画像ファイルを選択
def select_image():
    global image_path
    image_path = filedialog.askopenfilename(title="画像を選択", filetypes=[("Image files", "*.jpg;*.png")])
    if image_path:
        apply_3d_mask(image_path)

# 画像に3Dマスク風の線を付けて新しい画像として保存
def apply_3d_mask(image_path):
    image = cv2.imread(image_path)
    if image is None:
        print("画像の読み込みに失敗しました。")
        return

    # 顔のランドマークを検出
    face_landmarks_list = face_recognition.face_landmarks(image)

    if len(face_landmarks_list) == 0:
        print("顔が検出されませんでした。")
        return

    # 各顔パーツに線を描画
    for face_landmarks in face_landmarks_list:
        # 顎の輪郭に沿って線を描く
        cv2.polylines(image, [np.array(face_landmarks['chin'])], isClosed=False, color=(0, 255, 0), thickness=2)

        # 眉毛
        cv2.polylines(image, [np.array(face_landmarks['left_eyebrow'])], isClosed=False, color=(0, 255, 0), thickness=2)
        cv2.polylines(image, [np.array(face_landmarks['right_eyebrow'])], isClosed=False, color=(0, 255, 0), thickness=2)

        # 鼻
        cv2.polylines(image, [np.array(face_landmarks['nose_bridge'])], isClosed=False, color=(0, 255, 0), thickness=2)
        cv2.polylines(image, [np.array(face_landmarks['nose_tip'])], isClosed=False, color=(0, 255, 0), thickness=2)

        # 目
        cv2.polylines(image, [np.array(face_landmarks['left_eye'])], isClosed=True, color=(0, 255, 0), thickness=2)
        cv2.polylines(image, [np.array(face_landmarks['right_eye'])], isClosed=True, color=(0, 255, 0), thickness=2)

        # 口
        cv2.polylines(image, [np.array(face_landmarks['top_lip'])], isClosed=True, color=(0, 255, 0), thickness=2)
        cv2.polylines(image, [np.array(face_landmarks['bottom_lip'])], isClosed=True, color=(0, 255, 0), thickness=2)

    # 新しいファイルとして保存
    save_path = os.path.join(os.path.dirname(image_path), f"3d_mask_{os.path.basename(image_path)}")
    cv2.imwrite(save_path, image)
    print(f"3Dマスク画像が保存されました: {save_path}")

select_image()

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• モジュール名

「cv2」：OpenCVを使用して画像の読み込み、処理、保存を行うために使用。画像にランドマークを描画する際にも利用される。
「face_recognition」：顔のランドマーク（顎、眉毛、目、鼻、口など）を検出するために使用。
「numpy」：顔のランドマークの座標を配列に変換し、cv2.polylinesで使用するために利用。
「tkinter.filedialog」：ファイル選択ダイアログを使用して、画像ファイルを選択するために使用。
「os」：ファイルのパスを操作し、新しいファイルの保存先や名前を設定するために使用。

「cv2」と「face_recognition」、「numpy」はpipでインストールする必要があります。

pip install opencv-python  
pip install face_recognition  
pip install numpy  

• フィールド（メンバ変数）

「image_path」：ユーザーが選択した画像のファイルパスを保存する変数。
select_image()関数で取得され、apply_3d_mask()関数で使用される。

• select_image関数

ユーザーがファイル選択ダイアログを使用して画像ファイルを選択する

filedialog.askopenfilename()を用いて画像ファイルパスを取得し、
選択された画像が存在する場合にapply_3d_mask()関数を呼び出す。

• apply_3d_mask関数

画像を読み込みface_recognition.face_landmarks()を使用して、
顔のランドマーク（顎、眉毛、鼻、目、口）を検出する。

各ランドマークに基づいて、
cv2.polylines()で緑色の線を描画する（例：顎の輪郭や眉毛に沿った線）。

最後に、新しい画像として処理された画像を元のディレクトリに保存し、
保存先をコンソールに表示する。

実演

本スクリプトは、まずユーザーがファイル選択ダイアログを通じて画像を選び、
OpenCVを使用して画像を読み込みます。

その後、face_recognitionライブラリを使って顔のランドマーク（目、鼻、口など）を検出し、
各ランドマークに沿って線を描画します。

最終的に新しい画像として保存します。
ランドマーク検出は、リアルタイム顔認識や表情分析など、さまざまな応用に使われます。

まとめ

本記事では、CMakeを使ったPythonの顔認証システム構築の基礎から実践までを紹介しました。

CMakeを使ってプロジェクトを効率的に管理し、OpenCVやface_recognitionを活用することで、
実用的な顔認証システムを短期間で開発する方法が理解できたでしょう。

PythonとCMakeの組み合わせは、今後ますます重要なスキルとなるでしょう。

PythonでGUI（グラフィカルユーザーインターフェース）を作成するとき、Tkinterは非常に便利なライブラリです。

スライダーバーは、ユーザーがリアルタイムで数値を操作できて、matplotlibを使えば、グラフなどを動的に変化させることが可能です。

本記事では、Tkinterを使ってスライダーバーを作成し、
さらにそのスライダーでリアルタイムにグラフを操作する方法について解説します。

画面（ウィンドウ）作成

Tkinterを使って、まずは画面（ウィンドウ）を作成します。
これはTkinterの基本的な使い方であり、すべてのGUIアプリケーションの出発点です。

import tkinter as tk

# Tkinterウィンドウの作成
root = tk.Tk()
root.title("Tkinterウィンドウの作成")

# ウィンドウサイズ設定
root.geometry("400x300")

# メインループ
root.mainloop()

tk.Tk()メソッドでアプリケーションウィンドウを生成し、
その後、ウィジェット（ボタンやラベルなど）を配置していきます。

スライダーバーの作成

TkinterのScaleウィジェットを使って、スライダーバーを簡単に作成できます。
スライダーは数値の範囲を設定し、その範囲内でユーザーが値を選べるようにするUI要素です。

import tkinter as tk

# Tkinterウィンドウの作成
root = tk.Tk()
root.title("スライダーバーの作成")

# スライダーバーの作成
slider = tk.Scale(root)
slider.pack(padx=20, pady=20)

# メインループ
root.mainloop()

スライダーバーは、数値を自由に操作できるため多くの用途で役立ちます。
具体的には、以下のようなシーンで利用できます。

初期値の設定

スライダーバーには初期値を設定できます。
これにより、アプリケーションが起動した時点で、あらかじめ選択された状態が表示されます。

import tkinter as tk

# Tkinterウィンドウの作成
root = tk.Tk()
root.title("初期値の設定")

# スライダーバーの作成
slider = tk.Scale(root, from_=0, to=100, orient=tk.HORIZONTAL, label="スライダー")
slider.set(50)  # 初期値を50に設定
slider.pack(padx=20, pady=20)

# メインループ
root.mainloop()

set()メソッドを使い、スライダーバーの初期値を設定を行います。

オプション一覧（色・フォント・大きさ変更・デザインなど）

Tkinterでは、スライダーバーのデザインや外観をカスタマイズすることが可能です。
以下のオプションを用いることで、スライダーを自由に設定できます。

import tkinter as tk

# Tkinterウィンドウの作成
root = tk.Tk()
root.title("スライダーのオプション")

# スライダーバーの作成（デザイン変更）
slider = tk.Scale(root, from_=0, to=100, orient=tk.HORIZONTAL, label="スライダー", length=300, width=20, font=("Helvetica", 14), fg="blue", bg="lightgray")
slider.pack(padx=20, pady=20)

# メインループ
root.mainloop()

matplotlibグラフをスライダーで操作する

スライダーとグラフ描画の相性は高く、リアルタイムで関数が変化し、
概形の色を変えるスライダーを作成します。

【Python】グラフ操作｜x軸の範囲を対応させるgui

統計学や実験で得た数値を分析するときにグラフを作成します。表計算ソフト以外にPythonでは、実測値とそれをグラフ化するライブラリがあります。ユーザーが範囲を指定してその区間のプロット結果を出力するTkinterアプリを作成します。

alicia-ing.com

2025.08.11

ソースコード

import tkinter as tk
from tkinter import ttk
import numpy as np
import matplotlib.pyplot as plt
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg

# グラフの更新関数
def update_graph():
    a = a_slider.get()
    b = b_slider.get()
    c = c_slider.get()

    # RGB色の計算
    red = color_slider.get()
    color = f"#{red:02x}00ff"  #赤の成分

    x = np.linspace(-10, 10, 400)
    y = a * x**2 + b * x + c

    ax.clear()
    ax.plot(x, y, color=color)  # 色をスライダーで変更
    ax.set_title(f"y = {a}x^2 + {b}x + {c}")
    ax.set_xlabel("x")
    ax.set_ylabel("y")
    ax.grid()
    canvas.draw()

# Tkinterウィンドウ
root = tk.Tk()
root.title("二次関数グラフ")

fn=tk.Label(text="y=ax^2+bx+c")
fn.pack()

# スライダー用のフレームを作成
slider_frame = tk.Frame(root)
slider_frame.pack(pady=10)  #

# スライダーの作成
a_slider = tk.Scale(slider_frame, from_=-10, to=10, resolution=0.1, orient=tk.HORIZONTAL, command=lambda x: update_graph(),width=40)
a_slider.set(0)  # 初期値
a_slider.pack(side=tk.LEFT, padx=5)  # 横並びに配置

b_slider = tk.Scale(slider_frame, from_=-10, to=10, resolution=0.1, orient=tk.HORIZONTAL, command=lambda x: update_graph(),width=40)
b_slider.set(0)  # 初期値
b_slider.pack(side=tk.LEFT, padx=5)  # 横並びに配置

c_slider = tk.Scale(slider_frame, from_=-10, to=10, resolution=0.1, orient=tk.HORIZONTAL, command=lambda x: update_graph(),width=40)
c_slider.set(0)  # 初期値
c_slider.pack(side=tk.LEFT, padx=5)  # 横並びに配置

# 垂直スライダー (グラフの色変更)
color_slider = tk.Scale(root, from_=0, to=255, orient=tk.VERTICAL, command=lambda x: update_graph(),width=20, length=400)
color_slider.set(0)  # 初期値
color_slider.pack(side=tk.LEFT, padx=5)
tk.Label(root, text="グラフの色").pack(side=tk.LEFT)

# グラフ描画エリアの作成
fig, ax = plt.subplots()
canvas = FigureCanvasTkAgg(fig, master=root)
canvas.get_tk_widget().pack()

update_graph()  # 初期表示

root.mainloop()

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• モジュール名

「ttk」：tkinterの一部で、よりモダンなウィジェットスタイルを提供するために使用。
「numpy」：数値計算のためのライブラリ。np.linspaceを使用してグラフのx軸のデータを生成するために使用。
「matplotlib」：グラフ描画ライブラリ。FigureCanvasTkAggと連携して、Tkinter上でグラフを表示するために使用。

インストールには、それぞれpipを使用します。

pip install numpy
pip install matplotlib

数値解析には、様々なライブラリがあります。

【Python】 統計処理・データ分析で必要なライブラリ一覧

Pythonの統計処理で使うライブラリ「Numpy・Matplotlib・Pandas・Scipy」を紹介。さらにGoogle Colaboratoryでの処理も解説。

alicia-ing.com

2024.10.27

• フィールド（メンバ変数）

「a_slider」：二次関数の係数 a を調整するための水平スライダー。
「b_slider」：二次関数の係数 b を調整するための水平スライダー。
「c_slider」：二次関数の係数 c を調整するための水平スライダー。
「color_slider」：グラフの色（RGBの赤成分）を調整するための垂直スライダー。
「fig」：matplotlibのFigureオブジェクト。グラフ描画領域のベースとなる。
「ax」：matplotlibのAxesオブジェクト。グラフの描画や設定を行うための領域。

【Python】TkinterのLabel（ラベル）使い方

Tkinterのラベルの使い方について紹介。配置はpack()、grid()、place()３つの他、sideオプションやanchorオプションを紹介。文字の幅・高さや文字色・背景色の指定やフォントやサイズ、太さの変更も解説。

alicia-ing.com

2025.08.11

• 関数・メソッド

update_graph 関数
スライダーの値に基づいて二次関数 y = ax^2 + bx + c を描画する。以下の処理を行います。

• スライダーの値（a, b, c）を取得し、それに基づいてグラフを更新。
• x軸の値をnumpy.linspaceで生成し、y軸の値を二次関数で計算。
• スライダーから得た色の値を使用し、グラフの線の色を変更。
• matplotlibのaxをクリアして新しいグラフを描画。
• canvas.drawでTkinterウィジェット上に新しいグラフを表示。

実演

スクリプトの主要な機能は、スライダーバーを使って二次関数のグラフを操作し、
またグラフの色をリアルタイムで変更する点です。

• ウィンドウ作成：tk.Tk()でウィンドウを生成し、基本的なレイアウトを設定します。
• スライダーの生成：a_slider、b_slider、c_sliderという3つのスライダーを作成し、これらはそれぞれ二次関数の係数 a、b、cを操作します。また、color_sliderはグラフの色（RGBの赤成分）を動的に変更します。
• グラフの描画：matplotlibを使ってグラフを表示し、スライダーの値に基づいてグラフの形状が変わります。update_graph()関数はスライダーが操作されるたびに呼び出され、グラフがリアルタイムで再描画されます。
• リアルタイム更新：スライダーの値を取得し、二次関数の式に適用。さらに色もRGB値に基づいて動的に変化します。ax.clear()でグラフをクリアし、新しい値に基づいたグラフが描画されます。

まとめ

スライダーを使ったリアルタイムグラフ操作や色の動的変更などを通して、
Pythonでのアプリケーション開発の幅が広がります。
今回の例を応用すれば、データビジュアライゼーションに優れた数学ツールなどに応用が可能です。

Tkinterは、PythonでGUIアプリケーションを作成するための標準ライブラリで、リストボックス（List box）は複数のデータをユーザーに表示し、選択させるための便利なウィジェットです。

本記事では、リストボックスの基本的な使い方から値の取得、削除、選択、スクロールバーの追加など応用までを詳しく解説していきます。

画面（ウィンドウ）の作成

リストボックスを表示するために画面（ウィンドウ）を作成します。

Tkinterでは、Tk()クラスを用いてメインウィンドウを作成し、そのウィンドウの中にウィジェットを配置していきます。

import tkinter as tk

root = tk.Tk() 
root.title("リストボックス")  
root.geometry("200x150")  
root.mainloop()

リストボックスの作成

リストボックスは、Listboxクラスを使って作成します。

ユーザーが複数の項目から選択できるウィジェットで、ファイル選択やオプションの選択画面などに幅広く使われます。

listbox = tk.Listbox(root, width=40, height=10)
listbox.pack()

リストボックスを作成し、ウィンドウに配置するためにpack()メソッドを呼び出しています。
その他にも、grid()メソッドやplace()メソッドなどがあります。

リストボックスは、次のような用途に適しています。

値を取得、選択、削除

リストボックスから値を取得したり、項目を削除・選択することもできます。

#値の取得
selected_item = listbox.get(listbox.curselection())

#選択操作
listbox.select_set(0)  # 最初の項目を選択

#項目の削除
listbox.delete(0, tk.END)

リスト項目を用意して、これらをリストボックスに入れれば、追加できます。
また、項目を初期で選択しています。

import tkinter as tk

root = tk.Tk() 
root.title("リストボックス")  
root.geometry("200x150")  

listbox = tk.Listbox(root, width=40, height=10)
listbox.pack()

# リストボックスに項目を追加
items = ["Apple", "バナナ", "葡萄", "いちご"]
for item in items:
    listbox.insert(tk.END, item)

# 項目を選択
listbox.select_set(0)

root.mainloop()

スクロールバーの追加

リストボックス（listbox）の項目が多い場合、スクロールバーを追加することでユーザーが快適に操作できるようになります。

# リストボックスとスクロールバーの作成
listbox = tk.Listbox(root, width=40, height=10)
listbox.pack(side=tk.LEFT, fill=tk.BOTH)

scrollbar = tk.Scrollbar(root)
scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

# スクロールバーとリストボックスを連携
listbox.config(yscrollcommand=scrollbar.set)
scrollbar.config(command=listbox.yview)

これにより、リストボックスに縦方向のスクロールバーが連動し、リスト内の項目がスクロール可能になります。
リストボックスの枠が項目よりも多くなると、スクロールバーは解除されます。

オプション一覧（色・フォント・大きさ変更・デザインなど）

リストボックスもボタンやラベルのようにさまざまなオプションを設定できます。

# リストボックスのオプション設定
listbox = tk.Listbox(root, width=40, height=10, bg="lightblue", font=("Arial", 12), selectbackground="yellow",selectforeground="red")
listbox.pack()

エントリーの文字列をリストに追加する

エントリーボックスにユーザーが文字を入力し、
ボタン、Enterキーを押すとリストボックスに追加していきます。

【Python】Tkinterエントリー作成、初期値の取得を解説

PythonのTkinterでエントリーボックス（Entry）の解説をします。配置や文字列の取得、初期値、クリアなど基本事項を解説しながらログインフォームの制作しています。

alicia-ing.com

2025.04.29

【Python】Tkinterボタン(Button)の作成

PythonのTkinterでGUIボタンを構築する方法を紹介します。標準ボタンを作成したり配置したり、さらに色を指定して背景や文字を変更することも簡単にできます。Tkinterでアプリをつくるときには、ボタンは必須です。

alicia-ing.com

2025.03.11

また、リストボックスにスクロールバーを追加して、リストをダブルクリックすると、
ラベルにリストの文字を追加します。

【Python】Tkinterスライダーバーの使い方、グラフ操作

Tkinterでスライダーバーを使ったグラフ操作方法を解説。スライダーでリアルタイムに関数の形や色を変更できるインタラクティブなPythonアプリケーションを作成しています。

alicia-ing.com

2025.04.29

【Python】TkinterのLabel（ラベル）使い方

Tkinterのラベルの使い方について紹介。配置はpack()、grid()、place()３つの他、sideオプションやanchorオプションを紹介。文字の幅・高さや文字色・背景色の指定やフォントやサイズ、太さの変更も解説。

alicia-ing.com

2025.08.11

ダブルクリックをするには、bindでイベントを追加する必要があります。

【Python】Tkinterのbindメソッドでイベント検出

Pythonのtkinterのbindメソッドを解説。イベントハンドラとしてクリックイベントを例とし、さらにイベント一覧を紹介してます。

alicia-ing.com

2025.05.04

ソースコード

import tkinter as tk

# メインウィンドウの作成
root = tk.Tk()
root.title("リストボックス")

# エントリー（テキスト入力）の作成
entry = tk.Entry(root, width=40)
entry.pack(padx=10,pady=10)

# フレームを作成してリストボックスとスクロールバーをまとめる
frame = tk.Frame(root)
frame.pack(padx=10,pady=10)

# リストボックスの作成
listbox = tk.Listbox(frame, width=40, height=10)
listbox.pack(side=tk.LEFT)

# スクロールバーの作成
scrollbar = tk.Scrollbar(frame)
scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

# リストボックスとスクロールバーを連動させる
listbox.config(yscrollcommand=scrollbar.set)
scrollbar.config(command=listbox.yview)

# エントリーの内容をリストボックスに追加する関数
def add_listbox(event = None): 
    item = entry.get()  
    if item: 
        listbox.insert(tk.END, item) 
        entry.delete(0, tk.END)

# リストボックスの項目を全て削除する関数
def reset_listbox():
    listbox.delete(0, tk.END)  # リストボックスの全項目を削除

# ボタン用のフレームを作成
button_frame = tk.Frame(root)
button_frame.pack(pady=10)

# 追加ボタンの作成
add_button = tk.Button(button_frame, text="追加", command=add_listbox)
add_button.grid(row=0, column=0, padx=5)

# リセットボタンの作成
reset_button = tk.Button(button_frame, text="リセット", command=reset_listbox)
reset_button.grid(row=0, column=1, padx=5)
# 項目を表示するラベルの作成
label = tk.Label(root, text="input text")
label.pack(padx=10,pady=10)

# リストボックスでダブルクリックした項目をラベルに表示する関数
def item(event):
    # ダブルクリックされた項目のインデックスを取得
    selected_index = listbox.curselection()
    if selected_index:
        # 選択された項目のテキストを取得してラベルに表示
        selected_item = listbox.get(selected_index)
        label.config(text=selected_item)

# リストボックスの項目をダブルクリックした際のイベントバインド
listbox.bind("<Double-Button-1>", item)

# エントリーでEnterキーが押された時に追加するようにバインド
entry.bind("<Return>", add_listbox)

# メインループの開始
root.mainloop()

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• フィールド（メンバ変数）

「root」：メインウィンドウを保持する変数。アプリケーションのウィンドウそのものを表しています。
「entry」：ユーザーが入力するテキストフィールドの変数。ユーザーが文字列を入力できる領域を提供します。
「frame」：リストボックスとスクロールバーをまとめて配置するためのフレーム。UI要素をグループ化するためのものです。
「listbox」：複数の項目を表示するリストボックス。ユーザーが複数の項目から選択することができる要素です。
「scrollbar」：リストボックスのスクロールを制御するためのスクロールバー。
「button_frame」：追加ボタンとリセットボタンをまとめて配置するフレーム。
「add_button」：エントリーに入力されたテキストをリストボックスに追加するボタン。
「reset_button」：リストボックスの全項目を削除するボタン。
「label」：リストボックスの項目を選択した時に、そのテキストを表示するためのラベル。

• 関数・メソッド

add_listbox関数
この関数は、エントリーに入力された文字列を取得し、リストボックスに追加します。
入力が空白でない場合のみ、エントリーから文字列を取得し、
それをリストボックスの最後に追加します。

追加後、エントリーの内容をクリアします（空にします）。
イベント引数（event）は、Enterキーが押された際にも
この関数が呼び出されるように設定されています。

reset_listbox関数
この関数は、リストボックス内の全ての項目を削除します。
delete(0, tk.END)で、リストボックスの最初の項目から最後の項目まで全てを消去しています。

item関数
この関数は、リストボックス内でダブルクリックされた項目のテキストを取得、ラベルに表示します。

リストボックスの選択された項目のインデックスを取得し、
対応するテキストを取得してラベルの内容を変更します。

実演

Entryウィジェットを使用して、ユーザーがリストに追加する文字列を入力できるテキスト入力フィールドを設置します。

その後、ListboxとScrollbarを作成し、リストボックス内の項目が多くなった際にスクロールして項目を確認できるように設定します。

追加ボタンをクリックすると、入力されたテキストがリストボックスに追加され、リセットボタンを押すとリスト内の全項目が削除されます。

リストボックス内の項目をダブルクリックすると、その項目のテキストがラベルに表示される仕組みです。

まとめ

Tkinterのリストボックスを使うことで、
複数の項目を表示・選択するインターフェースを簡単に作成できます。

スクロールバーやボタンを使った追加・削除機能も加えることで、
ユーザーにとって使いやすいアプリケーションを開発可能です。

オプションを活用して、デザインや操作性を調整し、より高品質なGUIアプリを作成できます。

ラジオボタンの選択でラベルの表示・非表示にして、文字、色を変更する。

Tkinterは、Pythonに標準搭載されているライブラリで、ラジオボタンは、ユーザーに複数の選択肢から一つを選ばせる場面でよく使われます。

本記事では、Tkinterラジオボタン(radio button)をどうやって使うのか、そして複数のラジオボタンをグループ化する方法について詳しく解説します。

画面（ウィンドウ）作成

TkinterでGUIアプリを作成する際、まず最初に行うのがウィンドウの作成です。
tk.Tk()を使ってメインウィンドウを生成し、ウィンドウ内にウィジェットを配置していきます。

import tkinter as tk

root = tk.Tk()  # メインウィンドウを作成
root.title("タイトル名")  # ウィンドウのタイトルを設定
root.geometry("300x200")  # ウィンドウサイズを指定（幅x高さ）
root.mainloop()

ウィンドウの大きさやタイトルを設定することで、見た目を調整できます。

これがユーザーとのインターフェースの基盤となる部分です。

ラジオボタンの作成

ラジオボタンは、複数の選択肢から1つだけ選べるようにするためのウィジェットです。

radio = tk.Radiobutton(root, text="radio button")
radio.pack()  # ウィンドウにラジオボタンを配置

さらに、tk.Radiobutton()を使って作成し、variableオプションで選択結果を保持する変数を指定することもできます。

これにより、ユーザーがどのボタンを選択したかをプログラムで取得できるようになります。

ラジオボタンを使用する用途

ラジオボタンの用途は、多岐に広がり使用することでユーザビリティの向上につながります。

オプション一覧（色・フォントなど）

ラジオボタンを使用する際、表示されるテキストや色、フォント、大きさなどのデザインを変更することでより見やすく、使いやすいUIを作成できます。
fgで文字色、fontでフォントスタイル、padxとpadyでボタン間のスペースを調整できます。

radio = tk.Radiobutton(root, text="radio button", variable=color_var, value="radio button", fg="red", font=("Arial", 12))
radio.pack(padx=20, pady=5)

ラジオボタンを複数（グループ化）する

複数のラジオボタンをグループ化するには、共通のvariableを指定するだけで可能です。

異なる選択肢が同じ変数に関連付けられていることで、1つのグループとして扱われ、ユーザーはその中から1つだけ選択できます。

これにより、選択肢が直感的に分かりやすくなります。

colors = ["黒", "赤", "青", "緑"]
for color in colors:
    radio = tk.Radiobutton(root, text=color, variable=color_var, value=color)
    radio.pack(anchor='w')  # 左寄せで配置

配置には、anchorオプションを使います。
注意点は、左（left）ではなく、方角で西(west)を使用します。

縦、横並びの方法

ラジオボタンを縦にするには、デフォルトで列になります。

横に並べるには、pack()メソッドのsideオプションやgrid()メソッドを使います。

# 横に並べる場合
radio.pack(side='left')

これにより、複数のラジオボタンを任意のレイアウトで配置することが可能です。

初期値を指定して、選択した値に更新

ユーザーがラジオボタンを選択した後、その選択された値を取得するには、variable.get()を使用します。

variable.get()メソッドで初期値を指定します。
この値はプログラム開始時に設定したデフォルト値です。

selected_color = color_var.get(value="初期値")  # 初期値を取得

例えば、色を選択する際に最初にどの色が選ばれているか確認するために使えます。

import tkinter as tk

def show_selected():
    selected_color = color_var.get()  # 現在選択されている値を取得
    print(f"選択された色は: {selected_color}")

root = tk.Tk()  # メインウィンドウを作成
root.title("タイトル名")  # ウィンドウのタイトルを設定
root.geometry("300x200")  # ウィンドウサイズを指定（幅x高さ）

color_var = tk.StringVar(value="黒")  # 選択結果を保持する変数

# ラジオボタンの作成
radio_black = tk.Radiobutton(root, text="黒", variable=color_var, value="黒", command=show_selected)
radio_black.pack()

radio_red = tk.Radiobutton(root, text="赤", variable=color_var, value="赤", command=show_selected)
radio_red.pack()

radio_blue = tk.Radiobutton(root, text="青", variable=color_var, value="青", command=show_selected)
radio_blue.pack()

root.mainloop()

イベント処理・追加方法

既に使用していますが、ラジオボタンで選択されたときに特定の処理を実行するには、commandオプションを使用します。

これにより、ラジオボタンがクリックされたときに自動的に指定された関数が呼び出され、イベント処理が追加されます。

radio = tk.Radiobutton(root, text="赤", variable=color_var, value="赤", command=update_label)
radio.pack()

ラジオボタンの選択でラベルの表示と文字、色を変更

ラジオボタンで選択された値に応じて、ラベルのテキストや色を変更する処理を行います。選択された色を取得し、ラベルの文字を更新します。

また、特定の選択肢でラベルを非表示にすることも可能です。

ソースコード

import tkinter as tk

def update_label():
    selected_color = color_var.get()
    if selected_color == "非表示":
        label.pack_forget()  # ラベルを非表示にする
    else:
        label.config(text=f"{selected_color}色で表示しています", fg=get_color(selected_color))
        label.pack()  # ラベルを再表示する

def get_color(color_name):
    color_dict = {
        "黒": "black",
        "赤": "red",
        "青": "blue",
        "緑": "green"
    }
    return color_dict.get(color_name, "black")

# ウィンドウの設定
root = tk.Tk()
root.title("色選択アプリ")
root.geometry("300x200")

# ラジオボタンの値を保持する変数
color_var = tk.StringVar(value="黒")

# ラジオボタンの設定
colors = ["黒", "赤", "青", "緑", "非表示"]
for color in colors:
    rb = tk.Radiobutton(root, text=color, variable=color_var, value=color, command=update_label)
    rb.pack(anchor='w', padx=20, pady=5)

# ラベルの初期設定
label = tk.Label(root, text="黒色で表示しています", fg="black")
label.pack()

# ウィンドウのループ処理
root.mainloop()

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• モジュール名

「tkinter」：インストールは不要で、Pythonに標準で付属しているためすぐに使用可能です。

• フィールド（メンバ変数）

「root」：Tkウィンドウオブジェクトで、GUIアプリケーションのメインウィンドウを表します。
「color_var」：tk.StringVar()で作成され、ラジオボタンの選択した色を保持します。初期値は「黒」に設定されています。
「label」：tk.Labelオブジェクトで、選択された色のテキストを表示するためのラベルです。初期値は「黒色で表示しています」。

• 関数・メソッド

update_label関数
選択された色に基づいてラベルの表示を更新する処理を行います。
ラジオボタンで「非表示」が選択された場合、label.pack_forget()を使ってラベルを非表示にし、それ以外の色が選択された場合はlabel.config()でラベルのテキストと色を更新し、再表示します。

get_color関数
渡された色名（”黒”、”赤”、”青”、”緑”）を英語の色名（”black”、”red”、”blue”、”green”）に変換します。color_dictを使用し、該当しない場合はデフォルトで黒を返します。

実演

ラジオボタンの作成：5つのラジオボタン（黒、赤、青、緑、非表示）をウィンドウ内に作成し、それぞれの選択肢をクリックすると関数が呼び出して、ラベルと表示を更新します。

また、「非表示」が選択された場合にはラベルが非表示になる処理を実装しています。

まとめ

Tkinterを使用したラジオボタンの実装は、シンプルでありながら強力な機能を提供します。
ラジオボタンを使ったアプリケーションの構築方法を理解し、場面で活用してみてください。

PythonでGUIアプリケーションを作成するとき、ユーザーからの入力を受け取るために使用されるのが「Tkinter」のエントリーボックスです。

エントリーボックスを自由自在にカスタマイズできるようになれば、ユーザーとのやり取りをよりスムーズに行えるインターフェースが構築できるようになります。

この記事では、Tkinterのエントリーウィジェットを使って、文字列の取得や表示、エントリーボックスのサイズ変更、初期値の設定など、基本的な使い方を解説します。

画面（ウィンドウ）作成

Tkinterを使ったGUIアプリケーションは、最初に画面、つまりウィンドウを作成するところから始まります。

このウィンドウがユーザーとの対話の場となり、その上にボタンやエントリーボックスなどのウィジェットを配置していきます。

import tkinter as tk

root = tk.Tk()
root.title("Sample")
root.geometry("300x200")  # サイズを指定
root.mainloop()

ウィンドウサイズの設定やタイトルの指定など、
ユーザーにとって使いやすいデザインを作ることができます。

エントリー(Entry)作成

エントリーウィジェットは、ユーザーが文字を入力するための入力フィールドです。
Tkinterでは、Entryクラスを使って簡単に作成できます。

ここでは、エントリーボックスをウィンドウに配置、サイズや位置を調整する方法を見ていきます。

Pack()

pack()メソッドは、ウィジェットをウィンドウに配置する際に、
シンプルで自動的な位置決定を行う方法です。

entry = tk.Entry(root)
entry.pack(side=tk.TOP, padx=10, pady=10)

ウィジェットを上から順番に詰め込むように配置したい場合に使います。

grid()

grid()メソッドは、ウィジェットを行と列のグリッドに沿って配置する方法です。

entry = tk.Entry(root)
entry.grid(row=0, column=0, padx=10, pady=10)

より柔軟なレイアウトが可能で、複数のウィジェットを整理して配置したい場合に適しています。

Place()

place()メソッドは、ウィジェットをピクセル単位で正確に配置するための方法です。

entry = tk.Entry(root)
entry.place(x=50, y=50)

ウィンドウ上の特定の位置にウィジェットを置く必要がある場合に便利です。

オプション一覧（色・フォントなど）

Tkinterのエントリーボックスは、色、フォント、サイズなどをカスタマイズできます。
例えば、入力フィールドの背景色を変更したり、フォントの種類やサイズを指定することが可能です。

entry = tk.Entry(root, bg="lightblue", font=("Arial", 12), width=30)
entry.pack()

Entryウィジェットから文字列の取得・セット(初期値設定)・クリア

エントリーボックスに入力された文字列を取得するには、get()メソッドを使います。
また、insert()メソッドで初期値を設定したり、delete()メソッドで入力をクリアすることも可能です。

# 文字列の取得
text = entry.get()

# 文字列のセット
entry.insert(0, "アリッシアの朝")

# クリア
entry.delete(0, tk.END)

さらに改良をして、ボタンを押すと、テキストを取得し、エントリーの文字を削除するようにします。

【Python】Tkinterボタン(Button)の作成

PythonのTkinterでGUIボタンを構築する方法を紹介します。標準ボタンを作成したり配置したり、さらに色を指定して背景や文字を変更することも簡単にできます。Tkinterでアプリをつくるときには、ボタンは必須です。

alicia-ing.com

2025.03.11

【Python】TkinterのLabel（ラベル）使い方

Tkinterのラベルの使い方について紹介。配置はpack()、grid()、place()３つの他、sideオプションやanchorオプションを紹介。文字の幅・高さや文字色・背景色の指定やフォントやサイズ、太さの変更も解説。

alicia-ing.com

2025.08.11

import tkinter as tk

def display_text():
    # エントリーから文字を取得
    text = entry.get()
    # ラベルに表示
    label2.config(text=text)
    # エントリーをクリア
    entry.delete(0, tk.END)

root = tk.Tk()
root.title("Sample")
root.geometry("300x200")  # サイズを指定

# ラベル 
label1 = tk.Label(root, text="名前を入力してください")
label1.pack(pady=10)

# エントリーウィジェット
entry = tk.Entry(root)
entry.insert(0, "アリッシアの朝")
entry.pack(pady=10)

# ボタン
button = tk.Button(root, text="取得", command=display_text)
button.pack(pady=10)

# ラベル (取得した文字を表示するため)
label2 = tk.Label(root, text="")
label2.pack(pady=10)

root.mainloop()

ユーザーにとって使いやすいインターフェースを作ることができます。

入力値をリアルタイムで表示

ユーザーがエントリーボックスに入力した内容をリアルタイムで、画面に反映させる方法について解説します。

def show_input(*args):
    print(entry.get())

entry_var = tk.StringVar()
entry_var.trace("w", show_input)

entry = tk.Entry(root, textvariable=entry_var)
entry.pack()

traceメソッドを使って、入力が変更されるたびに反応する仕組みを作ることができます。

print()をラベルに変更して、Tkinter上に表示させることも可能です。

Enter(Return)キーで入力値を取得

ユーザーが入力を終えた後、Enterキーを押したタイミングでエントリーボックスから入力値を取得する方法を紹介します。

def on_enter(event):
    print("入力値:", entry.get())

entry.bind("<Return>", on_enter)

bindを使うことでイベントを追加できます。

【Python】Tkinterのbindメソッドでイベント検出

Pythonのtkinterのbindメソッドを解説。イベントハンドラとしてクリックイベントを例とし、さらにイベント一覧を紹介してます。

alicia-ing.com

2025.05.04

これにより、フォーム送信や次の処理に進む操作を自然な形で実現できます。

Pythonでログインフォームを作成する

Pythonでログインフォームを作るには、TkinterのEntryが有効です。

【Python】Tkinter画面遷移-複数ウィンドウをクラス化

Tkinterの複数ウィンドウを画面遷移するには、pack_forget()メソッドを使います。ボタンでクリックすると表示と非表示をして画面切り替えをします。複雑な画面遷移は、def関数では読みにくいのでクラス化して可読性を上げます。

alicia-ing.com

2025.03.10

ソースコード

import tkinter as tk
from tkinter import messagebox
import re

# 初期の正しいユーザー名とパスワード
initial_username = "アリッシア"
initial_password = "Alicia-ing"

# グローバル変数を使ってパスワードを更新可能にする
current_password = initial_password

# パスワードのバリデーション関数
def validate_password(password):
    # 大文字、小文字、記号を含むかチェック
    if (re.search(r'[A-Z]', password) and  # 大文字
        re.search(r'[a-z]', password) and  # 小文字
        re.search(r'[\W_]', password)):    # 記号
        return True
    else:
        return False

# 画面Aのログイン処理
def login():
    global current_password
    username = entry_username.get()
    password = entry_password.get()

    if username == "" or password == "":
        message_label.config(text="入力を完了してください", fg="red")
    elif username != initial_username or password != current_password:
        message_label.config(text="パスワードが異なります", fg="red")
        entry_username.delete(0, tk.END)  # 入力フィールドをクリア
        entry_password.delete(0, tk.END)  # 入力フィールドをクリア
    else:
        # 画面Bへ遷移
        open_screen_b(username)

# 画面Bを開く関数
def open_screen_b(username):
    screen_a.withdraw()  # 画面Aを非表示にする
    screen_b = tk.Toplevel()  # 新しいウィンドウ（画面B）
    screen_b.title("画面B")
    screen_b.geometry("300x200")  # 画面サイズの指定

    label_greeting = tk.Label(screen_b, text=f"Hello, {username}", font=("Arial", 14))
    label_greeting.pack(pady=10)

    label_new_password = tk.Label(screen_b, text="新しいパスワード:")
    label_new_password.pack(pady=5)

    new_password_entry = tk.Entry(screen_b)
    new_password_entry.pack(pady=5)

    # エンターキーが押されたらパスワード変更を実行
    new_password_entry.bind("<Return>", lambda event: change_password())

    def change_password():
        new_password = new_password_entry.get()
        if validate_password(new_password):
            global current_password
            current_password = new_password  # パスワードを更新
            messagebox.showinfo("成功", "パスワードが変更されました")
            screen_b.destroy()  # 画面Bを閉じる
            screen_a.deiconify()  # 画面Aを再表示する
        else:
            messagebox.showerror("エラー", "もう一度作成してください (大文字, 小文字, 記号を含む必要があります)")

    change_button = tk.Button(screen_b, text="変更", command=change_password)
    change_button.pack(pady=20)

# メインウィンドウ（画面A）
screen_a = tk.Tk()
screen_a.title("ログイン画面")
screen_a.geometry("300x250")  # 画面サイズの指定

# ユーザー名入力フィールド
label_username = tk.Label(screen_a, text="ユーザー名:")
label_username.pack(pady=5)

entry_username = tk.Entry(screen_a)
entry_username.pack(pady=5)

# パスワード入力フィールド
label_password = tk.Label(screen_a, text="パスワード:")
label_password.pack(pady=5)

entry_password = tk.Entry(screen_a, show="*")  # パスワード非表示
entry_password.pack(pady=5)

# メッセージラベル（エラーメッセージ表示用）
message_label = tk.Label(screen_a, text="")
message_label.pack(pady=5)

# ログインボタン
login_button = tk.Button(screen_a, text="ログイン", command=login)
login_button.pack(pady=20)

screen_a.mainloop()

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• モジュール名

「tkinter」：Pythonの標準ライブラリで、GUIアプリケーションを作成するために使用。「tkinter.messagebox」：GUIアプリケーション内で情報やエラーメッセージを表示するダイアログボックスを提供する。
「re」：正規表現を利用した文字列のパターンマッチングを行うために使用。パスワードのバリデーションに活用されている。

• フィールド（メンバ変数）

「initial_username」：初期の正しいユーザー名を保持する変数。ログイン時にユーザー入力と比較するために使用。
「initial_password」：初期の正しいパスワードを保持する変数。ログイン時にパスワード入力と比較するために使用。
「current_password」：現在のパスワードを保持するグローバル変数。パスワード変更後に更新され、ログイン時に使用される。
「screen_a」：ログイン画面（画面A）のウィンドウオブジェクトを保持。GUIのメインウィンドウを表す。
「screen_b」：パスワード変更画面（画面B）のウィンドウオブジェクト。ログイン成功後に新たに作成される。
「entry_username」：ユーザー名を入力するテキストフィールド。ユーザーがログイン時に使用する。
「entry_password」：パスワードを入力するテキストフィールド。ユーザーがログイン時に使用する。
「message_label」：ログイン時のエラーメッセージや案内メッセージを表示するためのラベル。

• クラス（関数・メソッド）

「validate_password」関数
正規表現を使用して、入力されたパスワードが大文字、小文字、記号を含むかをチェックし、条件を満たす場合にTrueを返す。それ以外の場合はFalseを返す。

「login」関数
処理の説明を文章にする。
ユーザーが入力したユーザー名とパスワードを検証する。入力が空の場合や不正な組み合わせの場合には、エラーメッセージを表示する。正しいユーザー名とパスワードが入力された場合は、画面Bに遷移する。

「open_screen_b」関数
画面Aを非表示にして、新しいウィンドウ（画面B）を表示し、ユーザーに挨拶メッセージと新しいパスワードを入力させる。パスワード変更のための処理もこの関数内で行われる。

「change_password」関数
ユーザーが入力した新しいパスワードが「validate_password」で有効かを確認し、有効な場合は現在のパスワードを更新し、画面Bを閉じて画面Aを再表示する。無効な場合はエラーメッセージを表示する。

実演

ログイン画面が表示されて、ユーザーが入力した情報に基づいて次の画面に遷移する処理を行います。

エントリーウィジェットにユーザー名とパスワードを入力し、それを検証します。
もし正しいユーザー名とパスワードが入力されると、次の画面が表示され、
パスワードを変更できるようになります。

まとめ

Tkinterを使ってエントリーボックスを作成し、文字列の取得やセット、クリア、そしてリアルタイムでの表示といった操作を行う方法について学びました。
エントリーウィジェットは、ユーザーとのインタラクションを強化するために欠かせない要素です。

Pythonでテキストを音声として読み上げたいときには、
オフラインで動作する合成音声ライブラリ「pyttsx3」を使うと便利です。

このライブラリは、簡単にテキストを音声に変換でき、速度や音声の種類も調整可能です。
プログラムにナレーションを追加したり、読み上げアプリを開発したりする際に活躍します。

本記事では、pyttsx3の基本的な使い方から、商用利用の可否や対応言語について詳しく解説します。
公式サイト：「Pyttsx3公式ページ」

pyttsx3とは？

pyttsx3は、Python用のテキスト読み上げライブラリで、
コンピュータのローカルで音声合成を行います。

インストールは、コマンドプロンプト、ターミナルでできます。

pip install pyttsx3

WindowsではSAPI5、MacOSではNSSpeechSynthesizer、Linuxではespeakを使用しており、
さまざまなプラットフォームで簡単に利用できます。pyttsx

また、音声速度や音量、性別の調整が可能で、カスタマイズ性が高い点も特徴です。

音声の読み上げ

テキストをリアルタイムで音声として再生できます。
say()メソッドにテキストを入力し、runAndWait()メソッドで実行します。

import pyttsx3

# エンジンの初期化
engine = pyttsx3.init()

# 読み上げるテキスト
engine.say("Hello, I am reading this text.")

# 読み上げ実行
engine.runAndWait()

音声のプロパティ変更

音声の再生速度、音量、音声の性別など、細かいプロパティを変更できます。
カスタマイズした音声合成が可能です。

速度150で音量90%、男性の声で「Hello alicia-ing」と読み上げます。

import pyttsx3

engine = pyttsx3.init()

# 音量の設定（0.0 から 1.0）
engine.setProperty('volume', 0.9)

# 速度（WPM: words per minute）
engine.setProperty('rate', 150)

# 音声（性別）の変更
voices = engine.getProperty('voices')
engine.setProperty('voice', voices[0].id)  # 男性の声
#engine.setProperty('voice', voices[1].id)  # 女性の声

engine.say("Hello alicia-ing")
engine.runAndWait()

音声の保存

テキストを音声ファイル（WAV形式）として保存することができます。
save_to_file()メソッドを使用して、音声をファイルに書き出すことが可能です。

ただし、mp3ファイルは非対応です。

text= "Hello alicia-ing"
engine.save_to_file(text , 'voice.wav')

イベント制御

読み上げ開始、終了時にイベントをトリガーにして、プログラムを処理する。

再生が開始したら、「Start」とログを出力し、
再生が終了したら、「製作者と終わった時間」を取得して、ログに出力する。

import pyttsx3
from datetime import datetime

def onStart(name):
    print("Start")

def onEnd(name, completed):
    end_time = datetime.now().strftime("%H:%M:%S")  # 再生終了時刻を取得
    print(f"End, presented: {name}, completed at: {end_time}")

engine = pyttsx3.init()

# イベントの接続
engine.connect('started-utterance', lambda name: onStart("Alicia"))
engine.connect('finished-utterance', lambda name, completed: onEnd("Alicia", completed))

# 読み上げの設定と実行
engine.say("This will trigger events.")
engine.runAndWait()

商用利用可能か？

pyttsx3はオープンソースライブラリであり、商用利用も可能です。

ただし、音声エンジンに依存する部分もあるため、
合成音声エンジン自体のライセンス条件を確認する必要があります。

そのため、商用利用可能なGoogle-Text-to-Speechがおすすめです。
APIを取得すれば、Pythonからも操作できます。

【Python】Google-Text-to-SpeechのAPIを取得し発話

Google Text-to-SpeechのAPIをPythonで操作する方法を解説。商用利用や料金、音声のMP3保存についても詳しく紹介しています。APIの設定方法から実際の音声生成までカバーし、あらゆる用途で役立つ情報を提供します。

alicia-ing.com

2024.11.25

対応している言語は？

pyttsx3は、使用する音声エンジンに依存して、様々な言語に対応しています。
具体的には、英語、日本語、フランス語、ドイツ語など、多くの言語で音声合成が可能です。

ただし、エンジンやOSによっては、言語のサポート状況が異なります。

筆者

Windowsでは、英語、日本語、フランス語はできた。ドイツ語もできたが英語？ってなった。
韓国語は発音できず、中国語は違う気がした。

• PDFファイルを結合する。

• PDFを１ページずつ分割する。

Pythonを使えば、複数のPDFファイルを1つに結合とPDFファイルを１つずつ分割することが簡単にできます。

本記事では、PyPDF2ライブラリを使用してPDFを分割や結合などの操作を実行する方法を詳しく解説します。

PyPDF2の機能と使う場面

PyPDF2は、PythonでPDFファイルを操作するためのライブラリです。

PDFの結合

import PyPDF2

# PDFファイルを読み込む
pdf1 = open('document1.pdf', 'rb')
pdf2 = open('document2.pdf', 'rb')

# PdfMergerオブジェクトを作成
merger = PyPDF2.PdfMerger()

# PDFファイルを追加
merger.append(pdf1)
merger.append(pdf2)

# 結合されたPDFをファイルとして書き出し
with open('new_document.pdf', 'wb') as output:
    merger.write(output)

# リソースを解放
pdf1.close()
pdf2.close()
merger.close()

PDFファイルをページ単位で分割

import PyPDF2

# 分割するPDFファイルを開く
input_pdf = open('document.pdf', 'rb')

# PdfReaderオブジェクトを作成
reader = PyPDF2.PdfReader(input_pdf)

# 分割されたページを新しいPDFファイルとして保存
for i in range(len(reader.pages)):
    writer = PyPDF2.PdfWriter()
    writer.add_page(reader.pages[i])

    with open(f'page_{i+1}.pdf', 'wb') as output_pdf:
        writer.write(output_pdf)

# リソースを解放
input_pdf.close()

ページの抽出

import PyPDF2

# 抽出するPDFファイルを開く
input_pdf = open('document.pdf', 'rb')

# PdfReaderオブジェクトを作成
reader = PyPDF2.PdfReader(input_pdf)

# 抽出するページ（1ページ目）
page = reader.pages[0]

# 新しいPDFファイルに抽出したページを追加
writer = PyPDF2.PdfWriter()
writer.add_page(page)

# 抽出したページを保存
with open('extracted_page.pdf', 'wb') as output_pdf:
    writer.write(output_pdf)

# リソースを解放
input_pdf.close()

PDFのメタデータを読み取る

import PyPDF2

# PDFファイルを開く
input_pdf = open('document.pdf', 'rb')

# PdfReaderオブジェクトを作成
reader = PyPDF2.PdfReader(input_pdf)

# メタデータを取得
metadata = reader.metadata

# メタデータを表示
print(metadata)

# リソースを解放
input_pdf.close()

フォルダー内すべてのPDFを1つに結合

ユーザーが選択したフォルダー内のすべてのPDFファイルを結合し、1つのPDFファイルとして保存します。

Tkinterを使用してフォルダー選択ダイアログを表示し、選択されたフォルダー内のPDFファイルをPyPDF2のPdfMergerクラスで結合します。

ソースコード

import os
from PyPDF2 import PdfMerger
from tkinter import Tk, filedialog

# Tkinterを使用してフォルダー選択ダイアログを表示
root = Tk()
root.withdraw()  # メインウィンドウを表示しないようにする
folder_path = filedialog.askdirectory()

if folder_path:
    # フォルダー名を取得
    folder_name = os.path.basename(folder_path)

    # PdfMergerオブジェクトを作成
    merger = PdfMerger()

    # フォルダー内のすべてのPDFファイルを取得し、結合
    for filename in os.listdir(folder_path):
        if filename.endswith('.pdf'):
            file_path = os.path.join(folder_path, filename)
            merger.append(file_path)

    # 結合されたPDFファイルの保存
    output_path = os.path.join(folder_path, f'{folder_name}.pdf')
    merger.write(output_path)
    merger.close()

    print(f"結合されたPDFファイルが{output_path}に保存されました。")
else:
    print("フォルダーが選択されませんでした。")

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• モジュール名

「os」：ファイルパスの操作やフォルダーのリストを取得します。
「PyPDF2」：PDFファイルの読み取りおよび書き込みを行います。
「tkinter」：GUIを使用してフォルダー選択ダイアログを表示します。

PyPDFは、標準ライブラリではないので、インストール必要があります。
コマンドプロンプト（Windows）に入力して、実行します。

pip install PyPDF2

• フィールド（メンバ変数）

「root」：Tkinterのメインウィンドウオブジェクト。GUIダイアログの親ウィンドウとして機能する。
「folder_path」：ユーザーが選択したフォルダーのパス。
「folder_name」：選択したフォルダーの名前。
「merger」：PDFファイルを結合するためのPdfMergerオブジェクト。
「output_path」：結合されたPDFファイルの保存先パス。

• それぞれのクラス（関数・メソッド）

PdfMergerクラス
PDFファイルを結合するためのオブジェクトを提供します。
ファイルを追加していき、最終的に1つのPDFファイルとして出力します。

Tkクラス
Tkinterのメインウィンドウオブジェクトを作成します。
GUIアプリケーションの基本ウィンドウとして機能します。

filedialog.askdirectoryメソッド
フォルダー選択ダイアログを表示し、
ユーザーが選択したフォルダーのパスを取得します。

os.path.basenameメソッド
指定されたパスからフォルダー名を取得します。

os.listdirメソッド
指定されたフォルダー内のファイルとサブフォルダーのリストを取得します。

merger.appendメソッド
指定されたPDFファイルを結合するために追加します。

merger.writeメソッド
結合されたPDFファイルを指定されたパスに保存します。

merger.closeメソッド
PdfMergerオブジェクトを閉じてリソースを解放します。

実演

フォルダー選択ダイアログが表示されるので、結合したいPDFファイルが含まれているフォルダーを選択します。

選択されたフォルダー内のすべてのPDFファイルが結合され、新しいPDFファイルとして保存されます。

フォルダー内のPDFを1ページずつ分割

次にユーザーが選択したフォルダー内のすべてのPDFファイルを各ページごとに分割し、個別のPDFファイルとして保存します。

フォルダー内の各PDFファイルを読み込み、それぞれのページを新しいPDFファイルとして保存します。

ソースコード

import os
from PyPDF2 import PdfReader, PdfWriter
from tkinter import Tk, filedialog

# Tkinterを使用してフォルダー選択ダイアログを表示
root = Tk()
root.withdraw()  # メインウィンドウを表示しないようにする
folder_path = filedialog.askdirectory()

if folder_path:
    # 出力用のフォルダーを作成
    output_folder = os.path.join(folder_path, 'split_pages')
    os.makedirs(output_folder, exist_ok=True)

    # フォルダー内のすべてのPDFファイルを処理
    for filename in os.listdir(folder_path):
        if filename.endswith('.pdf'):
            file_path = os.path.join(folder_path, filename)
            pdf = PdfReader(file_path)

            # 各ページを個別のPDFファイルとして保存
            for page_num in range(len(pdf.pages)):
                pdf_writer = PdfWriter()
                pdf_writer.add_page(pdf.pages[page_num])

                # 新しいPDFファイル名を作成
                output_filename = os.path.join(output_folder, f'{os.path.splitext(filename)[0]}_page_{page_num + 1}.pdf')
                with open(output_filename, 'wb') as output_pdf:
                    pdf_writer.write(output_pdf)

    print(f"分割されたPDFファイルが{output_folder}に保存されました。")
else:
    print("フォルダーが選択されませんでした。")

解説

上記と同じモジュールとフィールドは省略します。

• フィールド（メンバ変数）

「filename」：現在処理中のPDFファイルの名前。
「file_path」：現在処理中のPDFファイルのフルパス。
「pdf」：現在読み込まれているPDFファイルのPdfReaderオブジェクト。
「page_num」：現在処理中のページ番号。
「pdf_writer」：新しいPDFファイルを作成するためのPdfWriterオブジェクト。
「output_filename」：分割された各ページのPDFファイル名。

• それぞれのクラス（関数・メソッド）

PdfReaderクラス
PDFファイルを読み取るためのオブジェクトを提供します。
PDFファイルを開いてページごとの情報にアクセスできます。

PdfWriterクラス
PDFファイルを作成するためのオブジェクトを提供します。
ページを追加して新しいPDFファイルとして保存します。

os.path.joinメソッド
複数のパスコンポーネントを結合して1つのパスを作成します。

os.makedirsメソッド
指定されたパスにディレクトリを作成します。
exist_ok=Trueオプションを指定することで、すでに存在する場合でもエラーを発生させません。

os.listdirメソッド
指定されたフォルダー内のファイルとサブフォルダーのリストを取得します。

pdf_writer.add_pageメソッド
PdfWriterオブジェクトにページを追加します。

pdf_writer.writeメソッド
PdfWriterオブジェクトの内容を指定されたファイルに書き込みます。

os.path.splitextメソッド
ファイル名と拡張子を分割します。

実演

フォルダー選択ダイアログが表示されるので、分割したいPDFファイルが含まれているフォルダーを選択します。

選択されたフォルダー内のすべてのPDFファイルがページごとに分割され、新しいPDFファイルとして保存されます。

まとめ

この記事では、Pythonを使ってPDFファイルを結合および分割する方法を紹介しました。
PyPDF2ライブラリを使用することで、これらの操作を簡単に実行できます。

業務効率化や資料管理の向上に有効となります。