Home Page | Language Reference (extended) | SD Reference | Libraries | Comparison | Changes


TFTLibrary > TFT

PImage.isValid

Description

Checks if a named instance of PImage references a valid bitmap file.

Syntax

image.isValid();

Parameters

none

Returns

boolean

Example

// this example looks for a file named "logo.bmp"
//  on the SD card, and renders it to the screen
#include <Esplora.h>
#include <SD.h>
#include <SPI.h>
#include <TFT.h>            // Arduino TFT library #define SD_CS    8  // Chip select line for SD card in Esplora PImage logo; void setup ( ) {
  // initialize the screen
  EsploraTFT.begin ( ) ;
  // initialize the SD card
  SD.begin (SD_CS) ;
  // set the background the black
  EsploraTFT.background ( 0 , 0 , 0 ) ;   // load the image into the named instance of PImage
  logo = EsploraTFT.loadImage ( "arduino.bmp" ) ;   // if it is a valid image file, turn the Esplora's LED green
   if (logo.isValid ( ) ) {
       Esplora.writeGreen ( 255 ) ;
  }
  else {
  // if it is not valid, turn the LED red
    Esplora.writeRed ( 255 ) ;
  }   // draw the image on the screen starting at the top left corner
  EsploraTFT.image (logo, 0 , 0 ) ; } 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.