Readme.txt

JoySens - Analog stick sensitivity plugin for OE firmwares
version 1.2

(C) 2007 Raphael <raphael@fx-world.org>




1. How to install

Copy joysens.prx and joysens.ini (unless you're just updating) to ms0:/SEPLUGINS/ (Create if the folder doesn't exist).

Add the line "ms0:/SEPLUGINS/joysens.prx" to the following files:
game.txt for UMD games and homebrew loaded from the GAME folder
game150.txt for homebrew loaded from the GAME150 folder
game3xx.txt for homebrew loaded from the GAME3xx folder
pops.txt for games played with POPS
vsh.txt for VSH/XMB
Create those files if they don't exist.
Hard reboot your PSP into recovery menu (hold R Trigger during startup) and enable the plugin. Done.



2. Usage

This plugin changes the analog sticks sensitivity to more useablity in the following ways:
- It changes the axial mapping to a cubic (or other selected) form so that small movements don't get recognized too early.
  This means that you can move cursors more exactly and don't have it jumping around on the screen.
- It applies a sensitivity scale to linearly change the responsiveness (and maximal amplitude for values < 100%)
  of the stick. With this you can 'slow down' the analog stick.
- It filters movement of the analog stick so that abrupt changes are further smoothed (adjustable).
- It is possible to calibrate the analog stick so it centers properly
- It allows to remap the DPad to the analog, so you can play games that require analog input with a broken stick
- It allows to remap the analog to DPad, so you can for example control the XMB with the analog

This makes the analog stick more useable for high-precision needs like FPS or anything where you move something
with the analog stick that needs to be placed next-to-pixel-precise.


OPTIONS

ENABLE -
	To turn the plugin on/off at any given time press NOTE + SELECT.

SENSITIVITY - 
	To change sensitivity press NOTE + LEFT TRIGGER or NOTE + RIGHT TRIGGER.
	Default sensitivity is 100%. The minimum is 10% (which effectively makes the analog stick unuseable)
	and maximum is 400% (which is way sensitive).

SMOOTH -
	To change smoothness of movement press NOTE + LEFT or NOTE + RIGHT.
	Default smooth is 100%. The minimum is 10% (which effectively makes the analog stick unuseable)
	and maximum is 400% (which is way sensitive - the smallest change will give maximum amplitude already).

ADJUST -
	To change the adjust function exponent press NOTE + UP or NOTE + DOWN.
	Default is 3. Minimum is 0 (which really turns the analog stick off) and maximum is 32 (which only gives
	a response when the stick is moved to its extremes, making it quasi-digital). The higher this value the better
	the deadzone gets 'hidden'.
	A value of 1 will result in normal behaviour and anything < 1 will probably only make the stick behave worse.
	If you want to get an imagination of what you are setting with this, plot the function x * (x/127)^(a-1) in
	the range 0 to 127 for your chosen adjustment value a. If you don't have a clue about this, just forget it :P

