# 我该如何使用Dogename？(适用于最新的版本)

*哈哈，终于开始写了，我都说鸽鸽我呀是不会咕的嘛*~ ╮(‵▽′)╭

此文章是Dogename的使用说明，它将指导您如何更好地使用这个点名工具。

> *使用一样新东西之前看看使用说明是个好习惯。* 🤔    *——我说的*

这个使用说明分为以下几个部分：(点击可直达)

### 1. 安装&开始使用
- [从哪弄来？](#从哪弄来)  
- [怎么配置环境？(很简单的！)](#怎么配置环境)  
- [运行&使用](#运行与使用)  

### 2. 名单管理
- [添加一个名字](#添加一个名字)  
- [懒人：批量添加名字(特别棒！)](#批量添加名字)  
    - 文字识别法
    - 复制粘贴法
- [删除名字](#删除名字)  
- [导入&导出名单](#名单的导入和导出)  
- [打乱名字](#打乱名字)

### 3. 选项设置
- [点名方面的](#点名方面的设置)  
    - 点名规则
    - 挑选次数
    - 挑选速度
    - 使用/不使用随机性更强的Java SecureRandom
    - 开启/不开启语言播报
- [语音报方面的](#语音播报方面的设置)  


### 4. 其他小功能的介绍&说明
- [历史记录](#历史记录)
- [小窗模式](#小窗模式)  






--------------------------------------------

被夹在分割线之中不得动弹~

--------------------------------------------







# 开始：使用说明



## 1. 安装&开始使用



### 从哪弄来
- 既然你能来到这里，基本上你已经有Dogename了吧？  

- 如果还真没有，那就去这里吧：[Github](https://github.com/eatenid/dogename/releases)  

不过在中国大陆内，Github的访问速度普遍偏慢，因此建议您下载不带运行环境的包，或者去[releases](https://github.com/lensferno/dogename/releases)页给出的其他下载方式。

### 怎么配置环境
本程序是用Java语言写成的，因此您的计算机需要有合适的Java运行环境才能运行Dogename。(跟Minecraft一样的道理)

- 如果您是从本程序过来的，那么恭喜，跳过这步吧！🥳

- 如果您下载的是附带有Java运行环境的Dogename，那么您也不需要配置Java运行环境。  

- 如果您都不是以上，您可以到[Java官网](https://www.java.com/)下载并安装，安装完成后，就好了。

### 运行与使用
- 很简单，如果您的Java环境已经没问题了，就可以直接运行“dogename.exe”开始玩耍。   
-  成功运行后，点击“安排一下”即可开始点名，不过此时还没有任何名字在名单中，因此您需要至少添加一个名字(或者先使用“数字模式”玩玩)。下面讲讲述如何添加一个或多个名字。



--------



## 2. 名单管理

首先，您需要点击主界面上的“名单管理”按钮，呼出名单管理面板，以便进行操作。此时名单列表会列出已经添加的名字。

### 添加一个或几个名字

1. 在名字输入框中输入想要添加的名字，如果输入多行名字，则可以同时添加对个名字(每一行识别为一个名字)。
2. 输入完成后，点击"添加"按钮，即可在名单列表中看到刚刚添加进去的名字。

### 批量添加名字
> 在上面“添加一个或几个名字”提到过，如果一行输入了一个名字，就可以同时添加多个名字(每一行识别为一个名字)。  
因此，根据这个原理，可以实现批量添加名字。  

以下提供两种批量添加名字的方法：  

*(您也可以自己摸索其他的批量添加方法，只要最后能够使得名字输入框中每行拥有一个名字即可)*

#### 1. 通过Dogename自带的OCR(文字识别)功能来截取屏幕上的名字。

*<u>**注意，由于百度AI平台开放接口的限制，免费识别精度下降，因此若文字太小或文字颜色与背景色相近，识别效果可能会大大下降**</u>*

- 点击名单管理面板上的“从屏幕上截取名字”，打开OCR模块。
- 打开其他含有欲添加名单的文件*(例如Excel表格、Word文档、座位表图片等或者其他显示了名字的程序)*。
- 然后切换到Dogename的文字识别窗口(注意请使显示了名字的界面保持显示)，点击“截屏并开始识别”按钮。此时Dogename的界面将会被隐藏，以便进行截图操作。等待大约0.5秒，屏幕将会出现跟随鼠标位置的竖线和横线，这是方便您剪裁定位的。
- 点击鼠标左键，选取*含有名字的区域*，松开鼠标后，将会完成截屏操作并开始识别。
- 识别完成后，文字识别界面左侧的文本框将会显示出识别出的名字。如果文字关系清楚，识别出来的结果就是一行一个名字。如果不是，您可以手动修改，使得*一行只有一个名字*
- 修改完成后，将识别结果复制下来，粘贴在名字输入框中。点击“添加”按钮，即可完成添加。

下面的动图演示了如何进行这一操作：    

（原图：https://i.loli.net/2021/09/19/8oaldPZ5cLprYtI.gif）

<img src="https://i.loli.net/2021/09/19/8oaldPZ5cLprYtI.gif" alt="如果图片没有显示出来的话请直接打开：https://i.loli.net/2021/09/19/8oaldPZ5cLprYtI.gif或本项目仓库中res文件夹里的ocr.gif" style="zoom: 50%;" />        




#### 2. 从Word、Excel等含有表格式名单列表的地方复制粘贴。
- 如果因为网络不畅或者其他原因无法使用文字识别功能，您可以使用这种办法。
- 在其中的表格里，如果竖着选中文本，复制粘贴到名单输入框后一般就能够一行一个名字。点击“添加”按钮，即可批量添加上名字。    

下面的动图演示了如何进行这一操作：  

（原图：https://i.loli.net/2021/09/19/qUtgHLyb3wm72Rc.gif）

<img src="https://i.loli.net/2021/09/19/qUtgHLyb3wm72Rc.gif" alt="如果图片没有显示出来的话请直接打开：https://i.loli.net/2021/09/19/qUtgHLyb3wm72Rc.gif或本项目仓库res文件夹中的excel.gif" style="zoom: 50%;" />    




### 删除名字
- 很简单，只需要在名单列表中选中欲删除的名字，点击“删除”按钮即可。
- 点击“删除所有”按钮会删除名单列表中的所有名字。
- 注意：除非已经备份好名单，否则无法撤销，请小心操作。

### 名单的导入和导出
- 点击“备份”按钮，选择将要保存名单的地方，输入好文件名，点击确定，即可保存。
- 点击“恢复”按钮，选择导出过的名单文件，点击确定，即可导入。  
注意：**导入名单会直接覆盖现有名单**，因此建议您在导入之前备份好现有名单。

### 打乱名字
- 点击“打乱顺序”按钮，将会把名单中的名字随机排列，在*一定程度上(不是很严格地)*提高随机性。



--------



## 3. 选项设置



### 点名的设置

这里讲介绍一下几个方面的设置：
1. 点名规则
2. 挑选次数
3. 挑选速度
4. 使用/不使用随机性更强的Java SecureRandom
5. 开启/不开启语言播报  



-------------这是分割线-------------



##### 1. 点名规则
- 通过设置此项，可以按以下规则进行挑选：  
    - ①被点过的名字不会再被点，跳过已被挑中的名字（人人有份，默认） 
    - ②被点过的名字还要被点，不跳过已点过的名字（概率均分）


##### 2. 挑选次数
- 您可以调节名字随机滚动的次数，滚动显示多少个名字后，才是真正被选中的名字。  
--范围：3至200次  
--默认值：随机次数(范围：100至250次)  
~~小问题:这个次数是不怎么准确的~~😓

##### 3. 挑选速度
- 通过调节滑动条，您可以设置名字滚动的速度。数值越大速度越快。若调节为0，则显示一个名字后，会过100ms才显示下一个名字，直至出现正真被挑选中的名字。默认值：80 (20ms)

##### 4. 设置是否使用Java SecureRandom
- 开启后，将使用Java SecureRandom来获得较强随机性的随机数，而不是普通的随机数算法。默认开启。如果您觉得开启后点名明显变卡(虽说不太可能)，可以尝试关闭。

##### 5.设置是否开启语言播报
- 开启后，点中名字后将会把被选中的名字用语音播放出来。默认开启。需要网络支持。如果因为各种原因无法/没必要播放，可以关闭这个功能。


### 语音播报的设置  
- 在这里，你可以设置播报人，以及其语速和语调(默认都是5)。


--------



## 4. 其他小功能的介绍&说明

#### 1. 历史记录
- 在这里，你可以查看最近2000条点名记录。当记录超过2000条时，将会自动清空历史记录，重新从0开始记录，当然，您也可以手动清空。
- 在搜索框输入文字后，点击“向上查找”或者“向下查找”按钮，可以查找出包含有您想要搜索的文字的记录。  
~~(该功能现阶段状况：容易出bug~~😫~~，已不打算解决)~~
#### 2. 小窗模式
- 点击主界面的“小窗模式”按钮，可以将窗口变成小版界面，仅保留“安排一下”和“恢复”按钮，以及一个用于显示名字的文本。此时窗口总在最前端，拖动非按钮区域可以移动窗口。点击“恢复”按钮即可恢复原来的窗口状态。  