psd 3.4.0 → 4.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +196 -149
- package/dist/descriptor.d.ts +20 -0
- package/dist/descriptor.d.ts.map +1 -0
- package/dist/descriptor.js +114 -0
- package/dist/descriptor.js.map +1 -0
- package/dist/engine-data.d.ts +11 -0
- package/dist/engine-data.d.ts.map +1 -0
- package/dist/engine-data.js +82 -0
- package/dist/engine-data.js.map +1 -0
- package/dist/image.d.ts +52 -0
- package/dist/image.d.ts.map +1 -0
- package/dist/image.js +301 -0
- package/dist/image.js.map +1 -0
- package/dist/index.d.ts +16 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +10 -0
- package/dist/index.js.map +1 -0
- package/dist/layer-info.d.ts +494 -0
- package/dist/layer-info.d.ts.map +1 -0
- package/dist/layer-info.js +529 -0
- package/dist/layer-info.js.map +1 -0
- package/dist/layer-styles.d.ts +160 -0
- package/dist/layer-styles.d.ts.map +1 -0
- package/dist/layer-styles.js +183 -0
- package/dist/layer-styles.js.map +1 -0
- package/dist/layer.d.ts +143 -0
- package/dist/layer.d.ts.map +1 -0
- package/dist/layer.js +249 -0
- package/dist/layer.js.map +1 -0
- package/dist/nodes.d.ts +233 -0
- package/dist/nodes.d.ts.map +1 -0
- package/dist/nodes.js +326 -0
- package/dist/nodes.js.map +1 -0
- package/dist/path-record.d.ts +34 -0
- package/dist/path-record.d.ts.map +1 -0
- package/dist/path-record.js +44 -0
- package/dist/path-record.js.map +1 -0
- package/dist/png.d.ts +10 -0
- package/dist/png.d.ts.map +1 -0
- package/dist/png.js +85 -0
- package/dist/png.js.map +1 -0
- package/dist/psd.d.ts +49 -0
- package/dist/psd.d.ts.map +1 -0
- package/dist/psd.js +106 -0
- package/dist/psd.js.map +1 -0
- package/dist/reader.d.ts +41 -0
- package/dist/reader.d.ts.map +1 -0
- package/dist/reader.js +100 -0
- package/dist/reader.js.map +1 -0
- package/dist/resources.d.ts +105 -0
- package/dist/resources.d.ts.map +1 -0
- package/dist/resources.js +173 -0
- package/dist/resources.js.map +1 -0
- package/dist/type-tool.d.ts +142 -0
- package/dist/type-tool.d.ts.map +1 -0
- package/dist/type-tool.js +222 -0
- package/dist/type-tool.js.map +1 -0
- package/package.json +26 -32
- package/src/descriptor.ts +141 -0
- package/src/engine-data.ts +86 -0
- package/src/image.ts +338 -0
- package/src/index.ts +38 -0
- package/src/layer-info.ts +578 -0
- package/src/layer-styles.ts +339 -0
- package/src/layer.ts +334 -0
- package/src/nodes.ts +411 -0
- package/src/path-record.ts +69 -0
- package/src/png.ts +92 -0
- package/src/psd.ts +133 -0
- package/src/reader.ts +125 -0
- package/src/resources.ts +273 -0
- package/src/type-tool.ts +270 -0
- package/.travis.yml +0 -5
- package/Cakefile +0 -61
- package/DEVELOPMENT.md +0 -27
- package/bower.json +0 -26
- package/docs/docco.css +0 -284
- package/docs/lib/psd/blend_mode.coffee.html +0 -72
- package/docs/lib/psd/channel_image.coffee.html +0 -81
- package/docs/lib/psd/color.coffee.html +0 -13
- package/docs/lib/psd/descriptor.coffee.html +0 -173
- package/docs/lib/psd/file.coffee.html +0 -78
- package/docs/lib/psd/header.coffee.html +0 -71
- package/docs/lib/psd/image.coffee.html +0 -94
- package/docs/lib/psd/image_export.coffee.html +0 -5
- package/docs/lib/psd/image_exports/png.coffee.html +0 -19
- package/docs/lib/psd/image_format.coffee.html +0 -8
- package/docs/lib/psd/image_formats/layer_raw.coffee.html +0 -9
- package/docs/lib/psd/image_formats/layer_rle.coffee.html +0 -10
- package/docs/lib/psd/image_formats/raw.coffee.html +0 -6
- package/docs/lib/psd/image_formats/rle.coffee.html +0 -37
- package/docs/lib/psd/image_mode.coffee.html +0 -7
- package/docs/lib/psd/image_modes/cmyk.coffee.html +0 -36
- package/docs/lib/psd/image_modes/greyscale.coffee.html +0 -17
- package/docs/lib/psd/image_modes/rgb.coffee.html +0 -32
- package/docs/lib/psd/init.coffee.html +0 -22
- package/docs/lib/psd/layer/blend_modes.coffee.html +0 -22
- package/docs/lib/psd/layer/blending_ranges.coffee.html +0 -29
- package/docs/lib/psd/layer/channel_image.coffee.html +0 -13
- package/docs/lib/psd/layer/helpers.coffee.html +0 -19
- package/docs/lib/psd/layer/info.coffee.html +0 -69
- package/docs/lib/psd/layer/mask.coffee.html +0 -11
- package/docs/lib/psd/layer/name.coffee.html +0 -15
- package/docs/lib/psd/layer/position_channels.coffee.html +0 -24
- package/docs/lib/psd/layer.coffee.html +0 -64
- package/docs/lib/psd/layer_info/blend_clipping_elements.coffee.html +0 -11
- package/docs/lib/psd/layer_info/blend_interior_elements.coffee.html +0 -11
- package/docs/lib/psd/layer_info/fill_opacity.coffee.html +0 -10
- package/docs/lib/psd/layer_info/gradient_fill.coffee.html +0 -12
- package/docs/lib/psd/layer_info/layer_id.coffee.html +0 -10
- package/docs/lib/psd/layer_info/layer_name_source.coffee.html +0 -10
- package/docs/lib/psd/layer_info/legacy_typetool.coffee.html +0 -82
- package/docs/lib/psd/layer_info/locked.coffee.html +0 -24
- package/docs/lib/psd/layer_info/metadata.coffee.html +0 -30
- package/docs/lib/psd/layer_info/nested_section_divider.coffee.html +0 -23
- package/docs/lib/psd/layer_info/object_effects.coffee.html +0 -12
- package/docs/lib/psd/layer_info/section_divider.coffee.html +0 -41
- package/docs/lib/psd/layer_info/solid_color.coffee.html +0 -24
- package/docs/lib/psd/layer_info/typetool.coffee.html +0 -121
- package/docs/lib/psd/layer_info/unicode_name.coffee.html +0 -14
- package/docs/lib/psd/layer_info/vector_mask.coffee.html +0 -37
- package/docs/lib/psd/layer_info/vector_origination.coffee.html +0 -12
- package/docs/lib/psd/layer_info/vector_stroke.coffee.html +0 -12
- package/docs/lib/psd/layer_info/vector_stroke_content.coffee.html +0 -12
- package/docs/lib/psd/layer_info.coffee.html +0 -11
- package/docs/lib/psd/layer_mask.coffee.html +0 -73
- package/docs/lib/psd/lazy_execute.coffee.html +0 -80
- package/docs/lib/psd/mask.coffee.html +0 -47
- package/docs/lib/psd/node.coffee.html +0 -100
- package/docs/lib/psd/nodes/ancestry.coffee.html +0 -47
- package/docs/lib/psd/nodes/build_preview.coffee.html +0 -6
- package/docs/lib/psd/nodes/group.coffee.html +0 -19
- package/docs/lib/psd/nodes/layer.coffee.html +0 -17
- package/docs/lib/psd/nodes/root.coffee.html +0 -61
- package/docs/lib/psd/nodes/search.coffee.html +0 -23
- package/docs/lib/psd/path_record.coffee.html +0 -73
- package/docs/lib/psd/resource.coffee.html +0 -20
- package/docs/lib/psd/resource_section.coffee.html +0 -16
- package/docs/lib/psd/resources/layer_comps.coffee.html +0 -31
- package/docs/lib/psd/resources.coffee.html +0 -44
- package/docs/lib/psd/util.coffee.html +0 -24
- package/docs/lib/psd.coffee.html +0 -85
- package/index.js +0 -2
- package/lib/psd/blend_mode.coffee +0 -78
- package/lib/psd/channel_image.coffee +0 -87
- package/lib/psd/color.coffee +0 -10
- package/lib/psd/descriptor.coffee +0 -189
- package/lib/psd/file.coffee +0 -88
- package/lib/psd/header.coffee +0 -83
- package/lib/psd/image.coffee +0 -107
- package/lib/psd/image_export.coffee +0 -2
- package/lib/psd/image_exports/png.coffee +0 -28
- package/lib/psd/image_format.coffee +0 -5
- package/lib/psd/image_formats/layer_raw.coffee +0 -6
- package/lib/psd/image_formats/layer_rle.coffee +0 -7
- package/lib/psd/image_formats/raw.coffee +0 -3
- package/lib/psd/image_formats/rle.coffee +0 -38
- package/lib/psd/image_mode.coffee +0 -4
- package/lib/psd/image_modes/cmyk.coffee +0 -36
- package/lib/psd/image_modes/greyscale.coffee +0 -14
- package/lib/psd/image_modes/rgb.coffee +0 -39
- package/lib/psd/init.coffee +0 -21
- package/lib/psd/layer/blend_modes.coffee +0 -20
- package/lib/psd/layer/blending_ranges.coffee +0 -28
- package/lib/psd/layer/channel_image.coffee +0 -10
- package/lib/psd/layer/helpers.coffee +0 -16
- package/lib/psd/layer/info.coffee +0 -76
- package/lib/psd/layer/mask.coffee +0 -8
- package/lib/psd/layer/name.coffee +0 -12
- package/lib/psd/layer/position_channels.coffee +0 -22
- package/lib/psd/layer.coffee +0 -64
- package/lib/psd/layer_info/artboard.coffee +0 -16
- package/lib/psd/layer_info/blend_clipping_elements.coffee +0 -8
- package/lib/psd/layer_info/blend_interior_elements.coffee +0 -8
- package/lib/psd/layer_info/fill_opacity.coffee +0 -7
- package/lib/psd/layer_info/gradient_fill.coffee +0 -9
- package/lib/psd/layer_info/layer_id.coffee +0 -7
- package/lib/psd/layer_info/layer_name_source.coffee +0 -7
- package/lib/psd/layer_info/legacy_typetool.coffee +0 -80
- package/lib/psd/layer_info/locked.coffee +0 -21
- package/lib/psd/layer_info/metadata.coffee +0 -27
- package/lib/psd/layer_info/nested_section_divider.coffee +0 -22
- package/lib/psd/layer_info/object_effects.coffee +0 -9
- package/lib/psd/layer_info/section_divider.coffee +0 -38
- package/lib/psd/layer_info/solid_color.coffee +0 -21
- package/lib/psd/layer_info/typetool.coffee +0 -172
- package/lib/psd/layer_info/unicode_name.coffee +0 -11
- package/lib/psd/layer_info/vector_mask.coffee +0 -35
- package/lib/psd/layer_info/vector_origination.coffee +0 -9
- package/lib/psd/layer_info/vector_stroke.coffee +0 -9
- package/lib/psd/layer_info/vector_stroke_content.coffee +0 -9
- package/lib/psd/layer_info.coffee +0 -8
- package/lib/psd/layer_mask.coffee +0 -73
- package/lib/psd/lazy_execute.coffee +0 -86
- package/lib/psd/mask.coffee +0 -52
- package/lib/psd/node.coffee +0 -150
- package/lib/psd/nodes/ancestry.coffee +0 -44
- package/lib/psd/nodes/build_preview.coffee +0 -3
- package/lib/psd/nodes/group.coffee +0 -16
- package/lib/psd/nodes/layer.coffee +0 -14
- package/lib/psd/nodes/root.coffee +0 -59
- package/lib/psd/nodes/search.coffee +0 -20
- package/lib/psd/path_record.coffee +0 -72
- package/lib/psd/resource.coffee +0 -17
- package/lib/psd/resource_section.coffee +0 -16
- package/lib/psd/resources/guides.coffee +0 -25
- package/lib/psd/resources/layer_comps.coffee +0 -28
- package/lib/psd/resources/layer_links.coffee +0 -17
- package/lib/psd/resources/resolution_info.coffee +0 -26
- package/lib/psd/resources.coffee +0 -41
- package/lib/psd/util.coffee +0 -23
- package/lib/psd.coffee +0 -92
- package/output/Logo_Glyph.png +0 -0
- package/output/Make a change and save..png +0 -0
- package/output/Matte.png +0 -0
- package/webpack.config.js +0 -23
|
@@ -0,0 +1,578 @@
|
|
|
1
|
+
import { readDescriptor, type Descriptor } from './descriptor.ts';
|
|
2
|
+
import type { InfoBlock } from './layer.ts';
|
|
3
|
+
import { readLayerStyles } from './layer-styles.ts';
|
|
4
|
+
import { readPathRecords } from './path-record.ts';
|
|
5
|
+
import type { Header } from './psd.ts';
|
|
6
|
+
import type { Reader, SpaceColor } from './reader.ts';
|
|
7
|
+
import { readLegacyTypeTool, TypeTool } from './type-tool.ts';
|
|
8
|
+
|
|
9
|
+
interface Ctx {
|
|
10
|
+
header: Header;
|
|
11
|
+
/** Length of the block's data. */
|
|
12
|
+
length: number;
|
|
13
|
+
/** Offset where the block's data ends. */
|
|
14
|
+
end: number;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
type Parser = (r: Reader, ctx: Ctx) => unknown;
|
|
18
|
+
|
|
19
|
+
/** Skips `skip` bytes of version info, then reads a descriptor. */
|
|
20
|
+
const descriptorAfter = (skip: number) => (r: Reader) => {
|
|
21
|
+
r.skip(skip);
|
|
22
|
+
return readDescriptor(r);
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
/** A boolean followed by 3 bytes of padding. */
|
|
26
|
+
const flag = (r: Reader) => r.bool();
|
|
27
|
+
|
|
28
|
+
const SECTION_DIVIDER_TYPES = ['other', 'open folder', 'closed folder', 'bounding section divider'] as const;
|
|
29
|
+
const SHEET_COLORS = ['none', 'red', 'orange', 'yellow', 'green', 'blue', 'violet', 'gray'] as const;
|
|
30
|
+
const CHANNEL_LETTERS: Record<string, string[]> = { RGBColor: ['R', 'G', 'B'], CMYKColor: ['C', 'M', 'Y', 'K'] };
|
|
31
|
+
/** Indexed from 1. */
|
|
32
|
+
const BEVEL_STYLES = ['Outer Bevel', 'Inner Bevel', 'Emboss', 'Pillow Emboss', 'Stroke Emboss'];
|
|
33
|
+
|
|
34
|
+
function readDivider(r: Reader, { length }: Ctx) {
|
|
35
|
+
const code = r.int32();
|
|
36
|
+
const divider = {
|
|
37
|
+
type: SECTION_DIVIDER_TYPES[code] ?? 'other',
|
|
38
|
+
isFolder: code === 1 || code === 2,
|
|
39
|
+
/** Marks the end of a group. */
|
|
40
|
+
isHidden: code === 3,
|
|
41
|
+
/** The group's blend mode key, which overrides the layer record's. */
|
|
42
|
+
blendMode: undefined as string | undefined,
|
|
43
|
+
subType: undefined as 'normal' | 'scene group' | undefined,
|
|
44
|
+
};
|
|
45
|
+
if (length >= 12) {
|
|
46
|
+
r.skip(4); // signature
|
|
47
|
+
divider.blendMode = r.ascii(4);
|
|
48
|
+
}
|
|
49
|
+
if (length >= 16) divider.subType = r.int32() === 0 ? 'normal' : 'scene group';
|
|
50
|
+
return divider;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** A point count followed by (output, input) pairs. */
|
|
54
|
+
const readCurvePoints = (r: Reader) =>
|
|
55
|
+
Array.from({ length: r.int16() }, () => ({ output: r.int16(), input: r.int16() }));
|
|
56
|
+
|
|
57
|
+
export function readCurves(r: Reader, { end }: Pick<Ctx, 'end'>) {
|
|
58
|
+
r.skip(3); // padding + version
|
|
59
|
+
const tag = r.int32();
|
|
60
|
+
const curves: Array<{ channelIndex: number; points: Array<{ output: number; input: number }> }> = [];
|
|
61
|
+
// Legacy format: bit i of the tag says whether a curve for channel i is present.
|
|
62
|
+
for (let i = 0; i < 32; i++) {
|
|
63
|
+
if (tag & (1 << i)) curves.push({ channelIndex: i, points: readCurvePoints(r) });
|
|
64
|
+
}
|
|
65
|
+
// Photoshop CS repeats the curves in an extended section with explicit channel indexes,
|
|
66
|
+
// which replaces the legacy data.
|
|
67
|
+
if (r.pos < end - 4) {
|
|
68
|
+
if (r.ascii(4) !== 'Crv ') throw new Error('Malformed extended curves data');
|
|
69
|
+
r.skip(2);
|
|
70
|
+
const count = r.int32();
|
|
71
|
+
return Array.from({ length: count }, () => ({ channelIndex: r.int16(), points: readCurvePoints(r) }));
|
|
72
|
+
}
|
|
73
|
+
return curves;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function readLevels(r: Reader, { end }: Ctx) {
|
|
77
|
+
r.skip(2); // version
|
|
78
|
+
const record = () => ({
|
|
79
|
+
inputFloor: r.int16(),
|
|
80
|
+
inputCeiling: r.int16(),
|
|
81
|
+
outputFloor: r.int16(),
|
|
82
|
+
outputCeiling: r.int16(),
|
|
83
|
+
gamma: r.int16() / 100,
|
|
84
|
+
});
|
|
85
|
+
const records = Array.from({ length: 29 }, record);
|
|
86
|
+
if (r.pos < end - 4) {
|
|
87
|
+
if (r.ascii(4) !== 'Lvls') throw new Error('Malformed extended levels data');
|
|
88
|
+
r.skip(2);
|
|
89
|
+
const extra = r.int16() - 29;
|
|
90
|
+
for (let i = 0; i < extra; i++) records.push(record());
|
|
91
|
+
}
|
|
92
|
+
return records;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
function readGradientMap(r: Reader) {
|
|
96
|
+
r.skip(2); // version
|
|
97
|
+
const reverse = r.bool();
|
|
98
|
+
const dither = r.bool();
|
|
99
|
+
const name = r.unicode();
|
|
100
|
+
const colorStops = Array.from({ length: r.int16() }, () => {
|
|
101
|
+
const stop = { location: r.int32(), midpoint: r.int32(), color: r.spaceColor() };
|
|
102
|
+
r.skip(2);
|
|
103
|
+
return stop;
|
|
104
|
+
});
|
|
105
|
+
const transparencyStops = Array.from({ length: r.int16() }, () => ({
|
|
106
|
+
location: r.int32(),
|
|
107
|
+
midpoint: r.int32(),
|
|
108
|
+
opacity: r.int16(),
|
|
109
|
+
}));
|
|
110
|
+
const map = {
|
|
111
|
+
reverse,
|
|
112
|
+
dither,
|
|
113
|
+
name,
|
|
114
|
+
colorStops,
|
|
115
|
+
transparencyStops,
|
|
116
|
+
interpolation: undefined as number | undefined,
|
|
117
|
+
noise: undefined as
|
|
118
|
+
| {
|
|
119
|
+
mode: number;
|
|
120
|
+
randomSeed: number;
|
|
121
|
+
showingTransparency: boolean;
|
|
122
|
+
usingVectorColor: boolean;
|
|
123
|
+
roughnessFactor: number;
|
|
124
|
+
colorModel: number;
|
|
125
|
+
minimumColor: number[];
|
|
126
|
+
maximumColor: number[];
|
|
127
|
+
}
|
|
128
|
+
| undefined,
|
|
129
|
+
};
|
|
130
|
+
if (r.int16() > 0) {
|
|
131
|
+
map.interpolation = r.int16();
|
|
132
|
+
if (r.int16() >= 32) {
|
|
133
|
+
map.noise = {
|
|
134
|
+
mode: r.int16(),
|
|
135
|
+
randomSeed: r.int32(),
|
|
136
|
+
showingTransparency: r.int16() > 0,
|
|
137
|
+
usingVectorColor: r.int16() > 0,
|
|
138
|
+
roughnessFactor: r.int32(),
|
|
139
|
+
colorModel: r.int16(),
|
|
140
|
+
minimumColor: [0, 0, 0, 0].map(() => r.uint16() >> 8),
|
|
141
|
+
maximumColor: [0, 0, 0, 0].map(() => r.uint16() >> 8),
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
return map;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
function readHueSaturation(r: Reader) {
|
|
149
|
+
r.skip(2); // version
|
|
150
|
+
const type = r.uint8() === 0 ? ('hue' as const) : ('colorization' as const);
|
|
151
|
+
r.skip(1);
|
|
152
|
+
const hsl = () => ({ hue: r.int16(), saturation: r.int16(), lightness: r.int16() });
|
|
153
|
+
const colorization = hsl();
|
|
154
|
+
const master = hsl();
|
|
155
|
+
const ranges = Array.from({ length: 6 }, () => ({
|
|
156
|
+
range: [r.int16(), r.int16(), r.int16(), r.int16()],
|
|
157
|
+
settings: [r.int16(), r.int16(), r.int16()],
|
|
158
|
+
}));
|
|
159
|
+
return { type, colorization, master, ranges };
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function readSelectiveColor(r: Reader) {
|
|
163
|
+
r.skip(2); // version
|
|
164
|
+
const correctionMode = r.int16() === 0 ? ('relative' as const) : ('absolute' as const);
|
|
165
|
+
r.skip(8); // the first record is unused
|
|
166
|
+
const corrections = Array.from({ length: 9 }, () => ({
|
|
167
|
+
cyan: r.int16(),
|
|
168
|
+
magenta: r.int16(),
|
|
169
|
+
yellow: r.int16(),
|
|
170
|
+
black: r.int16(),
|
|
171
|
+
}));
|
|
172
|
+
return { correctionMode, corrections };
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
function readPhotoFilter(r: Reader) {
|
|
176
|
+
const version = r.int16();
|
|
177
|
+
let color: { colorSpace: number; components: number[] } | { x: number; y: number; z: number };
|
|
178
|
+
if (version === 3) {
|
|
179
|
+
color = { x: r.int32() >> 8, y: r.int32() >> 8, z: r.int32() >> 8 };
|
|
180
|
+
} else if (version === 2) {
|
|
181
|
+
color = { colorSpace: r.int16(), components: [r.int16(), r.int16(), r.int16(), r.int16()] };
|
|
182
|
+
} else {
|
|
183
|
+
throw new Error(`Unsupported photo filter version ${version}`);
|
|
184
|
+
}
|
|
185
|
+
return { color, density: r.int32(), preserveLuminosity: r.bool() };
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/** The legacy (pre-Photoshop 6) layer effects block. */
|
|
189
|
+
function readEffectsLayer(r: Reader) {
|
|
190
|
+
r.skip(2); // version
|
|
191
|
+
const count = r.int16();
|
|
192
|
+
const effects: {
|
|
193
|
+
visible?: boolean;
|
|
194
|
+
dropShadow?: ReturnType<typeof shadow>;
|
|
195
|
+
innerShadow?: ReturnType<typeof shadow>;
|
|
196
|
+
outerGlow?: ReturnType<typeof glow>;
|
|
197
|
+
innerGlow?: ReturnType<typeof glow>;
|
|
198
|
+
bevel?: ReturnType<typeof bevel>;
|
|
199
|
+
solidFill?: ReturnType<typeof solidFill>;
|
|
200
|
+
} = {};
|
|
201
|
+
|
|
202
|
+
const blendKey = () => {
|
|
203
|
+
r.skip(4); // signature
|
|
204
|
+
return r.ascii(4);
|
|
205
|
+
};
|
|
206
|
+
const opacity = () => Math.round((r.uint8() / 255) * 100);
|
|
207
|
+
// Documented as int32, but Photoshop writes 16.16 fixed point.
|
|
208
|
+
const fixed = () => r.int32() >> 16;
|
|
209
|
+
|
|
210
|
+
function shadow() {
|
|
211
|
+
const size = r.int32();
|
|
212
|
+
const end = r.pos + size;
|
|
213
|
+
const data = {
|
|
214
|
+
version: r.int32(),
|
|
215
|
+
blur: fixed(),
|
|
216
|
+
intensity: fixed(),
|
|
217
|
+
angle: fixed(),
|
|
218
|
+
distance: fixed(),
|
|
219
|
+
color: r.spaceColor(),
|
|
220
|
+
blendMode: blendKey(),
|
|
221
|
+
enabled: r.bool(),
|
|
222
|
+
useGlobalLight: r.bool(),
|
|
223
|
+
/** Percent. */
|
|
224
|
+
opacity: opacity(),
|
|
225
|
+
nativeColor: undefined as SpaceColor | undefined,
|
|
226
|
+
};
|
|
227
|
+
if (size >= 51) data.nativeColor = r.spaceColor();
|
|
228
|
+
r.seek(end);
|
|
229
|
+
return data;
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
function glow(inner: boolean) {
|
|
233
|
+
const size = r.int32();
|
|
234
|
+
const end = r.pos + size;
|
|
235
|
+
const data = {
|
|
236
|
+
version: r.int32(),
|
|
237
|
+
blur: fixed(),
|
|
238
|
+
intensity: fixed(),
|
|
239
|
+
color: r.spaceColor(),
|
|
240
|
+
blendMode: blendKey(),
|
|
241
|
+
enabled: r.bool(),
|
|
242
|
+
opacity: opacity(),
|
|
243
|
+
invert: undefined as boolean | undefined,
|
|
244
|
+
nativeColor: undefined as SpaceColor | undefined,
|
|
245
|
+
};
|
|
246
|
+
if (data.version === 2) {
|
|
247
|
+
if (inner) data.invert = r.bool();
|
|
248
|
+
data.nativeColor = r.spaceColor();
|
|
249
|
+
}
|
|
250
|
+
r.seek(end);
|
|
251
|
+
return data;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
function bevel() {
|
|
255
|
+
const size = r.int32();
|
|
256
|
+
const end = r.pos + size;
|
|
257
|
+
const version = r.int32();
|
|
258
|
+
const angle = fixed();
|
|
259
|
+
const strength = fixed();
|
|
260
|
+
const blur = fixed();
|
|
261
|
+
const highlightBlendMode = blendKey();
|
|
262
|
+
const shadowBlendMode = blendKey();
|
|
263
|
+
const highlightColor = r.spaceColor();
|
|
264
|
+
const shadowColor = r.spaceColor();
|
|
265
|
+
const styleId = r.uint8();
|
|
266
|
+
const data = {
|
|
267
|
+
version,
|
|
268
|
+
angle,
|
|
269
|
+
strength,
|
|
270
|
+
blur,
|
|
271
|
+
highlightBlendMode,
|
|
272
|
+
shadowBlendMode,
|
|
273
|
+
highlightColor,
|
|
274
|
+
shadowColor,
|
|
275
|
+
style: BEVEL_STYLES[styleId - 1],
|
|
276
|
+
highlightOpacity: opacity(),
|
|
277
|
+
shadowOpacity: opacity(),
|
|
278
|
+
enabled: r.bool(),
|
|
279
|
+
useGlobalLight: r.bool(),
|
|
280
|
+
direction: r.uint8() === 0 ? ('up' as const) : ('down' as const),
|
|
281
|
+
realHighlightColor: undefined as SpaceColor | undefined,
|
|
282
|
+
realShadowColor: undefined as SpaceColor | undefined,
|
|
283
|
+
};
|
|
284
|
+
if (version === 2) {
|
|
285
|
+
data.realHighlightColor = r.spaceColor();
|
|
286
|
+
data.realShadowColor = r.spaceColor();
|
|
287
|
+
}
|
|
288
|
+
r.seek(end);
|
|
289
|
+
return data;
|
|
290
|
+
}
|
|
291
|
+
|
|
292
|
+
function solidFill() {
|
|
293
|
+
const size = r.int32();
|
|
294
|
+
const end = r.pos + size;
|
|
295
|
+
const data = {
|
|
296
|
+
version: r.int32(),
|
|
297
|
+
blendMode: blendKey(),
|
|
298
|
+
color: r.spaceColor(),
|
|
299
|
+
opacity: opacity(),
|
|
300
|
+
enabled: r.bool(),
|
|
301
|
+
nativeColor: r.spaceColor(),
|
|
302
|
+
};
|
|
303
|
+
r.seek(end);
|
|
304
|
+
return data;
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
for (let i = 0; i < count; i++) {
|
|
308
|
+
const sig = r.ascii(4);
|
|
309
|
+
if (sig !== '8BIM') throw new Error(`Bad effects layer signature '${sig}'`);
|
|
310
|
+
const key = r.ascii(4);
|
|
311
|
+
switch (key) {
|
|
312
|
+
case 'cmnS': {
|
|
313
|
+
const size = r.int32();
|
|
314
|
+
r.skip(size);
|
|
315
|
+
effects.visible = true;
|
|
316
|
+
break;
|
|
317
|
+
}
|
|
318
|
+
case 'dsdw':
|
|
319
|
+
effects.dropShadow = shadow();
|
|
320
|
+
break;
|
|
321
|
+
case 'isdw':
|
|
322
|
+
effects.innerShadow = shadow();
|
|
323
|
+
break;
|
|
324
|
+
case 'oglw':
|
|
325
|
+
effects.outerGlow = glow(false);
|
|
326
|
+
break;
|
|
327
|
+
case 'iglw':
|
|
328
|
+
effects.innerGlow = glow(true);
|
|
329
|
+
break;
|
|
330
|
+
case 'bevl':
|
|
331
|
+
effects.bevel = bevel();
|
|
332
|
+
break;
|
|
333
|
+
case 'sofi':
|
|
334
|
+
effects.solidFill = solidFill();
|
|
335
|
+
break;
|
|
336
|
+
default:
|
|
337
|
+
r.skip(r.int32());
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
return effects;
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
function readMetadata(r: Reader) {
|
|
344
|
+
const metadata: { layerComp?: Descriptor } = {};
|
|
345
|
+
const count = r.int32();
|
|
346
|
+
for (let i = 0; i < count; i++) {
|
|
347
|
+
r.skip(4); // signature
|
|
348
|
+
const key = r.ascii(4);
|
|
349
|
+
r.skip(4); // copy on sheet duplication + padding
|
|
350
|
+
const length = r.int32();
|
|
351
|
+
const end = r.pos + length;
|
|
352
|
+
if (key === 'cmls') {
|
|
353
|
+
r.skip(4); // descriptor version
|
|
354
|
+
metadata.layerComp = readDescriptor(r);
|
|
355
|
+
}
|
|
356
|
+
r.seek(end);
|
|
357
|
+
}
|
|
358
|
+
return metadata;
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
/** Every layer info block this library understands, by name. */
|
|
362
|
+
const LAYER_INFO = {
|
|
363
|
+
artboard: {
|
|
364
|
+
keys: ['artb', 'artd', 'abdd'],
|
|
365
|
+
parse: (r: Reader) => {
|
|
366
|
+
const data = descriptorAfter(4)(r);
|
|
367
|
+
const rect = data.artboardRect;
|
|
368
|
+
return { data, coords: { left: rect['Left'], top: rect['Top '], right: rect['Rght'], bottom: rect['Btom'] } };
|
|
369
|
+
},
|
|
370
|
+
},
|
|
371
|
+
blackWhite: {
|
|
372
|
+
keys: ['blwh'],
|
|
373
|
+
parse: (r: Reader) => {
|
|
374
|
+
const d = descriptorAfter(4)(r);
|
|
375
|
+
return {
|
|
376
|
+
red: d['Rd '] as number,
|
|
377
|
+
yellow: d['Yllw'] as number,
|
|
378
|
+
green: d['Grn '] as number,
|
|
379
|
+
cyan: d['Cyn '] as number,
|
|
380
|
+
blue: d['Bl '] as number,
|
|
381
|
+
magenta: d['Mgnt'] as number,
|
|
382
|
+
tint: d.useTint as boolean,
|
|
383
|
+
tintColor: { red: d.tintColor['Rd '] as number, green: d.tintColor['Grn '] as number, blue: d.tintColor['Bl '] as number },
|
|
384
|
+
presetKind: d.bwPresetKind as number,
|
|
385
|
+
presetFileName: d.blackAndWhitePresetFileName as string,
|
|
386
|
+
data: d,
|
|
387
|
+
};
|
|
388
|
+
},
|
|
389
|
+
},
|
|
390
|
+
blendClippingElements: { keys: ['clbl'], parse: flag },
|
|
391
|
+
blendInteriorElements: { keys: ['infx'], parse: flag },
|
|
392
|
+
/** Only meaningful with "Use Legacy" checked; otherwise see `contentGenerator`. */
|
|
393
|
+
brightnessContrast: {
|
|
394
|
+
keys: ['brit'],
|
|
395
|
+
parse: (r: Reader) => ({ brightness: r.int16(), contrast: r.int16(), meanValue: r.int16(), labColor: r.bool() }),
|
|
396
|
+
},
|
|
397
|
+
channelBlendingRestrictions: {
|
|
398
|
+
keys: ['brst'],
|
|
399
|
+
parse: (r: Reader, { length, header }: Ctx) => {
|
|
400
|
+
const channels = Array.from({ length: length / 4 }, () => r.int32());
|
|
401
|
+
const letters = CHANNEL_LETTERS[header.modeName];
|
|
402
|
+
return { channels, letters: letters ? channels.map((c) => letters[c]) : undefined };
|
|
403
|
+
},
|
|
404
|
+
},
|
|
405
|
+
channelMixer: {
|
|
406
|
+
keys: ['mixr'],
|
|
407
|
+
parse: (r: Reader) => {
|
|
408
|
+
r.skip(2); // version
|
|
409
|
+
const monochrome = r.int16() > 0;
|
|
410
|
+
const channels = Array.from({ length: 4 }, () => ({
|
|
411
|
+
redCyan: r.int16(),
|
|
412
|
+
greenMagenta: r.int16(),
|
|
413
|
+
blueYellow: r.int16(),
|
|
414
|
+
black: r.int16(),
|
|
415
|
+
constant: r.int16(),
|
|
416
|
+
}));
|
|
417
|
+
return { monochrome, channels };
|
|
418
|
+
},
|
|
419
|
+
},
|
|
420
|
+
colorBalance: {
|
|
421
|
+
keys: ['blnc'],
|
|
422
|
+
parse: (r: Reader) => {
|
|
423
|
+
const range = () => ({ cyanRed: r.int16(), magentaGreen: r.int16(), yellowBlue: r.int16() });
|
|
424
|
+
return { shadows: range(), midtones: range(), highlights: range(), preserveLuminosity: r.int16() > 0 };
|
|
425
|
+
},
|
|
426
|
+
},
|
|
427
|
+
colorLookup: { keys: ['clrL'], parse: descriptorAfter(6) },
|
|
428
|
+
/** Brightness/contrast in Photoshop CS3+. */
|
|
429
|
+
contentGenerator: {
|
|
430
|
+
keys: ['CgEd'],
|
|
431
|
+
parse: (r: Reader) => {
|
|
432
|
+
const d = descriptorAfter(4)(r);
|
|
433
|
+
return {
|
|
434
|
+
brightness: d.Brgh as number,
|
|
435
|
+
contrast: d.Cntr as number,
|
|
436
|
+
meanValue: d.means as number,
|
|
437
|
+
labColor: d['Lab '] as boolean,
|
|
438
|
+
useLegacy: d.useLegacy as boolean,
|
|
439
|
+
auto: d.Auto as boolean,
|
|
440
|
+
data: d,
|
|
441
|
+
};
|
|
442
|
+
},
|
|
443
|
+
},
|
|
444
|
+
curves: { keys: ['curv'], parse: readCurves },
|
|
445
|
+
effectsLayer: { keys: ['lrFX'], parse: readEffectsLayer },
|
|
446
|
+
exposure: {
|
|
447
|
+
keys: ['expA'],
|
|
448
|
+
parse: (r: Reader) => {
|
|
449
|
+
r.skip(2); // version
|
|
450
|
+
return { exposure: r.float32(), offset: r.float32(), gamma: r.float32() };
|
|
451
|
+
},
|
|
452
|
+
},
|
|
453
|
+
/** 0-255. */
|
|
454
|
+
fillOpacity: { keys: ['iOpa'], parse: (r: Reader) => r.uint8() },
|
|
455
|
+
gradientFill: { keys: ['GdFl'], parse: descriptorAfter(4) },
|
|
456
|
+
gradientMap: { keys: ['grdm'], parse: readGradientMap },
|
|
457
|
+
hueSaturation: { keys: ['hue2'], parse: readHueSaturation },
|
|
458
|
+
/** Present (and `true`) on invert adjustment layers. */
|
|
459
|
+
invert: { keys: ['nvrt'], parse: () => true },
|
|
460
|
+
knockout: {
|
|
461
|
+
keys: ['knko'],
|
|
462
|
+
parse: (r: Reader) => {
|
|
463
|
+
const value = r.uint8();
|
|
464
|
+
return { enabled: value > 0, mode: value === 1 ? ('shallow' as const) : value === 2 ? ('deep' as const) : undefined };
|
|
465
|
+
},
|
|
466
|
+
},
|
|
467
|
+
layerId: { keys: ['lyid'], parse: (r: Reader) => r.int32() },
|
|
468
|
+
layerMaskAsGlobalMask: { keys: ['lmgm'], parse: flag },
|
|
469
|
+
/** Minimum Photoshop version needed to read the layer, times 10 (70 = 7.0). */
|
|
470
|
+
layerVersion: { keys: ['lyvr'], parse: (r: Reader) => r.int32() },
|
|
471
|
+
layerNameSource: { keys: ['lnsr'], parse: (r: Reader) => r.ascii(4) },
|
|
472
|
+
legacyTypeTool: { keys: ['tySh'], parse: readLegacyTypeTool },
|
|
473
|
+
levels: { keys: ['levl'], parse: readLevels },
|
|
474
|
+
locked: {
|
|
475
|
+
keys: ['lspf'],
|
|
476
|
+
parse: (r: Reader) => {
|
|
477
|
+
const value = r.int32();
|
|
478
|
+
const all = value === -2147483648;
|
|
479
|
+
const locked = {
|
|
480
|
+
transparency: all || (value & 0x01) > 0,
|
|
481
|
+
composite: all || (value & 0x02) > 0,
|
|
482
|
+
position: all || (value & 0x04) > 0,
|
|
483
|
+
all: false,
|
|
484
|
+
};
|
|
485
|
+
locked.all = locked.transparency && locked.composite && locked.position;
|
|
486
|
+
return locked;
|
|
487
|
+
},
|
|
488
|
+
},
|
|
489
|
+
metadata: { keys: ['shmd'], parse: readMetadata },
|
|
490
|
+
/** The Unicode layer name. */
|
|
491
|
+
name: { keys: ['luni'], parse: (r: Reader) => r.unicode() },
|
|
492
|
+
/** Group markers in files that lack `sectionDivider`. */
|
|
493
|
+
nestedSectionDivider: {
|
|
494
|
+
keys: ['lsdk'],
|
|
495
|
+
parse: (r: Reader) => {
|
|
496
|
+
const code = r.int32();
|
|
497
|
+
return { isFolder: code === 1 || code === 2, isHidden: code === 3 };
|
|
498
|
+
},
|
|
499
|
+
},
|
|
500
|
+
/** Layer styles (drop shadow, stroke, etc.). Photoshop stores a group's styles in `lfxs`. */
|
|
501
|
+
objectEffects: { keys: ['lfx2', 'lmfx', 'lfxs'], parse: (r: Reader) => readLayerStyles(descriptorAfter(8)(r)) },
|
|
502
|
+
patternFill: { keys: ['PtFl'], parse: descriptorAfter(4) },
|
|
503
|
+
photoFilter: { keys: ['phfl'], parse: readPhotoFilter },
|
|
504
|
+
/** Smart object data. */
|
|
505
|
+
placedLayer: { keys: ['SoLd', 'SoLE'], parse: descriptorAfter(12) },
|
|
506
|
+
posterize: { keys: ['post'], parse: (r: Reader) => r.int16() },
|
|
507
|
+
referencePoint: { keys: ['fxrp'], parse: (r: Reader) => ({ x: r.float64(), y: r.float64() }) },
|
|
508
|
+
sectionDivider: { keys: ['lsct'], parse: readDivider },
|
|
509
|
+
selectiveColor: { keys: ['selc'], parse: readSelectiveColor },
|
|
510
|
+
/** The layer's color label. */
|
|
511
|
+
sheetColor: { keys: ['lclr'], parse: (r: Reader) => SHEET_COLORS[r.int16()] ?? 'none' },
|
|
512
|
+
solidColor: {
|
|
513
|
+
keys: ['SoCo'],
|
|
514
|
+
parse: (r: Reader) => {
|
|
515
|
+
const data = descriptorAfter(4)(r);
|
|
516
|
+
const c = data['Clr '];
|
|
517
|
+
return { r: Math.round(c['Rd ']), g: Math.round(c['Grn ']), b: Math.round(c['Bl ']), data };
|
|
518
|
+
},
|
|
519
|
+
},
|
|
520
|
+
threshold: { keys: ['thrs'], parse: (r: Reader) => r.int16() },
|
|
521
|
+
transparencyShapesLayer: { keys: ['tsly'], parse: (r: Reader) => r.uint8() === 1 },
|
|
522
|
+
typeTool: { keys: ['TySh'], parse: (r: Reader) => new TypeTool(r) },
|
|
523
|
+
vectorMask: {
|
|
524
|
+
keys: ['vmsk', 'vsms'],
|
|
525
|
+
parse: (r: Reader, { length }: Ctx) => {
|
|
526
|
+
r.skip(4); // version
|
|
527
|
+
const flags = r.int32();
|
|
528
|
+
return {
|
|
529
|
+
invert: (flags & 0x01) > 0,
|
|
530
|
+
notLink: (flags & 0x02) > 0,
|
|
531
|
+
disable: (flags & 0x04) > 0,
|
|
532
|
+
paths: readPathRecords(r, Math.floor((length - 8) / 26)),
|
|
533
|
+
};
|
|
534
|
+
},
|
|
535
|
+
},
|
|
536
|
+
vectorMaskAsGlobalMask: { keys: ['vmgm'], parse: flag },
|
|
537
|
+
vectorOrigination: { keys: ['vogk'], parse: descriptorAfter(8) },
|
|
538
|
+
vectorStroke: { keys: ['vstk'], parse: descriptorAfter(4) },
|
|
539
|
+
vectorStrokeContent: { keys: ['vscg'], parse: descriptorAfter(8) },
|
|
540
|
+
vibrance: {
|
|
541
|
+
keys: ['vibA'],
|
|
542
|
+
parse: (r: Reader) => {
|
|
543
|
+
const data = descriptorAfter(4)(r);
|
|
544
|
+
return { vibrance: data.vibrance as number | undefined, saturation: data['Strt'] as number | undefined, data };
|
|
545
|
+
},
|
|
546
|
+
},
|
|
547
|
+
} satisfies Record<string, { keys: string[]; parse: Parser }>;
|
|
548
|
+
|
|
549
|
+
export type LayerInfo = {
|
|
550
|
+
readonly [K in keyof typeof LAYER_INFO]?: ReturnType<(typeof LAYER_INFO)[K]['parse']>;
|
|
551
|
+
};
|
|
552
|
+
|
|
553
|
+
const BY_KEY = new Map<string, [string, Parser]>(
|
|
554
|
+
Object.entries(LAYER_INFO).flatMap(([name, { keys, parse }]) => keys.map((key) => [key, [name, parse as Parser]] as const)),
|
|
555
|
+
);
|
|
556
|
+
|
|
557
|
+
/** Builds the `layer.info` object: one memoized getter per known block present in the layer. */
|
|
558
|
+
export function createLayerInfo(reader: Reader, blocks: InfoBlock[], header: Header): LayerInfo {
|
|
559
|
+
const info = {};
|
|
560
|
+
for (const block of blocks) {
|
|
561
|
+
const entry = BY_KEY.get(block.key);
|
|
562
|
+
if (!entry || Object.hasOwn(info, entry[0])) continue;
|
|
563
|
+
const [name, parse] = entry;
|
|
564
|
+
let value: unknown;
|
|
565
|
+
let parsed = false;
|
|
566
|
+
Object.defineProperty(info, name, {
|
|
567
|
+
enumerable: true,
|
|
568
|
+
get() {
|
|
569
|
+
if (!parsed) {
|
|
570
|
+
value = parse(reader.at(block.offset), { header, length: block.length, end: block.offset + block.length });
|
|
571
|
+
parsed = true;
|
|
572
|
+
}
|
|
573
|
+
return value;
|
|
574
|
+
},
|
|
575
|
+
});
|
|
576
|
+
}
|
|
577
|
+
return info;
|
|
578
|
+
}
|