・ readme.txt (はじめにお読みください。)

・ソフトウェア名		： Masaki Radio Notificator
・バージョン　	　　　　	： 1.03
・ライセンス　　　		： フリーソフト (寄付歓迎)
・作者名			： Masaki
・転載/掲載について		： 事前でも事後でも構いませんので
		　　　　   　 　 　ご連絡いただけますと幸いです。
・動作確認済みOS		： Windows(R) 7/ 8/ 10(22H2)
・作者ホームページアドレス	： https://masaki.mydns.jp/
・作者連絡先メールアドレス	： soft_report(at)masaki.mydns.jp
　　　　　　　　　　　　　　 	　 ※ (at)を@に置き換えてください。

・はじめに。
　当ソフトウェアをご使用、もしくはダウンロードいただきまして誠にありがとうございます。
　ラジオ番組のデータベースを作成したものを読み込んで画面上に表示(通知)するソフトウェアです。
　ポケットラジオやネットラジオを聴いていて、お気に入りの番組の時間が来たら表示するものが
　作りたいなぁと、前々から思っていたのでこのようなソフトウェアを制作しました。
　各ラジオ局で公開されている番組表の情報を、放送局の公式サイトなどでPDF形式で配布されている
　場合や、画像などで一週間分の番組表を配布しているページより(放送局によっては公開してない場合もあり)、
　ご自身で番組情報を入力していただく必要があるのですが…、お役にたてましたら幸いです。

　メンテナンス面でも・・と試行錯誤を重ねまして、表計算ソフトウェアなどでに気軽に編集を重視しておりまして
　CSV形式の読み込みに対応しています。

・ファイル構成について。
　ZIPアーカイブを展開しますと、以下の3つのファイルが存在することをご確認ください。
 　　 　　mskrnc.exe　・・・・・　ソフトウェア本体です。
 　　 　　readme.txt　・・・・・　今お読みになっている説明書です。
      msk_sample.csv　・・・・・　番組用データベースのサンプルです。 

　以下のファイルは、ソフトウェアの終了時に自動的に設定情報ファイルとして保存されます。
　※ファイルが存在しなくても、自動的に生成されます。
 　　mskrnc_conf.ini　・・・・・　設定ファイルです。

・使い方
　.csvファイルの作成がまだの場合：
　次の章の、「データベースの作成について」をご参照いただけましたら幸いです。

　.csvファイルを作成済みの場合: 
　画面上部の「番組データベース選択(CSV)」というボタンをクリックして、
　作成済みの.csvファイルを選ぶだけで後は、自動的に番組データベースを読み込みますので
　あとは、そのままです。放送時間が来ると画面上に入力された番組情報が表示されます。

・データベースの作成について。
　表計算ソフトなどでも編集しやすいように .csvファイル形式のものをデータベースという
　扱いで当ソフトウェアでは使用しています。
　番組表データベースのフォーマットは以下の通りとなっております。

曜日,放送局名,時刻,番組名,出演者,画像ファイル名,コールサイン等,コメント,
　�@　　�A　　 �B　　�C　　　�D　　　　�E　　　　　�F　　　　　　�G

*�@: 放送されている番組の曜日です: 月曜日〜日曜日で 月曜の場合、月曜日と入力してください。
*�A: 放送局の名前です。
*�B: 番組が放送されている時間帯です、例えば0時〜2時までの放送の場合のフォーマットは
　　以下の通りとなっております。区切り文字は  - ハイフンです。（半角のみ対応しています）
　　例  00:00-02:00  
　　放送局によっては、29時間などの表記(例えば、26時なら 翌日の午前2時)を使うところも多いので
　　そういった時間表記にも対応しています。(0時〜29時まで。)

*�C　放送されている番組名です。
*�D　放送されている番組のパーソナリティの方の名前を入力します。
 �E　放送されている番組でバナー画像がある場合は、保存されている場所を指定すると画面に表示されます。
　　 フルパスとファイル名のみに対応しておりますが、
　　 フルパスで入力されている場合、その場所から読み込みますが、
　　 ファイル名のみの場合、このソフトウェアのある同じディレクトリから読み込みを行います。
　　 
 �F　放送局の呼出符号(コールサイン)です、入力してもしなくても構いませんが雰囲気がでます。 
 �G　コメント欄です。注釈など。。

