リファレンス - jiglet @ wiki

リファレンス

用途別

• 基本
• 描画
  • 色
  • 基本図形描画
  • 画像関係
  • 文字列描画
  • 描画範囲指定
  • 原点変更
  • システムカラー
• キー・イベント
• 文字列入力
• データ保存
• その他処理
  • 配列のコピー
  • 文字列の整数化
  • 乱数
  • Base64
• リソース
• ダイアログ
• 日付時間
• 音声
• 携帯電話連携
• アプリ連携
• HTTP通信
• RSS
• 課金状態確認
• デバイス
  • バックライト
  • 振動
  • 赤外線通信（OBEX）
  • バーコード
  • 赤外線リモコン
  • カメラ
  • アナログ
  • ラジオ

---

基本

abstract void main()
jigletが、起動した時に呼ばれるメソッドです。

void repaint()
再描画を要求するメソッドです。

void repaintAll()
再描画を要求するメソッドです。全描画フラグがtrueとなります。通常は repaint() の方を使用します。

void terminate()
jigletを終了します。

void setSoftLabel(String label)
ソフトキーの機能を表すソフトラベルを設定します。

void setMenu(String[] menu, String[] help)
左ソフトキーを押されたときに表示する文字列を指定します。

void setTitle(String str)
タスク一覧に表示するタイトル文字列を設定します。（初期設定はタイトルが設定されています）

int getPlatformType()
仕様端末の種類を返します。
返値

PLATFORM_AU	AU版を表す定数です。
PLATFORM_DOCOMO_100K	ドコモ100k版を表す定数です。
PLATFORM_DOCOMO_30K	ドコモ30k版を表す定数です。
PLATFORM_SOFTBANK	SoftBank版を表す定数です。
PLATFORM_WILLCOM	Willcom版を表す定数です。

String getPlatform()
機種名を返します。

String getSourceURL()
ダウンロードURLを取得します。

void sleep(int n)
指定した時間(ミリ秒)だけ処理を中断します。

int freeMemory()
現在の空きメモリ量(byte)を返します。

void gc()
使用されていないメモリを開放します。

boolean savePower()
ラジオのみ再生されアプリの動作はすべて停止する節電モードに入ります。
返値

節電モードに入ることができればtrue

※現在はラジオ対応機種のみ対応

void println(String str)
エミュレータでの確認用に文字列を開発環境に出力します。

void println(int val)
エミュレータでの確認用に数値を開発環境に出力します。

---

描画

DH 描画可能領域の画面高さを表す定数です。
DW 描画可能領域の画面幅を表す定数です。

abstract void paint(boolean all)
描画用メソッドです。描画関係のメソッドはこのメソッドからの呼び出しでのみ使ってください。

色

void setColor(int r, int g, int b)
描画に使う色をセットします。

void setColor(int col)
描画に使う色をセットします。

int getColor(int r, int g, int b)
setColor(int col)で指定可能な色を取得します。

基本図形描画

void drawLine(int x, int y, int x2, int y2)
始点(x, y)、終点(x2, y2)で線を描画します。

void drawRect(int x, int y, int w, int h)
左上が(x, y)で幅がw, 高さがhの長方形を描画します。

void fillRect(int x, int y, int w, int h)
左上が(x, y)で幅がw, 高さがhの塗りつぶされた長方形を描画します。

void drawArc(int x, int y, int w, int h, int st, int angle)
座標(x,y)から(w,h)の大きさの長方形に接する円を角度stからangle度分描画します。

void fillArc(int x, int y, int w, int h, int st, int angle)
座標(x,y)から(w,h)の大きさの長方形に接する塗りつぶされた円を角度stからangle度分描画します。

void draw3DRect(int x, int y, int w, int h)
左上が(x, y)で幅がw, 高さがhの3Dのテキストボックスのような長方形を描画します。

void draw3DButton(int x, int y, int w, int h)
左上が(x, y)で幅がw, 高さがhの3Dのボタンのような長方形を描画します。

画像関係

void drawImage(Image im, int x, int y)
左上が(x, y)で画像を描画します。

Image getImage(byte[] src)
バイト配列から画像オブジェクトを取得します。

Image getImage(String fn)
画像オブジェクトをリソースファイルから取得します。

