# 更新日志

# v0.4.2

# 新特性

• core: 新增静态方法 Coordinate.polar, 根据极径和极角生成一个坐标.
• core: barrage.emitBullets 支持只传入 1 个参数作为要发射的子弹.
• core: 新增 field.setSpinner 方法, 可以实现加载时的动画.
• core: Barrage 新增内置参考点 center: 处于屏幕中央的点.

# 重大变化

• core: FieldOptions 中的 borderHeight 和 borderWidth 属性移动至 PlayerOptions.
• core: updater.setInterval 的 offset 参数改为目前到第一次调用之间的时间差; 当设置的这个值小于 0 时, 如果此时恰好处在一个周期上, 则会立即进行第一次调用.

# 修复与其他

• core: 修复了 Updater 中部分任务被重复执行的问题.
• core: 修复了擦弹结算结束后部分子弹仍留有擦弹效果的问题.
• core: 当 Field 无弹幕存在或处于加载状态时将不允许启动游戏.
• touhou: 新增了插件 th12, 里面含有对星莲船敌机的贴图支持.
• demo: 新增了符卡 [雨夜怪谈] 和 [深海漩涡].

# v0.4.1

# 新特性

• core: 实现了擦弹计数器 player.grazeCount. 每次擦弹将增加 1 擦弹数. 持续 config.grazeTimeout 帧擦弹将奖励 config.grazeBonus 擦弹数同时取消该子弹的后续擦弹判定. 中途如果停止擦弹将重置计时器.
• core: point 新增 spin 属性, 用于实现自旋. point.drawImage 方法将优先使用 spin 属性.
• core: point 新增 $action 属性, 用于实现敌机的特殊效果.
• core: field.setPlayer 和 field.setBarrage 方法支持传入异步函数作为参数了.
• core: stg.use 增加了第三个参数 once, 默认为 true, 即不会重复安装同一个插件.
• utils: memorize 函数新增可选的第二个参数 normalizer, 用于自定义对函数参数的处理.
• utils: 新增了两个配置:
  • cacheSize: 用于设置 math 中进行优化的函数的缓存队列的长度.
  • minValue: 用于设置 math 中部分函数的最小认可值, 小于该值的数将视为 0.

# 重大变化

• core: 删除了 field.getStatus 返回值的 bulletCount 属性.
• core: buildEmitter 方法的接口改动, 将能够支持更为复杂的配置.
• core: config 中的 fogEffectTimeout 等配置将并入 config.imageUpdate 中.

# 修复与其他

• utils: 对三角函数的计算进行了进一步优化, 提高了性能.
• touhou: 所有的文件实现了按需分离加载, 可以指定加载内容具体到文件.
• touhou: 插件 th15 增加了对哆来咪·苏伊特的贴图支持, 并使用到了符卡 [梦幻快车] 中.

# v0.4

# 新特性

• core: 实现了擦弹效果:
  • PlayerOptions 新增 grazeRadius 属性, 用于控制擦弹判定半径.
  • config 新增 grazeFilter 属性, 用于控制擦弹对应的滤镜效果.
• core: 重新实现了弹雾效果:
  • BulletAsset 新增 fogEffect 属性, 用于制定弹雾效果对应的弹型.
  • config 新增 fogEffectTimeout 属性, 用于控制子弹生成时弹雾效果的持续帧数.
• core: 实现了自机动画:
  • 通过 stg.buildEmitter 方法可以从文件生成一个自机 (敌机) 模板.
  • 将 PlayerOptions 的 display 钩子设定为对应的模板名称即可实现自机动画.
• core: PointOptions 和 PointTemplate 的 display 钩子新增了参数 displayTick, 表示该钩子函数从被绑定到调用时经过的逻辑帧数.
• touhou: 增加了官方插件 touhou.th15, 使用 stg.use 函数并提供资源即可加载东方绀珠传的部分子弹和自机数据.

# 重大变化

• core: 重写了 template 模块. 现在的 fieldType, judgeType 以及 display 钩子都可以通过 template 模块进行控制了. 新增了三个全局函数 defineTemplate, buildBullet 和 buildEmitter.
• touhou: @stg/bullets 包更名为 @stg/touhou, 用来维护更多东方 Project 相关的数据.

# 修复与其他

• core: 优化了资源的加载, 防止了重复加载的行为.
• core: scheduleLimit 和 maxBulletCount 被交由 config 进行处理.

# v0.3.2

# 新特性

