สีที่กำหนดเอง#

การแนะนำ #

คลาสสี color ใช้สำหรับกำหนดและแก้ไขสีสำหรับการวาดรูปทรงและการแสดงข้อความบนหน้าจอ V5 Brain Screen สามารถสร้างสีได้โดยใช้ค่า RGB, รหัสสีฐานสิบหก, ค่า HSV หรือค่าคงที่สีที่กำหนดไว้ล่วงหน้า

ตัวสร้างคลาส #

1 — Creates a color object with no assigned color.
color();

2 — สร้างวัตถุสี color จากค่าเลขฐานสิบหกหรือจำนวนเต็ม
color( 
  int value );

3 — สร้างวัตถุสี color จากค่า RGB
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

ตัวทำลายคลาส #

ทำลายวัตถุสี color และปล่อยทรัพยากรที่เกี่ยวข้อง

~color();

พารามิเตอร์#

พารามิเตอร์	พิมพ์	คำอธิบาย
`value`	`int`	ค่าสี ซึ่งอาจเป็นจำนวนเต็ม RGB ในรูปแบบเลขฐานสิบหก (ตัวอย่างเช่น `0xFFF700`) หรือค่าคงที่สีที่กำหนดไว้ล่วงหน้าตามรายการด้านล่าง
`r`	`uint8_t`	จำนวนเต็มตั้งแต่ 0 ถึง 255 ซึ่งแทนส่วนประกอบสีแดง
`g`	`uint8_t`	จำนวนเต็มตั้งแต่ 0 ถึง 255 ซึ่งแทนส่วนประกอบสีเขียว
`b`	`uint8_t`	จำนวนเต็มตั้งแต่ 0 ถึง 255 ซึ่งแทนส่วนประกอบสีน้ำเงิน

หมายเหตุ #

รองรับค่าสีที่กำหนดไว้ล่วงหน้าดังต่อไปนี้:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

ตัวอย่าง #

// Create the color yellow using a hexadecimal value
color myYellow = color(0xFFF700);

// Create a color using RGB values
color myBlue = color(0, 100, 255);

// Create a color using a predefined constant
color myRed = color(red);

ฟังก์ชันสมาชิก #

คลาส color ประกอบด้วยฟังก์ชันสมาชิกต่อไปนี้:

rgb — อัปเดตสีโดยใช้ค่า RGB
hsv — อัปเดตสีโดยใช้ค่า HSV
web — อัปเดตสีโดยใช้สตริงสีเลขฐานสิบหกของเว็บ

ก่อนเรียกใช้ฟังก์ชันสมาชิก color ใดๆ จะต้องสร้างอินสแตนซ์ color ก่อน ดังแสดงด้านล่าง:

// Create a color using RGB values
color brainColor = color(255, 128, 0);

rgb #

อัปเดตสีของวัตถุที่มีอยู่ซึ่งมีสี color โดยใช้ค่า RGB

Available Functions

1 — อัปเดตออบเจ็กต์สีด้วยค่า RGB ที่บรรจุไว้
uint32_t rgb( 
  uint32_t value );

2 — อัปเดตออบเจ็กต์สีด้วยค่า RGB ที่แยกจากกัน
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`value`	`uint32_t`	ค่า RGB ที่บรรจุส่วนประกอบสีทั้งสามชนิดไว้ด้วยกัน
`r`	`uint8_t`	จำนวนเต็มตั้งแต่ 0 ถึง 255 ซึ่งแสดงถึงส่วนประกอบสีแดงของสีนั้น
`g`	`uint8_t`	จำนวนเต็มตั้งแต่ 0 ถึง 255 ซึ่งแสดงถึงส่วนประกอบสีเขียวของสีนั้น
`b`	`uint8_t`	จำนวนเต็มตั้งแต่ 0 ถึง 255 ซึ่งแสดงถึงส่วนประกอบสีน้ำเงินของสีนั้น

Return Values

ส่งคืนค่า uint32_t uint32_t ซึ่งแสดงถึงค่า RGB ที่บรรจุแล้วของสีที่อัปเดต

Examples

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.rgb(170, 40, 150);

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.rgb(0xAA2896);

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);

hsv #

อัปเดตสีของวัตถุที่มีอยู่ซึ่งมีสี color โดยใช้ค่าเฉดสี ความอิ่มตัว และความสว่าง

Available Functions

color& hsv( 
  uint32_t hue, 
  double   sat, 
  double   value );

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`hue`	`uint32_t`	จำนวนเต็มตั้งแต่ 0 ถึง 360 ที่แสดงถึงเฉดสี
`sat`	`double`	ค่าตัวเลขตั้งแต่ 0.0 ถึง 1.0 ซึ่งแสดงถึงความอิ่มตัวของสี
`value`	`double`	ค่าตัวเลขตั้งแต่ 0.0 ถึง 1.0 ซึ่งแสดงถึงความสว่างของสี

Return Values

ส่งคืนค่าอ้างอิงไปยังอ็อบเจ็กต์สี color ได้รับการอัปเดตแล้ว

Examples

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.hsv(300, 0.75, 0.78);

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);

web #

อัปเดตสีของวัตถุที่มีอยู่ซึ่งมีสี color โดยใช้ค่าเลขฐานสิบหกหรือค่าสีเว็บ

Available Functions

color& web( 
  const char* color );

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`color`	`const char*`	ค่าเลขฐานสิบหกหรือค่าสีเว็บที่กำหนดสีเฉพาะ (เช่น `“#FF0000”` สำหรับสีแดง)

Return Values

ส่งคืนค่าอ้างอิงไปยังอ็อบเจ็กต์สี color ได้รับการอัปเดตแล้ว

Examples

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.web("#AA2896");

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);