1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110
|
LiVES clip format version 1.0
Internal format of a clip
An optional frame index, called frame_index, a sequence of integers, a positive number means that the frame points to an encoded frame within the file <clip_name>, a value of -1 indicates that the frame is in the corresponding image file.
If frame_index is not present, and there are images, then all frames map to images. If there are no images then all frames map to frames in the <file_name>.
Images: a sequence of jpeg or png*, numbered consecutively 00000001.jpg, 00000002.jpg, etc. for jpeg, and 00000001.png, 00000002.png, etc. for png.
Audio: a raw pcm file, channels are interleaved if applicable. File name is just audio.
header.lives file: a header file with the following contents:
<header_version>
integer: currently 100 for this version
</header_version>
<bpp>
integer: number of bits per pixel (usually 24)
</bpp>
<frames>
integer: number of frames in the clip
</frames>
<width>
integer: image width in pixels
</width>
<height>
integer: image height in pixels
</height>
<unique_id>
int64 : a randomly assigned 64 bit integer, used to uniquely identify the clip
</unique_id>
<fps>
double: frames per second, must be >0, may be omitted or 0 if frames is 0
</fps>
<pb_fps>
(optional) double: playback frames per second (can be 0 or negative)
</pb_fps>
<audio_channels>
integer: number of audio channels (0,1 or 2). 0 means no audio
</audio_channels>
<audio_rate>
integer: audio rate (Hz). May be ommitted or 0 if audio_channels is 0
</audio_rate>
<pb_audio_rate>
(optional) integer: audio rate (Hz) for playback - may be negative
</pb_audio_rate>
<audio_sample_size>
integer: audio sample size in bits (16 or 8). May be ommitted or 0 if audio_channels is 0
</audio_sample_size>
<audio_signed>
boolean: if audio is signed, value is "true", otherwise "false". May be ommitted if audio_channels is 0
</audio_signed>
<audio_endian>
integer: 0 means little-endian, 1 means big-endian. May be ommitted if audio_sample_size is 8, or if audio_channels is 0
</audio_endian>
<clipname>
string: freeform text, max 256 characters
</clipname>
<filename>
(optional) string: original file name
</filename>
<title>
(optional) string: freeform text, max 256 characters
</title>
<author>
(optional) string: freeform text, max 256 characters
</author>
<comments;>
(optional) string: freeform text, max 256 characters
</comments>
<keywords;>
(optional) string: freeform text, max 1024 characters
</keywords>
Notes: the radix for double (decimal point) is "."
No white space is allowed before <section> or </section>. They must start a new line. White space is allowed between one section and the next.
Video values (frames, fps, bpp, width, height) are optional for audio only clips.
Audio values (audio_*) are optional for video only clips.
|