


_________________________________
PS2 emulators GS plugin - GStaris

Author: Absolute0 - absolutezero@ifrance.com
Date:   september,22 2002



__________________________________________________________________________________________________
       "GStaris wa oishii desu ka?"




Contents:

  * Some words from the autor              my words :)
  * Thanks                                 the people i would like to thanks
  * Files                                  the files in this .zip
  * Installation                           how to install it
  * Configuration                          how to configure it
  * Menu description                       the menu of GStaris
  * Key description                        control the plugin using these keys
  * Version                                last things added
  * Bugs                                   knowed bugs



Some words from the autor:

  What's new ?
    Textures should work fine now (only one problem with colors15,funslower...)
	New menu with a lot of functions
	Drawing emulation is better and faster
	Alpha blending is a little better (1fx)
	...

  Maybe some demos will work better using 'Interpreter CPU' and 'Disable VSync speed hack' with PSX2
  Please report me bugs, speed and other comments. Don't send me any files without ask before.

  And about some questions:
    The plugin don't run ps2 games !
    OpenGL is the best API for nVidia cards :) - but it work with the others cards too ! :).
    Which demo works ? Just test them :).
	You want to make your plugin? Ok, contact shadow or linuzappz, and if you need help email me.
	When will be released next GStaris ? When i'll be happy and when it will be finished.
	Why fullscreen mode flicker like hell ? That's a good question :) - if you can help me email me ! :)
    For some others questions, please send an email at < absolutezero@ifrance.com >.



Thanks:

  * The PSX2 team (hi shadow ! hi linuzappz !)
  * The PS2PE team (hi Goldfinger !)
  * Antoche, and the #codefr team (IRCnet) (youhou starman !)
  * saquib, you'll learn more about him soon (maybe?)
  * asad, you'll learn more about him one day
  * my friends for their moral support: LIA, ry, morphin, and klang
  * majestic3 for his Taris logo
  * A big thanks to the ps2 developpers, particulary for all the autors of the demo i have :)
  * NickK,Pete,...
  * jegHegy, betatester of GStaris 0.4
  * The others, and so many more...



Files:

  * README.txt      this file !
  * GStaris.dll     the release of the GStaris OpenGL plugin



Installation:

 Copy the .dll files to the plugin directory of the emulator.
 If you have some problems, please consult the documentation of the emulator or this file & send me some details.
 You can also visit the PSX2 support site by the PsxFanatics team at: http://pcsx2.psxfanatics.com



Configuration:

  * Resolution:
      Choose the display resolution. Some stuff may not work with resolution != 640x480.
  * Fullscreen mode:
      The speed may be a little up in fullscreen mode.
  * Stretch:
      Stretch the render.
  * Force 75 Hz [Fullscreen]:
      Use 75 Hz in fullscreen mode instead of the default frequency.
  * Keep ps2 ratio:
      The ratio of the ps2 will be used in stretched mode.
  * Use FPS limit:
      Check it if you want to use FPS limit (default or user).
  * Limit FPS to 60:
      If FPS limit is enabled, it limit the FPS to 60.
  * Limit FPS to (10-200):
      If FPS limit is enabled, it limit the FPS to the value set in the edit box (min=10 max=200).
  * Display Fps Count:
      Display the menu (fps count, options, ...). It can be displayed also using Inser.
  * Enable alpha blending:
      Enable alpha blending for all the demos ; result depend on the demos (test 1fx with and without that...)
  * Polygon Mode:
      Mode of polygon drawing, fill, line, point. Use fill for compatibility, others are here only for debugging.
  * Use old drawing function:
      If enabled, GStaris will use the same drawing functions as GStaris 0.3
  * FB Fix 1&2&3&4 [Frame Buffer Fix]:
      You may always disable the FB Fix (no fb fix), but if you want to disable flickering with some demos, you can enable the fb fix 1 or 2. Read the changelog for details.
  * Missing objects fix:
      Enable it in order to see some missing objects in pillgen,1fx, and maybe others demos
  * Jasper speed fix:
      It will make Jasper work like it should, but use it ONLY for Jasper, because other demos should not work with this fix !



Menu description:

Fps count:      fps, frame count and fps options
Stretch mode:   actual stretch mode
Polygon mode:   actual polygon mode
Resolution:     actual resolution of the demo, and resolution of the window
Texture Viewer: allow you to see the demo's textures



Key description:

Inser:     show/hide menu    (fps count)
Suppr:     fps limit change  (off/on=60/on=user) - or polygon mode change (fill,line,point) - or texture info change
Page Down: menu change
Page Up:   menu change
Home:      [in log version] enable/disable logging
End:       change FBfix to next

F8:        make a screenshot (snap/snap_.bmp)

F11:       texture viewer ^ tView - 1;
F12:       texture viewer ^ tView + 1;



Versions:

    VERSION 0.5
    
- Fixed wrap bug in plasma_tunnel & soundcheck tunnel
- Added FBfix5 and FBfix6 : use them for colors15,psms,carshowroom,plasma_tunnel,...- all the demos :P
todo: - Fixed flatline demo (display register bug)
todo: texture func

    VERSION 0.4
    
- Fixed [PSMT8*CSM1*PSMCT32] texture format (ps2mame title !)
- GSprocessTexture rewrited, should be more compatible.
- Added mipmapping support
- New menu, without flickering :p
- Added Texture Viewer in menu
- Now the cursor will be available only in windowed mode.
- Fixed keep ps2 ratio mode, fixed screen centered bugs, etc...
- Texture format added: [PSMT4*CSM1*PSMCT16]  [PSMT4*CSM1*PSMCT16S] [PSMT4*CSM2*PSMCT16]
                        [PSMT8H*CSM1*PSMCT32] [PSMT8H*CSM1*PSMCT16] [PSMT8H*CSM1*PSMCT16S] [PSMT8H*CSM2*PSMCT16]
  I still need some demos to test...