int Image#getHeight()
画像の高さ取得

int Image#getWidth()
画像の幅取得

文字列描画

void drawString(String str, int x, int y)
文字列を描画します。

void setFont(int n)
描画に使用するフォントを設定します。
size

FONT_SMALL	小フォントを表す定数です。
FONT_MEDIUM	中フォントを表す定数です。
FONT_LARGE	大フォントを表す定数です。

int setFontSize(int size)
描画に使用するフォントを設定します。

int getFontHeight()
フォントの高さを返します。

int[] getFontSizes()
端末がサポートしてるフォントの大きさを配列にして返します。

int stringWidth(String s)
引数で指定した文字列の幅を返します。

int getLineBreak(String str, int off, int len, int width)
改行位置を返します。

描画範囲設定

void setClip(int x, int y, int w, int h)
描画範囲を指定します。

void clearClip()
指定した描画範囲を解除します。

原点変更

void setOrigin(int x, int y)
描画の原点となる座標を指定します。

システムカラー

int getSystemColor(int index)
指定したパレットインデックスの色を取得します。
index

SYSTEM_COLOR_BUTTON_BG	ボタンの背景色を表す定数です。
SYSTEM_COLOR_BUTTON_CURSOR	ボタンのカーソル色を表す定数です。
SYSTEM_COLOR_BUTTON_FONT1	ボタンの基本フォント色を表す定数です。
SYSTEM_COLOR_BUTTON_FONT2	ボタンのカーソルがあったときのフォント色を表す定数です。
SYSTEM_COLOR_BUTTON_FRAME1	ボタンの左と上の枠色を表す定数です。
SYSTEM_COLOR_BUTTON_FRAME2	ボタンの右と下の枠色を表す定数です。
SYSTEM_COLOR_DESCRIPTION_BG	画面下説明の背景色を表す定数です。
SYSTEM_COLOR_DESCRIPTION_FONT	画面下説明のフォント色を表す定数です。
SYSTEM_COLOR_DESCRIPTION_FRAME	画面下説明の枠色を表す定数です。
SYSTEM_COLOR_LIGHT_FONT	ボタンの薄いフォント色を表す定数です。
SYSTEM_COLOR_MENU_BG	メニューの背景色を表す定数です。
SYSTEM_COLOR_MENU_CURSOR	メニューのカーソル色を表す定数です。
SYSTEM_COLOR_MENU_FONT1	メニューの基本フォント色を表す定数です。
SYSTEM_COLOR_MENU_FONT2	メニューのカーソルがあったときのフォント色を表す定数です。
SYSTEM_COLOR_MENU_FRAME1	メニューの左と上の枠色を表す定数です。
SYSTEM_COLOR_MENU_FRAME2	メニューの右と下の枠色を表す定数です。
SYSTEM_COLOR_MENU_LIGHT_CURSOR	メニューの薄いカーソル色を表す定数です。
SYSTEM_COLOR_NUM	パレットの総数を表す定数です。
SYSTEM_COLOR_SCROLL_BAR	スクロールバーの色を表す定数です。
SYSTEM_COLOR_SCROLL_BG	スクロールバーの背景色を表す定数です。
SYSTEM_COLOR_STATUS_BG1	画面下ステータスバーの色を表す定数です。
SYSTEM_COLOR_STATUS_BG2	画面下ステータスバーの色を表す定数です。
SYSTEM_COLOR_STATUS_FONT	画面下ステータスバーのフォント色を表す定数です。

int[] getSystemColors()
全パレットの色配列を取得します。

void setSystemColors(int[] rgb)
全パレットの色配列を指定します。

---

キー入力（イベント処理）

int getKey()
イベントを取得します。
返値の上位16bit

EVENT_KEY	キープレスイベントを表す定数です。
EVENT_ACTIVATE	jigletが活性状態になったことを表す定数です。
EVENT_CLOSE	端末が閉じられたことを表す定数です。
EVENT_HTTP	通信が完了したことを表す定数です。
EVENT_LAUNCHED	jigletの起動パラメータが渡されたことを定数です。
EVENT_MENU	メニュー選択のイベントを表す定数です。
EVENT_OPEN	端末があけられたことを表す定数です。

返値の下位16bit

