画面#

導入 #

screen クラスは brain 基本クラスから派生しています。これは、IQ (第 1 世代) Brain が内蔵スクリーンにテキストと値を表示する方法を制御します。

IQ（第1世代）Brainの画面は、最大5行21列のテキストに対応しています。

番号付きグリッドオーバーレイ（列1～21、行1～5）を備えたVEX IQ（第1世代）ブレイン。赤いオーバーレイ線がグリッド構造を強調し、矢印が列1、列21、行1、行2、行5のラベルを示しています。最初の行の上部には1から21までの数字が表示されます。

アクセス #

screen クラスには、以下の方法でアクセスできます。

Brain.Screen

注記 #

画面 screen はブレインによって提供されます。直接構築されるものではありません。
プロジェクトは単一の Brain を使用するため、画面関数は Brain.Screen使用して呼び出されます。

例 #

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the Brain
brain Brain = brain();

// Print text to the Brain screen
Brain.Screen.print("Hello!");

メンバーの機能 #

screen クラスには、以下のメンバ関数が含まれています。

print — フォーマットされたテキスト、数値、またはブール値を Brain の画面に表示します。
setCursor — テキストカーソルを指定された行と列に移動します。
newLine — 現在の行の残りをクリアし、カーソルを次の行に移動します。
clearLine — 現在の行の残りをクリアするか、指定した行をクリアします。
row — テキストが印刷される行を返します。
column — テキストが印刷される列を返します。
getStringHeight — 現在のフォントを使用して文字列の高さをピクセル単位で返します。
getStringWidth — 現在のフォントを使用して文字列の幅をピクセル単位で返します。
printAt — 書式設定されたテキストを x、y ピクセルの位置に印刷します (オプションで不透明にできます)。
clearScreen — 画面全体をクリアします（オプションで指定した色にすることもできます）。
setFont — 画面に印刷するフォントを設定します。
setPenWidth — 描画された線と図形の輪郭の太さを設定します。
setPenColor — テキスト、ピクセル、線、図形の輪郭の色を設定します。
setFillColor — 描画された図形と印刷されたテキストの背景の塗りつぶしの色を設定します。
setOrigin — 画面座標に使用する原点を設定します。
setClipRegion — 画面出力を矩形領域に制限します。
drawPixel — 座標に 1 つのピクセルを描画します。
drawLine — 2点間に線を描画します。
drawRectangle — 指定されたサイズの長方形を x、y の位置に描画します。
drawCircle — 指定された半径で、x、y の位置に円を描画します。
render — ダブルバッファリングを有効にするか、バックバッファを画面にレンダリングします。

screen メンバー関数を呼び出す前に、以下に示すように brain インスタンスを作成する必要があります。

// Create the Brain
brain Brain = brain();

print #

IQ（第1世代）Brainの画面に、テキスト、数字、またはブール値を表示します。

Available Functions

1 — 文字列リテラルまたは読み取り専用の C スタイルの文字列を使用して、書式設定されたテキストを出力します。
void print(
    const char* format,
    ... );

2 — 変更可能な文字配列を使用して書式設定されたテキストを出力します。
void print(
    char* format,
    ... );

Parameters

パラメータ	タイプ	説明
`format`	`const char*`	文字列リテラルまたは読み取り専用の C スタイルの文字列として提供されるフォーマット文字列 (例: `“Score: %d”`)。
`format`	`char*`	変更可能な文字配列として提供されるフォーマット文字列。
`…`		書式文字列に挿入される1つ以上の追加値。カンマで区切られます。

Return Values

この関数は値を返しません。

Notes

出力は画面上の現在のカーソル位置つまりから始まります。
印刷されたテキストには、現在の画面フォント使用されます。
印刷されたテキストは、現在のペンカラー使用します。
print で印刷されるテキストは常に背景付きで印刷され、背景色は現在の塗りつぶし色によって決定されます。
フォーマット文字列を使用する場合、渡される値の数と型は、文字列内のフォーマット指定子と一致する必要があります。

Examples

// Display a message at the starting cursor
Brain.Screen.print("Hello, Robot!");

setCursor #

IQ（第1世代）Brain画面上の特定の行と列にカーソルを移動します。次の print コマンドを実行すると、その位置から印刷が開始されます。

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

パラメータ	タイプ	説明
`row`	`int32_t`	カーソルを移動する行。
`col`	`int32_t`	カーソルを移動させる列。

Return Values

