Definition

LONG [id]
{
  [Common flags]
  [MIN minval;]
  [MAX maxval;]
  [MINSLIDER minval;]
  [MAXSLIDER maxval;]
  [STEP step;]
  [CYCLE]
}

Description

Represents integer values in a container. Rendered as a numeric edit field, or as a selection list if CYCLE is present.

Flags

MIN minval;	The minimum value.
MAX maxval;	The maximum value.
MINSLIDER minval;	The minimum value for the slider.
MAXSLIDER maxval;	The maximum value for the slider.
STEP step;	The step for the edit field arrows.
CYCLE idlist;	A selection list. Separate the options with semi-colons.

Cycle

If a CYCLE flag is provided then the element turns into a selection box with the included options:

LONG MY_CYCLE_LONG
{
  CYCLE
  {
    FIRST_VALUE;
    SECOND_VALUE;
    ...
  }
}

The values must correspond to entries in the descname.h and descname.str files.
Two additional marker symbols can be used to display icons and separators:

The ~ symbol followed by an ID for a registered icon.
The -1 for a separator.

For instance the CYCLE resource of the light object looks like this:

LONG LIGHT_TYPE
{
  CYCLE
  {
    LIGHT_TYPE_OMNI~5102;
    LIGHT_TYPE_SPOT~300000146;
    LIGHT_TYPE_DISTANT~300000148;
    LIGHT_TYPE_AREA~300000150;
    -1;
    LIGHT_TYPE_SPOTRECT;
    LIGHT_TYPE_PARALLEL;
    LIGHT_TYPE_PARSPOT;
    LIGHT_TYPE_PARSPOTRECT;
    -1;
    LIGHT_TYPE_PHOTOMETRIC~300000265;
  }
}

Example

LONG PRIM_PLANE_SUBH { MIN 1; MAX 1000; }
LONG DEFORMOBJECT_MODE
{
  CYCLE
  {
    DEFORMOBJECT_MODE_LIMIT;
    DEFORMOBJECT_MODE_BOX;
    DEFORMOBJECT_MODE_UNLIMITED;
  }
}

Definition

Description

Flags

Cycle

Example

Further Reading