返値上位16bitがEVENT_KEYの時
	KEY_SELECT	決定キーを表す定数です。
	KEY_UP	上キーを表す定数です。
	KEY_DOWN	下キーを表す定数です。
	KEY_RIGHT	右キーを表す定数です。
	KEY_LEFT	左キーを表す定数です。
	KEY_SOFT	右ソフトキーを表す定数です。
	KEY_IAPP	待受切替キー・クリアキーを表す定数です。
	KEY_0	0キーを表す定数です。
	KEY_1	1キーを表す定数です。
	KEY_2	2キーを表す定数です。
	KEY_3	3キーを表す定数です。
	KEY_4	4キーを表す定数です。
	KEY_5	5キーを表す定数です。
	KEY_6	6キーを表す定数です。
	KEY_7	7キーを表す定数です。
	KEY_8	8キーを表す定数です。
	KEY_9	9キーを表す定数です。
	KEY_ASTERISK	＊キーを表す定数です。
	KEY_POUND	＃キーを表す定数です。
	KEY_LAST	キーの最後を表す定数です。

void clearKey()
イベントキューのキー情報をクリアします。

int getKeypadState()
キーの押下状態をビット列で取得します。

boolean isKeyPressed(int key)
引数で指定されたキーが押されてるかどうか取得します。

---

文字列入力

String inputText(String init, int mode)
初期文字列と入力モードを指定し、文字列入力を行います。
返値

TEXT_ALPHA	半角入力モードを表す定数です。
TEXT_KANA	全角入力モードを表す定数です。
TEXT_NUMBER	数値入力モードを表す定数です。

---

データ保存（スクラッチパッド）

byte[] readSP(int pos, int len)
スクラッチパッド（SD保存jigletの場合はSDカード）からデータを取得します。

boolean writeSP(int pos, byte[] dat)
スクラッチパッド（SD保存jigletの場合はSDカード）にデータを保存します。

int getLengthSP()
使用可能なスクラッチパッドの長さを取得します。

boolean setLengthSP(int size)
使用スクラッチパッドサイズを引数sizeに変更します。

int getFreeSizeSP()
本体のスクラッチパッド（SD保存jigletの場合はSDカード)の空き容量を取得します。

---

その他の処理

配列のコピー

void arraycopy(Object o1, int idx1, Object o2, int idx2, int len)
配列のコピーを行います。

文字列の整数化

int parseInt(String str)
文字列をintに変換します。

乱数

int random(int n)
0から(n-1)までのランダムな値を返します。

Base64

String encodeBase64(byte[] data)
渡されたバイト配列をBase64形式でエンコードします。

---

リソース

byte[] getResource(String str)
データをリソースファイルから取得します エラーの場合はnullが返ります。

Image getImage(String fn)
画像オブジェクトをリソースファイルから取得します。
→ 描画

Sound getSound(String str)
音声オブジェクトをリソースファイルから取得します。
→ 音声

---

ダイアログ

int showDialog(String str, int type)
ダイアログを表示します。
type

DIALOG_TYPE_NO_YES	NO_YESダイアログを表す定数です。
DIALOG_TYPE_OK	OKダイアログを表す定数です。
DIALOG_TYPE_YES_NO	YES_NOダイアログを表す定数です。

返値

DIALOG_YES	ダイアログのYESボタンを表す定数です。
DIALOG_NO	ダイアログのNOボタンを表す定数です。
DIALOG_OK	ダイアログの決定ボタンを表す定数です。

---

日付時間

long currentTime()
現在の時刻をlongで取得します。

void setTime(long st)
jigletで使うカレンダーオブジェクトの時刻をlongでセットします。

long getTime()
現在カレンダーオブジェクトに設定されている時刻をlongで取得します。

int getTime(int field)
jigletで使うカレンダーオブジェクトの指定した時間フィールドを取得します。
field

CALENDAR_YEAR	年を表す定数です。
CALENDAR_MONTH	月を表す定数です。
CALENDAR_DATE	月の日を表す定数です。
CALENDAR_DAY_OF_MONTH	月の日を表す定数です。(=CALENDAR_DATE)
CALENDAR_DAY_OF_WEEK	曜日を表す定数です。
CALENDAR_HOUR_OF_DAY	時間(0～23)を表す定数です。
CALENDAR_MINUTE	分(0～59)を表す定数です。
CALENDAR_SECOND	秒(0～59)を表す定数です。
CALENDAR_MILLISECOND	ミリ秒(0～999)を表す定数です。