• core: 增加了静态方法 Coordinate.from(), 作用是用给定的点构造坐标系.
• core: CanvasPoint 增加了属性 $barrage, 用于访问所处的弹幕实例.
• core: BulletOptions 新增了 blur 属性, 用于控制生成时的弹雾效果.
• core: FieldOptions 增加了下列属性:
  • control: 默认的自机控制模式.
  • borderWidth: 自机活动范围的边框宽度.
  • borderHeight: 自机活动范围的边框高度.
• core: BarrageOptions, PlayerOptions 增加了 assets 属性, 用于声明在构造前读取的资源文件.
• core: field.getStatus 返回对象增加了 bulletCount 属性, 表示当前弹幕中的子弹数量.
• core: buildFromImages 增加一个控制自旋的参数, 当子弹旋转对称时默认时将不计算旋转以提高性能.
• util: color 增加了 scheme4, scheme8 和 scheme16 属性作为东方 Project 风格的默认颜色方案.

# 修复与其他

• core: 修复了子弹处于斜向坐标系时出现的定位错误.
• core: 修复了参考点在 mounted 钩子中无法通过 $parent.$refs 访问自己的问题.
• demo: 新增了符卡 [污秽的纯化].
• demo: 在符卡 [梦幻快车] 中添加了鳞弹.

# v0.3.1

# 新特性

• core: 新增 loadImages, checkImages 和 loadAssets 方法, 用于加载全局资源.
• core: config 新增 publicPath, defaultColor, showWarning 三个属性.
• core: Updater 新增 $assets, $config 属性, 它们是对应模块的引用.
• core: 子弹模板现在可以使用 Query 字符串, 运行时将使用类似 CSS 的优先级进行渲染.
• core: BulletOptions 中的 judgeType 和 fieldType 属性都允许传入函数.
• core: 新增了 point.drawImage() 方法, 用于绘制来自资源文件的图形.
• core: 新增了 use 函数, 用于加载插件, 同时 bullets 模块也用插件的方式重新实现.
• bullets: 增加了对东方 Project 第二代引擎 (风神录后) 的部分弹型的支持.
• bullets: 新增了 colorSeries 对象, 包含了东方 Project 中默认的颜色系列.

# 重大变化

• core: 重写了 Template 模块, 实现了下面的函数:
  • defineTemplate: 加载子弹模板 (相当于过去的 Bullet.install).
  • buildFromImages: 从图片资源中直接生成子弹模板.
• core: 新的 BulletTemplate 仅支持 applied 和 display 两个钩子函数.
• core: BulletOptions 中的 extends 属性更名为 display, 同时允许传入函数.
• bullets: 将涉及场地和判定相关的函数从 bullets 模块放入 core 模块.

# 修复与其他

• 修复了 $ref 中默认包含 base 而非 origin 的问题.
• 移除了目前项目对 deepmerge 包的依赖.
• 打包时将生成多个入口文件:
  • stg.min.css: 所需的样式文件.
  • stg.common.js: 可直接在 NodeJS 环境下加载的模块.
  • stg.runtime.js: 应当在浏览器中加载使用的模块, 内置了所需的样式.

# v0.3

# 重大变化

• core: Looping 不再是 EventTarget 的子类, 对应的事件全部改用 onPause 等属性来实现.
• core: Looping 类的 onUpdate 事件更改为 onStats, 同时增加 statsInterval 属性用于控制其触发频率.
• core: 移除 looping.resume() 等方法中的 slient 参数.

# 新特性

• core: Looping 构造函数新增 skipFrame 参数, 可用于调整描画间隔.
• core: 新增 looping.initialize() 方法, 可以用于重新初始化实例.
• core: 新增 config.angleUnit, 用于配置采用的角度单位, 默认为 Math.PI.
• core: looping.getStatus() 返回对象新增 frameRate 属性, 表示当前物理帧数.

# v0.2.1

# 重大变化

• core: 移除 Bullet 构造函数的 rel 属性, 改为 origin, 同时支持传入 Point 类型.
• utils: 将库 utils.Random 更改为 random.

# 新特性

• core: 加入了默认的自机判定点颜色和大小.
• core: 当调用 scene.setBarrage() 方法时会自动清屏.
• utils: 新增库 utils.color, 用于处理颜色.

# v0.2

# 新特性

• core: 支持无自机模式 (观赏模式). 当不涉及自机时, 子弹会跳过碰撞判定.
• core: 自机新增属性 control, 用来决定是鼠标操控还是键盘操控.
• core: 类 Field 的大部分功能由新类 Scene 完成, 前者保留对外层 DOM 的控制.
• utils: 将 math 和 memorize 相关函数转移到 @stg/utils 下.

# 修复和其他

• core: 修复了 point.$coord 不及时更新的问题.
• bundle: 生成了源代码的 source map.