Add layerByID method to Project object

Author: jthomascolombo

docs/general/project.rst

@@ -921,6 +921,42 @@ Retrieves an item by its :ref:`Item ID <Item.id>`
 
 :ref:`Item`.
 
+----
+
+.. _Project.layerByID:
+
+Project.layerByID()
+*********************************************
+
+``app.project.layerByID(id)``
+
+**Description**
+
+Instance method on Project which, when given a valid ID value, returns the Layer object in the Project with that given ID.
+
+**Parameters**
+
+===========     ======================
+``id``          A non-negative integer representing the ID of the Layer to be retrieved from the Project.
+===========     ======================
+
+**Returns**
+
+:ref:`Layer` with the given ID if it exists on the project; otherwise null. Non-valid IDs will throw an exception stating that the input parameter is not an unsigned integer.
+
+**Example**
+
+.. code:: javascript
+
+   var firstComp = app.project.item(1);
+   var firstLayer = firstComp.layer(1);
+   var layerID = firstLayer.id;
+
+   if (app.project.layerByID(layerID) === firstLayer) {
+      alert("You can get the Layer from the ID!");
+   }
+
+
 ----
 
 .. _Project.reduceProject: