Improve docs.

Author: MarcelloPerathoner

doc_src/_static/my_theme.css

@@ -1,3 +1,15 @@
 span.eqno { float: right }
 
 span.eqno a.headerlink { display: none }
+
+.rst-content .menuselection
+{
+    margin: auto 2px;
+    border: 1px solid black;
+    border-radius: 4px;
+    padding: 2.4px 6px;
+    font-size: 80%;
+    font-weight: 700;
+    background-color: rgb(255, 237, 204);
+    white-space: nowrap;
+}

doc_src/glossary.rst

@@ -19,6 +19,11 @@
       A piece of cardboard that is exactly 18% reflecting neutral grey. See:
       https://en.wikipedia.org/wiki/Gray_card
 
+   color reference chart
+
+      A card that has many different color samples on it.  See:
+      https://en.wikipedia.org/wiki/Color_chart
+
    PC Sync
 
       A standard connector used in photography to synchronize the flash to the

doc_src/light-2d.png

@@ -6,78 +6,96 @@ Before taking an RTI image you must decide on :ref:`which lens to use <lenses>`
 and if you will be shooting :ref:`RAW images or JPEGs <raw_or_jpeg>`.  Also look
 into :ref:`vibration reduction <vibration_reduction>` techniques.
 
+Always refer to the online `camera manuals`_ for more details.
+
+.. note::
+
+   This guide refers to Nikon brand cameras.  The RTI dome works with other
+   brand cameras too.  We will add those cameras as soon as we can get our hands
+   around some.
+
 
 Camera Settings
 ===============
 
-1. **Choose RAW or JPEG.** Nikon: :guilabel:`QUAL` + :guilabel:`rear dial`.
+#. **Turn the camera on.**  Turn the power switch to :guilabel:`On`.
 
-2. **Set the white balance** to incandescent light if you are shooting JPEG.
-   Nikon: :guilabel:`WB` + :guilabel:`rear dial`.  This setting has no effect on
-   RAW images.
+#. **Check the clock of the camera.** Press :guilabel:`MENU`, then select
+   :menuselection:`SETUP MENU`, :menuselection:`Time zone and date`,
+   :menuselection:`Date and time`.
 
