.. currentmodule:: tftlcd
.. _tftlcd.LCD43R:

class LCD43R -- 4.3寸RGB屏
===========================

LCD43R 类提供一个01Studio 4.3寸RGB屏控制接口，通过构建该对象可以轻松实现4.3寸RGB显示屏
的各种画图控制。

.. image:: https://docs.01studio.cc/data/picture/4_3RGB.png
    :alt: 01Studio 4.3' LCD picture
    :width: 700px

相关资料请点击下面链接:

* `01Studio 4.3' RGB显示屏原理图 <https://docs.01studio.cc/data/sch/4_3RGB.pdf>`_ (PDF)

示例::

    import tftlcd

    d = tftlcd.LCD43R(portrait=1)  #构建LCD对象
    d.fill((255, 255, 255))  #填充白色
    d.drawRect(0, 0, 100, 100, (255,0,0))  #画红色矩形
    d.printStr('Hello 01Studio!', 0, 0, (0,255,0))  #写字符
    d.Picture(0, 0, '/flash/curry.jpg')  #显示图片


构造函数
------------

.. class:: LCD43R(portrait=1)

    构建一个4.3寸RGB屏对象，参数如下：

	- ``portrait`` LCD显示方向：
	
		- ``1`` - 横屏，800*480 ，开发板默认方向；
		- ``2`` - 竖屏，480*800 ，1基础上顺时针旋转90°；	
		- ``3`` - 横屏，800*480 ，1基础上顺时针旋转180°；		
		- ``4`` - 竖屏，480*800 ，1基础上顺时针旋转270°。	

使用方法
--------------

.. method:: LCD43R.fill(color)

   全屏填充:

	- ``color`` RGB颜色数据，如:(255,0,0)表示红色。

.. method:: LCD43R.drawPixel(x,y,color)

   画点:

	- ``x`` 横坐标；
	- ``y`` 纵坐标；
	- ``color`` RGB颜色数据，如:(255,0,0)表示红色。

.. method:: LCD43R.drawLine(x0,y0,x1,y1,color)

   画线段:

	- ``x0`` 起始横坐标；
	- ``y0`` 起始纵坐标；
	- ``x1`` 结束横坐标；
	- ``y1`` 结束纵坐标；
	- ``color`` RGB颜色数据，如:(255,0,0)表示红色。

.. method:: LCD43R.drawRect(x,y,width,height,color,border=1,fillcolor=None)

   画矩形:

	- ``x`` 起始横坐标；
	- ``y`` 起始纵坐标；
	- ``width`` 宽度；
	- ``height`` 高度；
	- ``color`` 边框颜色，RGB颜色数据，如:(255,0,0)表示红色。
	- ``border`` 边框宽度，单位为像素，默认=1；
	- ``fillcolor`` 填充颜色，RGB颜色数据，如:(255,0,0)表示红色,默认=None表示不填充。	

.. method:: LCD43R.drawCircle(x,y,radius,color,border=1,fillcolor=None)

   画圆:

	- ``x`` 圆心横坐标；
	- ``y`` 圆心纵坐标；
	- ``radius`` 半径；
	- ``color`` 边框颜色，RGB颜色数据，如:(255,0,0)表示红色。
	- ``border`` 边框宽度，单位为像素，默认=1；
	- ``fillcolor`` 填充颜色，RGB颜色数据，如:(255,0,0)表示红色,默认=None表示不填充。

.. method:: LCD43R.printStr(text,x,y,color,backcolor=None,size=2)

   写字符:

	- ``text`` 字符，string类型；
	- ``x`` 起始横坐标；	
	- ``y`` 起始纵坐标；
	- ``color`` 字体颜色，RGB颜色数据，如:(255,0,0)表示红色。
	- ``backcolor`` 字体背景颜色，RGB颜色数据，如:(255,0,0)表示红色,默认=None。
	- ``size`` 字体尺寸，默认=2表示标准尺寸：
	
		- ``1`` - 小号；
		- ``2`` - 标准；
		- ``3`` - 中号；
		- ``4`` - 大号；

.. method:: LCD43R.Picture(x,y,filename,cached=True)

   显示图片，支持图片格式：jpg/bmp。最大尺寸480*800

	- ``x`` 起始横坐标；
	- ``y`` 起始纵坐标；
	- ``filename`` 路径+名称，如："/flash/cat.jpg"、"/sd/dog.bmp"
	- ``cached`` 使用缓存文件，默认True表示使用。使用缓存文件能提高显示速度。
	
.. method:: LCD43R.CachePicture(filename, path=filename + '.cache', replace=False)

   制作图片缓存文件，支持图片格式：jpg/bmp。最大尺寸480*800

	- ``filename`` 路径+名称，如："/flash/cat.jpg"、"/sd/dog.bmp"；
	- ``path`` 保存路径，默认filename + '.cache'表示和图片文件路径一致。文件格式为 '.cache'；
	- ``replace`` 是否覆盖已经存在的缓存文件，默认 replace=False 表示不覆盖。