最初はこれだけでも覚えよう!


cls  end  goto  mes  picload  stop

cls

cls p1			[画面クリア]

p1=0〜4(0) : クリアする時の色

説明

ウインドゥ内の情報をすべてクリアします。 

p1でクリアする5種類の色を指定することができます。 
    色の指定値:
     ( 0=白 / 1=明るい灰色 / 2=灰色 / 3=暗い灰色 / 4=黒 )


cls命令で画面をクリアすると、画面にあるボタンや入力ボックスなどのオブジェクト類、
設定されているパレットなどすべてが初期状態に戻ります。 

end

[プログラム終了]

説明

HSPのプログラムを終了します。
end命令はスクリプトのどこにあってもかまいません。
end命令が実行されると、そのアプリケーションは終了します。 
スクリプトの最後まで達した場合も、同様にHSPのプログラムを終了します。 


goto

goto *label			[指定ラベルにジャンプ]

*label : ラベル名

説明

指定したラベルに無条件でジャンプします。
以降は、ラベル名で指定された場所から実行を続けます。 


mes

mes "strings"			[メッセージ表示]

"strings" : 表示するメッセージ、または変数

説明

ウインドゥ内に、指定されたメッセージを表示します。
メッセージは、カレントポジションと呼ばれるウインドゥ上の仮想的なカーソル位置から表示され、
カレントポジションが次の行に自動的に移動します。 

表示されるメッセージのフォントは、font命令で選択することができます。
また、メッセージを表示する速度をtext命令で設定することができます。 

表示するメッセージに改行コードが含まれていた場合には、改行され次の行から表示を続けます。 

printとmesはどちらも同じ意味になります。 

picload

picload "filename",p1,p2,p3			[画像ファイルをロード]

"filename" : ロードするファイル名
p1=0〜1(0) : 画像ロードモード
p2,p3 : 新規ウインドゥサイズX,Y

説明

画像ファイルをロードします。通常は、 
    picload "test.bmp"


とするだけで、"test.bmp"で指定された画像ファイルが現在の画面にロードされ、
ウインドゥサイズが自動的に絵のサイズに合わせられます。 

p1の画像ロードモードは、 
    モード0:ウインドゥを初期化してロード
    モード1:現在の画面の上にロード


p1のロードモードを省略もしくは0にすることで、画像のサイズで初期化したウインドゥにロードされます。
その際に、(p2,p3) でウインドゥのサイズを指定できるようになります。たとえば、 
    picload "test.jpg",0,600,400


は、HSPの画面を画像ファイルの大きさで初期化してロードします。
その際に画像が600x400よりも大きい場合はウインドゥには一部だけが表示されウインドゥサイズは600x400になります。
この場合は、スクロールバーが付加され画像をスクロールさせることができるようになります。 

p1にロードモード1を指定することで、現在のウインドゥのサイズなどを一切変更せず、
指定した座標からロードすることができます。
この場合は、(p2,p3)がロードする座標の左上XYになります。
ただし、MAG,JPGファイルで画面の領域からはみ出るような座標を指定するとエラーになります。 

画像ファイル名は、拡張子も含めて完全な形で書いてください。
画像の形式は、拡張子で判断されます。現在ロードできる、ファイル形式は以下の通りです。 
    BMP形式  : 拡張子 BMP : Windows標準の4,8,24bitのデータ。
                 RLE圧縮のデータも扱うことができます。
    MAG形式  : 拡張子 MAG : MAG形式のデータ。
                 16色、256色のどちらでもOKです。
    JPEG形式 : 拡張子 JPG : JFIF標準のJPEGデータ。
                 グレイスケールデータでもOKです。


フルカラーデータを扱うJPEG形式をロードする時、画面のモードがパレットモードだった時は、
自動的に最適なパレットが選ばれ、もとのイメージに近い画像が表示されます。 

picload命令は、HSPのメイン画面、screen、buffer、bgscr 命令で初期化された画面に対して実行することができます。
また、buffer命令で初期化された画面に対して読み込みをした時のみ、
ロードされた画像のパレットが自動的にHSPのメイン画面 (ウインドゥID0)にも適用されます。
この機能により、仮想画面からメイン画面へgcopy命令などで画像を手軽に転送できるようになります。
(オートパレットマッチング機能)


stop

[プログラム中断]

説明

プログラムの実行を一時中断します。ボタンがクリックされるまで待つ時などに使用します。