Reference   Language | Libraries | Comparison | Changes

TFTLibrary > TFT

circle

Description

Draws a circle on the screen.

The circle is drawn relative to its center point, which means the total diameter will always be an odd number.

Syntax

screen.circle(xPos, yPos, radius);

Parameters

  • xPos : int, the location of the center of the circle on the x axis
  • yPos : int, the location of the center of the circle on the y axis
  • radius : int, the radius of the circle

Returns

int : the width of the screen in pixels

Example

#include <SPI.h>
#include <TFT.h>            // Arduino TFT library

#define cs   10
#define dc   9
#define rst  8

TFT screen = TFT(cs, dc, rst);

void setup() {
  // initialize the screen
  screen.begin();

  // make the background black
  screen.background(0,0,0);

  // set the stroke color to white
  screen.stroke(255,255,255);

  // set the fill color to grey
  screen.fill(127,127,127);

  // draw a circle in the center of screen
  screen.circle(screen.width()/2, screen.height()/2, 10);
}

void loop() {

}

See also

Reference Home

Corrections, suggestions, and new documentation should be posted to the Forum.

The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.