Version 8.1.0

DKPlugins · Aug 30, 2019 · b699e1e · b699e1e
1 parent b22c42c
commit b699e1e
Show file tree

Hide file tree

Showing 12 changed files with 854 additions and 246 deletions.
diff --git a/DKTools.js b/DKTools.js
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 **Author**: DK
 
-**Version**: Public 8.0.1
+**Version**: Public 8.1.0
 
 **Description**: Library for RPG Maker MV. Contains many tools for developing.
 

diff --git a/dev/DKTools.js b/dev/DKTools.js
diff --git a/release/DKTools.js b/release/DKTools.js
diff --git a/src/DKTools.js b/src/DKTools.js
@@ -3,8 +3,8 @@ Title: DKTools
 Author: DK (Denis Kuznetsov)
 Site: https://dk-plugins.ru
 E-mail: kuznetsovdenis96@gmail.com
-Version: 8.0.1
-Release: 01.08.2019
+Version: 8.1.0
+Release: 29.08.2019
 First release: 13.01.2016
 Supported languages: Russian, English
 */
@@ -14,23 +14,23 @@ Supported languages: Russian, English
 Автор: DK (Денис Кузнецов)
 Сайт: https://dk-plugins.ru
 E-mail: kuznetsovdenis96@gmail.com
-Версия: 8.0.1
-Релиз: 01.08.2019
+Версия: 8.1.0
+Релиз: 29.08.2019
 Первый релиз: 13.01.2016
 Поддерживаемые языки: Русский, Английский
 */
 
 /*:
-* @plugindesc v.8.0.1 Library for RPG Maker. Made with ♥ by DKPlugins
+* @plugindesc v.8.1.0 Library for RPG Maker. Made with ♥ by DKPlugins
 * @author DK (Denis Kuznetsov)
 * @help
 
  ### Info about plugin ###
  Title: DKTools
  Author: DK (Denis Kuznetsov)
  Site: https://dk-plugins.ru
- Version: 8.0.1
- Release: 01.08.2019
+ Version: 8.1.0
+ Release: 29.08.2019
  First release: 13.01.2016
  Supported languages: Russian, English
  Thank you for your support: https://dk-plugins.ru/donate
@@ -45,7 +45,7 @@ E-mail: kuznetsovdenis96@gmail.com
  https://dk-plugins.ru/documentation/DKTools/index.html
 
  ### Requirements and dependencies ###
- Version of RPG Maker 1.6+
+ RPG Maker and project version 1.6+
 
  ### Instructions ###
 
@@ -98,6 +98,10 @@ E-mail: kuznetsovdenis96@gmail.com
  If the color of the ruler is not specified,
  random color will be selected automatically.
 
+ ### Preloading resources ###
+ To preload a whole folder with resources or a file with a non-standard path,
+ you must specify the "Path" in the "Text" tab instead of the "File" tab.
+
  ### Plugin commands ###
  1. Checks for plugins updates from DKPlugins
  DKPluginsCheckUpdates
@@ -181,12 +185,6 @@ E-mail: kuznetsovdenis96@gmail.com
  * @param New Functions
  * @default ---------------------------------
 
- * @param Print Detailed Error
- * @parent New Functions
- * @desc Detailed error display
- * @type struct<PrintDetailedError>
- * @default {"Enabled":"false","Error Message":"Game has encountered a bug. Please report it.","Restart Message":"Press F5 to restart the game."}
-
  * @param Functions
  * @default ---------------------------------
 
@@ -230,7 +228,7 @@ E-mail: kuznetsovdenis96@gmail.com
  * @parent Functions
  * @desc Preloading resources
  * @type struct<PreloadManager>
- * @default {"Enabled":"false","Debugging":"false","Images":"[]"}
+ * @default {"Enabled":"false","Debugging":"false","Audio Files":"[]","Image Files":"[]"}
 
  * @param Screenshots
  * @parent Functions
@@ -248,7 +246,7 @@ E-mail: kuznetsovdenis96@gmail.com
  * @parent Functions
  * @desc Tile size
  * @type struct<TileSize>
- * @default {"Enabled":"false","Size":"48"}
+ * @default {"Enabled":"false","Size":"48","Tilesets Folder":"img/tilesets/","Parallaxes Folder":"img/parallaxes/"}
 
  * @param Grid
  * @parent Functions
@@ -271,16 +269,16 @@ E-mail: kuznetsovdenis96@gmail.com
 */
 
 /*:ru
-* @plugindesc v.8.0.1 Библиотека для RPG Maker. Сделано с ♥ от DKPlugins
+* @plugindesc v.8.1.0 Библиотека для RPG Maker. Сделано с ♥ от DKPlugins
 * @author DK (Денис Кузнецов)
 * @help
 
  ### Информация о плагине ###
  Название: DKTools
  Автор: DK (Денис Кузнецов)
  Сайт: https://dk-plugins.ru
- Версия: 8.0.1
- Релиз: 01.08.2019
+ Версия: 8.1.0
+ Релиз: 29.08.2019
  Первый релиз: 13.01.2016
  Поддерживаемые языки: Русский, Английский
  Спасибо за Вашу поддержку: https://dk-plugins.ru/donate
@@ -295,7 +293,7 @@ E-mail: kuznetsovdenis96@gmail.com
  https://dk-plugins.ru/documentation/DKTools/index.html
 
  ### Требования и зависимости ###
- Версия мейкера 1.6+
+ Версия мейкера и проекта 1.6+
 
  ### Инструкции ###
 
@@ -348,6 +346,10 @@ E-mail: kuznetsovdenis96@gmail.com
  ### 3.2 ### Цвет линейки ###
  Если не указан цвет линейки, то автоматически будет выбран случайный цвет.
 
+ ### Предзагрузка ресурсов ###
+ Чтобы предзагрузить целую папку с ресурсами или файл с нестандартным путем,
+ необходимо указывать "Путь" во вкладке "Текст" вместо вкладки "Файл".
+
  ### Команды плагина ###
  1. Проверить обновления плагинов от DKPlugins
  DKPluginsCheckUpdates
@@ -434,13 +436,6 @@ E-mail: kuznetsovdenis96@gmail.com
  * @text Новые функции
  * @default ---------------------------------
 
- * @param Print Detailed Error
- * @text Детальное отображение ошибок
- * @parent New Functions
- * @desc Детальное отображение ошибок
- * @type struct<PrintDetailedError>
- * @default {"Enabled":"false","Error Message":"В игре обнаружена ошибка. Пожалуйста, сообщите об этом.","Restart Message":"Нажмите F5, чтобы перезапустить игру."}
-
  * @param Functions
  * @text Функции
  * @default ---------------------------------
@@ -492,7 +487,7 @@ E-mail: kuznetsovdenis96@gmail.com
  * @parent Functions
  * @desc Предварительная загрузка ресурсов
  * @type struct<PreloadManager>
- * @default {"Enabled":"false","Debugging":"false","Images":"[]"}
+ * @default {"Enabled":"false","Debugging":"false","Audio Files":"[]","Image Files":"[]"}
 
  * @param Screenshots
  * @text Скриншоты
@@ -513,7 +508,7 @@ E-mail: kuznetsovdenis96@gmail.com
  * @parent Functions
  * @desc Размер тайла
  * @type struct<TileSize>
- * @default {"Enabled":"false","Size":"48"}
+ * @default {"Enabled":"false","Size":"48","Tilesets Folder":"img/tilesets/","Parallaxes Folder":"img/parallaxes/"}
 
  * @param Grid
  * @text Сетка
@@ -536,6 +531,19 @@ E-mail: kuznetsovdenis96@gmail.com
  * @type struct<CursorGraphic>
  * @default {"Enabled":"false","Graphic": ""}
 
+ * @param Print Detailed Error
+ * @text Детальное отображение ошибок
+ * @parent Functions
+ * @desc Детальное отображение ошибок
+ * @type struct<PrintDetailedError>
+ * @default {"Enabled":"false","Error Message":"В игре обнаружена ошибка. Пожалуйста, сообщите об этом.","Restart Message":"Нажмите F5, чтобы перезапустить игру."}
+
+ * @param Print Detailed Error
+ * @parent Functions
+ * @desc Detailed error display
+ * @type struct<PrintDetailedError>
+ * @default {"Enabled":"false","Error Message":"Game has encountered a bug. Please report it.","Restart Message":"Press F5 to restart the game."}
+
 */
 
 /*~struct~FileSystem:
@@ -892,7 +900,8 @@ E-mail: kuznetsovdenis96@gmail.com
 /*~struct~PreloadManagerImage:
 
  * @param Path
- * @desc Path to file (with extension) or directory. For example, img/system/Window.png for file or img/system/ for directory
+ * @desc The path to the file or directory. Details in the help.
+ * @type file
 
  * @param Hue
  * @desc Hue
@@ -912,7 +921,8 @@ E-mail: kuznetsovdenis96@gmail.com
 
  * @param Path
  * @text Путь
- * @desc Путь к файлу (с расширением) или директории. Например, img/system/Window.png для файла или img/system/ для директории
+ * @desc Путь к файлу или директории. Подробности в справке.
+ * @type file
 
  * @param Hue
  * @text Оттенок
@@ -933,7 +943,8 @@ E-mail: kuznetsovdenis96@gmail.com
 /*~struct~PreloadManagerAudio:
 
  * @param Path
- * @desc Path to file (with extension) or directory. For example, audio/bgm/Battle1.ogg for file or audio/bgm/ for directory
+ * @desc The path to the file or directory. Details in the help.
+ * @type file
 
  * @param Caching
  * @desc Audio caching
@@ -946,7 +957,8 @@ E-mail: kuznetsovdenis96@gmail.com
 
  * @param Path
  * @text Путь
- * @desc Путь к файлу (с расширением) или директории. Например, audio/bgm/Battle1.ogg для файла или audio/bgm/ для директории
+ * @desc Путь к файлу или директории. Подробности в справке.
+ * @type file
 
  * @param Caching
  * @text Кэширование
@@ -1130,6 +1142,14 @@ E-mail: kuznetsovdenis96@gmail.com
  * @min 1
  * @default 48
 
+ * @param Tilesets Folder
+ * @desc Tilesets folder
+ * @default img/tilesets/
+
+ * @param Parallaxes Folder
+ * @desc Parallaxes folder
+ * @default img/parallaxes/
+
  */
 
 /*~struct~TileSize:ru
@@ -1147,6 +1167,16 @@ E-mail: kuznetsovdenis96@gmail.com
  * @min 1
  * @default 48
 
+ * @param Tilesets Folder
+ * @text Папка тайлсетов
+ * @desc Папка тайлсетов
+ * @default img/tilesets/
+
+ * @param Parallaxes Folder
+ * @text Папка параллакса
+ * @desc Папка параллакса
+ * @default img/parallaxes/
+
  */
 
 /*~struct~Grid:

diff --git a/src/DKTools/Base.js b/src/DKTools/Base.js
@@ -1067,7 +1067,7 @@ DKTools.Base = class {
      * Draws a character face
      * Returns true if successfully completed
      *
-     * @version 6.0.0
+     * @version 8.1.0
      *
      * @param {String} faceName - Face filename
      * @param {Number} faceIndex - Face index
@@ -1256,7 +1256,7 @@ DKTools.Base = class {
      * Draws an icon
      * Returns true if successfully completed
      *
-     * @version 6.0.0
+     * @version 8.1.0
      *
      * @param {Number} iconIndex - Icon index
      * @param {Object} [options={}] - Options for drawing
@@ -1300,7 +1300,7 @@ DKTools.Base = class {
      * Draws a name of the item
      * Returns true if successfully completed
      *
-     * @version 6.1.0
+     * @version 8.1.0
      *
      * @param {Object} item - Item
      * @param {Object} [options={}] - Options for drawing
@@ -1464,7 +1464,7 @@ DKTools.Base = class {
      *
      * @param {Object} options - Options for drawing
      *
-     * @param {PIXI.Polygon | PIXI.Point[] | PIXI.ObservablePoint[] | Point[] | Object[]} [options.points] - Polygon or Points or objects with parameters
+     * @param {PIXI.Point[] | PIXI.ObservablePoint[] | Point[] | Object[]} [options.points] - Points or objects with parameters
      * @param {String} [options.color] - Line color
      * @param {Number} [options.lineWidth] - Line width
      * @param {Number} [options.paintOpacity] - Change paint opacity
@@ -3038,6 +3038,8 @@ DKTools.Base = class {
     }
 
     /**
+     * @version 8.1.0
+     *
      * @param {Number} iconIndex
      * @param {Object} textState
      */

