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

LAYER_ON()                                                          C_DEMO
   Changes a layer's status for object searches and remapping.

   Syntax
         nActiveStatus = LAYER_ON(nLayer [,nActiveStatus] [,nBox] [,nPoly]
                                  [,nCircle] [,nText])

   Arguments
         nLayer           Sets the number of the layer to turn on or off.
         OPTIONAL PARAMETERS
         nActiveStatus    Sets the status of the layer.
                              0 = turn layer off totally.
                              1 = turn layer on totally.
                              2 = display layer but don't search it.
         nBox             Default search method for box (type 1)
         nPoly            Default search method for polygon (type 2)
         nCircle          Default search method for circle (type 10-17)
         nText            Default search method for text (type 20)
                              -1  Do not find this object.
                               0  Find object on line.
                               1  Find inside of closed objects.

   Returns
         nLayer = LAYER_ON(nLayer,@nActiveStatus,@nBox,@nPoly,@nCircle,@nText)

   Description
         LAYER_ON() changes a layer's status for object searches and
         remapping. A layer has three types of status:
+----------------------------------------------------------------------------+
|Layer nActiveStatus Flags                                                   |
-----------------------------------------------------------------------------|
|Status|Description                                                          |
|------+---------------------------------------------------------------------|
|   0  |Off: The layer is ignored for all searching and remapping of objects.|
|   1  |Active: The layer is always searched and remapped when called for.   |
|   2  |Passive: The layer is remapped but objects are not searched.         |
+----------------------------------------------------------------------------+
         The default search method can be set for new objects created on a
         layer. nBox sets the default search method. If you set it to a -1,
         then it will not be found at all. The default is to find the object
         by touching the mouse cursor on the edge of the object. A setting
         of 1 will find a closed object, polygon or box, when the mouse is
         anywhere inside the object. nPoly, nCircle, and nText let you set
         default search methods for polygons, circles, and text.