この関数は値を返しません。

Notes

print を使用する際に、後続のテキスト出力の開始位置に影響します。
行と列は現在設定されているスクリーンフォントに基づいています。
setCursor を呼び出すと、後続のテキスト出力の位置にのみ影響します。

Examples

// Print at row 3 column 7
Brain.Screen.setCursor(3, 7);
Brain.Screen.print("VEXcode!");

IQ（第1世代）ブレインスクリーンの中央に「VEXcode!」というテキストが表示されている。

newLine #

ブレイン画面の次の行の先頭にカーソルを移動します。

Available Functions

void newLine();

Parameters

この関数は引数を受け付けません。

Return Values

この関数は値を返しません。

Notes

カーソルが文の途中にある場合、 newLine カーソルの後の行をクリアしてから次の行に移動します。
newLineを呼び出すと、カーソルは次の行の最初の列に移動します。
カーソル位置と行番号は setCursor を使用して設定されます。

Examples

// Display two lines of text
Brain.Screen.print("First message");
Brain.Screen.newLine();
Brain.Screen.print("Second message");

IQ（第1世代）Brainの画面に「最初のメッセージ」と「2番目のメッセージ」が別々の行に表示されます。

clearLine #

IQ（第1世代）Brainの画面上の行からテキストを消去します。

Available Functions

1 — カーソル位置から現在の行の残りの部分をクリアします。
void clearLine();

2 — 現在設定されている塗りつぶしの色を使用して指定された行をクリアします。
void clearLine(
    int number );

3 — 定義済みまたはカスタムカラーオブジェクトを使用して、指定された行をクリアします。
void clearLine(
    int          number,
    const color& color );

4 — 16進数の色値を使用して、指定された行をクリアします。
void clearLine(
    int         number,
    const char* color );

5 — 色相値を使用して指定された行をクリアします。
void clearLine(
    int number,
    int hue );

Parameters

パラメータ	タイプ	説明
`number`	`int`	クリアする行番号。行番号は `1`から始まります。
`color`	`const color&`	Clears the row using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	16進数の色値を使用して行をクリアします（例： `“#000000”`）。
`hue`	`int`	`0`～`359`範囲の整数色相値を使用して行をクリアします。これは、カラーホイール上の度数を表します。

Return Values

この関数は値を返しません。

Notes

行をクリアしても、現在のカーソル位置は変わりません。
カーソル位置と行番号は setCursor を使用して設定されます。
IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。

Examples

// Display text on two rows
Brain.Screen.print("This text stays");
Brain.Screen.newLine();
Brain.Screen.print("This disappears");

// Wait 3 seconds before clearing row 2
wait(3, seconds);
Brain.Screen.clearLine(2);

row #

IQ（第1世代）Brainの画面上で、現在のカーソル行位置を返します。

Available Functions

int32_t row();

Parameters

この関数は引数を受け付けません。

Return Values

テキストが印刷される行を表す、 int32_t 整数値（int32_t）を返します。

行番号は1から始まります。

Notes

The cursor position is based on the current screen font.
返された値は、次に印刷される出力が表示される場所を示します。
行の値は、テキストが印刷されたとき、または setCursor が呼び出されたときに変更されます。

Examples

// Display the cursor's current row
Brain.Screen.setCursor(3, 12);
Brain.Screen.print("row: ", Brain.Screen.row());

column #

IQ（第1世代）Brainの画面にテキストが印刷される列を返します。

Available Functions

int32_t column();

Parameters

この関数は引数を受け付けません。

Return Values

テキストが印刷される列を表す、 int32_t を返します。

列番号は1から始まります。

Notes

The cursor position is based on the current screen font.
返された値は、次に印刷される出力が表示される場所を示します。
テキストが印刷されたとき、または setCursor が呼び出されたときに列の値が変更されます。

Examples

// Display the cursor's current column
Brain.Screen.print("column: ", Brain.Screen.column());

getStringHeight #

IQ（第1世代）Brainスクリーンに表示された文字列の高さをピクセル単位で返します。

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

パラメータ	タイプ	説明
`cstr`	`const char*`	計測対象のテキストは、Cスタイルの文字列として提供されます（例： `“Hello”`）。

Return Values

Brain画面にレンダリングされた際の文字列の高さ（ピクセル単位）を表す、 int32_t のint32_t値を返します。

Notes

返される高は、現在選択されているスクリーンフォントに依存します。
この関数は、画面に描画せずに文字列の長さを測定します。
返される高さは、文字列が印刷されたときにどのように表示されるかを示しています。

