.. _set_state_led_off:

set_state_led_off
------------------------------------------
This function turns **OFF** the state LED on the robot arm.  
It disables the LED light completely, regardless of its previously set color or rule configuration.

**Definition** |br|
``DRFLEx.h`` within class `CDRFLEx`, public section (line 995)

.. code-block:: cpp

    bool set_state_led_off()
    {
        return _set_state_led_off(_rbtCtrl);
    };

**Parameter** |br|
None

**Return**

.. list-table::
   :widths: 25 75
   :header-rows: 1

   * - **Value**
     - **Description**
   * - 0
     - Fail — failed to turn off the LED
   * - 1
     - Success — LED successfully turned off

**Example**

.. code-block:: cpp

    // Set LED to red to indicate an active warning state
    Drfl.set_state_led_color(1, 0, 0);  // Red color
    printf("LED set to red: warning active.\n");

    // Simulate a few seconds of system alert
    std::this_thread::sleep_for(std::chrono::seconds(2));

    // Turn off all LED lights (e.g., entering standby or power-save mode)
    Drfl.set_state_led_off();
    printf("LED lights turned off for standby mode.\n");

    // Wait and then reset LED to system default when resuming operation
    std::this_thread::sleep_for(std::chrono::seconds(2));
    Drfl.state_led_reset();
    printf("LED restored to default system color.\n");

This example demonstrates how to **turn off the robot arm's LED lights**  
when entering a standby or power-save mode.  
After displaying a red warning state, all LEDs are turned off using  
`set_state_led_off()`, and later restored to the default system configuration.