  _______ _______ ______ _______ _______      _____   _______ ___ ___ _______ 
 |    ___|_     _|   __ \     __|_     _|    |     |_|       |   |   |    ___|
 |    ___|_|   |_|      <__     | |   |      |       |   -   |   |   |    ___|
 |___|   |_______|___|__|_______| |___|      |_______|_______|\_____/|_______|

                     An Overlanders / The Union production

Released at: Silly Venture 2020+1 in Gdansk (PL)
Release date: 20/08/2021 (V1.0)

Coders: RATI/OVR & Janek/OVR
Graphics & Design: Mic/Dune
Union logo: ES/The Exceptions 
Music & Sound FX: Jess/OVR
Dev Toolchain: Mr Bee/OVR
Pong Sound Driver: Ben/OVR
Guest writer: Cronos/Quartermass Xperiment

HDD_VERSION: 28/05/2022
. Released at GEMTOS Atari convention in St-Just-en-Chaussee (France)

v1.3: 10/10/2021
. Fix: syncscroll now working with the 2 shifters status in WS2 (thanks go to
       SPKR/SMFX for reporting the bug. Thanks to Troed/SYNC for confirming that
       our fix is the only one we can apply at the moment)
. Thanks to v1.3 tester: SPKR

v1.2: 19/09/2021
. Upd: now runs with Saint emulator (thanks Leonard/OXG for the blind guess)
. Fix: bitplanes disalignment when entering Reset screen in STe (thanks
       Evil/DHS + SPKR/SMFX for the tip)
. Fix: ACIA IT not properly resetted (thanks SPKR/SMFX for catching the bug and 
       reporting to us)
. Fix: tile bug in Greetings part
. Thanks to v1.2 testers: SPKR, Leonard, Jade, Evil, Fury, Grey

===============================================================================
          _______ ______ _____        _______ ___ ___ _______ ______ 
         |   |   |   __ \     |_     |     __|   |   |    |  |      |
         |       |   __ <       |    |__     |\     /|       |   ---|
         |___|___|______/_______|    |_______| |___| |__|____|______|
                                                            
Released at: Silly Venture 2020+1 in Gdansk (PL)
Release date: 20/08/2021
Coding date: 18/07/2020

Coders: RATI/OVR & Ben/OVR

The initial idea was to find a way to replicate what Gunstick/ULM showed in a
Facebook video in which we can see the HBL jittering compensation in 2020. 

We share hereby our way to do it with all the explanations we could derive from
our research. We are certainly wrong on some points. Do not hesitate to correct
us. 

Notes:
. original proof that it was possible elaborated by Ijor and LJBK
. Troed/SYNC was the very first who did succeed to implement this concept on a
  real machine

Files: 
- HBLSYNC.S: library that contains the vbl/hbl jittering code with detailed
              explanations
- MAIN.S: main program that leverages the library above to illustrate how to 
           use it
- VBLHBLSQ.PI1: diagram detailing the concept
- MAIN.PRG: pre assembled executable

===============================================================================

              $$ $$$$$ $$
              $$ $$$$$ $$
             .$$ $$$$$ $$.
             :$$ $$$$$ $$:
             $$$ $$$$$ $$$
             $$$ $$$$$ $$$                               
            ,$$$ $$$$$ $$$.                              Be strong !
           ,$$$$ $$$$$ $$$$.                             Be smart !
          ,$$$$; $$$$$ :$$$$.                            Be ATARI !
         ,$$$$$  $$$$$  $$$$$.
       ,$$$$$$'  $$$$$  `$$$$$$.
     ,$$$$$$$'   $$$$$   `$$$$$$$.
  ,s$$$$$$$'     $$$$$     `$$$$$$$s.
$$$$$$$$$'       $$$$$       `$$$$$$$$$
$$$$$Y'          $$$$$          `Y$$$$$