Difference between revisions of "MGV"

From MSX Game Library

(Commands)
(Extension)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
MGLV is a video format for MSXgl.
+
'''MGV''' is a video format for MSXgl.
  
 
== Format ==
 
== Format ==
Line 24: Line 24:
 
<syntaxhighlight lang="txt>
 
<syntaxhighlight lang="txt>
 
7  6  5  4  3  2  1  0
 
7  6  5  4  3  2  1  0
│  │  │     └──┴──┴──┴── Screen mode (0-15)
+
│  │  │       └──┴──┴── Screen mode (0-7)
 
│  │  └───────────────── Screen width (0: 256 px, 1: 512 px)
 
│  │  └───────────────── Screen width (0: 256 px, 1: 512 px)
 
└──┴──────────────────── Bit per pixel (0: 1-bit, 1: 2-bit, 2: 4-bit, 3: 8-bit)
 
└──┴──────────────────── Bit per pixel (0: 1-bit, 1: 2-bit, 2: 4-bit, 3: 8-bit)
 
</syntaxhighlight>
 
</syntaxhighlight>
 
Screen mode:
 
Screen mode:
* 0: Text 1 (Screen 0 width 40, 40x27)
+
* 0: TEXT - Screen 0, width 40 & 80
* 1: Graphic 1 (Screen 1, 32x27)
+
* 1: GM1 - Screen 1
* 2: Graphic 2 (Screen 2, 32x27)
+
* 2: GM2 - Screen 2 & 4
* 3: Multi Color (Screen 3, 64x53)
+
* 3: MC - Screen 3
* 4: Text 2 (Screen 0 width 80, 80x27)
+
* 4: BITMAP - Screen 5 ~ 8
* 5: Graphic 3 (Screen 4, 32x27)
+
* 5: YAE - Screen 10 (GM7 + YJK + YAE)
* 6: Graphic 4 (Screen 5, 256x212, 16 colors)
+
* 6: YJK - Screen 12 (GM7 + YJK)
* 7: Graphic 5 (Screen 6, 512x212, 4 colors)
 
* 6: Graphic 6 (Screen 7, 512x212, 16 colors)
 
* 7: Graphic 7 (Screen 8, 256x212, 256 colors)
 
* 8: Graphic 7 + YJK + YAE (Screen 10, 256x212, X colors)
 
* 9: Graphic 7 + YJK (Screen 12, 256x212, X colors)
 
* 10: Graphic 3 mirrored 0000 (undocumented)
 
* 11: Graphic 3 mirrored 0101 (undocumented)
 
* 12: Graphic 3 mirrored 0022 (undocumented)
 
 
|-
 
|-
 
| (0x0005) || 1 || Video format - Replay
 
| (0x0005) || 1 || Video format - Replay
Line 91: Line 83:
 
| <tt>n8</tt> || <tt>vv</tt> || Fill <tt>n</tt> bytes (1-15) with <tt>vv</tt> value
 
| <tt>n8</tt> || <tt>vv</tt> || Fill <tt>n</tt> bytes (1-15) with <tt>vv</tt> value
 
|-
 
|-
| <tt>09</tt> || <tt>vv,nn</tt> || Fill <tt>nn</tt> bytes (1-255) with <tt>vv</tt> value
+
| <tt>09</tt> || <tt>nn,vv</tt> || Fill <tt>nn</tt> bytes (1-255) with <tt>vv</tt> value
 
|-
 
|-
| <tt>0A</tt> || <tt>vv,nnnn</tt> || Fill <tt>nnnn</tt> bytes (1-65535) with <tt>vv</tt> value
+
| <tt>0A</tt> || <tt>nnnn,vv</tt> || Fill <tt>nnnn</tt> bytes (1-65535) with <tt>vv</tt> value
 
|-
 
|-
 
| <tt>0B</tt> || <tt>vv</tt> || Fill a full frame with <tt>vv</tt> value
 
| <tt>0B</tt> || <tt>vv</tt> || Fill a full frame with <tt>vv</tt> value
Line 108: Line 100:
  
 
== Extension ==
 
== Extension ==
<tt>.MGLV</tt> (for Windows/Linux) or <tt>.MGV</tt> (for MSX-DOS)
+
* Default extension (for MSX-DOS): <tt>.MGV</tt>
 +
* Alternative for Windows/Linux: <tt>.MGLV</tt>
  
 
== Change log ==
 
== Change log ==

Latest revision as of 00:59, 29 October 2024

MGV is a video format for MSXgl.

Format

Header

Offset Size Desc. Value
0x0000 3 Signature "MGV"
0x0003 1 Flag
7  6  5  4  3  2  1  0
│        │  └──┴──┴──┴── File format version (0-15)
│        └────────────── Segment size (0: 8 KB, 1: 16 KB)
└─────────────────────── Include video format data (4 bytes)
(0x0004) 1 Video format - Image
7  6  5  4  3  2  1  0
│  │  │        └──┴──┴── Screen mode (0-7)
│  │  └───────────────── Screen width (0: 256 px, 1: 512 px)
└──┴──────────────────── Bit per pixel (0: 1-bit, 1: 2-bit, 2: 4-bit, 3: 8-bit)

Screen mode:

  • 0: TEXT - Screen 0, width 40 & 80
  • 1: GM1 - Screen 1
  • 2: GM2 - Screen 2 & 4
  • 3: MC - Screen 3
  • 4: BITMAP - Screen 5 ~ 8
  • 5: YAE - Screen 10 (GM7 + YJK + YAE)
  • 6: YJK - Screen 12 (GM7 + YJK)
(0x0005) 1 Video format - Replay
7  6  5  4  3  2  1  0
│  │        └──┴──┴──┴── Frame skip (0-15)
│  └──────────────────── Loop (0: No, 1: Yes)
└─────────────────────── Frequency (0: 50 Hz, 1: 60 Hz)

At 50 Hz, a frame skip of 1 means 25 fps.
At 60 Hz, a frame skip of 5 means 10 fps.

(0x0006) 1 Video format - Width 1-256 (or 2-512 for Screen mode 6 and 7)
(0x0007) 1 Video format - Height 1-256

Commands

Cmd Options Desc.
00 End of data
01 End of segment (increment segment index and reset data pointer)
02 End of line
x3 Switch to table

x:

  • 0: Pattern table (default)
  • 1: Color table (screen mode 1, 2 and 3)
  • 2: Layout table (tile based modes)
  • 3: Color palette (MSX2/2+)
n4 Skip n bytes (1-15)
05 nn Skip nn bytes (1-255)
06 nnnn Skip nnnn bytes (1-65535)
07 Skip a frame / End of frame
n8 vv Fill n bytes (1-15) with vv value
09 nn,vv Fill nn bytes (1-255) with vv value
0A nnnn,vv Fill nnnn bytes (1-65535) with vv value
0B vv Fill a full frame with vv value
nC vv[n] Copy n bytes (1-15) from vv[n] data table
0D nn,vv[nn] Copy nn bytes (1-255) from vv[nn] data table
0E nnnn,vv[nnnn] Copy nnnn bytes (1-65535) from vv[nnnn] data table
0F vv[] Copy a full frame from data table (raw frame)

Extension

  • Default extension (for MSX-DOS): .MGV
  • Alternative for Windows/Linux: .MGLV

Change log

  • Version 1.0 (2024/03/31)
    • Original version (File format version 0)