BBD | manual

1. About BBD

Basuka Book Designer (BBD) is a set of actions with Javascript code for Adobe Photoshop® that enables you to design photo books in a quick and efficient manner.

This manual describes version 1 of BBD and all other versions 1.x that might appear later to fix potential bugs.

2. System requirements

Note: if you are using Windows Vista you must first right-click on the Photoshop icon and select Run as administrator before you run the installation script (as described below). You only need to run as administrator during the installation process.

This manual and distribution is intended for Adobe Photoshop CS3, CS4 or CS5. It doesn't matter whether you are using Mac OS X, Windows XP, Vista or Win 7. You need to have a certain amount of Photoshop experience since the whole point of BBD is that all of the Photoshop commands are available at any time during the layout process.

After ordering BBD, you should have a zip file with the current version. Make sure the zip file is unpacked before you proceed. We will refer to this folder as your BBD folder. Your BBD folder should contain a small number of jsx files and look something like the screendump on the right.

The rest of the installation takes place from within Photoshop.

3. Launching the install program

Everything related to installation is handled by one script: install.jsx

You will be presented with the following screen:

3.1 Uninstalling previous versions

Before you install this version of BBD you may want to uninstall previous versions if you have been beta-testing previous versions of BBD. You are not required to do this, it is only for cosmetic reasons: your Bridge menu will not have two menu options to add images and there will be fewer scripts in Photoshop’s File > Scripts menu.

3.2 Getting the activation code

For security reasons you first need to register your copy of BBD in order to obtain an activation code: simply email me the characters (use copy & paste) and I will reply with your activation code as soon as I can. You can click on Stop and re-run the script later when you receive your activation code.

If you move to a new machine or update Photoshop, you need to register again to obtain a new activation code. It doesn’t cost anything and I will be happy to help you.

Once you have received your activation code you can continue with the installation by clicking on the Install button.

You will be asked to enter your activation code, as shown on the left.

After a few seconds, and if everything goes well, the window below should appear.

If there are any error messages, please review them and contact me if you don’t understand them. If you can, include a screen dump or tell me exactly what the error message was. You can run install.jsx as many times as you want.

If all goes well, the install program copied all the scripts to Photoshop’s script folder. It also generated an action file for your system and stored it in your BBD folder.

Before you load the action file you need to restart both Photoshop and Bridge. When you start Bridge again, it may ask you if you want to activate the scripts - answer “Yes”.

You can then load the action file, either by double clicking it, or, if that doesn’t work, go to the Actions Palette, open its fly-out menu, choose Load Actions and navigate to the action file. Finally, choose Button mode in the same fly-out menu and you should have a set of colorful buttons like at the top of this document.

Congratulations, you have now successfully installed BBD - now let's start using it!

5. Book pages

A book is produced one page spread at a time. Basuka prints books in many different formats (20x20, 20x30, etc) and there are functions to create blank page spreads for each type of book. You can of course also start with your own blank document, for instance a 10x15 cm 300 dpi thank-you card.

Bear in mind that when pages are submitted to Basuka for printing, the first left page is not used, neither is the last right page.

Create a blank page spread by clicking on New page. BBD will generate a blank page for the book that you have specified in your Preference setting (more on Preference settings later). To simplify the layout process I would recommend that you work in fullscreen mode: tap the F-button until the window frames disappear. In fullscreen mode it is considerably easier to handle the control points that Photoshop places around objects when they are being transformed.

On a blank page spread, a vertical guideline is placed in the gutter. Unlike other book printers, Basuka books are printed with such accuracy that no special consideration needs to be given to the outermost edge of the page spread. However, I would still advise against putting text or other details very close to the edge.

Now start Bridge and select the images you want to appear on the page. Right-click and choose Add image(s) to book and the images should appear on the blank page. (If you do not have this menu, first look in Bridge's preferences under Startup Scripts and make sure BookDesigner-Add is checked. If it is, and it is still not working, please contact me.)

You can import all images that Photoshop understands: JPEG, GIF, Photoshop's own PSD files, etc. But I would recommend that you only import finished and flattened files since BBD isn't suitable for, e.g., RAW conversion or black-and-white conversions, even if it is possible. Spending too much time working on the individual images will be lost work if you must re-design the page from scratch.

When images appear on the blank page they are converted to smart objects, a recent feature introduced in Photoshop CS2. Smart objects enables you to shrink and enlarge images back and forth without quality loss. Even if the page is saved and later loaded, your images have not lost any quality.

Before we proceed with the layout functions we need to mention color spaces. In BBD all templates are in the Adobe RGB color space. Your images may be stored in another color space, for instance the smaller sRGB color space. Depending on your Photoshop settings you may or may not get conversion questions when importing files from Bridge. Refer to the Photoshop menu Edit>Color Settings... but make sure this conversion keeps you in Adobe RGB.

6. Actions

Now let us return to the actual design job! The most important thing to do is to press V (Move Tool) and check the Auto Select Layer in the upper left corner. Photoshop will now automatically select the layer corresponding to the image you click on. This makes it possible to drag images around. Simply click on an image before you perform an operation on it.

For instance, if you would like to scale or rotate an image, you first click on it. (You will see that the corresponding layer in the layers palette is selected.) Now press Cmd-T (Ctrl-T in Windows) and control points will be laid out for rotating or scaling the image. Remember to hold the shift key down to maintain the aspect ratio. If the image you are scaling is much larger than the page, some of the control points will appear outside the page. Press Cmd-0 (Ctrl-0 in Windows) to zoom out far enough. In these situations it is very useful to work in fullscreen mode.

At any time you can go back to Bridge, select a few more images and add them to your current page.

Another important feature of Photoshop is the ability to select several images. There are several ways to do this, they all assume you have the Move Tool active.

1. Click on the first image. Then hold down the Shift key and click on the remaining images, or:
2. Click on the first image’s layer in the layers palette. Then hold down Cmd (Ctrl on a PC) and click on the other layers, or:
3. Use the mouse to drag a selection around the images you want to select. This works well if the images you want to select are already grouped together.