java slideshow instructions, documentation

Applet tag

Copy the following html applet tag in your web site, and place the v3.jar file in the same directory as your html pages, on your site :

<applet code="v3.class" archive="v3.jar" height="400" width="400" vspace="0" hspace="0" codebase=".">
<param name=list value="china.txt">
<param name=regkey value="xxxxxxx">
<param name=timer value="4000">
<param name=showpanel value="1">
<param name=showinfo value="0">
<param name=xfade value="16">
<param name=comments value="1">
<param name=htmltarget value="_blank">
<param name=backcolor value="3158108">
<param name=filter value="0">
<param name=useJS value="0">
</applet>

Parameters

Detailed information on the applet tag and the parameters :

height="400" width="400"
Size of the applet in pixels, you can also set a percentage here (ex: width="100%").

vspace="0" hspace="0"
Defines the margin in pixels around the applet.

<param name=list value="yourtextfile.txt">
filename for the text file where you will put the list of the images to display. you can put a php file here to make custom lists. be careful with the paths and file names, the web servers are case sensitive.

<param name=regkey value="xxxxxxx">
put here your personal regkey. it will remove the evaluation messages for your domain and allow you to make slideshows with a large number of images.

<param name=timer value="0-999999">
controls the time between two images, in milliseconds. if the timer is 0, you activate a special mode which just display 2 arrows in the panel and won't change the pictures automaticaly. it's used for the online shop example.

<param name=showpanel value="0/1">
display or not the control panel, and enable/disable user control on the slideshow.

<param name=showinfo value="0-3">
show or not some information about the slideshow and the images (0: no info ; 1: full info with file names ; 2: no info, no loading led ; 3: short info, no file names)

<param name=xfade value="0-255">
speed of the crossfading (1=slow, 255=very fast). you can disable the crossfading with the value 0. values between 1 and 32 are recommended.

<param name=comments value="0-3">
enable/disable the display of comments and url links for your images. if it's set to 1, you must add a description line in the txt file after all the file names. if it's set to 2, you must add the url after all the image file names. if it's 3, you must place in order the file name, the text comment line and the url to link to for this image. see the sample text files for a more clear idea.

<param name=htmltarget value="targetname">
the html target of the document you will get if you click on an image and if url links are activated. you can put anything, like "_blank", "_self", or your custom frame name.

<param name=backcolor value="0-16777215 or #ABCDEF">
the background color, to fit better on your website. you can use a value like '#FFBB00'. a decimal value of the RGB color can also be put here (ex: #5F5FC0 => 6250432). use the windows calculator, put it in scientific mode, enter your number in hexadecimal then convert it to decimal to get the right value to use.

<param name=filter value="0-2">
sets a filter for the slideshow (0: no filter, 1: black&white, 2: sepia). the image will be displayed through this filter.

<param name=useJS value="0/1">
(experienced users only!). disable/enable the Javascript support, the applet will call the setDesc javascript function with the comment as parameter. You can also call the applet methods setTimer(value), setFilter(value), newlistjs(listname) to alter the slideshow settings in realtime.

contents of the text file :


the text file must only contain the file names of the images you want to display.
you can add a directory before the file name.
images will be displayed in the order you wrote them in the text file, you can display several times the same image by repeating its name in the list.
if the text comments are enabled, you must add a line with the appropriate comment right after the line with the file name.
I you don't need comments for all the images, just leave a blank line.
the applet will switch to the first image when the last image will have been displayed.
if you enabled the url links, you must add a line with the url to link to after the file name or the text comment.
if you don't want to assign an adress for a page, just leave a blank line.
the last line of the file must end with an asterisk '*'.

See a sample text file without comments (comments=0)
See a sample text file with comments (comments=1)
See a sample text file without comments and with url links (comments=2)
See a sample text file with comments and url links (comments=3)


latest updates :


- 29/06/2006:
- changed the graphics output so the applet doesn't eat cpu anymore and the whole browser will respond quicker.
- added the possibility to enter hexadecimal values for the background color.

- 28/05/2006:
- major release, v3.0
- added javascript support to control the slideshow from an html page and update a dhtml from the applet.
- added controls to change the list on the fly.
- added realtime black and white & sepia filters.

buy a good web slideshow for your website now
Buy MJS now with this form and make a nice addition to your web site !

- Licence for domain name(s)

Type below the domain name(s) you want to register (ex: 'mywebsite.myhost.com')
 


Price : 24.90 euro


Pay with Moneybookers : 
 
 
Pay with Paypal : 
 
 
Links
Plopbox : an online computer music jukebox to listen, find and submit great tunes!
Ojuice : The demoscene information center
Scene.org : the biggest demoscene archive
Gfx Artist : The nicest graphics of the web
Pouet.net : the place to find the best demos. increase Sparks demo popularity
Linuxfr.org : da Linux french portal
Dev Master : the game programming site, Java game programming, C++, DirectX, win32, opengl...
Cfxweb.net : demo effects & game development, links to the java demoscene, Java game programming
Equinox : loads of nice java demos (java applets) and oldschool atari st related stuff
Komplex : java demos and java effects in flyers, also gba and pc demos. best group of the java demoscene
Pierre-bleue : graphist,freelance designer 2D, 3D, flash, html.
Flan : oldschool graphist, 2d pixel stuff, wonderful

Mxx.net : Online web slideshow with online games Web developer, AJAX + Javascript websites and java applets. mastering java freelance development & java game programming
web hosting service : anotherlight.com. check my upcoming java projects and ajax, javascript website. VPS. check out my java effects and enjoy the java online games
My next project is a cool chiptune jukebox made with a lot of ajax, JS and an applet, web hosting is with a virtual private server (VPN) xen. javascript calls launch music played by the applet.