<html  dir=rtl>
<head>
<style type="text/css">
h1 {font-family:arial; font-size:20pt}
body {font-family:arial; font-size:10pt}
td {font-family:arial; font-size:10pt}
pre {font-family:arial; font-size:10pt}
input {width:200px}

</style>
<META CHARSET=windows-1255> 
<title>
שימוש בפקודת FScommand
</title>
</head>
<body >
<a href='http://www.flashdev.co.il'>בחזרה לעמוד הבית</a><p>

<center><h1>
שימוש בפקודת FScommand 

</h1></center>
<br><br>
<center>
	<img src="hebrew.gif" width=394 height=28 alt="This tutorial is using the HEBREW (ISO-LOGICAL) character-set">
</center>

<table border=0 align=right width="640px">
<tr><td>
<b><font size="+1">
כללי
</font></b>
 - בשיעור זה נלמד כיצד לתקשר בין אובייקט הפלאש לבין העמוד המכיל אותו ע"י שימוש בפקודת fscommand ושפת javascript. 
<br><br>
<b><font size="+1">
ידע נדרש
</font></b>
 - 
HTML, הכרת javascript ברמה בסיסית

</td></tr>
<tr><td>
<br>
<center>
<!-- this is the real embedded flash object -->
<OBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
	codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=5,0,0,0"
	ID=flashMovie 
	WIDTH=400 
	HEIGHT=70>
	 <PARAM NAME=movie VALUE="flashMovie.swf"> 
	<PARAM NAME=quality VALUE=high> 
	<PARAM NAME=bgcolor VALUE=#999999> 
	<EMBED 
		src="flashMovie.swf" 
		quality=high 
		bgcolor=#999999  
		WIDTH=400 
		HEIGHT=70	
		swLiveConnect=true 
		NAME=flashMovie 
		TYPE="application/x-shockwave-flash" 
		PLUGINSPAGE="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
	</EMBED>
</OBJECT>
</center>
</td></tr>

<tr><td>
<br>

<font size="+1">
<b>
הפעלת ג'אווהסקריפט מתוך פלאש
</b>
</font>
<br>
הפעולה היחידה שפקודת fscommand עושה, היא בעצם להפעיל פונקציה מסוימת בעמוד ה - html המכיל את הקובץ, תוך יכולת להעביר 
מספר פרמטרים . מטרת הפונקציה היא לשמש כ"מתווכת" - היא מקבלת את הערכים מפלאש ולפיהם מבצעת פעולות 
בשפת ג'וואהסקריפט (כגון קריאה לפוקנציות אחרות או פעולות מקומיות שלא דורשות שימוש בפונקציות אחרות).
<br>
הפקודה לא מבצעת את שינוי הצבע למשל מתוך הפלאש עצמו - היא רק מפעילה את הפונקציה המתאימה בעמוד,  
עם טקסט שבמקרה הזה הוא שם של צבע. באותה מידה היינו יכולים להשתמש בטקסטים ללא שום קשר לפעולה עצמה ולפרש 
אותם בכל דרך שנרצה - השמות שאנחנו מעבירים הם רק טקסטים שנועדו להקל על חיי המתכנת על מנת שיבין למה הכוונה בפקודה.
<br><Br>
על מנת לאפשר שימוש ב fscommand בקובץ יש לבחור באפשרות המתאימה בסימניית HTML שבתפריט Publish Settings:
<center><br>
<img src="publish.jpg" width=538  height=440 >
<br></center>
<br><br>
לאחר שנעשה לקובץ Publish, יווצר שם מזהה (ID) לסרט אשר מאפשר את התקשורת הדו-כיוונית עם ה -
 swf כמו שנוכל לראות בקוד הלקוח מעמוד זה:
