RAYLIGHT FOR MAC 2.08

What is new in 2.08

• The Scan Volumes option has been renamed Scan Removable Media.  
• A delete button was added to allow you to remove items in the Other Scan Locations list.  The delete key also works for deleting the selected item.
• A 64 GB option was added to the P2 Options for the Card Size.
• Bug Fix: When the Activation window displays and the serial number had been entered previously and saved in options.txt, the serial number appeared backwards. 
• Bug Fix: The System ID may change on some computers and cause the activation screen to pop up. 
• Bug Fix: In some cases, the default hard drive was being inadvertently scanned when "Scan Removable Media" was selected. This could cause a long delay and it would appear that Raylight was hung up.
• Bug Fix: Remove pulldown was not working if the default Target Frame Rate of 23.976 was used without ever having clicked on the choices for Target Frame Rate.
• Bug Fix: P2 card creation was not working on the PPC architecture.
• Bug Fix: P2 card creation was not handling write failures properly (locked destination folder).
• Other minor fixes.

Requirements

Raylight requires Mac OSX 10.4 or 10.5 and Quicktime 7 or later version. Any version of Final Cut Pro 5 or later versions can be used. Raylight will run on either PowerPC (G5, G4) or Intel processor.  Note that presently with 10.5 (Leopard) you cannot write directly to a P2 card but other functions work normally.

Installation

Raylight requires no installation step. However when you first run the program (release version only) you will be prompted for your serial number and product activation code. The serial number and activation code can be obtained at DVFilm.com/activate If you do not know what your serial number is, there is a link on the activation page to get it.

Using Raylight to Import MXF Files

Insert P2 Card or attach a hard drive, P2 Store, or Firestore device, or attach a camera with P2 Cards. Start Raylight and click "Scan Now." Raylight will scan the cards or drives for video MXF files, and then create MXF file links in the /Users /Shared /Raylight folder on your system drive. Need to scan other locations for MXF files? Read the section "Other Locations" below. The process should take no more than a few seconds. The links appear as Quicktime files but they do not contain any audio or video data, they are just links (Aliases or Data References) to the data in the MXF files. Do not move or delete the MXF files after you have scanned them.  Do not rename the volume name of external drives or P2 cards.  If you do move the MXF files, or rename the external drive or P2 card, they must be rescanned. The link files (extension .MXF.mov) can be opened with Final Cut Pro and can be edited as normal. You can also double-click on the link files in Finder to play back the clip in the Quicktime Player.

Pulldown Options

24PA pulldown, also known as 2:3:3:2 or "Advanced Pulldown", can be removed from 1080i/60 and 480i/60 (NTSC DV, DVCPRO, DVCPRO50) clips, if the "Remove Pulldown" option is selected. You can also use this option to remove 3:2 or 2:2 pulldown from footage recorded at 60P, or 2:2 pulldown from 50P. Be sure to set the Target Frame Rate in the drop-down selector box to 23.976, 29.97, or 25 fps as appropriate. The "Set Frame Rate" option should NOT be used unless you want to change the speed of motion (see next paragraph).

Changing Silent Frame Rate

Select the "Set Silent Frame Rate" option to change the frame rate of slow motion or fast-motion (time lapse) video to be the same as the frame rate in the drop-down selector box. This option only works with silent clips.  For example silent 720/60P footage can be slowed down to 24P for editing.

Background Scanning

Checkmark "Scan in Background" to have Raylight scan all volumes every 10 seconds. Raylight will not overwrite existing links to save on system resources and also to not interfere with the use of the links, so this background scanning can safely be used during editing and other video work. Raylight WILL overwrite the links if you do a manual scan (by clicking the Scan Now button) AND you have the "Overwrite Existing Links" option selected.

Note that starting with version 2, in background scanning mode, Raylight also checks the /Users /Shared /Raylight /Quicktime folder for quicktimes that you exported from FCP (see P2 Maker below).

If you do not wish to scan any mounted volumes you can turn this off in the Scan Filter Options tab of the MXF options drawer.  You can selectively scan specific folders by including folders in the Other Scan Locations (see below).  Scanning of mounted volumes or "Other" folders includes all subfolders.  The 1 or 2 level limit of previous versions has been removed.

Other Locations

Locations other than P2 Cards or volumes containing P2 Card images, for example a P2 folder on your desktop, may be scanned by adding them to the "Other Scan Locations" list. 

If you select "Store Links in Same Location as Source Files" then the links will be stored in the same folder as the video MXF files. This can make it easier to organize the links, however, the MXF files must be rescanned if they are copied to another folder or drive.

The links created by Raylight may be copied or moved to any other part of your computer, including other disk drives, and they will function normally.