getStringWidth #

IQ（第1世代）Brainスクリーンに表示された文字列の幅をピクセル単位で返します。

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

パラメータ	タイプ	説明
`cstr`	`const char*`	計測対象のテキストは、Cスタイルの文字列として提供されます（例： `“Hello”`）。

Return Values

Brain画面にレンダリングされた際の文字列の幅をピクセル単位で表す、 int32_t int32_t値を返します。

Notes

返されるは、現在選択されているスクリーンフォントに依存します。
この関数は、画面に描画せずに文字列の長さを測定します。
返される幅は、文字列が印刷されたときにどのように表示されるかを示しています。

printAt #

IQ（第1世代）Brainの画面上の特定の座標に、テキスト、数字、またはブール値を印刷します。

Available Functions

1 — 指定されたピクセル位置にフォーマットされた出力を印刷します。
void printAt(
    int32_t    x,
    int32_t    y,
    const char* format,
    ... );

2 — 指定されたピクセル位置にフォーマットされた出力を印刷し、テキストの背景が不透明か透明かを設定します。
void printAt(
    int32_t    x,
    int32_t    y,
    bool       bOpaque,
    const char* format,
    ... );

Parameters

パラメータ	タイプ	説明
`x`	`int32_t`	画面原点を基準とした、印刷位置のx座標。
`y`	`int32_t`	画面原点を基準とした、印刷位置のy座標。
`bOpaque`	`bool`	印刷されたテキストを不透明に描画するか透明に描画するかを制御します。 `true` — 印刷されたテキストの背景は、現在の塗りつぶしの色を使用して塗りつぶされます。 `false` — テキストは透明に描画され、背景は塗りつぶされません。
`format`	`const char*`	画面に表示される内容を制御する書式文字列（例： `“Score: %d”`）。
`…`		書式文字列に挿入される1つ以上の追加値。カンマで区切られます。

Return Values

この関数は値を返しません。

Notes

x および y 座標は現在の画面原点に対する相対座標であり、setOrigin を使用して変更できます。
印刷されたテキストには、現在の画面フォント使用されます。
印刷されたテキストは、現在のペンカラー使用します。
フォーマット文字列を使用する場合、渡される値の数と型は、文字列内のフォーマット指定子と一致する必要があります。

Examples

// Print the number 1 at pixel (100, 40)
Brain.Screen.printAt(100, 40, 1);

clearScreen #

ブレインの画面上のすべての描画とテキストを消去します。

Available Functions

1 — 画面を黒くします。
void clearScreen();

2 — 定義済みまたはカスタムカラーオブジェクトを使用して画面をクリアします。
void clearScreen(
    const color& color );

3 — 16進数カラー値を使用して画面をクリアします。
void clearScreen(
    const char* color );

4 — 色相値を使用して画面をクリアします。
void clearScreen(
    int hue );

Parameters

パラメータ	タイプ	説明
`color`	`const color&`	Clears the screen using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	文字列として表される 16 進数の色値を使用して画面をクリアします (例: `“#000000”`)。
`hue`	`int`	色相環上の角度を表す、 `0`～`359`範囲の整数色相値を使用して画面をクリアします。

パラメータ

タイプ

説明

color

const color&

Clears the screen using a color object. Predefined colors include:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

This can also use a custom color object.

color

const char*

