136 lines
6.1 KiB
Plaintext
136 lines
6.1 KiB
Plaintext
The original starting point for this library was the Adafruit_ILI9341
|
|
library in January 2015.
|
|
|
|
The licence for that library is MIT.
|
|
|
|
The first evolution of the library that led to TFT_eSPI is recorded here:
|
|
|
|
https://www.instructables.com/id/Arduino-TFT-display-and-font-library/
|
|
|
|
Adafruit_ILI9341 ORIGINAL LIBRARY HEADER:
|
|
|
|
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvStartvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
|
This is our library for the Adafruit ILI9341 Breakout and Shield
|
|
----> http://www.adafruit.com/products/1651
|
|
|
|
Check out the links above for our tutorials and wiring diagrams
|
|
These displays use SPI to communicate, 4 or 5 pins are required to
|
|
interface (RST is optional)
|
|
Adafruit invests time and resources providing this open source code,
|
|
please support Adafruit and open-source hardware by purchasing
|
|
products from Adafruit!
|
|
|
|
Written by Limor Fried/Ladyada for Adafruit Industries.
|
|
MIT license, all text above must be included in any redistribution
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^End^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
Selected functions from the Adafruit_GFX library (as it was in 2015) have
|
|
been imported into the TFT_eSPI.cpp file and modified to improve
|
|
performance, add features and make them compatible with the ESP8266 and
|
|
ESP32.
|
|
|
|
The fonts from the Adafruit_GFX and Button functions were added later.
|
|
The fonts can be found with the license.txt file in the "Fonts\GFXFF"
|
|
folder.
|
|
|
|
The Adafruit_GFX functions are covered by the BSD licence.
|
|
|
|
Adafruit_GFX ORIGINAL LIBRARY LICENSE:
|
|
|
|
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvStartvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
|
|
|
Software License Agreement (BSD License)
|
|
|
|
Copyright (c) 2012 Adafruit Industries. All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
- Redistributions of source code must retain the above copyright notice,
|
|
this list of conditions and the following disclaimer.
|
|
- Redistributions in binary form must reproduce the above copyright notice,
|
|
this list of conditions and the following disclaimer in the documentation
|
|
and/or other materials provided with the distribution.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^End^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Due to the evolution of the TFT_eSPI library the original code may no longer
|
|
be recognisable, however in most cases the function names can be used as a
|
|
reference point since the aim is to retain a level of compatibility with
|
|
the popular Adafruit_GFX graphics functions.
|
|
|
|
Contributions from other authors are recorded on GitHub:
|
|
https://github.com/Bodmer/TFT_eSPI
|
|
|
|
The major addition to the original library was the addition of fast
|
|
rendering proportional fonts of different sizes as documented here:
|
|
|
|
https://www.instructables.com/id/Arduino-TFT-display-and-font-library/
|
|
|
|
The larger fonts are "Run Length Encoded (RLE)", this was done to
|
|
reduce the font memory footprint for AVR processors that have limited
|
|
FLASH, with the added benefit of a significant improvement in rendering
|
|
speed.
|
|
|
|
In 2016 the library evolved significantly to support the ESP8266 and then
|
|
the ESP32. In 2017 new Touch Screen functions were added and a new Sprite
|
|
class called TFT_eSprite to permit "flicker free" screen updates of complex
|
|
graphics.
|
|
|
|
In 2018 anti-aliased fonts were added along with a Processing font conversion
|
|
sketch.
|
|
|
|
In 2019 the library was adapted to be able to use it with any 32 bit Arduino
|
|
compatible processor. It will run on 8 bit and 16 bit processors but will be
|
|
slow due to extensive use of 32 bit varaibles.
|
|
|
|
Many of the example sketches are original work, that contain code created
|
|
for my own projects. For all the original code the FreeBSD licence applies
|
|
and is compatible with the GNU GPL.
|
|
|
|
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvStartvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
|
Software License Agreement (FreeBSD License)
|
|
|
|
Copyright (c) 2020 Bodmer (https://github.com/Bodmer)
|
|
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
1. Redistributions of source code must retain the above copyright notice, this
|
|
list of conditions and the following disclaimer.
|
|
2. Redistributions in binary form must reproduce the above copyright notice,
|
|
this list of conditions and the following disclaimer in the documentation
|
|
and/or other materials provided with the distribution.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
|
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
|
|
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
The views and conclusions contained in the software and documentation are those
|
|
of the authors and should not be interpreted as representing official policies,
|
|
either expressed or implied, of the FreeBSD Project.
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^End^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|