[Windows Mobile Development and Hacking General] Marshall07:
Readme...

Marshall WaitCursor 1.0

19th December 2007

_______________________

Marshall WaitCursor is a WaitCursor application for Windows Mobile. You can make your own

WaitCursors using png files with Alpha Transparent Channel. So you can make cursors

of any shape you like and also semi-transparent ones.

_______________________

1. INSTALLATION

- Place the cab into any folder of your device

- Execute it

- Choose the installation folder

- Launch the application from Start\Programs\MWC\MWC

2. UNINSTALL

- IMPORTANT: Disable the cursor using MWCUnload

- Remove the program from "Remove Programs" in the Sytstem Settings

3. WHAT'S IN THE PACKAGE

- Tux\ [ Tux cursor folder ]

- Crystal\ [ Crystal cursor folder ]

- BlueGlass\ [ BlueGlass cursor folder ]

- Butterfly\ [ Butterfly cursor folder ]

- MarshallWaitCursor.exe [ Main program that loads the WaitCursor ]

- MWCUnload.exe [ WaitCursor Unloader ]

- MWCReload.exe [ WaitCursor Reloader ]

- MarshallWaitCursor4b.dll [ Main program library ]

4. HOW TO CHANGE THE CURSOR

- Point to HKCU\Software\Marshall\MarshallWaitCursor and edit the CurrentSkin value.

Set it to the name of the folder of the WaitCursor you want to use

- Launch MWCReload

5. HOW TO MAKE A CUSTOM WAITCURSOR

- Make one png file for each frame of the animation

(avoid different resolutions for the frames)

- Make a conf.mwc file following the outline of an already existing .mwc file.

Expecially you can configure:

- nFrames: the number of frames

- xPosition and yPosition: the position where to draw the frames

- frameInterval: the interval between each frame (in milliseconds)

- startDelay: initial delay to wait before showing the cursor

- frame: each frame making the animation

Read the comments in .mwc files for more configuration details

- Put the .png files and the conf.mwc file in a folder naming it with the name of the skin

6. FAQs

1. Why I can't see any WaitCursor when MWC is executed?

-> MWC tries to replace the Windows Mobile default wait cursor but it is not always possible.

Depending on the device, memory, and other parameters, MWC may not be able to succesfully load.

Unload MWC (using MWCUnload), wait a couple of minutes and then try again (launcing MWC)

2. When I start-up my device, I can see the MWC current cursor but after I enter the PIN,

I see the default WM wait cursor running on the today screen.

-> This happens if MWC is loaded before the PIN is entered. You you have such problem,

remove ZMWC.lnk from the /Windows/Startup folder and, after you enter the PIN, manually

launch MWC.

3. Why MWC succesfully loads when Wisbar Advance is running and it doesn't happen when Wisbar Advance

is closed?

-> I noticed this strange behaviour in some situations. Because Wisbar Advance performs system APIs

hooks like my app does, it may happen that Wisbar Advance make it easier for MWC to load.

Try this:

1)Launch MWCUnload

2)Close Wisbar Advance (if running)

3)Launch Wisbar Advance again

4)After Wisbar Advance finish loading, launch MWC

4. After I change the Wait Cursor from registry and I launch MWCReload, the first frame of the previous

wait cursor is showed. Why?

-> It is a small developement bug that I plan to solve on the next release.

5. When I boot my device, I get this error: "Error locating process"

-> It may happen. Please try a soft-reset. If you still get the error message, remove ZMWC.lnk from

the /Windows/Startup folder and, after the boot is finished, manually launch MWC.

7. CREDITS

- My biggest thanks goes to Herojit from MSDNForums

and expecially to Chris McKay from Lakeridge Software

You can advertise my program to anyone you want but you shouldn't post the binaries

out the Website. My Website should be the only place where to download this program.

For any particular use, ask me by email or through my website.

Marshall