Quartz Composer

The Quartz Composer 4.0 interface and a composition

Developer(s)| Apple Computer
Stable release|

4.6.2 / December 12, 2016

Operating system| Mac OS X Tiger (Version 2.0)
Mac OS X Leopard (Version 3.0)
Mac OS X Leopard + iPhone SDK (Version 3.1)
Mac OS X Snow Leopard (Version 4.0)
macOS Sierra (Version 4.6.2)
Available in| English
Type| Visual programming language/Software development tool
License| Proprietary
Website| Apple - Quartz Composer (User Guide)

Quartz Composer is a node graph system provided as part of the Xcode development environment in macOS for processing and rendering graphical data. It is capable of making sophisticated animations for keynote or presentations and creating animated screensavers.[1]

Quartz Composer uses OpenGL (including GLSL), OpenCL (only in Mac OS X Snow Leopard and later), OpenAL, Core Image, Core Video, JavaScript and other technologies to create an API and a developer tool around a simple visual programming paradigm. Apple has embedded Quartz technologies deeply into the operating system. Compositions created in Quartz Composer can be played standalone in any QuickTime-aware application[2] (although only on Mac OS X Tiger and later), as a system Screen Saver,[3] as an iTunes Visualizer, from inside the Quartz Composer application, or can be embedded into a Cocoa or Carbon application via supplied user interface widgets. While Quartz Composer is included with the iPhone SDK, as of December 2015[update] there is no way of running Quartz Compositions on iOS devices. Starting in macOS Catalina, the Quartz Composer framework has been deprecated, although it is still present for compatibility.[4]

## Contents

* 1 Patches
* 1.1 Plugins
* 2 Hidden options
* 3 Native datatypes
* 3.1 Type conversion
* 4 Compositions
* 4.1 Composition protocols
* 4.2 Composition runtimes
* 4.3 Composition repository
* 4.4 Comparing compositions
* 5 Related software
* 5.1 Quartz Composer Visualizer
* 5.2 Automator support
* 6 History
* 6.1 Progression images
* 7 References
* 8 External links
* 8.1 Books
* 8.2 Tutorials and documentation
* 8.3 Mailing list
* 8.4 Compositions
* 8.5 Custom patches / plugins
* 8.6 Images and videos

## Patches

Quartz programming through Quartz Composer works by implementing and connecting patches.[5] Similar to routines in traditional programming languages, patches are base processing units. They execute and produce a result. For better performance, patch execution follows a lazy evaluation approach, meaning that patches are only executed when their output is needed. There are three types of patches: Consumers, Processors and External Input patches that can receive and output mouse clicks, scrolls and movements; MIDI and audio; keyboard; or other movements. A collection of patches can be melded into one, called a macro. Macros can be nested and their subroutines also edited.

To control the order of rendering, each renderer is assigned a layer, indicated in its upper-right corner. Layers are rendered sequentially, lowest to highest. Renderers can be enabled or disabled, essentially turning on or off that particular layer. Turning off unused layers often results in better performance, since fewer upstream patches need to be evaluated.

Some patches can have subpatches, which allows for global parameter changes to just the included subpatches. This is useful for lighting, 3D transformation and GLSL shaders, among other things. Subpatch support is indicated by square corners on a patch, rather than the typical rounded corners.

Quartz Composer Multiplexer

With Version 3.0, it became possible to turn compositions into Virtual Patches. These allow the user to reuse functionality without having to store duplicate copies in each composition. The Quartz Composer Editor allows the user to save a "flattened" copy (with the virtual patches fully expanded inside), for easy distribution. Version 4.0 extended this functionality even more and automatically includes "flattened" copies of virtual patches for use as a fallback if the desired virtual patch isn't installed on the host system. This greatly simplifies composition distribution.

Network functionality was greatly improved with the release of Leopard. It became possible to transmit data and synchronize over a network interface and it also added support for Open Sound Control transmission and reception.

### Plugins

The Quartz Composer 3.0 interface

