krpano Actions / Scripting Reference Version 1.16.2

Select Version:

• 1.22
• 1.21
• 1.20.11
• 1.20.10
• 1.20.9
• 1.20.8
• 1.20.7
• 1.20.6
• 1.20.5
• 1.20.4
• 1.20.2
• 1.20.1
• 1.20
• 1.19-pr16
• 1.19-pr15
• 1.19-pr14
• 1.19-pr13
• 1.19-pr12
• 1.18
• 1.17.1
• 1.16.2
• 1.0.8.15
• 1.0.8.14
• 1.0.8.12
• 1.0.7

• variable
  Any variable name.
  When the variable doesn't exists it will be created.
• value
  The new value for this variable.

Examples

set(var1, 'hello');

set(var2, get(var1));

set(fullscreen, true);

set(layer[p1].visible, false);

set(hotspot[h1].scale, 2.5);

set(contextmenu.item[0].caption, 'hello item');

set(events.onxmlcomplete, null);

• variable
  Any variable.
  When the variable doesn't exists, then get() will return null.

Examples

set(dstvar, get(srcvar));

looktohotspot(get(name));

lookto(get(h), get(v), get(f));

showtext(get(msg));

tween(var,get(dstval));

set(pic, spot1);
set(hotspot[get(pic)].visible, false);

trace('xyz=', xyz, ' get(xyz)=', get(xyz));

txtadd(msg, 'fov=', get(view.fov));

set(destination, get(source) )

• destination
  The destination variable.
  When the variable doesn't exists it will be created.
• source
  The source variable.
  When the variable doesn't exists, null will be set to the destination variable.

Examples

copy(dstvar, srcvar);

copy(cur_hlookat, view.hlookat);

copy(layer[text].x, mouse.x);
copy(layer[text].y, mouse.y);

• variables
  Any variable name.
  Can be passed more than once.

Examples

set(tmp1, ...);
set(tmp2, ...);
... do something ...
delete(tmp1, tmp2);

• condition - the condition to check
  When the result of the condition is true, then the then-actions will be executed, and when the condition is false, then the else-actions.
  
  There are two types of conditions possible:
  
  1. Checking one variable:

     if(variable, ...);

     Test if this variable is true or 'not 0' or 'not null'.
     
     
  2. Comparing two variables or values:

     if(var1 OPERATOR var2, ...);

     The var1 or var2 can be a variables or values. When var1 or var2 is a variable then the content of the variable will be used for comparison. Only when using a 'strict' comparison operator (=== or !==) then var1 and var2 must be variables (or null).
     
     Available operators:

     ==	equal
     !=	not equal
     <  or  LT	lower than *
     >  or  GT	greater than *
     <=  or  LE	lower or equal than *
     >=  or  GE	greater or equal than *
     ===	strict equal (compare only existent variables)
     !==	strict not equal (compare only existent variables)

     * Note - because of xml limitations, the usage of '<' and '>' characters is not possible every time!
  
  
• then-actions
  The krpano actions that will be executed when the condition is true.
  
  
• else-actions (optionally)
  The krpano actions that will be executed when the condition is false.
  
  

Examples

if(fullscreen, fullscreensetup(), windowsetup() );

if(fullscreen, set(layer[controls].visible, false) );

if(%1 != next, set(i,0) );

if(i LT 10, loop(next) );

if(var === null, set(var,0));

if(hotspot[spot1] === null, trace(there is no spot1 hotspot));

if(varA GT 5,
    if(varA LT 10,
        trace('varA is between 5 and 10')
      );
  );

set(result,true);
ifnot(varA, set(result,false) );
ifnot(varB, set(result,false) );
ifnot(varC, set(result,false) );
if(result, trace('all vars are true') );

if(var1 GT var2,
    trace('condition is true');
    lookto(100,20,50);
  ,
    trace('condition is false');
    lookto(0,0,100);
  );

• id
  An optional unique id for the delayedcall. This id can be used to stop the delayedcall by calling stopdelayedcall(id).
• delay
  The number of seconds to wait before executing the actions.
• actions
  The action commands to execute.

Examples

delayedcall(5.0, hidelogo() );

delayedcall(10, looktohotspot(spot1);loadpano(pano2.xml); );

delayedcall(1, showtext('hello');       );
delayedcall(4, showtext('to the pano'); );

<action name="updatemousepos">
  copy(layer[cursor].x, mouse.x);
  copy(layer[cursor].y, mouse.y);
  delayedcall(0.02, updatemousepos() );
