TweetFollow Us on Twitter

Fun With Quartz Composer

Volume Number: 21 (2005)
Issue Number: 5
Column Tag: Programming

Fun With Quartz Composer

by Scott Knaster

Have you seen the incredible RSS Visualizer screen saver in Mac OS X Tiger? If you haven't, go check it out now: you'll find it in the Desktop & Screen Saver panel in System Preferences. Figure 1 gives you the flavor of what it looks like, but you really have to see the words swooping and twisting around on the screen to get the full astonishing effect.

Figure 1. RSS Visualizer is a hypnotically cool screen saver.

One of the best things about RSS Visualizer is that it wasn't created in the old-fashioned screen saver way by writing a little Cocoa program. Instead RSS Visualizer was built with no code whatsoever using a remarkable new tool called Quartz Composer. In this article, we're going to take a look at Quartz Composer and get a feel for what it does and how it works.

Quartz Composer is an application included with Xcode Tools 2.0. Quartz Composer lets you play with and learn about the cool Quartz graphics features built into Tiger without having to study APIs or write code. Documents you create with Quartz Composer, called compositions, can be turned into QuickTime movies or OS X screen savers. In this article, we'll use Quartz Composer to create a nifty screen saver without very much effort. It will take a little while to follow all the steps, but I promise the results will be worthwhile.

Here's a friendly warning: Quartz Composer is supercool and highly addictive. Before you start using it, be sure you have several hours (or perhaps an entire night) to dive in and try things out, because you might find it hard to walk away.

And now, let's get started.

Compose Yourself

To begin, go to /Developer/Applications/Graphic Tools and run Quartz Composer. As the program starts up, you might get an alert complaining that your Mac's video hardware won't support all the program's greatest features, but that's OK. If you get the alert, read what it says and click Continue.

Next, you see the New Composition Assistant offering several types of templates to start our composition. For this example, we're going to start from scratch, so just click Cancel to make the Assistant go away.

Use File > New to create a new, empty composition. You see two windows: The one that looks like a checkerboard is called the viewer; and the other is the editor.

On the left side of the editor window, make sure Patch Library is selected. In Quartz Composer, a patch is an individual graphical element or process. Patches are the building blocks you use to make compositions. We'll start this one with a cube. Look down the Name column in the Patch Library until you find the patch named Cube--it's in the Renderer category. Double-click Cube to add a cube patch to the composition. Instantly, if not sooner, a box labeled Cube shows up in the editor. There's also a cube showing in the viewer--you can't see it, because it has no color or texture yet, but you can tell it's there because it's blotting out the grid background (Figure 2).

Figure 2. Our composition starts with a cube. We only know it's there because part of the background is obscured in the viewer window.

Let's be honest about this: our cube is totally boring right now. Why, it's barely a cube at all. But if you take a look at the cube patch in the editor, you see that it has a bunch of values we can use to fill it that should make it far more interesting. Let's start by putting something on the front of the cube. In the Patch Library, find Image Importer (it's in the Generator category) and double-click to add one to the composition.

Note: when you're adding a patch to your composition, there are various ways to find the patch you're looking for. By default, the Patch Library is sorted by category. You might find it more useful to alphabetize the patch names--click the Name column to do that. If you know any part of the name of the patch or category, you can type text in the Search In Libraries field to get instant results. Note that some patches have a bullet in front of their names. The bullet indicates that these patches work best with graphics hardware that's not present on the computer running Quartz Composer, so they will run slowly if used on this computer. (The alert you might have seen when you started up Quartz Composer was warning about this.)

Click the new Image Importer patch to select it. Click the Inspector button in the toolbar (you can also choose Editor > Show Inspector or press Command-I).

In the Inspector, click the pop-up menu and choose Settings.

Face Front

Now you need to find a nice picture to put on a cube face. Click Import From File and navigate to any image you want in almost any format, including JPEG, TIFF, PNG, TIFF, and PDF. For best results, pick an image that's square or nearly so. If you can't find any images you like, look in the current user's Pictures folder. When you locate the image you want to use, double-click it. If you prefer, there's a cool shortcut: Drag an image file and drop it into the Image Data area in the Inspector. The image you picked should appear in the Image Data area.

