4
Table Of Contents
- Shake 4 User Manual
- Contents
- Shake 4 Documentation and Resources
- Part I: Interface, Setup, and Input
- An Overview of the Shake User Interface
- Opening Shake
- Overview of the Shake User Interface
- Making Adjustments to the Shake Window
- Navigating in the Viewer, Node View, and Curve Editor
- Working With Tabs and the Tweaker
- Menus and the Title Bar
- Script Management
- The File Browser
- Using and Customizing Viewers
- Using Multiple Viewers
- Looking at Images in a Viewer
- Suspending Rendering and Viewer Redraw
- Controls in the Viewer Shelf
- Using the Compare Buffers
- Viewer Lookups, Viewer Scripts, and the Viewer DOD
- Using the Viewer’s Domain of Definition (DOD)
- Creating Your Own VLUTs and Viewer Scripts
- Viewer Keyboard Shortcuts
- The Viewer Shortcut Menu
- Node-Specific Viewer Shelf Controls
- The Parameters Tabs
- Using Expressions in Parameters
- The Parameters Tab Shortcut Menu
- The Domain of Definition (DOD)
- The Time Bar
- Previewing Your Script Using the Flipbook
- Setting a Script’s Global Parameters
- Adding Media, Retiming, and Remastering
- Using Proxies
- Using Proxies
- Using interactiveScale
- Using Temporary Proxies
- Permanently Customizing Shake’s Proxy Settings
- Using Pre-Generated Proxy Files Created Outside of Shake
- Pre-Generating Your Own Proxies
- Rendering Proxies on the Command Line
- Pre-Generated Proxy File References in FileIn Nodes
- Anamorphic Images and Pre-Generated Proxies
- How Proxy Paths Are Defined
- Proxies of YUV Files
- Organizing Proxy Files
- Full-Resolution Proxies and Network Rendering
- Customizing the Format of Pre-Generated Proxies
- Pre-Generating Proxies Outside of the User Interface
- Using Pre-Generated Proxies in Your Script
- Keeping High-Resolution Elements Offline
- When Not to Use Proxies
- Proxy Parameters
- Compatible File Formats and Image Resolutions
- Importing Video and Anamorphic Film
- The Basics of Processing Interlaced Video
- Setting Up Your Script to Use Interlaced Images
- Displaying Individual Fields in the Viewer
- Integrating Interlaced and Non-Interlaced Footage
- Video Functions
- About Aspect Ratios and Nonsquare Pixels
- What is Anamorphic Video?
- Anamorphic Examples
- Properly Viewing Squeezed Images
- Node Aspect Ratio and the defaultAspect Parameter
- Compositing Square Pixel Images With Squeezed Images
- Inheritance of the defaultAspect Parameter for Individual Nodes
- 3D Software Renders
- Tuning Parameters in Squeezed Space
- Rendering Squeezed Images
- Handling Video Elements
- Preset Formats
- Table of Common Aspect Ratios
- Using the Node View
- About Node-Based Compositing
- Where Do Nodes Come From?
- Navigating in the Node View
- Using the Enhanced Node View
- Noodle Display Options
- Creating Nodes
- Selecting and Deselecting Nodes
- Connecting Nodes Together
- Breaking Node Connections
- Inserting, Replacing, and Deleting Nodes
- Moving Nodes
- Loading a Node Into a Viewer
- Loading Node Parameters
- Ignoring Nodes
- Renaming Nodes
- Arranging Nodes
- Groups and Clusters
- Opening Macros
- Cloning Nodes
- Thumbnails
- The Node View Shortcut Menu
- Using the Time View
- Using the Audio Panel
- Parameter Animation and the Curve Editor
- The Flipbook, Monitor Previews, and Color Calibration
- Rendering With the FileOut Node
- Image Caching
- Customizing Shake
- Setting Preferences and Customizing Shake
- Creating and Saving .h Preference Files
- Customizing Interface Controls in Shake
- Color Settings for Various Interface Items
- Custom Stipple Patterns in the Enhanced Node View
- Adding Custom Media Formats to the Format Menu
- Setting Format Defaults
- Assigning Default Width and Height to a Parameter in a Macro
- Setting Maximum Viewer Resolution in the Interface
- Default Timecode Modes and Displays
- Autosave Settings
- Undo Level Number
- Amount of Processors to Assign to the Interface
- Font Size for Menus and Pop-Up Menus
- Adding Functions to the Right-Click Menu
- Adding Functions Into a Menu
- Opening Scripts With Missing Macros
- Linking an HTML Help Page to a Custom Node
- The Curve Editor and Time Bar
- Customizing File Path and Browser Controls
- Tool Tabs
- Customizing the Node View
- Using Parameters Controls Within Macros
- Assigning a Color Control
- Assigning the Old Color Control
- Changing Default Values
- Grouping Parameters in a Subtree
- Setting Slider Ranges
- Adding Pop-Up Menus
- Creating Radio Buttons
- Creating Push-Button Toggles
- Creating On/Off Buttons
- Making a Parameter Non-Animateable
- Placing a Curve Editor Into a Parameters Tab
- Viewer Controls
- Template Preference Files
- Changing the Default QuickTime Configuration
- Environment Variables for Shake
- Interface Devices and Styles
- Customizing the Flipbook
- Configuring Additional Support for Apple Qmaster
- An Overview of the Shake User Interface
- Part II: Compositing With Shake
- Image Processing Basics
- Compositing With Layer Nodes
- Layered Photoshop Files and the MultiLayer Node
- Compositing With the MultiPlane Node
- Using Masks
- Rotoscoping
- Options to Customize Shape Drawing
- Using the RotoShape Node
- Drawing New Shapes With the RotoShape Node
- Editing Shapes
- Copying and Pasting Shapes Between Nodes
- Animating Shapes
- Attaching Trackers to Shapes and Points
- Adjusting Shape Feathering Using the Point Modes
- Linking Shapes Together
- Importing and Exporting Shape Data
- Right-Click Menu on Transform Control
- Right-Click Menu on Point
- Viewer Shelf Controls
- Using the QuickShape Node
- Paint
- Shake-Generated Images
- Color Correction
- Bit Depth, Color Space, and Color Correction
- Concatenation of Color-Correction Nodes
- Premultiplied Elements and CG Element Correction
- Color Correction and the Infinite Workspace
- Using the Color Picker
- Using a Color Control Within the Parameters Tab
- Customizing the Palette and Color Picker Interface
- Using the Pixel Analyzer
- The PixelAnalyzer Node
- Color-Correction Nodes
- Atomic-Level Functions
- Utility Correctors
- Consolidated Color Correctors
- Other Nodes for Image Analysis
- Keying
- Image Tracking, Stabilization, and SmoothCam
- About Image Tracking Nodes
- Image Tracking Workflow
- Strategies for Better Tracking
- Picking a Good Reference Pattern
- Picking a Good Search Region
- Manually Coax Your Track
- Identify the Color Channel With the Highest Contrast
- Delog Logarithmic Cineon Files Prior to Tracking
- Avoid Reducing Image Quality
- Do Not Track Proxies
- Increasing Contrast and Preprocessing the Image
- Tracking Images With Perspective, Scale, or Rotational Shifts
- Tracking Obscured or Off-Frame Points
- Modifying the Results of a Track
- Saving Tracks
- Tracking Nodes
- The SmoothCam Node
- Transformations, Motion Blur, and AutoAlign
- Warping and Morphing Images
- Filters
- Part III: Optimizing, Macros, and Scripting
- Optimizing and Troubleshooting Your Scripts
- Installing and Creating Macros
- How to Install Macros
- Creating Macros—The Basics
- Creating Macros—In Depth
- Basic Macro Structure
- File Name Versus Macro Name
- Loading Image Macros Into the Interface
- Typical Errors When Creating Macros
- Setting Default Values for Macros
- Changing Default Settings
- Attaching Parameter Widgets
- Inappropriate Behavior in All the Wrong Places
- Making Radio or Toggle Buttons
- Standard Script Commands and Variables
- Macro Examples
- Expressions and Scripting
- The Cookbook
- Cookbook Summary
- Coloring Tips
- Filtering Tips
- Keying Tips
- Layering Tips
- Transform Tips
- Creating Depth With Fog
- Text Treatments
- Installing and Using Cookbook Macros
- Command-Line Macros
- Image Macros
- Color Macros
- Relief Macro
- Key Macros
- Transform Macros
- Warping With the SpeedBump Macro
- Utility Macros
- Using Environment Variables for Projects
- Keyboard Shortcuts and Hot Keys
- Keyboard Shortcuts in Shake
- General Application Commands
- Navigating in Time
- General Windowing Keyboard Shortcuts and Modifiers
- Saving and Restoring Favorite Views
- The Viewer
- Flipbook Keyboard Shortcuts
- Tool Tab Keyboard Modifiers
- Node View
- Selecting Nodes
- Grouping Nodes
- Macro Shortcuts in the Node View
- QuickPaint
- The Curve Editor
- Parameters Tab Shortcuts and Modifiers
- MultiPlane Node Keyboard Shortcuts
- Keyboard Modifiers for Transform and MultiPlane Nodes
- Keyboard Modifiers for Color Adjustments
- Keyboard Shortcuts in Shake
- The Shake Command-Line Manual
- Index
Apple Computer, Inc.
© 2005 Apple Computer, Inc. All rights reserved.
Under the copyright laws, this manual may not be
copied, in whole or in part, without the written consent
of Apple. Your rights to the software are governed by
the accompanying software license agreement.
The Apple logo is a trademark of Apple Computer, Inc.,
registered in the U.S. and other countries. Use of the
keyboard Apple logo (
Option-Shift-K
) for commercial
purposes without the prior written consent of Apple
may constitute trademark infringement and unfair
competition in violation of federal and state laws.
Every effort has been made to ensure that the
information in this manual is accurate. Apple Computer,
Inc. is not responsible for printing or clerical errors.
Apple Computer, Inc.
1 Infinite Loop
Cupertino, CA 95014-2084
408-996-1010
www.apple.com
Apple, the Apple logo, Final Cut, Final Cut Pro, FireWire,
Mac, Macintosh, Mac OS, Nothing Real, QuickTime,
Shake, and TrueType are trademarks of Apple Computer,
Inc., registered in the U.S. and other countries. Exposé
and Finder are trademarks of Apple Computer, Inc.
Adobe is a trademark of Adobe Systems Inc.
Cineon is a trademark of Eastman Kodak Company.
Maya, Alias, Alias/Wavefront, and O2 are trademarks of
SGI Inc.
3ds Max is a trademark of Autodesk Inc.
Softimage and Matador are registered trademarks of
Avid Technology, Inc.
Times is a registered trademark of Heidelberger
Druckmaschinen AG, available from Linotype Library
GmbH.
Other company and product names mentioned herein
are trademarks of their respective companies. Mention
of third-party products is for informational purposes
only and constitutes neither an endorsement nor a
recommendation. Apple assumes no responsibility with
regard to the performance or use of these products.
ACKNOWLEDGEMENTS
Portions of this Apple software may utilize the following
copyrighted material, the use of which is hereby
acknowledged.
Double Negative Visual Effects (OpenEXR): Portions of
the OpenEXR file translator plug-in are licensed from
Double Negative Visual Effects.
FilmLight Limited (Truelight): Portions of this software
are licensed from FilmLight Limited. © 2002-2005
FilmLight Limited. All rights reserved.
FLEXlm 9.2 © Globetrotter Software 2004. Globetrotter
and FLEXlm are registered trademarks of Macrovision
Corporation.
Framestore Limited (Keylight): FS-C Keylight v1.4 32 bit
version © Framestore Limited 1986-2002.
Industrial Light & Magic, a division of Lucas Digital Ltd.
LLC (OpenEXR): Copyright © 2002 All rights reserved.
Redistribution and use in source and binary forms, with
or without modification, are permitted provided that
the following conditions are met:
Redistributions of source code must retain the above
copyright notice, this list of conditions and the following
disclaimer.
Redistributions in binary form must reproduce the
above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other
materials provided with the distribution.
Neither the name of Industrial Light & Magic nor the
names of its contributors may be used to endorse or
promote products derived from this software without
specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.
Oliver James (Keylight 32-bit support): © 2005 Apple
Computer, Inc. All rights reserved.
This new version has been updated by Oliver James, one
of Keylight's original authors, to provide full support for
floating point images.
Thomas G. Lane ( JPEG library ): © 1991-1998 Thomas G.
Lane. All rights reserved except as specified below.
The authors make NO WARRANTY or representation,
either express or implied, with respect to this software, its
quality, accuracy, merchantability, or fitness for a
particular purpose. This software is provided AS IS, and
you, its user, assume the entire risk as to its quality and
accuracy. Permission is hereby granted to use, copy,
modify, and distribute this software (or portions thereof)
for any purpose, without fee, subject to these conditions:
(1) If any part of the source code for this software is










