carta1 1.6.0 → 1.7.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 +4 -61
- package/bin/cli.js +508 -239
- package/codec/allocation/solve.js +46 -28
- package/codec/analysis/blocks.js +4 -1
- package/codec/analysis/spectrum.js +17 -15
- package/codec/boundary/container.js +1 -1
- package/codec/boundary/pcm.js +2 -88
- package/codec/boundary/processor.js +4 -4
- package/codec/boundary/reader.js +2 -2
- package/codec/boundary/stream.js +56 -50
- package/codec/core/constants.js +6 -5
- package/codec/core/geometry.js +2 -2
- package/codec/core/tables.js +21 -98
- package/codec/quantization/spectrum.js +6 -6
- package/codec/signal/fft.js +1 -0
- package/codec/signal/mdct.js +48 -38
- package/codec/signal/qmf.js +37 -465
- package/codec/syntax/bitstream.js +9 -9
- package/codec/syntax/frame.js +11 -2
- package/codec/synthesis/bands.js +13 -14
- package/codec/synthesis/pcm.js +4 -0
- package/dist/carta1-worker.min.js +1 -1
- package/dist/carta1-worker.min.js.map +1 -1
- package/dist/carta1.min.js +1 -1
- package/dist/carta1.min.js.map +1 -1
- package/package.json +4 -16
- package/bin/options.js +0 -41
- package/codec/boundary/inspect.js +0 -96
- package/dist/carta1.wme +0 -0
- package/dist/wme/index.js +0 -2
- package/dist/wme/index.js.map +0 -1
- package/docs/native.md +0 -107
- package/docs/porffor.md +0 -23
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Carta1
|
|
2
2
|
|
|
3
3
|
Carta1 is an ATRAC1 encoder and decoder in JavaScript. It converts PCM WAVE
|
|
4
|
-
audio to
|
|
4
|
+
audio to the AEA container, decodes AEA back to PCM WAVE, exposes stateful
|
|
5
5
|
frame and stream APIs, and ships browser Web Worker bundles.
|
|
6
6
|
|
|
7
7
|
## Supported format
|
|
@@ -34,11 +34,6 @@ npm ci
|
|
|
34
34
|
npm run check
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
[Native CLI archives](docs/native.md) for Linux and macOS (x64 and ARM64) are
|
|
38
|
-
built with Porffor and attached to GitHub Releases after exact WAV/AEA parity
|
|
39
|
-
checks against the Node CLI. They run without Node.js. See the native guide
|
|
40
|
-
for local builds, supported input formats, and verification.
|
|
41
|
-
|
|
42
37
|
## CLI
|
|
43
38
|
|
|
44
39
|
Run the installed executable directly, or use `npx carta1` from a project that
|
|
@@ -47,7 +42,6 @@ depends on Carta1:
|
|
|
47
42
|
```bash
|
|
48
43
|
carta1 --encode input.wav output.aea
|
|
49
44
|
carta1 --decode input.aea output.wav
|
|
50
|
-
carta1 --json input.aea structure.json
|
|
51
45
|
|
|
52
46
|
npx carta1 --encode input.wav output.aea
|
|
53
47
|
```
|
|
@@ -60,7 +54,6 @@ signed 16-bit PCM WAVE output.
|
|
|
60
54
|
| --------------------- | ---------------------------------------------------- |
|
|
61
55
|
| `-e, --encode` | Encode PCM WAVE to AEA. |
|
|
62
56
|
| `-d, --decode` | Decode AEA to PCM WAVE. |
|
|
63
|
-
| `-j, --json` | Write AEA metadata and frame structure as JSON. |
|
|
64
57
|
| `-q, --quiet` | Suppress normal output and progress. |
|
|
65
58
|
| `-f, --force` | Overwrite an existing output file. |
|
|
66
59
|
| `-t, --title <title>` | Set a UTF-8 AEA title (up to 255 encoded bytes). |
|
|
@@ -69,7 +62,7 @@ signed 16-bit PCM WAVE output.
|
|
|
69
62
|
| `-V, --version` | Print the Carta1 version. |
|
|
70
63
|
| `-h, --help` | Print command help. |
|
|
71
64
|
|
|
72
|
-
Exactly one of `--encode
|
|
65
|
+
Exactly one of `--encode` and `--decode` is required. The input and
|
|
73
66
|
output are positional paths. Existing output is preserved unless `--force` is
|
|
74
67
|
provided.
|
|
75
68
|
|
|
@@ -189,8 +182,8 @@ npm test # Run the test suite once
|
|
|
189
182
|
npm run test:watch # Re-run tests while editing
|
|
190
183
|
npm run lint # Check JavaScript and formatting
|
|
191
184
|
npm run format # Apply repository formatting
|
|
192
|
-
npm run build # Build browser bundles
|
|
193
|
-
npm run check # Run lint, tests,
|
|
185
|
+
npm run build # Build browser bundles
|
|
186
|
+
npm run check # Run lint, tests, and browser builds
|
|
194
187
|
```
|
|
195
188
|
|
|
196
189
|
Run `npm run check` before submitting a change. Pull requests and pushes run
|
|
@@ -206,53 +199,3 @@ implementation used to understand the ATRAC1 format and codec behavior.
|
|
|
206
199
|
## License
|
|
207
200
|
|
|
208
201
|
ISC
|
|
209
|
-
|
|
210
|
-
## Experimental Web MiniDisc encoder plugin
|
|
211
|
-
|
|
212
|
-
`npm run build` also emits `dist/carta1.wme`, alongside the three existing
|
|
213
|
-
browser bundles. GitHub Releases attach the WME, all three JavaScript bundles,
|
|
214
|
-
and their source maps. The npm package includes the same build outputs. Release
|
|
215
|
-
CDN links are pinned to that release's version.
|
|
216
|
-
|
|
217
|
-
**Carta1 (ATRAC1, experimental)** is an ATRAC1 codec for standard MD SP, not
|
|
218
|
-
ATRAC3 LP2/LP4 or ATRAC3plus Hi-MD. Current Web MiniDisc API v1 does not support
|
|
219
|
-
software ATRAC1 output: its SP modes request PCM for the recorder to encode in
|
|
220
|
-
hardware. Installing this plugin does not enable Carta1 recording in the
|
|
221
|
-
unmodified app. All current API v1 codecs (PCM, MP3, AT3, A3+) are explicitly
|
|
222
|
-
reported as unsupported so there is no silent hardware-encoding fallback.
|
|
223
|
-
|
|
224
|
-
### Proposed host extension for testing
|
|
225
|
-
|
|
226
|
-
The archive uses the standard API v1 SAR container and default encoder class,
|
|
227
|
-
with the usual `init`, `deinit`, `getSupportFor`, `transcode`, and progress hooks.
|
|
228
|
-
It adds two **proposed, nonstandard** export codec names, using the host's
|
|
229
|
-
existing recording-mode names:
|
|
230
|
-
|
|
231
|
-
| `exportParams.format` | PCM channels | Output |
|
|
232
|
-
| -------------------------------- | ------------ | ---------------- |
|
|
233
|
-
| `{ codec: 'SPS', bitrate: 292 }` | 2 | ATRAC1 stereo SP |
|
|
234
|
-
| `{ codec: 'SPM', bitrate: 146 }` | 1 | ATRAC1 mono SP |
|
|
235
|
-
|
|
236
|
-
Bitrates are nominal kbps; ATRAC1 uses 212-byte sound units per channel per
|
|
237
|
-
512 samples at 44.1 kHz. The host's built-in FFmpeg decodes/resamples sources
|
|
238
|
-
and optionally applies ReplayGain; the existing Carta1 worker encodes them.
|
|
239
|
-
`transcode` returns raw sound units **without the 2048-byte AEA header**.
|
|
240
|
-
Stereo sound units alternate left/right. Canonical priming and drain units
|
|
241
|
-
are retained; gapless is not advertised and AEA timeline metadata is omitted.
|
|
242
|
-
|
|
243
|
-
A host implementing this proposal must extend its export-codec interface,
|
|
244
|
-
preserve SPS/SPM through capability checks and transcoding instead of mapping
|
|
245
|
-
them to PCM, and route the result to a compatible pre-encoded ATRAC1 transfer
|
|
246
|
-
path (such as a supported device's homebrew SP uploader). It must handle channel
|
|
247
|
-
mode, transfer framing/padding, and device capabilities there. Ordinary SP PCM
|
|
248
|
-
upload must never receive these compressed bytes. Neither the proposed names
|
|
249
|
-
nor device transfer compatibility are part of the current WMD API contract;
|
|
250
|
-
the WMD team can revise them when implementing support. No host changes are
|
|
251
|
-
included here.
|
|
252
|
-
|
|
253
|
-
`npm run test:wme` exercises the built archive and its bundled worker for both
|
|
254
|
-
proposed formats, comparing the returned raw bytes with `encodeAeaPcm` across
|
|
255
|
-
independent tracks. Lifecycle and failure tests run in the normal test suite.
|
|
256
|
-
|
|
257
|
-
The repository-only WME packager lives in `build/wme.js`. Build tooling is
|
|
258
|
-
excluded from the npm package; the generated `dist/` assets are included.
|