Initial projector control page

manual/source/index.rst

@@ -27,6 +27,7 @@ Reference Manual
    mediamanager
    creating_service
    print_service
+   projector
    plugin_list
    display_tags
    configure_shortcuts

manual/source/projector.rst

@@ -6,7 +6,7 @@ Projector Remote Control
 
 The Projector Manager allows you to remotely control a network-connected
 projector that conforms to the Japan Business Machine and Information System
-Associaion (JBMIA) PJLink specification.
+Associaion (JBMIA) PJLink specification. Available in OpenLP v2.2.
 
 Projector Manager
 -----------------
@@ -15,50 +15,109 @@ The Projector Manager is the interface to controlling your projector(s). It is
 located on the bottom-right corner of OpenLP just below the Theme Manager.
 
 .. image:: pics/projector_manager.png
+   :alt: Projector Manager
 
-The icons shown are for (in order from left to right):
+The icons on the Projector Manager tab are:
 
-.. image:: pics/projector_new.png  Add a new projector
-.. image:: pics/projector_connect.png  Connect to all projectors
-.. image:: pics/projector_disconnect.png  Disconnect from all projectors
-.. image:: pics/projector_power_on.png  Power on all projectors
-.. image:: pics/projector_power_off.png  Power Off (standby) all projectors
-.. image:: pics/projector_blank.png  Close the shutter on all projectors
-.. image:: pics/projector_show.png  Open the shutter on all projectors
+.. image:: pics/projector_new.png
+   :height: 100
+   :width: 100
+   :scale: 50
+   :alt: New Projector icon
+
+Add a new projector
+
+.. image:: pics/projector_connect.png
+   :height: 100
+   :width: 100
+   :scale: 50
+   :alt: Connect Projector icon
+
+Connect to all projectors
+
+.. image:: pics/projector_disconnect.png
+   :height: 100
+   :width: 100
+   :scale: 50
+   :alt: Disconnect Projector icon
+
+Disconnect from all projectors
+
+.. image:: pics/projector_power_on.png
+   :height: 100
+   :width: 100
+   :scale: 50
+   :alt: Power On Projector icon
+
+Power on all projectors
+
+.. image:: pics/projector_power_off.png
+   :height: 100
+   :width: 100
+   :scale: 50
+   :alt: Power Off Projector icon
+
+Power Off (standby) all projectors
+
+.. image:: pics/projector_blank.png
+   :height: 100
+   :width: 100
+   :scale: 50
+   :alt: Blank Screen icon
+
+Blank screen - Close the shutter on all projectors
+
+.. image:: pics/projector_show.png
+   :height: 100
+   :width: 100
+   :scale: 50
+   :alt: Show Screen icon
+
+Show screen - Open the shutter on all projectors
 
 Adding a Projector
 ------------------
 
 .. image:: pics/projector_add_wizard_welcome.png
+   :alt: Add Projector Wizard welcome page
 
 When you click on the 'Add Projector' icon, you will launch the wizard to help
-guide you through adding a new projector. click on the :guilabel:`Next`.
+guide you through adding a new projector. click on :guilabel:`Next`. to start.
+On each of the following pages, there's a :guilabel:`Help` button to give you
+some hints as to what goes in what field.
 
 On this page, you will enter the basic information needed to connect to the
 projector.
 
 .. image:: pics/projector_add_wizard_host.png
+   :alt: Add Projector Wizard enter host page
 
 Enter the following information:
 
   IP Number: IPv4 or IPv6 addresses are acceptable. Required.
+
   Port: The network port. Default PJLink port is already filled in.
+
   PIN: If you have authenticated access enabled, enter the PIN here.
 
 Once you enter the information, click on the :guilabel:`Next` button.
 
 .. image:: pics/projector_add_wizard_edit.png
+   :alt: Add Projector Wizard enter host page
 
 On the edit page, you can add the rest of the information for your projector.
 
   Name: A name for you to identify the projector in the manager list. Required.
-  Location: The location where this projector is located.
-  Notes: Any other notes you want for this projector.
+
+  Location: The location where this projector is located. Optional.
+
+  Notes: Any other notes you want for this projector. Optional.
 
 Once you have finished entering information for this projector, click on
 the :guilabel:`Next` button.
 
 .. image:: pics/projector_add_wizard_finish.png
+   :alt: Add Projector Wizard finish page
 
 Once you get to this page, your entry has been saved and is ready for use.
 Click on the :guilabel:`Finish` button to close the wizard.
@@ -66,4 +125,79 @@ Click on the :guilabel:`Finish` button to close the wizard.
 Congratulations - you have finished entering your new projector in the list.
 
 .. image:: pics/projector_manager_list.png
+   :alt: Projector Manager with one entry
 
+Projector Menus
+---------------
+
+Once you have a projector entered, you can right-click on the entry and a pop-up
+menu will show.
+
+These are the descriptions of the menu items you may see. Note that the menu
+entries you see will vary depending on the status of the projector:
+
+    Blank Screen : Close shutter so screen is blank.
+
+    Connect Projector : Connect to this projector.
+
+    Delete Projector : Delete this entry from the database.
+
+    Disconnect Projector : Disconnect from this projector.
+
+    Edit Projector : This will allow you to edit the information on this entry and
+    save changes to the database..
+
+    Power Off Projector : Tell the projector to enter standby.
+
+    Power On Projector : Tell the projector to power on.
+
+    Select Input : Select the projector video source to use.
+
+    Show Screen : Open shutter so you can see the picture.
+
+    View Porjector Information : This will show you the saved information on this
+    entry in the database.
+
+    View Projector Status : Will show you the information gathered from the
+    projector.
+
+Initial Menu
+~~~~~~~~~~~~
+
+When you first enter a projector or when you first start OpenLP, you will select
+from the following menu items:
+
+.. image:: pics/projector_item_not_connected.png
+   :alt: Projector not connected menu
+
+
+Projector Connected Menu 1
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Once the projector has been connected, and if the projector is not powered on,
+you get the below menu list:
+
+.. image:: pics/projector_item_connected_off.png
+   :alt: Projector Connected Power Off menu
+
+Projector Connected Menu 2
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Once you have connected to the projector, and the projector is powered on (either
+by being previously on or you sent the power on command), you will see the
+following menu:
+
+.. image:: pics/projector_item_power_on.png
+   :alt: Projector Connected and Power On menu
+
+Source Input Options
+~~~~~~~~~~~~~~~~~~~~
+
+If you want to change the video source the projetor uses, click on the
+"Select Source" option, then select from the pop-up window which video source
+you want to use.
+
+NOTE: The picture is an example only - what options you
+will have will vary depending on the projector you have.
+
+.. image:: pics/projector_source_select.png