Element: video
Video definition. The type attribute defines one of the different video HW configurations: coin (RCA Video Coin Arcade Game Console), cdp1861 (alternatively 1861 or pixie), cdp1862 (or 1862), cdp1864 (or 1864), st4 (Studio IV video), vip2k (VIP2K Membership Card video), fred (FRED 1 or 1.5 video), mc6845, mc6847, tms9918, intel8275, 1870 (RCA VIS 1870) or sn76430n (Cybervision 2001 video)
Type: coin
Video definition for the RCA Video Coin Arcade Game Console.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| graphics | child elements | Define graphic constants | |
| height | height (pixels) | Define video screen height in pixels. | |
| iogroup | group number (8 bit) | Coin Arcade iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q | port (1 to 7) | Coin Arcade output port definition to enable graphics. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| xscale | x scale factor | Define default x scale, when not specified factor 3 will be used. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: cdp1861
Video definition for the CDP1861 (pixie) chip.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type="fore") or background (type="back") color. For the VISICOM COM-100 color option 3 additional foregroud colors can be specified: type="fore1", type="fore2" and type="fore3". Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| colortype | vis | Defines VISICOM COM-100 color option. | |
| ef | pol, q | ef flag (1 to 4) | EF used for frame indicator. Use type="on" to use frame indicator only when screen is on / enabled. For details about attribute and value usage see XML - I/O |
| graphics | child elements | Define graphic constants | |
| height | height (pixels) | Define video screen height in pixels. | |
| highres | Define high resolution mode. | ||
| in | mask, q, type | port (1 to 7) | CDP1861 input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O |
| io | mask, q, type | port (1 to 7) | CDP1861 input and output port definition to enable (type="on", default) or disable (type="off") graphics. WHen using io instead of in or out, the specified port will be defined as input and output for the same function. For details about attribute and value usage see XML - I/O |
| iogroup | group number (8 bit) | CDP1861 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | CDP1861 output port definition to enable (type="on") or disable (type="off", default) graphics. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| xscale | x scale factor | Define default x scale, when not specified factor 3 will be used. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: cdp1862
Video definition for the CDP1862 chip, this definition should always be used in combination with the CDP1861 (pixie) definition.
| child element | attribute | value | description |
|---|---|---|---|
| color | type | red, green, blue (8 bit) | Defines foreground (type: white (or fore), red, blue, magenta, green, yellow, cyan, black) and/or background (type: back_blue (or back), back_black, back_green, back_red) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| colorram | mask | Define color RAM range, RAM bits as defined in mask | |
| colortype | cos, eti, hec, hug, tmc, vic, vip | Defines the color option: cos (Cosmicos, default), eti (ETI-660), hec (HEC1802), hug (HUG1802), tmc (Telmac 1800/2000), vic (Soundic Victory) or vip (COSMAC VIP) | |
| iogroup | group number (8 bit) | CDP1862 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | CDP1862 output port. Attribute Type="back" defines the output port to switch background colour. Attribute Type="color_ram" defines the output port to write to color RAM using the RAM bits as defined in mask. For details about attribute and value usage see XML - I/O |
Type: cdp1864
Video definition for the CDP1864 chip.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type: white (or fore), red, blue, magenta, green, yellow, cyan, black) and/or background (type: back_blue (or back), back_black, back_green, back_red) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| colorram | mask | Define color RAM range, RAM bits as defined in mask | |
| colortype | cos, eti, hec, hug, tmc, vic, vip | Defines the color option: cos (Cosmicos, default), eti (ETI-660), hec (HEC1802), hug (HUG1802), tmc (Telmac 1800/2000), vic (Soundic Victory) or vip (COSMAC VIP) | |
| ef | pol, q | ef flag (1 to 4) | EF used for frame indicator. Use type="on" to use frame indicator only when screen is on / enabled. For details about attribute and value usage see XML - I/O |
| graphics | child elements | Define graphic constants | |
| height | height (pixels) | Define video screen height in pixels. | |
| in | mask, q, type | port (1 to 7) | CDP1864 input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O |
| io | mask, q, type | port (1 to 7) | CDP1864 input and output port definition to enable (type="on", default) or disable (type="off") graphics. WHen using io instead of in or out, the specified port will be defined as input and output for the same function. For details about attribute and value usage see XML - I/O |
| iogroup | group number (8 bit) | CDP1864 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | CDP1864 output port definition. Attribute type="tone" defines the output port to set tone latch. Attribute type="back" defines the output port to switch background color. Attribute type="color_tone" defines the output port to set tone and color latch. Attribute Type="color_ram" defines the output port to write to color RAM using the RAM bits as defined in mask. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| xscale | x scale factor | Define default x scale, when not specified factor 4 will be used. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: st4
Video definition for the the Studio IV video chip.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type: black, red, blue, magenta, green, yellow, cyan, white) and/or background (type: back_black, back_red, back_blue, back_magenta, back_green, back_yellow, back_cyan, back_white) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| colorram | Define color RAM range | ||
| ef | pol, q | ef flag (1 to 4) | EF used for frame indicator. Use type="on" to use frame indicator only when screen is on / enabled. For details about attribute and value usage see XML - I/O |
| graphics | child elements | Define graphic constants | |
| height | height (pixels) | Define video screen height in pixels. | |
| in | mask, q, type | port (1 to 7) | Studio IV input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O |
| iogroup | group number (8 bit) | Studio IV video iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | Studio IV video output port definition. Attribute type="color" defines the output port to set color, enable graphics and PAL/NTSC mode, two 'color' output ports can be defined by repeating this tag. Attribute type="dma" defines the output port to enable the dma burst. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| xscale | x scale factor | Define default x scale, when not specified factor 4 will be used. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: graphics
Graphics line details for some of the above video chips.
| child element | attribute | value | description |
|---|---|---|---|
| interrupt | line | Defines graphic line when an interrupt should be generated. | |
| start | line | Defines graphic line when an interrupt should be generated. |
Type: vip2k
Video definition for the VIP2K Membership Card.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| dirname | type | directory name (text) | Location of the sequencer file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system). |
| ef | pol, q | ef flag (1 to 4) | EF used for frame indicator. For details about attribute and value usage see XML - I/O |
| filename | file name (text) | VIP2K Membership Card sequencer filename. | |
| height | height (pixels) | Define video screen height in pixels. | |
| in | mask, q, type | port (1 to 7) | VIP2K Membership Card input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O |
| io | mask, q, type | port (1 to 7) | VIP2K Membership Card input and output port definition to enable (type="on", default) or disable (type="off") graphics. WHen using io instead of in or out, the specified port will be defined as input and output for the same function. For details about attribute and value usage see XML - I/O |
| iogroup | group number (8 bit) | VIP2K Membership Card iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | VIP2K Membership Card output port definition to enable (type="on") or disable (type="off", default) graphics. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| xscale | x scale factor | Define default x scale, when not specified factor 1.5 will be used. | |
| width | width (pixels) | Define video screen width in pixels. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: fred
Video definition for the FRED 1 or 1.5.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| height | height (pixels) | Define video screen height in pixels. | |
| iogroup | group number (8 bit) | FRED 1 or 1.5 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | FRED 1 or 1.5 output port definition (bit 0-2 background colour, bit 3 white foreground, bit 4-5 enable graphics, bit 6 PAL/NTSC). For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| xscale | x scale factor | Define default x scale, when not specified no factor will be used. | |
| width | width (pixels) | Define video screen width in pixels. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: mc6845
Video definition for the MC6845 chip.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| char | XxY (pixels) | Define initial character size in pixels, e.g. 7x8 will define characters of 7 pixels wide and 8 pixels high. Note that charcater height can be changed via the CRTC address and data register. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| dirname | type | directory name (text) | Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system). |
| ef | pol, q | ef flag (1 to 4) | EF used for display enable. For details about attribute and value usage see XML - I/O |
| font | font file name (text) | MC6845 font file filename. | |
| interlace | Set interlace option on | ||
| iogroup | group number (8 bit) | MC6845 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, type | address (16 bit) | MC6845 output definition using a memory address. Attribute type="register" defines the CRTC address register. Attribute type="data" defines the CRTC data register. Using the mask option will allow a range of addresses. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| ram | start-end (hex format and 16 bit) | Defines video ram in a range within the CPU memory map. Always specify a range in hex (0x) format. | |
| screen | XxY (character x lines) | Defines initial screen size in characters, e.g. 64x16 will define a screen of 64 characters wide and 16 lines. Note that screen size can be changed via the CRTC address and data register. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: mc6847
Video definition for the MC6847 chip.
| child element | attribute | value | description |
|---|---|---|---|
| as | init | bit number | Defines 'as' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| ag | init | bit number | Defines 'ag' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines text (type: text_back, text_back, text_orange) and/or graphic (type: graph_green, graph_yellow, graph_blue, graph_red, graph_buff, graph_cyan, graph_magenta, graph_orange) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| css | init | bit number | Defines 'css' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| dirname | type | directory name (text) | Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system). |
| ext | init | bit number | Defines 'ext' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| font | font file name (text) | MC6847 font file filename. | |
| gm0 | init | bit number | Defines 'gm0' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| gm1 | init | bit number | Defines 'gm1' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| gm2 | init | bit number | Defines 'gm2' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| inv | init | bit number | Defines 'inv' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0. |
| iogroup | group number (8 bit) | MC6847 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q | port (1 to 7) or address range (16 bit) | MC6847 output definition output number to select video mode either defined as an output port (1-7) or range (use hex, i.e. 0xFF00-0xFFFF). For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| ram | start-end (hex format and 16 bit) | Defines video ram in a range within the CPU memory map. Always specify a range in hex (0x) format. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: tms9918
Video definition for the TMS9918 chip.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines color (type: transparant, black, medium_green, light_green, dark_blue, light_blue, dark_red, aqua_blue, medium_red, light_red, dark_yellow, light_yellow, dark_green, purple, gray, white) definiton. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| ef | pol, q | ef flag (1 to 4) | EF used for interrupt. For details about attribute and value usage see XML - I/O |
| iogroup | group number (8 bit) | TMS9918 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | TMS9918 output port definition. Attribute type="register" defines the port to select the register. Attribute type="data" defines the port for data output. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: intel8275
Video definition for the Intel 8275 chip.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines foreground (type="fore"), background (type="back") or highlight (type="high")color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| dirname | type | directory name (text) | Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system). |
| ef | pol, q | ef flag (1 to 4) | EF used for the vertical retrace. For details about attribute and value usage see XML - I/O |
| font | font file name (text) | Intel 8275 font file filename. | |
| in | mask, q, type | port (1 to 7) | Intel 8275 input portin definition using a memory address. Attribute type="status" defines the port to read the status. Attribute type="parameter" defines the port to read the parameter. For details about attribute and value usage see XML - I/O |
| interlace | Set interlace option on | ||
| iogroup | group number (8 bit) | Intel 8275 iogroup definition. For details about value usage see XML - I/O | |
| out | mask, q, type | port (1 to 7) | Intel 8275 output port definition. Attribute type="command" defines the port to write the command. Attribute type="parameter" defines the port to write the parameter. For details about attribute and value usage see XML - I/O |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: 1870
Video definition for the VIS 1870.
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| charlines | number of lines (8 or 9) | Defines default number of character lines 8 or 9. The actual value should be set by FW but the default is used for the initial emulation screen size. If not specified 8 will be used for NTSC and 9 for PAL. | |
| charrom | address (16 bit) | Defines at which addres character RAM changes to ROM (i.e., where character ROM starts) | |
| charsize | iogroup, type | size (0x3ff or 0x7ff) | Define charcater memory as RAM (type="ram") or ROM (type="rom") with size 0x3ff or 0x7ff. Attribute iogroup="no" will decouple activation of character RAM from the defined I/O group. |
| clock | speed (MHz) | VIS 1870 clock speed | |
| cmamaskfixed | CMA mask fixed to 0xf independent of the number of lines. NTSC or 8 lines would normally use CMA mask 0x7 but COMX NTSC still uses 16 lines per character in memory so CMA mask is 0xf. | ||
| color | num, mask | red, green, blue (8 bit) | Defines color where attribute num="x" will set color x with x=0 to 7. Attribute mask defines the color mask for color x (num="x") where x=0 to 7. Color mask is used in the ctone definition which defines the different brightness levels. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| colorram | type | Define color RAM type: type="cidelsa" (color ram HW as in Cidelsa) or type="tmc" (color ram HW as in TMC600) | |
| ctone | num | Defines the CTONE brightness value for color x (num="x"), this should be used in combination with a defintion of a color mask only. | |
| cursorblink | Activates cursor blinking | ||
| dirname | type | directory name (text) | Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system). |
| ef | pol, q | ef flag (1 to 4) | VIS 1870 EF flag definition. Attribute type="display" defines the EF flag for the non display period. Attribute type="mode" defines the EF flag to select video mode (used in the COMX-35 or COMIX-35, where this function is only active until first Q pulse). Attribute write="enable" will enable writing to video RAM even during display period. For details about attribute and value usage see XML - I/O |
| filename | format | file name (text) | VIS 1870 character ROM file filename. Attribute format="tmc" loads a file in TMC format. |
| graphicsize | iogroup, type | size (0x1fff) | Define graphic memory as RAM with size 0x1fff. Attribute iogroup="no" will decouple activation of character RAM from the defined I/O group. |
| int | VIS 1870 interrupt mode. | ||
| iogroup | group number (8 bit) | VIS 1870 iogroup definition. For details about value usage see XML - I/O | |
| maxcharlines | number of lines (8 or 16) | Defines maximum number of character lines 8 or 16. When using PAL, 9 lines are visible but 16 are reserved in character memory. | |
| maxscreenlines | number of lines (24, 25 or 27) | Defines number of lines on one screen: 24, 25 or 27 (for Cidelsa DRACO) | |
| mode | mode (pal or ntsc) | Defines video mode pal or ntsc | |
| out | mask, q, type | port (1 to 7) | VIS 1870 output port definition. Attribute type="select" defines the port to select the VIS 1870 port (as used in the Telmac TMC-600). Attribute type="write" defines the port to write to the selected VIS 1870 port (as used in the Telmac TMC-600). Attribute type="int" defines the port to set interrupt enable (port 2 on the RCA COSMC Microboard Computer). Attribute type="int_reset" defines the port to reset the interrupt request (port 2 on the VIS1802). For details about attribute and value usage see XML - I/O |
| pagesize | iogroup, type | size (0x3ff or 0x7ff) | Defines page memory as RAM with size 0x3ff or 0x7ff. Attribute type="ram" is the normal configuration and type="rom" will define page memory as RAM but add the option to load a ROM to 0xF800-0xFFFF as well. Attribute iogroup="no" will decouple activation of page RAM from the defined I/O group. |
| pcbmask | 0x7f or 0xff | Defines pcb mask 0x7f or 0xff | |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| rotate | Rotate screen 90% as in Cidelsa | ||
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |
Type: sn76430n
Video definition for the SN76430N chip (Cybervision 2001 video).
| child element | attribute | value | description |
|---|---|---|---|
| border | XxY (pixels) | Defines default border size. | |
| color | type | red, green, blue (8 bit) | Defines color (type: white, yellow, green, red or black) definiton. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used. |
| pos | screen position (x, y) | Defines default video terminal screen position. | |
| zoom | zoom factor | Define default zoom, when not specified factor 2.00 will be used. |