]> git.sesse.net Git - mlt/blob - src/framework/mlt_types.h
add support for timecode and clock time strings to the framework
[mlt] / src / framework / mlt_types.h
1 /**
2  * \file mlt_types.h
3  * \brief Provides forward definitions of all public types
4  *
5  * Copyright (C) 2003-2012 Ushodaya Enterprises Limited
6  * \author Charles Yates <charles.yates@pandora.be>
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with this library; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
21  */
22
23 #ifndef _MLT_TYPES_H_
24 #define _MLT_TYPES_H_
25
26 #ifndef GCC_VERSION
27 #define GCC_VERSION (__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__)
28 #endif
29
30 #include <inttypes.h>
31 #include <limits.h>
32 #include "mlt_pool.h"
33
34 #ifndef PATH_MAX
35 #define PATH_MAX 4096
36 #endif
37
38 /** The set of supported image formats */
39
40 typedef enum
41 {
42         mlt_image_none = 0,/**< image not available */
43         mlt_image_rgb24,   /**< 8-bit RGB */
44         mlt_image_rgb24a,  /**< 8-bit RGB with alpha channel */
45         mlt_image_yuv422,  /**< 8-bit YUV 4:2:2 packed */
46         mlt_image_yuv420p, /**< 8-bit YUV 4:2:0 planar */
47         mlt_image_opengl   /**< suitable for OpenGL texture */
48 }
49 mlt_image_format;
50
51 /** The set of supported audio formats */
52
53 typedef enum
54 {
55         mlt_audio_none = 0,/**< audio not available */
56         mlt_audio_pcm = 1, /**< \deprecated signed 16-bit interleaved PCM */
57         mlt_audio_s16 = 1, /**< signed 16-bit interleaved PCM */
58         mlt_audio_s32,     /**< signed 32-bit non-interleaved PCM */
59         mlt_audio_float,   /**< 32-bit non-interleaved floating point */
60         mlt_audio_s32le,   /**< signed 32-bit interleaved PCM */
61         mlt_audio_f32le    /**< 32-bit interleaved floating point */
62 }
63 mlt_audio_format;
64
65 /** The time string formats */
66
67 typedef enum
68 {
69         mlt_time_frames = 0, /**< frame count */
70         mlt_time_clock,      /**< SMIL clock-value as [[hh:]mm:]ss[.fraction] */
71         mlt_time_smpte       /**< SMPTE timecode as [[[hh:]mm:]ss:]frames */
72 }
73 mlt_time_format;
74
75 /** The relative time qualifiers */
76
77 typedef enum
78 {
79         mlt_whence_relative_start,  /**< relative to the beginning */
80         mlt_whence_relative_current,/**< relative to the current position */
81         mlt_whence_relative_end     /**< relative to the end */
82 }
83 mlt_whence;
84
85 /** The recognized subclasses of mlt_service */
86
87 typedef enum
88 {
89         invalid_type,               /**< invalid service */
90         unknown_type,               /**< unknown class */
91         producer_type,              /**< Producer class */
92         tractor_type,               /**< Tractor class */
93         playlist_type,              /**< Playlist class */
94         multitrack_type,            /**< Multitrack class */
95         filter_type,                /**< Filter class */
96         transition_type,            /**< Transition class */
97         consumer_type,              /**< Consumer class */
98         field_type                  /**< Field class */
99 }
100 mlt_service_type;
101
102 /* I don't want to break anyone's applications without warning. -Zach */
103 #undef DOUBLE_MLT_POSITION
104 #ifdef DOUBLE_MLT_POSITION
105 typedef double mlt_position;
106 #else
107 typedef int32_t mlt_position;
108 #endif
109
110 typedef struct mlt_frame_s *mlt_frame, **mlt_frame_ptr; /**< pointer to Frame object */
111 typedef struct mlt_property_s *mlt_property;            /**< pointer to Property object */
112 typedef struct mlt_properties_s *mlt_properties;        /**< pointer to Properties object */
113 typedef struct mlt_event_struct *mlt_event;             /**< pointer to Event object */
114 typedef struct mlt_service_s *mlt_service;              /**< pointer to Service object */
115 typedef struct mlt_producer_s *mlt_producer;            /**< pointer to Producer object */
116 typedef struct mlt_playlist_s *mlt_playlist;            /**< pointer to Playlist object */
117 typedef struct mlt_multitrack_s *mlt_multitrack;        /**< pointer to Multitrack object */
118 typedef struct mlt_filter_s *mlt_filter;                /**< pointer to Filter object */
119 typedef struct mlt_transition_s *mlt_transition;        /**< pointer to Transition object */
120 typedef struct mlt_tractor_s *mlt_tractor;              /**< pointer to Tractor object */
121 typedef struct mlt_field_s *mlt_field;                  /**< pointer to Field object */
122 typedef struct mlt_consumer_s *mlt_consumer;            /**< pointer to Consumer object */
123 typedef struct mlt_parser_s *mlt_parser;                /**< pointer to Properties object */
124 typedef struct mlt_deque_s *mlt_deque;                  /**< pointer to Deque object */
125 typedef struct mlt_geometry_s *mlt_geometry;            /**< pointer to Geometry object */
126 typedef struct mlt_geometry_item_s *mlt_geometry_item;  /**< pointer to Geometry Item object */
127 typedef struct mlt_profile_s *mlt_profile;              /**< pointer to Profile object */
128 typedef struct mlt_repository_s *mlt_repository;        /**< pointer to Repository object */
129 typedef struct mlt_cache_s *mlt_cache;                  /**< pointer to Cache object */
130 typedef struct mlt_cache_item_s *mlt_cache_item;        /**< pointer to CacheItem object */
131
132 typedef void ( *mlt_destructor )( void * );             /**< pointer to destructor function */
133 typedef char *( *mlt_serialiser )( void *, int length );/**< pointer to serialization function */
134
135 #define MLT_SERVICE(x)    ( ( mlt_service )( x ) )      /**< Cast to a Service pointer */
136 #define MLT_PRODUCER(x)   ( ( mlt_producer )( x ) )     /**< Cast to a Producer pointer */
137 #define MLT_MULTITRACK(x) ( ( mlt_multitrack )( x ) )   /**< Cast to a Multitrack pointer */
138 #define MLT_PLAYLIST(x)   ( ( mlt_playlist )( x ) )     /**< Cast to a Playlist pointer */
139 #define MLT_TRACTOR(x)    ( ( mlt_tractor )( x ) )      /**< Cast to a Tractor pointer */
140 #define MLT_FILTER(x)     ( ( mlt_filter )( x ) )       /**< Cast to a Filter pointer */
141 #define MLT_TRANSITION(x) ( ( mlt_transition )( x ) )   /**< Cast to a Transition pointer */
142 #define MLT_CONSUMER(x) ( ( mlt_consumer )( x ) )       /**< Cast to a Consumer pointer */
143 #define MLT_FRAME(x)      ( ( mlt_frame )( x ) )        /**< Cast to a Frame pointer */
144
145 #ifdef WIN32
146 #include <pthread.h>
147 /* Win32 compatibility function declarations */
148 extern int usleep(unsigned int useconds);
149 extern int nanosleep( const struct timespec * rqtp, struct timespec * rmtp );
150 extern int setenv(const char *name, const char *value, int overwrite);
151 #endif
152
153 #endif