付録・コメント機能について 1997/11/02
  1. コメント機能を使ってみよう。
  2. コメント表示に関する注意すべき問題
  3. fkiss,WKISS32の機能文字(改行処理等)(+ おまけ 透明度指定)
  4. もっとコメントを書きたい人へ

コメント機能を最初に搭載したのは Hx2さま作のKISSGAシリーズです。

「コメント機能」とは、あるセルを”右クリック”したときに、 文章が表示される便利な機能です。
fkiss命令とは違うのですが表現力を豊かにする意味で 一部分説明したいと思います。

「コメント機能」と称して、コメントを表示出来るローダーは、

・KISSGAシリーズHx2氏作
・WKISSF.K氏作
・fkiss(v0.25以降)yav氏作
・WKISS32F.K氏作
・KISSLDえむけい氏作
のようです。
しかも、上に挙げたローダ毎に表示方法が若干異なります。



『1』コメント機能を使ってみよう
まずは深く考えないで、簡単な例を挙げて説明します。


ex.1
------------------------------------------------------------------------
#12	REI_1.CEL	*0: 0 1 2 3 4 5 ;こんにちは☆私○○ちゃんです!
------------------------------------------------------------------------

上のex.1で、「;」以降の緑色の部分がコメントです。

なので、実際には「#12 REI_1.CEL」を右クリックしたとき、画面には

----------------------------------------
こんにちは☆私○○ちゃんです!
----------------------------------------
と表示されます。ただこれだけです。簡単でしょう?

ただし、コメント表示されるのは、
「セル指定を含めて、1行は253文字(リターンコードの[CR+LF]含むと255文字)まで」
ですので、注意して下さい。それ以上だとエラーになります。


『2』コメント表示に関する注意すべき問題
注意すべき問題が、2点ほどあります。
これに注意しないと、ローダーが違った場合作者さんが意図している表示と 異なった表示をしてしまいます。

1:「文字列が自動改行されるかされないか。」

KISSGAシリーズ、およびWKISSでは、自動改行されるので コメントが画面をはみだす事はありません。
しかし、WKISS32,fkiss では、あまり長いコメントを書くと、 改行しないので、文字が画面からはみだしてしまいます。
その代わりに文字制御命令がいくつかあります。(後述)

WKISS やKISSGAで作成したコメントを WKISS32で閲覧すると良くはみ出ます。
作成時にはご注意を。(T-T)

2:「複数のセルから構成されるオブジェクトにおいて、セルが違う場合 コメントが表示されるかされないか」

つまり、オブジェクト番号が同じで、セルファイル名が違うセルを右クリック したときの、表示の違いです。

・ KISSGAシリーズ v1.50では
オブジェクト番号が一致していても、右クリックしたセルに、 コメントが記入されていれば、そのセルのコメントしか表示されません。 コメントの付いていないセルを右クリックした場合は、 同じオブジェクトに所属する、いちばん優先順位の高い (重ね合わせが上の)他のセルのコメントで代用するようです。

・ WKISS,KISSLD(コメント未加工表示)では
オブジェクト番号が一致していれば、違ったセルでも すべてのコメントを上から優先順に表示します。 コメントが記入されていなくても空行は1行として表示されます。

・ WKISS32,fkiss,KISSLDでは
オブジェクト番号が一致していれば、違ったセルでも すべてのコメントを上から優先順に表示します。 コメントが記入されていないと、空行は詰めて表示します。

以下にこれらの違いの例を示します。


ex.2                                    v  ここに「;」が無い事に注意
------------------------------------------------------------------------
#12	REI_0.CEL	*0: 0 1 2 3 4 5
#12	REI_1.CEL	*0: 0 1 2 3 4 5 ;こんにちは☆私○○ちゃんです!
#12	REI_2.CEL	*0: 0 1 2 3 4 5 ;はじめてだけどよろしくね☆
#12	REI_3.CEL	*0: 0 1 2 3 4 5 ;
------------------------------------------------------------------------

上のようにコンフィグに記述したとします。
上の例 ex.2を用いて説明しますと、

WKISS,KISSLD(コメント未加工表示)では(各種多少異なりますが)
「REI_0.CEL」「REI_1.CEL」「REI_2.CEL」「REI_3.CEL」のうち、 どのセルを右クリックしても
----------------------------------------
#REI_0.CEL:
#REI_1.CEL:こんにちは☆私○○ちゃんです!
#REI_2.CEL:はじめてだけどよろしくね☆
#REI_3.CEL:
----------------------------------------
と4行にわけて表示されます。
つまり同じオブジェクト番号(上の例(ex.2)では"#12")は 全て表示してくれます。

WKISS32,fkiss,KISSLDでは(多少異なりますが)
「REI_0.CEL」「REI_1.CEL」「REI_2.CEL」「REI_3.CEL」のうち、 どのセルを右クリックしても