文字列として表される 16 進数の色値を使用して画面をクリアします (例: “#000000”)。

hue

int

色相環上の角度を表す、 0～359範囲の整数色相値を使用して画面をクリアします。

Return Values

この関数は値を返しません。

Notes

IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。

Examples

// Clear screen after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen();

// Clear screen to blue after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen(red);

setFont #

IQ（第1世代）Brainの画面に表示されるテキストに使用するフォントを設定します。

これは、print などのスクリーンテキスト関数を使用する際に、後続のテキスト出力に適用されるフォントを制御します。

Available Functions

void setFont(
  fontType font );

Parameters

パラメータ	タイプ	説明
`font`	`fontType`	フォントを以下のいずれかに設定します: `mono12` `mono15` `mono20` `mono30` `mono40` `mono60` `prop20` `prop30` 32 33 `prop40` `prop60` これらオプション以下に示されています。

パラメータ

タイプ

説明

font

fontType

フォントを以下のいずれかに設定します:

mono12
mono15
mono20
mono30
mono40
mono60
prop20
prop30 32 33

prop40

prop60

これらオプション以下に示されています。

Return Values

この関数は値を返しません。

Examples

// Display two different fonts on
// two separate lines
Brain.Screen.setFont(mono20);
Brain.Screen.print("Mono Medium");
Brain.Screen.newLine();
Brain.Screen.setFont(prop20);
Brain.Screen.print("Prop Medium");

setPenWidth #

描画される線と図形の輪郭の太さを設定します。

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

パラメータ	タイプ	説明
`width`	`uint32_t`	ペンの幅（ピクセル単位）。0～32の範囲で指定します。

Return Values

この関数は値を返しません。

Notes

ペン幅は、drawLine、drawRectangle、drawCircleなどの描画機能に適用されます。

Examples

// Draw a circle with a pen width of 5
Brain.Screen.drawCircle(40, 70, 20);
Brain.Screen.setPenWidth(5);
Brain.Screen.drawCircle(100, 70, 20);

setPenColor #

テキスト、ピクセル、線、図形の輪郭の色を設定します。

Available Functions

1 — 定義済みまたはカスタムカラーオブジェクトを使用してペンの色を設定します。
void setPenColor(
    const color& color );

2 — 16進数カラー値を使用してペンの色を設定します。
void setPenColor(
    const char* color );

3 — 色相値を使用してペンの色を設定します。
void setPenColor(
    int hue );

Parameters

パラメータ	タイプ	説明
`color`	`const color&`	Sets the pen color using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char*`	文字列として表される 16 進数の色値を使用してペンの色を設定します (例: `“#FF0000”`)。
`hue`	`int`	`0`～`359`範囲の整数色相値を使用してペンの色を設定します。これはカラーホイール上の角度を表します（たとえば、 `0` は赤、 `120` は緑、 `240` は青です）。

パラメータ

タイプ

説明

color

const color&

Sets the pen color using a color object. Predefined colors include:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char*

文字列として表される 16 進数の色値を使用してペンの色を設定します (例: “#FF0000”)。

hue

int

0～359範囲の整数色相値を使用してペンの色を設定します。これはカラーホイール上の角度を表します（たとえば、 0 は赤、 120 は緑、 240 は青です）。

Return Values

この関数は値を返しません。

Notes

IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。

Examples

Brain.Screen.drawRectangle(100, 50, 10, 20);
Brain.Screen.setPenColor(blue);
Brain.Screen.drawRectangle(50, 50, 10, 20);

setFillColor #

図形を描画する際に使用される塗りつぶし色を設定します。

Available Functions

1 — 定義済みまたはカスタムカラーオブジェクトを使用して塗りつぶしの色を設定します。
void setFillColor(
    const color& color );

2 — 16進数カラー値を使用して塗りつぶしの色を設定します。
void setFillColor(
    const char* color );

3 — 色相値を使用して塗りつぶしの色を設定します。
void setFillColor(
    int hue );

Parameters

パラメータ	タイプ	説明
`color`	`const color&`	Sets the fill color using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char*`	文字列として表される 16 進数の色値を使用して塗りつぶしの色を設定します (例: `“#00FF00”`)。
`hue`	`int`	`0`～`359`範囲の整数色相値を使用して塗りつぶしの色を設定します。これはカラーホイールの角度を表します（たとえば、 `0` は赤、 `120` は緑、 `240` は青です）。

パラメータ

タイプ

説明

color

const color&

Sets the fill color using a color object. Predefined colors include:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char*

文字列として表される 16 進数の色値を使用して塗りつぶしの色を設定します (例: “#00FF00”)。

hue

int

0～359範囲の整数色相値を使用して塗りつぶしの色を設定します。これはカラーホイールの角度を表します（たとえば、 0 は赤、 120 は緑、 240 は青です）。

Return Values

この関数は値を返しません。

Notes

IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。

Examples

// Draw a circle filled with yellow
Brain.Screen.setFillColor(yellow);
Brain.Screen.drawCircle(50, 50, 20);

setOrigin #

Brainの画面にグラフィックを描画する際に使用する原点を設定します。

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

パラメータ	タイプ	説明
`x`	`int32_t`	原点のx座標は、脳の画面の左上隅を基準として0から159までの範囲で表されます。
`y`	`int32_t`	原点のy座標は、脳の画面の左上隅を基準として0から107までの値をとります。

Return Values

この関数は値を返しません。

Notes

デフォルトの原点は、画面の左上隅の座標（0, 0）です。
原点は、drawLine、drawRectangle、drawCircle、およびprintAtなどの座標関数に適用されます。
起点は、再度変更されるかプロジェクトがリセットされるまで有効です。

setClipRegion #

画面上に、描画やテキストが表示される矩形領域を定義します。この領域外のコンテンツは表示されません。

Available Functions

void setClipRegion(
  int x,
  int y,
  int width,
  int height );

Parameters

パラメータ	タイプ	説明
`x`	`int`	クリップ領域の左上隅のx座標。0から159までの整数で指定します。
`y`	`int`	クリップ領域の左上隅のy座標。0から107までの整数で指定します。
`width`	`int`	クリップ領域の幅をピクセル単位で指定します。0から159までの整数値で表してください。
`height`	`int`	クリップ領域の高さ（ピクセル単位）。0から107までの整数で指定します。

Return Values

この関数は値を返しません。

Notes

描画機能は、クリップ領域の外側にある場合でも実行されますが、領域内の部分のみが表示されます。
x および y 座標は現在の画面原点に対する相対座標であり、setOrigin を使用して変更できます。
クリップ領域は現在のスレッドにのみ適用されます。
新しいクリップ領域を設定すると、現在のスレッドに対して以前に設定されたクリップ領域はすべて置き換えられます。

Examples

// Restrict text and drawings to a specific region
Brain.Screen.setClipRegion(0, 0, 120, 120);
Brain.Screen.drawRectangle(60, 60, 100, 100, red);
Brain.Screen.printAt(60, 60, "Cut off!");

drawPixel #

指定されたx座標とy座標に、IQ（第1世代）Brainの画面上に1ピクセルを描画します。

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

パラメータ	タイプ	説明
`x`	`int`	ピクセルが描画されるx座標。0から159までの整数で指定します。
`y`	`int`	ピクセルが描画されるy座標。0から107までの整数で指定します。

Return Values

この関数は値を返しません。

Notes

IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。
x および y 座標は、現在の画面原点に対する相対座標であり、setOrigin を使用して設定できます。
指定されたピクセル位置が画面の範囲外にある場合、そのピクセルは描画されません。

Examples

// Draw one pixel at the center 
// of the screen
Brain.Screen.drawPixel(80, 50);

drawLine #

IQ（第1世代）Brainの画面上の2点を結ぶ直線を描画します。

Available Functions

void drawLine(
  int x1,
  int y1,
  int x2,
  int y2 );

Parameters

パラメータ	タイプ	説明
`x1`	`int`	直線の開始位置を示すx座標。0から159までの整数で指定します。
`y1`	`int`	直線の開始y座標。0から107までの整数で指定します。
`x2`	`int`	直線の終点のx座標。0から159までの整数で表されます。
`y2`	`int`	直線の終点のy座標。0から107までの整数で表されます。

Return Values

この関数は値を返しません。

Notes

IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。
線の幅は、setPenWidth で設定された現在のペン幅によって決定されます。
x および y 座標は、現在の画面原点に対する相対座標であり、setOrigin を使用して設定できます。
線の一部が画面の境界外にある場合、表示されている部分のみが描画されます。

Examples

// Draw a line from the top left to 
// bottom right of the screen
Brain.Screen.drawLine(0, 0, 159, 107);

drawRectangle #

IQ（第1世代）Brainの画面上に、指定された位置とサイズの長方形を描画します。

Available Functions

1 — 現在設定されている塗りつぶしの色を使用して長方形を描画して塗りつぶします。
void drawRectangle(
    int x,
    int y,
    int width,
    int height );

2 — 定義済みまたはカスタムカラーオブジェクトを使用して長方形を描画および塗りつぶします。
void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const color&  color );

3 — 16進数カラー値を使用して長方形を描画し、塗りつぶします。
void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const char*   color );

4 — 色相値を使用して長方形を描画し、塗りつぶします。
void drawRectangle(
    int x,
    int y,
    int width,
    int height,
    int hue );

Parameters

パラメータ	タイプ	説明
`x`	`int`	長方形の左上隅のx座標。0から159までの整数で表されます。
`y`	`int`	長方形の左上隅のy座標。0から107までの整数で表されます。
`width`	`int`	長方形の幅。0から159までの整数で指定します。
`height`	`int`	長方形の高さ。0から107までの整数で指定します。
`color`	`const color&`	Fills the rectangle using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	16進数の色値を使用して長方形を塗りつぶします（例： `“#FF0000”`）。
`hue`	`int`	`0`–`359`の範囲の色相値を使用して長方形を塗りつぶします。

Return Values

この関数は値を返しません。

Notes

IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。
輪郭線の太さは、setPenWidthで設定された現在のペン幅によって決定されます。
x および y 座標は現在の画面原点に対する相対座標であり、setOrigin を使用して変更できます。
長方形の一部が画面の境界外にある場合、表示されている部分のみが描画されます。

Examples

// Draw a red rectangle on the screen
Brain.Screen.drawRectangle(25, 25, 100, 50, red);

drawCircle #

IQ（第1世代）Brainの画面上に、指定された位置と半径で円を描画します。

Available Functions

1 — 現在設定されている塗りつぶしの色を使用して円を描画し、塗りつぶします。
void drawCircle(
    int x,
    int y,
    int radius );

2 — 定義済みまたはカスタムカラーオブジェクトを使用して円を描画し、塗りつぶします。
void drawCircle(
    int           x,
    int           y,
    int           radius,
    const color&  color );

3 — 16進数カラー値を使用して円を描画し、塗りつぶします。
void drawCircle(
    int           x,
    int           y,
    int           radius,
    const char*   color );

4 — 色相値を使用して円を描画し、塗りつぶします。
void drawCircle(
    int x,
    int y,
    int radius,
    int hue );

Parameters

パラメータ	タイプ	説明
`x`	`int`	円の中心のx座標。0から159までの整数で表されます。
`y`	`int`	円の中心のy座標。0から107までの整数で表されます。
`radius`	`int`	円の半径。0～107ピクセルの整数で指定します。
`color`	`const color&`	Fills the circle using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	16進数の色値を使用して円を塗りつぶします（例： `“#FF0000”`）。
`hue`	`int`	円を `0`～`359`の範囲の色相値で塗りつぶします。

Return Values

この関数は値を返しません。

Notes

IQ（第1世代）Brainの画面はモノクロディスプレイなので、特定の色は画面に表示されません。
輪郭線の太さは、setPenWidthで設定された現在のペン幅によって決定されます。
x および y 座標は現在の画面原点に対する相対座標であり、setOrigin を使用して変更できます。

Examples

// Draw a green circle on the screen
Brain.Screen.drawCircle(80, 50, 20, green);

render #

Brainの画面でダブルバッファリングを有効にします。一度呼び出されると、テキストや図形などの描画機能は、プロジェクトの残りの部分ではすぐに表示されなくなります。代わりに、 render が再度使用されたときにのみ更新が表示されます。これにより、画面の更新がよりスムーズかつ制御しやすくなりますが、 render 使用されるまで何も表示されません。

Available Functions

1 — ダブルバッファリングを有効にするか、バックバッファを画面にレンダリングします。
bool render();

2 — 垂直同期動作とオプションのスケジューラ実行を制御しながら、バックバッファを画面にレンダリングします。
bool render(
    bool bVsyncWait,
    bool bRunScheduler = true );

Parameters

パラメータ	タイプ	説明
`bVsyncWait`	`bool`	`true` — 画面の垂直リフレッシュを待ってからレンダリングすることで、画面のティアリングを軽減します。 `false` — 画面の垂直リフレッシュを待たずにレンダリングします。
`bRunScheduler`	`bool`	Optional. `true` (default) — Allow background tasks to run while waiting to render. `false` — Do not allow background tasks to run while waiting to render.

パラメータ

タイプ

説明

bVsyncWait

bool

true — 画面の垂直リフレッシュを待ってからレンダリングすることで、画面のティアリングを軽減します。
false — 画面の垂直リフレッシュを待たずにレンダリングします。

bRunScheduler

bool

Optional.

true (default) — Allow background tasks to run while waiting to render.
false — Do not allow background tasks to run while waiting to render.

Return Values

バッファに保存された描画が画面に正常にレンダリングされたかどうかを示すブール値を返します。

true — 描画は画面に正常にレンダリングされました。
false — 描画は画面にレンダリングできませんでした。

Notes

render を呼び出すと、プロジェクトの残りの部分では render を使用する必要が生じます。

Examples

Brain.Screen.render();

// Draw text to the back buffer
Brain.Screen.print("Render later...");

// Wait for a screen press to render drawings
while (!Brain.Screen.pressing()) {
  wait(20, msec);
}
Brain.Screen.render();