src/common.h

/*
 *  LDForge: LDraw parts authoring CAD
 *  Copyright (C) 2013 Santeri Piippo
 *  
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *  
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *  
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

// =============================================================================
// This file is included one way or another in every source file of LDForge.
// Stuff defined and included here is universally included.

#ifndef COMMON_H
#define COMMON_H

#include <stdio.h>
#include <stdlib.h>
#include <assert.h>
#include <vector>
#include <stdint.h>
#include <stdarg.h>
#include <QString>
#include <QMutex>

#include "string.h"
#include "config.h"
#include "types.h"

#define APPNAME "LDForge"
#define VERSION_MAJOR 0
#define VERSION_MINOR 1
#define VERSION_PATCH 999
#define BUILD_ID BUILD_INTERNAL

// =============================================
#if (BUILD_ID != BUILD_INTERNAL)
#define RELEASE
#endif // BUILD_ID

#define BUILD_INTERNAL	0
#define BUILD_ALPHA		1
#define BUILD_BETA		2
#define BUILD_RC			3
#define BUILD_RELEASE		4

#ifndef RELEASE
# define devf(...) doDevf (__func__, __VA_ARGS__);
#else
# define devf(...)
#endif // RELEASE

void doDevf (const char* func, const char* fmtstr, ...);

// Version string identifier
str versionString ();
const char* versionMoniker ();
str fullVersionString ();

#ifdef __GNUC__
# define FORMAT_PRINTF(M,N) __attribute__ ((format (printf, M, N)))
# define ATTR(N) __attribute__ ((N))
#else
# define FORMAT_PRINTF(M,N)
# define ATTR(N)
#endif // __GNUC__

#ifdef WIN32
#define DIRSLASH "\\"
#define DIRSLASH_CHAR '\\'
#else // WIN32
#define DIRSLASH "/"
#define DIRSLASH_CHAR '/'
#endif // WIN32

#ifdef RELEASE
#define NDEBUG // remove asserts
#endif // RELEASE

// Read-only, private property with a get accessor
#define READ_PROPERTY(T, GET) \
private: \
	T m_##GET; \
public: \
	T const& GET () const { return m_##GET; } \

// Same as above except not const
#define MUTABLE_READ_PROPERTY(T, GET) \
private: \
	T m_##GET; \
public: \
	T& GET () { return m_##GET; } \

// Read/write private property with get and set accessors
#define SET_ACCESSOR(T, GET, SET) \
	void SET (T val) { m_##GET = val; }

#define PROPERTY(T, GET, SET) \
	READ_PROPERTY(T, GET) \
	SET_ACCESSOR(T, GET, SET)

#define MUTABLE_PROPERTY(T, GET, SET) \
	MUTABLE_READ_PROPERTY(T, GET) \
	SET_ACCESSOR(T, GET, SET)

// Property that triggers a callback when it is changed
#define CALLBACK_PROPERTY(T, GET, SET) \
	READ_PROPERTY(T, GET) \
	void callback_##SET (); \
	void SET (T val) { m_##GET = val; callback_##SET (); }

// Property with thread locking, use when multiple threads access the same property
// Comes with a callback function for detecting when the value is changed.
#define THREAD_PROPERTY(T, GET, SET) \
private: \
	T m_##GET; \
	QMutex m_threadLock_##GET; \
public: \
	const T& GET () const { return m_##GET; } \
	void callback_##SET (); \
	void SET (T val) { \
		m_threadLock_##GET.lock (); \
		m_##GET = val; \
		callback_##SET (); \
		m_threadLock_##GET.unlock (); \
	}

#ifdef null
#undef null
#endif // null

#ifdef __GNUC__
#define FUNCNAME __PRETTY_FUNCTION__
#else
#define FUNCNAME __func__
#endif // __GNUC__

// Replace assert with a version that shows a GUI dialog if possible
#ifdef assert
#undef assert
#endif // assert

void assertionFailure (const char* file, const ulong line, const char* funcname, const char* expr);
void fatalError (const char* file, const ulong line, const char* funcname, str errmsg);

#define assert(N) \
	(N) ? ((void)(0)) : assertionFailure(__FILE__, __LINE__, FUNCNAME, #N)

#define fatal(MSG) \
	fatalError (__FILE__, __LINE__, FUNCNAME, MSG)

// Null pointer
static const std::nullptr_t null = nullptr;

// Main and edge color identifiers
static const short maincolor = 16;
static const short edgecolor = 24;

static const bool yup = true;
static const bool nope = false;

class ForgeWindow;
class LDObject;
class bbox;
class LDOpenFile;
class QApplication;

// -----------------------------------------------------------------------------
// Plural expression
template<class T> static inline const char* plural (T n) {
	return (n != 1) ? "s" : "";
}

// -----------------------------------------------------------------------------
// Templated clamp
template<class T> static inline T clamp (T a, T min, T max) {
	return (a > max) ? max : (a < min) ? min : a;
}

// Templated minimum
template<class T> static inline T min (T a, T b) {
	return (a < b) ? a : b;
}

// Templated maximum
template<class T> static inline T max (T a, T b) {
	return (a > b) ? a : b;
}

// Templated absolute value
template<class T> static inline T abs (T a) {
	return (a >= 0) ? a : -a;
}

// Quick QString to const char* conversion
static inline const char* qchars (const QString& qstr) {
	return qstr.toStdString ().c_str ();
}

static const double pi = 3.14159265358979323846f;

#ifdef IN_IDE_PARSER // KDevelop workarounds:
#error IN_IDE_PARSER is defined (this code is only for KDevelop workarounds)

// Current function name
static const char* __func__ = "";

#ifndef va_start
#define va_start(va, arg)
#endif // va_start

#ifndef va_end
#define va_end(va)
#endif // va_end

typedef void FILE; // :|
#endif // IN_IDE_PARSER

// -----------------------------------------------------------------------------
enum LogType {
	LOG_Normal,
	LOG_Warning,
	LOG_Error,
	LOG_Dev,
};

// logf - universal access to the message log. Defined here so that I don't have
// to include gui.h here and recompile everything every time that file changes.
// logf is defined in main.cpp
void logf (const char* fmtstr, ...) FORMAT_PRINTF (1, 2);
void logf (LogType type, const char* fmtstr, ...) FORMAT_PRINTF (2, 3);
// -----------------------------------------------------------------------------
// Vertex at (0, 0, 0)
extern const vertex g_origin;

// -----------------------------------------------------------------------------
// Pointer to the OpenFile which is currently being edited by the user.
extern LDOpenFile* g_curfile;

// -----------------------------------------------------------------------------
// Pointer to the bounding box.
extern bbox g_BBox;

// -----------------------------------------------------------------------------
// Vector of all currently opened files.
extern vector<LDOpenFile*> g_loadedFiles;

// -----------------------------------------------------------------------------
// Pointer to the main application.
extern const QApplication* g_app;

// -----------------------------------------------------------------------------
// Identity matrix
extern const matrix g_identity;

#endif // COMMON_H