IPP Software Navigation Tools IPP Links Communication Pan-STARRS Links

Ignore:
Timestamp:
Aug 9, 2004, 12:44:25 PM (22 years ago)
Author:
desonia
Message:

fixed some stupid indent-induced formating problems and added doxygen
comments.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/psLib/src/collections/psMetadata.h

    r1407 r1426  
    1111*  @author Ross Harman, MHPCC
    1212*
    13 *  @version $Revision: 1.16 $ $Name: not supported by cvs2svn $
    14 *  @date $Date: 2004-08-07 00:06:06 $
     13*  @version $Revision: 1.17 $ $Name: not supported by cvs2svn $
     14*  @date $Date: 2004-08-09 22:44:25 $
    1515*
    1616*  Copyright 2004 Maui High Performance Computing Center, University of Hawaii
     
    3434 */
    3535typedef enum {
    36     PS_META_ITEM_SET = 0,       // /< Null. Metadata is in psMetadataItem.items
    37     PS_META_BOOL,                          // /< Boolean data.
    38     PS_META_S32,                           // /< Signed 32-bit integer data.
    39     PS_META_F32,                           // /< Single-precision float data.
    40     PS_META_F64,                           // /< Double-precision float data.
    41     PS_META_STR,                           // /< String data (Stored in as void *).
    42     PS_META_IMG,                           // /< Image data (Stored in as void *).
    43     PS_META_JPEG,                          // /< JPEG data (Stored in as void .
    44     PS_META_PNG,                           // /< PNG data (Stored in as void *).
    45     PS_META_ASTROM,                        // /< Astrometric coefficients (Stored in as void *).
    46     PS_META_UNKNOWN,                       // /< Other data (Stored in as void *).
    47     PS_META_NTYPE                          // /< Number of types. Must be last.
     36    PS_META_ITEM_SET = 0,       ///< Null. Metadata is in psMetadataItem.items
     37    PS_META_BOOL,                          ///< Boolean data.
     38    PS_META_S32,                           ///< Signed 32-bit integer data.
     39    PS_META_F32,                           ///< Single-precision float data.
     40    PS_META_F64,                           ///< Double-precision float data.
     41    PS_META_STR,                           ///< String data (Stored in as void *).
     42    PS_META_IMG,                           ///< Image data (Stored in as void *).
     43    PS_META_JPEG,                          ///< JPEG data (Stored in as void .
     44    PS_META_PNG,                           ///< PNG data (Stored in as void *).
     45    PS_META_ASTROM,                        ///< Astrometric coefficients (Stored in as void *).
     46    PS_META_UNKNOWN,                       ///< Other data (Stored in as void *).
     47    PS_META_NTYPE                          ///< Number of types. Must be last.
    4848} psMetadataType;
    4949
     
    5555typedef struct psMetadataItem
    5656{
    57     const int id;               // /< Unique ID for metadata item.
    58     char *restrict name;        // /< Name of metadata item.
    59     psMetadataType type;        // /< Type of metadata item.
     57    const int id;               ///< Unique ID for metadata item.
     58    char *restrict name;        ///< Name of metadata item.
     59    psMetadataType type;        ///< Type of metadata item.
    6060    union {
    6161        bool B;
    62         psS32 S32;              // /< Signed 32-bit integer data.
    63         psF32 F32;              // /< Single-precision float data.
    64         psF64 F64;              // /< Double-precision float data.
    65         psPTR V;                // /< Pointer to other type of data.
    66     } data;                     // /< Union for data types.
    67     char *comment;              // /< Optional comment ("", not NULL).
    68     psList *restrict items;     // /< List of psMetadataItems with same name.
     62        psS32 S32;              ///< Signed 32-bit integer data.
     63        psF32 F32;              ///< Single-precision float data.
     64        psF64 F64;              ///< Double-precision float data.
     65        psPTR V;                ///< Pointer to other type of data.
     66    } data;                     ///< Union for data types.
     67    char *comment;              ///< Optional comment ("", not NULL).
     68    psList *restrict items;     ///< List of psMetadataItems with same name.
    6969}
    7070psMetadataItem;
     
    102102 * @return psMetadataItem*: Pointer metadata item.
    103103 */
    104 psMetadataItem *psMetadataItemAlloc(const char *name,   // /< Name of metadata item.
    105                                     psMetadataType type,        // /< Type of metadata item.
    106                                     const char *comment,        // /< Comment for metadata item.
    107                                     ... // /< Arguments for name formatting and metadata item data.
     104psMetadataItem *psMetadataItemAlloc(const char *name,   ///< Name of metadata item.
     105                                    psMetadataType type,        ///< Type of metadata item.
     106                                    const char *comment,        ///< Comment for metadata item.
     107                                    ... ///< Arguments for name formatting and metadata item data.
    108108                                   );
    109109
     
    121121 * @return psMetadataItem*: Pointer metadata item.
    122122 */
    123 psMetadataItem *psMetadataItemAllocV(const char *name,  // /< Name of metadata item.
    124                                      psMetadataType type,       // /< Type of metadata item.
    125                                      const char *comment,       // /< Comment for metadata item.
    126                                      va_list list       // /< Arguments for name formatting and metadata item
     123psMetadataItem *psMetadataItemAllocV(const char *name,  ///< Name of metadata item.
     124                                     psMetadataType type,       ///< Type of metadata item.
     125                                     const char *comment,       ///< Comment for metadata item.
     126                                     va_list list       ///< Arguments for name formatting and metadata item
    127127                                     // data.
    128128                                    );
     
    134134 * @return psMetadata*: Pointer metadata.
    135135 */
    136 psMetadata *psMetadataAlloc(void        // /< Void.
     136psMetadata *psMetadataAlloc(void        ///< Void.
    137137                           );
    138138
     
    143143 * @return bool: True for success, false for failure.
    144144 */
    145 bool psMetadataAddItem(psMetadata * restrict md,        // /< Metadata collection to insert metadat item.
    146                        int where,       // /< Location to be added.
    147                        psMetadataItem * restrict item   // /< Metadata item to be added.
     145bool psMetadataAddItem(psMetadata * restrict md,        ///< Metadata collection to insert metadat item.
     146                       int where,       ///< Location to be added.
     147                       psMetadataItem * restrict item   ///< Metadata item to be added.
    148148                      );
    149149
     
    154154 * @return bool: True for success, false for failure.
    155155 */
    156 bool psMetadataAdd(psMetadata * restrict md,    // /< Metadata collection to insert metadat item.
    157                    int where,   // /< Location to be added.
    158                    const char *name,    // /< Name of metadata item.
    159                    psMetadataType type, // /< Type of metadata item.
    160                    const char *comment, // /< Comment for metadata item.
    161                    ...          // /< Arguments for name formatting and metadata item data.
     156bool psMetadataAdd(psMetadata * restrict md,    ///< Metadata collection to insert metadat item.
     157                   int where,   ///< Location to be added.
     158                   const char *name,    ///< Name of metadata item.
     159                   psMetadataType type, ///< Type of metadata item.
     160                   const char *comment, ///< Comment for metadata item.
     161                   ...          ///< Arguments for name formatting and metadata item data.
    162162                  );
    163163
     
    171171 * @return bool: True for success, false for failure.
    172172 */
    173 bool psMetadataRemove(psMetadata * restrict md, // /< Metadata collection to insert metadat item.
    174                       int where,        // /< Location to be removed.
    175                       const char *restrict key  // /< Name of metadata key.
     173bool psMetadataRemove(psMetadata * restrict md, ///< Metadata collection to insert metadat item.
     174                      int where,        ///< Location to be removed.
     175                      const char *restrict key  ///< Name of metadata key.
    176176                     );
    177177
     
    183183 * @return psMetadataItem*: Pointer metadata item.
    184184 */
    185 psMetadataItem *psMetadataLookup(psMetadata * restrict md,      // /< Metadata collection to insert metadat
     185psMetadataItem *psMetadataLookup(psMetadata * restrict md,      ///< Metadata collection to insert metadat
    186186                                 // item.
    187                                  const char *restrict key       // /< Name of metadata key.
     187                                 const char *restrict key       ///< Name of metadata key.
    188188                                );
    189189
     
    194194 * @return psMetadataItem*: Pointer metadata item.
    195195 */
    196 psMetadataItem *psMetadataGet(psMetadata * restrict md, // /< Metadata collection to insert metadat item.
    197                               int where // /< Location to be retrieved.
     196psMetadataItem *psMetadataGet(psMetadata * restrict md, ///< Metadata collection to insert metadat item.
     197                              int where ///< Location to be retrieved.
    198198                             );
    199199
     
    204204 * @return void: void.
    205205 */
    206 bool psMetadataSetIterator(psMetadata * restrict md,    // /< Metadata collection to iterate.
    207                            int where    // /< Location of iterator.
     206bool psMetadataSetIterator(psMetadata * restrict md,    ///< Metadata collection to iterate.
     207                           int where    ///< Location of iterator.
    208208                          );
    209209
     
    214214 * @return psMetadataItem*: Pointer metadata item.
    215215 */
    216 psMetadataItem *psMetadataGetNext(psMetadata * restrict md,     // /< Metadata collection to iterate.
    217                                   const char *restrict match,   // /< Beginning of key name.
    218                                   int which     // /< Iterator to be used.
     216psMetadataItem *psMetadataGetNext(psMetadata * restrict md,     ///< Metadata collection to iterate.
     217                                  const char *restrict match,   ///< Beginning of key name.
     218                                  int which     ///< Iterator to be used.
    219219                                 );
    220220
     
    225225 * @return psMetadataItem*: Pointer metadata item.
    226226 */
    227 psMetadataItem *psMetadataGetPrevious(psMetadata * restrict md, // /< Metadata collection to iterate.
    228                                       const char *restrict match,       // /< Beginning of key name.
    229                                       int which // /< Iterator to be used.
     227psMetadataItem *psMetadataGetPrevious(psMetadata * restrict md, ///< Metadata collection to iterate.
     228                                      const char *restrict match,       ///< Beginning of key name.
     229                                      int which ///< Iterator to be used.
    230230                                     );
    231231
     
    240240 * @return psMetadataItem*: Pointer metadata item.
    241241 */
    242 void psMetadataItemPrint(FILE * fd,     // /< Pointer to file to write metadata item.
    243                          const char *format,    // /< Format to print metadata item.
    244                          const psMetadataItem * restrict metadataItem   // /< Metadata item to print.
     242void psMetadataItemPrint(FILE * fd,     ///< Pointer to file to write metadata item.
     243                         const char *format,    ///< Format to print metadata item.
     244                         const psMetadataItem * restrict metadataItem   ///< Metadata item to print.
    245245                        );
    246246
     
    252252 * @return psMetadata*: Pointer metadata.
    253253 */
    254 psMetadata *psMetadataReadHeader(psMetadata * output,   // /< Resulting metadata from read.
    255                                  char *extname, // /< File name extension string.
    256                                  int extnum,    // /< File name extension number. Starts at 1.
    257                                  char *filename // /< Name of file to read.
     254psMetadata *psMetadataReadHeader(psMetadata * output,   ///< Resulting metadata from read.
     255                                 char *extname, ///< File name extension string.
     256                                 int extnum,    ///< File name extension number. Starts at 1.
     257                                 char *filename ///< Name of file to read.
    258258                                );
    259259
     
    264264 * @return psMetadata*: Pointer metadata.
    265265 */
    266 psMetadata *psMetadataFReadHeader(psMetadata * output,  // /< Resulting metadata from read.
    267                                   char *extName,        // /< File name extension string.
    268                                   int extNum,   // /< File name extension number.
    269                                   fitsfile * fd // /< Pointer to file to read.
     266psMetadata *psMetadataFReadHeader(psMetadata * output,  ///< Resulting metadata from read.
     267                                  char *extName,        ///< File name extension string.
     268                                  int extNum,   ///< File name extension number.
     269                                  fitsfile * fd ///< Pointer to file to read.
    270270                                 );
    271271
Note: See TracChangeset for help on using the changeset viewer.