Braiteoir Dath

Réamhrá

Úsáidtear an rang braiteoir datha colorsensor chun rochtain a fháil ar shonraí ón Braiteoir Datha. Úsáideann sé solas frithchaite chun rudaí a bhrath, dathanna a aithint, agus gile agus dath a thomhas.

Tógálaí Ranga

colorsensor Color1 = colorsensor(index);

Scriostóir Ranga

Scriosann sé an réad colorsensor agus scaoileann sé acmhainní gaolmhara.

virtual ~colorsensor();

Paraiméadair

Paraiméadar	Cineál	Cur síos
index	int32_t	An Port Cliste a bhfuil an Braiteoir Datha ceangailte leis, scríofa mar PORTx, áit a seasann x don uimhir phoirt (mar shampla, PORT1).

Samplaí

// Create an colorsensor instance in Port 1
colorsensor Color1 = colorsensor(PORT1);

Feidhmeanna na mBall

Áirítear leis an rang braiteoir datha colorsensor na feidhmeanna ball seo a leanas:

• setLight – Casann sé LED an Braiteora Datha air, as, nó go leibhéal gile socraithe.

• isNearObject – Tugann sé seo le fios an bhfuil réad gar don Braiteoir Datha nó nach bhfuil.

• detects – Tugann sé seo ar ais cibé an mbraitheann an Braiteoir Datha dath sonraithe nó nach mbraitheann.

• colorname – Seolann sé ainm an datha a bhraith an Braiteoir Dathanna ar ais.

• brightness – Tugann sé seo ar ais gile braite réada.

• hue – Tugann sé seo an luach datha braite ar ais.

Sula nglaotar ar aon fheidhmeanna colorsensor , ní mór sampla colorsensor a chruthú, mar a thaispeántar thíos:

/* This constructor is required when using VS Code.
Color Sensor configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create an colorsensor instance in Port 1
colorsensor Color1 = colorsensor(PORT1);

setLight

Socraíonn sé cumhacht solais LED an Braiteora Datha. Is féidir leis an solas cabhrú leis an Braiteoir Datha rudaí agus dathanna a bhrath níos soiléire.

Mura bhfuil solas an Braiteora Datha múchta, lasfar an solas má shocraítear cumhacht an tsolais os cionn 0%.

Má tá solas an Braiteora Datha lasta, múchfar an solas má shocraítear cumhacht an tsolais ag 0%.

Déanann céatadán níos airde an solas níos gile. Déanann céatadán níos ísle an solas níos laige.

Available Functions

1 — Casann sé an stiúir air nó as ag baint úsáide as ledState.

void setLight( 
  ledState  state );

2 — Casann sé an stiúir air go déine shonrach.

void setLight( 
  int32_t      intensity, 
  percentUnits units = percent );

Parameters

Paraiméadar	Cineál	Cur síos
state	ledState	Socraíonn sé an LED air nó as. ledState::on Casann sé an LED air ag gile 100%. ledState::off Casann sé as é.
intensity	int32_t	An leibhéal cumhachta chun an solas a shocrú ó 0 – 100.
units	percentUnits	An t-aonad a léiríonn déine an tsolais: percent / pct — faoin gcéad

Return Values

Ní thugann an fheidhm seo luach ar ais.

Examples

// Set the light power to 50 percent.
Color1.setLight(50, percent);

isNearObject

Filleann sé má bhraitheann an Braiteoir Datha réad in aice láimhe.

Available Functions

bool  isNearObject();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Seolann an fheidhm seo luach Booleanach a léiríonn an bhfuil réad in aice láimhe braite:

• true – Braitheann an Braiteoir Datha réad.

• false – Ní bhraitheann an Braiteoir Datha réad.

Examples

// If an object is detected by the Color Sensor, print
// "near object".
if (Color1.isNearObject()){
  Brain.Screen.print("near object");
}

detects

Tuairisceán má tá an Braiteoir Dathanna ag braith dath sonraithe.

Available Functions

1 — Detects a colorType.

bool detects( 
  colorType  color );

2 — Detects a vex::color.

bool detects( 
  vex::color  color );

Parameters

Paraiméadair	Cineál	Cur síos
color	colorType	Dath bailí: blue – Luach datha idir 196° agus 229° blue_green – Luach datha idir 140° agus 195° blue_violet – Luach datha idir 230° agus 239° green – Luach datha idir 84° agus 139° orange – Luach datha idir 21° agus 30° purple red – Luach datha idir 350° agus 14° red_orange – Luach datha idir 15° agus 20° red_violet – Luach datha idir 281° agus 350° violet – Luach datha idir 240° agus 280° white yellow – Luach datha idir 54° agus 74° yellow_green – Luach datha idir 75° agus 83° yellow_orange – Luach datha idir 31° agus 53°
color	vex::color	Dath saincheaptha bailí, nó ceann de na dathanna réamhshainithe atá liostaithe thuas.

Return Values

• true – Braitheann an Braiteoir Dathanna an dath.

• false – Ní bhraitheann an Braiteoir Datha an dath.

Examples

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Drive until a red object is seen
  Drivetrain.drive(forward);
  while (true) {
    if (Color1.detects(red)) {
      Drivetrain.stop();
      break;
    }
    wait(0.5, seconds);
  }
}

colorname

Tugann sé an dath is gaire a bhraitear ar ais.

Available Functions

colorType colorname();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Nuair a phriontáiltear go díreach é, taispeánann sé an luach uimhriúil a bhaineann leis an dath sin:

Dath	Luach Uimhriúil
none	0
red	1
green	2
blue	3
white	4
yellow	5
orange	6
purple	7
cyan	8
red_violet	9
violet	10
blue_violet	11
blue_green	12
yellow_green	13
yellow_orange	14
red_orange	15
black	16
transparent	17

Notes

• Cruthaítear an fheidhm convertColorToString go huathoibríoch ag VEXcode nuair a chumraítear Braiteoir Datha sa fhuinneog Gléasanna. Níl sé ar fáil ach amháin laistigh de thionscadail VEXcode IQ agus ní oibreoidh sé i dtimpeallachtaí eile.

• Agus colorname á úsáid lasmuigh de VEXcode, ba cheart comparáidí a dhéanamh go díreach le luach colorType — aon dath a thosaíonn le colorType:: (mar shampla, colorType::green nó colorType::red).

Examples

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Continuously check the detected color
  while (true) {

    // Compare the color name with "red"
    if (convertColorToString(Color1.colorname()) == "red") {
      Brain.Screen.print("Red object!");
    } else {
      Brain.Screen.print("Not red");
    }

    wait(0.5, seconds);
    Brain.Screen.clearScreen();
    Brain.Screen.setCursor(1, 1);
  }
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Continuously check the detected color
  while (true) {

    // Compare the color name with the colorType
    if (Color1.colorname() == colorType::red) {
      Brain.Screen.print("Red object!");
    } else {
      Brain.Screen.print("Not red");
    }

    wait(0.5, seconds);
    Brain.Screen.clearScreen();
    Brain.Screen.setCursor(1, 1);
  }
}

brightness

Tugann sé seo an méid solais a léirítear ón réad ar ais.

Ciallaíonn céatadán níos airde go léirítear níos mó solais ar ais chuig an Braiteoir Datha. Ciallaíonn céatadán níos ísle go léirítear níos lú solais ar ais.

Available Functions

double  brightness(bool bRaw = false);

Parameters

Paraiméadar	Cineál	Cur síos
bRaw	bool	Luach Booleánach chun sonraí gile amha a léamh in ionad céatadáin. Is é false an luach réamhshocraithe.

Return Values

Dúbailt a léiríonn an gile a bhraith an Braiteoir Datha sa raon 0 - 100%, nó dúbailt a léiríonn na sonraí amha a bhraith an braiteoir.

Examples

// Set a variable, brightness, to the value of the brightness
// detected by the Color Sensor
double brightness = Color1.brightness();

// Print the brightness detected by the Color Sensor to the
// Brain's screen
Brain.Screen.print(brightness);

hue

Tugann sé seo an dath a bhraith an Braiteoir Datha ar ais.

Is bealach é lí chun dath a chur síos trí uimhreacha a úsáid timpeall ar roth datha.

Available Functions

double hue();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Dúbailt a léiríonn luach an datha a bhraith an Braiteoir Datha sa raon 0 — 359.00.

Examples

// Set a variable, hue, to the value of the hue detected
// by the Color Sensor.
double hue = Color1.hue();