

-------------------------------------------------------------------------------


         _   __        _     _ _      ____ _
        / | / /__     | |__ (_) |_   / ___| |__   ___  ___ ___  ___
        | |/ /_  )____| '_ \| | __| | |   | '_ \ / _ \/ _ \ __|/ _ \
        |_/ / / /_____| |_) | | |_  | |___| | | |  __/  __\__ \  __/
         /_/ /___|    |_.__/|_|\__|  \____|_| |_|\___|\___|___/\___|



                         ___  _______
                        /   \/   (_) \
                       / _            \
                     _/ (_) _____      \
                    //     ´     \      \
                   //      |    .´       \
                   |\      ¨\__'_./       \
                   | \                ()   \    :::  1/2 - B I T   C H E E S E
                   |  \_____________________\
                   |  |                     |   :::  HBC.MANUJARVINEN.COM
                   |  |         _____,      |
             ,     |()|        /      \     |
            <_'    |  |       '        '    |
                   |  |       |     *  |    |   :::  Knits & Sips
          ___      |  |        \. ,'  /     |
         /___'      \ |         `----'      |   :::  REVISION '23
        /    ?       \|                     |
         ----'    _   '_____________________'
                 |_'



-------------------------------------------------------------------------------



                                     ________
                                     C R E W:

      Bercon       | HBC           |  Code, Graphics



                                     ____________
                                     T H A N K S:

      - HBC crew
      - iq - for his contributions to distance field raymarching and demoscene
      - Chorium - owner of RTX3070 - for render time testing
      - Ceramika Manufaktura - for inspiration to the teapot design,
                               "Polish Pottery White Flower on Blue Teapot"



                                     ________
                                     I N F O:

      While rendering, you see a black screen. Be patient and don't switch to
      another tab or window, that will pause the rendering. Unlikely to work on
      lower end graphics cards, because the shader compilation will crash.

      Measured render times:
      * Knits_n_Sips.html, under 15 seconds on GeForce 4090
      * Knits_n_Sips_low_quality.html, under 25 seconds on GeForce 3070

      1) Firefox, works out of the box

      * Drag & Drop Knits_n_Sips.html file into Firefox



      If you don't want to use Firefox, Chrome requires some tricks:

      You can run the intro via HTTP server or by starting Chrome with security
      off (see below why).

      2) Chrome with HTTP server approach

      For example if you have Node.js (nodejs.org) installed, here are step by
      step instructions:
      A)
          * Launch HTTP server by running "1_or_start_nodejs_http_server.bat"
      B)
          * In the folder where intro is located, hold shift and right click
            and select "Open PowerShell window here"
          *  Type: "npx http-server" to launch a web server

      * Open "localhost:8080"
      * Click "Knits_n_Sips.html" to render the image

      3) Chrome with security off approach

      A)
          * Launch Chrome via "2_or_start_chrome_with_security_off.bat"
      B)
          * Create a new Chrome shortcut with following options:
            --disable-web-security
            --user-data-dir="C:/Temp"

      * Drag & drop the Knits_n_Sips.html file into Chrome from Explorer and it
        should render.

      Why do I need to disable security?

      Chrome has a protection that prevents reading from "tainted" <canvas>.
      The intro is packed as PNG image file which is decoded by loading the
      contents into <canvas> and when the data originates from file:// address,
      it's always considered tainted by Chrome.

      - Bercon


                                     ____________
                                     G R E E T S:

                                     Adapt
                                     Ananasmurska
                                     cpdt
                                     iq
                                     Kali
                                     LLB / Ctrl-Alt-Test
                                     noby
                                     P01
                                     Tekotuotanto

