Changeset 9608

Timestamp:

Oct 16, 2006, 5:42:55 PM (20 years ago)

Author:

Paul Price

Message:

Documenting pmHDUUtils.[ch]

Location:

trunk/psModules/src/camera

Files:

• pmHDUUtils.c (modified) (7 diffs)
• pmHDUUtils.h (modified) (2 diffs)

trunk/psModules/src/camera/pmHDUUtils.c

@@ -9 +9 @@
 
 
-pmHDU *pmHDUFromFPA(const pmFPA *fpa    // FPA for which to find HDU
-                   )
+pmHDU *pmHDUFromFPA(const pmFPA *fpa)
 {
     PS_ASSERT_PTR_NON_NULL(fpa, NULL);
@@ -16 +15 @@
 }
 
-pmHDU *pmHDUFromChip(const pmChip *chip // Chip for which to find HDU
-                    )
+pmHDU *pmHDUFromChip(const pmChip *chip)
 {
     PS_ASSERT_PTR_NON_NULL(chip, NULL);
@@ -29 +27 @@
 }
 
-pmHDU *pmHDUFromCell(const pmCell *cell // Cell for which to find HDU
-                    )
+pmHDU *pmHDUFromCell(const pmCell *cell)
 {
     PS_ASSERT_PTR_NON_NULL(cell, NULL);
@@ -42 +39 @@
 }
 
-pmHDU *pmHDUFromReadout(const pmReadout *readout // Readout for which to find HDU
-                       )
+pmHDU *pmHDUFromReadout(const pmReadout *readout)
 {
     PS_ASSERT_PTR_NON_NULL(readout, NULL);
@@ -53 +49 @@
 
 // Get the lowest HDU
-pmHDU *pmHDUGetLowest(const pmFPA *fpa, // The FPA
-                      const pmChip *chip, // The chip, or NULL
-                      const pmCell *cell // The cell, or NULL
-                     )
+pmHDU *pmHDUGetLowest(const pmFPA *fpa, const pmChip *chip, const pmCell *cell)
 {
     pmHDU *hdu = NULL;          // The HDU that's at the lowest level
@@ -71 +64 @@
 
 // Get the highest HDU
-pmHDU *pmHDUGetHighest(const pmFPA *fpa, // The FPA
-                       const pmChip *chip, // The chip, or NULL
-                       const pmCell *cell // The cell, or NULL
-                      )
+pmHDU *pmHDUGetHighest(const pmFPA *fpa, const pmChip *chip, const pmCell *cell)
 {
     pmHDU *hdu = NULL;          // The HDU that's at the highest level
@@ -90 +80 @@
 }
 
-void pmHDUPrint(FILE *fd,               // File descriptor to which to print
-                const pmHDU *hdu,       // HDU to print
-                int level,              // Level at which to print
-                bool header             // Print header?
-               )
+void pmHDUPrint(FILE *fd, const pmHDU *hdu, int level, bool header)
 {
     PS_ASSERT_PTR_NON_NULL(hdu,);

trunk/psModules/src/camera/pmHDUUtils.h

@@ +1 @@
+/// @file pmHDUUtils.h
+///
+/// @brief Utility functions for working with an HDU
+///
+/// @ingroup Camera
+///
+/// @author Paul Price, IfA
+///
+/// @version $Revision: 1.6 $ $Name: not supported by cvs2svn $
+/// @date $Date: 2006-10-17 03:42:55 $
+///
+/// Copyright 2005-2006 Institute for Astronomy, University of Hawaii
+///
+
 #ifndef PM_HDU_UTILS_H
 #define PM_HDU_UTILS_H
@@ -5 +19 @@
 #include "pmHDU.h"
 
-// Get the lowest HDU in the hierarchy, as supplied
-pmHDU *pmHDUGetLowest(const pmFPA *fpa, // The FPA
-                      const pmChip *chip, // The chip, or NULL
-                      const pmCell *cell // The cell, or NULL
+/// Get the lowest HDU in the hierarchy
+///
+/// The lowest HDU in the hierarchy will be the one with the actual pixels (if all levels are supplied).
+pmHDU *pmHDUGetLowest(const pmFPA *fpa, ///< The FPA
+                      const pmChip *chip, ///< The chip, or NULL
+                      const pmCell *cell ///< The cell, or NULL
                      );
 
-// Get the highest HDU in the hierarchy, as supplied
-pmHDU *pmHDUGetHighest(const pmFPA *fpa, // The FPA
-                       const pmChip *chip, // The chip, or NULL
-                       const pmCell *cell // The cell, or NULL
+/// Get the highest HDU in the hierarchy
+///
+/// The highest HDU in the hierarchy will be the PHU (might get NULL if not all levels are supplied)
+pmHDU *pmHDUGetHighest(const pmFPA *fpa, ///< The FPA
+                       const pmChip *chip, ///< The chip, or NULL
+                       const pmCell *cell ///< The cell, or NULL
                       );
 
-// Find the HDU in the FPA hierarchy
-pmHDU *pmHDUFromFPA(const pmFPA *fpa    // FPA for which to find HDU
+/// Given an FPA, return the HDU (or NULL if all HDUs reside below the FPA)
+pmHDU *pmHDUFromFPA(const pmFPA *fpa    ///< FPA for which to find HDU
                    );
-pmHDU *pmHDUFromChip(const pmChip *chip // Chip for which to find HDU
+
+/// Given a chip, return the HDU (or NULL if it resides below the chip)
+pmHDU *pmHDUFromChip(const pmChip *chip ///< Chip for which to find HDU
                     );
-pmHDU *pmHDUFromCell(const pmCell *cell // Cell for which to find HDU
+
+/// Given a cell, return the HDU
+pmHDU *pmHDUFromCell(const pmCell *cell ///< Cell for which to find HDU
                     );
-pmHDU *pmHDUFromReadout(const pmReadout *readout // Readout for which to find HDU
+
+/// Given a readout, return the HDU
+pmHDU *pmHDUFromReadout(const pmReadout *readout ///< Readout for which to find HDU
                        );
 
-// Print details about an HDU
-void pmHDUPrint(FILE *fd,               // File descriptor to which to print
-                const pmHDU *hdu,       // HDU to print
-                int level,              // Level at which to print
-                bool header             // Print header?
+/// Print details about an HDU
+///
+/// This is intended for testing or development use.  Only works if tracing is enabled.
+void pmHDUPrint(FILE *fd,               ///< File descriptor to which to print
+                const pmHDU *hdu,       ///< HDU to print
+                int level,              ///< Level at which to print
+                bool header             ///< Print header?
                );