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

OBJS_READ()                                                         C_DEMO
   Restores objects previously saved to a DOS file.

   Syntax
         OBJS_READ(cFileName [,nLayer])

   Arguments
         cFileName   Sets a valid DOS name of a file to read, optionally
         OPTIONAL PARAMETERS
         nLayer      Sets the destination layer for the objects. If nLayer
                     is not specified, objects will be copied into the layer
                     from which they were originally saved with OBJS_SAVE().
                     If layers before nLayer do not exist, they will be
                     created.

   Returns
         None

   Description
         OBJS_READ() reads in a binary DOS file that was previously saved with
         OBJS_SAVE(). The objects are restored in their original color and
         groups. An object's marked status is not saved. Therefore, marked
         objects will be restored as unmarked. When nLayer is specified, the
         objects will be placed on that layer. Layers with lower numbers will
         be created as needed.

   Examples

         Load saved objects to the drawing viewport:

         OBJ_DELETE(0)                    && Clear current drawing
         OBJS_READ("CADFILE.CAD")         && Restore objects from file