1 files changed, 34 insertions, 0 deletions
diff --git a/libgamma_site_initialise.c b/libgamma_site_initialise.c
new file mode 100644
index 0000000..23acc2d
--- /dev/null
+++ b/libgamma_site_initialise.c
@@ -0,0 +1,34 @@
+/* See LICENSE file for copyright and license details. */
+#include "common.h"
+
+
+/**
+ * Initialise an allocated site state
+ * 
+ * @param   this    The site state to initialise
+ * @param   method  The adjustment method (display server and protocol)
+ * @param   site    The site identifier, unless it is `NULL` it must a
+ *                  `free`:able. Once the state is destroyed the library
+ *                  will attempt to free it. There you should not free
+ *                  it yourself, and it must not be a string constant
+ *                  or allocated on the stack. Note however that it will
+ *                  not be `free`:d if this function fails.
+ * @return          Zero on success, otherwise (negative) the value of an
+ *                  error identifier provided by this library
+ */
+int
+libgamma_site_initialise(libgamma_site_state_t *restrict this, int method, char *restrict site)
+{
+	this->method = method;
+	this->site = site;
+
+	switch (method) {
+#define X(CONST, CNAME, DEPTH, RAMPS)\
+	case CONST:\
+		return libgamma_##CNAME##_site_initialise(this, site);
+	LIST_AVAILABLE_METHODS(X)
+#undef X
+	default:
+		return LIBGAMMA_NO_SUCH_ADJUSTMENT_METHOD;
+	}
+}