</action>

• id
  The id of the delayedcall that should be stopped.

Examples

<events name="introimage_events"
        onnewpano="delayedcall(introimage, 5.0, hide_introimage() );"
        onremovepano="stopdelayedcall(introimage);"
        />

• startactions
  The actions that will be called / executed before the for loop starts.
• condition
  See the condition at the if() documentation.
• nextactions
  The actions that will be called / executed after one loop (after the loopaction).
• loopactions
  The actions that will be repeatedly called / executed as long as the condition is true.

Examples

for(set(i,0), i LT 10, inc(i), trace('i=',i) );.

for(set(i,0), i LT layer.count, inc(i), 
  trace('layer[',i,'].name=',layer[get(i)].name);
);  

• condition
  See the condition at the if() documentation.
• loopactions
  The actions that will be repeatedly called / executed as long as the condition is true.
• doneactions (optionally, asyncloop only)
  The actions that will be called when the condition becomes false and the looping stops.

Examples

ondown="asyncloop(pressed, layer[scrollarea].scrollby(+2,0) );"

onover="asyncloop(hovering, updatemousepos(), hideinfo() );"

asyncloop(true, framehandler() );

• variable
  The variable that should be switched/changed.
  
• value1, value2, ... (optionally)
  The switch-through values for this variable.

Examples

switch(fullscreen);

switch(hotspot.visible);

switch(layer[button1].visible);

switch(layer[button1].alpha, 1.0, 0.5);

switch(layer[child].parent, button1, button2, button3);

switch(destpos, -100, 0, +100); tween(y,get(destpos));

• variable
  Any variable.
  

Examples

push(varA);
push(varB);
pop(varB2);
pop(varA2);

• Stops / breaks all currently running actions / tweens.
• Remove also all currently queued actions.

• Stops / breaks all currently running actions / tweens.

• Dispatches the 'eventname' named events from all <events> elements.

Examples

<events name="events1" myevent="trace(events1...);" />
<events name="events2" myevent="trace(events2...);" />
...
events.dispatch(myevent);

• with 2 parameters:
  
  • add(dst,val1)  ⇒  dst = dst + val1 (like +=)
  • sub(dst,val1)  ⇒  dst = dst - val1 (like -=)
  • mul(dst,val1)  ⇒  dst = dst * val1 (like *=)
  • div(dst,val1)  ⇒  dst = dst / val1 (like /=)
  • mod(dst,val1)  ⇒  dst = dst % val1 (modulate)
  • pow(dst,val1)  ⇒  dst = dst ^ val1
• with 3 parameters:
  
  • add(dst,val1,val2)  ⇒  dst = val1 + val2
  • sub(dst,val1,val2)  ⇒  dst = val1 - val2
  • mul(dst,val1,val2)  ⇒  dst = val1 * val2
  • div(dst,val1,val2)  ⇒  dst = val1 / val2
  • mod(dst,val1,val2)  ⇒  dst = val1 % val2 (modulate)
  • pow(dst,val1,val2)  ⇒  dst = val1 ^ val2

• variable
  The variable where the result of the calculation will be stored.
  When the variable doesn't exists it will be created.
• valueA / valueB (optionally)
  The values or variables for the calculation.

Examples

set(val, 1);
add(val, 1);
trace('val should be 2: val=',val);

mul(doublewidth, width, 2.0);

mul(scale, 0.5);

div(result, vala, valb);

add(dst,rotate,360); tween(rotate,get(dst),5);

add(xpos, mouse.x, mouse_x_offset);

sub(destx, stagewidth,  destwidth);

div(aspect,16,9);

mod(cur_hlookat,cur_hlookat,360);

pow(sqrt,val,0.5);

• variable
  The variable to increase or decrease.
  
• byvalue (optionally)
  Increase or decrease the variable by this value. When not set the variable will be increase or decrease by 1.
• max / min (optionally)
  Defines maximum and minimum values, when one limit will be reached then the value will be set back to the other limit value. This can be used to let the varibale wrap around a defined range or to clip at at specific limit (with min=max).

Examples

inc(i);

inc(frame,1,get(lastframe),0);

inc(ypos,30);

inc(view.hlookat, 2, 90, 90);

• Math.PI
  Mathematically constant with the value of PI (3.141592)
• Math.abs(var) or Math.abs(result,v)
  Make an absolute value.
