
Open-GL Stars 0.5.0.0520
___________________________________________________________________________
Tomasz Porosiski                  Plik ReadMe - Strona kodowa Windows 1250


Open-GL Stars to program do pomiaru wydajnoci kart graficznych, ktry
napisaem, aby sprawdzi moje umiejtnoci pisania w Open-GL'u dla 32
bitowych systemw Windows. Pocztkowo mia to by may projekt, ale
ewoluowa i doprowadzi do powstania penej aplikacji. Program rozwijany
jest ju od okoo roku, a udostpniany na zasadach freeware.

___________________________________________________________________________
1. GWNE ZALETY

- atwy w uyciu interfejs uytkownika, podobny do programw z systemu BeOS
- moliwo dowolnej zmiany rozdzielczoci i liczby kolorw (bit-depth) 
- moliwo renderingu w oknie (take nietypowe rozmiary) i na penym
  ekranie
- moliwo zmiany sposobu filtrowania tekstur (bilinear / bilinear+mipmaps
  / trilinear)
- moliwo regulacji jasnoci obrazu (gamma)
- pena obsuga MAPI
- moliwo modyfikacji bardzo wielu parametrw (nacinij "h", aby zobaczy
  pen list klawiszy)
- wszystkie ustawienia s dokonywane w jednym oknie i zapisywane
  w pliku .ini
- pena statystyka podczas renderingu (liczba klatek na sekund, trjktw
  na sekund i na klatk...)
