Click above to get retro games delivered to your door ever month!

WIND_COMB()                                                         C_EXAM12
   Combines objects marked by a window.

   Syntax
         nIndex = WIND_COMB(nCombineLevel [,nLayer] [,nX1,nY1,nX2,nY2])

   Arguments
         cCombineLevel   Level at which objects were combined (0 or 1).
         OPTIONAL PARAMETERS
         nLayer          Layer on which to combine objects.
         nX1             First horizontal corner of box used to combine
                         objects.
         nY1             First vertical corner of box used to combine objects.
         nX2             Second horizontal corner of box used to combine
                         objects.
         nY2             Second vertical corner of box used to combine objects.

   Returns
         nIndex          The object number that the other objects within the
                         box were combined to.

   Description
         WIND_COMB() combines objects surrounded by a window produced by
         MS_OBJECT() or by directly entering the corners into the function.
         It combines the objects in a single step without requiring them to
         be marked first.

         nCombineLevel sets how the objects will be combined. There are two
         levels of combination. Level 0 is for permanently combining objects
         into blocks that will form a single image. Combine level 1 is for
         temporary combines used for moving, copying, or transforming a set
         of objects that you wish to still react as independent objects after
         the transformation.

         nLayer specifies where the objects are that you wish to combine. If
         the parameter is not numeric, then the current layer is selected.

         nX1, nY1, nX2 and nY2 are the upper-left and lower-right corners
         of the combine area. This method can be used instead of using
         the mouse to draw the box.

   Examples

         M_result = MS_OBJECT(1,7,-1,1)         && Draw temporary box
         IF M_result > 0
            WIND_COMB(1)                      && Combine at level 1
         ENDIF