.. role:: raw-html-m2r(raw) :format: html Contents ======== * `Contents <#contents>`__ * `VideoIngestion Module <#videoingestion-module>`__ * `Steps to Independently Build and Deploy VideoIngestion Service <#steps-to-independently-build-and-deploy-videoingestion-service>`__ * `Steps to Independently Build VideoIngestion Service <#steps-to-independently-build-videoingestion-service>`__ * `Steps to Independently Deploy VideoIngestion Service <#steps-to-independently-deploy-videoingestion-service>`__ * `Deploy VideoIngestion Service without Config Manager Agent Dependency <#deploy-videoingestion-service-without-config-manager-agent-dependency>`__ * `Deploy VideoIngestion Service with Config Manager Agent Dependency <#deploy-videoingestion-service-with-config-manager-agent-dependency>`__ * `Configuration <#configuration>`__ * `Ingestor Configuration <#ingestor-configuration>`__ * `VideoIngestion Features <#videoingestion-features>`__ * `Image Ingestion <#image-ingestion>`__ * `UDF Configurations <#udf-configurations>`__ * `Updating Security Context of VideoIngestion Helm Charts <#updating-security-context-of-videoingestion-helm-charts>`__ * `Camera Configurations <#camera-configurations>`__ * `GenICam GigE or USB3 Cameras <#genicam-gige-or-usb3-cameras>`__ * `Prerequisites for Working with the GenICam Compliant Cameras <#prerequisites-for-working-with-the-genicam-compliant-cameras>`__ * `RTSP Cameras <#rtsp-cameras>`__ * `USB v4l2 Cameras <#usb-v4l2-cameras>`__ * `RealSense Depth Cameras <#realsense-depth-cameras>`__ VideoIngestion Module --------------------- The VideoIngestion (VI) module ingests the video frames from video sources in the Edge Insights for Industrial (EII) stack for processing. The example of video sources include video files or cameras such as Basler, RTSP, or USB cameras. The VI module can also perform video analytics, when it runs with the classifier and post-processing user defined functions (UDFs). .. image:: /IEdgeInsights/VideoIngestion/img/fig_9_1.png :target: /IEdgeInsights/VideoIngestion/img/fig_9_1.png :alt: Video ingestion diagram The high-level logical flow of the VideoIngestion pipeline is as follows: #. The app reads the application configuration via the Configuration Manager which has details of the ``ingestor``\ , ``encoding``\ , and ``UDFs``. #. Based on the ingestor configuration, the app reads the video frames from a video file or camera. #. [\ ``Optional``\ ] The read frames are passed to one or more chained native or Python UDFs for doing any pre-processing. Passing through UDFs is optional and it is not required to perform any pre-processing on the ingested frames. With chaining of UDFs supported, you also have classifier UDFs and any post-processing UDFs like resize etc., configured in the ``udfs`` key to get the classified results. For more details, refer to the `../common/video/udfs/README.md `_. #. App gets the msgbus endpoint configuration from system environment. Based on the configuration, the app publishes data on the mentioned topic on the MessageBus. .. note:: The following use cases are suitable for a single node deployment, where the overhead of the VideoAnalytics (VA) service can be avoided: * The VA service is not required, when the VI service is configured with a UDF that does the classification. The VI service uses multiple UDFs for pre-processing, classification, and post-processing. * The VA service is not required, when the VI service uses the Gstreamer Video Analytics (GVA) elements. Pre-processing, classification, and post-processing (using the vappi gstreamer elements) can be done in the gstreamer pipeline. If required, you can configure the post-processing by having multiple UDFs in the VI service. Steps to Independently Build and Deploy VideoIngestion Service ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. note:: For running two or more microservices, we recommend users to try the use case-driven approach for building and deploying as mentioned in `Generate Consolidated Files for a Subset of Edge Insights for Industrial Services `_. Steps to Independently Build VideoIngestion Service ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. note:: When switching between independent deployment of the service with and without config manager agent service dependency, one would run into issues with ``docker-compose build`` w.r.t Certificates folder existence. As a workaround, run the command ``sudo rm -rf Certificates`` to proceed with ``docker-compose build``. To independently build VideoIngestion service, complete the following steps: #. The downloaded source code should have a directory named VideoIngestion: .. code-block:: sh cd IEdgeInsights/VideoIngestion #. Copy the IEdgeInsights/build/.env file using the following command in the current folder .. code-block:: sh cp ../build/.env . .. **NOTE**\ : Update the HOST_IP and ETCD_HOST variables in the .env file with your system IP. .. code-block:: sh # Source the .env using the following command: set -a && source .env && set +a #. Independently build .. code-block:: sh docker-compose build Steps to Independently Deploy the VideoIngestion Service ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. note:: \ : Prerequisite for deploying the service: .. Download and unzip the udfs.zip packages using the following commands .. code-block:: sh # Create a common/video directory (if not present) in IEdgeInsights/VideoIngestion mkdir -p common/video && cd common/video # Download the udfs.zip packages from the server and unzip them in the common/video directory. For server address, use value of PKG_SRC variable from IEdgeInsights/build/.env file. set -a && source ../../.env && set +a wget --no-proxy ${PKG_SRC}/udfs.zip unzip udfs.zip # Return to the VideoIngestion directory cd ../../ You can deploy the VideoIngestion service in any of the following two ways: Deploy the VideoIngestion Service without the Config Manager Agent Dependency """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Run the following commands to deploy the VideoIngestion service without Config Manager Agent dependency: .. code-block:: sh # Enter the VideoIngestion directory cd IEdgeInsights/VideoIngestion .. Copy the IEdgeInsights/build/.env file using the following command in the current folder, if not already present. .. code-block:: sh cp ../build/.env . **Note:** Ensure that ``docker ps`` is clean and ``docker network ls`` doesn't have EII bridge network. .. code-block:: Update .env file for following: 1. HOST_IP and ETCD_HOST variables with your system IP. 2. `READ_CONFIG_FROM_FILE_ENV` value to `true` and `DEV_MODE` value to `true`. Source the .env using the following command: set -a && source .env && set +a .. code-block:: sh # Run the service docker-compose -f docker-compose.yml -f docker-compose-dev.override.yml up -d .. note:: VideoIngestion container restarts automatically when its config is modified in ``config.json`` file. If user is updating the config.json file using ``vi or vim`` editor, it is required to append the ``set backupcopy=yes`` in ``~/.vimrc`` so that the changes done on the host machine config.json gets reflected inside the container mount point. Deploy the VideoIngestion Service with the Config Manager Agent Dependency """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Run the following commands to deploy the VideoIngestion service with Config Manager Agent dependency: .. note:: Ensure that the Config Manager Agent image present in the system. If not, build the Config Manager Agent locally when independently deploying the service with Config Manager Agent dependency. .. code-block:: sh # Enter the VideoIngestion directory cd IEdgeInsights/VideoIngestion Copy the IEdgeInsights/build/.env file using the following command in the current folder, if not already present. .. code-block:: sh cp ../build/.env . .. note:: Ensure that ``docker ps`` is clean and ``docker network ls`` does not have EII bridge network. .. code-block:: Update .env file for following: 1. HOST_IP and ETCD_HOST variables with your system IP. 2. `READ_CONFIG_FROM_FILE_ENV` value is set to `false`. .. Run the following command to copy the docker-compose.yml of ConfigMgrAgent from IEdgeInsights/ConfigMgrAgent directory as docker-compose.override.yml in IEdgeInsights/VideoIngestion: .. code-block:: sh cp ../ConfigMgrAgent/docker-compose.yml docker-compose.override.yml .. Copy the builder.py with standalone mode changes from IEdgeInsights/build directory .. code-block:: sh cp ../build/builder.py . .. Run the builder.py in standalone mode, this will generate eii_config.json and update docker-compose.override.yml .. code-block:: sh python3 builder.py -s true Building the service (This step is optional for building the service if not already done in the ``Independently buildable`` step above) .. code-block:: sh docker-compose build To run the service in the PROD mode, run the following command: **NOTE**\ : While running in the PROD mode, ensure to update the ``DEV_MODE`` to ``false`` in the .env file and source the .env using the command ``set -a && source .env && set +a`` .. code-block:: sh docker-compose up -d .. To run the service in the DEV mode, run the following command: **NOTE**\ : While running in the DEV mode, ensure to update the ``DEV_MODE`` to ``true`` in the .env file and source the .env using the command ``set -a && source .env && set +a`` .. code-block:: sh docker-compose -f docker-compose.yml -f docker-compose-dev.override.yml -f docker-compose.override.yml up -d Configuration ^^^^^^^^^^^^^ For configuration details refer to the following topics: #. `UDF Configuration `_ #. `ETCD Secret Configuration `_ #. `MessageBus Configuration `_ #. JSON schema(\ ``[WORK_DIR]/IEdgeInsights/VideoIngestion/schema.json``\ ) All the app module configurations are added to the distributed key-value store under the ``AppName`` env, as mentioned in the environment section of the app's service definition in the ``docker-compose``. If the ``AppName`` is ``VideoIngestion``\ , then the app's config is taken from the ``/VideoIngestion/config`` key via the EII Configuration Manager. .. note:: * The Developer mode-related overrides go in the ``docker-compose-dev.override.yml`` file. * VideoIngestion does not support inferencing with ``MYRIAD (NCS2)`` and ``HDDL`` devices. * For the ``jpeg`` encoding type, ``level`` is the quality from ``0 to 100``. A higher value means better quality. * For the ``png`` encoding type, ``level`` is the compression level from ``0 to 9``. A higher value means a smaller size and longer compression time. * Use the `JSON validator tool `_ for validating the app configuration for the schema. Ingestor Config ~~~~~~~~~~~~~~~ EII supports the following type of ingestors: * `OpenCV `_ * `GStreamer `_ * `RealSense `_ For more information on the Intel RealSense SDK, refer to `librealsense `_. VideoIngestion Features ^^^^^^^^^^^^^^^^^^^^^^^ Refer to the following, to learn more about the VideoIngestion features and supported camera: * `Generic server `_ * `Gstreamer video analytics `_ * `Run GVA elements in VI or VA `_ * `GenICam GigE/USB3.0 camera support <#genicam-gige-or-usb3-cameras>`__ * `RTSP camera support <#rtsp-cameras>`__ * `USB v4l2 compatible camera support <#usb-v4l2-cameras>`__ Image Ingestion ~~~~~~~~~~~~~~~ The Image ingestion feature is responsible for ingesting the images coming from a directory into the EII stack for further processing. The ``OpenCV Ingestor`` supports the image ingestion. Image ingestion supports the following image formats: * Jpg * Jpeg * Jpe * Bmp * Png Refer to the following snippet for configuring the config.json(\ ``[WORK_DIR]/IEdgeInsights/VideoIngestion/config.json``\ ) file, for enabling the image ingestion feature. * OpenCV Ingestor .. code-block:: javascript { // "ingestor": { "type": "opencv", "pipeline": "/app/img_dir/", "poll_interval": 2, "loop_video": true, "image_ingestion": true }, "sw_trigger": { "init_state": "running" }, "max_workers":1, // } The description of the keys used in the ``config.json`` file is as follows: * pipeline — Provides the path to the images directory that is volume mounted. * poll_interval — Refers to the pull rate of image in seconds. Configure the ``poll_interval`` value as required. * loop_video — Would loop through the images directory. * image_ingestion — Optional boolean key. It is required to enable the image ingestion feature. .. **Note:** * The image_ingestion key in the ``config.json`` needs to be set to true for enabling the image ingestion feature. * Set the ``max_workers`` value to 1 as ``"max_workers":1`` in the ``config.json`` files for VideoIngestion/config.json(\ ``[WORK_DIR]/IEdgeInsights/VideoIngestion/config.json``\ ) and VideoAnalytics/config.json(\ ``[WORK_DIR]/IEdgeInsights/VideoAnalytics/config.json``\ ). This is to ensure that the image sequence is maintained. If the ``max_workers`` is set to more than 1, then the images would be out of order due to many multiple threads operating asynchronously. * If the resolution of the image is greater than ``1920×1200``\ , then the image will be resized to ``width = 1920`` and ``height = 1200``. The image is resized to reduce the loading time of the image in the Multimodal Data Visualization and the Multimodal Data Visualization Streaming. Volume mount the image directory present on the host system. To do this, provide the absolute path of the images directory in the ``docker-compose file``. Refer to the following snippet of the ``ia_video_ingestion`` service to add the required changes in the docker-compose.yml(\ ``[WORK_DIR]/IEdgeInsights/VideoIngestion/docker-compose.yml``\ ) file. After making the changes, ensure that the builder.py(\ ``[WORK_DIR]/IEdgeInsights/build/builder.py``\ ) is executed before you build and run the services. .. code-block:: yaml ia_video_ingestion: ... volume: - "vol_eii_socket:${SOCKET_DIR}" - "/var/tmp:/var/tmp" # Add volume # Provide the absolute path to the images directory present in the host system for volume mounting the directory. Eg: -"home/directory_1/images_directory:/app/img_dir" - ":/app/img_dir" ... UDF Configurations ~~~~~~~~~~~~~~~~~~ Ensure that you are using the appropriate UDF configuration for all the video and camera streams. If the UDF is not compatible with the video source, then you may not get the expected output in the Multimodal Data Visualization or the Multimodal Data Visualization Streaming screen. Use the ``dummy`` UDF, if you are not sure about the compatibility of the UDF and a video source. The dummy UDF will not do any analytics on the video, and it will not filter any of the video frames. You will see the video streamed by the camera, as it is displayed on the video output screen in the Multimodal Data Visualization or Multimodal Data Visualization Streaming. .. Refer to the following configuration for the ``dummy`` UDF: .. code-block:: javascript "udfs": [{ "name": "dummy", "type": "python" }] > .. Apply the same changes in the VideoAnalytics configuration, if it is subscribing to VideoIngestion. Updating Security Context of VideoIngestion Helm Charts ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Complete the following steps to update the Helm charts to enable K8s environment to access or detect Basler Camera and USB devices: #. Open the ``EII_HOME_DIR/IEdgeInsights/VideoIngestion/helm/templates/video-ingestion.yaml`` file #. Update the following security context snippet: .. code-block:: yml securityContext: privileged: true in the yaml file as: .. code-block:: yaml ... ... ... imagePullPolicy: {{ $global.Values.imagePullPolicy }} securityContext: privileged: true volumeMounts: - name: dev mountPath: /dev ... #. Rerun the ``builder.py`` to apply these changes to your deployment Helm charts. Camera Configurations ~~~~~~~~~~~~~~~~~~~~~ The camera configurations for the VI module are as follows: * For a video file: * OpenCV Ingestor .. code-block:: javascript { "type": "opencv", "pipeline": "./test_videos/pcb_d2000.avi", "poll_interval": 0.2 "loop_video": true } * Gstreamer Ingestor .. code-block:: javascript { "type": "gstreamer", "pipeline": "multifilesrc loop=TRUE stop-index=0 location=./test_videos/pcb_d2000.avi ! h264parse ! decodebin ! videoconvert ! video/x-raw,format=BGR ! appsink" } For more information or configuration details for the ``multifilesrc`` element, refer to the `docs/multifilesrc_doc.md `_. GenICam GigE or USB3 Cameras """""""""""""""""""""""""""" .. note:: As EII is using Matrix Vision SDKe(\ ``[WORK_DIR]/IEdgeInsights/VideoIngestion/mvGenTL_Acquire-x86_64_ABI2-2.44.1.tgz``\ ) with evaluation license, one would start seeing watermark after 200 ingested images when using a non Matrix Vision camera. One has to purchase the Matrix Vision license to remove this watermark or use a Matrix Vision camera or integrate the respective camera SDK(Eg: basler camera SDK for basler cameras). For more information or configuration details for the GenICam GigE or the USB3 camera support, refer to the `GenICam GigE/USB3.0 Camera Support `_. Prerequisites for Working with the GenICam Compliant Cameras ############################################################ The following are the prerequisites for working with the GeniCam compliant cameras. .. note:: For other cameras such as RealSense, RSTP, and USB (v4l2 driver compliant) revert the changes that are mentioned in this section. Refer to the following snip of the ``ia_video_ingestion`` service, to add the required changes in the docker-compose.yml(\ ``[WORK_DIR]/IEdgeInsights/VideoIngestion/docker-compose.yml``\ ) file of the respective ingestion service (including custom UDF services). After making the changes, before you build and run the services, ensure to run the builder.py(\ ``[WORK_DIR]/IEdgeInsights/build/builder.py``\ ). * For GenICam GigE cameras: Update the ``ETCD_HOST`` key with the current system's IP in the .env(\ ``[WORK_DIR]/IEdgeInsights/build/.env``\ ) file. .. code-block:: sh ETCD_HOST= Make the following changes to the docker-compose.yml(\ ``[WORK_DIR]/IEdgeInsights/VideoIngestion/docker-compose.yml``\ ) file. .. code-block:: yaml ia_video_ingestion: # Add root user user: root # Add network mode host network_mode: host # Ensure that the previous commands are not added under the environment section and also take care of the indentations in the compose file. ... environment: ... # Add HOST_IP to no_proxy and ETCD_HOST no_proxy: "${RTSP_CAMERA_IP}," ETCD_HOST: "" ... # Comment the networks section as it will throw an error when network mode host is used. # networks: # - eii # Comment ports section as below # ports: # - 64013:64013 For GenIcam USB3.0 cameras: .. code-block:: yaml ia_video_ingestion: # Add root user user: root ... environment: # Refer [GenICam GigE/USB3.0 Camera Support](/IEdgeInsights/VideoIngestion/docs/generic_plugin_doc.html) to install the respective camera SDK # Setting the GENICAM value to the respective camera/GenTL producer which needs to be used GENICAM: "" ... .. note:: * If the GenICam cameras do not get initialized during the runtime, then on the host system, run the ``docker system prune`` command. After that, remove the GenICam specific semaphore files from the ``/dev/shm/`` path of the host system. The ``docker system prune`` command will remove all the stopped containers, networks that are not used (by at least one container), any dangling images, and build cache which could prevent the plugin from accessing the device. * If you get the ``Feature not writable`` message while working with the GenICam cameras, then reset the device using the camera software or using the reset property of the Generic Plugin. For more information, refer to the `README `_. * In the ``IPC`` mode, if the Ingestion service is running with the ``root`` privilege, then the ``ia_video_analytics``\ , ``multimodal-data-visualization-streaming`` and ``multimodal-data-visualization`` service subscribing to it must also run with the ``root`` privileges. * In a multi-node scenario, replace :raw-html-m2r:`` in "no_proxy" with the leader node's IP address. * In the TCP mode of communication, the msgbus subscribers and clients of VideoIngestion are required to configure the ``Endpoint`` in the ``config.json`` file with the host IP and port under the ``Subscribers`` or ``Clients`` interfaces section. * Gstreamer Ingestor * GenICam GigE/USB3.0 cameras .. code-block:: javascript { "type": "gstreamer", "pipeline": "gencamsrc serial= pixel-format= exposure-time=5000 exposure-mode=timed exposure-auto=off throughput-limit=300000000 ! videoconvert ! video/x-raw,format=BGR ! appsink" } .. **Note:** * The Generic Plugin can work only with GenICam compliant cameras and only with gstreamer ingestor. * The previous gstreamer pipeline was tested with Basler and IDS GigE cameras. * If ``serial`` is not provided, then the first connected camera in the device list will be used. * If ``pixel-format`` is not provided, then the default ``mono8`` pixel format will be used. * If ``width`` and ``height`` properies are not set, then gencamsrc plugin will set the maximum resolution supported by the camera. * By default, ``exposure-auto`` property is set to ON. If the camera is not placed under the sufficient light, then with auto exposure, ``exposure-time`` can be set to very large value which will increase the time taken to grab frame. This can lead to ``No frame received error``. Hence, it is recommended to manually set exposure as in the sample pipline when the camera is not placed under good lighting conditions. * ``throughput-limit`` is the bandwidth limit for streaming out data from the camera(in bytes per second). * While using the USB3.0 camera, ensure that the USBFS limit is set to atleast 256MB or more. You can verify this value by using command ``cat /sys/module/usbcore/parameters/usbfs_memory_mb``. If it is less than 256MB, then follow these `steps to increase the USBFS value `_. * Hardware trigger based ingestion with Gstreamer ingestor .. code-block:: javascript { "type": "gstreamer", "pipeline": "gencamsrc serial= pixel-format= trigger-selector=FrameStart trigger-source=Line1 trigger-activation=RisingEdge hw-trigger-timeout=100 acquisition-mode=singleframe exposure-time=5000 exposure-mode=timed exposure-auto=off throughput-limit=300000000 ! videoconvert ! video/x-raw,format=BGR ! appsink" } .. **Note:** * For PCB use case, use the ``width`` and ``height`` properties of the gencamsrc to set the resolution to ``1920x1200`` and make sure it is pointing to the rotating PCB boards, as seen in the ``pcb_d2000.avi`` video file for the PCB filter to work. Refer to the following example pipeline: .. code-block:: javascript { "type": "gstreamer", "pipeline": "gencamsrc serial= pixel-format=ycbcr422_8 width=1920 height=1200 exposure-time=5000 exposure-mode=timed exposure-auto=off throughput-limit=300000000 ! videoconvert ! video/x-raw,format=BGR ! appsink" } Refer to the `docs/basler_doc.md `_ for more information or configuration details on Basler camera. RTSP Cameras ~~~~~~~~~~~~ Update the RTSP camera IP or the simulated source IP to the ``RTSP_CAMERA_IP`` variable in the .env(\ ``[WORK_DIR]/IEdgeInsights/build/.env``\ ) file. Refer to the `docs/rtsp_doc.md `_ for information or configuration on RTSP camera.** * OpenCV Ingestor .. code-block:: javascript { "type": "opencv", "pipeline": "rtsp://:@:/" } .. **Note**\ : OpenCV for RTSP will use software decoders. * Gstreamer Ingestor .. code-block:: javascript { "type": "gstreamer", "pipeline": "rtspsrc location=\"rtsp://:@:/\" latency=100 ! rtph264depay ! h264parse ! vaapih264dec ! vaapipostproc format=bgrx ! videoconvert ! video/x-raw,format=BGR ! appsink" } .. **Note:** The RTSP URI of the physical camera depends on how it is configured using the camera software. You can use VLC Network Stream to verify the RTSP URI to confirm the RTSP source. * For RTSP simulated camera using CVLC * OpenCV Ingestor .. code-block:: javascript { "type": "opencv", "pipeline": "rtsp://:/" } * Gstreamer Ingestor .. code-block:: javascript { "type": "gstreamer", "pipeline": "rtspsrc location=\"rtsp://:/\" latency=100 ! rtph264depay ! h264parse ! vaapih264dec ! vaapipostproc format=bgrx ! videoconvert ! video/x-raw,format=BGR ! appsink" } **Refer to `docs/rtsp_doc.md `_ for more information or configuration on the RTSP simulated camera.** USB v4l2 Cameras ~~~~~~~~~~~~~~~~ For information or configurations details on the USB cameras, refer to `docs/usb_doc.md `_. * OpenCV Ingestor .. code-block:: javascript { "type": "opencv", "pipeline": "/dev/" } * Gstreamer Ingestor .. code-block:: javascript { "type": "gstreamer", "pipeline": "v4l2src device=/dev/ ! video/x-raw,format=YUY2 ! videoconvert ! video/x-raw,format=BGR ! appsink" } RealSense Depth Cameras ~~~~~~~~~~~~~~~~~~~~~~~ * ``RealSense Ingestor`` .. code-block:: javascript "ingestor": { "type": "realsense", "serial": "", "framerate": , "imu_on": true }, .. **Note** * The Intel RealSense Ingestor was tested with the Intel RealSense Depth Camera D435i. * RealSense Ingestor does not support poll_interval. If required, use framerate to reduce the ingestion frames per second (FPS). * If the ``serial`` config is not provided, then the first RealSense camera in the device list will be connected. * If the ``framerate`` config is not provided, then the default framerate of ``30`` will be applied. Ensure that the framerate provided is compatible with both the color and depth sensor of the RealSense camera. With the D435i camera, only framerate 6,15,30, and 60 is supported and tested. * The IMU stream will work only if the RealSense camera model supports the IMU feature. The default value for ``imu_on`` is set to ``false``.