LL

Translate a Java class into a JavaScript object. This is a convenience method that avoid repeated use of fully qualified names while scripting Java.

Create a blank animation: frames are created fully transparent and need to be drawn. Notes: animations created this way are memory expensive and cannot be persisted (yet). This means that Shortcut.setCustomIcon() wont't work, but Shortcut.setImage() will.

Create a blank new image of the specified size. Pixel format is always ARGB 8888. Take care when creating images since it can rapidly exhaust memory and lead to a crash.

Create an image from the specified file.

Create an image from a package and a resource name. For instance:LL.createImage("net.pierrox.lightning_launcher_extreme", "icon") The density used is either the one given by ActivityManager.getLauncherLargeIconDensity if available, or the current one.

Create an image whose content is drawn using a script. This can be used for memory efficient graphics and animations. Please refer to ImageScript for the documentation on how to use it.

Create a new script. Use this API wisely.

Request the user to select an area in the image. Warning: because images need to be persisted to file while cropping, this method may be slow.

Delete a script.

Returns an array of desktop identifiers.

Return the collection of scripts matching some flags.

Returns a container by its id.

Return the Android Context this script is linked with (an activity context). This is meant to be used with Android services.

Returns the currently displayed desktop.

Retrieve the currently executed script.

Returns a desktop by its name, as set in the "Configure desktop" screen. The desktop name can be retrieved using getName(). This method will return null if no desktop by that name can be found

Returns the event object associated with this script execution. The event provides contextual data, such as the current desktop, which item has been tapped, and so on.

Returns the desktop used as the floating desktop, or null if not set.

Returns the home desktop. As of Lightning V14, this method looks for the desktop in the home screen, then in the background desktop.

Returns an item by its id. This is a shortcut avoiding to traverse the list of all desktops and folders.

Returns the desktop used as the lock screen, or null if not set. As of Lightning V14, this method looks for the desktop in the lock screen, then in the home screen, and finally in the background desktop.

Returns the list of currently open folders. This function returns the opener item, not the container itself. This method will return null when the script is executed in the background.

Retrieve a script by its unique identifier

Retrieve a script by name

Retrieve the whole set of known variables (builtins and user ones).

Go to a specified desktop, without changing the current position in this desktop.

Go to a specified desktop and set the current absolute position in this desktop, setting a scale of 1 and using animations. This method does nothing when the script is run in background.

Go to a specified desktop and set the current absolute position in this desktop. This method does nothing when the script is run in background.

Returns true if the screen is currently locked using the Lightning lock screen.

Returns whether the current context is paused. It often means that Lightning Launcher is not displayed, for instance because another app is running. When the script is executed in the background this method always returns true.

This method is used to load a text from a package raw resource. Instances of use of this method are:

• load scripts and set them as event handler (useful in script plugins)
• load JSON data, such as theme colors, data, etc.

Request the user to pick a color.

Request the user to pick an image through the Lightning image picker screen. Warning: images returned by this function may be very large, take care at memory use as exceeding limits will make the launcher crash. Use the maxPixels parameter: the image will be scaled by a power of two so that its number of pixels is below or equal. This function supports picking bitmaps and nine patches.

Request the user to enter a numeric value. When using the "%" unit, valueType must be set to FLOAT: the dialog will scale a decimal value so that 0.75 is displayed as 75%. Warning: the returned value may be subject to rounding errors.

Run a Lightning action. This method does nothing when the script is run in background.

Same as #runAction(int,Item,String) with a null item and data.

Same as #runAction(int,String) with a null data.

Run another script. Optional data can be transmitted to the called script and retrieved using getData().

Persist launcher data now.

Send a tasker intent, optionally waiting for its completion to return.

Set a boolean variable. This is a shortcut for LL.getVariables().edit().setBoolean(name, value).commit();. When modifying several at once, consider using the PropertyEditor object instead for best efficiency.

Set a boolean variable. This is a shortcut for LL.getVariables().edit().setFloat(name, value).commit();. When modifying several at once, consider using the PropertyEditor object instead for best efficiency.

Set a boolean variable. This is a shortcut for LL.getVariables().edit().setInteger(name, value).commit();. When modifying several at once, consider using the PropertyEditor object instead for best efficiency.

Set a string variable. This is a shortcut for LL.getVariables().edit().setString(name, value).commit();. When modifying several at once, consider using the PropertyEditor object instead for best efficiency.

Start an activity. Example:

 var intent = new Intent(Intent.ACTION_VIEW, Uri.parse("http://www.pierrox.net/")
 LL.startActivity(intent);

Start an activity and handle the result in another script. This is similar to http://developer.android.com/reference/android/app/Activity.html#onActivityResult%28int,%20int,%20android.content.Intent%29 This call is asynchronous and the script will continue its execution. Once the started activity ends, the "receiver" script is called with the following parameters set:

• resultCode: Integer, the activity result, most often Activity.RESULT_OK or Activity.RESULT_CANCELED
• data: Intent, data provided by the activity, if any
• token: String, optional value passed as third argument in startActivityForResult

Unlock the screen.

Write data to a file. This is for logging and debug purpose only. The path is not configurable and is: /LightningLauncher/script/log.txt. Please note that this method won't add newlines automatically when appending data.