Also new in Version 3.0 was the possibility to write custom patch plugins using an Xcode template, and the notion of a "safe mode" where plugins and other unsafe patches fail to load. This prevents malicious compositions from performing dangerous or insecure operations. Custom patches using Apple's Xcode template are always considered unsafe.

It was possible to develop custom patch plugins for Version 2.0, but the API was undocumented and private and was never supported by Apple. Eventually, templates were released to simplify this procedure.[6]

## Hidden options

In the Quartz Composer editor, holding the option key while selecting "Preferences..." from the menu adds 3 additional tabs of options for the user to configure. These options include System settings, Editor settings and QuickTime integration settings. Notable options include expanded tooltips, software rendering and uncapped framerate rendering. Multisample antialiasing (MSAA) was added as a hidden option in version 4.0, allowing for antialiasing inside the QC Editor, though it only works on GPU's that support MSAA.

## Native datatypes

Data inside QC can be one of the following types:

* Boolean – a Boolean value, 0 or 1
* Index – a positive integer between 0 and 2147483647
* Number – a double precision floating point number
* String – a unicode string
* Color – an RGBA or CMYK quartet, or a Grayscale value
* Image – a 2D image of arbitrary (possibly infinite) dimensions
* Structure – a named or ordered collection of objects, including nested structures
* Virtual – any of the above

Two additional types were introduced in version 4.0:

* Mesh – a collection of vertices and per-vertex normals, texture coordinates and colors in 3-space
* Interaction – a valueless type used to associate user input with user-interactive elements of the composition

### Type conversion

Data can usually be converted to other types transparently. In Quartz Composer 3.0, the connections between patches change color to indicate conversions that are taking place. Yellow connections mean no conversion is taking place, Orange indicates a possible loss of data from conversion (Number to Index) and Red indicates a severe conversion; Image to Boolean, for example.

## Compositions

Quartz Composer documents are called Compositions. Compositions are Binary Property Lists (though XML versions are also supported) with a filename extension .qtz and a `com.apple.quartz-composer-composition` UTI.[7] Patches, their connections and their input port states are saved in the composition file. Images can be stored inside a composition as well, making for self-contained compositions with embedded graphics. By dragging a movie file into the Quartz Composer editor, a reference to the movie file is created, providing a changing image that can be connected to a renderer.

Compositions also store metadata such as composition author, copyright and description. The user can also add arbitrary metadata items, if desired.

Many image formats are supported, including JPEG, JPEG2000, GIF, PNG, TIFF, TGA, OpenEXR, BMP, ICO, PDF, PICT, ICNS and some raw digital camera types.[8] Images are maintained in their native form for as long as possible before rasterizing for display. This means that Quartz Composer will keep vector images as vectors when cropping, scaling, rotating, or translating which allows it to work with very large logical image dimensions without consuming large amounts of memory or processing time. Such functionality is most apparent when working with text-based images, or PDFs.

Version 3.0 added the ability to add annotations to areas of the composition, called notes. These notes parallel comments in other programming languages. Notes can be yellow, red, green, blue, or gray, and can overlap other notes.

### Composition protocols

In Version 3.0, the concept of Composition Protocols was introduced. Protocols provide a template of required and optional inputs and outputs to qualify conforming compositions for various purposes. The following protocols are available by default:

* Graphic Animation – These don't have required inputs or outputs, but are required to render to the screen. Graphic Animations are useful for animated backgrounds in applications such as Keynote.
* Image Filter – Modifies an image using filters. No renderers are allowed in Image Filters, unless they are inside of a Render In Image environment.
* Graphic Transition – Generates a transition from a source image to a destination image over a fixed time interval.
* RSS Visualizer – Parses and Displays an RSS Feed.
* Screen Saver – Integrates with Finder for animated screen savers.
* Music Visualizer – Integrates with iTunes for audio visualization.

There is an additional protocol that Apple uses in their private API:

* Photo Visualizer – Receives an image list, provides information about total image count and currently displayed image.

One new protocol was added in version 4.0:

* Mesh Filter – deforms an input mesh.

There is no officially supported way to add additional protocols to Quartz Composer. However, there are some undocumented methods that may make this possible in the future.[9]

### Composition runtimes

In addition to protocols, compositions can also conform to different runtimes where Quartz Composer is available. In Leopard, there are runtimes for Tiger (32-bit), as well as 32-bit and 64-bit versions of the Leopard Quartz Composer runtime. The editor can also indicate used patches that are unsafe, or unavailable in Tiger to aid in making compatible compositions.

### Composition repository

A System-wide Composition Repository is available as of Version 3.0.[10] This allows applications to share and make use of common compositions for effects and processing. It is also possible for applications to query the repository for compositions that match certain criteria, such as protocol conformance.

The Repository is spread across 3 file system locations:

* /System/Library/Compositions – core system compositions (the user typically doesn't modify these)
* /Library/Compositions – compositions available for all users
* /Users/username/Library/Compositions – compositions available for only this user

Adding compositions to the repository is as simple as adding the composition file to one of these locations.

### Comparing compositions

It became possible to compare compositions in Quartz Composer 3.0. This feature allows the user to compare inputs, rendered output and graph appearance of any two compositions.

## Related software

### Quartz Composer Visualizer

A developer tool called Quartz Composer Visualizer was released with Quartz Composer 3.0 that allows compositions to be rendered across multiple screens on a single machine, or even spanned across several machines and displays.

### Automator support

Support for some Automator actions was added with the release of Leopard.

* Apply Quartz Composition Filter to Image Files
* Convert Quartz Compositions to QuickTime Movies
* Render Quartz Compositions to Image Files

## History

* 2002 - Apple acquired the foundation of its Quartz Composer from Pierre-Olivier Latour, who originally developed the tool under the name PixelShox Studio.[11]
* 2005 - Apple used this foundational technology to develop Quartz Composer, first released in Mac OS X Tiger (version 10.4) as part of the Xcode suite.[12]
* 2007 - Mac OS X Leopard (version 10.5) improved the performance of the Quartz Composer, including integration with OpenCL, idle state rendering, and GPU-efficient geometry pipelines.[13] The system gained a redesigned UI, multitouch support, and new workflow tools like Virtual Macros, Interactive Placement, and an enhanced Patch Library. [13] These improved the performance and hardware rendering.
* 2009 - Alongside Mac OS X Snow Leopard (version 10.6), Quartz Composer 4.0 was released, introducing minor performance upgrades. The UI was refined for better usability including a "snap to grid" feature. It also gained support for a new 3D model importer supporting the Collada (.dae) file format, enabling handling 3D textured meshes within compositions.[14]
* 2011 - Tool became more embedded within Xcode 4.0 toolchain.
* 2014 - With the release of Mac OS Yosemite, Apple released the Metal API designed to replace OpenGL embedded libraries to improve performance on iOS devices.[15] As a result, this shift marked the decline of Quartz Composer, as it was heavily reliant on OpenGL technologies that Metal replaced. Although still supported in Yosemite, it lacked any major updates and was increasingly seen as deprecated.
* 2019 - Quartz Composer became increasingly buggy, and starting in Mac OS 10.15, it was officially marked as deprecated by Apple and removed from Xcode.[16] However, it remained present for compatibility purposes but users were urged to transition to newer frameworks including Metal, SceneKit and Core Image.[16]
* 2021- In Mac OS Monterey, QuartzComposer.mdimporte plugin was removed, signifying Apple's removal of support for Quartz Composer components.[17] Since then, several users reported that the software does not work on Apple M1 laptops.

### Progression images

* QC Leopard (2007)

* QC Snow Leopard (2009)

* QC (2010)

* QC (2010+)

## References

1. ↑ Chen, Jim X.. "Guide to Graphics Software Tools". https://cs.gmu.edu/~jchen/graphics/book/tools/quartzcomposer.htm.
2. ↑ Quartz Composer User Guide
3. ↑ Quartz Composer Users Guide - Making a Screen Saver
4. ↑ Xcode 11 Release Notes
5. ↑ Quartz Composer User Guide - Patches
6. ↑ fdiv.net: Xcode Template for Custom Quartz Composer Patches
7. ↑ Uniform Type Identifiers Overview
8. ↑ Using the ImageIO Framework
9. ↑ Creating Your Own Protocols
10. ↑ Quartz Composer User Guide: Composition Repository
11. ↑ "PixelShox Technology". http://www.polhosting.info/web-archives/pixelshox_technology/.
12. ↑ "Sunsetting Quartz Composer in VDMX6" (in en-US). 2024-11-26. https://vdmx.vidvox.net/blog/sunsetting-quartz-composer-in-vdmx6.
13. ↑ 13.0 13.1 "Quartz Composer Release Note". https://developer.apple.com/library/archive/releasenotes/GraphicsImaging/RN-QuartzComposer/index.html.
14. ↑ vade (2009-08-31). "Mac OS X 10.6: Quartz Composer 4.0 Hands-On Review, New Features" (in en-US). https://cdm.link/mac-os-x-106-quartz-composer-40-hands-on-review/.
15. ↑ Smith, Ryan. "Some Thoughts on Apple's Metal API". https://www.anandtech.com/show/8116/some-thoughts-on-apples-metal-api.
16. ↑ 16.0 16.1 "Xcode 11 Release Notes" (in en-US). https://docs.developer.apple.com/documentation/xcode-release-notes/xcode-11-release-notes.
17. ↑ hoakley (2021-12-14). "What has changed in Monterey 12.1?" (in en). https://eclecticlight.co/2021/12/14/what-has-changed-in-monterey-12-1/.

## External links

### Books

* Quartz Composer Book in Japanese
* Learning Quartz Composer Book & DVD in English

### Tutorials and documentation

* ~~Quartz Composer Programming Guide~~ from Apple (no longer available)
* Quartz Composer tutorials
* Quartz Composer wiki
* kineme.net QC Wiki
* ~~quartzcomposer.com (unofficial website)~~ (no longer available)
* George Toledo's Programming and Design Blog
* Rob Duarte's 2015 series of Quartz Composer tutorial videos
* cybero's Quartz Composer JavaScript guide, blog & other Quartz Composer tutorials
* Quartz Composer interaction design tutorials

### Mailing list

* Mailing List
* Mailing List Archives
* Kineme Quartz Composer, Patches & Plugins forum

### Compositions

* QuartzCompositions.com Forum and Composition Repository
* kineme.net Composition Repository
* ZUGAKOUSAKU
* Quartz Composer Composition Directory
* GLSL, CoreImage & OpenCL Quartz Composer files from toneburst on machinesdontcare
* George Toledo's Programming and Design Blog

### Custom patches / plugins

* vade’s v002 plugins & effects
* Kineme QC Patches
* Google Quartz Composer Patches
* Qtzlcodex Quartz Composer Custom Patches
* _1024 plugins by Francois Wunschel
* Minuek's Quartz Composer Patches
* Paolo Manna QC LuaPlugin
* Open Emu for QC
* Open Frameworks for QC
* Tom Butterworth plugins
* CoGe plugins by Tamas Nagy
* George Toledo's Programming and Design Blog ( a variety of official and non-official api plugins and Xcode projects )
* I Love QC New Site dedicated to learning Quartz Composer, making files and supporting the Pearson Education book Learning Quartz Composer[Usurped!]
* jQC by QCDesigners, an interaction design framework for Quartz Composer
* Facebook Origami, a free design prototyping toolkit for Quartz Composer

### Images and videos

* Quartz Composer on Flickr
* Quartz Composer on Vimeo

Template:MacOS developer tools

0.00

(0 votes)

Original source: https://en.wikipedia.org/wiki/Quartz Composer. Read more

|

Retrieved from "https://handwiki.org/wiki/index.php?title=Software:Quartz_Composer&oldid=4217846"