Documented displayASS and incremented the version number to 1.4

CHANGELOG.md

@@ -3,6 +3,7 @@
 * **1.4.0**
  * Added a new method `commandJSON()`
  * Added an *options* parameter to the `load()` and `append()` methods to pass additional options to **mpv**
+ * Added a method `displayASS()` to make using *ass-formatted* subtitles easier. (Thanks to @AxelTerizaki)
 
 * **1.3.1**
  * Fixes `next()` and `prev()`. The mode was not propagated to **mpv** and instead of **strong** it is actually **force*

package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-mpv",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "A Node module for MPV",
   "main": "index.js",
   "scripts": {

readme.md

@@ -392,7 +392,23 @@ mpvPlayer.on('stopped', function() {
 
   Adjust the scale of the subtitles
 
+* **displayASS** (assMessage, duration, position=7)
 
+  Displays **ass-formated** subtitles. A good documentation about **ass** can be found [here](http://docs.aegisub.org/3.2/ASS_Tags/).
+
+  * `assMessage` the subitle text along with the **ass-tags**
+  * `duration` the time the subtitle should be displayed in *miliseconds*
+  * `position` where the subtitles are displayed. It works like a numpad (**5** being center and so on). The default is **7** - the top left corner
+
+  This method will add `${osd-ass-cc/0}` (along with the position tag) in front of your message, to enable **ass** formating and *parameter expansion*.
+
+  You cannot show two different subtitles at the same time, the newer one will overwrite the previous one. This is a limitation of **mpv**.
+
+  Unfortunately beforehand defined **ass styles** do not work, you have to style your subtitles using **ass-tags**
+
+  ```JavaScript
+  player.displayASS('{\\fsp10}Hey I'm a letter spaced subtitle in the center of the screen', 5000, 5);
+  ```
 
 ## Properties