LiVES 3.2.0
Macros | Enumerations
liblives.hpp File Reference

Header file for liblives. More...

Go to the source code of this file.

Macros

#define LIVES_VERSION_MAJOR   3
 Version number major. More...
 
#define LIVES_VERSION_MINOR   2
 Version number minor. More...
 
#define LIVES_VERSION_MICRO   0
 Version number micro. More...
 
#define LIVES_CHECK_VERSION(major, minor, micro)   (major > LIVES_VERSION_MAJOR || (major == LIVES_VERSION_MAJOR && (minor > LIVES_VERSION_MINOR || (minor == LIVES_VERSION_MINOR && micro >= LIVES_VERSION_MICRO))))
 Macro to check if livesApp version is >= major.minor.micro. More...
 
#define LIVES_CHAR_ENCODING_DEFAULT   LIVES_CHAR_ENCODING_UTF8
 Default character encoding. More...
 

Enumerations

enum  lives_filechooser_t { LIVES_FILE_CHOOSER_VIDEO_AUDIO , LIVES_FILE_CHOOSER_AUDIO_ONLY }
 Filechooser hinting types. More...
 
enum  lives_interface_mode_t { LIVES_INTERFACE_MODE_INVALID = -1 , LIVES_INTERFACE_MODE_CLIPEDIT , LIVES_INTERFACE_MODE_MULTITRACK }
 LiVES operation mode. More...
 
enum  lives_status_t {
  LIVES_STATUS_INVALID = -1 , LIVES_STATUS_NOTREADY , LIVES_STATUS_READY , LIVES_STATUS_PLAYING ,
  LIVES_STATUS_PROCESSING , LIVES_STATUS_PREVIEW
}
 LiVES operational status. More...
 
enum  lives_endian_t { LIVES_LITTLEENDIAN , LIVES_BIGENDIAN }
 Endian values. More...
 
enum  lives_callback_t {
  LIVES_CALLBACK_FRAME_SYNCH = 1 , LIVES_CALLBACK_PLAYBACK_STARTED = 2 , LIVES_CALLBACK_PLAYBACK_STOPPED = 3 , LIVES_CALLBACK_PLAYBACK_STOPPED_RD = 4 ,
  LIVES_CALLBACK_RECORD_STARTED = 32 , LIVES_CALLBACK_RECORD_STOPPED = 33 , LIVES_CALLBACK_APP_QUIT = 64 , LIVES_CALLBACK_CLIP_OPENED = 128 ,
  LIVES_CALLBACK_CLIP_CLOSED = 129 , LIVES_CALLBACK_CLIPSET_OPENED = 256 , LIVES_CALLBACK_CLIPSET_SAVED = 257 , LIVES_CALLBACK_MODE_CHANGED = 4096 ,
  LIVES_CALLBACK_OBJECT_DESTROYED = 16384 , LIVES_CALLBACK_PRIVATE = 32768
}
 Callback types. More...
 
enum  lives_char_encoding_t { LIVES_CHAR_ENCODING_UTF8 , LIVES_CHAR_ENCODING_LOCAL8BIT , LIVES_CHAR_ENCODING_FILESYSTEM }
 Character encoding types. More...
 
enum  lives_dialog_response_t {
  LIVES_DIALOG_RESPONSE_INVALID = -1 , LIVES_DIALOG_RESPONSE_NONE = 0 , LIVES_DIALOG_RESPONSE_OK , LIVES_DIALOG_RESPONSE_RETRY ,
  LIVES_DIALOG_RESPONSE_ABORT , LIVES_DIALOG_RESPONSE_RESET , LIVES_DIALOG_RESPONSE_SHOW_DETAILS , LIVES_DIALOG_RESPONSE_CANCEL ,
  LIVES_DIALOG_RESPONSE_ACCEPT , LIVES_DIALOG_RESPONSE_YES , LIVES_DIALOG_RESPONSE_NO
}
 Dialog response values. More...
 
enum  lives_audio_source_t { LIVES_AUDIO_SOURCE_UNKNOWN = -1 , LIVES_AUDIO_SOURCE_INTERNAL , LIVES_AUDIO_SOURCE_EXTERNAL }
 Audio sources. More...
 