- tryb benchmark (2000 klatek - animacja uzaleniona od klatki, wic za
  kadym razem zobaczysz 2000 identycznych obrazw, rny bdzie tylko czas
  wykonania testu - dokadnie tak jak w Quake'u 3 przy timedemo 1)
- ciekawe efekty 3d (np. lens-flare i czsteczki)
- moliwo robienia zrzutw ekranw (w formacie Targa) - wystarczy
  nacisn "s"
- szczegowy raport z dziaania programu i wyniki testw wywietlane
  w dwch osobnych oknach

Jeli chcesz przywrci domylne ustawienia programu - skasuj plik
"stars.ini", ktry znajduje si w katalogu programu.

___________________________________________________________________________
2. RZECZY, KTRE MUSISZ WIEDZIE ZANIM ZACZNIESZ...

To 'Oprogramowanie' jest darmowe. Moesz je rozpowszechnia pod warunkiem,
e nie bdziesz za to pobiera adnych opat i nie bdziesz go modyfikowa.
Mimo to prosz Ci o rejestracj, poniewa chciabym si dowiedzie gdzie
mj program dotrze. Rejestracja jest bardzo prosta - wylij e-mail
na adres: stars@stars.benchmark.pl.

Moesz uywa programu tylko do zastosowa osobistych, nie-komercyjnych.
Nie wczaj tego 'Oprogramowania' do swoich wasnych projektw bez
WYRANEJ I JEDNOZNACZNEJ PISEMNEJ ZGODY autora. Z gry dzikuj.

No dobrze, teraz moemy ju zacz...

___________________________________________________________________________
3. LISTA PLIKW

Pakiet dystrybucyjny zawiera:

Krtka nazwa |      Rozmiar |     Data |  Czas | Pena nazwa
-------------+--------------+----------+-------+-------------
STARS    EXE |      181 248 | 00.10.24 | 12:00 | stars.exe
BENCH    TGA |      262 188 | 00.10.24 | 12:00 | bench.tga
CHARS    TGA |       32 812 | 00.10.24 | 12:00 | chars.tga
END      TGA |       65 580 | 00.10.24 | 12:00 | end.tga
FLARE1   TGA |       16 428 | 00.10.24 | 12:00 | flare1.tga
FLARE2   TGA |       16 428 | 00.10.24 | 12:00 | flare2.tga
FLARE3   TGA |       16 428 | 00.10.24 | 12:00 | flare3.tga
FLARE    TGA |        1 068 | 00.10.24 | 12:00 | flare.tga
GLOW     TGA |       65 580 | 00.10.24 | 12:00 | glow.tga
INTRO    TGA |      262 188 | 00.10.24 | 12:00 | intro.tga
LOGO     TGA |      524 332 | 00.10.24 | 12:00 | logo.tga
OTHER    TGA |       65 580 | 00.10.24 | 12:00 | other.tga
SPACE    TGA |       65 580 | 00.10.24 | 12:00 | space.tga
STAR1    TGA |          300 | 00.10.24 | 12:00 | star1.tga
STAR2    TGA |          300 | 00.10.24 | 12:00 | star2.tga
STAR3    TGA |          300 | 00.10.24 | 12:00 | star3.tga
STARS    TXT |       14 723 | 00.10.24 | 12:00 | stars.txt
STARS-PL TXT |       17 646 | 00.10.24 | 12:00 | stars-pl.txt

___________________________________________________________________________
4. INSTALACJA

Rozpakuj plik z programem (przypuszczam, e ju to zrobie skoro czytasz
ten plik) do wybranego katalogu. To ju wszystko - jeli chcesz, moesz
jeszcze doda skrt na Pulpicie lub w Menu Start.

___________________________________________________________________________
5. DEINSTALACJA

Wystarczy skasowa katalog, do ktrego wczeniej rozpakowae pliki -
program w aden sposb nie zmienia konfiguracji systemu, a wszystkie
ustawienia zapisuje w pliku "stars.ini", ktry znajduje si w katalogu
programu.

___________________________________________________________________________
6. KLAWISZE

- nacinij "h", aby zobaczy pen list

Jeli masz kopoty ze zrozumieniem skrtowych opisw, oto one w troch
duszej postaci:

  1 - wcza/wycza rendering meteorw (to takie czerwono-biae na rodku)
  2 - wcza/wycza rendering gwiazd
  3 - wcza/wycza rendering czsteczek (te, "lataj" wok meteorw)
  4 - wcza/wycza rendering ta
  D - wcza/wycza dithering (moe poprawia jako obrazu w 16 bitach)
  T - wcza/wycza rysowanie trjktw (podobne do r_showtris w Quake'u)
  S - zapanie ekranu do pliku
  F - wcza/wycza wywoanie funkcji glFinish(), ktra wstrzymuje
      rendering do oprnienia wszystkich potokw sterownika Open-GL
  O - pokazuje/ukrywa okno informacji o sterowniku Open-GL
  H - pokazuje/ukrywa okno pomocy
  I - pokazuje/ukrywa statystyki i informacje
  X - pokazuje/ukrywa dodatkowe statystyki
  V - pokazuje wersj programu
  G - wcza/wycza tryb debug (moesz uywa strzaek oraz klawiszy PgDn
      i PgUp aby swobodnie obraca to)
  R - zatrzymuje rotacj w trybie debug
 =/- - zwiksza/zmniejsza odlego meteorw
 [/] - zwiksza/zmniejsza przezroczysto meteorw
 ;/' - zwiksza/zmniejsza liczb gwiazd
 ,/. - zwiksza/zmniejsza liczb meteorw
Spacja - zatrzymuje/wznawia animacj

Uwaga! Wszystkie klawisze s aktywne tylko w trybie demonstracyjnym.

___________________________________________________________________________
7. WYMAGANIA SPRZTOWE I PROGRAMOWE

Wymagania minimalne:
- dowolny PC z Windows 95/98/ME lub WindowsNT/2000 i sterownikiem Open-GL

Zalecany sprzt:
- procesor klasy PII lub AMD-K6II
- 16 MB pamici
- akcelerator 3D z penym sterownikiem Open-GL ICD

Program by rozwijany na:
- PentiumII 233, 64Mb, Riva 128 4MB AGP (ster. referencyjne 3.37 & 3.41)
- Celeron 566E, 128MB, ATI Rage 128 Pro 32MB (ster. referencyjne 06.33CD21)

I testowany na:
- Celeron 300A, 64Mb, intel740 8MB AGP (ster. referencyjne 3.2 & 4.0)
  - tylko do wersji 0.5.0.0250
- PentiumII 450, 128MB, Riva TNT 16MB AGP (ster. referencyjne 3.68
  i nowsze)

Program przetestowany z systemami:
- Microsoft Windows 98 PL (4.10.1998)
- Microsoft Windows 98 Second Edition PL (4.10.2222)
- Microsoft Windows Millenium Edition English (4.90.3000)
- Microsoft Windows 2000 PL(?) - tylko wersja 0.4.4

Program dziaa cakiem pynnie na wymienionych konfiguracjach, osigajc
okoo 30 kl./sek. na intelu 740, ok. 40 na Rivie 128, 60-70 na Rivie TNT
i Rage'u 128 Pro (w rozdzielczoci 640x480x16 na penym ekranie).

Aby uzyska wysoki i stay wskanik liczby klatek na sekund potrzebna jest
karta przede wszystkim z wysokim wspczynnikiem wypeniania (fill-rate).
Proponuj, o ile jest dostpny, uywa trybu 32-bitowego. Rnica midzy
16 bitami i 32 bitami bya atwo zauwaalna zarwno na Rivie TNT, jak
i na karcie z koci Rage 128 Pro.

Program nie wyglda najlepiej na kartach oferujcych tylko 16-bitowy
rendering. Jako obrazu na Rivie 128 jest enujca, troch lepiej jest na
intelu 740 (dosy dobry dithering). Praktycznie wszystko rysowane jest
z uyciem blendingu, wic na nic si nie zdadz "magiczne filtry" dajce
22-bitowy kolor na Voodoo 3 - potrzebna jest karta oferujca prawdziwy
32-bitowy rendering. Jeli masz tak - moesz podziwia najlepsz moliw
jako obrazu.

___________________________________________________________________________
8. TEKSTURA "END.TGA"

Moesz dowolnie modyfikowa tekstur w pliku "end.tga" aby umieci
w programie wybrane przez siebie logo (na przykad gdy chcesz umieszczasz
ten program na swojej stronie www i chcesz j zareklamowa). Plik powinien
mie wymiary 128x128 i musi to by 4-kanaowa, 32-bitowa Targa. Pierwsze
3 kanay opisuj kolor, a czwarty zawiera kana Alpha, czyli informacje
o przezroczystoci. Jeli masz jakie wtpliwoci - zobacz jak zrobiony
jest oryginalny plik "end.tga".

___________________________________________________________________________
9. HISTORIA ROZWOJU

0.5.0.0520 - [24.10.2000]
      - poprawiona wsppraca ze wszystkimi kartami Voodoo (program mona
        wreszcie uruchomi na penym ekranie) - specjalne podzikowania dla
        Pana Daoxiang Gong z firmy 3dfx za wspprac i testy (problem
        wynika z bdu w sterowniku Open-GL dla kart Voodoo, niezbdne
        moe si wic okaza cignicie nowych, poprawionych sterownikw
        ze strony producenta)
      - wszystkie parametry testw (tzn. w trybie benchmark) s teraz
        ustawiane domylnie 

0.5.0.0510 - [11.09.2000]
      - poprawiem zgodno z procesorami AMD-K6 i pochodnymi (poprawka nie
        ma adnego wpywu na wydajno, to tylko kwestia innej
        inicjalizacji koprocesora)
0.5.0.0500 - [01.09.2000]
      - nastpna oficjalna wersja (dostpna take po angielsku)
      - dodaem intro (tylko w trybie demonstracyjnym)
      - moliwo zmiany sposobu filtrowania tekstur: bilinear
        / bilinear+mipmaps / trilinear
      - lepsze tekstury - nowe logo Stars, logo Open-GL zostao
        przeniesione do pliku other.tga. lepsza tekstura ta
      - optymalizacja systemu czsteczek (nowe rwnanie, gdy s
        renderowane jako wygadzane punkty)
      - wszystkie wybrane opcje s zapisywane do wynikw testu (sposb
        filtrowania tekstur itp.)
      - pena informacja na temat uruchamiania i dziaania programu w oknie
        konsoli
      - wszystkie zrzuty ekranw zawieraj adres oficjalnej strony programu
      - poprawione okno dialogowe zapisu (nie pojawia si opcja "otwrz
        tylko do odczytu")
      - poprawione przenikanie tekstu
      - zmieniona obsuga MAPI - jeli jest wyczona, program bdzie
        prbowa wysa e-mail wykorzystujc standardowe funkcje shella
      - poprawiem bd ze z ikon pod WindowsME
0.5.0.0411 - beta1 [15.08.2000]
      - dziaa take pod Windows ME (4.90.3000 - wersja finalna, angielska)
      - ulepszona obsuga MAPI
      - ulepszony interfejs (program uywa nowych okien dialogowych
        z Windows2000/WindowsME - oczywicie tylko w tych systemach)
      - moliwo ustawienia gammy - rozjanienia lub ciemnienia obrazu
      - zupenie nowe okna pomocy i informacji o sterowniku Open-GL
      - ostatecznie pozbyem si drobnej usterki zwizanej z zapisywaniem
        zrzutw ekranw (tylko w maych rozdzielczociach)
      - napisaem od nowa tzw. clipping planes dla gwiazd (s teraz
        znacznie lepsze, zwaszcza w obrazach panoramicznych
        /szerokoktnych, ale wci daleko im do doskonaoci)
      - precyzyjniejsze dziaanie efektu lens-flare
      - poprawki i optymalizacja kodu
0.5.0.0250
      - obsuga MAPI - moliwo wysyania listw bezporednio z programu
      - moliwo zmiany czcionki i ta okienek raportu oraz konsoli
      - moliwo umieszczenia wasnego logo w programie (plik end.tga)
      - ulepszenia interfejsu (wicej podpowiedzi i skrtw klawiszowych)
        i renderingu ta
      - wszystkie ustawienia s zapisywane w pliku stars.ini
      - kursor zmienia ksztat na rk gdy jest przesuwany nad napisem
        odsyajcym do jakiej strony w internecie lub do jakiego adresu
        poczty elektronicznej
      - duo poprawek i ulepsze
0.5.0.0201
      - nowe renderowanie ta
      - nowy interfejs - podobny do programw dla systemu BeOS
      - wicej statystyk (prdko wypeniania, liczba trjktw na sekund
        i w jednej klatce)
      - poprawiony odsyacz do UPXa
      - usunem moliwo uruchamiania z linii polece
0.4.4 - pierwsza opublikowana wersja [20.03.200]
      - zupenie nowe renderowanie gwiazd
0.4.3 - duo (za duo...) maych poprawek
      - tekst i ikony s poprawnie skalowane do rozdzielczoci renderingu
0.4.2 - dodaem efekt lens-flare + tryb debug, by mona byo dokadniej mu
        si przyjrze
      - czsteczki mog by renderowane jako normalne teksturowane
        czworokty (niektre karty, zwaszcza te starsze, nie akceleruj
        wygadzanych punktw, co bardzo niekorzystnie odbija si na
        wydajnoci)
0.4.0 - eksperymentalny system czsteczek (uywa wygadzonych punktw
        o rnych rozmiarach)
      - nacinicie [Alt]+[Tab] zamyka okno renderingu
      - dokadniejsze zliczanie czasu (funkcja timeGetTime)
      - drobne (i wiksze) poprawki
0.3.6 - znacznie mniejsza liczba wywoa funkcji glBindTexture - z 300-1000
        do 3(!) -> 5% zwikszenie wydajnoci (przy 400 gwiazdach)
0.3.5 - spore zmiany w menu (osobna cz dla wynikw testu...)
      - dodaem weryfikacj tego, czy tekstury s oryginalne (tzn. czy nikt
        ich nie podmieni)
      - dodatkowa kontrola bdw
      - dodaem okno konsoli
0.3.0 - ulepszenia w procedurach niskopoziomowych, co bardzo poprawio
        wydajno (z okoo 48 kl/s do 72 kl/s + 3-10% wicej klatek na
        sekund przy zblieniu meteorw)
0.2.5 - duo poprawek w kodzie sprawdzajcym poprawno danych
      - znalazem may bd w sterowniku Open-GL Rivy 128 (wersja 3.37)
      - poprawione menu - dziaa doskonale
      - poprawiem bd, ktry powodowa spowolnienie animacji przy bardzo
        duej liczbie klatek na sekund
0.2.2 - duo poprawek w kodzie meteorw - wszystko powinno by duo
        pynniejsze
0.2.0 - dodaem menu do wyboru rozdzielczoci i trybu - nie trzeba wreszcie
        wpisywa wszystkiego w linii polece (chocia nadal mona)
0.1.8 - moliwo przeprowadzenia benchmarku (renderowanie 2000 klatek)
      - poprawiem bd w pobieraniu parametrw z linii polece
      - program na czas dziaania wycza wygaszacz ekranu
      - drobne ulepszenia i poprawki kodu
      - dodaem logo i inne drobne rzeczy
0.1.6 - dodaem klawisze do zmiany liczby gwiazd i meteorw
      - dodaem dane umoliwiajce sprawdzenie autentycznoci
0.1.4 - wyniki s przesyane do schowka
...
0.0.1 - pocztek projektu Open-GL Stars

___________________________________________________________________________
10. ZNANE BDY

Jak na razie - nie wiem o adnych bdach w tej wersji. Jeli jednak
znalaze co, co uwaasz za bd lub niedorbk - napisz list z dokadnym
opisem problemu i twojej konfiguracji na adres: support@stars.benchmark.pl.

___________________________________________________________________________
11. DOMYLNE USTAWIENIA TESTW

Options:             Full-screen, Hardware only 
Particles:           Texture 
Options -> General:
  Dithering:        ON
  Draw triangles:   OFF
  Filtering:        Trilinear 
Options -> Space:    Obie warstwy wczone
Options -> Meteors:  Meteors alpha <> 0.0
Frames rendered:     2000 

Jeli chcesz przeprowadzi testy przy innych ustawieniach - dodaj do pliku
'stars.ini' w sekcji [General] lini: 'b_default_settings=0'. Uzyskane
w ten sposb wyniki nie s jednak miarodajne i NIE POWINNY BY wysyane
przez formularz na stronie www programu.

___________________________________________________________________________
12. PODZIKOWANIA

Specjalne podzikowania dla:

- zaogi Benchmark3D (http://www.benchmark.pl) - najlepszego polskiego
  serwisu o sprzcie i firmy Ceti S.C. - Operatora Internetu
  (http://www.ceti.com.pl) za utrzymywanie mojej strony

- Entera (http://www.enter.pl) i Resetu (http://www.reset.com.pl)
  - za zamieszczenie poprzedniej wersji na pytach doczanych do tych
  czasopism

- Przemka - pierwszej osoby, ktra przysaa mi wyniki

- Aleksandra Ewicha, ktry przysa mi najwicej wynikw

- Aleksandra Jerzego Jerzaka, ktry sta si pierwszym zarejestrowanym
  uytkownikiem

- Markusa Oberhumera i Laszlo Molnara za UPX - The Ultimate Packer
  for eXecutables (http://upx.tsx.org)

- Mike'a Lischke (Lischke@imib.med.tu-dresden.de) za doskonae pliki
  nagwkowe Open-GL'a i bibliotek dziaa na matrycach i wektorach

- Scotta Franke (druid-), autora dema Ambient Psychosis, za bardzo
  uyteczne kawaki kodu (http://www-scf.usc.edu/~sfranke/glj)

- Nate'a 'm|d' Millera (vandals1@home.com,
  http://members.home.com/vandals1) za doskonae przykady w Open-GL'u

___________________________________________________________________________
13. KONTAKT Z AUTOREM

Jeli masz jakie uwagi/sugestie/pytania na temat tego programu, moesz si
ze mn skontaktowa pod tymi adresami:

WWW:
         http://www.stars.benchmark.pl/
Email:
         stars@stars.benchmark.pl
Smail:
         Tomasz Porosiki
         mudzka 13/27
         51354 Wrocaw
         POLAND

___________________________________________________________________________
14. INFORMACJA O PRAWACH AUTORSKICH

Copyright 2000 Tomasz Porosiski. All rights reserved.
Unauthorized duplication is a violation of applicable laws.
___________________________________________________________________________
24.10.2000                                               12:00 (GMT +01:00)