void setTime(int field, int value)
jigletで使うカレンダーオブジェクトの時間を設定します。
field

CALENDAR_YEAR	年を表す定数です。
CALENDAR_MONTH	月を表す定数です。
CALENDAR_DATE	月の日を表す定数です。
CALENDAR_DAY_OF_MONTH	月の日を表す定数です。(=CALENDAR_DATE)
CALENDAR_DAY_OF_WEEK	曜日を表す定数です。
CALENDAR_HOUR_OF_DAY	時間(0～23)を表す定数です。
CALENDAR_MINUTE	分(0～59)を表す定数です。
CALENDAR_SECOND	秒(0～59)を表す定数です。
CALENDAR_MILLISECOND	ミリ秒(0～999)を表す定数です。

---

音声

Sound getSound(byte[] src)
バイト配列から音声オブジェクトを取得します。

Sound getSound(String str)
音声オブジェクトをリソースファイルから取得します。

void playSound(Sound snd)
音声を再生します。

void playSound(Sound snd, int channel)
チャンネル指定で音声を再生します。

void setVolume(int val)
再生音量を設定します。

void setVolume(int val, int channel)
指定したチャンネルの再生音量を設定します。

int getPlayTime()
音声が再生されたからの時間をmsec単位で取得します。

int getPlayTime(int channel)
指定したチャンネルの音声が再生されたからの時間をmsec単位で取得します。

int getMaxAudioChannel()
その機種がサポートする最大チャンネル数を返します。

int getState(STATE_MANNER)
マナーモードに設定されてるかどうかを表します。
返値

MANNER_OFF	マナーモードに設定されてないことを表します。
MANNER_ON	マナーモードに設定されていることを表します。

---

携帯電話連携

boolean saveImageToPhone(byte[] image)
指定した画像を端末に保存します。メソッド呼出し後、端末の保存確認画面に切り替わります。

boolean setConciergeImage(byte[] image)
jigブラウザで使用する待受画像を設定します。

Image getConciergeImage()
jigブラウザで待受画像としてに設定されている画像を取得します。

---

アプリ連携、ブラウザ連携

void launch(String url, int encode, int type)
引数で指定されたURLのjigletを起動します。
encode

ENCODE_NONE	jigブラウザ側でエンコードせず、URLを直接渡すことを表す定数です。
ENCODE_EUC	EUC-JP文字コードを表す定数です。
ENCODE_JIS	JIS(ISO-2022-JP)文字コードを表す定数です。
ENCODE_SJIS	Shift_JIS文字コードを表す定数です。
ENCODE_UTF8	UTF-8文字コードを表す定数です。

type

LAUNCH_TERMINATE	launch()後にjigletを終了することを表す定数です。
LAUNCH_KEEP_ALIVE	launch()後もjigletの処理を継続することを表す定数です。

String encodeURL(String str)
URLエンコードを行います。

byte[] getLaunchParameter()
jigletの起動パラメータを取得します。

int getLaunchType()
起動タイプを取得します。
返値

LAUNCHED_AS_TASK	単独のタスクとして起動されたことを表す定数です。
LAUNCHED_AS_TOOL	ブラウザのツールとして起動されたことを表す定数です。
LAUNCHED_AS_CONCIERGE	待受jigletとして起動されたことを表す定数です。

String selectURL()
ユーザが選択したjigletのURL、もしくはサイトのURLを取得します。

String getNameFromURL(String url)
引数で指定されたURLと一致するjigletの名前を取得します。

Image getIconImageFromURL(String url)
引数で指定されたURLと一致するjigletのアイコン画像を返します。

待ち受け用&anamel1)

void setWakeUpTimer(int time)
休眠状態から復帰するための時間をミリ秒で指定します。

int getState(STATE_SCREEN)
画面可視状態を表します。
返値

SCREEN_VISIBLE	液晶が可視状態であることを表す定数です。
SCREEN_INVISIBLE	液晶が非可視状態であることを表す定数です。