enum  lives_audio_player_t {
  LIVES_AUDIO_PLAYER_UNKNOWN = -1 , LIVES_AUDIO_PLAYER_PULSE , LIVES_AUDIO_PLAYER_JACK , LIVES_AUDIO_PLAYER_SOX ,
  LIVES_AUDIO_PLAYER_MPLAYER , LIVES_AUDIO_PLAYER_MPLAYER2
}
 Audio players. More...
 
enum  lives_insert_mode_t { LIVES_INSERT_MODE_NORMAL }
 Multitrack insert modes. More...
 
enum  lives_gravity_t { LIVES_GRAVITY_NORMAL , LIVES_GRAVITY_LEFT , LIVES_GRAVITY_RIGHT }
 Multitrack gravity. More...
 
enum  lives_loop_mode_t { LIVES_LOOP_MODE_NONE = 0 , LIVES_LOOP_MODE_CONTINUOUS = 1 , LIVES_LOOP_MODE_FIT_AUDIO = 2 }
 Player looping modes (bitmap) More...
 

Detailed Description

Header file for liblives.

Definition in file liblives.hpp.

Macro Definition Documentation

◆ LIVES_CHAR_ENCODING_DEFAULT

#define LIVES_CHAR_ENCODING_DEFAULT   LIVES_CHAR_ENCODING_UTF8

Default character encoding.

Definition at line 124 of file liblives.hpp.

◆ LIVES_CHECK_VERSION

#define LIVES_CHECK_VERSION (   major,
  minor,
  micro 
)    (major > LIVES_VERSION_MAJOR || (major == LIVES_VERSION_MAJOR && (minor > LIVES_VERSION_MINOR || (minor == LIVES_VERSION_MINOR && micro >= LIVES_VERSION_MICRO))))

Macro to check if livesApp version is >= major.minor.micro.

Definition at line 32 of file liblives.hpp.

◆ LIVES_VERSION_MAJOR

#define LIVES_VERSION_MAJOR   3

Version number major.

Definition at line 17 of file liblives.hpp.

◆ LIVES_VERSION_MICRO

#define LIVES_VERSION_MICRO   0

Version number micro.

Definition at line 27 of file liblives.hpp.

◆ LIVES_VERSION_MINOR

#define LIVES_VERSION_MINOR   2

Version number minor.

Definition at line 22 of file liblives.hpp.

Enumeration Type Documentation

◆ lives_audio_player_t

Audio players.

Enumerator
LIVES_AUDIO_PLAYER_UNKNOWN 

Unknown / invalid.

LIVES_AUDIO_PLAYER_PULSE 

Audio playback is through PulseAudio.

LIVES_AUDIO_PLAYER_JACK 

Audio playback is thorugh Jack.

LIVES_AUDIO_PLAYER_SOX 

Audio playback is through Sox.

LIVES_AUDIO_PLAYER_MPLAYER 

Audio playback is through mplayer.

LIVES_AUDIO_PLAYER_MPLAYER2 

Audio playback is through mplayer2.

Definition at line 158 of file liblives.hpp.

◆ lives_audio_source_t

Audio sources.

Enumerator
LIVES_AUDIO_SOURCE_UNKNOWN 

Unknown / invalid.

LIVES_AUDIO_SOURCE_INTERNAL 

Audio source is internal to LiVES.

LIVES_AUDIO_SOURCE_EXTERNAL 

Audio source is external to LiVES.

Definition at line 148 of file liblives.hpp.

◆ lives_callback_t

Callback types.

Enumerator
LIVES_CALLBACK_FRAME_SYNCH 

sent when a frame is displayed

LIVES_CALLBACK_PLAYBACK_STARTED 

sent when a/v playback starts or clip is switched

LIVES_CALLBACK_PLAYBACK_STOPPED 

sent when a/v playback ends sent when a/v playback ends and there is recorded data for rendering/previewing

LIVES_CALLBACK_PLAYBACK_STOPPED_RD 
LIVES_CALLBACK_RECORD_STARTED 

sent when record starts (TODO)

LIVES_CALLBACK_RECORD_STOPPED 

sent when record stops (TODO)

LIVES_CALLBACK_APP_QUIT 

sent when app quits

LIVES_CALLBACK_CLIP_OPENED 

sent after a clip is opened

LIVES_CALLBACK_CLIP_CLOSED 

