Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ libfcvg(3X) — NEWS-os 4.2.1R

Media Vault

Software Library

Restoration Projects

Artifacts Sought

LIBFCVG(3X)  —  NEWS-OS Programmer’s Manual

名称

libfcvg − フルカラービデオグラフィックライブラリ /usr/sony/lib/libfcvg.a の 関数一覧

形式

デバイスのオープン、クローズ
 

fcvg_open()
fcvg_close()

 
デバイスの初期化
 

fcvg_init(flag)
fcvg_cur_clr_w()
fcvg_clut_default_w()

 
ビデオプレーンに対する操作
 

fcvg_video_box_w(x, y, width, height, plane, color)
fcvg_video_pixel_r(x, y, plane)
fcvg_video_pixel_w(x, y, plane, color)
fcvg_video_scan_r(x, y, n, plane, colors)
fcvg_video_scan_w(x, y, n, plane, colors)
fcvg_rgb_pixel_r(x, y, rgb)
fcvg_rgb_pixel_w(x, y, rgb)

 
キャラクタプレーンに対する操作
 

fcvg_char_box_w(x, y, width, height, col_num)
fcvg_char_pixel_r(x, y)
fcvg_char_pixel_w(x, y, col_num)
fcvg_char_scan_r(x, y, n, col_nums)
fcvg_char_scan_w(x, y, n, col_nums)

 
サブキャラクタプレーンに対する操作
 

fcvg_subchar_box_w(x, y, width, height, col_num)
fcvg_subchar_pixel_r(x, y)
fcvg_subchar_pixel_w(x, y, col_num)
fcvg_subchar_scan_r(x, y, n, col_nums)
fcvg_subchar_scan_w(x, y, n, col_nums)

 
コントロールプレーンに対する操作
 

fcvg_ctl_box_w(x, y, width, height, ctl)
fcvg_ctl_pixel_r(x, y)
fcvg_ctl_pixel_w(x, y, ctl)
fcvg_ctl_scan_r(x, y, n, ctl)
fcvg_ctl_scan_w(x, y, n, ctl)

 
カーソルプレーンに対する操作
 

fcvg_cur_r(cur)
fcvg_cur_w(cur)
fcvg_cur_move(x, y)
fcvg_cur_pos(x, y)

 
カラールックアップテーブルに対する操作
 

fcvg_clut_r(col_num, rgb)
fcvg_clut_w(col_num, rgb)

 
ステータスレジスタに対する操作
 

fcvg_reg_r(bit)
fcvg_reg_w(bit, mask)

 

座標系

FCVG ライブラリでは、下図のように表示画面の左上が原点となる座標系を 用いています。

 
line from 0.675,10.012 to 3.425,10.012 line from 3.225,9.962 to 3.425,10.012 to 3.225,10.062 line from 0.675,10.012 to 0.675,8.262 line from 0.625,8.462 to 0.675,8.262 to 0.725,8.462 line from 0.675,9.012 to 2.175,9.012 to 2.175,10.012 line from 0.675,8.637 to 2.675,8.637 to 2.675,10.012 "(0, 479)" at 0.113,8.983 ljust "(0, 511)" at 0.113,8.671 ljust "y" at 0.613,8.171 ljust "x" at 3.300,9.983 ljust "(1023, 0)" at 2.425,10.108 ljust "(767, 0)" at 1.863,10.108 ljust "(0, 0)" at 0.487,10.108 ljust "表示領域" at 0.988,9.483 ljust "メモリ領域" at 1.488,8.796 ljust
 

画像ファイルフォーマット

FCVG ライブラリでは以下の 2 種類の画像ファイルフォーマットを使用しています。

ビデオプレーンの画像ファイルフォーマット
キャラクタプレーンの画像ファイルフォーマット
 

ビデオプレーンの画像ファイルフォーマット

ビデオプレーンの画像ファイルは「ヘッダ部」と「画像データ部」の 2 つの 部分から構成されています。

ヘッダ部

ファイルの先頭には画像ファイルの情報が、次のような構造体で定義されています。

#define FCVG_PIC_MAGIC 0x8945
typedef struct header {
short magic;
short type;
short x, y;
short x_start, y_start;
} fcvg_header;

構造体のそれぞれの項の内容は以下のとおりです。

magic 画像データファイルをあらわすマジックナンバーです。 FCVG_PIC_MAGIC で定義された値です。

type データファイルのタイプをあらわします。 ビデオプレーンの圧縮なし rgb 順の画像の場合 0x0000 が入ります。

x, y 画像データファイルの x 方向、 y 方向の長さが入ります。 単位はピクセルです。

x_start, y_start 画像データの左上の座標が入ります。
 

画像データ部

画面左上より+x 方向へ、右端まで来たら 1 ピクセル下がってまた左より +x 方向へ、最後の右下まで、各ピクセルの値が rgb (1 バイト× 3)、 rgb、rgb .... の順に並んでいます。
 

キャラクタプレーンの画像ファイルフォーマット

キャラクタプレーンの画像ファイルは、「ヘッダ部」、 「カラールックアップテーブル部」、「画像データ部」の 3 つの 部分より構成されています。
 

ヘッダ部

ビデオプレーンのヘッダ部と同様です。 type には、キャラクタプレーン圧縮なし画像の場合 0x2000 が入ります。
 

カラールックアップテーブル部

ヘッダの後ろに続きます。 カラーナンバー 0 番より 15 番まで、rgb (1 バイト× 3)、 rgb、rgb .... の順に並んでいます。
 

画像データ部

カラールックアップテーブル部の後ろに続きます。 各ピクセルが 1 バイトデータです。 下位 4 ビットが有効になります。 その他はビデオプレーンの画像データ部と同じです。
 

関連ファイル

/usr/src/sony/lib/libfcvg/∗ライブラリのソースコード用ディレクトリ
/usr/sony/demo/NWB224サンプルプログラム用ディレクトリ
/usr/sony/lib/libfcvg.aFCVG ライブラリ
/usr/sony/include/fcvg.hヘッダファイル
/usr/sony/include/fcvg_lib.hヘッダファイル
/usr/sony/include/fcvg_reg.hヘッダファイル

 

関連事項

「NEWS-OS Release 4.0 プログラマーズガイド
  8 章 フルカラービデオグラフィックインターフェース」

NEWS-OSRelease 4.2.1R

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026