If the MXF files are copied or moved anywhere, however, then you must remake the links by clicking "Scan Now." Use the "Overwrite Existing Link Files" option if you need to replace existing links with new ones. In some cases an old link will still function but there is a delay of several seconds while the system searches for the MXF files. If this happens in the Quicktime Player, you can save the link using File->Save and the link will be updated. If it happens in FCP, open the link with QT Player, then File->Save the link.

Limitations of the Demo Version

Note that the demo version limits the video and audio links to 10 seconds or less. In the release version, there is no limit to the length of the video track, and all four audio tracks are linked.

Metadata Options

Raylight reads the .XML files in the CLIP folder to get timecode, pulldown, and metadata. The metadata can be viewed in the Quicktime Player "Movie Properties" if you have the Quicktime Pro license enabled, or in the first or second frame of video by means of a video slate generated by Raylight. If the "Create Metadata Slate" is selected, the slate is written over the first frame of picture so it does not change the length of the clip or affect the soundtrack. If you have the "Frame 2" option selected, the slate replaces frame 2 instead (so that frame 1 will appear as the thumbnail in FCP). If you have a clip that was recorded across more than one MXF file, the slate will only appear on the first file, unless "Always Slate" is selected.

Clip and Folder Naming

Raylight will place the User Clip Name from the metadata in the file name if that option is selected. In the camera select Type 2 metadata so that the User Clip Name will be automatically incremented on each take. Raylight will also put the clips into a folder based on the Program Name metadata item, if "Create Folders by Program Name" is selected, or by the Volume Name (Card Name or Disk Name) if "Create Folders by Volume Name" is selected. Or both if selected. One suggested use is to use Program Name for the title of a movie, and User Clip Name for the shot number, eg "23A Take ". Another option is to use Program Name for the scene, and simply "Take " for User Clip Name. The camera will append 0001, etc to the name (if Type 2 is selected).

Suggested Workflow

Here is a suggested workflow to improve your productivity and take advantage of the features of Raylight.

1.     The cameraman or assistant camera uses a Mac laptop computer and P2 CMS software (free from Panasonic) to backup the card onto hard drive and rename the clips, and fill in any metadata items such as ProgramName (e.g. "MyFeatureFilm"), UserClipName (e.g. "Scene 23 Take 5"), etc. and give a name to the P2 card, i.e. "MyShootDay1".

2.     The backup drive or the P2 Cards are connected to the editor's computer.

3.     The editor scans with Raylight using the User Clip Name, Volume Name, and Program Name options. The shots are automatically organized into a "MyFeatureFilm" folder in the Raylight folder. Inside the "MyFeatureFilm" folder there will be a "MyShootDay1" folder (the name of the P2 Card).

4.     Then inside the "MyShootDay1" folder will be a number of .MXF.mov Raylight link files, beginning with "Scene23 Take 5 0001FG.MXF.mov" where 0001FG.MXF is the first clip that was shot on that day.

5.     If an external drive is used for editing, then the Raylight links should be moved to the drive and backed up along with the card images. If the drive is moved to another computer, the links will still function as long as the structure of the drive is not changed and the volume name of the drive is not changed. Also the other computer does not need to have Raylight installed. The link files, once they are created, are completely handled by Quicktime without help from Raylight.

Timecode

Raylight converts timecode from the .XML file into Quicktime timecode. If pulldown is removed, the starting timecode is converted from 30 fps to 24 fps format. Because of this you may see a difference between the starting timecode on the metadata slate and the starting timecode as reported by FCP. For example 15 in 30fps format equals 12 in 24fps format.

P2 Maker

P2 Maker is a new feature with release 2. It allows you to create new P2 Cards from FCP.

Select Background Scanning and export a Quicktime from FCP into the /Users /Shared /Raylight /Quicktime folder. Or, Drop a DV, DVCPRO, DVCPROHD or DVCPRO50 Quicktime into the Raylight window. The P2 Maker drawer will open. Enter any metadata you wish to be stored in the card or press Import Data to copy metadata from an existing .XML clip file. Press Start in the Drawer to start the conversion to P2 Card format.

The Card image will be stored in the Raylight/P2Cards folder. Raylight will also copy data directly into a P2 Card if you wish. Click on Destination Change to change the destination. Be sure the card's write protect tab is in the write position. If you are using the Dual Systems Adaptor (express card to P2 Card adaptor) be sure to install the appropriate drivers. If the P2 Card is in the camera, install the Panasonic P2 card drivers and use the USB connection instead of Firewire (Firewire connection to the Mac is read-only). Also your camera must be updated to the latest firmware, (the version that supports 16GB P2 cards). Consult your camera manual for more information on using the camera's "PC Mode" for reading and writing to the P2 Cards.