Now we'll tell the cube to display the image you selected. In the editor, click the little circle next to the word Image in the Image Importer and drag to the circle next to Front Image in the Cube patch. You should see a spaghetti-like strand of yellow wire strung between the two circles or ports (Figure 3). Take a look in the viewer window--the cube now has the selected image on its face. It's not so lame any more.

Figure 3. All my tubes and wires, careful notes, and antiquated notions.

One of the most powerful features of Quartz Composer is its ability to create compositions that don't just sit there--they live, breathe, and move. To make your cube get active, you must change some of its settings repeatedly over time. In particular, if you change the rotation settings, the cube changes its orientation, and you see different parts of it. By changing the rotation values over and over, the cube spins. Quartz Composer includes a patch called an Interpolation that supplies an ever-changing stream of values. Find Interpolation in the patch library and double-click to add one to the composition.

Click the interpolation patch to select it, and then click Inspector to see its values. We want the cube to rotate by varying its orientation between 0 and 360 degrees, so we ask the interpolation to supply values that go from 0 to 360. In the Inspector, click the pop-up menu and choose Input Parameters. Leave Start Value at 0 and change End Value to 360. The Duration value determines how many seconds it takes to complete the interpolation. Set that value to 20. Leave the other values as they are.

Now that you have a source of values from 0 to 360, you need to supply those values to the cube for its rotation. Drag from the Result port of the Interpolation to the X Rotation port of the cube. Take a look at the viewer window. The cube is in motion! You should see the cube tumbling endlessly forward, all faces white except for the front, which still has an image on it. That's pretty neat, but we're just getting started.

Getting To Spin Alley

Because the cube is only changing its x-rotation, we never see its left and right sides. To fix that, we can spin the cube on its y-axis at the same time, and offset the z-rotation a bit (but not change it continuously). In the editor, drag another connection from the Results port, this time hooking it to the cube's Y Rotation. Click the Cube patch, and then click the Inspector button. Go to the Input Parameters panel. In the Z Rotation field, type 90, and then close the Inspector. Now the cube is tumbling, and all six faces eventually come into view.

Quartz Composer is drawing the cube over and over again, but something is missing: You see only one frame of the cube animation at a time. What's happening to the previous frames? As a development and debugging aid, Quartz Composer automatically erases the viewer before every redraw. This automatic erasing won't happen when you use the composition outside Quartz Composer. To see what that will look like, choose Viewer > Disable Background Erasing and take a look at the viewer. You soon get a big smear of cubes everywhere it's been drawn (Figure 4). That's not what you want. To prevent this from happening, you need a patch that erases each old frame of the cube before drawing a new one. Find the Clear patch in the Patch Library and double-click to create one.

Figure 4. The cube draws over itself repeatedly and eventually creates a big ugly mess.

You've added the Clear patch, and now the viewer window is...completely black! Nice job, Picasso! What's gone wrong? Take a look at the yellow numbers in the upper-right corner of the Cube and Clear patches. The number for Cube is 1, and Clear is 2. These numbers represent the rendering layer for each patch. Because the Clear patch was just added, it got rendering layer 2, the last layer in this composition. Quartz Composer draws compositions into an offscreen buffer, then moves the result onto the screen. Compositions are processed in order of their rendering layers. So each time through the composition, the cube is drawn (rendering layer 1), then cleared to black (rendering layer 2), then drawn on the screen! That's why you're seeing only a black screen in the viewer.

To fix this problem, we need to reverse the order: clear the screen first, and then draw the cube. To make this change, Control-click the title of the Clear patch and choose Rendering Layer. Now pick Layer 1. Note that the Rotating Cube's layer automatically changes to 2, and in the viewer window, your cube is back with the background now cleared to black, just as nature intended.

Picture This

Sure, you've got a lovely rotating cube, but five of the faces are blank. That's still some boring cube! We can make it better by putting things on the other faces, using various patches to show how cool Quartz Composer is. Start by adding an image from a Web page. Find the Image Downloader patch and double-click to add one. Open the Inspector, go to the Input Parameters panel, and type into the Image URL field.