- Sprite code correction (psms,ps2mame,others) ; now it's like the GSsoft plugin.
- A lot of optimisations - speed is really better (5-10 fps with some demos).
  But the following additions will slow down the emulation of some demos :p
- New updateTexture checking code (psms games works! - soundcheck text colors works! - colors15 textures begin to work)
- new drawing code (for Point,Line,Triangle,Sprite) - faster, more compatible
- fixed 1fx alpha blending
- fixed PRIM register bug (plasma_tunnel)
- Added 'Missing stuff Fix' for 1fx,pillgen and maybe other demos
- Added FBfix 3&4, now FBfix is displayed in main menu, now you can change FBfix dynamically using 'End' button
- Fixed a bug when shutdown emulator without ESCAPE button (thanks Seta-San)
- Internal changes and code cleaning.

    VERSION 0.3 - Ry's birthday
    
- New z calculation (thanks saquib, for giving me the beginning of my actual code)
- Fixed jasper
- GIF correction
- 'About dialog' changes
- [PSMT8*CSM1*PSMCT16] & [PSMT8*CSM1*PSMCT16S] texture format added - need a demo to test :)
- pillgen;psms;soundcheck;1fx correction > Frame Buffer Fix 1
- 3starsII                               > Frame Buffer Fix 2
- alpha blending correction - now alpha blending is enabled by default
- Added experimental 'Keep ps2 ratio' (report me your comments)
- Now in non-stretched mode, screen will be centered (report me your comments)
- New scissoring code, with hardware&software support (a little part is missing)
- TEX1 register partially added
- STQ correction - works better, not perfectly
- New sprite clipping code (bytheway,demo2d,...)
- Added RGB24 -> RGB32 conversion in IDTwrite (3starsII title,...)
- Added RBG16 -> RGB32 conversion in IDTwrite (soundcheck tunnel,jum1,...)
- Compatible with the old and the new GS defs
- Fixed crash when using alpha blending code on old video cards (thanks asad)
- Fixed the bitbltbuf.dbw==0 bug (not the asad's fix, but another based on his fix)
- [PSMT4*CSM1*PSMCT32] texture format fixed (soundcheck & ps2mame text ; [i said bytheway in 0.2 changelog, it's an error sorry])
- Internal changes.

    VERSION 0.2
    
- Bug correction with the textured sprite primitives (turnip)
- Added a texture format used by 'bytheway' (if i remember well) & 'soundcheck' [PSMT4*CSM1*PSMCT32]
- STQ texture coordinate added
- Correction of a silly bug in the XYZ__ registers (hi shadow !)
- Added 'Display Fps Count' to display the menu (can be displayed also using Inser)
- Added 'Polygon Mode' to choose the polygon draw mode: fill,line,point - for debugging
- Added 'Stretch Mode' you know for what :)
- Depth test (z) bug correction (3stars,...)
- Fixed fullscreen mode
- Added partial texture function support
- Added a texture format used by ps2mame [PSMT8*CSM1*PSMCT32] - bugged :)
- GSprocessTexture function correction (ps2mame) - (hi shadow !)
- IDT (Image Data Transmission) correction - space, turnip (init text)
- Added 'Resolution' to choose the resolution
- Snapshot code correction
- Added 'Force 75 Hz [Fullscreen]' - can be useful
- Fixed drawSpriteT func (boredom)
- New RGBA code - compatibility is better
- VERY partial alpha blending code
- Added depth test in sprite drawing (drawSpriteZ ; drawSpriteTZ)
- New primitive drawing function selection - faster with some demos
- Complete alpha blending code (buggy)
- Added 'Enable alpha blending' to choose beetween the very partial code and the complete code
- And many and many little corrections and optimizations :)...

    VERSION 0.1 - First release
    
  * version 0.1 part B
- Bug with the *printf & the beginning of jasper corrected. printf, newprintf runs.
- TEX0 register correction (tmapped).
- Primitive drawing correction. tmapped run.
- Primitive drawing second correction. psms & psms-naplink primitives runs.
- Added flat & gouraud shading
- Added support for 8bit textures using the CLUT (psms). psms texture runs but i can't test all now.
- sprite primitive drawing correction
- prim funcs completely rewrited
- Depth test without speed decrease
- Some bugs with psms were corrected just before releasing the plugin :)
- Added some display correction (psms,space - maybe others i don't have)
- tested with PS2PE
- texture selection bug correction - space and others will work with the rights textures
- little primitive drawing correction > speed is up with many demos (fire,space,...)
- added texture update (when needed) ; speed is a little low but compatibility is really better (space,turnip,...)

  * version 0.1 part A
- OpenGL hardware rendering
- point,line,triangle,sprite primitives supported
- can run many demos with high speed
- experimental fullscreen mode 640*480*32 only
- windowed mode 640*480 with bpp >= 16 (i can't test with 15)
- option: fps limit at 60 fps ; choose fps limit value

  * First BETA version
- software image data processing
- can run some demo, but it's slow
- tested with PSX2



Bugs:

- p51 flickering, others ... :)
- IDT_move_onscreen_to_onscreen func in a resolution != 640x480 (3stars only i think)
- funslower missing polygon with old drawing func only
- plasmadream
- fullscreen mode bug come back ! 'why...?'


