The name of the Bitmap resource.
|Path||Specifies the path and file name of the used bitmap.|
|Frames||Defines the number of subframes in a bitmap. Bitmaps with frames can be used as animations in controls like knobs, sliders, and animations.|
This mode defines how a bitmap is adapted in size when the control that is using it is set to be scalable and sized smaller or larger than the original bitmap.
Left, Top, Right, Bottom.
As soon as a margin is set, the margin area is not stretched or tiled, but only the area outside. This can be used to define frames, for example, where the four corners of the bitmap are preserved in size and only the rest of the bitmap is stretched.
On Windows systems, the maximum size for bitmaps is 2048 x 16384 pixels. Note that this refers to the bitmap size in memory rather than to the absolute size of the bitmap file.
When loading a bitmap, a rescaled version of the bitmap resource is automatically created in memory. The size of the bitmap resource depends on the display scaling factor.
For example, if you use a scaling factor of 200 %, the size of the bitmap resource will be twice the original file size. This higher-resolution bitmap resource will then use either an upscaled version of the bitmap file or an additional High-DPI version of it.
In other words, a standard bitmap should have a maximum width of 1024 and height of 8192 pixels, to allow for a scaling factor of 200%.
If you want to leave headroom for higher display scaling factors like 300%, for example, you must reduce the maximum size of the bitmaps to approx. 680 x 5460 pixels.
Especially with animations that contain a large number of frames, a height of 8192 pixels is easily reached. So be careful when creating animations for large objects.
A knob with 100 x 100 pixel frame size and 100 frames will lead to a bitmap of 100 x 10.000 pixels.
Using a windows scaling factor of 200%, the High-DPI version of this knob would have a size of 200 x 20.000 pixels in memory or would require a dedicated file of that size, which would be too large.
Decreasing the number of frames to 65, as it is the case for most of the HALion factory controls, reduces the size to 100 x 6.500
in standard and 200 x 13.000 in High DPI resolution.