int getState(STATE_FOLDING)
端末開閉の状態を表します。
返値

FOLDING_OPEN	端末がオープン状態であることを表す定数です。
FOLDING_CLOSE	端末がクローズ状態であることを表す定数です。

int getState(STATE_SHOULD_SLEEP)
休眠に移行すべき状態を表します。
返値

SHOULD_SLEEP_YES	待受起動の場合に休眠に移行すべき状態であることを表します。
SHOULD_SLEEP_NO	待受起動の場合に処理を継続すべき状態であることを表します。

int getState(STATE_JIGLET)
jigletの状態を表します。
返値

JIGLET_ACTIVE	jigletの活性状態を表す定数です。
JIGLET_DEACTIVE	jigletの非活性状態を表す定数です。
JIGLET_NORMAL	jigletの通常状態を表す定数です。
JIGLET_SLEEP	jigletの休眠状態を表す定数です。

void setState(STATE_JIGLET, JIGLET_DEACTIVE)
アプリを非活性状態にします。

void setState(STATE_JIGLET, JIGLET_SLEEP)
アプリを休眠状態にします。

---

HTTP通信

byte[] getHTTP(String url)
指定されたURLにHTTP通信を行い、通信データをバイト列で返します。

byte[] getHTTP(String url, byte[] post)
指定されたURLにHTTP通信を行い、通信データをバイト列で返します。

int accessHTTP(String url, byte[] post)
指定されたURLへのHTTP非同期通信を開始し、通信データ受け取りを識別するIDを返します。通信が終了すると、EVENT_HTTPが返ります。
→ getKey()

byte[] getHTTP(int id)
accessHTTPメソッドで取得したバイト列を返します。

---

RSS（途中）

String[][] getRSSChannels()
RSSチャンネル情報を返します。
返値

RSS_CHANNEL_ID	RSSチャンネル配列のIDが格納されているインデックスです。
RSS_CHANNEL_ITEM_NUM	RSSチャンネル配列の記事個数が格納されているインデックスです。
RSS_CHANNEL_NEW_ITEM_NUM	RSSチャンネル配列の新着記事個数が格納されているインデックスです。
RSS_CHANNEL_SELECTED	RSSチャンネル配列のチャンネル選択状態が格納されているインデックスです。
RSS_CHANNEL_TITLE	RSSチャンネル配列のチャンネルタイトルが格納されているインデックスです。

String[][] getRSSItems(String channelID)
引数で指定したチャンネルの記事一覧を取得します。
返値

RSS_ITEM_ID	RSS記事配列のIDが格納されてるインデックスです。
RSS_ITEM_DATE	RSS記事配列の日付が格納されてるインデックスです。
RSS_ITEM_FLAG	RSS記事配列の未読・既読フラグが格納されてるインデックスです。
RSS_ITEM_TIME	RSS記事配列の時間が格納されてるインデックスです。
RSS_ITEM_TITLE	RSS記事配列のタイトルが格納されてるインデックスです。
RSS_ITEM_URL	RSS記事配列のURLが格納されてるインデックスです。

void setRSSItemFlag(String idStr, boolean flag)
引数で指定した記事の既読・未読状態を変更します。

void setChannelSelected(String idStr, boolean flag)
チャンネルの選択状態を変更します。

void deleteRSSItem(String idStr)
引数で指定した記事を削除します このメソッドを呼び出した後はflushRSS()メソッドを呼び出してください。

void flushRSS()
変更したRSSのデータをjigブラウザ側に反映させます。

void updateRSS()
RSSの更新を行います。

---

課金状態確認

int getState(STATE_CHARGED)
ユーザが課金済みかどうかを表します。
返値

CHARGED	ユーザが課金済みであることを表します。
NOT_CHARGED	ユーザが未課金であることを表します。

---

デバイス

boolean hasDevice(int device)
端末が引数で指定したデバイスをサポートしてるかどうかを返します。
device

DEVICE_SD	SDカードを表す定数です。
DEVICE_BARCODE_READER	バーコードリーダーを表す定数です。
DEVICE_CAMERA	カメラを表す定数です。
DEVICE_ANALOG	アナログ入力デバイスを表す定数です。
DEVICE_RADIO	ラジオを表す定数です。

