カスタムフォント機能インターフェース

目的：CustomFont クラスのメソッドをすばやく理解できるよう、クラスのメソッド、パラメータ、戻り値、使用例を紹介し、開発に役立てます。

クラス概要

CustomFont クラスは、ターミナルのテキストの色やスタイルを整形するためのユーティリティクラスで、定義済みのメッセージ情報と色付きテキストの出力機能を提供します。

コンストラクタ

`CustomFont()`

カスタムフォントオブジェクトを初期化し、定義済みのメッセージ内容を設定します。

パラメータ ：なし 戻り値 ：CustomFont インスタンス

例：

python

font = CustomFont()

属性一覧

定義済みメッセージ

以下の属性には整形済みのテキスト情報が含まれており、そのまま出力に使用できます：

compony_msg：会社情報と著作権表示
imu_load_success：ジャイロスコープの読み込み成功メッセージ
arm_load_success：ロボットアームの初期化完了メッセージ
font_load_success：カスタムフォントの初期化完了メッセージ
ps2_load_success：PS2 コントローラーの初期化完了メッセージ
ps2_arm_common：PS2 コントローラーの操作説明（図付き）

例：

python

font = CustomFont()
print(font.arm_load_success)  # 打印机械臂初始化完成提示

メソッド一覧

`color_text(text, color=None, bg_color=None, bold=False, underline=False)`

文字色、背景色、太字、下線のスタイルを付けてターミナルにテキストを出力します。

パラメータ ：

text (str)：整形するテキスト内容
color (str, 省略可)：文字色。指定可能な値："black" , "red" , "green" , "yellow" , "blue" , "magenta" , "cyan" , "white"
bg_color (str, 省略可)：背景色。指定可能な値は color パラメータと同じです
bold (bool, 省略可)：太字にするかどうか。デフォルトは False
underline (bool, 省略可)：下線を付けるかどうか。デフォルトは False

戻り値 ：str - 整形済みのテキスト文字列（ANSI エスケープシーケンスを含む）

例：

python

font = CustomFont()

# 红色文本
print(font.color_text("错误信息", color="red"))

# 绿色粗体文本
print(font.color_text("成功信息", color="green", bold=True))

# 蓝色背景的黄色文本
print(font.color_text("警告信息", color="yellow", bg_color="blue"))

# 带下划线的洋红色文本
print(font.color_text("链接文本", color="magenta", underline=True))

# 白色粗体带下划线的文本，红色背景
print(font.color_text("重要提示", color="white", bg_color="red", bold=True, underline=True))

使用例

完全な例

python

from custom_font import CustomFont

# 初始化自定义字体
font = CustomFont()

# 打印公司信息
print(font.compony_msg)

# 打印各模块加载成功信息（带颜色）
print(font.color_text(font.imu_load_success, color="green"))
print(font.color_text(font.arm_load_success, color="blue", bold=True))
print(font.color_text(font.font_load_success, color="cyan"))
print(font.color_text(font.ps2_load_success, color="magenta"))

# 打印PS2操作说明
print(font.ps2_arm_commond)

# 自定义彩色提示信息
print(font.color_text("=== 系统启动完成 ===", color="green", bold=True))
print(font.color_text("警告：请勿在运行时断电！", color="red", bold=True))
print(font.color_text("提示：使用PS2手柄控制机械臂", color="yellow"))

出力結果の例

ターミナルには次のように表示されます：

会社情報のバナー
各モジュールの読み込み成功を示す色付きメッセージ
PS2 コントローラー操作の詳細な図解
カスタムカラーのステータス情報