1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE task

    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

    12 <task id="GUID-6F71BDAA-1639-4460-ACE8-BA677AE7D967" xml:lang="en"><title>Switching

    13 ON the lights</title><prolog><metadata><keywords/></metadata></prolog><taskbody>

    14 <context><p>The <codeph>LightOnL()</codeph> method call switch ON the specified

    15 target light. Multiple light targets can be specified by using bitwise-or.</p><p>The

    16 following code snippet demonstrates how to switch ON lights for infinite duration

    17 with default intensity for multiple targets (Lights are switched ON with fade-in): </p><codeblock xml:space="preserve">iLight-&gt;LightOnL( CHWRMExtendedLight::EPrimaryDisplay | CHWRMExtendedLight::EPrimaryKeyboard );</codeblock><p>The following code snippet demonstrates how to switch ON lights for the

    18 specified duration with default intensity for one target (Lights are switched

    19 ON with fade-in):</p><codeblock xml:space="preserve">// aDuration = 5000 milliseconds

    20 light->LightOnL( CHWRMExtendedLight::ESecondaryDisplay, 5000 );

    21 </codeblock><p>After the duration expires, if there are no previous infinite

    22 time duration call in this session, the light state for target is changed

    23 to whatever state was caused by the last infinite time duration call, or default

    24 state determined by inactivity timer.</p><p>The following code snippet demonstrates

    25 how to switch ON lights for the specified duration with specified intensity

    26 for one target (fade-in is also controlled): </p><codeblock xml:space="preserve">// aDuration = 5000 milliseconds

    27 // aIntensity = 50, intensity can be between KHWRMLightMinIntensity and KHWRMLightMaxIntensity, inclusive.

    28 // aFadeIn = EFalse means that lights will turn ON instantly and fade-in is not used,

    29 // ETrue would mean that lights would smoothly fade-in.

    30 light-&gt;LightOnL( CHWRMExtendedLight::ESecondaryDisplay, 5000, 50, EFalse );</codeblock><note> All

    31 devices do not support fade-out. In such scenarios where fade-out is not supported,

    32 the device behaves in its default state.</note></context>

    33 </taskbody></task>