Changes between Version 144 and Version 145 of UserGuideGit

Timestamp:

Mar 2, 2009, 4:01:34 PM (16 years ago)

Author:

Frédéric

Comment:

--

UserGuideGit

@@ -153 +153 @@
 It can be usefull to call an external program to make tethered shooting, instead of using the Merlin/Orion triggering.
 
-If a '''{{{shoot.py}}}''' python script is found in the user config. dir, the functions '''{{{mirrorLockup(stabilizationDelay)}}}''' and '''{{{shoot(bracketNumber)}}}''' contained in this script will be called instead of internal ones.
+If a '''{{{shoot.py}}}''' python script is found in the user config. dir, the functions '''{{{mirrorLockup()}}}''' and '''{{{shoot(bracketNumber)}}}''' contained in this script will be called instead of internal ones.
 
 Here is a minimalistic example script (here, we use '''gphoto2''' as tethered shooting program):
@@ -161 +161 @@
 import subprocess
 
+
 def mirrorLockup():
+    """ Lockup the mirror.
+
+    @return: error code, stdout, stderr
+    @rtype: tuple of int, str, str
+    """
+
     # See shoot() function
+    return 0, "", ""
 
 
 def shoot(bracketNumber):
-
-    # Launch the external command
+    """ Shoot.
+
+    @param bracketNumber: number of the current bracket picture
+    @type bracketNumber: int
+
+    @return: error code, stdout, stderr
+    @rtype: tuple of int, str, str
+    """
+
+    # Launch external command
     p = subprocess.Popen(["gphoto2", "--capture-image"], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
 
@@ -173 +189 @@
     stdout, stderr = p.communicate()
 
-    # Return result (a tuple containing return code, stdout and stderr)
-    return p.returncode, stdout, stderr
+    return p.returncode,stdout, stderr
 }}}