Connect the Image port of the Image Downloader patch to the cube's Left Image port. The Web image should instantly appear on the right face of the tumbling cube. (If it doesn't, double-check to make sure you typed the URL correctly, or type the URL of another image on the web.)

The next face is practical: it's going to show the time of day. To make it, add three patches: System Time, Date Formatter, and Image With String. Run a wire from System Time to Date Formatter via their Time ports. Make a connection from Date Formatter to Image With String using their String ports. Finally, connect the Image output from Image With String to the Right Image port on the cube. Now you have the time of day on the right face of the cube.

The time display is kind of messy: it's scaled and hard to read, certainly not up to our fancy-pants graphics standards. Let's fix that. Click Image With String, then click Inspector, and go to the Settings panel. Change both the Horizontal and Vertical Alignment to Center. Pick a different font if you like. Click Fixed Dimensions (in pixels). Fill in an Image Size of 1024 by 1024, and a font size of 200. Ah, the time now looks a lot better.


Wouldn't it be cool if one of the cube faces continuously showed a QuickTime movie clip? Let's do it. Add an Image With Movie patch to the composition and open the Inspector. Go to the Input Parameters panel and type the path to a QuickTime movie (for example, /Users/yourName/Documents/, or download a movie trailer from and then type its local path). Connect the Image With Movie patch's Image output to the Cube's Top Image input. Take a look at the viewer--you should see the movie playing on the cube's top face as it rotates into and out of view. Awesome! Figure 5 shows the composition at this point.

Figure 5. The composition now has images on four faces (this picture shows three).

There are still two blank faces on the cube, but I'll leave those to you and your creativity now that you have a feel for how it works. Here are some ideas you can use to dress up those faces:

Use a Host Info patch to display various bits of interesting and obscure information, such as the current user name, computer name, OS version, or CPU load.

Set the background color of the cube faces by using the Inspector to change the Front Color, Left Color, and so on.

Hook an Interpolation patch to an RGB Color patch to continually change the colors you put on the faces.

When you're all done with the cube, it's easy to make it into a screen saver. Just use File > Save As and navigate to the current user's Library/Screen Savers folder. Save the composition into that folder. When you go to System Preferences and click Desktop & Screen Saver, you see your composition at the bottom of the list, available as an official screen saver. Click, select, and enjoy.

Note that when you install Tiger, it doesn't create the user's Library/Screen Savers folder by default. If you navigate there and find no such folder, you can click the New Folder button in the Save dialog to create it.

Like Disneyland, a Quartz Composer document is never truly finished as long as there is imagination left in the world. If you want to play more with Quartz Composer, here are a just a few of the many interesting features you might want to investigate:

Use a Lighting patch to get the nifty effect of shining a light on objects in your composition.

Check out the Clip Library in the editor window to add a pulsating Apple logo or shimmering background.

Add a Mouse controller to use the mouse to slide your objects around on the screen. This won't work in a screen saver because moving the mouse deactivates the screen saver.

Grab a Random patch to feed random inputs to an object, such as the location values for a cube, to make it warp around the screen.

Tiger's RSS Visualizer screen saver, built with Quartz Composer, uses patches that read RSS feeds and display them in a composition, among many other cool features. You can open RSS Visualizer in Quartz Composer and spend hours or days studying it. If you do, you'll get a strong education in the features of Quartz Composer.

For more ideas about what you can do with Quartz Composer, check out the folder at /Developer/Examples/Quartz Composer. Quartz Composer is an amazing tool for creating beautiful images without any programming. Enjoy exploring it - but don't forget to go back to your regular life from time to time.

Scott Knaster lives a glamorous life that consists mostly of sitting in a chair and typing on a keyboard. Scott recently completed his latest book, Hacking Mac OS X Tiger, to be published in July by Wiley. This article is based on material in that book. Scott is a recovering Quartz Composer addict.


Community Search:
MacTech Search:

Software Updates via MacUpdate

