dogename的个人镜像,超前版本,GitHub:https://github.com/lensferno/dogename
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
dogename/res/usage.md

229 lines
10 KiB

# 我该如何使用Dogename?(适用于最新的版本)
*哈哈,终于开始写了,我都说鸽鸽我呀是不会咕的嘛*~ ╮(‵▽′)╭
此文章是Dogename的使用说明,它将指导您如何更好地使用这个点名工具。
> *使用一样新东西之前看看使用说明是个好习惯。* 🤔 *——我说的*
这个使用说明分为以下几个部分:(点击可直达)
### 1. 安装&开始使用
- [从哪弄来?](#从哪弄来)
- [怎么配置环境?(很简单的!)](#怎么配置环境)
- [运行&使用](#运行与使用)
### 2. 名单管理
- [添加一个名字](#添加一个名字)
- [懒人:批量添加名字(特别棒!)](#批量添加名字)
- 文字识别法
- 复制粘贴法
- [删除名字](#删除名字)
- [导入&导出名单](#名单的导入和导出)
- [打乱名字](#打乱名字)
### 3. 选项设置
- [点名方面的](#点名方面的设置)
- 点名规则
- 挑选次数
- 挑选速度
- 使用/不使用随机性更强的Java SecureRandom
- 开启/不开启语言播报
- [语音报方面的](#语音播报方面的设置)
### 4. 其他小功能的介绍&说明
- [历史记录](#历史记录)
- [小窗模式](#小窗模式)
--------------------------------------------
被夹在分割线之中不得动弹~
--------------------------------------------
# 开始:使用说明
## 1. 安装&开始使用
### 从哪弄来
- 呃嗯嗯嗯嗯嗯🤔...怎么说呢,既然你能来到这里,基本上你已经有Dogename了吧?
- 如果还真没有,那就去这里吧:[Github](https://github.com/eatenid/dogename/releases)
> 说一声:
> 文件“dogename.jar”为主程序文件。
> “dogename_with_jre”之类的文件是带有Java运行库的整合版本,如果您下载的是这个整合包,那么您就不必再配置运行环境,跳过b步骤了。
不过在中国大陆内,Github的访问速度普遍偏慢,因此建议您下载不带运行环境的包(dogeneme_no_jre),或者去下载页(releases页)给出的其他下载方式。
### 怎么配置环境
本程序是用Java语言写成的,因此您的计算机需要有合适的Java运行环境才能运行Dogename。(跟Minecraft一样的道理)
- 如果您是从本程序过来的,那么恭喜,您不用配置环境了!🥳
- 如果您下载的是附带有Java运行环境的Dogename,那么您也不需要配置Java运行环境。
- 如果您都不是以上,您可以到[Java官网](https://www.java.com/)下载并安装,安装完成后,就好了。
### 运行与使用
- 很简单,如果您的Java环境已经没问题了,就可以直接运行“dogename.exe”开始玩耍。
- 您也可以运行“dogename_hide.exe”来隐式运行dogename(就是不会有黑框框显示出来),不过直接使用“dogename.exe”可以*在一定程度上*帮助您排查为何不能运行(如果您按照说明去做*一般*不会出现这种情况)。
- 成功运行后,点击“安排一下”即可开始点名,不过此时还没有任何名字在名单中,因此您需要至少添加一个名字(或者先使用“数字模式”玩玩)。下面讲讲述如何添加一个或多个名字。
--------
## 2. 名单管理
首先,您需要点击主界面上的“名单管理”按钮,呼出名单管理面板,以便进行操作。此时名单列表会列出已经添加的名字。
### 添加一个或几个名字
1. 在名字输入框中输入想要添加的名字,如果输入多行名字,则可以同时添加对个名字(每一行识别为一个名字)。
2. 输入完成后,点击"添加"按钮,即可在名单列表中看到刚刚添加进去的名字。
### 批量添加名字
> 在上面“添加一个或几个名字”提到过,如果一行输入了一个名字,就可以同时添加多个名字(每一行识别为一个名字)。
因此,根据这个原理,可以实现批量添加名字。
以下提供两种批量添加名字的方法:
*(您也可以自己摸索其他的批量添加方法,只要最后能够使得名字输入框中每行拥有一个名字即可)*
##### 1. 通过Dogename自带的OCR(文字识别)功能来截取屏幕上的名字。
- 点击名单管理面板上的“从屏幕上截取名字”,打开OCR模块。
- 打开其他含有欲添加名单的文件*(例如Excel表格、Word文档、座位表图片等或者其他显示了名字的程序)*。
- 然后切换到Dogename的文字识别窗口(注意请使显示了名字的界面保持显示),点击“截屏并开始识别”按钮。此时Dogename的界面将会被隐藏,以便进行截图操作。等待大约0.5秒,屏幕将会出现跟随鼠标位置的竖线和横线,这是方便您剪裁定位的。
- 点击鼠标左键,选取*含有名字的区域*,松开鼠标后,将会完成截屏操作并开始识别。
- 识别完成后,文字识别界面左侧的文本框将会显示出识别出的名字。如果文字关系清楚,识别出来的结果就是一行一个名字。如果不是,您可以手动修改,使得*一行只有一个名字*
- 修改完成后,将识别结果复制下来,粘贴在名字输入框中。点击“添加”按钮,即可完成添加。
下面的动图演示了如何进行这一操作:
![如果图片没有显示出来的话请直接打开:https://www.example.com](https://www.example.com/gif.gif)
##### 2. 从Word、Excel等含有表格式名单列表的地方复制粘贴。
- 如果因为网络不畅或者其他原因无法使用文字识别功能,您可以使用这种办法。
- 在其中的表格里,如果竖着选中文本,复制粘贴到名单输入框后一般就能够一行一个名字。点击“添加”按钮,即可批量添加上名字。
下面的动图演示了如何进行这一操作:
![如果图片没有显示出来的话请直接打开:https://www.example.com](https://www.example.com/gif.gif)
### 删除名字
- 很简单,只需要在名单列表中选中欲删除的名字,点击“删除”按钮即可。
- 点击“删除所有”按钮会删除名单列表中的所有名字。
- 注意:除非已经备份好名单,否则无法撤销,请小心操作。
### 名单的导入和导出
- 点击“备份”按钮,选择将要保存名单的地方,输入好文件名,点击确定,即可保存。
- 点击“恢复”按钮,选择导出过的名单文件,点击确定,即可导入。
注意:**导入名单会直接覆盖现有名单**,因此建议您在导入之前备份好现有名单。
### 打乱名字
- 点击“打乱顺序”按钮,将会把名单中的名字随机排列,在*一定程度上(不是很严格地)*提高随机性。
--------
## 3. 选项设置
### 点名的设置
这里讲介绍一下几个方面的设置:
1. 点名规则
2. 挑选次数
3. 挑选速度
4. 使用/不使用随机性更强的Java SecureRandom
5. 开启/不开启语言播报
-------------这是分割线-------------
##### 1. 点名规则
- 通过设置此项,可以按以下规则进行挑选:
- ①被点过的名字还要被点
- ②被点过的名字不会再被点(默认使用)
- ~~娱乐模式*(①模式下可用)* ~~ *(已移除)*
- 机会均等*(②模式下可用,默认使用)*
介绍:
- **娱乐模式**:旧称“套路模式”,勾选后会使被点过的名字在挑选列表中多出现4到5次,增加再次被点中的几率。
**注意:仅在勾选此模式后点中的名字才会被多增加4到5次,不勾选时选中的名字不受影响。
退出后会自动重置,不影响下次使用。**
- **机会均等**:勾选“机会均等”后,将会保存已点过的的名字和数字到文件中,下次启动时仍不会被点到,直到全部名字或数字被点完 或点击“机会均等”的“重置”按钮。
**注意:仅保存“这次点过就不点了”模式下选中的名字或数字。***
##### 2. 挑选次数
- 您可以调节名字随机滚动的次数,滚动显示多少个名字后,才是真正被选中的名字。
--范围:3至200次
--默认值:随机次数(范围:100至250次)
~~小问题:这个次数是不怎么准确的~~😓
##### 3. 挑选速度
- 通过调节滑动条,您可以设置名字滚动的速度。数值越大速度越快。若调节为0,则显示一个名字后,会过100ms才显示下一个名字,直至出现正真被挑选中的名字。默认值:80 (20ms)
##### 4. 设置是否使用Java SecureRandom
- 开启后,将使用Java SecureRandom来获得较强随机性的随机数,而不是普通的随机数算法。默认开启。如果您觉得开启后点名明显变卡(虽说不太可能),可以尝试关闭。
##### 5.设置是否开启语言播报
- 开启后,点中名字后将会把被选中的名字用语音播放出来。默认开启。需要网络支持。如果因为各种原因无法/没必要播放,可以关闭这个功能。
### 语音播报的设置
- 在这里,你可以设置播报人,以及其语速和语调(默认都是5)。
--------
## 4. 其他小功能的介绍&说明
#### 1. 历史记录
- 在这里,你可以查看最近2000条点名记录。当记录超过2000条时,将会自动清空历史记录,重新从0开始记录,当然,您也可以手动清空。
- 在搜索框输入文字后,点击“向上查找”或者“向下查找”按钮,可以查找出包含有您想要搜索的文字的记录。
~~(该功能现阶段状况:容易出bug~~😫~~,搜寻替代方案ing...)~~
#### 2. 小窗模式
- 点击主界面的“小窗模式”按钮,可以将窗口变成小版界面,仅保留“安排一下”和“恢复”按钮,以及一个用于显示名字的文本。这个时候窗口总在最前端,拖动非按钮区域可以移动窗口。点击“恢复”按钮即可恢复原来的窗口状态。