You may change the folder that Raylight scans for new Quicktime files to appear. Click Scan Folder Change button. Use Reset to back to the default location.  Select Open to load a new quicktime file.

Select the Clear button to clear the current quicktime file loaded and any meta data fields. If background scanning is enabled the same file cleared will be rediscovered.  You can use the Skip button to skip the currently loaded or discovered file and it will not get rediscovered.

Note the audio format in the QuickTime must be uncompressed ("Linear PCM") 16-bits/sample. One stereo or 4 mono tracks are acceptable. These are the defaults settings for exported DVCPROHD projects.

Starting with version 2.07, file locks on the P2 Card folders and files are automatically bypassed by Raylight so you do not need to remove them yourself.

Limitations

Do not use Disk Images (dmg) with MXF files to edit with Raylight. There will be a 100% performance penalty due to the way the links are de-referenced by Final Cut Pro and Quicktime, which means you may not have real-time playback. Instead use your MXF files in a CONTENTS/VIDEO folder just as they would appear in a P2 Card folder, and put the CONTENTS folder in the root folder of your system drive, P2 Card, or media hard drive.

Currently Supported formats: 1080i60, 1080i50, 1080/30P, 1080/25P, 1080i/24PA, 720/24PN, 720/24P, 720/30PN, 720/30P, 720/25PN, 720/25P, 720/60P, 720/50P, DVCPRO50 60i/NTSC, DVCPRO50 50i/PAL, DVCPRO50 60i/24PA, DVCPRO50 50i/25P, DV-PAL, DV-NTSC, DVCPRO PAL, DVCPRO NTSC.

Known Issues

Raylight does not work with non-English characters in volume names, folder names, etc. and the folder names must be less than 32 characters.

You cannot import two P2 Cards or Disk Drives that have the same exact name. Rename the first one before connecting the second one.

Some versions of FCP do not install a version of the Quicktime DVCPROHD codec that works with Intel processors and the Quicktime player. For example, if you have FCP 5.0, you cannot play DVCPROHD on an Intel processor, only a G5/G4 processor. If you are using 720p50 DVCPROHD format, you must have FCP 6 or later.

Known issues with P2 Maker function:

1.     Raylight will not split a clip across P2 Cards.

2.     Clips that span files (clips that are >4GB) are not logically linked, so FCP and Raylight will not import them as one clip, but as multiple clips.

TroubleShooting Guide

Problem: there is a warning about illegal characters. Solution: rename your folder or volume (card or disk drive name) using characters A-Z, a-z, 0-9.

Problem: there is a warning about folder names too long. Solution: rename your volume (card name or disk drive name) using 31 characters or less.

Problem: Raylight does not find any MXF files, and no links appear in /Users /Shared/ Raylight. Solution: be sure to check the output window for messages indicating what files were found or any files that were skipped.  Options for Raylight are stored in the file options.txt found in the /Users/Shared/Raylight folder on your system drive.  You can set the option LogVerbose to 1 (LogVerbose = 1) to see more detailed information during scanning.  In general, it is not recommended you leave this on, important messages will be shown in the output window without this option.

Problem: clips on 2^nd P2 Card only: they play back with noise frames and audio noise. Solution: rename P2 Cards when you connect them so you do not have 2 cards with the same name,

Problem: Raylight creates the links, and I can see the metadata slate, but the video is all white or all black, or random noise. Solution: delete the link and rescan the MXF files. Make sure each folder in the path to your MXF files has a folder name less than 32 characters. Make sure the drive is formatted Mac OS Extended if you use long file names such as file names with the MetaData "User Clip Name". Make sure you have the DVCPROHD components installed by FCP 5 or 6. They are in the Library/Quicktime folder on your system drive, six files that start with "DVCPROHD" and end with ".component"

Problem: I see the clips and the slate in FCP but not in the quicktime player. Solution: no solution right now for Intel processor and FCP 5.0 or earlier versions. Later releases of Raylight will include the DVFilm DVCPROHD codec for systems that do not have FCP installed.

Problem: I moved the MXF files to another computer and now the links do not work. Solution: after moving the MXF files to the 2^nd computer, delete the links and rescan the MXF files with Raylight running on the 2^nd computer. OR, move the link files so that they live in the same folder as your card images. Reconnect the links in FCP so that FCP can find them in their new location, and save the project. Then if the project needs to be moved to another computer, move the drive in its entirety to the other computer without changing the volume name, or if the files must be copied or uploaded to a server, copy the entire contents of the drive and use the same volume name for the destination drive.

Questions? Go to DVFilm.com and click on Support, Support Request.

c.2008 DVFilm