aboutsummaryrefslogtreecommitdiff
path: root/src/reflist.h
diff options
context:
space:
mode:
authorThomas White <taw@bitwiz.org.uk>2011-03-26 20:26:06 +0100
committerThomas White <taw@physics.org>2012-02-22 15:27:21 +0100
commitcf481c5e99e6923358687d66fd6afecc95625a57 (patch)
treead847b8243eda52ffc8081880dd402dc39e5fbed /src/reflist.h
parent03acd73808f6f21bbfc38300796b24ecf823a697 (diff)
Add documentation via gtk-doc
Diffstat (limited to 'src/reflist.h')
-rw-r--r--src/reflist.h27
1 files changed, 19 insertions, 8 deletions
diff --git a/src/reflist.h b/src/reflist.h
index 0f8741cf..f380ba85 100644
--- a/src/reflist.h
+++ b/src/reflist.h
@@ -16,30 +16,40 @@
#include <config.h>
#endif
-
+/**
+ * RefList:
+ *
+ * This data structure is opaque. You must use the available accessor functions
+ * to read and write its contents.
+ */
typedef struct _reflist RefList;
+
+/**
+ * Reflection:
+ *
+ * This data structure is opaque. You must use the available accessor functions
+ * to read and write its contents.
+ */
typedef struct _reflection Reflection;
typedef struct _reflistiterator RefListIterator;
-#define INDICES signed int h, signed int k, signed int l
-
/* Creation/deletion */
extern RefList *reflist_new(void);
extern void reflist_free(RefList *list);
/* Search */
-extern Reflection *find_refl(const RefList *list, INDICES);
+extern Reflection *find_refl(const RefList *list, signed int h, signed int k, signed int l);
extern Reflection *next_found_refl(Reflection *refl);
/* Get */
extern double get_excitation_error(const Reflection *refl);
extern void get_detector_pos(const Reflection *refl, double *fs, double *ss);
+extern double get_partiality(const Reflection *refl);
extern void get_indices(const Reflection *refl,
signed int *h, signed int *k, signed int *l);
-extern double get_partiality(const Reflection *refl);
extern double get_intensity(const Reflection *refl);
-extern void get_partial(const Reflection *refl, double *r1, double *r2, double *p,
- int *clamp_low, int *clamp_high);
+extern void get_partial(const Reflection *refl, double *r1, double *r2,
+ double *p, int *clamp_low, int *clamp_high);
extern int get_scalable(const Reflection *refl);
extern int get_redundancy(const Reflection *refl);
extern double get_sum_squared_dev(const Reflection *refl);
@@ -60,7 +70,8 @@ extern void set_esd_intensity(Reflection *refl, double esd);
extern void set_ph(Reflection *refl, double phase);
/* Insertion */
-extern Reflection *add_refl(RefList *list, INDICES);
+extern Reflection *add_refl(RefList *list,
+ signed int h, signed int k, signed int l);
/* Deletion */
extern void delete_refl(Reflection *refl);