asciianything 1.2.1 → 1.2.2

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.
Files changed (2) hide show
  1. package/README.md +10 -9
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -47,15 +47,16 @@ behind Puppeteer or Playwright, or any headless capture), then point the tool at
47
47
  with `--fps`; resolution comes from the frames. The same path handles Blender renders, stop-motion stills, screen
48
48
  recordings split to frames, and anything else that can write `0001.png`.
49
49
 
50
- **Exact by construction.** A photo is one frame of the same pipeline: the decoder flags, the renderer call, the atlas and
51
- the calibration are the video path with a single frame in it. `asciianything shot.png` and frame 0 of a clip made from
52
- `shot.png` are byte-identical — measured at 0 differing pixels on a 3840×2160 frame.
50
+ **Exact by construction.** A photo is one frame of the same pipeline: same decoder flags, same renderer call, same atlas
51
+ and calibration. Rendering `shot.png` and rendering frame 0 of a clip made from that image produce identical pixels —
52
+ 0 differing pixels on a 3840×2160 frame.
53
+
54
+ What differs afterwards is only the container. A photo is written as exact PNG. A video carries the encoder's error:
55
+ `--crf 0 --pix-fmt yuv444p` decodes back within ±2 levels of the rendered RGB (the rounding of the RGB→YUV→RGB matrix),
56
+ while the default `--crf 17` is a normal lossy encode.
53
57
 
54
58
  Output size always equals input size, odd dimensions included: a 1001×667 frame encodes as 1001×667, with the encoder
55
- switching to `yuv444p` automatically because `yuv420p` needs even dimensions. Video at the default `--crf 17` is lossy on
56
- purpose (that is what makes a 19-second 1080p clip 54 MB); `--crf 0 --pix-fmt yuv444p` keeps the decoded frame within ±2
57
- levels of the rendered RGB, which is the rounding of the RGB→YUV→RGB matrix and nothing else. Photos are always written
58
- as exact PNG.
59
+ switching to `yuv444p` automatically because `yuv420p` needs even dimensions.
59
60
 
60
61
  ## What it is
61
62
 
@@ -225,8 +226,8 @@ Measured against the sources after encoding, in linear light, one-cell blur:
225
226
  Frame counts, durations, dimensions and colour tags are probed independently after encoding. The sunset run additionally
226
227
  holds every measured region — top sky, cirrus, cloud fan, sea band, wet sand, rocks — inside ±1.6 %.
227
228
 
228
- Two more exactness checks: the photo path against frame 0 of a clip of the same image gives **0 differing pixels**, and a
229
- `--crf 0 --pix-fmt yuv444p` encode of that frame decodes back within **±2 levels** of the rendered RGB.
229
+ Two more exactness checks: rendering a photo and rendering frame 0 of a clip of the same image gives **0 differing
230
+ pixels**, and a `--crf 0 --pix-fmt yuv444p` encode of that frame decodes back within **±2 levels** of the rendered RGB.
230
231
 
231
232
  ## Demos
232
233
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "asciianything",
3
- "version": "1.2.1",
3
+ "version": "1.2.2",
4
4
  "description": "Turn a 3D scene, a video or a photo into a mosaic of coloured lowercase prose \u2014 frame-accurate, with ffmpeg.",
5
5
  "keywords": [
6
6
  "ascii",