界面介绍
==============
Mixly软件主要分成图形化程序选择区、图形化程序编辑区、代码预览区、系统功能区、消息提示区。


.. image:: images/03Interface_introduction/interface0.png

图形化程序选择区
----------------
图形化程序选择区中包含了各类图形化程序，每一个类别中都包含多个图形化。通过将这些图形块拖动到图形化程序编辑区就可以完成编程。

.. image:: images/03Interface_introduction/block_area.png

程序编写区
------------------

.. image:: images/03Interface_introduction/block_coding_area.png

程序编写
+++++++++++++
我们通常把能完成一定功能的代码块拖动到该区域处进行连接。

程序删除
++++++++++++++++++++++++++
* 将不需要的代码拖到右下方的垃圾桶。
* 将不用的代码拖到最左侧的图形化程序选择区。
* 选中不用的代码后点击键盘Delete或者Backspace键。

程序缩放
+++++++++++++
在右下角垃圾桶上方有缩放按钮。

* 第一个按钮是图形块大小正常化并居中。
* 第二个是放大图形块。
* 第三个是缩小图形块。

当然也可以直接使用鼠标滚轮进行缩放。

程序整理
++++++++++++
当编写的程序比较多时，需要对程序进行整理。

在空白区右击，选择清理块。

.. Attention::	
	只有当有多个分离块时，才能进行整理。

.. image:: images/03Interface_introduction/clear_block.png

程序复制
+++++++++++
* 在图形块上右击，选择复制，会产生一个一样的块，但该方式只能复制一个块。

.. image:: images/03Interface_introduction/copy_block.png

* 先用鼠标拖住多个块，再按下Ctrl+C，Ctrl+V可以复制多块。

切换语言
+++++++++++++
在该区域的右上角，还可以选取语言的种类。

截止目前为止，Mixly可支持英语、西班牙语、简体中文及繁体中文。

.. image:: images/03Interface_introduction/language.png


撤销及重做
+++++++++++++
在选择语言的左边还有两个箭头，分别是撤销（undo，Ctrl + Z）及重做（redo，Ctrl + Y）。

撤销功能是当我们编写代码时误删代码后，便可点击左箭头或直接按Ctrl + Z来恢复误删代码。

而重做则是和Ctrl + Z相反，它是恢复上一步操作，该功能也可通过点击右箭头或直接键入Ctrl + Y 来实现。

帮助文档
+++++++++++
在选择语言的左侧?图标是帮助文档的链接，点击该图标可以打开帮助文档。

代码预览区
-------------
.. image:: images/03Interface_introduction/code_area.png

该区域可通过点击右侧深灰色箭头来显示或隐藏。

在图形化程序选择区拖拽图形块后，在代码编辑区会生成对应的代码。可以帮助用户掌握代码的学习。

.. Attention::	
	在该区域无法直接对代码进行编辑，需要点击图形化程序选择区左上角的 代码 按钮才能进行编辑。

消息提示区
++++++++++++++++

消息提示区通常是给学生予以信息反馈的场所。比如编译或上传进程中，编译或上传是否成功，如果失败原因是什么；或者是导入库是否成功等消息。

.. image:: images/03Interface_introduction/22-1.png

系统功能区
++++++++++++++++

系统功能区主要执行的功能有新建、打开、保存、另存为、导出库、导入库、管理库、编译、上传、选择主控板型号及端口、串口监视器及软件界面放大缩小等功能。

.. image:: images/03Interface_introduction/system_function.png

一般功能
----------

.. image:: images/03Interface_introduction/file_function.png

Mixly的一般功能包括新建、打开、保存、另存为，其中代码保存或另存为的格式为.mix或者.ino。

当用户需要打开已保存的文件时，可以先打开Mixly软件，再点击“打开”，找到*.mix文件。也可以直接双击*.mix文件打开。

库功能
-----------
为了方便用户使用及代码分享，Mixly特增加了库功能。库功能分别包括：导出库，导入库以及管理库。
当用户编写完一段代码后（比如语音播报），可这个代码集成在一个函数中（假设该函数为sayNum）。之后只需要点击导出库并给该库起个名字便能使用。

.. image:: images/03Interface_introduction/23-2.png

保存后就可以将该库上传至平台，供他人下载使用、学习。

当有人下载该代码后，可直接将该库进行导入并使用。点击导入库找到该文件的位置。

.. image:: images/03Interface_introduction/23-3.png

导入后界面会刷新，耐心等待1-2秒，便可在模块选择区见到新导入的库，同时，在消息提示区也会提示“导入自定义库成功！”接着可直接点击sayNum库，将指令拖入程序构建区，调用该函数即可。 

.. image:: images/03Interface_introduction/23-4.png

.. image:: images/03Interface_introduction/23-5.png

管理库的功能是可以对已导入的库进行重命名、删除和打开目录。

.. image:: images/03Interface_introduction/23-6.png

编译&上传
-------------

当用户编写完代码后，如果想要检查代码逻辑是否有误，可点击编译。

如果显示“编译失败”，则需要根据提示检查自己的代码，如显示“编译成功”则证明代码逻辑上无误，可上传。

如果出现“上传失败”，大多数情况插拔USB线即可解决该问题。

如果出现“上传成功”，则证明代码已上传至板子上。当然，如果用户对于代码逻辑信心十足，可直接点击上传按钮。

板卡&端口
----------------
.. image:: images/03Interface_introduction/23-7.png

当用户点击主控板下拉三角时即可看到有众多主控板型号可供选择。用户需按照当前手中主控板型号予以选择。

.. Attention::
	开始编程前就要先选择板卡，编写好程序再切换板卡将导致程序丢失。

.. image:: images/03Interface_introduction/board_select.png

选择好板卡后，还需要选择该板卡对应的端口号，端口号是计算机与板卡通信的通道。

.. image:: images/03Interface_introduction/23-9.png

串口监视器
--------------
串口监视器与模块选择区的通信模块中的串口通信指令一起使用。
可以用于输出变量、传感器数值等。


界面缩放
-----------------------
在串口监视器右侧有一个左右可拉的按钮，该按钮可放大或缩小Mixly整个界面的大小。

与程序构建区内的放大、缩小不同（该按钮只可放大或缩小程序构建区代码的大小），拖动缩放界面可放大除消息提示区外所有区域的大小。

.. image:: images/03Interface_introduction/23-11.png