• Math.acos(var) or Math.acos(result,v)
  Calculates the arc cosine (in radians).
• Math.asin(var) or Math.asin(result,v)
  Calculates the arc sine (in radians).
• Math.atan(var) or Math.atan(result,v)
  Calculates the arc tangent (in radians).
• Math.atan2(result,a,b)
  Calculates the arc tangent (in radians) of the two variables a and b. It is similar to calculating the arc tangent of a / b, except that the signs of both arguments are used to determine the quadrant of the result.
• Math.ceil(var) or Math.ceil(result,v)
  Calculates the next highest integer value by rounding up.
• Math.cos(var) or Math.cos(result,v)
  Calculates the cosine (parameter in radians).
• Math.exp(var) or Math.exp(result,v)
  Calculates e (=base of the natural system of logarithms, ~2.718282) raised to the power of var/v.
• Math.floor(var) or Math.floor(result,v)
  Calculates the next lowest integer value by rounding down.
• Math.log(var) or Math.log(result,v)
  Calculates the natural logarithm.
• Math.max(var,var2) or Math.max(result,...vars)
  Get the largest value of all given variables or values.
• Math.min(var,var2) or Math.min(result,...vars)
  Get the lowest value of all given variables or values.
• Math.pow(var,var2) or Math.pow(result,v1,v2)
  Calculates var/v1 raised to the power of var2/v2.
• Math.round(var) or Math.round(result,v)
  Calculates the rounded integer value.
• Math.sin(var) or Math.sin(result,v)
  Calculates the sine (parameter in radians).
• Math.sqrt(var) or Math.sqrt(result,v)
  Calculates the square root.
• Math.tan(var) or Math.tan(result,v)
  Calculates the tangent (parameter in radians).

• variable
  The variable to be rounded.
  
• decimalplaces (optionally)
  The number of decimal places.

Examples

roundval(val);

roundval(val,2);

copy(cur_hlookat,view.hlookat);
mod(cur_hlookat,360);
roundval(cur_hlookat,2);
copy(cur_vlookat,view.vlookat);
roundval(cur_vlookat,2);
txtadd(msg,'looking at ',get(cur_hlookat),'/',get(cur_vlookat));

• destination
  The destination variable where the connected text will be stored.
  The variable will be created when it doesn't exists.
• txt1, txt2, txt3, ... (optionally)
  The texts that will be connected together. When using only one txt parameter then this text will be added to the content of current destination variable.
  Note - when the content of a variable should be used - then the get() action must be used to resolve the variable!

Examples

txtadd(picfilename,'%CURRENTXML%/pic_',get(pic),'.jpg');

txtadd(crop,'0|',get(ypos),'|333|285');

txtadd(pname, 'thumbbar_image_', get(i));

txtadd(layer[text].html,'[p]',get(data[txt1].content),'[/p]');

txtadd(msg,get(view.fovtype),'=',get(fov),'°');

• dstvar
  The destination variable where the extracted text will be stored.
  The variable will be created when it doesn't exists.
• srcvar
  The variable or text with the source text.
  
• startpos
  The starting position from where the text should be extracted.
  
• len
  The length of the text to extract.
  

• dstvar
  The destination variable where the extracted text will be stored.
  The variable will be created when it doesn't exists.
• txt
  The text in which should be searched.
• searchtxt
  The text that should be searched for.
• startindex (optionally)
  The starting startindex/position where to start searching the text (0 by default).

• var
  Without text parameter - the variable which will be escaped/unescaped.
  With text parameter - the variable where the escaped/unescaped text will be stored.
  
• text (optionally)
  The text that that will be escaped/unescaped.
  

• variable
  The variable that should be changed.
  
  
• value
  The destination value for this variable.
  When tweening percent values - add a '%' character to the value.
  Note - to tween to the value of another variable use the get() action to get the value of the other value!
  
  
• time (optionally)
  
  • The time in seconds for the change from the current value to the destination value (0.5 seconds by default).
  • Instead of using a fixed time for the change it is possible to define the maximum moving distance for the value and a time for that distance.
    This allows to use a short time for a short distance and long time for a long distance. This can be done by using the distance function:
    
    distance(maxdistance,maxtime)
    
    • maxdistance - the maximum distance between the start and the destination value
    • maxtime - the time in seconds for this maximum distance
  
  
• tweentype (optionally)
  The interpolation type (easeOutQuad by default).
  See here for all available tween types: tweentypes.
  
  
