ag-psd 20.0.0 → 20.1.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## v20.1.0
+- Improve performance of encoding and decoding large text fields.
+- Added initial support for 32bit image data.
+- Fixed handling compressed encoding mode by switching to better compression library.
+
 ## v20.0.0
 - Added support for reading 16bit image data, when reading PSD width default settings 16bit data will be converted to regular 8bit canvases, when `useImageData: true` is passed in read options the image data will be of type `Uint16Array` for 16bit images. Because of that type of `layer.imageData` and `psd.imageData` and `layer.mask.imageData` can be of different types depending on PSD file bitDepth.
 - Added support for reading image data compressed with zip with prediction mode.

package/README_PSD.md

@@ -107,9 +107,21 @@ const psd: Psd = {
 
 ## Bitmaps and image data
 
-Image data can be accessed from `psd.canvas` or `layer.canvas` fields by default. These fields store regular HTMLCanvasElement (or node-canvas object when running in node.js). If `useImageData` option is set to true in read options then the image data will be available in `psd.imageData` and `layer.imageData` fields instead. Using image data option gives you direct access to pixel data without having to go through the canvas object, which bypasses alpha premultiplication and convertion from 16/32bit image data to 8bit canvas data.
+Image data can be accessed from `psd.canvas` or `layer.canvas` fields by default. These fields store regular HTMLCanvasElement (or node-canvas object when running in node.js). For 16bit and 32 bit documents image data will be converted to regular 8bit canvas (this will result in a loss of data, use `useImageData` option if you want to preserve precission of color data).
 
-For 16/32bit documents `imageData` fields will contain pixel data as `Uint16Array` or `Uint32Array` respectfully.
+If `useImageData` option is set to true in read options then the image data will be available in `psd.imageData` and `layer.imageData` fields instead. Using image data option gives you direct access to pixel data without having to go through the canvas object, which bypasses alpha premultiplication and convertion from 16/32bit image data to 8bit canvas data.
+
+For 16bit documents `imageData` fields will contain pixel data as `Uint16Array`, the values ranging from 0 to 65535.
+
+For 32bit documents `imageData` fields will contain pixel data as `Float32Array`, the values ranging from 0 to 1. 32bit values are in linear color space (as oposed to gamma corrected sRGB color). In order to convert the values to regular sRGB color space the values need to be gamma-corrected by using following conversion code (except alpha channel):
+
+```js
+// convert 32bit linear to 8bit sRGB
+destination[i] = Math.round(Math.pow(source[i], 1.0 / 2.2) * 255);
+
+// convert 8bit sRGB to 32bit linear
+destination[i] = Math.pow(source[i] / 255, 2.2);
+```
 
 ## Layers and Groups
 
@@ -241,7 +253,7 @@ Example layer structure:
 
   [](/files/blend-modes.png)
 
-- `canvas` (or `imageData`) see `canvas` property description in [Basic document structure](#basic-socument-structure)
+- `canvas` (or `imageData`) see `canvas` property description in [Basic document structure](#basic-document-structure)
 
   Vector, text and smart object layers still have image data with pregenerated bitmap. You also need to provide that image data when writing PSD files.
   
@@ -726,7 +738,7 @@ if ('l' in color) {
 }
 ```
 
-If you expect the fields to be in one specific format you can just verity that it's correct and throw an error if it's a format that you didn't expect:
+If you expect the fields to be in one specific format you can just verify that it's correct and throw an error if it's a format that you didn't expect:
 
 ```ts
 // handle only RGB colors

package/TODO

@@ -1,5 +1,7 @@
+writing 1, 16, 32 bit documents
 'pths'
 - cleanup errors from tests (make list of drawings that should ignore those errors)
+- writing zip/zip with prediction
 
 
 - can we remove sectionDivider property ?

package/dist/additionalInfo.js

@@ -1904,6 +1904,10 @@ addHandler('Lr16', function () { return false; }, function (reader, _target, _le
     (0, psdReader_1.readLayerInfo)(reader, psd, options);
 }, function (_writer, _target) {
 });
+addHandler('Lr32', function () { return false; }, function (reader, _target, _left, psd, options) {
+    (0, psdReader_1.readLayerInfo)(reader, psd, options);
+}, function (_writer, _target) {
+});
 addHandler('LMsk', hasKey('userMask'), function (reader, target) {
     target.userMask = {
         colorSpace: (0, psdReader_1.readColor)(reader),
@@ -2928,9 +2932,11 @@ addHandler('Txt2', hasKey('engineData'), function (reader, target, left) {
     var data = (0, psdReader_1.readBytes)(reader, left());
     target.engineData = (0, base64_js_1.fromByteArray)(data);
     // const engineData = parseEngineData(data);
+    // const engineData2 = decodeEngineData2(engineData);
     // console.log(require('util').inspect(engineData, false, 99, true));
-    // require('fs').writeFileSync('resources/engineData2Simple.txt', require('util').inspect(engineData, false, 99, false), 'utf8');
-    // require('fs').writeFileSync('test_data.json', JSON.stringify(ed, null, 2), 'utf8');
+    // require('fs').writeFileSync('test_data.bin', data);
+    // require('fs').writeFileSync('test_data.txt', require('util').inspect(engineData, false, 99, false), 'utf8');
+    // require('fs').writeFileSync('test_data.json', JSON.stringify(engineData2, null, 2), 'utf8');
 }, function (writer, target) {
     var buffer = (0, base64_js_1.toByteArray)(target.engineData);
     (0, psdWriter_1.writeBytes)(writer, buffer);