diff --git a/src/DKTools/Imported.js b/src/DKTools/Imported.js
@@ -7,7 +7,7 @@
  * @type {Object}
  */
 window.Imported = window.Imported || {};
-window.Imported.DKTools = '8.0.1';
+window.Imported.DKTools = '8.1.0';
 
 
 

diff --git a/src/DKTools/PreloadManager.js b/src/DKTools/PreloadManager.js
@@ -347,14 +347,15 @@ DKTools.PreloadManager = class {
     /**
      * Adds the object to preload queue
      *
+     * @version 8.1.0
      * @since 5.0.0
      * @private
      * @static
      *
      * @param {String} type - Type (audio or image)
      * @param {Object} object - Object with parameters
      *
-     * @param {String} object.path - Path to file or directory (only for local mode)
+     * @param {String} object.path - Path to file or directory
      * @param {Number} [object.hue] - Hue (only for images)
      * @param {Boolean} [object.caching] - Caching
      */
@@ -367,7 +368,7 @@ DKTools.PreloadManager = class {
             const entity = new DKTools.IO.Directory(object.path);
 
             if (entity.isDirectory()) {
-                if (DKTools.IO.isLocalMode()) {
+                if (DKTools.IO.isLocalMode() || DKTools.IO.mode === DKTools.IO.MODE_NWJS_STAMP) {
                     const options = { sync: true };
                     let files = [];
 
@@ -384,21 +385,28 @@ DKTools.PreloadManager = class {
                             return;
                         }
 
-                        this._queue[type][fullPath] = {
-                            ...object,
-                            path: fullPath
-                        };
+                        this._queue[type][fullPath] = { ...object, path: fullPath };
                     });
                 } else {
                     throw new Error('Web browsers and mobile phones cannot load directories!');
                 }
             } else {
-                const file = new DKTools.IO.File(object.path);
+                let path = object.path;
+
+                if (!path.includes('.')) {
+                    if (type === 'image') {
+                        path += '.png';
+                    } else if (type === 'audio') {
+                        path += '.ogg';
+                    }
+                }
+
+                const file = new DKTools.IO.File(path);
                 const fullPath = file.getFullPath();
 
                 if (file.isFile()) {
                     if (!this._queue[type][fullPath]) {
-                        this._queue[type][fullPath] = object;
+                        this._queue[type][fullPath] = { ...object, path };
                     }
                 } else {
                     console.error('This is not a file: ' + fullPath);