バックライト

int getState(STATE_BACKLIGHT)
バックライトの状態を表します。
返値

BACKLIGHT_ON	バックライトが点灯状態であることを表す定数です。
BACKLIGHT_OFF	バックライトが消灯状態であることを表す定数です。

void setState(STATE_BACKLIGHT, BACKLIGHT_ON)
バックライトを点灯します。

void setState(STATE_BACKLIGHT, BACKLIGHT_OFF)
バックライトを消灯します。

振動

void vibrate(int time)
指定された時間だけ端末を振動させます。

赤外線通信（OBEX）

boolean sendOBEX(byte[] data, String name, String type)
赤外線を利用してデータを送信します。

boolean receiveOBEX()
赤外線データを利用したデータの受信を開始します。

byte[] getOBEXData()
直前のreceiveOBEX()で受信したデータを返します。

String getOBEXName()
直前のreceiveOBEX()で受信したデータのNAME属性を返します。

String getOBEXType()
直前のreceiveOBEX()で受信したデータのTYPE属性を返します。

バーコード

String readBarcode()
バーコードリーダーを起動し撮影した文字列を取得します。

赤外線リモコン

void sendIR(String irData)
リモコン用赤外線データを送信します。

カメラ

byte[] takePicture(int w, int h)
カメラを起動し撮影した画像を取得します。

アナログ

int getAnalogX()
アナログ入力デバイスのX方向の入力を返します。

int getAnalogY()
アナログ入力デバイスのY方向の入力を返します。

ラジオ（途中）

int seekRadio(boolean upward)
ラジオの周波数をシークし、受信可能な周波数を返します。

SEEK_RADIO_OFF	seekRadioの返り値で、ラジオ電源がOFFになってるためシークできなかったことを表す定数です(=0)
SEEK_RECEIVE_FAILED	seekRadioの返り値で、電波状況が悪いためシーク失敗したことを表す定数です(=-1)

STATE_RADIO_OFFTIMER	ラジオのオフタイマーを表す定数です。
オフタイマーオフ：-1
整数：ラジオをオフにするまでの時間（秒）

STATE_RADIO_VOLUME	ラジオの音量を表す定数です。
整数：0～100

STATE_RADIO_FREQUENCY	ラジオの周波数を表す定数です。
整数：周波数（AM_MINからAM_MAX、または、FM_MINからFM_MAX、または、下記定数）
STATE_RADIO_AM_MAX_FREQUENCY	ラジオの設定可能なAM最小周波数を表す定数です。
STATE_RADIO_AM_MIN_FREQUENCY	ラジオの設定可能なAM最小周波数を表す定数です。
STATE_RADIO_FM_MAX_FREQUENCY	ラジオの設定可能なFM最大周波数を表す定数です。
STATE_RADIO_FM_MIN_FREQUENCY	ラジオの設定可能なFM最小周波数を表す定数です。
RADIO_FREQUENCY_TV1	FMのTV1を表す周波数です。
RADIO_FREQUENCY_TV2	FMのTV2を表す周波数です。
RADIO_FREQUENCY_TV3	FMのTV3を表す周波数です。

STATE_RADIO_MODE	ラジオのステレオモードを表す定数です。
RADIO_MODE_AUTO	ラジオのステレオ属性が自動であることを表す定数です。
RADIO_MODE_MONAURAL	ラジオのステレオ属性がモノラルであることを表す定数です。

STATE_RADIO	ラジオの電源を表す定数です。
RADIO_ON	ラジオの電源ONであることを表す定数です。
RADIO_OFF	ラジオの電源OFFであることを表す定数です。

STATE_RADIO_OUTPUT	ラジオの出力先を表す定数です。
RADIO_OUTPUT_AUTO	ラジオの出力先がオートであることを表す定数です。
RADIO_OUTPUT_EARPHONE	ラジオの出力先がイヤホンであることを表す定数です。
RADIO_OUTPUT_SPEAKER	ラジオの出力先がスピーカーであることを表す定数です。

STATE_RADIO_TUNERTYPE	ラジオのチューナーの種類を表す定数です。
RADIO_TUNERTYPE_AM	AMを表す定数です。
RADIO_TUNERTYPE_FM	FMを表す定数です。