<span dir=ltr><pre>
<font color=#aaaaaa > &ltOBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/...#version=5,0,0,0"
	</font><font color=blue >ID=flashMovie</font>
	<font color=red>WIDTH=400
	HEIGHT=70&gt
	&ltPARAM NAME=movie VALUE="flashMovie.swf"&gt 
	&ltPARAM NAME=quality VALUE=high&gt 
	&ltPARAM NAME=bgcolor VALUE=#CCCCCC&gt </font>
	<font color=#aaaaaa>&ltEMBED 
		src="flashMovie.swf" 
		quality=high 
		bgcolor=#CCCCCC  
		WIDTH=400 
		HEIGHT=70	
		swLiveConnect=true 
		NAME=flashMovie 
		TYPE="application/x-shockwave-flash" 
		PLUGINSPAGE="http://www.macromedia....=ShockwaveFlash"&gt
	&lt/EMBED&gt
&lt/OBJECT&gt</font>
</pre></span>
</td></tr>
<tr><td>


את הפקודה FScommand נמצא תחת תפריט Actions:

<center>
<br>
<img src="fscommand.jpg" width=538  height=281 >
<br>
</center>
<br><br>
לפקודת FScommand יש 2 פרמטרים שאנחנו יכולים להעביר:
<br><br>
<b>
command 
</b>
 - פרמטר זה הוא חובה - על פיו אנחנו בוחרים איזה חלק להפעיל בתוך הפונקציה (בדוגמא שבעמוד - שינוי צבע, שינוי גודל וכו'). 
<br>
<b>
args
</b>
 - אין חובה למלא חלק זה - לא תמיד אנחנו רוצים להעביר ערכים לפונקציה. בדוגמא שבעמוד אנחנו מפעילים alert עם 
כתובת העמוד, כאשר הפקודה שבפלאש רק קוראת לפקודה המתאימה בגאווהסקריפט.
<br><Br>
כאשר הפקודה מופעלת, היא מעבירה את הפרמטרים command ו - args לפונקציה 
שנמצאת בעמוד ה - html עצמו. 
<br>

הפונקציה מזהה את הפרמטרים ששלחנו בשמות שגם אנחנו מכירים: 
command,args ואת הקוד שמפרש את הפקודה אנחנו רושמים במקום המסומן לנו ע"י הטקסט 
<i>
Place your code here
</i>
(אשר נכתב 
כהערת סימון וניתן למחוק אותו).
</td></tr>
<tr><td>
<span dir=ltr><pre>
<font color=#aaaaaa>&ltSCRIPT LANGUAGE=JavaScript&gt
&lt!--
var InternetExplorer = navigator.appName.indexOf("Microsoft") != -1;
// Handle all the the FSCommand messages in a Flash movie</font>
<font color=blue>function flashMovie_DoFSCommand(command, args) {
  var flashMovieObj = InternetExplorer ? flashMovie : document.flashMovie;
  //
  // Place your code here...
  // 
}
</font>
<font color=#aaaaaa>// Hook for Internet Explorer 
if (navigator.appName && navigator.appName.indexOf("Microsoft") != -1 && 
	     navigator.userAgent.indexOf("Windows") != -1 &&
	     navigator.userAgent.indexOf("Windows 3.1") == -1) {
	document.write('&ltSCRIPT LANGUAGE=VBScript\&gt \n');
	document.write('on error resume next \n');
	document.write('Sub flashMovie_FSCommand(ByVal command, ByVal args)\n');
	document.write('  call flashMovie_DoFSCommand(command, args)\n');
	document.write('end sub\n');
	document.write('&lt/SCRIPT\&gt \n');
}
//--&gt
&lt/SCRIPT&gt</font>
</pre></span>
</td></tr>

<tr><td>
לדוגמא ראשונה ניקח את ה alert - תיבת האזהרה שאנחנו מפעילים ע"י fscommand שמכילה את כתובת העמוד
<br>
הפקודה הבאה רשומה על הכפתור Where שבתוך קובץ הפלאש:	
<span dir=ltr><pre>
fscommand ("myAlert"); </pre></span>בחלק הראשון של הפקודה, command, נרשום "myAlert" - טקסט פשוט, ללא שימוש בשום משתנים. את 
החלק השני של הפקודה, args, נשאיר ריק
ובתוך הפונקציה שבעמוד, היכן שרשום 
<i>
Place your text here
</i>
נרשום את התנאי הבא:
<span dir=ltr><pre>
<font color=#999999>function flashMovie_DoFSCommand(command, args) {
  var flashMovieObj = InternetExplorer ? flashMovie : document.flashMovie;
  //
<font color=blue>  if (command=='myAlert'){
	alert (document.location);
  }</font>
}</font>  
</pre></span>

