2: 2011-03-08 (火) 13:34:11 k-tan[6] [7] | 3: 2011-03-08 (火) 22:12:05 名無しさん[C1tKa0P8FJM] [8] | ||
---|---|---|---|
Line 39: | Line 39: | ||
--r, g, b はそれぞれ0~255が有効。これらを0x000000~0xffffffの整数に変換する。 | --r, g, b はそれぞれ0~255が有効。これらを0x000000~0xffffffの整数に変換する。 | ||
- | -[01f以降] drawStr() | + | -[01f以降] drawStr(int x0, int y0, int rx, int ry, const char *s, ...) |
+ | --文字列を描画する。printfとの違いは、描き始めの位置をピクセル単位で制御できることと、重ねあわせができることと、拡大ができることである。 | ||
+ | --rxやryは倍率で、整数倍のみ指定できる。 | ||
- | -[01f以降] setMode() | + | -[01f以降] setMode(int flags) |
+ | --flagsは以下のものが指定できる。 | ||
+ | #define BL_PSET 0x00000004 | ||
+ | #define BL_PAND 0x00000005 | ||
+ | #define BL_POR 0x00000006 | ||
+ | #define BL_PXOR 0x00000007 | ||
+ | #define BL_DBGFLSH 0x00000040 | ||
+ | #define BL_RLSFLSH 0x00000060 | ||
+ | #define BL_DEBUG BL_DBGFLSH | ||
+ | #define BL_RELEASE BL_RLSFLSH | ||
+ | --PSET, PAND, POR, PXOR はどれか一つを指定することができる。デフォルトでは PSET になっている。指定しなければ変更されない。 | ||
+ | ---これらは setPix(), drawLine(), drawRect(), fillRect(), fillOval(), drawStr() に影響する。 | ||
+ | --DBGFLSH, RLSFLSH もどれか一つを指定することができる。デフォルトでは DBGFLSH になっている。指定しなければ変更されない。 | ||
+ | ---これはフラッシュ忘れを分かりやすくする。リリースモードにするとフラッシュ忘れが分かりにくくなる代わりに(忘れていても結構それなりに画面に反映されてしまうことがある)、メモリが節約され、速度も向上する。 | ||
+ | ---リリースモードにしたいときは、一番最初に setMode(BL_RELEASE); と書くのが良いだろう。 | ||
-[01f以降] openVWin(int n, int sx, int sy) | -[01f以降] openVWin(int n, int sx, int sy) | ||
Line 51: | Line 67: | ||
--描画関数がどの画面に対して描画を行うかを指定する。 openVWin() しないまま slctWin() して描画することもできて、その場合は表画面と同一サイズで blike が openVWin() する。 | --描画関数がどの画面に対して描画を行うかを指定する。 openVWin() しないまま slctWin() して描画することもできて、その場合は表画面と同一サイズで blike が openVWin() する。 | ||
- | -[01f以降] copyRct0() | + | -[01f以降] copyRct0(int sx, int sy, int n0, int x0, int y0, int n1, int x1, int y1) |
+ | --ウィンドウのある領域の画像を、別のウィンドウの同じ大きさの領域にコピーする。sxとsyは領域のサイズで、n0やn1はウィンドウ番号。 n0, x0, y0 の内容が、 n1, x1, y1 へコピーされる。 | ||
+ | --n0とn1が同じウィンドウを指していてもよく、その場合は同一画面内でのコピーになる。ただし領域が重なっていてはいけない。 | ||
- | -[01f以降] copyRct1() | + | -[01f以降] copyRct1(int sx, int sy, int n0, int x0, int y0, int n1, int x1, int y1, int ic) |
+ | --ウィンドウのある領域の画像を、別のウィンドウの同じ大きさの領域にコピーする。その際、 ic で指定した色が透明色として扱われる。 | ||
+ | |||
+ | *** そのほかの関数群 [#g0dd6fe4] | ||
+ | -[01f以降] int rnd(int n) | ||
+ | --0からn-1の範囲の乱数を返す。 | ||
+ | |||
+ | -[01f以降] srand(int s) | ||
+ | --乱数のパターンを指定する。 | ||
+ | |||
+ | * ドライバ関数群 [#r913b417] | ||
+ | -[01f以降] 各OSのmain関数 | ||
+ | --この関数は、ドライバに必要な初期化を行って、さらに bl_init(); で blike の内部を初期化したのち、 blMain(); を呼び出す。 | ||
+ | --もし blMain(); から帰ってきた場合は、アプリの終了が期待されているので、速やかにドライバの終了処理や bl_exit(); で blike の内部の終了処理を完了させたのち、アプリそのものをそのOSのやり方で終了する。現状では終了コードは渡されないので、常に正常終了でかまわない。 | ||
+ | |||
+ | -[01f以降] void *bld_malloc(unsigned int bytes) | ||
+ | --この関数は、そのOSにおけるメモリ確保を期待している。確保に失敗した場合は NULL (0) を返してほしい。 | ||
+ | |||
+ | -[01f以降] void bld_free(void *p, unsigned int bytes) | ||
+ | --この関数は、そのOSにおけるメモリ開放を期待している。bytesは確保時と同じ値を渡すので、必要であれば利用してよい。 | ||
+ | |||
+ | -[01f以降] void bld_openWin(int sx, int sy) | ||
+ | --この関数は、そのOSにおけるウィンドウオープンを期待している。sxは160以上、syは1以上を blike 側で保障する。 | ||
+ | --ウィンドウに表示してほしいグラフィックのイメージバッファは、 bl_work.win[BL_SYSWIN].buf で参照できる(これは int * 型)。したがって、 int の配列で不都合がないのなら、ドライバ側でウィンドウのイメージを確保する必要はないだろう。 | ||
+ | --sxやsyについても、 bl_work.win[BL_SYSWIN].xsiz, bl_work.win[BL_SYSWIN].ysiz を参照すればいつでも得られるので、ドライバ側で保存する必要はないだろう。 | ||
+ | |||
+ | -[01f以降] void bld_flshWin(int sx, int sy, int x0, int y0) | ||
+ | --この関数は、イメージバッファ内の指定された範囲のフラッシュを期待している。sxやsyが0以下になるとか、画面外のピクセルが含まれてしまうなど、そういうやっかいなパラメータを渡すことはないので、その辺はドライバ関数が心配する必要はない。 | ||
+ | --setMode(BL_DBGFLSH); では、不正なカラーコード(0x000000未満とか0xffffffより大きいとか)を渡さないようになっている。リリースモードの場合は、チェックを省略しているので、もしかしたら渡してしまうかもしれないが、しかしとりあえず常に不正なカラーコードが来ることはないと仮定していいと思われる。 | ||
+ | ---デバッグが完了しないうちにリリースモードを指定するほうがおかしいので。 |
(This host) = http://osask.net