Log inGet started
Package

toonBlocks.testSuite

This package holds more than this page lists. See all of its files in its world.

README.md

toonBlocks test suite

Checks every toonBlocks block against styleKit's block rules (the three fills and the five outlines each share one set of named settings, defaults inside their ranges); that at least ten toon ramps are listed and ToonBlocks.setRamp switches them in one change; that every whole look applies in one change, needs only toonBlocks and styleKit, and lets a part swap after; that an outline swaps with styleKit's depth line and back in one change, its shells appearing and going with it and nothing held once the stack is cleared; that per-object (setObjectOutline) and per-material (setMaterialOutline) outlines take and come off; that ToonMaterial.paint and unpaint put toon light inside a material and take it off leaving the frame and the files as they were. On the presented frame, over a small lit set of its own: every block changes the picture and taking it off returns the frame exactly. With every light off the frame stays black under every block and look (measured at the Lookbook's every-light-off moment, so it needs lookbookKit's modules, and stands down as skipped where they are not installed). The per-object outline check also addresses the test ball by its name, as the guides do (1.0.6 refused a live entity's name). The every-light-off check discards the edits its run leaves in the Lookbook scene's autosave once the previous scene is back (the whole overlay when there was none before, else only the new edits), so a world that installed toonBlocks keeps its Lookbook exactly as it came. The band-count check passes under a fresh world's default light (a strong sun, faint ambient), where 1.0.8 found 4 tones at 5 bands. Two checks catch the faults 1.0.5 fixed, on the suite's own ball under a light the check sets (the scene's sun turned to shine from the side, other directional lights off for the moment and every light put back after, the ball seen from 22 m): every light block, fill and whole look draws the ball in clean flat bands, with at most 1 percent of it flecked (a fleck is a pixel that 6 of its 8 neighbours differ from by more than 6 code values, all one way, which a band edge never is; 1.0.4's toonBands flecked 5.3 percent and celPoster 15.4); and the band count is a dial anyone can see, with 2 against 5 bands changing more than 5 percent of the frame and 25 percent of the ball, 3 against 4 more than 5 percent of the ball, and the ball showing at least n flat tones at n bands for 2 to 5 (1.0.4, whose clean light had two levels, showed 2, 3, 3 and 4). A figure check (1.1.0) looks at the engine's humanoid figure as the showcase stage shows it (about a fifth of the frame tall, the sun behind it, the side the camera sees in the shadow band) under toonBands, toonRamp and Comic ink cel at their defaults, before a red backdrop that casts no shadow (so the white figure stands out even under a fresh world's bright default light), with a front fill light swept from off to strong so the shade passes through the whole range where a keepShade lift would change: no fleck inside a band (where the same stack with keepShade 0 is flat), and no more flecks on the figure than with keepShade 0 (toonRamp: no more than toonBands with keepShade 0). It turns the debug drawing off while it looks and puts it back. 1.0.9, whose default lift tipped between thirds pixel by pixel, failed it with up to 98 flecks inside a band. The ball's stipple check covers keepShade 0.7, now that 0 is the default. A close-up figure check (1.1.2; with the 3D view set to 1920 x 1080 while it runs since 1.1.3) looks at the same figure half the frame tall, as an editor camera a few metres off shows it, where the outline's inner lines are drawn: the outline alone adds no more than 0.1 percent of the figure in specks, toonRamp has at most 1 lone speck (a speck in flat paint), and Comic ink cel no more than toonBands with keepShade 0 has or 2, whichever is more (since 1.1.3; toonBands' own lone count moves between 0 and 3 from run to run). The whole counts, and Comic ink cel's specks away from its line (its rim and glint edges), are reported, not judged: toonBands' own count moves between runs by more than a fixed margin over it (since 1.1.3). 1.1.1 failed it (the outline alone 0.17 percent, Comic ink cel 18 lone specks, toonRamp 4), and 1.1.2 failed it in a brand new world (toonRamp 3 lone specks).

Known limits

  • Frame tests read the presented frame, so a run needs a drawn view, and a busy machine moves the timing checks (#24548).
  • A two-client editor sometimes refuses to load two different scenes at once (#24666, #24667).
  • The web build was not checked from here (#20946).

The package README's Known limits lists the rest.