# Layout Tool Troubleshooting

This section explains some of the error messages or problems you can encounter while running the layout tool and provides possible solutions.

### Error Message: Layout failed; unable to allocate avatar(s)

The placement of avatars can result in insufficient contiguous space for a large file and result in following message:

``

    layout failed: unable to allocate avatar(s)
    for:MyReallyBigMovieFile

If that message appears, increase the total amount of space assigned to the image file or reduce the number of avatars.

### Error Message: CD Image creation error: "Could not assign avatar(s) for launchme"

This message indicates the layout tool could not write all the avatars because the cdrom.tcl file did not allocate enough space for the image. Try the following:

1. In the cdrom.tcl file, increase the amount of space allocated for the cdrom.image file by editing the following line:

     `set megabytes n`
     `((size of takeme folder) * 1.1)`

2. Decrease the number of directory avatars or root avatars in the cdrom.tcl file.

### Error Message: CD Image creation error: "Unable to match glob patterns"

There is an empty folder in the directory you created; remove it.

### Problem: Title does not run

To track down the problem, ask yourself the following questions:

- Are there hard-coded pathnames using /remote in your program? Your program must use aliases to `$boot`, which the system sets to /remote when running through the Debugger, and to /cd-rom when running from the CD-ROM image or disc.

- When testing in Debugger mode, make sure to set the `$boot` alias to `/cd-rom` before running your application. On the command line in the Debugger, type the following:

  `alias boot /cd-rom`

- Then run launchme.

- Make sure that you use the version of the layout tool distributed with the most recent release of 3DO software.

- When your application reads files from the CD-ROM, it must read an integral number of disc blocks. For example, if `Cmd_Status` reports that the blocksize is 2048 and the file size is 3277 bytes, the program must read 4096 bytes.

### Message: "O/S error -34 allocating space"

This error indicates that there is not enough contiguous space on the hard drive to lay down the CD-ROM image. Remember you need the amount of space you have defined in the cdrom.tcl file. You can also edit the cdrom.tcl file so the layout tool places the cdrom.image file on a hard disk that has enough space.

Note: Consider defragmenting your hard disk if you have this problem.

### Problem: Layout is very slow

If you're using a Macintosh operating system earlier than 7.5, set file caching to 32 KB to speed up the layout tool. Note that this should not be necessary with the layout tool included with 3DO Portfolio 2.5.