Getting Started

Introduction

This page is designed to help you learn to edit this Wiki. It is divided into three sections:

• This introduction
• A sample page as it will appear when browsing
• The source for the sample page.

You might find it helpful to copy the source and paste it into any new page that you create, so that your contribution appears in the same standard format.

First of all, you need to log on in order to have the right to edit pages. This is the price that legitimate contributors have to pay to ensure that we can prevent the Wiki from being vandalised.

At the bottom of every page is a link that says "Edit this page". If you click on that, you get a different view of the page, where links are defined by double square brackets [[like this]].

To create a new link in the dictionary, simply:

1. Copy the source code from the third section below
2. Visit the Lingo Dictionary page
3. Click on "Edit this page" at the bottom
   Here's a [http://director-online.dasdeck.com/dougwiki/index.php?title=Lingo_Dictionary&action=edit

shortcut] for steps 2 and 3 

1. In the text frame, scroll down to the correct alphabetical position
2. Add your entry as:
   
   *[[lingoKeyword]]
   
   The asterisk makes the entry appear as a separate bullet point.
3. Click on the "Save Page" button under the text frame
4. In the main frame, scroll to the entry that you have just created
5. Click on it: a new page will open for you to edit.
6. Paste the copied source code into the new page
7. Start editing

Sample page

Imports a file into a cast member. This works for most of member types. Returns a boolean value that is TRUE when the operation worked, or FALSE if otherwise.

Syntax

from MX 2004 Documentation

 member.importFileInto(fileOrUrlString, (additional Options As List))

Syntax from MX Technote

 member.importFileInto(fileName{, [#dither:True/False, #trimWhiteSpace:True/False]})
 member.importFileInto(fileName {,[#dither:True/False,#trimWhiteSpace:True/False]})
 member.importFileInto(URL {,[#dither:True/False, #trimWhiteSpace:True/False]})

Undocumented Syntax

Director 10.1: The propList might also contain the undocumented:

 #mapImageToStage: FALSE

This prevents that the new member will get the bitdepth of the stage on importFileInto.

Bugs/Quirks/Problems

The undocumented #mapImageToStage:False adresses the problem, that importFileInto always uses the current bitDepth of the stage. With this you can set it to use always 32bit, but there is no way to define a lower bitdepth. So you cannot create an 8bit member with this command.

The only workaround is to create dummy members, that have the desired bitdepth, and then to duplicate it, and make the changes via copyToClipBoard and pasteClipBoardInto. See unlinking external files for details.

Related Note

Another way to use external files is to link your members and set their fileName.

See also

unlinking external files

External links

• [http://www.macromedia.com/devnet/mx/director/articles/multimedia_postcards.html

MM Tutorial: Dynamic Run-time Linking to External Media with Director MX 1]

• [http://www.macromedia.com/devnet/mx/director/articles/external_media.html

MM Tutorial: Dynamic Run-time Linking to External Media with Director MX 2]

• [http://www.macromedia.com/support/director/ts/documents/importfileinto_doc.htm

Director MX Technote for importFileInto command]

• [http://www.hoeben.net/node/view/53

Note about the undocumented feature at the blog from hoeben.net]

Source for sample page

{| border="1" cellpadding="2" cellspacing="0" width="400" align="left" style="margin-left:1.0em;"
!colspan="2" style="color: white;" bgcolor="#AAAADD"|<code>importFileInto</code>
|-
|Type:
|[[method]]
|-
|Version:
| ?
|-
|Language:
|[[Lingo]], [[JavaScript]]
|-
|Dependencies:
|none

|-
!colspan="2" style="color: white;" bgcolor="#AAAADD"|Links/Related
|-
|colspan="2"|[[newMember]], [[unlinking external files]]
|}











Imports a file into a cast member. This works for most of member types.
Returns a boolean value that is [[TRUE]] when the operation worked, or [[FALSE]]
if otherwise.

==Syntax==
===from MX 2004 Documentation===
  member.importFileInto(fileOrUrlString, (additional Options As List))

===Syntax from MX Technote===
  member.importFileInto(''fileName{, [#dither:True/False, #trimWhiteSpace:True/False]}'')
  member.importFileInto(''fileName {,[#dither:True/False,#trimWhiteSpace:True/False]}'')
  member.importFileInto(''URL {,[#dither:True/False, #trimWhiteSpace:True/False]}'')

===[[Undocumented]] Syntax===
Director 10.1: The [[propList]] might also contain the undocumented:
  #mapImageToStage: FALSE
This prevents that the new member will get the [[bitdepth]] of the stage on importFileInto.

==Bugs/Quirks/Problems==
The undocumented #mapImageToStage:False adresses the problem, that importFileInto
always usesthe current [[bitDepth]] of the stage. With this you can set it to use always
32bit, but there is no way to define a lower bitdepth. So you cannot create an 8bit
member with this command.

The only workaround is to create dummy members, that have the desired bitdepth,
and then to [[duplicate]] it, and make the changes via [[copyToClipBoard]] and
[[pasteClipBoardInto]].  See [[unlinking external files]] for details.

==Related Note==
Another way to use external files is to link your members and set their [[fileName]].

==See also==
[[unlinking external files]]

==External links==
*[http://www.macromedia.com/devnet/mx/director/articles/multimedia_postcards.html
MM Tutorial: Dynamic Run-time Linking to External Media with Director MX 1]
*[http://www.macromedia.com/devnet/mx/director/articles/external_media.html
MM Tutorial: Dynamic Run-time Linking to External Media with Director MX 2]
*[http://www.macromedia.com/support/director/ts/documents/importfileinto_doc.htm
Director MX Technote for importFileInto command]
*[http://www.hoeben.net/node/view/53
Note about the undocumented feature at the blog from hoeben.net]

[[Category:Dictionary]] [[Category:Lingo]] [[Category:JavaScript]]