CENTER -
	To change the calibration either change it manually in the ini file (center) or try the following:
	- Move the analog stick to the top-left and hold it a few seconds, then release slowly until it's centered and don't
	  touch it anymore. Press NOTE+SQUARE,
	- Move the analog stick to the bottom-right and hold a few seconds, release slowly until centered. Press NOTE+SQUARE.
	- Repeat these steps until the center point has been found correctly (optimally, this is the mean value of the axes
	  minimal and maximal value when the stick isn't touched).
	Default value is <0,0>.

FORCEANALOG -
	You can select to force analog stick input to be enabled. This is useful for the XMB to be able to control it with analog.
	It does not harm any games that already poll analog input, hence why there is no enable/disable button combination.

RESET -
	To reset all values to default press NOTE+CROSS.

INFO -
	To pin/unpin the info output press NOTE + TRIANGLE. This will make the info output stay on top of the screen
	even when no button is pressed.

	NOTE: The info output does NOT work in all games (though it does in most and in XMB), so even when you don't see anything,
		  the plugin might still be running!
		  To check that, set the adjust parameter to 0 and see if the analog stick is turned off ingame. If so, the plugin
		  works and only the info output isn't.
		  If you don't get any info output even in XMB, then the plugin doesn't work. Check that you installed and enabled
		  the plugin correctly in your CFW's recovery menu.

	If not pinned to show the current settings only press and hold NOTE.
	You should see an output on the top-left of the screen like this:

	Adjusted analog axes: <16,12> -> <0,0>
	JoySens: on (info pinned)
	Sensitivity: 100%
	Smooth: 100%
	Adjust: 3.0
	Center: <0,0> (127,127) -> (-128, -128)
	Remap: Analog->DPad

	The first line is important to check if the analog stick properly maps the axes. Optimally the second coordinate pair
	should be constantly <0,0> if you don't touch the stick (while the first pair might jump around) and still give the full
	range from -128 to 127 in both axes (unless sensitivity < 100%) when you move the stick to the extremes.
	This line doesn't give the proper values in XMB other than photo viewer, browser and system information as XMB doesn't poll
	the analog stick unless you enable FORCEANALOG (set to 1).
	The second to last line gives the current center offset plus the measured minimum and maximum amplitude of untouched stick (gets
	updated with NOTE+SQUARE). They only should matter to you when you constantly get very odd values for center (values < -30 or > 30).
	The last line shows the current remapping method. This is either "None", "Analog->DPad" or "DPad->analog".
	
REMAP -
	The first option is to map DPad movement to analog stick (will make DPad unuseable for other uses), in case your analog is
	completely useless but a game requires analog input. Press NOTE + START to toggle the remapping.
	The second setting will remap the analog stick to DPad (analog will still be interpreted) so you can control for example
	the XMB with the analog stick.
	The third setting will turn remapping off (default).

SAVE -
	To save the current settings press NOTE + CIRCLE.


Also, you can change the button mapping in the joysens.ini file by properly setting the buttons. Just make sure there
is no double mapping.
Possible are SELECT,START,RTRIGGER,LTRIGGER,TRIANGLE,CROSS,CIRCLE,SQUARE,LEFT,RIGHT,UP,DOWN,SCREEN,VOLUP,VOLDOWN.
Any different value will turn off that function for online-adjustment.
You can't change the NOTE button mapping though.



3. Todo

- Better support for ingame info output (Find a better function hook than sceDisplaySetFrameBuf as some games seem to
  bypass that function - namely GTA:VCS).
- Improve compatibility with homebrew from XMB
- Add different switchable configurations

This plugin was tested under CFW 3.10-OE-A', 3.40-OE-A and 3.51-M33-7 and in the games GTA:VCS, CoD:RTV, RidgeRacer and Tekken5:DR.



4. Updates

from v1.11:
- Fixed a major bug with the calibration function that scaled the range wrongly (should now really be useable)
- Added a function to map the DPad buttons to analog in case you can't fix your analog stick but a game requires analog stick
- Added a function to force analog input (for XMB for example)
- Added a function to map the analog to DPad (to control XMB with analog)
- Added button mappings for SCREEN (brightness), VOLUP and VOLDOWN


from v1.01:
- Added better calibration method (keeps the axis scale in range)
- Fixed automatic calibration function (gives pretty reliable results now) and moved vertical and horizontal calibration into
  one function
- Added a movement smooth factor (how much changes in the axes get scaled, the lower the smoother any movement gets recognized)
- Added an adjust parameter which controls the exponent of the adjustment function (default 3.0 meaning a cubic form)
- Added button mapping configuration
- Fixed a small error in the axis mapping, where values were mapped in range -127 to 128 where it should be -128 to 127
- Added setting save functionality
- Improved the readme with better instructions


from v1.0:
- Added compatibility for 3.40 OE and higher firmwares



5. Contact

http://wordpress.fx-world.org
raphael@fx-world.org



6. Thanks&Greets

Thanks to all who made the PSPSDK possible.
Special thanks to TyRaNiD for PSPLINK. The main function hook functionality is based on remotejoy's hook function.

Greets to the people from ps2dev.org and psp-programming.com



7. Disclaimer

This software was not produced by Sony Corp nor any of its affiliates or representatives.
It is not endorsed by Sony, therefore they hold no responsibility for the use of this modification with their product.
PlayStation is a registered trademark of Sony Computer Entertainment, to which I have no affiliation.

Use at your own risk. I may not be held responsible for any harm that this software causes to your PSP.




Joysens jest to modu? (plugin) do firmware?w M33/OE
poprostu instalujesz go i podczas gry powinien sam zadzia?a? (a jak nie, za pomoc? /\ + SELECT wy?wietli ci infona temat analoga i mo?esz sprawdza? sobie wychylenia w tamtch statystykach), dodatkowa konfiguracja jest w pliku joysens.ini

instalacja to:
- wrzucasz pliki do ms0:/seplugins
- tworzysz/edytjesz game.txt i wpisujesz tam: ms0:\seplugins\joysens.prx
- wchodzisz do recovery mode w PSP do dzia?u PLUGINS
- je?li dobrze zrobi?e? poprzednie punkty to pojawi si? ta...