QuarkTex NG 1.1
===============
QuarkTex NG gives AmigaOS in WinUAE hardware accelerated 3D: Warp3D,
StormMESA (agl.library), MiniGL, OpenGL ES 2.0 (ogles2.library) and
OpenGL ES 3.0/3.1 (ogles3.library) programs draw with the PC's graphics
card through OpenGL, instead of the emulated CPU drawing every pixel.
It is an independent continuation of QuarkTex, the 3D virtualization
solution Robert Konrad released in 2003 (driver/video/QuarkTex, last
version 0.53), under the same license, the GNU LGPL v3.
Thanks to R-Typer and Ladislawv
-------------------------------
ogles2.library and ogles3.library implement the interfaces of the PiStorm
ogles2.library and ogles3.library and their SDKs, made by R-Typer and
Ladislawv for the PiStorm with a Raspberry Pi 4:
ogles2 OpenGL ES 2.0 https://github.com/ladislawv/ogles2 (SDK 1.3)
ogles3 OpenGL ES 3.1 https://github.com/ladislawv/ogles3 (release 1.0)
QuarkTex NG's libraries are built against their SDKs' headers and tested
with their examples and demos, so programs written for their libraries
also run in WinUAE. Many thanks to both of them.
What is new in 1.1
------------------
- New ogles3.library: OpenGL ES 3.0 and 3.1, the interface of the PiStorm
ogles3.library 1.0 by R-Typer and Ladislawv, on the PC's OpenGL 4.3.
All 380 entries of its table: GLSL ES 3.00/3.10 shaders, vertex array
objects, uniform buffers, instancing, transform feedback, queries,
samplers, 3D and array textures, multiple render targets, and ES 3.1's
compute shaders, storage buffers, atomic counters, images, indirect
draws and dispatches, separate shader programs, multisample textures.
The ogles3 1.0 demos (Boing 2026, Boing Ocean, Boing Swarm, Juggler RT)
run unchanged, in a window and fullscreen. As the PiStorm library, a
context is OpenGL ES 3.1 unless it asks for 2.0.
- ogles2.library:
- Faster drawing from vertex buffers: the host keeps their converted
copies and converts only what a draw reads and what changed. Quake III
"timedemo four": 98 fps against 83 fps with 1.0 beta 3 on the same PC.
- Every entry of the SDK is there now: ETC1 compressed textures (ETC2
and EAC too in ogles3), GL_KHR_debug, glMultiDraw*EXT, base vertex
draws, glClipControlEXT (with an OpenGL 4.5 driver).
- OGLES2_CCT_SHARE_WITH: contexts share textures, buffers, shaders,
programs and renderbuffers.
- Contexts on a bitmap (OGLES2_CCT_BITMAP, aglSetBitmap) and resizing
with aglSetParams2 work and are tested.
- The dispatch table's calls go to the context they are given: a second
task can draw with its own context.
- Framebuffer 0 is the context's picture: programs that draw into a
texture and then bind framebuffer 0 again show their frames.
- minigl.library 30.0: MiniGL's 30 SDK (PiStorm3D 30.0), same interface
as the 29 SDK.
- agl.library: contexts on a rastport (AMA_RastPort, AMA_Screen), as
StormMESA allowed.
- Windows in front of a 3D window stay as they are: frames are written
only into the visible parts of a window.
- QuarkTexNGCheck.exe: tells whether the PC's graphics driver can run
QuarkTex NG.
- The host uses OpenGL 4.3 (3.3 still runs everything but OpenGL ES 3.1).
- Libraries and DLLs of this release only work with each other: install
all of them.
What is new since QuarkTex 0.53
-------------------------------
- Runs in 64-bit WinUAE as well (0.53 needed the 32-bit one).
- Commands go to the host in batches instead of one emulator call per
OpenGL function; Warp3D is drawn on the host with a modern OpenGL.
- New minigl.library: MiniGL games such as Return to Castle Wolfenstein,
Jedi Knight II, OpenLara and Hurrican run on the host's OpenGL, with
multitexture, paletted textures and vertex arrays drawn by the host.
- New ogles2.library and ogles3.library (OpenGL ES 2.0, 3.0 and 3.1).
- Frames are written into the Amiga's RTG display memory, so the 3D picture
shows in a window, a full window and fullscreen, scaled and filtered by
WinUAE like any other Amiga graphics (0.53: windowed mode only).
- Several 3D programs can draw at the same time, each in its own window.
- Stencil buffer, chroma keying, mipmaps and several 3D contexts at once.
- Fixed: black fog, wrong texture colours, ignored palettes and texture
updates, broken Z-buffer reads and writes, depth writes that could not be
turned off, leaked textures, W3D_Query answers.
Performance (Intel Iris Xe, 68040/68060 with JIT)
-------------------------------------------------
Warp3D, 1.2 million triangles QuarkTex 0.53 1.34 s, QuarkTex NG 0.39 s
RTCW at 640x480, no frame cap MiniGL Classic on Warp3D 157 fps,
QuarkTex NG minigl.library about 170 fps
RTCW, data per frame to host 1.37 MB before, 22 KB now
Quake III GLES2, timedemo four PiStorm with Raspberry Pi 4 80.4 fps,
at 640x480 QuarkTex NG 1.0 beta 3: 79.0 (window),
83.6 (fullscreen)
Requirements
------------
- Windows with a graphics card and driver for OpenGL 4.3 (with 3.3 only,
everything but OpenGL ES 3.1 runs; QuarkTexNGCheck.exe tells).
- WinUAE (tested with 6.0.3 and the 6.x betas), 32-bit or 64-bit.
- AmigaOS 3.x, a 68020 or better with FPU (68040/68060 recommended),
Picasso96 with an RTG board (uaegfx).
Installation
------------
0. Run QuarkTexNGCheck.exe on the PC. It shows the graphics card, driver,
OpenGL and GLSL versions and ends with "QuarkTex NG support = PASS" if
the driver can run QuarkTex NG (OpenGL 4.3 core profile), or FAIL and
why. Double-clicked it opens a window; in a command prompt it prints
the report.
1. Copy the two files in WinUAE/ (quarktexng-windows-x86.dll and
quarktexng-windows-x86-64.dll) into your WinUAE directory, next to
winuae.exe and winuae64.exe (or into its plugins directory).
2. Copy the five files in Libs/ (Warp3D.library, agl.library,
minigl.library, ogles2.library, ogles3.library) to LIBS: on your Amiga.
Keep copies of the libraries you replace. The libraries and the DLLs
belong together.
3. Set up WinUAE as below.
WinUAE settings
---------------
Required:
- Settings, Host, Miscellaneous: "Allow native code" (native_code=true).
- Settings, Hardware, CPU and FPU: FPU "CPU internal" with the precision
"Host (80-bit)" (fpu_msvc_long_double=true). With the default 64-bit
emulation games compute values a real 68k FPU does not: in Jedi Knight II
the first person weapon never shows, in RTCW it disappears. The libraries
check this and write a warning into QuarkTexNGLog.txt.
Recommended:
- CPU 68040 or 68060 at "Fastest possible".
- JIT on, cache size 16 MB (cachesize=16384), JIT "FPU support" on
(compfpu=true). The games themselves run on the emulated 68k: with the
JIT FPU off, Jedi Knight II fell from 90 to about 15 fps.
- RTG board UAE Zorro III, 64 MB or more (needed for fullscreen).
- Z3 Fast RAM, 256 MB or more for large games.
README.md in the archive explains every setting and has the full
performance tables.
Known issues
------------
- MiniGL Classic (the Warp3D based minigl.library) crashes in fullscreen on
QuarkTex NG's Warp3D.library. Use the minigl.library of this archive.
- On planar or 8-bit screens the 3D picture is drawn in a window of its own
over WinUAE, which shows only while WinUAE runs in a window.
- The rotating passport in OpenLara's menu draws dark.
- A smart refresh window's parts hidden behind other windows are not
updated while they are covered.
- ogles2/ogles3.library: no shader or program binary formats;
glClipControlEXT needs an OpenGL 4.5 driver; VSYNC and multisampling of
the default framebuffer are ignored.
- Breaking Quake III (ogles2) with Ctrl-C during play reset the Amiga; a
normal quit does not.
License and source
------------------
QuarkTex (C) 2003-2012 Robert Konrad.
QuarkTex NG, changes and additions since 2026 (C) Serkan DURSUN.
Both are released under the GNU Lesser General Public License version 3
(License.txt), which builds on the GNU General Public License version 3
(COPYING). QuarkTex NG is a modified version of QuarkTex and is not made or
endorsed by its original author.
ogles2.library and ogles3.library implement the interfaces of the PiStorm
ogles2.library and ogles3.library and their SDKs by R-Typer and Ladislawv
(github.com/ladislawv/ogles2, github.com/ladislawv/ogles3).
The notices of the parts made by others, among them the mingw-w64 runtime
in the host DLLs, are in ThirdParty.txt.
The source code of this release is in Source/ and on
https://github.com/Sdursun/QuarkTexNG. Left out of Source/ are Warp3D.h
and Warp3D.fd, the Warp3D API includes, (C) 1998 Sam Jordan, Hans-Joerg
Frieden and Thomas Frieden, which are not under the LGPL: building needs
them from QuarkTex's original repository, as
Source/Warp3D.library/Warp3D-includes.txt explains. Amigamesa.h is from
Mesa 1.2, (C) 1995 Brian Paul, LGPL v2 or later. Building minigl.library
needs MiniGL's SDK, (C) Hyperion under the Hyperion MiniGL Open Source
License, which is not included; building ogles2.library and ogles3.library
needs the ogles2 and ogles3 SDKs (MIT headers), not included either.
Archive contents
----------------
QuarkTexNG/QuarkTexNG.readme this file
QuarkTexNG/ReadMe.txt installation and settings in short
QuarkTexNG/README.md full documentation
QuarkTexNG/License.txt GNU LGPL v3
QuarkTexNG/COPYING GNU GPL v3
QuarkTexNG/ThirdParty.txt notices of the parts made by others
QuarkTexNG/QuarkTexNGCheck.exe checks the PC's OpenGL for QuarkTex NG
QuarkTexNG/Libs/ Warp3D.library, agl.library, minigl.library,
ogles2.library, ogles3.library
QuarkTexNG/WinUAE/ the host DLLs for 32- and 64-bit WinUAE
QuarkTexNG/Source/ source code of this release (without the
Warp3D API includes, see above)
History
-------
1.1 New ogles3.library (OpenGL ES 3.0/3.1); faster ogles2 buffers,
every ogles2 entry, shared contexts, bitmap contexts;
minigl.library 30.0; agl rastport contexts; windows in front of
3D windows kept; QuarkTexNGCheck.exe; host on OpenGL 4.3.
1.0beta3 New ogles2.library (OpenGL ES 2.0); several 3D programs at once;
fullscreen screens in the mode of their size; Warp3D screen mode
fixes; no FPU requester.
1.0beta2 minigl.library moved to MiniGL's 29 SDK (PiStorm3D 29.1): lighting,
normal arrays, a GLU and GLUT subset. Programs built on an older
MiniGL SDK need recompiling against the 29 SDK.
1.0beta First release of QuarkTex NG.
|