אנו בעצם משווים את הטקסט שהעברנו כרגע מתוך פלאש (command) לטקסט אחר ובמידה שהם שווים אנחנו מבצעים את פעולת ה - alert. 
<br>
אין שום חשיבות למובן המילה שאנחנו מעבירים - באותה מידה יכולנו להשתמש בטקסט "ABC" על מנת להפעיל את ה alert. 
<br>
<br>
היות ויש בסרט שלנו מספר כפתורים המשתמשים בfscommand אנחנו צריכים לדעת להפריד בין האירועים 
השונים - ניתן לעשות זאת ע"י מספר משפטי if..else או ע"י משפט switch..case במידה ויש 
הרבה אירועים, אבל בסופו של דבר הבחירה בשיטה היא ענין של נוחות למתכנת. בעמוד זה השתמשתי במשפט if..elseif על מנת להבחין בין הקריאה לשינוי צבע לבין הקריאה ל - alert.
</td></tr>
<tr><td>
<span dir=ltr><pre>
<font color=#999999>function flashMovie_DoFSCommand(command, args) {
  var flashMovieObj = InternetExplorer ? flashMovie : document.flashMovie;
  //
<font color=blue>  if (<font color=red>command</font>=='changeColor'){
	document.bgColor=<font color=red>args</font>;
  }else if (command=='myAlert'){
	alert ("you are in " + document.location);
  }</font>
}</font>  
</pre></span>בחלק הראשון של משפט התנאי, השתמשתי גם בנתון השני
 שפלאש מעביר - args. במקרה זה הנתון השני מכיל שם של צבע (כל כפתור מעביר את שם הצבע הרלוונטי)
<br>



