/* GStreamer
 * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
 *                    2000 Wim Taymans <wtay@chello.be>
 *
 * gstprops.h: Header for properties subsystem
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */


#ifndef __GST_PROPS_H__
#define __GST_PROPS_H__

#include <gst/gstconfig.h>

#include <glib.h>

typedef struct _GstProps GstProps;

typedef enum {
   GST_PROPS_END_ID = 0,
   GST_PROPS_INT_ID,
   GST_PROPS_FLOAT_ID,
   GST_PROPS_FOURCC_ID,
   GST_PROPS_BOOL_ID,
   GST_PROPS_STRING_ID,

   GST_PROPS_VAR_ID,   /* after this marker start the variable properties */

   GST_PROPS_LIST_ID,
   GST_PROPS_FLOAT_RANGE_ID,
   GST_PROPS_INT_RANGE_ID,

   GST_PROPS_LAST_ID = GST_PROPS_END_ID + 16,
} GstPropsId;

#define GST_MAKE_FOURCC(a,b,c,d) 	((a)|(b)<<8|(c)<<16|(d)<<24)
#define GST_STR_FOURCC(f)		(((f)[0])|((f)[1]<<8)|((f)[2]<<16)|((f)[3]<<24))

#define GST_PROPS_LIST(a...) 		GST_PROPS_LIST_ID,##a,NULL
#define GST_PROPS_INT(a) 		GST_PROPS_INT_ID,(a)
#define GST_PROPS_INT_RANGE(a,b) 	GST_PROPS_INT_RANGE_ID,(a),(b)
#define GST_PROPS_FLOAT(a) 		GST_PROPS_FLOAT_ID,(a)
#define GST_PROPS_FLOAT_RANGE(a,b) 	GST_PROPS_FLOAT_RANGE_ID,(a),(b)
#define GST_PROPS_FOURCC(a) 		GST_PROPS_FOURCC_ID,(a)
#define GST_PROPS_BOOLEAN(a) 		GST_PROPS_BOOL_ID,(a)
#define GST_PROPS_STRING(a) 		GST_PROPS_STRING_ID,(a)

#define GST_PROPS_INT_POSITIVE		GST_PROPS_INT_RANGE(0,G_MAXINT)
#define GST_PROPS_INT_NEGATIVE		GST_PROPS_INT_RANGE(G_MININT,0)
#define GST_PROPS_INT_ANY		GST_PROPS_INT_RANGE(G_MININT,G_MAXINT)


struct _GstProps {
  gint refcount;
  GMutex *lock;
  gboolean fixed;

  GList *properties;		/* real properties for this property */
};

/* initialize the subsystem */
void 		_gst_props_initialize		(void);

GstProps*	gst_props_new			(const gchar *firstname, ...);
GstProps*	gst_props_newv			(const gchar *firstname, va_list var_args);

void            gst_props_unref                 (GstProps *props);
void            gst_props_ref                   (GstProps *props);
void            gst_props_destroy               (GstProps *props);

void            gst_props_debug 		(GstProps *props);

GstProps*       gst_props_copy                  (GstProps *props);
GstProps*       gst_props_copy_on_write         (GstProps *props);

GstProps*	gst_props_merge			(GstProps *props, GstProps *tomerge);

gboolean 	gst_props_check_compatibility 	(GstProps *fromprops, GstProps *toprops);
GstProps* 	gst_props_intersect	 	(GstProps *props1, GstProps *props2);
GList* 		gst_props_normalize	 	(GstProps *props);

GstProps*	gst_props_set			(GstProps *props, const gchar *name, ...);

gboolean 	gst_props_has_property		(GstProps *props, const gchar *name);

gint 		gst_props_get_int		(GstProps *props, const gchar *name);
gfloat 		gst_props_get_float		(GstProps *props, const gchar *name);
gulong		gst_props_get_fourcc_int	(GstProps *props, const gchar *name);
gboolean	gst_props_get_boolean		(GstProps *props, const gchar *name);
const gchar*	gst_props_get_string		(GstProps *props, const gchar *name);

#ifndef GST_DISABLE_LOADSAVE
xmlNodePtr 	gst_props_save_thyself 		(GstProps *props, xmlNodePtr parent);
GstProps* 	gst_props_load_thyself 		(xmlNodePtr parent);
#endif

#endif /* __GST_PROPS_H__ */