*: 入力することを推奨していますが、曜日と時刻以外は、ご使用になる方のお好みで
　 ご自由に入力くださいませ。

　例で表しますと、

　日曜日,放送局名,06:00-06:15,番組名称,パーソナリティや出演者名,,コールサイン・周波数など,コメントです。,

　となります。
　ソフト側の処理では、曜日(例: 月曜日)などで始まっていない場合や、空欄の場合はコメント行として扱われますので
　その行は無視されますが、ほかにも;などで始まる行はコメント文として扱っています。
　月曜日の場合、月だけ書くと無視されますので、大変お手数ですが月曜日と入力をお願いします。
　サンプルファイルも添付しておりますので、msk_sample.csvをご参照くださいませ。

・極端に長い文字の場合…。
　各項目で入力された文字が長い場合、画面に収まらない場合は自動的に改行を行います。
　それでも、各項目ではみ出る可能性のあるほど長い場合は、それ以降の文字は表示されません。

・画像ファイルについて。
　画像ファイルは、フルパスによる指定もしくは、ファイル名指定に対応しています。
　フルパスの場合、 d:\joqr_pic.jpg 
　ファイル名指定の場合、   joqr_pic.jpg 
　という感じですが、画像ファイル名だけでの指定の場合
　このソフトウェアのある同じディレクトリから読み出しされますので、
　ソフトウェアが d:\radio\mskrnc.exe に存在したとします。
　その場合は、ファイル名のみの場合 obc_pic.jpgは、 d:\radio\のフォルダから
　読み込みしようとしますので、ご注意ください。
　フルパスの場合はその指定した場所から読み込みます。

　番組バナー用の画像ファイルは、アスペクト比を維持したままの状態で
　縦長の画像は、ソフトの中央部分に表示されますが、
　横長の画像は、中央よりではなく左寄りで、他の番組情報と同じような感じに表示されます。
　画像の大きさによっては、中央揃え(センタリング)されます。

・同じ時間帯に複数の放送がある場合の仕様と代替画像についてなど。
　数秒毎に同じ時間帯の番組情報を切り替えて表示します。
　同じ時間に複数の番組が放送されている場合などで、2つ番組が放送されている場合は、
　１つ目の番組を表示→数秒待機→2つ目の番組を表示→数秒待機
　のあと、また１つ目の番組からといった感じで番組情報の表示の切り替え動作を繰り返します。
　目安として、約20秒毎に切り替えます。
　※ データベースファイルも番組情報の描画頻度と同じく、HDDやSSDの負荷を考えて
　毎秒ではなく10秒に一度のときにファイルの読み込みが行われます。
　CSVファイルを更新した場合、「番組情報リロード」というボタンをクリックすると
　手動でデータベースファイルを再読込します。

・代替画像の読み込み・描画について。
　データベースに登録されている番組で、その時間帯で放送されていないときに
　表示する代替画像で表示できる画像サイズは X: 580px Y: 450px です。
　極端に大きいものや、小さいものであっても、指定された画像は自動的に
　アスペクト比は維持したままの状態で画面に表示されます。
　代替画像の読み込みは、ソフトウェアを起動したときか、設定画面でOKをクリックした際に
　フォルダから読み込んだ画像ファイルをバッファにキャッシュします。
　必要であれば、毎回フォルダから読まずにバッファから読み出しをするようになっています。

・メニューバーについて。

　ファイル(F)
　タスクトレイに常駐する (T) : タスクトレイにトレイアイコンを表示し常駐した状態で動作を継続します。
　　  ソフトウェアの終了 (Q) : ソフトウェアを終了します。

 　・タスクトレイでの常駐時。
　　トレイアイコンを左クリックで元のメイン画面を表示します。
　　右クリックで、ポップアップメニューを表示します。

　　・タスクトレイアイコンを右クリックした時のトレイメニュー。
　　メイン画面を表示する(V)  : タスクトレイでの常駐状態を解除して元のメイン画面を表示します。
　　　　設定を表示(C)　　　　: 設定画面を表示します。
　　ソフトウェアの終了(Q)　　: ソフトウェアを終了します。