----------------------------------------
こんにちは☆私○○ちゃんです!
はじめてだけどよろしくね☆
----------------------------------------
と2行にわけて表示されます。
つまり同じオブジェクト番号(上の例(ex.2)では"#12")は 全て表示してくれます。

KISSGAシリーズ v1.50では、
表示は右クリックするセルにより異なっていて

ex.2 において
----------------------------------------「REI_0.CEL」「REI_1.CEL」
「こんにちは☆私○○ちゃんです!」      「REI_3.CEL」
----------------------------------------  を右クリックした場合の表示
または、
----------------------------------------
はじめてだけどよろしくね☆              「REI_2.CEL」
----------------------------------------  を右クリックした場合の表示
のどちらか片方しか表示されません。

注:KISSGAシリーズ v1.48以前はコメントの書いていないセルの フォロー表示はしません。(KISS21 v1.48 & v1.50で確認)

この違いを有効に使うと、それぞれのローダーによって 違った楽しみ方ができます。
( KISSLDはコメント表示方法を WKISS風とWKISS32風に切り替えることが出来ます。)

注:より細かい違いに関しては、【MORE.HTM [3]】 を参照してください。





『3』fkiss,WKISS32の機能文字(改行処理等)(+ おまけ 透明度指定)

・fkissの機能文字

コメント表示においてWKISS,KISSGAシリーズ以外では自動改行しません。
その代わりに細かい指定が出来るようになっています。コメントの中で使用して ください。

コメント領域の機能文字に対応しているローダーは、
fkiss,WKISS32,KISSLD です。

fkissでは、コメントの記入位置こそ同じですが、
コメントを "(ダブルクォーテーション)または /(スラッシュ)
で囲む事が正しいとしています。しかし fkiss及び他の機能文字対応ローダー は、これがなくても一応コメントを表示してくれます。

\n改行します。\n\nだと、空行を表示できます。
\t[TAB](タブ)です 半角スペース8つ分です。 その間隔はフォントによります。
\"ダブルクォーテーション自身を表示します。




(おまけ)透明度指定の機能文字

fkiss,WKISS32,KISSLDでは、透明度を指定する事ができます。
表示出来る色数は環境により異なりますので、これを指定するときには ご注意ください。

WKISS32,KISSLDでは、
ハイカラー(約65,536色,16bitカラー)以上をお薦めします。 256色で表示をしている環境では、色が正確に表示出来ませんので 十分ご注意ください。

fkissでは、
256色表示のままで、ディザにより疑似的に半透明表示をします。 フルカラーは使いません。
%t128透明度指定です。コメントを表示するための「;」の直後、 「"」の前に記入します。
数値は0から256までの整数で、0なら%tを指定しないのと同じ全表示、 256なら全透明です。




『4』もっとコメントを書きたい人へ

一行に半角253文字では足りないコメントを書く場合には、 以下のようにすると何行でもかけます。(^^;
ただしKISSGAシリーズでは、先に述べた理由により、 この方法は使えません。


ex.3
------------------------------------------------------------------------
#12 AAA.CEL  *0 : 0 ;こんにちは。
#12 AAA.CEL  *0 : 0 ;制御文字を知らなかったときこうやって改行したの。
#12 AAA.CEL  *0 : 0 ;この改行方法が役に立つのはWKISS くらいかしら。
#12 AAA.CEL  *0 : 0 ;こうすれば何行でも何文字でも書けるのよ☆
#12 AAA.CEL  *0 : 0 ;でも、結構大変なの。(;_;)
------------------------------------------------------------------------

ex.3のように記述すると、用意するセルファイルが【AAA.CEL】1つで良いので 手間とファイルサイズを節約することが出来ます。(^^)
もちろんメモリを節約するわけでは無いです。 (__;

ただし、ex.3に示す様に記述した場合、
同名で複数回読み込んだセルをfkiss命令の引数に使うと、 ローダによって動作が異なることがあります。

詳細は【MORE.HTM [2]5参照】


fkiss 命令と複数行コメントを同時に使用して 動作に支障が有る場合には 以下 ex.4 のように記述すると良いでしょう。


ex.4 ------------------------------------------------------------------------ #12 AAA1.CEL *0 : 0 ;こんにちは。 #12 AAA2.CEL *0 : 0 ;制御文字を知らなかったときこうやって改行したの。 #12 AAA3.CEL *0 : 0 ;この改行方法が役に立つのはWKISS くらいかしら。 #12 AAA4.CEL *0 : 0 ;こうすれば何行でも何文字でも書けるのよ☆ #12 AAA5.CEL *0 : 0 ;でも、結構大変なの。(;_;) ------------------------------------------------------------------------

ex.4では、セルファイルを全て用意しなくてはならないのが欠点ですが、 より互換性の高い動作を望む事ができるでしょう。(^^)




[COMMENT.HTM]