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

HOT_INFO()                                                          C_DEMO
   Returns information from the hot object buffer.

   Syntax
         nHotInfo = HOT_INFO([nItem])

   Arguments
         OPTIONAL PARAMETERS
         nItem       Hot buffer information.

   Returns
         nHotInfo    Information requested by nItem.

                  +----------------------------+
                  |    Item      | Description |
                  ---------------+-------------|
                  | No. parameter| Number      |
                  |     1        | Color       |
                  |     2        | Layer       |
                  |     3        | Mark        |
                  |     4        | Sequence    |
                  |     5        | Closest X   |
                  |     6        | Closest Y   |
                  +----------------------------+

   Description
         Objects in the drawing can be made hot by placing the mouse cursor
         on the edge of any object and pressing a mouse button while in
         KEY_PRESS(). The information about the object that released the
         KEY_PRESS() as an event 64 is stored in a hot buffer until a new
         object replaces it.

         The hot object number can be returned with HOT_INFO() if a number is
         passed outside the range or no parameter is passed at all.

         nItem 1 is the color of the current hot object. If the color of the
         object is set to take the current color of the layer by entering a
         -1 when the object was added, the color returned will be the current
         color of the layer. If the object is marked by a call to OBJ_EDIT()
         or MARK_WIND(), the current color of the marked objects is returned.
         Otherwise, the color of the object when it was added to the layer
         will be returned.

         nItem 2 returns the layer that the object was stored on.

         nItem 3 returns whether the current hot object is marked or not. A
         1 is returned if it has been marked, a 0 is returned if the object
         is not marked.

         nItem 4 returns the line segment number value stored in the hot
         buffer from the last hot object found. This refers to the sequence
         within the object of the segment that the hot point resides.

         nItem 5 returns the X coordinate of the closest point as stored in
         the hot buffer from the last hot object found.

         nItem 6 returns the Y coordinate of the closest point as stored in
         the hot buffer from the last hot object found.