| Quartz Composer | |
|---|---|
 | |
 The Quartz Composer 4.0 interface and a composition | |
| Developer | 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 anode graph system provided as part of theXcodedevelopment environment inmacOS for processing andrendering graphical data. It is capable of making sophisticated animations for keynote or presentations and creating animated screensavers.[1]
Quartz Composer usesOpenGL (includingGLSL),OpenCL (only in Mac OS X Snow Leopard and later),OpenAL,Core Image,Core Video,JavaScript and other technologies to create anAPI and a developer tool around a simple visual programming paradigm. Apple has embedded Quartz technologies deeply into theoperating system. Compositions created in Quartz Composer can be played standalone in anyQuickTime-aware application[2] (although only on Mac OS X Tiger and later), as a systemScreen Saver,[3] as an iTunes Visualizer, from inside the Quartz Composer application, or can be embedded into aCocoa orCarbon application via supplieduser interfacewidgets. While Quartz Composer is included with the iPhone SDK, as of December 2015[update] there is no way of running Quartz Compositions oniOS devices. Starting inmacOS Catalina, the Quartz Composer framework has been deprecated, although it is still present for compatibility.[4]
Quartz programming through Quartz Composer works by implementing and connectingpatches.[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 alazy 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 andGLSL shaders, among other things. Subpatch support is indicated by square corners on a patch, rather than the typical rounded corners.
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 forOpen Sound Control transmission and reception.
Also new in Version 3.0 was the possibility to write custom patch plugins using anXcode 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]
In the Quartz Composer editor, holding theoption 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.
Data inside QC can be one of the following types:
Two additional types were introduced in version 4.0:
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.
Quartz Composer documents are calledCompositions. Compositions are BinaryProperty Lists (thoughXML versions are also supported) with afilename extension.qtz and acom.apple.quartz-composer-compositionUTI.[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 storemetadata such as composition author,copyright and description. The user can also add arbitrary metadata items, if desired.
Many image formats are supported, includingJPEG,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, callednotes. These notes parallelcomments in other programming languages. Notes can be yellow, red, green, blue, or gray, and can overlap other notes.
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:
There is an additional protocol that Apple uses in their private API:
One new protocol was added in version 4.0:
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]
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.
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 3file system locations:
Adding compositions to the repository is as simple as adding the composition file to one of these locations.
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.
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.
Support for some Automator actions was added with the release of Leopard.
![[icon]](/mt/?noimg=&dark=on&url=https%3a%2f%2fen.wikipedia.org%2fwiki%2fFile%3aWiki_letter_w_cropped.svg) | This sectionneeds expansion. You can help byadding missing information.(June 2025) |
