Editing Calico

{{InfoboxSoftware
|name = Calico
|port = Calico
|title = Calico
|screenshot = [[File:CalicoE1M1.png|200px]]
|caption = A view of {{maplinkgen|MAP01|Hangar|Console Doom}}.
|standard = [[Atari Jaguar|Jaguar Doom]]
|developer = [[James Haley (Quasar)]]
|baseparent = Jaguar Doom
|initialversion = 1.0
|initialdate = 2017-04-30
|programming language = {{wp|C (programming language)|C}}, {{wp|C++}}
|status = Active
|platform = Cross-Platform
|language = English (United States)
|license = {{wp|MIT License}}
|repotype = git
|repourl = [https://github.com/team-eternity/calico-doom GitHub]
|ircchannel = [irc://irc.oftc.net/noteternityenginerelated OFTC #noteternityenginerelated]
}}
'''Calico''' is a [[source port]] based on the [[Atari Jaguar]] version of [[Doom]] by [[James Haley (Quasar)]], a back port which allows playing that version of the game on {{wp|Microsoft Windows}}, [[Linux]], and {{wp|macOS|Mac}} personal computers. Developed under a philosophy similar to that of [[Chocolate Doom]], it aims to preserve the original version with maximum fidelity and compatibility.

==Features==
Calico allows playing the Atari Jaguar version of Doom when provided with either a {{wp|ROM image}} (legally obtainable via use of a backup device), or the extracted [[IWAD]] file from inside it (these files should be named {{c|doom.jag}} or {{c|jagdoom.wad}}, respectively, in order to be autodetected - use of the {{c|-file}} [[command-line switch]] is also supported).

Calico utilizes [[render to texture]] via {{wp|OpenGL}} to provide a scalable window with optional hardware filtering and support for variable [[aspect ratio]]. The latter is particularly useful for authenticity's sake, since different television sets displayed the game's signal differently.

As of the v2.0 release, support for intermission music and network games is not yet present, but is planned for a future release. Music support is now present in the development tree, contributed by [[Erick Vásquez García (Erick194)]], but has not yet been included in a release.

==Development==
Returning the code base from the Jaguar game console back to the PC required replacement of all of the {{wp|GNU Assembler|GAS}} assembly-language modules targeted at the Tom and Jerry Jaguar processors with equivalent portable logic written in {{wp|C (programming language)|C}}. The recent release of the [[3DO]] source code by [[Rebecca Heineman]] proved useful, as the game logic portions of that port's code are largely identical to the Jaguar code in terms of logic (the Jaguar code was originally written in C, and then compiled and hand-tuned as assembly - other ports based on the Jaguar version use this original C code as their basis). The [[Doom64 EX]] port by [[Samuel Villarreal (Kaiser)]] also proved useful for additional verification. Portions of both of these code bases were used directly where the logic was identical or only required minor modifications.

For making the rendering functional, it was necessary to reverse engineer the assembly directly and thoroughly in most cases, since the other available code bases use different rendering approaches, particularly in the later phases of scene generation.

Extensive code is also used from [[KEX 2]] and the [[Eternity Engine]] to provide OpenGL rendering, library utilities, and integration with the {{wp|Simple DirectMedia Layer|SDL}} library.

===History===
On June 10, 2020, Doomworld user Vic Vos {{dwforumsp|id=2141090|title=built}} a 64-bit version based on the latest commit and published it to the development thread.

v2.0 was released on January 31, 2021, adding mouse and gamepad support, an OpenGL 4.0 shader-based renderer, and a setup utility based on chocolate-setup called the Calico Configurator.

==Trivia==
* In keeping with the cat-based theme of the Atari Jaguar, the name "calico" was chosen in honor of Quasar's late cat, [http://eternity.mancubus.net/nikki/ Nikki].

==External links==
* {{idgames|file=source/calico10|Version 1.0 release}}
* [https://github.com/team-eternity/calico-doom/releases/tag/v2.0 v2.0 release], hosted on {{wp|GitHub}}
* {{dwforums|id=91624|title=Development thread}} at [[Doomworld]]
* [https://github.com/team-eternity/calico-doom Calico git repository], hosted on GitHub
* [https://github.com/team-eternity/calico-config/ Calico Configurator repository]

{{s-start}}
{{s-port}}
{{s-cond}}
{{s-bef-cond|before=[[Atari Jaguar]]}}
{{s-ttl|title=Calico}}
{{s-aft-cond|after=[[Doom 32X: Resurrection]]}}
{{s-end}}

[[Category:Doom ports]]
[[Category:Source ports by name]]
[[Category:Console-based ports]]