﻿Picasso menu


Flash SWF Object

The object is a ready-to-use SWF file that you simply integrate into your HTML page. We have developed the object for users who do not have Macromedia Flash. The object cannot be controlled with ActionScript. It can set up only through an XML file.

Picasso menu object info

We created a flash menu, which contains the best qualities. Now you can simply draw flash buttons, which are necessary for you. No restrictions! If you do not want to draw buttons yourself, you can take advantage of the ready-made templates. Also we want to say that the quantity of submenu levels is not limited, it is possible to make menu's of horizontal or vertical types, submenu's of a drop-down or popups types.

Picasso menu object features

·You can draw any main and sub buttons !
·Additional button themes
·Horizontal or vertical menu type
·Drop down or popup submenu type
·Horizontal submenu align
·Unlimited submenu levels
·Unlimited amount of main and sub buttons
·Custom button width
·Any font
·Unlimited text length
·Custom button actions
	oGetUrl
	oLoadMovie
	oGotoAndStop
	oGotoAndPlay
	oYour click handler with transfer of parameter
·External configuration XML file
·Change of a path to XML file in HTML
·Import background pictures
·Import button sounds
·Detailed documentation
·Support Flash player 7, 8, 9
·Small target file size (16 Kb)


Documentation

Flash object documentation
 
·Purchase and Installation
·Starting the Work
·Object HTML code 
·Object stage parameter 
·XML file format 
·Object parameter

Purchase and Installation

Once you purchase the object, the link to the download file will be sent to you by e-mail. This will be a zip archive with the object files and the documentation. Download this archive to your computer and unzip it. 

Starting the Work

To start working simply paste object HTML into your page and setup xml configuration file. You can place configuration file anywhere on your server. 

Object HTML code

Paste this code into your HTML-page and replace object stage parameter with your values. (following HTML-code supports MS Internet Explorer and Netscape Navigator)

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/
flash/swflash.cab#version=7,0,0,0" width="width"
height="height">
 
<param name="movie" value="swf file path"> 
<param name="quality" value="high"> 
<param name="scale" value="noscale"> 
<param name="bgcolor" value="background color"> 
<param name="flashVars"
value="xmlURL=path to configuration file">

  <embed src="swf file path" width="width" height="height"
flashvars=" xmlURL=path to configuration file" quality="high"
pluginspage="http://www.macromedia.com/go/getflashplayer" type="
application/x-shockwave-flash" scale="noscale" bgcolor="
background color"></embed>
</object>


Object stage parameter

Width 
This parameter controls width of flash object stage on your HTML-page. The width of the object can be different.

Height 
This parameter controls height of flash object stage on your HTML-page. The height of the object can be different.

Swf file path  
This parameter points to the object swf file. You can store your swf files anywhere on server.

Background color  
This parameter controls background color of object stage. So you can adjust its look and fee. The color should be set in RGB in the following format: #NNNNNN, where N is a hexadecimal number (0-F).