<br>
<br>
<font size="+1">
<b>
הפעלת פלאש ע"י ג'אווהסקריפט
</b>
</font>
<br>
חלק זה קצת יותר מורכב היות והוא משלב פקודות לא מוכרות - תרגום לפקודות ג'אווהסקריפט של חלק מהפקודות בפלאש, 
המאפשרות שינוי מבחוץ של רכיבים בסרט (משתנים , tell target, שליטה על הסרט עצמו וכו').
<br>
את הרשימה המלאה של הפקודות ניתן להשיג באתר הבית של מקרומדיה 
<a href="http://www.macromedia.com/support/flash/publishexport/scriptingwithflash/scriptingwithflash_03.html" target="_blank">
בכתובת זו
</a>.
<br>
הרשימה שבקישור מכילה את כל הפקודות האפשריות (בנוסף לתאימות לגרסאות השונות של פלאש) אשר ניתן להפעיל על פלאש מתוך ג'אווהסקריפט.
<br><br>
בשיעור זה נדגים את הפקודות העיקריות שבהן משתמשים, על הסרטון  הבא שנקרא "flashMovie2".
<br><br>
</td></tr>
<tr><td>
<center>
<OBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
	codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=5,0,0,0"
	ID=flashMovie2 
	WIDTH=400 
	HEIGHT=200>
	 <PARAM NAME=movie VALUE="flashMovie2.swf"> 
	<PARAM NAME=quality VALUE=high> 
	<PARAM NAME=bgcolor VALUE=#999999> 
	<param name=scale value=noborder>
	<EMBED 
		src="flashMovie2.swf" 
		quality=high 
		bgcolor=#999999  
		scale= noborder
		WIDTH=400 
		HEIGHT=200	
		swLiveConnect=true 
		NAME=flashMovie2 
		TYPE="application/x-shockwave-flash" 
		PLUGINSPAGE="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
	</EMBED>
</OBJECT>
<br><br>

<input type=button value="menu to right" onClick="flashMovie2.TsetProperty('/menuMC',0,340); flashMovie2.SetVariable('myVar','flashMovie2.TsetProperty(\'/menuMC\',0,340)')"> 
<input type=button value="X property - menu to left" onClick="flashMovie2.TsetProperty('/menuMC',0,55); flashMovie2.SetVariable('myVar','flashMovie2.TsetProperty(\'/menuMC\',0,55)')"> 
<br>
<input type=button value="Large menu" onClick="flashMovie2.TsetProperty('/menuMC',2,100); flashMovie2.TsetProperty('/menuMC',3,100); flashMovie2.SetVariable('myVar','flashMovie2.TsetProperty(\'/menuMC\',3,100)')"> 
<input type=button value="Xscale property - Small menu" onClick="flashMovie2.TsetProperty('/menuMC',2,60);flashMovie2.TsetProperty('/menuMC',3,60); flashMovie2.SetVariable('myVar','flashMovie2.TsetProperty(\'/menuMC\',3,60)')"> 
<br>
<input type=button value="Hide Menu" onClick="flashMovie2.TsetProperty('/menuMC',7,0); flashMovie2.SetVariable('myVar','flashMovie2.TsetProperty(\'/menuMC\',7,0)') "> 
<input type=button value="Alpha property - Show Menu" onClick="flashMovie2.TsetProperty('/menuMC',7,1); flashMovie2.SetVariable('myVar','flashMovie2.TsetProperty(\'/menuMC\',7,1)') "> 
<br>

<input type=button value="Normal size" onClick="flashMovie2.height=200; "> 
<input type=button value="Flash Height - Minimize Flash" onClick="flashMovie2.height=2 "> 
<br>

<input type=button value="End label" onClick="flashMovie2.TgotoLabel('_level0','end'); flashMovie2.SetVariable('myVar','flashMovie2.TgotoLabel(\'_level0\',\'end\')')"> 
<input type=button value="Goto Label - Start label" onClick="flashMovie2.TgotoLabel('_level0','start'); flashMovie2.SetVariable('myVar','flashMovie2.TgotoLabel(\'_level0\',\'start\')')"> 
<br>
</center>
<br><br>
פקודות אלו, וכל שאר הפקודות המופיעות ב<a href="http://www.macromedia.com/support/flash/publishexport/scriptingwithflash/scriptingwithflash_03.html" target="_blank">
רשימת הפקודות המלאה
</a>
מאפשרות להשפיע על כל חלק בסרטון הפלאש ומאפשרות 
שימושים שונים כמו העלמת תפריטים, הקטנת הפלאש למימדים שלא יפריעו לתפריט אחר בעמוד, 
שינוי רכיבים שונים בתוך סרטון הפלאש ללא צורך ברענון העמוד, עבודה עם נתונים בזמן אמת (ע"י קבלת והכנסת נתונים לתוך אובייקט הפלאש 
בזמן הריצה) ועוד אין סוף אפשרויות.
<br>
הבדל עיקרי אחד בין עבודה בפלאש לבין עבודה מג'אווהסקריפט הוא בפקודה setProperty אשר משתמשת בקודים מספריים במקום השמות המדוייקים
 (כמו בפלאש) למאפיינים השונים. 
<br>
<span dir=ltr><pre>
				<u>דוגמאות לפקודות</u>		

.GotoFrame(1)		- קופץ לפריים 2 - ספירת הפריימים מתחילה מ 0
.TgotoFrame ( "/mc", 2)	- כנ"ל, לגבי ציר זמן של מוביקליפ
.TgotoLabel("/mc", "label")	- קפיצה לליבל 
.TPlay("/mc")		- נגינה של מוביקליפ
.TStopPlay("/mc")		- עצירה של מוביקליפ

.GetVariable("varName")	- החזרת ערך של משתנה
.SetVariable("varname", value)	- קביעת ערך למשתנה

.TsetProperty ("/mcName",0,50)	- מיקום המוביקליפ ב - 50 פיקסלים בציר האיקס 
.TgetProperty("/mc",0)	- מחזיר את מיקום המוביקליפ על ציר האיקס

:כל הפקודות צריכות להיות רשומות בהמשך לשם האובייקט. לדוגמא

flashMovie2.TGotoFrame(23);


			<u>קודים מספריים למאפיינים</u>

<u>שם המאפיין</u>		<u>קוד</u>	         <u>תיאור</u>

X position		- 0	X מיקום על ציר ה 
Y position		- 1	Y מיקום על ציר ה 
X scale		- 2	אחוזי רוחב מהסימבול המקורי
Yscale		- 3	אחוזי גובה מהסימבול המקורי
currentframe	- 4	הפריים בו נמצא עכשיו ציר הזמן
totalframes	- 5	סך כל הפריימים בציר הזמן
alpha		- 6	שקיפות באחוזים
visibility		- 7	0 = hide , 1 = show
width		- 8	רוחב בפיקסלים
height		- 9	גובה בפיקסלים
rotation		- 10	סיבוב במעלות
target		- 11	הנתיב המלא של מוביקליפ מסויים
framesloaded	- 12	כמות הפריימים שהספיקו לרדת
droptarget		 - 13	הנתיב המלא של המוביקליפ שמעליו הפסקנו לגרור מוביקליפ אחר
url		- 14	הכתובת המלאה בה נמצא הקובץ שמוצג


</pre></span>
<br><br>



<pre>
									בהצלחה
</pre>
</td></tr>
</table>
<SCRIPT LANGUAGE=JavaScript>
<!--
var InternetExplorer = navigator.appName.indexOf("Microsoft") != -1;
// Handle all the the FSCommand messages in a Flash movie
function flashMovie_DoFSCommand(command, args) {
  var flashMovieObj = InternetExplorer ? flashMovie : document.flashMovie;
  if (command=='changeColor'){
	document.bgColor=args;
  }else if (command=='myAlert'){
	alert ("you are in " + document.location);
  }
}
// Hook for Internet Explorer 
if (navigator.appName && navigator.appName.indexOf("Microsoft") != -1 && 
	  navigator.userAgent.indexOf("Windows") != -1 && navigator.userAgent.indexOf("Windows 3.1") == -1) {
	document.write('<SCRIPT LANGUAGE=VBScript\> \n');
	document.write('on error resume next \n');
	document.write('Sub flashMovie_FSCommand(ByVal command, ByVal args)\n');
	document.write('  call flashMovie_DoFSCommand(command, args)\n');
	document.write('end sub\n');
	document.write('</SCRIPT\> \n');
}

function flashMovie2_DoFSCommand(command, args) {
  var flashMovie2Obj = InternetExplorer ? flashMovie2 : document.flashMovie2;
}

if (navigator.appName && navigator.appName.indexOf("Microsoft") != -1 && 
	  navigator.userAgent.indexOf("Windows") != -1 && navigator.userAgent.indexOf("Windows 3.1") == -1) {
	document.write('<SCRIPT LANGUAGE=VBScript\> \n');
	document.write('on error resume next \n');
	document.write('Sub flashMovie2_FSCommand(ByVal command, ByVal args)\n');
	document.write('  call flashMovie2_DoFSCommand(command, args)\n');
	document.write('end sub\n');
	document.write('</SCRIPT\> \n');
}

//-->
</SCRIPT>


</body>
</html>