Sizing
How to size elements and use pixelSize, sizeX, and sizeY.
TLDR: The size of the Root element is defined in three.js units through the optional sizeX
and sizeY
parameters. The pixelSize
parameter allows you to define how big one pixel in the UI is in relation to one three.js unit.
Important
The pixelSize
should be set so that the default font height (16px
) is reasonably sized. All pre-built components adhere to this sizing concept.
In Depth Explanation
The root element size is specified in three.js units using the optional sizeX
and sizeY
parameters.
Declaring the size of elements inside the root element using parameters, such as the width
of an image or the fontSize
of a text element, is based on pixel
units, which strongly relate to the px
unit in CSS. The relation between three.js units and pixel units can be set using the pixelSize
property. The property expresses the size of one pixel in three.js units and defaults to 0.002
. With this default, 500px
is equal to 1 three.js unit. To make interoperability between code bases and different component libraries easier, we encourage to use the intuition of pixel sizes from the web. For instance, the default text height relates to 16 pixels. If these pixel sizes appear too small or too high in the szene, the pixelSize
should be increased or decreased respectively.