.. _Documents.add:

================================================
Documents.add
================================================

   :ref:`Document` **add** (:ref:`UnitValue` **width**, :ref:`UnitValue` **height**, :ref:`number` **resolution**, :ref:`string` **name**, :ref:`NewDocumentMode` **mode**, :ref:`DocumentFill` **initialFill**, :ref:`number` **pixelAspectRatio**, :ref:`BitsPerChannelType` **bitsPerChannel**, :ref:`string` **colorProfileName**)


Parameters
----------

+----------------------+-----------------------------------------------------+
| **width**            | The width of the document.                          |
+----------------------+-----------------------------------------------------+
| **height**           | The height of the document.                         |
+----------------------+-----------------------------------------------------+
| **resolution**       | The resolution of the document (in pixels per inch) |
+----------------------+-----------------------------------------------------+
| **name**             | The name of the document.                           |
+----------------------+-----------------------------------------------------+
| **mode**             | The document mode.                                  |
+----------------------+-----------------------------------------------------+
| **initialFill**      | The initial fill of the document.                   |
+----------------------+-----------------------------------------------------+
| **pixelAspectRatio** | The initial pixel aspect ratio of the document.     |
+----------------------+-----------------------------------------------------+
| **bitsPerChannel**   | The number of bits per channel.                     |
+----------------------+-----------------------------------------------------+
| **colorProfileName** | The name of color profile for document.             |
+----------------------+-----------------------------------------------------+



Description
-----------

A document.