View source for SynDB

'''SynDB''' is a database schematic for [[light data]] rich hypermedia syndication.

==Schemas==
===Canonical schemas===
These schemas contain raw media data in a singular canonical format. These formats serve as master copies from which processed "composite" media formats can be created for various purposes and the constraints thereof.

{| class="wikitable"
|+ Raster images
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,192,248,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the raster image.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>w</tt>
| <tt>u64</tt>
| Width of image minus one, in pels.<ref name="64bit">Allows for a range of 1 to 18,446,744,073,709,551,616 pels.</ref>
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>h</tt>
| <tt>u64</tt>
| Height of image minus one, in pels.<ref name="64bit" />
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>colspace</tt>
| <tt>enum : u4</tt>
| Colour space in use.<ref>Can be one of <code>GRAY1</code><tt>=0</tt>, <code>GRAY2</code><tt>=1</tt>, <code>GRAY4</code><tt>=2</tt>, <code>GRAY8</code><tt>=3</tt>, <code>GRAY16</code><tt>=4</tt>, <code>GRAY32</code><tt>=5</tt>, <code>RGB332</code><tt>=6</tt>, <code>RGBA4444</code><tt>=7</tt>, <code>RGB565</code><tt>=8</tt>, <code>RGBA5551</code><tt>=9</tt>, <code>RGBA8888</code><tt>=10</tt>, <code>RGBX1010102</code><tt>=11</tt>, <code>RGBA16161616</code><tt>=12</tt>, <code>YUV420</code><tt>=13</tt>, <code>YUV422</code><tt>=14</tt>, or <code>YUV444</code><tt>=15</tt>.</ref>
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>data</tt>
| <tt>blob</tt>
| Data payload, using the given colour space as its ABI.
|}

{| class="wikitable"
|+ Vector images
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,192,248,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the vector image.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>w</tt>
| <tt>u64</tt>
| Nominal width of image minus one, in pels.<ref name="64bit" />
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>h</tt>
| <tt>u64</tt>
| Nominal height of image minus one, in pels.<ref name="64bit" />
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>data</tt>
| <tt>blob</tt>
| Data payload, using the PackVector format as its ABI.
|}

{| class="wikitable"
|+ Motion pictures
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,192,248,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the motion picture.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>w</tt>
| <tt>u32</tt>
| Width of motion picture minus one, in pels.<ref name="32bit">Allows for a range of 1 to 4,294,967,296 pels.</ref>
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>h</tt>
| <tt>u32</tt>
| Height of motion picture minus one, in pels.<ref name="32bit" />
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>data</tt>
| <tt>blob</tt>
| Motion picture payload, stored as HEVC Main 10 Profile lossless in AVCC container format (MPEG-4 Part 15).
|}

{| class="wikitable"
|+ Waveform audio
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,192,248,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the waveform.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>rate</tt>
| <tt>u32</tt>
| Sample rate of the waveform, in hertz.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>depth</tt>
| <tt>enum : u2</tt>
| Bit depth of an audio sample.<ref>Can be one of <code>U8</code><tt>=0</tt>, <code>U16LE</code><tt>=1</tt>, <code>U24LE</code><tt>=2</tt> or <code>U32LE</code><tt>=3</tt>.</ref>
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>chcount</tt>
| <tt>u3</tt>
| Channel count minus one, thereby allowing anywhere from 1 to 8 channels.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>ttl</tt>
| <tt>u64</tt>
| Total sample count.<ref>This counts inter-channel samples, ergo 1 second of 44.1kHz audio is 44,100 samples regardless of the channel count.</ref>
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>data</tt>
| <tt>blob</tt>
| Raw PCM waveform payload.
|}

{| class="wikitable"
|+ Text
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,192,248,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the text.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>encoding</tt>
| <tt>enum : u2</tt>
| Content encoding of the text.<ref>Can be one of <code>ASCII</code><tt>=0</tt>, <code>UTF8</code><tt>=1</tt>, <code>UTF16LE</code><tt>=2</tt>, or <code>UTF32LE</code><tt>=3</tt>.</ref>
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>data</tt>
| <tt>blob</tt>
| Data payload of the text, without any {{expl|BOM|byte order mark}}.
|}

===Composite schemas===
These schemas contain information particular to composite media formulations sourced from canonical "master copies" in tables following the schemas above. They are tailored to specific uses very close to the product level.

{| class="wikitable"
|+ Animated images
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,192,248,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the animated image.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>loop</tt>
| <tt>bool</tt>
| Whether the animation loops infinitely or not at all.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>count</tt>
| <tt>u32</tt>
| Total number of frames in the animated image.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>frames</tt>
| <tt>u64[]</tt>
| Ordered list of IDs to canonical raster images, constituting the animation frame list.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>delays</tt>
| <tt>u16[]</tt>
| Ordered list of delays for each frame, denominated in centiseconds (10ms increments).
|}

{| class="wikitable"
|+ Web videos
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,192,248,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the video.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>video</tt>
| <tt>u64</tt>
| ID of the canonical motion picture data source.
|-
| style="background-color:rgba(192,248,192,0.5)" | <tt>audio</tt>
| <tt>u64</tt>
| ID of the canonical waveform data source.
|-
| style="background-color:rgba(192,248,192,0.5)" | <tt>subs</tt>
| <tt>u64</tt>
| ID of the canonical text data, interpreted as SRT format subtitles.
|}

==Composition API==
{| class="wikitable"
|+ Animated images
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>id</tt>
| <tt>u64</tt>
| ID of the animated image in the database table.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>cent8crop</tt>
| <tt>bool</tt>
| Whether to do a centred crop to the nearest whole 8&times;8 width and height. This helps make more efficiently coded MP4s.
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>outfmt</tt>
| <tt>enum : u2</tt>
| Desired output format.<ref>Can be one of <code>MP4</code><tt>=0</tt>, <code>APNG</code><tt>=1</tt>, <code>MNG</code><tt>=2</tt> or <code>GIF</code><tt>=3</tt>.</ref>
|-
| style="background-color:rgba(248,248,192,0.5)" | <tt>outopts</tt>
| <tt>union : outfmt</tt>
| Options <tt>struct</tt>s unionised to provide for each of the 4 possible output formats. <tt>struct</tt>s within TBD.
|}

<pre>s32 syn_compose_ani_mp4(
   u64 id,
   bl cent8crop,
   u32 w,
   u32 h,
   enum { NEAREST, BILINEAR, BICUBIC, LANCZOS } resize_alg,
   enum { FPS24, FPS30, FPS60 } fps,
   u32 bitrate );</pre>

<pre>s32 syn_compose_ani_apng(
   u64 id,
   bl cent8crop,
   u16 w,
   u16 h,
   enum { NEAREST, BILINEAR, BICUBIC, LANCZOS } resize_alg,
   bl paletted,
   bl crushed );</pre>

<pre>s32 syn_compose_ani_gif(
   u64 id,
   bl cent8crop,
   u16 w,
   u16 h,
   enum { NEAREST, BILINEAR, BICUBIC, LANCZOS } resize_alg,
   bl deep_pal,
   bl crushed );</pre>

==References==
<references />