Path to the configuration file  
This parameter points to the object xml configuration file. You can store your xml files anywhere on server. But remember this path can be absolute (example:
http://www.yourdomain.com/config/menu01.xml) or relative to the directory with your HTML page (example: ../config/menu01.xml).


Buttons creation

Now you can simply draw flash buttons, which are necessary for you. You will find two usual flash buttons in the library: "1 mainButton" and "2 subButton".

You can edit them as you wish as these are usual flash buttons! Create a beautiful effect for the appearance, a roll over effect or simply draw a fine static button.

After you will open a button template fla file all necessary movieclips already are in library. You will only need to edit them.

Inside the flash button you can use a textfield with any font and any adjustments. It is important that the textfield is a "dynamic text" type and that it is placed directly in the flash button or inside a movieclip. Then the button label will automatically be entered in the textfield.


XML File Format

The component settings XML file is a usual text file of the following format:

<menu>
	<properties>
		<menu_type type="vertical"/>
		<menu_vertical_align align="top"/>
		<menu_horizontal_align align="left"/>
		<selected_state state="true"/>
 		<button_theme theme_file_path=""/>
		<menu_background bg_file_path=""/>
		<menu_rollover_sound mp3source="" mp3volume="10"/>
	</properties>
	<buttons>
		<button text="Button actions" url="" target="" action="">
			<button text="getUrl action" url="your.html" target="_blank" action="getUrl"/>
			<button text="loadMovie action" url="test.swf" target="_parent.test_mc.swfloader" action="loadMovie"/>
			<button text="gotoAndStop action" url="30" target="_parent.test_mc" action="gotoAndStop"/>
			<button text="gotoAndPlay action" url="playframe" target="_parent.test_mc" action="gotoAndPlay"/>
			<button text="myFunction action" url="1000" target="_parent.test_mc" action="myFunction"/>
		</button>
		<button text="Products" url="your.html" target="_blank" action="getUrl"/>
		<button text="Services" url="your.html" target="_blank" action="getUrl"/>
		<button text="Contact Us" url="your.html" target="_blank" action="getUrl"/>
		<button text="Company" url="your.html" target="_blank" action="getUrl"/>
	</buttons>
</menu>


Object parameter

Menu properties

Menu type
This parameter determines the type of the menu. If set to “vertical”, the menu will be vertical. If set to “horizontal”, the menu will be horizontal.

Menu vertical align
This parameter determines the vertical align of the sub menu. If set to “top”, the sub menu will be drop down. If set to “bottom”, the menu will be popup.

Menu horizontal align
This parameter determines the horizontal align of the sub menu. If set to “left”, the sub menu will appear on the right. If set to “right”, the sub menu will appear on the left.

Main button selected state
This parameter determines the selected state of the main buttons. If set to "true", the main menu button will be selected after click. If set to "false", the main menu button will be without selected state.

External menu buttons theme file
This parameter is the path to the menu buttons theme file. Its value may be either an external swf (buttontheme.swf) file path. If no name is specified, the included basic button theme will be used. If the name is incorrect, the component will not work.

Menu background
This parameter is the path to the menu background file. Its value may be either an external jpeg or swf (+ gif & png, if you work in the Flash 8) file path. If no name is specified, the background will not be used. If the name is incorrect, the background will not be used.

Menu rollover sound
This parameter is the path to the menu buttons rollover sound file. Its value may be either an external mp3 file path. If no name is specified, the rollover sound will not be used. If the name is incorrect, the rollover sound will not be used.

Menu buttons

Button text
This parameter determines the button label text.

Button actions
If you want that the button was visible without execute any action then set it’s ACTION to "".
"GetUrl" opens url in target window. (action - "getUrl", then url - what you open in window,  target - target window)

If the object is loaded into other flash document:
"loadMovie" load your file (jpeg, swf + (gif & png) if you work in the Flash 8) in target movie clip. (action - "loadMovie", then url - path to file which you want to load,  target - target movie clip where you want to load file)
"gotoAndStop" go and stop to frame or label in target movie clip. (action - "gotoAndStop", then url - frame to go or label to go,  target - target movie clip where you want to execute action)
"gotoAndPlay" go and play to frame or label in target movie clip. (action - "gotoAndPlay", then url - frame to go or label to go,  target - target movie clip where you want to execute action)
"nameofyourfunction" execute your function in target movie clip and transfer parameter in it (if it is necessary). (action - "nameofyourfunction", then url - parameter which is transferred in your function,  target - target movie clip where your function placed)


THEMES

One of the main advantages of Picasso menu is presence of additional button themes. At purchase of Picasso menu in it the basic theme is already enclosed, but at any moment you have opportunity to apply to the menu any other liked button theme.

Purchase and Installation

Once you purchase the button theme, the link to the download file will be sent to you by e-mail. This will be a zip archive with the button theme files and the documentation. Download this archive to your computer and unzip it. 

Starting the Work

To start working simply put button theme file (buttontheme.swf) on server and setup xml configuration file* or specify menu properties in flash component**. You can store your button theme files anywhere on server. But remember this path can be absolute (example:
http://www.yourdomain.com/themes/theme01.swf) or relative to the directory with your HTML page (example: ../themes/theme01.swf).

* Setup xml configuration file

In a xml file you can find this node with attribute “theme_file_path”:

…
<menu_theme theme_file_path="path to buttontheme.swf"/>
…

This attribute is the path to the menu buttons theme file. Its value may be either an external swf (themename.swf) file path. If no name is specified, the included basic theme will be used. If the name is incorrect, the component will not work.

** Specify menu properties

In a Flash component in the Custom UI you can find this parameter:

Menu theme file (external)
This parameter is the path to the menu buttons theme file. Its value may be either an external swf (themename.swf) file path. If no name is specified, the included basic theme will be used. If the name is incorrect, the component will not work.


CONTACT

If you have a question: support@flash-extensions.net

With regards,
Flash-Extensions.net