-3. **Set the ISO sensitivity.** Use the ISO sensitivity with least noise.
-   Nikon: :guilabel:`ISO` + :guilabel:`rear dial`.  All cameras have one ISO
-   sensitivity where the sensor noise is minimal, usually the lowest, but you
-   should check with your camera manual or the internet.
+#. **Choose RAW or JPEG.** Press :guilabel:`QUAL` and turn the :guilabel:`rear
+   dial` until either :menuselection:`RAW` or :menuselection:`FINE★` appears in
+   the display.
 
-4. **Set the lens to manual focus.** Nikon: Push the switch on the lens from
-   :guilabel:`M/A` to :guilabel:`M`.
+#. **Set the white balance** to incandescent light if you are shooting JPEG.
+   Press :guilabel:`WB` and turn the :guilabel:`rear dial` until a light bulb
+   symbol appears on the camera display.  This setting has no effect on RAW
+   images.
 
-5. **Set the camera to manual exposure.** Nikon: :guilabel:`MODE` +
-   :guilabel:`rear dial`.  Use the smallest aperture for maximum depth of field (:term:`DOF`).
-   Nikon: :guilabel:`front dial`.  Set the shutter speed.  Nikon: :guilabel:`rear dial`.
+#. **Set the camera to manual exposure.** Press :guilabel:`MODE` and turn the
+   :guilabel:`rear dial` until an :menuselection:`M` appears in the display.
 
-6. **Set the camera to Continuous High Speed Mode** Nikon: :guilabel:`left dial`.
+#. **Set the ISO sensitivity.** Use the ISO sensitivity with least noise.  Press
+   :guilabel:`ISO` and turn the :guilabel:`rear dial` until the chosen value appears
+   on the camera display.  All cameras have one ISO sensitivity where the sensor
+   noise is minimal, usually the lowest, but you should check with your camera
+   manual or the internet.
 
-7. Either:
+#. **Set the camera to Continuous High Speed Mode** press the safety
+   button near the dial and turn the :guilabel:`left dial` to the
+   :guilabel:`CH` position.
 
-   a) **Turn on live view**.  Nikon D850: :guilabel:`Lv`.  Or
+#. **Set the camera and lens to manual focus.** Set the focus-mode
+   selector on the camera to :guilabel:`M`.  Also set the focus mode switch on
+   the lens (if present) to :guilabel:`M`.
 
-   b) **Turn on exposure delay mode.** Nikon D700: menu :menuselection:`d9`.
+#. **D700 only: Turn on exposure delay mode.** Press :guilabel:`MENU` and select
+   :menuselection:`CUSTOM SETTINGS MENU`, :menuselection:`d9`.
 
-8. Check the clock of the camera. Nikon: :guilabel:`info`.
+#. **Turn the camera off.**  Turn the power switch to :guilabel:`Off`.
 
 
 Dome Setup
 ==========
 
 1. **Connect the RTI dome to the CRM 114** (Camera to RTI Module) using two
-   Cat.5 or better Ethernet cables.
+   Cat.5 or better Ethernet cables.  Don't swap the cables: make sure to connect
+   socket 1 on the CRM 114 with socket 1 on the dome.
 
-2. **Fit lens and camera to the dome.** Align the camera's vertical axis with
-   the 0° axis of dome.  A polarizing filter between dome and lens will allow
-   you to turn the camera with more ease.
+2. **Fit the lens and camera to the dome.** Align the camera's vertical axis
+   with the 0° axis of dome.  The tripod socket on the camera should be near to
+   the 0° marking on the dome while the bottom plate of the camera should be at
+   exactly 90° angle to that mark.  Note: A polarizing filter between dome and
+   lens will allow you to align the camera with more ease.
 
    .. warning::
 
-      You will not get working RTI pictures without correct alignment of dome
-      and camera.
+      A correct alignment of dome and camera is essential to RTI.
 
 3. **Connect the camera to the CRM** using two interface cables.  Connect the
-   PC-Flash output on the camera with the flash input on the CRM.  Connect the
+   PC-Sync output on the camera with the flash input on the CRM.  Connect the
    trigger input on the camera with the trigger output on the CRM.
 
-4. **Connect an external monitor to the camera** using a cable with a mini-HDMI
-   plug at one end.  You may skip this step if you don't want to use an external
-   monitor.
+4. **Optionally connect an external monitor to the camera** using a cable with a
+   mini-HDMI plug at one end.
 
 5. **Connect the AC/DC adaptor to the CRM** and plug it into a wall socket.  The
    green light on the CRM should come on.
 
-6. **Turn the camera on.**
+6. **Turn the camera on.**  Turn the power switch to :guilabel:`On`.
 
 
 Shooting
 ========
 
-1. **Put the object under the dome** in the approximate center of the dome. You
+#. **Put the object under the dome** in the approximate center of the dome. You
    will find the exact position later.
 
-2. **Turn the pilot light on.** Short press the green button to turn the pilot
+#. **Turn the pilot light on.** Short press the green button to turn the pilot
    lights on.  You can also use this button to turn the lights off again.
 
-3. **Focus and center the object.** Look through the viewfinder and use the
+#. **Focus and center the object.** Look through the viewfinder and use the
    focus ring on the lens to put the object into focus.  Move the dome or the
    object around until the object is in the exact center of the picture.  Be
    careful not to rotate the camera from the 0° position.
@@ -86,7 +104,8 @@ Shooting
    view mode.  This will show the picture on the camera monitor.  If you have an
    external monitor attached to the camera you will also see the picture there.
 
-4. **Press the shutter-release button** to make a test exposure.
+#. **Take a test exposure.** Press the shutter-release button to make a test
+   exposure.
 
    Review the picture and check the histogram.  Press :guilabel:`▶` and then
    press what Nikon calls the multi selector in the down direction until you get
@@ -95,12 +114,13 @@ Shooting
    sensitivity).  Repeat this step until you are satisfied with the picture
    histogram.
 
-5. **Close the viewfinder.** This avoids stray light falling into the camera
+#. **Close the viewfinder.** This avoids stray light falling into the camera
    from above.
 
-6. **Press** :guilabel:`Lv` **to enter live view mode.**
+#. **Turn on live view**.  Nikon D800 and later models only.  Press
+   :guilabel:`Lv`.  The object should now appear on the camera screen.
 
-7. **Long press the green button** to start the shooting run.  The camera will
+#. **Long press the green button** to start the shooting run.  The camera will
    start taking exposures.
 
    During a shooting run don't touch the camera or dome and avoid anything that
@@ -131,13 +151,34 @@ internal buffer, which fills up after a short burst, after that the speed of the
 memory card may limit the frame rate.  If your exposure time is longer than the
 writing time the speed of the memory card may not matter.
 
-For greatest depth of field (:term:`DOF`) use the smallest aperture (that is the
-*highest* aperture number).  When you look through the viewfinder you see the
-DOF of the largest aperture, which is much less than the DOF you will get on the
-picture.  For best results focus on the middle ground.
+Choosing the lens aperture: the right lens aperture depends on the depth of
+field (:term:`DOF`) you need to bring the whole object in focus.  A flat object
+requires only a small DOF, an object with more relief requires a larger DOF.
+The smallest aperture gives you the largest DOF.  Note that higher numbers mean
+smaller apertures: f/8 is a smaller aperture than f/4.  OTOH at apertures
+smaller than f/11 lens diffraction will become noticeable.
+
+If you look through the viewfinder you see the DOF of the largest aperture,
+which is much less than the DOF you will get on the actual picture.  Now focus
+somewhere on the middle ground of the object.  If you press the DOF preview
+:guilabel:`Pv` button, the lens will stop down and you will see in the
+viewfinder the actual DOF you'll get in the picture.
+
+If you want color, place the object onto a :term:`grey card` or put a
+:term:`color reference chart` near the object.  This will make it easier to find
+the correct white balance in the raw converter software.
+
+
+Camera Manuals
+==============
+
+  - `Nikon D700 <https://downloadcenter.nikonimglib.com/en/products/15/D700.html>`_
+
+  - `Nikon D800 <https://downloadcenter.nikonimglib.com/en/products/16/D800.html>`_
+
+  - `Nikon D810 <https://downloadcenter.nikonimglib.com/en/products/176/D810.html>`_
 
-If you want color, place the object onto a :term:`grey card`.  This will make it
-easier to find the correct white balance in the raw converter software.
+  - `Nikon D850 <https://downloadcenter.nikonimglib.com/en/products/359/D850.html>`_
 
 
 Footnotes