MediaScript Objects and Methods 101
•
•
•
•
load()
Loads an image into the Media object from the specified file. The following file formats
support the CMYK color-space: “.psd”, “.tif”, and “.jpg”.
NOTE: In MediaRich version 3.6, load() no longer does any color conversion. For instance,
additional parameters for Color Profile Specifications srcProfile, destProfile, and
intent parameters are no longer supported.
You must now explicitly call convert() or
colorConvert() to change the type of an image.
Syntax
load(
[name @ <"filename", "http://server_name/../filename",
"ftp://username:password@ftp.server_name/../ filename",
"ftp://ftp.server_name/../filename", "virtualfilesystem:/filename">]
[type @ <"typename">]
[detect @ <true, false>]
[transform @ <true, false>] // (FPX files only)
[layers @ <"layer list">] // (PSD files only)
[temporaryFileName @ <"filename">]
[collapsed @ <true, false>] // (PSD files only)
[VisibleOnly @ <true, false>] // (PSD files only)
[PreviewAlpha @ <true, false>] // (PSD files only)
[transform @ <true, false>] // (FPX files only)
[fillalpha @ <true, false>] // (PNG files only)
[screengamma @ <value 0..10>] // (PNG files only)
[waplook @ <true, false>] // (WBMP files only)
[dpi @ <value 1..32767>] // (EPS, PDF, and PS files only)
[LoadMetadata @ <true, false>]
);
Parameters
name - specifies the filename and path (full or relative) of the file to be loaded. By default,
MediaRich looks for media in the read file system which points to the following directory:
MediaRich/Shared/Originals/Media.
You can modify the MediaRich server’s local.properties file to change the default
Media directory. See the MediaRich Administrator’s Guide for more information. You can also
load a file from an HTTP or FTP URL using the name parameter.
NOTE: The functionality of loading files from HTTP or FTP sources is disabled by default for
security reasons. Contact your MediaRich Administrator to enable this functionality.
type - specifies the expected file type; otherwise the type is derived from the file extension.
Valid type names are: “bmp”, “eps”, “flashpix”, “gif”, “jpeg”, “png”, “pict”, “pcx”, “pdf”,
“photoshop”, “ps”, “tiff”, “targa”, and “wbmp”.
NOTE: Some image formats are module and/or platform specific. Please visit the support section of
the Equilibrium website for the most current list.