Monosnap 3.4.11 - Versatile screenshot u...
Monosnap lets you capture screenshots, share files, and record video and .gifs! Features Capture Capture full screen, just part of the screen, or a selected window Make your crop area pixel... Read more
Yummy FTP Pro 2.0.3 - $29.99
Yummy FTP Pro is an advanced Mac file transfer app which provides a full-featured professional toolkit combined with blazing speeds and impeccable reliability, so whether you want to transfer a few... Read more
Smultron 10.1.3 - Easy-to-use, powerful...
Smultron 10 is an elegant and powerful text editor that is easy to use. You can use Smultron 10 to create or edit any text document. Everything from a web page, a note or a script to any single piece... Read more
Time Out 2.4 - Break reminder tool with...
Time Out helps remind you to take work breaks throughout the day. It has two kinds of breaks: a "Normal" break, typically for 10 minutes after 50 minutes of work, so you can move about and relax,... Read more
Iridient Developer 3.2.2 - Powerful imag...
Iridient Developer (was RAW Developer) is a powerful image-conversion application designed specifically for OS X. Iridient Developer gives advanced photographers total control over every aspect of... Read more
DesktopLyrics 2.6.13 - Displays current...
DesktopLyrics is an application that displays the lyrics of the song currently playing in "iTunes" right on your desktop. The lyrics for the song have to be set in iTunes; DesktopLyrics does nothing... Read more
BusyContacts 1.2.8 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
iClock 4.2.5 - Customizable menu bar clo...
iClock replaces the old Apple's default menu bar clock with more features, customization and increases your productivity. Features: Have your Apple or Google calendar instantly available from the... Read more
Dropbox 45.4.92 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keeps them up-to-date between systems... Read more
MacFamilyTree 8.3.4 - Create and explore...
MacFamilyTree gives genealogy a facelift: modern, interactive, convenient and fast. Explore your family tree and your family history in a way generations of chroniclers before you would have loved.... Read more

Latest Forum Discussions

See All

How PUBG, Fortnite, and the battle royal...
The history of the battle royale genre isn't a long one. While the nascent parts of the experience have existed ever since players first started killing one another online, it's really only in the past six years that the genre has coalesced into... | Read more »
Around the Empire: What have you missed...
Oh hi nice reader, and thanks for popping in to check out our weekly round-up of all the stuff that you might have missed across the Steel Media network. Yeah, that's right, it's a big ol' network. Obviously 148Apps is the best, but there are some... | Read more »
All the best games on sale for iPhone an...
It might not have been the greatest week for new releases on the App Store, but don't let that get you down, because there are some truly incredible games on sale for iPhone and iPad right now. Seriously, you could buy anything on this list and I... | Read more »
Everything You Need to Know About The Fo...
In just over a week, Epic Games has made a flurry of announcements. First, they revealed that Fortnite—their ultra-popular PUBG competitor—is coming to mobile. This was followed by brief sign-up period for interested beta testers before sending out... | Read more »
The best games that came out for iPhone...
It's not been the best week for games on the App Store. There are a few decent ones here and there, but nothing that's really going to make you throw down what you're doing and run to the nearest WiFi hotspot in order to download it. That's not to... | Read more »
Death Coming (Games)
Death Coming Device: iOS Universal Category: Games Price: $1.99, Version: (iTunes) Description: --- Background Story ---You Died. Pure and simple, but death was not the end. You have become an agent of Death: a... | Read more »
Hints, tips, and tricks for Empires and...
Empires and Puzzles is a slick match-stuff RPG that mixes in a bunch of city-building aspects to keep things fresh. And it's currently the Game of the Day over on the App Store. So, if you're picking it up for the first time today, we thought it'd... | Read more »
What You Need to Know About Sam Barlow’s...
Sam Barlow’s follow up to Her Story is #WarGames, an interactive video series that reimagines the 1983 film WarGames in a more present day context. It’s not exactly a game, but it’s definitely still interesting. Here are the top things you should... | Read more »
Pixel Plex Guide - How to Build Better T...
Pixel Plex is the latest city builder that has come to the App Store, and it takes a pretty different tact than the ones that came before it. Instead of being in charge of your own city by yourself, you have to work together with other players to... | Read more »
Fortnite Will Be Better Than PUBG on Mob...
Before last week, if you asked me which game I prefer between Fortnite Battle Royale and PlayerUnknown’s Battlegrounds (PUBG), I’d choose the latter just about 100% of the time. Now that we know that both games are primed to hit our mobile screens... | Read more »