sent after a clip is closed

LIVES_CALLBACK_CLIPSET_OPENED 

sent after a clip set is opened

LIVES_CALLBACK_CLIPSET_SAVED 

sent after a clip set is closed

LIVES_CALLBACK_MODE_CHANGED 

sent when interface mode changes

LIVES_CALLBACK_OBJECT_DESTROYED 

sent when livesApp object is deleted

LIVES_CALLBACK_PRIVATE 

for internal use

Definition at line 81 of file liblives.hpp.

◆ lives_char_encoding_t

Character encoding types.

Enumerator
LIVES_CHAR_ENCODING_UTF8 

UTF-8 char encoding.

LIVES_CHAR_ENCODING_LOCAL8BIT 

8 bit locale file encoding

LIVES_CHAR_ENCODING_FILESYSTEM 

file system encoding (UTF-8 on windows, local8bit on others)

Definition at line 114 of file liblives.hpp.

◆ lives_dialog_response_t

Dialog response values.

Enumerator
LIVES_DIALOG_RESPONSE_INVALID 

INVALID response.

LIVES_DIALOG_RESPONSE_NONE 

Response not obtained.

LIVES_DIALOG_RESPONSE_OK 

OK button clicked.

LIVES_DIALOG_RESPONSE_RETRY 

Retry button clicked.

LIVES_DIALOG_RESPONSE_ABORT 

Abort button clicked.

LIVES_DIALOG_RESPONSE_RESET 

Reset button clicked.

LIVES_DIALOG_RESPONSE_SHOW_DETAILS 

Show details button clicked.

LIVES_DIALOG_RESPONSE_CANCEL 

Cancel button clicked.

LIVES_DIALOG_RESPONSE_ACCEPT 

Accept button clicked.

LIVES_DIALOG_RESPONSE_YES 

Yes button clicked.

LIVES_DIALOG_RESPONSE_NO 

No button clicked.

Definition at line 129 of file liblives.hpp.

◆ lives_endian_t

Endian values.

Enumerator
LIVES_LITTLEENDIAN 
LIVES_BIGENDIAN 

Definition at line 72 of file liblives.hpp.

◆ lives_filechooser_t

Filechooser hinting types.

Enumerator
LIVES_FILE_CHOOSER_VIDEO_AUDIO 

file chooser options for single video or audio file

LIVES_FILE_CHOOSER_AUDIO_ONLY 

file chooser options for single audio file

Definition at line 39 of file liblives.hpp.

◆ lives_gravity_t

Multitrack gravity.

Enumerator
LIVES_GRAVITY_NORMAL 

no gravity

LIVES_GRAVITY_LEFT 

inserted blocks gravitate to the left

LIVES_GRAVITY_RIGHT 

inserted blocks gravitate to the right

Definition at line 179 of file liblives.hpp.

◆ lives_insert_mode_t

Multitrack insert modes.

Enumerator
LIVES_INSERT_MODE_NORMAL 

Definition at line 171 of file liblives.hpp.

◆ lives_interface_mode_t

LiVES operation mode.

Enumerator
LIVES_INTERFACE_MODE_INVALID 

livesApp instance is invalid

LIVES_INTERFACE_MODE_CLIPEDIT 

clip editor mode

LIVES_INTERFACE_MODE_MULTITRACK 

multitrack mode

Definition at line 49 of file liblives.hpp.

◆ lives_loop_mode_t

Player looping modes (bitmap)

Enumerator
LIVES_LOOP_MODE_NONE 

no looping

LIVES_LOOP_MODE_CONTINUOUS 

both video and audio loop continuously

LIVES_LOOP_MODE_FIT_AUDIO 

video keeps looping until audio playback finishes

Definition at line 189 of file liblives.hpp.

◆ lives_status_t

LiVES operational status.

Enumerator
LIVES_STATUS_INVALID 

livesApp instance is invalid

LIVES_STATUS_NOTREADY 

application is starting up; not ready

LIVES_STATUS_READY 

application is ready for commands

LIVES_STATUS_PLAYING 

application is playing, only player commands will be responded to

LIVES_STATUS_PROCESSING 

application is processing, commands will be ignored

LIVES_STATUS_PREVIEW 

user is previewing an operation, commands will be ignored

Definition at line 59 of file liblives.hpp.