Editing TMS9918

{{short description|Video display controller}}
{{more citations needed|date=April 2015}}
[[IMAGE:TMS9918A 01.jpg|thumb|VDP TMS9918A]]
[[IMAGE:TMS9918A 02.jpg|thumb|VDP TMS9918A]]
The '''TMS9918''' is a [[video display controller]] (VDC) manufactured by [[Texas Instruments]], in manuals referenced as "Video Display Processor" (VDP) and introduced in 1979.<ref name="auto">{{Cite web|url=https://www.smspower.org/Development/TMS9918ArizonaTechnicalSymposiumDraft|title=TMS9918 Arizona Technical Symposium Draft - Development - SMS Power!|website=www.smspower.org}}</ref> The TMS9918 and its variants were used in the [[PV-2000|Casio PV-2000]], [[Coleco Adam]], [[ColecoVision]], [[VTech CreatiVision|CreatiVision]], [[Hanimex|Hanimex Pencil II]], [[MSX]], [[Memotech MTX]], [[NABU Network#Hardware|NABU Personal Computer]], [[Programa Educativo de Colegios Secundarios|PECOS]], [[SG-1000]], [[SC-3000]], [[SV-318]], [[SV-328]], [[Sord M5]], [[TI-99/4A|TI-99/4]], [[Tatung Einstein]], and [[Tomy Tutor]].

The TMS9918 generates both grid-based character graphics (used to display text or background images) and [[sprite (computer graphics)|sprite]]s used for moving foreground objects.

The key features of this chip are, as highlighted in a 1980 presentation by Karl Guttag (one of the designers):<ref name="auto"/>

*256 by 192 full color pixels per screen
*15 different colors and/or shades
*[[Progressive scan|Non-interlaced]] color [[composite video]] output
*Direct wiring to RAS/CAS type [[Dynamic random-access memory|dynamic RAMs]]
*Automatic refresh of dynamic RAMs
*General [[8-bit computing|8-bit]] memory mapped type CPU interface
*CPU accesses RAM via VDP (no need for [[Direct memory access|DMA]])
*32 dynamic characters per screen
*Thirty-two 8×8 patterns per row, 24 rows per screen
*Text mode with forty 6×8 patterns per row
*Multicolor mode with 64 by 48 memory mappable color squares
*External video input and control
*Single supply +5 volt operation
*Standard N-Channel [[Silicon-gate|silicon gate]] technology

==Product family==
All of the ICs in this family are usually referred to by the TMS9918 name, sometimes with an 'A' postfix. The 'A' indicates a second version of the chip which added new features, most prominently the addition of a [[bitmap]] mode (Graphic II).

{| class="wikitable sortable" style="margin-left: auto; margin-right: auto; border: none;"
|+ Texas Instruments TMS9918 Product Family Summary
|-
! Chip Variant
! Video Out
! Video In
! Video Frequency
! Mode 2 Support
|-
| 9918
| [[Composite video|Composite]]
| Composite
| [[525 lines|60 Hz]]
| No
|-
| 9918A / 9118
| Composite
| Composite
| 60 Hz
| Yes
|-
| 9928A / 9128
| [[YPbPr]]
| (None)
| 60 Hz
| Yes
|-
| 9929A / 9129
| YPbPr
| (None)
| [[625 lines|50 Hz]]
| Yes
|}

===TMS9918===
The '''TMS9918''' was only used in the TI-99/4; the [[TI-99/4A]] and the other computers had the A version VDC.

=== TMS9918A, TMS9928A and TMS9929A ===
[[IMAGE:TMS9928A 01.jpg|thumb|VDP TMS9928A]]
The '''TMS9918A''' and '''TMS9928A''' output a [[525 lines|60&nbsp;Hz video signal]], while the '''TMS9929A''' outputs 50&nbsp;Hz. The difference between '1' and the '2' in 'TMS9918A' and 'TMS9928A' is that the '1' version outputs [[composite video|composite]] [[NTSC]] video, while the '2' versions (including the TMS9929A) outputs analog Y [[luma (video)|luminance]] and R-Y and B-Y colour difference signals. The need for the latter was predominant in the [[625 lines|50&nbsp;Hz world]], including Europe, due to the different video signal standards [[PAL]] and [[SECAM]].  It was more cost-effective to output Y, R-Y and B-Y and encode them into PAL or SECAM in the [[RF modulator]], than to try to have a different console for every different color standard.  The '1' version also features an external composite video input which made it a handy chip to use in video "titlers" that could overlay text or graphics on video, while the '2' version does not.

The original variants of the TMS9918 were depletion load NMOS and manufactured on a 4.5 μm process; it was one of the first depletion load NMOS chips Texas Instruments manufactured in contrast to the [[TMS9900]] microprocessor which used the older enhancement load NMOS process that required three supply voltages. Due to the large die size and relatively high internal speed, the TMS9918 ran warm enough to necessitate a heat sink; some devices such as the Taiwanese DINA console (a hybrid Colecovision/SG-1000) neglected to install sinks and suffered from malfunctions of the chip. By 1983 Texas Instruments had shrunk the die size to 3 μm which ran cooler and no longer required a sink; MSX machines and the Sega SG-1000 used the newer 3 μm TMS9918 while most Colecovisions had the original 4.5 μm variant (the final run of the consoles produced in 1985 had the newer model TMS9918).

===TMS9118, TMS9128 and TMS9129===
[[File:VDP TMP9118.png|thumb|VDP TMP9118NL prototype]]
A later variant of the TMS9918 series chips, the '''TMS9118''', '''TMS9128''', and '''TMS9129''', were released in the mid-late 1980s, but were never very popular. The function of one pin is changed, and the mapping of the video memory allows two 16K×4-bit chips to be used instead of the eight 16K×1-bit chips the TMS99xx needs. Otherwise the chips are completely identical to the TMS9918A, TMS9928A and TMS9929A respectively.

==External interfaces==

===Video RAM===
The VDP has 16K × 8 bits of external video memory.  This memory is outside the address space of the [[Central processing unit|CPU]].  Having a separate address space means that the CPU has to do more work to write or read this memory, but it also means that the VDC doesn't slow the CPU down when it periodically reads this memory to generate the display.  Additionally, it leaves more address space available to the CPU for other memory and memory-mapped hardware.

Depending on the screen mode being used, not all of the video memory may be needed to generate the display.  In these cases, the CPU may use the extra video memory for other purposes.  For example, one use is as a scratch-pad for uncompressing graphics or sound data stored in cartridge ROM into.  Another popular use is to create a second copy of some or all of the display data to eliminate flickering and tearing, a technique known as [[Multiple buffering#Double buffering in computer graphics|double buffering]].

===CPU===
The CPU communicates with the VDP through an [[Bus (computing)|8-bit bus]].  A pin controlled by the CPU separates this bus into two "ports", a control port and a data port.  To write or read a byte of video memory, the CPU first has to write two bytes on the VDP's control port to the VDC's internal address [[Processor register|register]].  Next, the CPU performs the actual write or read on the VDP's data port.  As a data byte is written or read, the TMS9918 automatically increments the internal address register.  This auto-increment feature accelerates writes and reads of blocks of data.  The control port is also used to access various internal registers.

==Graphics==
The TMS9918 has two separate and distinct graphics types: characters and [[Sprite (computer graphics)|sprites]].

===Characters===
Characters are typically used to create text or background images. They appear behind sprites.

====Screen modes====
The TMS9918 has a number of screen modes that control the characteristics of the characters.

=====Documented=====
There are four documented screen modes available in the TMS9918A (as mentioned before, the TMS9918 lacks mode Graphic 2):
* '''Mode 0 (Text):''' 240×192 pixels total, as 40×24 characters, pulled from 1 character set of 256 6×8 pixel characters. The entire character set has a 2-color limitation. This mode doesn't support sprites.
* '''Mode 1 (Graphic 1):''' 256×192 pixels total, as 32×24 characters, pulled from 1 character set of 256 8×8 pixel characters. Each group of 8 characters in the character set has a 2-color limitation. For example, the characters "0" through "7" will all have the same [[Attribute clash|color attributes]].
* '''Mode 2 (Graphic 2):''' 256×192 pixels total, as 32×24 characters, pulled from 3 character sets of 256 8×8 pixel characters. Each 8-pixel-wide line of a character in the character sets has a 2-color limitation. This mode provides a unique character for every character location on screen, allowing for the display of bitmapped images.
* '''Mode 3 (Multicolor):''' 256×192 pixels total, 64×48 changeable virtual pixels, as 32×24 "[[Semigraphics|semi-graphics]]" characters. These semi-graphics are defined in a special character set of 256 characters defined by 2×2 "fat-pixels". There are 4×4 pixels in each fat-pixel, but the pixels within a fat-pixel cannot be individually defined, although each fat-pixel can have its own color, hence the name of this mode (Multicolor). This mode is very blocky, and rarely used.

====== Screen Mode 2 details ======
Technically, mode 2 is a character mode with a colorful character set. The screen is horizontally divided into three 256×64 pixel areas, each of which gets its own character set. By sequentially printing the characters 0 through 255 in all three areas, the program can simulate a graphics mode where each pixel can be set individually. However, the resulting [[framebuffer]] is non-linear.

The program can also use three identical character sets, and then deal with the screen like a text mode with a colorful character set. Background patterns and sprites then consist of colorful characters. This was commonly used in games, because only 32×24 bytes would have to be moved to fill and scroll the entire screen.

The challenge of using TMS9918 mode 2 was that every 8×1 pixel area could have only two colors, foreground and background. They could be freely picked out of the 16 color palette, but for each 8×1 area, only two colors could exist. When manipulating the screen in [[BASIC]] with the <code>LINE</code> command, one easily could exceed the maximum 2 colors per 8×1 area and end up with "[[Attribute clash|color spill]]".

=====Undocumented=====
Texas Instruments originally only documented the four modes listed above. However the bit that enables mode 2 is more interesting than initially let on. It is best described as a modifier bit for the other modes. Enabling it does three things:<ref>[http://www.unige.ch/medecine/nouspikel/ti99/tms9918a.htm#hybrid%20bitmap Video Display Processor / Hybrid Modes.], which is also put to use.</ref>

# Expands the color table size.
# Divides the screen horizontally into thirds.
# Changes two address bits of the pattern and color tables into mask bits, which controls whether each third of the screen has its own pattern and color table or not.

With this in mind, three additional modes are possible. Note that although genuine TMS9918A chips support these modes, clones and emulators may not.
* '''Mode 0 (Text) + Mode 2 (Graphic 2)''': Known as ''Bitmap Text Mode''. This mode allows for two-color bitmap images, with no color table.  This saves memory, at the expense of a slightly reduced horizontal resolution (text mode has a horizontal resolution of 240 pixels instead of 256 pixels like the graphic modes do).
* '''Mode 1 (Graphic 1) + Mode 2 (Graphic 2):''' Known as ''Half-Bitmap Mode''.  Texas Instruments actually documented this "undocumented" screen mode in their manual titled ''"Video Display Processors Programmers Guide SPPU004"''.<ref name=":0">{{Cite book |url=http://www.msxblog.es/wp-content/uploads/2009/09/vdpprogrammersguide.pdf |title=Video Display Processors - Programmer's Guide |publisher=Texas Instruments}}</ref>  In section 8.4.2, "''Playing Games with VRAM Addressing"'',<ref name=":0" /> they discuss how this mode combines the memory savings of mode 1 with the color detail of mode 2.  However, as they go on to say this mode limits the number of sprites that can be displayed to 8 instead of 32.  Therefore, the term "undocumented" used to describe this mode is a misnomer.  However, because this manual was not widely known, this mode is generally considered to be one of the undocumented modes. Generally, the only reason to use this mode over Mode 2 is to reduce memory consumption.
* '''Mode 3 (Multicolor) + Mode 2 (Graphic 2)''': Known as Bitmap Multicolor Mode. This mode is more of a novelty, as it offers nothing beyond what the standard Multicolor mode can already do.

====Scrolling====
The TMS9918 does not have any [[Scrolling|scroll]] registers, so scrolling must be done by software.  Furthermore, scrolling can only be done on character boundaries, not pixel by pixel.{{citation needed|date=April 2018}}

===Sprites===
Sprites are typically used to create moving foreground objects. They appear in front of characters (tiles).

Modes 1, 2, and 3 can render sprites. There can be up to 32 monochrome sprites of either 8×8 or 16×16 pixels on screen, each sprite with its own, single color.  The illusion of multicolor sprites can be created by stacking multiple sprites on top of each other.

There can be no more than 4 sprites on a single scanline; any additional sprites' horizontal pixels are dropped. Sprites with a higher priority are drawn first. The VDP reports in a status register the number of the first dropped sprite. The CPU can get around this limitation by rotating sprite priorities so that a different set of sprites is drawn on every frame; instead of disappearing entirely, the sprites will flicker. This technique is known as sprite multiplexing.

Automatic sprite movement is not handled by the VDP. Instead, in practice, the CPU will pick up on the VDP's [[vertical blank interrupt|vertical interrupt]] - a standard VDP output, which is triggered automatically once every 50th or 60th of a second (depending on chip variant), at the start of the VBI ([[vertical blanking interval]]).  The CPU then jumps to a sprite-handling routine in the software, which in turn tells the VDP where to reposition the sprites.

The sprite collision flag is set when non-zero pattern bits of two sprites coincide, even if either sprite has transparent colour. This is useful for triggering more advanced collision detection routines inside the software which can then determine the exact location of the collision and act upon it, as the VDP is itself incapable of reporting which two sprites have collided.

===Colors===
The TMS9918 family chips used a [[composite video]] palette. Colors were generated based on a combination of [[luminance]] and [[chrominance]] values for the TMS9918A and [[Y]], [[B-Y|U (B-Y)]] and [[R-Y|V (R-Y)]] values are for the TMS9928A/9929A.<ref name=":1">{{Cite book |url=http://www.bitsavers.org/components/ti/TMS9900/TMS9918A_TMS9928A_TMS9929A_Video_Display_Processors_Data_Manual_Nov82.pdf |title=TMS9918A/TMS9928A/TMS9929A Video Display Processors Data Manual |date=November 1982 |publisher=Texas Instruments |pages=2-17}}</ref>

====Datasheet values====
The TMS9918 has a fixed [[Palette (computing)|16-color palette]], composed of 15 displayed colors and a "transparent" color.
* When "transparent" is used for sprites, it will show the graphics plane.
* When "transparent" is used for the text/graphics plane, it will show the backdrop.
* When "transparent" is used for the backdrop, it will show the external video signal (if enabled) otherwise black.

According to "Table 2.3 - Color Assignments" on the datasheet outputs levels are the following:<ref name=":1" />

{| class="wikitable sortable centered"
! rowspan="2" |Color code
! rowspan="2" |Color
! colspan="2" |TMS9918A
! colspan="3" |TMS9928A/9929A
|-
![[Luminance]]
![[Chrominance]]
![[YCbCr|Y]]
![[YCbCr|U]]
![[YCbCr|V]]
|-
| style="text-align: center; background:#000000; color:white" | 1
|                                                                black
| style="text-align: right ;" | 0%
| style="text-align: right ;" | -
| style="text-align: right ;" | 0%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 47%
|-
| style="text-align: center; background:#008000" | 2
|                                                                medium green
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 20%
| style="text-align: right ;" | 7%
|-
| style="text-align: center; background:#90EE90" | 3
|                                                                light green
| style="text-align: right ;" | 67%
| style="text-align: right ;" | 40%
| style="text-align: right ;" | 67%
| style="text-align: right ;" | 27%
| style="text-align: right ;" | 17%
|-
| style="text-align: center; background:#000080; color:white" | 4
|                                                                dark blue
| style="text-align: right ;" | 40%
| style="text-align: right ;" | 60%
| style="text-align: right ;" | 40%
| style="text-align: right ;" | 100%
| style="text-align: right ;" | 40%
|-
| style="text-align: center; background:#ADD8E6; color:white" | 5
|                                                                light blue
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 93%
| style="text-align: right ;" | 43%
|-
| style="text-align: center; background:#8B0000; color:white" | 6
|                                                                dark red
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 30%
| style="text-align: right ;" | 83%
|-
| style="text-align: center; background:#00FFFF" | 7
|                                                                cyan
| style="text-align: right ;" | 67%
| style="text-align: right ;" | 60%
| style="text-align: right ;" | 73%
| style="text-align: right ;" | 70%
| style="text-align: right ;" | 0%
|-
| style="text-align: center; background:#FF0055" | 8
|                                                                medium red
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 60%
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 27%
| style="text-align: right ;" | 93%
|-
| style="text-align: center; background:#FF6666" | 9
|                                                                light red
| style="text-align: right ;" | 67%
| style="text-align: right ;" | 60%
| style="text-align: right ;" | 67%
| style="text-align: right ;" | 27%
| style="text-align: right ;" | 93%
|-
| style="text-align: center; background:#808000" | 10
|                                                                dark yellow
| style="text-align: right ;" | 73%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 73%
| style="text-align: right ;" | 7%
| style="text-align: right ;" | 57%
|-
| style="text-align: center; background:#FFFF80" | 11
|                                                                light yellow
| style="text-align: right ;" | 80%
| style="text-align: right ;" | 33%
| style="text-align: right ;" | 80%
| style="text-align: right ;" | 17%
| style="text-align: right ;" | 57%
|-
| style="text-align: center; background:#008000; color:white" | 12
|                                                                dark green
| style="text-align: right ;" | 46%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 23%
| style="text-align: right ;" | 13%
|-
| style="text-align: center; background:#FF00FF; color:white" | 13
|                                                                magenta
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 40%
| style="text-align: right ;" | 53%
| style="text-align: right ;" | 67%
| style="text-align: right ;" | 73%
|-
| style="text-align: center; background:#808080" | 14
|                                                                gray
| style="text-align: right ;" | 80%
| style="text-align: right ;" | -
| style="text-align: right ;" | 80%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 47%
|-
| style="text-align: center; background:#FFFFFF" | 15
|                                                                white
| style="text-align: right ;" | 100%
| style="text-align: right ;" | -
| style="text-align: right ;" | 100%
| style="text-align: right ;" | 47%
| style="text-align: right ;" | 47%
|}

''Notes: Colors are merely illustrative, and were converted from the YUV values (MS9928A/9929A) to [[sRGB]] taking into account [[Gamma correction]]. [[NTSC#SMPTE C|SMPTE C]] colorimetry was not taken into account - see the next section for alternate color conversions.''

====CRT display====
{{Original research inline|date=May 2021}}

Converting Y, R-Y and B-Y to RGB requires considering how Y originated:
  Y = R * 0.30 + G * 0.59 + B * 0.11

This leads to the following formulas:
  R = R-Y + Y
  B = B-Y + Y
  G = (Y - 0.30 * R - 0.11 * B) / 0.59

But for all colors that have no chrominance - thus black, gray and white - R-Y and B-Y are not 0% but all have an offset of 47%. So this offset has to be subtracted from all R-Y and B-Y values at first. Due to the fact that in practice this one step will never be done alone, it's no problem that some results will be negative:

{| class="wikitable"
|-
!Color code
!Color
!Y
!R-Y
!B-Y
|-
| style="text-align: center;"                  | 1
|                                                black
| style="text-align: right ;"                  | 0%
| style="text-align: right ;"                  | 0%
| style="text-align: right ;"                  | 0%
|-
| style="text-align: center;"                  | 2
|                                                medium green
| style="text-align: right ;"                  | 53%
| style="text-align: right ;"                  | -40%
| style="text-align: right ;"                  | -27%
|-
| style="text-align: center;"                  | 3
|                                                light green
| style="text-align: right ;"                  | 67%
| style="text-align: right ;"                  | -30%
| style="text-align: right ;"                  | -20%
|-
| style="text-align: center;"                  | 4
|                                                dark blue
| style="text-align: right ;"                  | 40%
| style="text-align: right ;"                  | -7%
| style="text-align: right ;"                  | 53%
|-
| style="text-align: center;"                  | 5
|                                                light blue
| style="text-align: right ;"                  | 53%
| style="text-align: right ;"                  | -4%
| style="text-align: right ;"                  | 46%
|-
| style="text-align: center;"                  | 6
|                                                dark red
| style="text-align: right ;"                  | 47%
| style="text-align: right ;"                  | 36%
| style="text-align: right ;"                  | -17%
|-
| style="text-align: center;"                  | 7
|                                                cyan
| style="text-align: right ;"                  | 73%
| style="text-align: right ;"                  | -47%
| style="text-align: right ;"                  | 23%
|-
| style="text-align: center;"                  | 8
|                                                medium red
| style="text-align: right ;"                  | 53%
| style="text-align: right ;"                  | 46%
| style="text-align: right ;"                  | -20%
|-
| style="text-align: center;"                  | 9
|                                                light red
| style="text-align: right ;"                  | 67%
| style="text-align: right ;"                  | 46%
| style="text-align: right ;"                  | -20%
|-
| style="text-align: center;"                  | 10
|                                                dark yellow
| style="text-align: right ;"                  | 73%
| style="text-align: right ;"                  | 10%
| style="text-align: right ;"                  | -40%
|-
| style="text-align: center;"                  | 11
|                                                light yellow
| style="text-align: right ;"                  | 80%
| style="text-align: right ;"                  | 10%
| style="text-align: right ;"                  | -30%
|-
| style="text-align: center;"                  | 12
|                                                dark green
| style="text-align: right ;"                  | 47%
| style="text-align: right ;"                  | -34%
| style="text-align: right ;"                  | -24%
|-
| style="text-align: center;"                  | 13
|                                                magenta
| style="text-align: right ;"                  | 53%
| style="text-align: right ;"                  | 26%
| style="text-align: right ;"                  | 20%
|-
| style="text-align: center;"                  | 14
|                                                gray
| style="text-align: right ;"                  | 80%
| style="text-align: right ;"                  | 0%
| style="text-align: right ;"                  | 0%
|-
| style="text-align: center;"                  | 15
|                                                white
| style="text-align: right ;"                  | 100%
| style="text-align: right ;"                  | 0%
| style="text-align: right ;"                  | 0%
|}

Next comes the conversion to RGB. All results must be in the range from 0% to 100%:

{| class="wikitable"
|-
!Color code
!Color
!R
!G
!B
|-
| style="text-align: center;"                  | 1
|                                                black
| style="text-align: right ;"                  | 0%
| style="text-align: right ;"                  | 0.0000%
| style="text-align: right ;"                  | 0%
|-
| style="text-align: center;"                  | 2
|                                                medium green
| style="text-align: right ;"                  | 13%
| style="text-align: right ;"                  | 78.3729%
| style="text-align: right ;"                  | 26%
|-
| style="text-align: center;"                  | 3
|                                                light green
| style="text-align: right ;"                  | 37%
| style="text-align: right ;"                  | 85.9831%
| style="text-align: right ;"                  | 47%
|-
| style="text-align: center;"                  | 4
|                                                dark blue
| style="text-align: right ;"                  | 33%
| style="text-align: right ;"                  | 33.6780%
| style="text-align: right ;"                  | 93%
|-
| style="text-align: center;"                  | 5
|                                                light blue
| style="text-align: right ;"                  | 49%
| style="text-align: right ;"                  | 46.4576%
| style="text-align: right ;"                  | 99%
|-
| style="text-align: center;"                  | 6
|                                                dark red
| style="text-align: right ;"                  | 83%
| style="text-align: right ;"                  | 31.8644%
| style="text-align: right ;"                  | 30%
|-
| style="text-align: center;"                  | 7
|                                                cyan
| style="text-align: right ;"                  | 26%
| style="text-align: right ;"                  | 92.6102%
| style="text-align: right ;"                  | 96%
|-
| style="text-align: center;"                  | 8
|                                                medium red
| style="text-align: right ;"                  | 99%
| style="text-align: right ;"                  | 33.3390%
| style="text-align: right ;"                  | 33%
|-
| style="text-align: center;"                  | 9
|                                                light red
| style="text-align: right ; background: red;" | 113%
| style="text-align: right ;"                  | 53.9492%
| style="text-align: right ;"                  | 47%
|-
| style="text-align: center;"                  | 10
|                                                dark yellow
| style="text-align: right ;"                  | 83%
| style="text-align: right ;"                  | 75.3729%
| style="text-align: right ;"                  | 33%
|-
| style="text-align: center;"                  | 11
|                                                light yellow
| style="text-align: right ;"                  | 90%
| style="text-align: right ;"                  | 80.5085%
| style="text-align: right ;"                  | 50%
|-
| style="text-align: center;"                  | 12
|                                                dark green
| style="text-align: right ;"                  | 13%
| style="text-align: right ;"                  | 68.7627%
| style="text-align: right ;"                  | 23%
|-
| style="text-align: center;"                  | 13
|                                                magenta
| style="text-align: right ;"                  | 79%
| style="text-align: right ;"                  | 36.0508%
| style="text-align: right ;"                  | 73%
|-
| style="text-align: center;"                  | 14
|                                                gray
| style="text-align: right ;"                  | 80%
| style="text-align: right ;"                  | 80.0000%
| style="text-align: right ;"                  | 80%
|-
| style="text-align: center;"                  | 15
|                                                white
| style="text-align: right ;"                  | 100%
| style="text-align: right ;"                  | 100.0000%
| style="text-align: right ;"                  | 100%
|}

The erroneous value of 113% for R of color "light red" might seem to come from a typo within the datasheet and there R-Y must not be greater than 80%. But measuring the output signals of the chip with an [[oscilloscope]] shows that all values in the table are correct. So the error is inside the chip and drives the red signal into saturation. For this reason this value is to be corrected to 100%.

Up to that time only [[Cathode-ray tube|cathode ray tubes]] had been available for computer monitors as well as for televisions, and that these CRTs had a [[Gamma correction|gamma]]. The TMS9918 series chips had been designed to work with televisions and their CRTs had a [[Gamma correction|gamma]] of 1.6 (remark: CRTs of [[Macintosh]] monitors had 1.8 and the CRTs of PC monitors had 2.2). Digital flat panels do not have [[Gamma correction|gamma]]. For this reason the colors of the TMS9918 look somewhat pale here as in the first table above. The below table uses the gamma-corrected values, which are (written in hexadecimal):

{| class="wikitable"
|-
!Color code
!Color
!R
!G
!B
|-
| style="text-align: center; background:#000000; color:white"         | 1
|                                                                       black
|                                                                       00
|                                                                       00
|                                                                       00
|-
| style="text-align: center; background:#0AAD1E"                      | 2
|                                                                       medium green
|                                                                       0A
|                                                                       AD
|                                                                       1E
|-
| style="text-align: center; background:#34C84C"                      | 3
|                                                                       light green
|                                                                       34
|                                                                       C8
|                                                                       4C
|-
| style="text-align: center; background:#2B2DE3; color:white"         | 4
|                                                                       dark blue
|                                                                       2B
|                                                                       2D
|                                                                       E3
|-
| style="text-align: center; background:#514BFB; color:white"         | 5
|                                                                       light blue
|                                                                       51
|                                                                       4B
|                                                                       FB
|-
| style="text-align: center; background:#BD2925; color:white"         | 6
|                                                                       dark red
|                                                                       BD
|                                                                       29
|                                                                       25
|-
| style="text-align: center; background:#1EE2EF"                      | 7
|                                                                       cyan
|                                                                       1E
|                                                                       E2
|                                                                       EF
|-
| style="text-align: center; background:#FB2C2B"                      | 8
|                                                                       medium red
|                                                                       FB
|                                                                       2C
|                                                                       2B
|-
| style="text-align: center; background:#FF5F4C"                      | 9
|                                                                       light red
|                                                                       FF
|                                                                       5F
|                                                                       4C
|-
| style="text-align: center; background:#BDA22B"                      | 10
|                                                                       dark yellow
|                                                                       BD
|                                                                       A2
|                                                                       2B
|-
| style="text-align: center; background:#D7B454"                      | 11
|                                                                       light yellow
|                                                                       D7
|                                                                       B4
|                                                                       54
|-
| style="text-align: center; background:#0A8C18; color:white"         | 12
|                                                                       dark green
|                                                                       0A
|                                                                       8C
|                                                                       18
|-
| style="text-align: center; background:#AF329A; color:white"         | 13
|                                                                       magenta
|                                                                       AF
|                                                                       32
|                                                                       9A
|-
| style="text-align: center; background:#B2B2B2"                      | 14
|                                                                       gray
|                                                                       B2
|                                                                       B2
|                                                                       B2
|-
| style="text-align: center; background:#FFFFFF"                      | 15
|                                                                       white
|                                                                       FF
|                                                                       FF
|                                                                       FF
|}

The used steps are: Round all values to two decimal places, then raise to the power of 1.6 for [[gamma correction]] and finally transform the range of values from 0...100 to 0...255.

==Specifications==
* Video RAM: direct wiring to 4, 8, or 16 KB
* Text modes: 40 × 24 and 32 × 24
* Resolution: 256 × 192
* Colours: 15 colours + transparent
* Sprites: 32, 1 colour, max 4 per horizontal line

==Legacy==

Texas Instruments' TMS9918A was succeeded the [[Yamaha V9938]], which added additional bitmap modes, more colorful [[sprite (computer graphics)|sprites]], a vertical full-screen scroll register, vertical and horizontal offset registers, a hardware [[blitter]] and a customizable [[palette (computing)|palette]]. The V9938 was designed for the [[MSX|MSX2]] standard of computers, and later used in a third-party upgrade to the [[TI-99/4A]]: the [[Geneve 9640]] "computer-on-a-card". 

The V9938, in turn, was succeeded by the [[Yamaha V9958|V9958]], which added some additional [[High color|high-colour]] modes and a horizontal two-page scroll register, these chips were used in the MSX2+/[[MSX turboR|turboR]] systems.

[[Toshiba]] made a [[Clone (computing)|clone]] called the T6950 and does not support the undocumented pattern / color table masking feature in graphics 2 mode.<ref>{{Cite web|url=http://www.msx.org/forum/development/msx-development/undocumented-mode-1-2-polldiscussion?page=1|title=Undocumented Mode 1 + 2 : Poll/Discussion &#124; MSX Resource Center (Page 2/4)}}</ref>{{better source needed|date=November 2015|reason=The provided source is a forum posting, which is a self-published source}} Later, Toshiba released the T7937A [[MSX-Engine]] with a built-in VDP and fixed the masking features. Both VDPs by Toshiba feature a slightly different palette than the Texas VDPs, with more vivid colors.

The VDP of the [[Master System]] game console is a development of the TMS9918.  This was further evolved into the VDP of the [[Sega Genesis|Sega Genesis/Mega Drive]] game console, which added more capable graphics modes but eliminated all but the most capable graphics mode from the Master System VDP.

==See also==
* [[TMS34010]], a 1986 microprocessor with dedicated graphics instructions
* [[Atari 8-bit computers]] have comparable graphics hardware introduced the same year
* [[Motorola 6845]], a display controller widely used in 8-bit computers
* [[Motorola 6847]]
* [[Yamaha V9938]]
* [[Yamaha V9958]]
* [[List of 8-bit computer hardware graphics]]

==References==
{{reflist}}

==External links==
* [https://web.archive.org/web/20180717212934/https://emu-docs.org/VDP%20TMS9918/Datasheets/TMS9918.pdf Datasheet]
* [http://map.grauw.nl/resources/video/ti-vdp-programmers-guide.pdf Programmers Guide]
* [http://codehackcreate.com/archives/30 F18A Modern Replacement]
* [https://cdn.hackaday.io/files/5789247676576/9918-SRAM.pdf SRAM Replacement for TMS9x18 VRAM]

[[Category:Computer-related introductions in 1979]]
[[Category:Graphics chips]]
[[Category:TI-99/4A]]
[[Category:Coleco consoles]]
[[Category:Texas Instruments hardware]]
[[Category:MSX hardware]]