• donecall (optionally)
  The action commands to execute when the destination value has been reached.
  Instead of some actions, it is also possible to use the special keyword WAIT - in this case the user interface and the execution of the following actions will be blocked until the destination value has been reached.
  
  
• updatecall (optionally)
  These action will be called every time (=every frame) when the value will be updated / changed! WARNING - use updatecall with care! When heavly used this can reduce the rendering performance!

Examples

tween(scale,2);

tween(rotate,90);

tween(width,50%);

onover="tween(alpha,0.7,distance(0.3,0.2));"
onout="tween(alpha,1.0,distance(0.3,0.2));"

set(alpha,0);
set(visible,true);
tween(alpha, 1.0 ,0.3);

tween(layer[logo].width, get(destwidth));

set(layer[image].enabled,false);
tween(layer[image].alpha,0.0,0.5,default,removeplugin(image));

set(view.stereographic,true);
tween(view.vlookat, 90.0, 2.0);				
tween(view.fisheye, 1.0, 2.0);
tween(view.fov, 150.0, 2.0);

• variable
  The name of the variable which is currently tweening and should be stopped.
• ... variable, variable, ... (optionally)
  Addtional variables that should stop tweening.

Examples

ondown="tween(layer[text].y, 10, distance(400,0.7), linear);"
onup="stoptween(layer[text].y);"

• linear

• easeOutQuad (the default)
• easeOutQuart
• easeOutQuint
• easeOutSine
• easeOutBounce
• easeOutCirc
• easeOutCubic
• easeOutExpo

• easeInQuad
• easeInQuart
• easeInQuint
• easeInSine
• easeInBounce
• easeInCirc
• easeInCubic
• easeInExpo

• easeOutInQuad
• easeOutInQuart  *
• easeOutInQuint  *
• easeOutInSine  *
• easeOutInBounce  *
• easeOutInCirc  *
• easeOutInCubic  *
• easeOutInExpo  *

• easeInOutQuad  *
• easeInOutQuart  *
• easeInOutQuint  *
• easeInOutSine  *
• easeInOutBounce  *
• easeInOutCirc  *
• easeInOutCubic  *
• easeInOutExpo  *

• xmlpath (for loadpano)
  The path/url of the new pano xml file to be loaded (use null for none).
  When a relative path will be used then the file will be loaded from the basedir folder, which is %FIRSTXML% by default. That means that the paths in all loadpano calls are relative to the first loaded xml file.
  
  
• xmlstring (for loadxml)
  The content of a xml file as string/text to be loaded (should be escape-coded).
  
  
• scenename (for loadscene)
  The name of the <scene> to be loaded.
  
  
• vars (optionally)
  Variables to set (use null for none).
  These variables will be set after parsing/resolving the xml but before starting to load the pano images. This can be used to overwrite any settings from the xml or to set addtional ones. The variables can be defined as var1=val1 pairs separated by a & character (e.g. sphere=image.jpg&view.fov=120&view.fisheye=0.35).
  HTML5 Notes - for HTML5 compatibility &amp; instead of & should be used.
  
  
• flags (optionally)
  Addtional flags for loading (use null for none).
  Flags can be combined by a | character.
  
  Possible flags:
  
  • MERGE (the recommended flag)
    
    • Merges all settings from the current and the next pano.
    • If there are plugins and hotspots in the new panorama with the same name as the kept ones, the new elements will not be loaded.
    • This is the recommended setting for virtual tours.
  • KEEPVIEW - keep current view settings
  • KEEPSCENES - keep current scenes (loadpano only)
  • KEEPDISPLAY - keep current display settings
  • KEEPCONTROL - keep current control settings
  • KEEPPLUGINS - keep current loaded plugins
  • KEEPHOTSPOTS - keep current loaded hotspots
  • KEEPPROGRESS - keep current progress settings
  • NOPREVIEW - ignore the <preview> tag of the new xml
  • KEEPBASE - a predefined combination of:
    KEEPDISPLAY | KEEPCONTROL | KEEPPLUGINS | KEEPPROGRESS
  • KEEPALL - a predefined combination of:
    KEEPVIEW | KEEPDISPLAY | KEEPCONTROL | KEEPPLUGINS | KEEPPROGRESS
  • REMOVESCENES - remove all currently defined scene elements (the same like - set(scene.count,0); )
  • IGNOREKEEP - ignore the keep flags and remove also the elements with keep="true"
  
  
