X-Git-Url: http://research.m1stereo.tv/gitweb?a=blobdiff_plain;f=src%2Fframework%2Fmlt_profile.h;h=6245640e58dea8ed192383895873a4c1abf2994a;hb=f4963a6aa07644399b273b5d2b1f9299c9047414;hp=0c64e7c02f21da7c0ded81dc4f0ba42c3554e337;hpb=d57832919959e117a68d856b172c090746fc3399;p=melted

diff --git a/src/framework/mlt_profile.h b/src/framework/mlt_profile.h
index 0c64e7c..6245640 100644
--- a/src/framework/mlt_profile.h
+++ b/src/framework/mlt_profile.h
@@ -1,7 +1,10 @@
-/*
- * mlt_profile.h -- video output definition
- * Copyright (C) 2007 Ushodaya Enterprises Limited
- * Author: Dan Dennedy <dan@dennedy.org>
+/**
+ * \file mlt_profile.h
+ * \brief video output definition
+ * \see mlt_profile_s
+ *
+ * Copyright (C) 2007-2009 Ushodaya Enterprises Limited
+ * \author Dan Dennedy <dan@dennedy.org>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -23,27 +26,30 @@
 
 #include "mlt_types.h"
 
+/** \brief Profile class
+ *
+ */
+
 struct mlt_profile_s
 {
-	char* description;
-	int frame_rate_num;
-	int frame_rate_den;
-	int width;
-	int height;
-	int progressive;
-	int sample_aspect_num;
-	int sample_aspect_den;
-	int display_aspect_num;
-	int display_aspect_den;
+	char* description;      /**< a brief description suitable as a label in UI menu */
+	int frame_rate_num;     /**< the numerator of the video frame rate */
+	int frame_rate_den;     /**< the denominator of the video frame rate */
+	int width;              /**< the horizontal resolution of the video */
+	int height;             /**< the vertical resolution of the video */
+	int progressive;        /**< a flag to indicate if the video is progressive scan, interlace if not set */
+	int sample_aspect_num;  /**< the numerator of the pixel aspect ratio */
+	int sample_aspect_den;  /**< the denominator of the pixel aspect ratio */
+	int display_aspect_num; /**< the numerator of the image aspect ratio in case it can not be simply derived (e.g. ITU-R 601) */
+	int display_aspect_den; /**< the denominator of the image aspect ratio in case it can not be simply derived (e.g. ITU-R 601) */
 };
 
-extern mlt_profile mlt_profile_get( );
-extern mlt_profile mlt_profile_select( const char *name );
+extern mlt_profile mlt_profile_init( const char *name );
 extern mlt_profile mlt_profile_load_file( const char *file );
 extern mlt_profile mlt_profile_load_properties( mlt_properties properties );
 extern mlt_profile mlt_profile_load_string( const char *string );
 extern double mlt_profile_fps( mlt_profile profile );
 extern double mlt_profile_sar( mlt_profile profile );
 extern double mlt_profile_dar( mlt_profile profile );
-extern void mlt_profile_close( );
+extern void mlt_profile_close( mlt_profile profile );
 #endif