Price Scanner via

Sale of the year continues as Apple resellers...
Adorama has new 2017 15″ MacBook Pros on sale for $250-$300 off MSRP. Shipping is free, and Adorama charges sales tax in NJ and NY only: – 15″ 2.8GHz Touch Bar MacBook Pro Space Gray (MPTR2LL/A): $... Read more
Sunday Sales: $200 off 13″ Touch Bar MacBook...
Amazon has new 2017 13″ 3.1GHz Touch Bar MacBook Pros on sale this weekend for $200 off MSRP, each including free shipping: – 13″ 3.1GHz/256GB Space Gray MacBook Pro (MPXV2LL/A): $1599.99 $200 off... Read more
B&H drops prices on 15″ MacBook Pros up t...
B&H Photo has dropped prices on new 2017 15″ MacBook Pros, now up to $300 off MSRP and matching Adorama’s price drop yesterday. Shipping is free, and B&H charges sales tax for NY & NJ... Read more
Apple restocks Certified Refurbished 2017 13″...
Apple has restocked Certified Refurbished 2017 13″ 2.3GHz MacBook Pros for $200-$230 off MSRP. A standard Apple one-year warranty is included with each MacBook, models receive new outer cases, and... Read more
13″ Space Gray Touch Bar MacBook Pros on sale...
Adorama has new 2017 13″ Space Gray Touch Bar MacBook Pros on sale for $150 off MSRP. Shipping is free, and Adorama charges sales tax in NY & NJ only: – 13″ 3.1GHz/256GB Space Gray MacBook Pro (... Read more
Best deal of the year on 15″ Apple MacBook Pr...
Adorama has New 2017 15″ MacBook Pros on sale for up to $300 off MSRP. Shipping is free, and Adorama charges sales tax in NJ and NY only: – 15″ 2.8GHz Touch Bar MacBook Pro Space Gray (MPTR2LL/A): $... Read more
Save $100-$150+ on 13″ Touch Bar MacBook Pros...
B&H Photo has 13″ Touch Bar MacBook Pros on sale for $100-$150 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 13″ 3.1GHz/256GB Space Gray MacBook Pro... Read more
Current deals on 27″ Apple iMacs, models up t...
B&H Photo has 27″ iMacs on sale for up to $150 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 27″ 3.8GHz iMac (MNED2LL/A): $2149 $150 off MSRP – 27″ 3... Read more
Thursday Deal: 13″ 2.3GHz MacBook Pro for $11...
B&H Photo has the 13″ 2.3GHz/128GB Space Gray MacBook Pro on sale for $100 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 13-inch 2.3GHz/128GB Space... Read more
How to save $100-$190 on 10″ & 12″ iPad P...
Apple is now offering Certified Refurbished 2017 10″ and 12″ iPad Pros for $100-$190 off MSRP, depending on the model. An Apple one-year warranty is included with each model, and shipping is free: –... Read more

Jobs Board

Firmware Engineer - *Apple* Accessories - A...
# Firmware Engineer - Apple Accessories Job Number: 113452350 Santa Clara Valley, California, United States Posted: 28-Feb-2018 Weekly Hours: 40.00 **Job Summary** Read more
Automation and Performance Engineer, *Apple*...
# Automation and Performance Engineer, Apple Pay Job Number: 113557967 Santa Clara Valley, California, United States Posted: 09-Mar-2018 Weekly Hours: 40.00 **Job Read more
Hardware Systems Architect - *Apple* Watch...
# Hardware Systems Architect - Apple Watch Job Number: 113565323 Santa Clara Valley, California, United States Posted: 05-Mar-2018 Weekly Hours: 40.00 **Job Read more
Lead *Apple* Solution Consultant - Apple (U...
# Lead Apple Solution Consultant Chicago IL Job Number: 113560644 Chicago, Illinois, United States Posted: 10-Mar-2018 Weekly Hours: 40.00 **Job Summary** As a Lead Read more
Art Director, *Apple* Music + Beats1 Market...
# Art Director, Apple Music + Beats1 Marketing Design Job Number: 113258081 Culver City, California, United States Posted: 07-Mar-2018 Weekly Hours: 40.00 **Job Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.