• blend (optionally)
  Blend / fade to next panoroma.
  
  Possible blending modes:
  
  • NOBLEND = no blending (default).
  • BLEND(n) = blends from current panorama to next in n seconds
  • ZOOMBLEND(n,z) = zooms and blends in n seconds with zoom factor z (Flash only)

Examples

loadpano(pano2.xml);

loadpano(pano2.xml, null, MERGE, BLEND(1));

loadscene(scene1);

loadscene(scene1, null, MERGE, BLEND(1));

loadxml('<krpano><image><sphere url="pano.jpg"/></image></krpano>');

loadxml(get(data[xml].content), null, KEEPALL);

loadpano('%SWFPATH%/pano.xml', null, MERGE, BLEND(2));

loadpano(sphere.xml, image.hfov=1.0&view.limitview=fullrange);

• url
  The url to open.
• target (optionally)
  The target where the url should be opened.
  
  Possible settings:
  
  • _blank - open the url in a new window (the default)
  • _self - open the url in the current frame in the current window
  • _parent - open the url in the parent of the current frame
  • _top - open the url in the top-level frame in the current window

Examples

openurl('http://krpano.com',_self);

openurl('help.html');

• atH
  Horizontal position in degrees, spherical coordinates (-180 to +180).
• atV
  Vertical position in degrees, spherical coordinates (-90 to +90).
• fov (optionally)
  The new field of view in degrees (0 - 179).

Examples

lookat(0,0);

lookat(0,0,90);

loadpano(pano.xml);
lookat(45.1, -20.2, 110.0);

• toH
  Horizontal destination looking direction (-180 to +180, wraparound possible).
  
  
• toV
  Vertical destination looking direction (-90 to +90).
  
  
• hotspotname (for looktohotspot, optionally)
  The name of the hotspot. Use the hotspot position (ath/atv) as destination position.
  When no name will be defined and looktohotspot() will be called from a hotspot event then the caller hotspot itself will be used.
  
  
• fov (optionally)
  The destination fov (0 to 179).
  The looktohotspot action will use automatically the size of the hotspot as destination fov when the fov was not set. The other actions keep the current fov when not set.
  
  
• motiontype (optionally)
  The type of the motion.
  
  Possible settings:
  
  • linear(speed) - a linear motion
    • speed = moving speed in degrees/second
      
  • smooth(accel,break,maxspeed) - accelerated smooth movement (=default)
    • accel = acceleration in degrees/second² (default=720)
    • break = negative acceleration in degrees/second² (default=-720)
    • maxspeed = maximum moving speed in degrees/second (default=720)
  • tween(tweentype,time) - tween animation curve
    • tweentype = one of the tween types
    • time = time in seconds for the movement
  
  
• shortestway (optionally)
  The use the shortest possible way from the current to the destination position.
  Possible settings: true or false (default=true).
  
  
• nonblocking (optionally, lookto only)
  When set to true, then the lookto action will not wait for completing the movement before continue executing the the following actions. The user-interface will also be not blocked.
  When the lookto movement is done then the donecall action will be called (when defined).
  
  
• donecall (optionally, lookto only, only when nonblocking is true)
  This action will be called when the nonblocking lookto movement is done.

Examples

moveto(100.0,5,linear(10));

zoomto(130,smooth());

lookto(33,-22,30,smooth(100,50,20));

looktohotspot(hotspot1);

looktohotspot(hotspot2, 40);

looktohotspot(hotspot3, 25, smooth(100,50,20));

looktohotspot(get(name));

• desthlookat
  The intended destination hlookat value. The current view.hlookat variable will be adjusted (without changing the current view) to be next to this value.

Examples

adjusthlookat(140);
tween(view.hlookat, 140);

• parameter
  
  • any number - this the time the action will wait in seconds
  • LOAD - wait until loading is finished
  • BLEND - wait until loading and blending are finished

Examples

oninterrupt(break);
lookto(150,30,70);
wait(3);
lookto(242,0,150);
lookto(280,-10,50);
wait(3);

loadpano(pano2.xml,null,MERGE,BLEND(2));
lookat(100,50,5);
wait(BLEND);
lookto(100,50,150);

• actions
  
  • The action commands to call on a user interrupt.
  • Addtionally there is a special command possible here:
    break - this will just break the current actions.

Examples

oninterrupt(break);
lookto(150,30,70);
wait(3);
lookto(242,0,150);
lookto(280,-10,50);
wait(3);