・設定画面について。
　番組情報を常にロードする:
　　番組情報の描画頻度(10秒）毎に自動的にデータベースを読み込む機能です。
　　デフォルトでは、オフ になっています。
　プッシュ通知 :
　　登録されている番組の放送が始まる、3分前と1分前に通知を表示する機能です。
　　デフォルトでは、オン になっています。
　　※ この機能は番組の放送が始まる前に通知する機能のため、ソフトが起動した時点で既に
　　放送が開始している番組の通知は表示されません。
　放送時間外の時に画像を表示：
　　データベースに登録されている番組で放送時間外のときに文章ではなく、
　　お好みの画像を番組情報を表示している部分に表示する機能です。
　　入力欄が空白の場合と、ファイルが見つからない場合は、初期のテキスト表示になります。

　OKを押すことで変更した設定が反映されますが、キャンセルをクリックすると設定は反映せずに
  そのまま画面を閉じます。

・コマンドラインオプション。
 ショートカットアイコンや、ソフトウェアの実行の際のコマンドラインオプションに対応しています。

 /tasktray_boot　: ソフトウェア起動時にメイン画面を表示しないでタスクトレイに常駐した状態で開始します。

・免責。
　このソフトウェアは、開発や動作検証の際に、危害を及ぼすような危険なコードは無いことを確認し、
　十分に動作テストを実施してから公開しておりますが、
　各パソコンの構成によっては、うまく動かない可能性もございます。
　ご使用になったことにより、発生しました障害や損害に関しては、作者は一切の責任を負いませんので、
　(At your own risk)の上でご使用くださいますようよろしくお願いします。

・アンイストールについて。
　ソフト本体の設定情報などの保存場所としてレジストリは使用しておりませんので、
　設定ファイル等は、mskrnc_conf.ini というiniファイル形式で保存されています。
　このソフトウェアをアーカイバーで展開した時のできたフォルダの
　「mskrnc」のフォルダをまるごと削除していただくか、mskrnc内の
　mskrnc.exe や mskrnc_conf.ini、msk_sample.csv、readme.txt　の4つのファイルを削除するだけで
　アンイストールは完了です。

・他の使用用途など。
　当ソフトウェアは、主にラジオ番組の番組の通知/表示用のソフトとして設計しておりますが、
　ラジオは特に聞かないのだけれど…、という場合でも、ほかの用途としてテレビ番組などの
　通知、表示用ソフトとしてもご利用いただけます。

・謝辞。
　このソフトウェアは、Hot Soup Processor (略称: HSP)を使用して制作しました。
　HSP開発者の、おにたま氏、動作検証をいただいた、コーダイ(@kodainsk)氏、suhacker氏、
　このソフトウェアをご使用いただいている皆様に深く感謝致します。

・更新履歴。(日付はそのバージョンでの初回リリース日です)。
v1.03	- 2022/10/22
・コマンドラインオプションを追加しました。
・各項目の文字でバラバラになっていたのを各行とも揃えました。
　データベースで入力された文字列で長い場合は改行するようにしました。(140文字まで)
・番組用データベースのコメント欄は未入力の場合は、項目を表示しないようにしました。
・本readme.txt内の一部の誤字を修正しました。 (2022/10/26 公開分)
・24時台の時間帯で開始時刻になっている番組の通知が稀に表示されない不具合を修正しました。(2022/10/30)
 
v1.02	- 2022/10/13
・前回読み込んだデータベースを次回起動時に自動的に読み込むように変更しました。
・データベースファイルの書式チェックをするように追加しました。
　曜日で始まらない行や、空白、;などで始まる行はコメント文として扱うようにしました。
・時刻をまたぐ番組があったときに初期の頃から特定の条件が重なることで
　正常に表示されない他、突然エラーが発生することのある致命的なバグを修正しました。
・番組バナー用の画像をアスペクト比を維持したまま表示するように変更しました。
・タスクトレイの常駐機能を追加しました。
・設定画面の追加:
　データベースの再(自動)読み込み、番組開始前のプッシュ通知機能、代替画像設定の追加。

v1.01	- 2022/10/08
・最小化時に、番組情報を描画している部分で文字かぶりしていたのを修正。
・手動でのデータベース読み込み機能の追加。
・ステータスバーを追加:
　現在の曜日と、読み込み状態、放送の番組数を表示する機能を追加。

v1.00	- 2022/10/02 <非公開>
・初期バージョン。
　最低限CSVファイルから番組表の読み込みと簡易な画面表示。

v1.00(dev) - 2022/09/24 <非公開>
・制作開始 / 開発初期バージョン。