Alexander: add some forward declaration subroutine signatures

2024-01-29T09:00:39Z

add some forward declaration subroutine signatures

@@ Line 206: / Line 206: @@
 | 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>.
+| 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>
@@ Line 212: / Line 212: @@
 | Options <tt>struct</tt>s unionised to provide for each of the 4 possible output formats. <tt>struct</tt>s within TBD.
 |}
 ==References==
 <references />

Alexander: /* Composition API */ new section

2024-01-29T06:35:13Z

Composition API: new section

Show changes

Alexander: Created page with "'''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(192,248,192,0.5)" | `id`..."

2024-01-29T05:55:17Z

Created page with "'''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(192,248,192,0.5)" | <tt>id</tt>..."

New page

'''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(192,248,192,0.5)" | <tt>id</tt>
| style="background-color:rgba(192,248,192,0.5)" | <tt>u64</tt>
| ID of the raster image.
|-
| <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>
|-
| <tt>h</tt>
| <tt>u64</tt>
| Height of image minus one, in pels.<ref name="64bit" />
|-
| <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>
|-
| <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(192,248,192,0.5)" | <tt>id</tt>
| style="background-color:rgba(192,248,192,0.5)" | <tt>u64</tt>
| ID of the vector image.
|-
| <tt>w</tt>
| <tt>u64</tt>
| Nominal width of image minus one, in pels.<ref name="64bit" />
|-
| <tt>h</tt>
| <tt>u64</tt>
| Nominal height of image minus one, in pels.<ref name="64bit" />
|-
| <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(192,248,192,0.5)" | <tt>id</tt>
| style="background-color:rgba(192,248,192,0.5)" | <tt>u64</tt>
| ID of the motion picture.
|-
| <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>
|-
| <tt>h</tt>
| <tt>u32</tt>
| Height of motion picture minus one, in pels.<ref name="32bit" />
|-
| <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(192,248,192,0.5)" | <tt>id</tt>
| style="background-color:rgba(192,248,192,0.5)" | <tt>u64</tt>
| ID of the waveform.
|-
| <tt>rate</tt>
| <tt>u32</tt>
| Sample rate of the waveform, in hertz.
|-
| <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>
|-
| <tt>chcount</tt>
| <tt>u3</tt>
| Channel count minus one, thereby allowing anywhere from 1 to 8 channels.
|-
| <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>
|-
| <tt>data</tt>
| <tt>blob</tt>
| Raw PCM waveform payload.
|}

{| class="wikitable"
|+ Text
|-
! Field
! Type
! Description
|-
| style="background-color:rgba(192,248,192,0.5)" | <tt>id</tt>
| style="background-color:rgba(192,248,192,0.5)" | <tt>u64</tt>
| ID of the text.
|-
| <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>
|-
| <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(192,248,192,0.5)" | <tt>id</tt>
| style="background-color:rgba(192,248,192,0.5)" | <tt>u64</tt>
| ID of the animated image.
|-
| <tt>loop</tt>
| <tt>bool</tt>
| Whether the animation loops infinitely or not at all.
|-
| <tt>count</tt>
| <tt>u32</tt>
| Total number of frames in the animated image.
|-
| <tt>frames</tt>
| <tt>u64[]</tt>
| Ordered list of IDs to canonical raster images, constituting the animation frame list.
|}

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

==References==
<references />

SynDB - Revision history

Alexander: add some forward declaration subroutine signatures

Alexander: /* Composition API */ new section