Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


A section is a portion of a bitmap defined by a rectangle that has a x/y-position and width and height.

A section can be used instead of an image resource and has the advantage to use less OS graphic resources. Therefore, it is useful to add only a few image resources combining graphical elements, which are then used as references in the various sections. Check the HALion 6 macro pages to see how this concept is used.

Sections can also be used for animations, by setting the Frames property to the number of subframes that can be found within the section. Furthermore, sections can be scaled by the controls in which they are assigned. Select the Scale Mode and Margins to define the scaling behavior.



On this page:

Table of Contents



The name of the section.

Pos XThe X-coordinate of the first pixel (upper left corner).
Pos YThe Y-coordinate of the first pixel (upper left corner).
WidthThe horizontal size in pixels.
HeightThe vertical size in pixels.
FramesDefines the number of subframes in a bitmap. Bitmaps with frames can be used as animations in controls like knobs, sliders, and animations.
Scale Mode

This 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.

  • Stretch: By default, scale mode is set to stretch, which means that the bitmap is drawn smaller or larger.
  • Tile: This means that the original bitmap will be drawn repeatedly as soon as the control size exceeds the size of the original bitmap.
  • Tile Border: This method repeatedly draws the area that is defined by the margin settings, and leaves the inner area empty.

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, where the four corners of the bitmap are preserved in size and only the rest of the bitmap is stretched, for example.