@ReadMe_modules.txt
doclib\ 
@ReadMe_modules.txt
■ このドキュメントについて MOD_AlphaLayer+TimerRepeat - version 2.6(全体)
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
・a2d+AlphaLayer.hsp (※対応OS:Windows8以降)
・mod_TimerRepeat.hsp
これらのモジュールについてのドキュメントです。
詳細は以下に記述しています。
■ 各モジュールのヘルプ
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
・a2d+AlphaLayer.hs
・mod_TimerRepeat.hs
上記の.hsファイルを「C:\hsp3**\hsphelp」フォルダ内にコピーしてください。
HDLに組み込まれ、HSPエディタ上のF1ヘルプで参照出来るようになります。
┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳
┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻
━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
モジュール名│a2d+AlphaLayer.hsp
バージョン│2.4
作者│MIZUSHIKI (mail:suwa.mizushiki@gmail.com)
│ Copyright(C) 2019-2024 MIZUSHIKI
━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 概要 ■
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
Artlet2Dモジュール(a2d.hsp)の仮想イメージを用いて、アルファブレンド半透明 子ウィ
ンドウを作ることができます。
デフォルトではマウスクリック等のウィンドウメッセージを透過する仕様になっています
が、コールバックを設定してサブクラス化し、ウィンドウメッセージを取得することも出
来ます。
■ 注意 ■
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
・Windows 10 May 2020 Update(Ver.20H1)から非表示のウィンドウまたは非表示のレイヤ
ーに alalSetParent ,,1で非表示貼り付けをしても表示されてしまうことを確認しまし
た。
しかも、その状態はalalIsShownをしても非表示状態と認識されて0を返します。
なので、実際には見えているのにalalHideをしても消えません。
消すには一度alalShowを実行して、その後alalHideをしなければいけません。
Windows側の不具合に近いのではないかと思っているのですが、現状は注意して使って
いくしかない状態です。
・Windows 8 以降でしか動作しません。
このモジュールを利用して作られた作品には「対応OS:Windows8以降」を記述願います。
・開発環境は、HSP3.6β1以降を推奨。
デバッグ実行ランタイム(hsp3.exe)の改造が不要になります。
■ 命令 / 関数 ■
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
alalSetParent
Artlet2D仮想イメージをアルファレイヤー子ウィンドウとして描画先ウィンドウに貼り付ける
alalWindow
Artlet2D仮想イメージを用いてレイヤードウィンドウを作成
alalRedraw
アルファレイヤーにArtlet2D仮想イメージを再描画する
alalCallback
アルファレイヤーのWindowsメッセージ割り込み指定
alalShow
アルファレイヤー子ウィンドウを表示させる
alalIsShown
アルファレイヤー子ウィンドウの表示状態を取得
alalHide
アルファレイヤー子ウィンドウを非表示にする
alalAlpha
アルファレイヤーの透明度を設定する
alalWidth
アルファレイヤー子ウィンドウのサイズ・位置設定
alalGetRect
アルファレイヤー子ウィンドウの左上・右下座標の取得
alalZtop
アルファレイヤーをZオーダー（表示順序）の一番上に配置する
alalZbottom
アルファレイヤーをZオーダー（表示順序）の一番下に配置する
alalZnext
アルファレイヤーのZオーダー（表示順序）を指定したウィンドウの下に配置する
alalWindow_SetTransparent
alalWindowで作成したレイヤードウィンドウのクリック透過モードを変更
【Artlet2D拡張】
alCreateImageByAnimationFile
アニメーション画像ファイルから仮想イメージを作成
alGetFramesDelay
アニメーションのフレーム間の時間間隔を取得
alGetFramesCount
アニメーションのフレーム数を取得
alGetLoopCount
アニメーションのループ回数を取得
■ 謝辞 ■
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
参考：なたで様「レイヤードウィンドウ総合モジュール」
https://www.natade.net/lang/hsp/
(HSP | なたでラボ / モジュール )
ウィンドウの透過処理について、なたで様の「レイヤードウィンドウ総合モジュール」
を参考にさせて頂きました。ありがとうございます！
参考：nori様「GIFアニメサンプルスクリプト」
http://hsp.tv/play/pforum.php?mode=pastwch&num=75891
(HSPTV!掲示板 / HSPでGIFアニメーションの再生)
GIFアニメーションの再生の仕方を参考にさせていただきました。
ありがとうございます！
モジュール：ぷま様「バイナリサーチ(BM法) bsearch」
http://hsp.tv/play/pforum.php?mode=pastwch&num=29717 （代替）
(HSPTV!掲示板 / sdim,bload命令について)
非常に速い検索が可能になりました。ありがとうございます！
■ 履歴
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
version 2.4 2024/ 1/ 5
￣￣￣￣￣￣￣￣￣￣￣￣
・alCopyImageToImage/ImageToScreenが高さ省略時正しくコピーされないバグを修正。
・alalIsOnLayer関数が返り値を返さずエラーになることがあるバグを修正。
version 2.3 2022/11/16
￣￣￣￣￣￣￣￣￣￣￣￣
・alalWindow,alalWindow_SetTransparent関数を追加。
・alalSetParent後のstatに子ウィンドウのウィンドウハンドルを格納するようにした。
・alCreateImageByAnimationFileで画像を縦に並べたPNGファイルでもアニメーションと
して読み込みが可能になった。
・alalAlphaで透明度変更後にalalRedrawしても透明度を維持するようにした。
・重複コンパイル防止処理が機能していなかったバグを修正。
・終了時のウィンドウ破棄し忘れを修正。
・細かい箇所の変更と修正。
version 2.2 2021/ 6/25
￣￣￣￣￣￣￣￣￣￣￣￣
・Windows 10 May 2020 Update(Ver.20H1)のアプデ辺りから発生したバグに対処。
非表示状態で作成しても表示されてしまう。(一度VISIBLE→非VISIBLE処理が必要)
非表示の子レイヤーに張り付けた孫レイヤーが見えてしまう。
↑プログラムで回避必要。(詳細：alalSetParentのHelp参照)
・CallWindowProcが定義されていなかったバグを修正。
version 2.1 2020/ 9/10
￣￣￣￣￣￣￣￣￣￣￣￣
・GIFアニメーションファイルの読み込みに対応。【Artlet2D拡張】
alCreateImageByAnimationFile
alGetFramesDelay
alGetFramesCount
alGetLoopCount
・alalIsShown関数を追加。
・A2DのImage ID１つにつきアルファレイヤー1つじゃなくても利用できる裏技を内包。
・デバイスコンテキストが一部解放されていなかった問題を修正。
・未初期化変数の初期化処理を入れるよう修正。
・alalWidthでサイズを0以下にすると以降再表示できなくなるバグを修正。
version 2.0 2020/ 6/ 6
￣￣￣￣￣￣￣￣￣￣￣￣
・命令を全面見直し(HSPのウィンドウを使わず自力でウィンドウを生成)。
version 1.1 2019/11/10
￣￣￣￣￣￣￣￣￣￣￣￣
・HSP3.5 で動かなくなっていたバグを修正。
version 1.0 2019/10/31
￣￣￣￣￣￣￣￣￣￣￣￣
・リリース。
━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
モジュール名│mod_TimerRepeat.hsp
バージョン│2.5
作者│MIZUSHIKI (mail:suwa.mizushiki@gmail.com)
│ Copyright(C) 2019-2024 MIZUSHIKI
━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 概要 ■
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
一定間隔で実行するタイマー機能をrepeat〜loopのような記述で簡単に利用することが出
来るようになります。
また、timer_ease命令を合わせて使うことで、時間変化によるイージング値を簡単に取得
出来るようになります。
□ モジュール内記述：mod_uniq.hsp - ver.1.1 □
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
指定した区間において、名前の被らないユニークな変数を定義します。
□ モジュール内記述：mod_waiton.hsp(+タイマーループ割り込み) - ver.1.2.2 □
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
中断中にタイマーループの指定時間が来たら適宜実行されるようになっています。
また、oncmd等の割り込みジャンプにも対応しています。
通常のwaitでは oncmd, onkey, onclick の割り込みジャンプが発生すると、return
で戻ってたときに待ち時間が残っていても次の行から処理が始まってしまいます。
timer_waitonは、残り時間があった場合は残りのぶん再waitします。
a2d+AlphaLayer.hsp でSetCallbackAlphaLayerを使いメッセージ割り込みを指定した
場合、マウスの通過でも wait/await の待機時間が無効化されてしまうため利用を推
奨します。
mod_TimerRepeat.hsp をインクルードした時点で、通常のwait命令がtimer_waitonの機
能で上書きされます。（waitと書いてもtimer_waitonの処理が実行されます。）
■ 命令 / 関数 ■
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
timer_repeat
タイマーループの始まりの場所を示す
timer_loop
タイマーループの始まりに戻る
timer_kill
タイマーループを終了させる
timer_init
タイマーループ初期化処理（_init_end まで）
timer_deinit
タイマーループ後始末処理
timer_break
タイマーループから抜けだしてタイマーも終了させる
timer_continue
タイマーループをやり直す
timer_cnt
タイマーループのカウンター
timer_intervals
timer_repeat内で繰り返し間隔の取得
timer_getTimerTime
実行中のタイマーループの経過時間を取得
timer_setTimerSpeed
タイマーループの繰り返し間隔を変更
timer_getTime
ミリ秒タイマー
timer_ease
タイマーループ内で時間変化によるイージング値の取得
geteaseT
時間変化によるイージング値を取得
timer_setTimerEngine
タイマーの実行タイミングを変更する（オート/マニュアル）
timer_fire
タイマーのマニュアル実行時に確認/実行を行う。
◆ mod_uniq.hsp - ver.1.1 ◆
uniq_start
uniq()のスコープ開始
uniq
ユニークな変数を定義
uniqN
N個外側のスコープのuniq()変数を取得
uniq_end
uniq()のスコープ終了
◆ mod_waiton.hsp(+タイマーループ割り込み) - ver.1.2.2 ◆
timer_waiton
実行を一定時間中断する(タイマーループ割り込み+oncmd等の割り込みジャンプに対応)
timer_awaiton
一定の時間で待つ(タイマーループ割り込み+oncmd等の割り込みジャンプに対応)
timer_stop
プログラム中断(タイマーループ割り込みに対応)
■ 履歴
￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
version 2.5 2024/ 1/ 5
￣￣￣￣￣￣￣￣￣￣￣￣
・(mod_uniq ver.1.1)uniq2〜uniq9のコマンドを追加。
version 2.4 2022/11/16
￣￣￣￣￣￣￣￣￣￣￣￣
・timer_initを指定したとき初期化時に本体も実行されてしまうことがあるバグを修正。
・timer_initの中で別IDのtimer_killをするとtimer_cntがバグるのを修正。
・timer_fireにオプション値を追加。
version 2.3 2021/ 7/18
￣￣￣￣￣￣￣￣￣￣￣￣
・timer_repeatがいくつも連続して呼ばれている中で新規にtimer_init:を使用したとき
に既に稼働しているタイマーにも関わらず改めてtimer_init:内が実行されてしまう不
具合を修正。
・timer_deinitの中でtimer_repeatを記述するとtimer_killなどで終了させたタイマー
にも関わらず終了が無かったことにされて続いてしまう不具合を修正。
version 2.2 2021/ 6/25
￣￣￣￣￣￣￣￣￣￣￣￣
・Windowsを起動したまま24.855日以上たつとtimer_easeの処理がバグる問題を修正。
version 2.1 2020/ 9/10
￣￣￣￣￣￣￣￣￣￣￣￣
・timer_repeatでp1(繰り返し間隔)を数値だけでなく配列も指定できるように変更。
(a2d+AlphaLayerのGIFアニメ再生の簡易化のため)
・timer_setTimerSpeedも数値だけでなく配列も指定できるように変更。
・timer_getTimeの仕様変更。(gettime標準命令を諦めwinmm.dll-timeGetTimeを利用)
・未初期化変数の初期化処理を入れるよう修正。
(mod_waiton.hsp Ver.1.2.2)
・waiton系命令で必ず1(wait 1/await 1)以上待つように変更。
version 2.0 2020/ 1/ 3
￣￣￣￣￣￣￣￣￣￣￣￣
・HSP3Dishでも利用できるように変更。
・WM_TIMER使用からwait書き換え式に変更。(精度も良くなった)
・timer_easeで渡されたものが変数かどうかを自力読み取りするようにした。
・timer_getTimeの数値をgettime、getreqから取得するようにした。
・timer_setTimerEngine、timer_fireでタイマー実行のタイミングをコントロールでき
るようにした。
・mod_uniq.hsp(ver.1.0)、mod_waiton.hsp+タイマーループ割り込み(ver.1.2.1)をモジ
ュール内に記述するようにした。
・[名称変更]geteaseWithTime→geteaseT
・[バグfix]timer_continueの第1パラが必ず0になってしまうバグを修正。
version 1.1 2019/11/ 9
￣￣￣￣￣￣￣￣￣￣￣￣
・mod_waiton.hspを自動でインクルードするように修正。
(一緒に使う必要なくなったと思ったらそんなことなかった。)
・timer_setTimerSpeed命令の変数指定ミスを修正。
version 1.0 2019/10/31
￣￣￣￣￣￣￣￣￣￣￣￣
・リリース。
┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳┳
┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻┻