リファレンス

立体表面の規則と形

import { … } from "@johnmorrisdotca/meikyuu/3d";

最小化と gzip 圧縮をしたサイズは 20.3 kB（読み込むものをすべて含み、esbuild で計測）

リファレンスの説明と例は英語です。見出しと目次は日本語です。

Meikyuu over the surface of a solid: a perfect maze on a cube, a globe, the other dice (a tetrahedron, an octahedron, an icosahedron, a ten-sided, a twelve-sided and more) or a shape (a box, a cross of cubes, a ring, a torus, a star, a heart), with the line drawn from one face to the next across the edges. The graph of the surface (solidGridOf), the maze made on it by the very algorithms the flat mazes use (buildSolidMaze, SolidRecipe), the measure of how hard it is (solidDifficultyOf), the arithmetic of looking at a turned solid and of finding the cell under a finger (projectFrame, pickCell), the checker for an answer (checkSolidAnswer) and a still picture as SVG (drawSolid). The game itself (drawing, undo, stones, steps) is the root entry's: it plays any maze, flat or not. The board to play in a page is @johnmorrisdotca/meikyuu/3d/play, and the numbered levels are in @johnmorrisdotca/meikyuu/3d/levels.

エクスポート

名前	種類	概要
`buildSolidMaze`	関数	Make the maze a recipe names.
`cachedSolidGrid`	関数	The grid of a solid cut `n` ways, kept: a grid is never changed, and a script that makes thousands of mazes of one size builds it once.
`cellsAlongDrag`	関数	The cells a straight drag from one point to another crosses, in order, by sampling it finely enough that no cell the drag passes through is missed.
`checkSolidAnswer`	関数	Whether a list of cells is the answer: it starts at the start, ends at the goal, steps from each cell to one joined to it by a passage, and never visits a cell twice.
`createFrame`	関数	Room for a frame of a solid.
`dragTurn`	関数	The turn a drag from one point to another makes: the point of the solid under the first is carried to under the second.
`drawSolid`	関数	Render a surface maze and optional trail/stones as native SVG text.
`DrawSolidOptions`	型	A MAZE OVER A SOLID AS SVG TEXT, a still picture of it from one side: the near side's cells shaded by how squarely they face the viewer, the walls that stand, and, if asked, the line, the stones and the way through.
`EDGE_FULL`	定数	The normalized threshold used for a full native edge turn.
`EDGE_NEIGHBOUR`	定数	The normalized neighbouring-cell edge-turn threshold.
`EDGE_RATE`	定数	The fastest the solid turns by itself, in radians a second.
`EDGE_SAFE`	定数	THE SOLID TURNS BY ITSELF to keep the end of a line being drawn in view.
`edgeTurn`	関数	Compute a view rotation that follows a surface path near an edge, or null when no turn is needed.
`faceCellTurn`	関数	The turn that brings the cell round to face the viewer (see `facingOf` for `around`), by the shortest way, and then rolls it so that a side of the cell lies level (the cell's own first side, to the nearest of the turns that put one of its sides level).
`isSolidCut`	関数	Whether a solid can be cut `n` ways: a whole number of at least 2, or 1 where the solid has already sixty cells uncut (the dodecahedron's five to a face).
`isSolidDie`	関数	Whether a solid is among the dice (the rest are shapes).
`MEIKYUU_MOST_SOLID_CELLS`	定数	The most cells a solid may have in a recipe: a little over twice the biggest level.
`MEIKYUU_SOLID_PER_LIST`	定数	How many levels each size of each solid has: eight pages of eight.
`openingTurn`	関数	A view of the solid to begin with: the cell faces the viewer, then the solid is tipped a little so that its depth shows and its neighbours on the near side can be seen.
`parseSolidRecipe`	関数	A recipe from its code, or null when it is not one, or names a solid of more than `MEIKYUU_MOST_SOLID_CELLS` cells.
`pickCell`	関数	The cell the point `(x, y)` of the picture is on, or -1 for none.
`projectFrame`	関数	Put the solid, turned by `q` and zoomed, on a picture `width` by `height`: fills every array of the frame.
`Quat`	型	A rotation: `[x, y, z, w]`, of length one.
`QUAT_IDENTITY`	定数	The rotation that does nothing.
`quatAngle`	関数	How far apart two rotations are, in radians, from 0 to pi.
`quatAxisAngle`	関数	The turn of `angle` radians about an axis (any length but nought).
`quatBetween`	関数	The shortest turn that carries the direction `a` onto the direction `b`.
`quatMul`	関数	Two rotations in turn: `b` after `a`.
`quatNormalize`	関数	A rotation made one again: the turns a drag adds up carry a little error, which this takes out.
`quatSlerp`	関数	Halfway (or any share) from one rotation to another along the shortest way.
`quatTurn`	関数	A point turned.
`SOLID_ALGORITHMS`	定数	The algorithms that make a maze over a solid: all but Eller's, which needs rows.
`SOLID_CUTS`	定数	How many ways each solid is cut, for each size: small, medium, large, huge and colossal.
`SOLID_DICE`	定数	The dice, by how many sides, smallest first.
`SOLID_DIE_SIDES`	定数	How many sides a die has (what its name on a die is: d6).
`SOLID_EYE`	定数	How far the eye is from the middle of the solid, in times its reach.
`SOLID_FILL`	定数	The share of the box the solid's outline fills at most.
`SOLID_FIRST`	定数	THE SOLIDS BY HOW THEY ARE MET.
`SOLID_KINDS`	定数	THE SURFACE OF A SOLID AS A CELL GRAPH: the one thing a maze over a solid is made on.
`SOLID_MORE_DICE`	定数	The seven dice that came after the first five, and the six shapes.
`SOLID_MORE_SHAPES`	定数	The additional box, cross, ring, torus, star and heart surface families.
`SOLID_SHAPES`	定数	The shapes.
`SOLID_SIZE_NAMES`	定数	THE SIZES OF THE LEVELS OF A SOLID: three to each, small, medium and large, cut so that they come to about the same number of cells whichever solid it is (under a hundred, about three hundred, and six to seven hundred), and so that the one kind of solid is not the easy one: a cube cut 4, 7 and 10 ways has 96, 294 and 600 cells, a globe at frequency 3, 5 and 8 has 92, 252 and 642, an octahedron cut 3, 6 and 9 has 72, 288 and 648.
`SOLID_ZOOM_LEAST`	定数	How far in and out the picture can be zoomed, as a multiple of the fitted size: in to six, so that a cell of a colossal solid (about six pixels across when the whole solid is in the box) is a finger wide (about 24) at four and has room beyond.
`SOLID_ZOOM_MOST`	定数	The maximum native surface-view zoom factor.
`SolidAlgorithm`	型	A maze-carving algorithm supported on a surface graph.
`solidAnswerSteps`	関数	The answer as steps (the format a kept run uses, `lineToSteps`), for a maze: its whole solution.
`solidCells`	関数	How many cells a solid cut `n` ways has.
`solidCellsOf`	関数	How many cells a solid has at a size.
`solidCutOf`	関数	The cut of a solid at a size.
`solidDifficultyOf`	関数	How hard a maze over a solid is to play, from 0 to 100, on the very scale flat mazes are scored on (`difficultyOf`).
`SolidEdge`	型	The edge between two cells: its two corners (indices into `vertices`) and the two cells it lies between.
`SolidFrame`	型	Where a solid is, as a picture of a given size: the turn, the zoom, and every corner and cell as it lands.
`solidGeometry`	関数	How a maze over a solid lies in space, for the measure: squared distance through space to the goal, and the bend of the line in three dimensions.
`SolidGrid`	型	A surface cell graph, neighbouring faces, vertices, projected centres and shape geometry.
`solidGridOf`	関数	The surface of a solid cut `n` ways (`n` at least 2, or 1 for a solid with sixty cells at that): its cells, which are beside which, and where each lies.
`SolidKind`	型	A supported polyhedron, die or shaped surface for a maze.
`SolidMaze`	型	A maze over a solid: what a flat maze has that is not flat.
`SolidRecipe`	型	Everything that makes a maze over a solid.
`solidRecipeCode`	関数	A recipe as one short word, such as `cube:6:prim:48213`, and the other way (`parseSolidRecipe`).
`SolidSize`	型	A named small, medium, large, huge or colossal surface-maze collection.
`solidSolutionOf`	関数	The one way from the start to the goal, cell by cell.
`stepTurn`	関数	A turn about the viewer's own axes: `right` radians about the vertical (the solid's near side moves right) and `down` about the horizontal.
`trackballPoint`	関数	The point of the trackball a point of the picture is on, for turning by a drag: the unit sphere seen from the front, and, outside it, the rim.
`Vec3`	型	A point or a direction in three dimensions.

ソースを見る GitHub で編集@johnmorrisdotca/meikyuu 3.2.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。