oninterrupt( trace(user interrupt); );
lookto(0,0,90);			
lookto(90,0,90);
lookto(180,0,90);
lookto(270,0,90);
lookto(0,0,90);

• x / y
  Variables with screen coordniates in the pixels from the left top edge.
  spheretoscreen: When the variables doesn't exist they will be created.
• h / v
  Variables with spherical coordniates in the degrees (360x180).
  screentosphere: When the variables doesn't exist they will be created.

Examples

screentosphere(mouse.x, mouse.y, toh, tov);

• text
  
  • The text to show.
  • HTML tags can be used to format the text.
  • Using < and > characters will be not possible (because of xml limitations).
  • The [ and ] characters can be used instead - krpano will map them automatically.
  • To get the real [ and ] characters use them twice - [[ and ]].
  
  Examples for formating:
  
  • [b]bold[/b] ⇒ bold text
  • [i]italic[/i] ⇒ italic text
  • [u]underline[/u] ⇒ underlined text
  • [br] ⇒ line break
  
  
• textstyle (optionally)
  the name of the textstyle to use for this text,
  if not defined the DEFAULT style is used
  see xml textstyle tag documentation

Examples

onhover="showtext(you are hovering me);"

onhover="showtext(style text,TEXTSTYLE);"

onhover="showtext(line 1[br]line 2[br]line 3);"

onhover="showtext([b]bold[/b] [i]italic[/i]);"

DEMO: view some textstyles interactive

• updateall (optionally)
  For multi-resolution pano - should all levels be updated?
  Possible settings: true or false (default=false).
• updatefov (optionally)
  Reparse the image.hfov, image.vfov and image.voffset settings when building the pano object.
  Possible settings: true or false (default=false).

Examples

set(image.hfov,1);
updateobject(true,true);

• Force a redraw of the panorama view.
• The rendering quality will not change.

• Force a redraw of the panorama view.
• The rendering quality will change to movequality / movequality10 .
• Resets also the idletime counter.

• name
  Name of the new layer/plugin, hotspot or lensflare element.
• ath / atv (lensflare only)
  Horizontal and vertical position in degrees for the lensflare element.

Examples

addlayer(button);
set(layer[button].url,button.jpg);
set(layer[button].align,bottom);
set(layer[button].x,10);
set(layer[button].y,20);
set(layer[button].onhover,showtext('hovering the new button'));
set(layer[button].onclick, removelayer(button) );

addhotspot(newspot);
set(hotspot[newspot].url,spot.png);
set(hotspot[newspot].ath,150);
set(hotspot[newspot].atv,30);
set(hotspot[newspot].scale,0.7);
set(hotspot[newspot].zoom,true);
set(hotspot[newspot].onclick, removehotspot(newspot) );

addhotspot(polyspot);
set(hotspot[polyspot].fillalpha, 0.25);
set(hotspot[polyspot].borderalpha, 0.50);
set(hotspot[polyspot].onclick, removehotspot(polyspot) );
set(hotspot[polyspot].point[0].ath,-10);
set(hotspot[polyspot].point[0].atv,-10);
set(hotspot[polyspot].point[1].ath,-10);
set(hotspot[polyspot].point[1].atv,+10);
set(hotspot[polyspot].point[2].ath,+10);
set(hotspot[polyspot].point[2].atv,+10);
set(hotspot[polyspot].point[3].ath,+10);
set(hotspot[polyspot].point[3].atv,-10);

addlensflare(sun, 20, -60);
set(lensflare[sun].set,  FLARESET2);
set(lensflare[sun].size, 0.7);

• name
  Name of the layer/plugin, hotspot or lensflare element that should be removed.

• fscommand(quit)
  Quit the standalone flashplayer.
• fscommand(showmenu,false)
  Hide the menubar of the standalone flashplayer (Windows only).
• fscommand(exec,'application.exe')
  Start an external application.
  The 'application.exe' must be in a subfolder named "fscommand".

• state (optionally)
  
  • true to show the log (default)
  • false to hide the log

• ....
  Any text or variables. When passing a variable then automatically the content of the variable will be used.

Examples

trace('view.maxpixelzoom=', view.maxpixelzoom);

<events onkeydown="trace('keycode=',keycode);" />

onresize="trace('size=',stagewidth,'x',stageheight);"

onclick="trace('mouse clicked at ', mouse.x, ' / ', mouse.y);"

trace('xyz=',xyz,' get(xyz)=',get(xyz));

• errormessage
  The error message to show.