Commits

Ronald Oussoren committed c181928

Add short descriptions to more examples.

Comments (0)

Files changed (39)

pyobjc-framework-AddressBook/Examples/Plugins/Python Address Label/readme.txt

+This plugin adds an 'Python Address Label' action to "Adress" properties in
+the AddressBook application.
+
+To install this plugin you have to build it (using 'python setup.py py2app')
+and then copy it to  '~/Library/Address\ Book\ Plug-Ins' (this folder may
+not exist yet.

pyobjc-framework-AddressBook/Examples/Plugins/Python Address Label/summary.txt

+This plugin adds an 'Python Address Label' action to "Adress" properties in
+the AddressBook application.

pyobjc-framework-Automator/Examples/AutoSample/ReadMe.txt

 Overview
 ========
 
-This sample displays a single window containing a list of workflows and a read only AMWorkflowView.  The workflows listed are the ones found in the Application's resources in the folder::
+This sample displays a single window containing a list of workflows and a read only ``AMWorkflowView``.  The workflows listed are the ones found in the Application's resources in the folder::
 
 	/AutoSample.app/Contents/Resources/workflows/
 
-When the application starts up it scans the workflows folder and loads each Automator workflow found there as an instance of AMWorkflow.  It then stores these AMWorkflow instances in an array along with the file names.  That array is used as the backing store for the NSTableView in the window.  
+When the application starts up it scans the workflows folder and loads each Automator workflow found there as an instance of ``AMWorkflow``.  It then stores these ``AMWorkflow`` instances in an array along with the file names.  That array is used as the backing store for the ``NSTableView`` in the window.  
 
-When a click is received on the name of a workflow in the NSTableView, the workflow is displayed in the AMWorkflowView on the right hand side of the window.
+When a click is received on the name of a workflow in the ``NSTableView``, the workflow is displayed in the ``AMWorkflowView`` on the right hand side of the window.
 
-When a double-click is received on the name of a workflow in the NSTableView (or, when the "run" button is pressed), the selected workflow is displayed in the AMWorkflowView on the right hand side of the window and it is run.
+When a double-click is received on the name of a workflow in the ``NSTableView`` (or, when the "run" button is pressed), the selected workflow is displayed in the ``AMWorkflowView`` on the right hand side of the window and it is run.
 
 Initialization Details
 ======================
 
-All of the setup for this sample is performed in the -awakeFromNib method.  The important features to note there are as follows:
+All of the setup for this sample is performed in the ``-awakeFromNib`` method.  The important features to note there are as follows:
 
-(a) The AMWorkflowView is being used for display purposes only.  As such, we mark the view as read only by turning off it's editing features with the following method call::
+(a) The ``AMWorkflowView`` is being used for display purposes only.  As such, we mark the view as read only by turning off it's editing features with the following method call::
 
 	workflowView.setEditable_(False)
 
-(b) We don't actually manage the AMWorkflowView ourselves.  Rather, we use an AMWorkflowController to take care of that.  In this sample, we have added an AMWorkflowController to our .nib file and we have set the AMWorkflowView displayed in the main window as it's workFlowView.  
+(b) We don't actually manage the ``AMWorkflowView`` ourselves.  Rather, we use an ``AMWorkflowController`` to take care of that.  In this sample, we have added an ``AMWorkflowController`` to our ``.nib`` file and we have set the ``AMWorkflowView`` displayed in the main window as it's ``workFlowView``.  
 
-With this arrangement, our Controller object does not have to worry about the details of operating the AMWorkflowView's user interface, as the AMWorkflowController will take care of that. 
+With this arrangement, our Controller object does not have to worry about the details of operating the ``AMWorkflowView's`` user interface, as the ``AMWorkflowController`` will take care of that. 
 
-So methods in the Controller object can receive information about the status of the view we have set our Controller object as the AMWorkflowController's delegate.  With our controller object set as the AMWorkflowController delegate, the AMWorkflowController will call back to our Controller object to provide status information about the AMWorkflow it is displaying in the AMWorkflowView.
+So methods in the Controller object can receive information about the status of the view we have set our Controller object as the ``AMWorkflowController's`` delegate.  With our controller object set as the ``AMWorkflowController`` delegate, the ``AMWorkflowController`` will call back to our Controller object to provide status information about the ``AMWorkflow`` it is displaying in the ``AMWorkflowView``.
 
-To run and display specific AMWorkflows, we will want to call methods on the AMWorkflowController.  So we can do that from methods implemented in the Controller object,  we have added an instance variable to the Controller object where we store a reference to the AMWorkflowController object.
+To run and display specific ``AMWorkflows``, we will want to call methods on the ``AMWorkflowController``.  So we can do that from methods implemented in the Controller object,  we have added an instance variable to the Controller object where we store a reference to the ``AMWorkflowController`` object.
 
 All of these releationships have been set up by control-dragging between objects in the Interface Builder interface.  You can use the connections inspector in Interface Builder to examine these connections.
 
 
-(c) We allocate and initialize all of the AMWorkflow instances for the workflows found in our Resources folder and we store them in a NSArray.  It's worth noting that we populate the NSArray with NSDictionary records that include the AMWorkflow instance, the file name, and the path.
+(c) We allocate and initialize all of the ``AMWorkflow`` instances for the workflows found in our Resources folder and we store them in a ``NSArray``.  It's worth noting that we populate the ``NSArray`` with ``NSDictionary`` records that include the ``AMWorkflow`` instance, the file name, and the path.
 
 
-(d) we have set up an array controller to manage the contents of the NSTableView.  To do that, we have bound the content array of the array controller to the workflows value stored in our Controller object.  In the column of the table we have bound the value to the arrangedObjects controller key on the Array Controller.  Back in our controller object, we have stored a reference to the Array Controller in the tableContent outlet so we can access its arrangedObjects value (to allow us to access the values displayed in the table no matter how the user has sorted the list by clicking on the table header). 
+(d) we have set up an array controller to manage the contents of the ``NSTableView``.  To do that, we have bound the content array of the array controller to the workflows value stored in our Controller object.  In the column of the table we have bound the value to the ``arrangedObjects`` controller key on the Array Controller.  Back in our controller object, we have stored a reference to the Array Controller in the ``tableContent`` outlet so we can access its ``arrangedObjects`` value (to allow us to access the values displayed in the table no matter how the user has sorted the list by clicking on the table header). 
 
 
 
-AMWorkflowController delegate methods
-=====================================
+``AMWorkflowController`` delegate methods
+==========================================
 
-We implement two AMWorkflowController delegate methods in this sample.  Namely, workflowControllerWillRun: and workflowControllerDidRun:.  The first method is called just before a workflow being managed by the AMWorkflowController is run and the second is called just after it finishes running.  
+We implement two ``AMWorkflowController`` delegate methods in this sample.  Namely, ``workflowControllerWillRun:`` and ``workflowControllerDidRun:``.  The first method is called just before a workflow being managed by the ``AMWorkflowController`` is run and the second is called just after it finishes running.  
 
-We use these methods to display the progress bar and to set the internal runningWorkflow flag.  We use bindings based on the runningWorkflow flag to display the progress bar, enable the stop button while a workflow is running, and disable the run button while a workflow is running.  Also, we use the runningWorkflow flag to prevent certain user actions, such as switching the AMWorkflowController to another workflow, while a workflow is still running.
+We use these methods to display the progress bar and to set the internal ``runningWorkflow`` flag.  We use bindings based on the ``runningWorkflow`` flag to display the progress bar, enable the stop button while a workflow is running, and disable the run button while a workflow is running.  Also, we use the ``runningWorkflow`` flag to prevent certain user actions, such as switching the ``AMWorkflowController`` to another workflow, while a workflow is still running.
 
 
 
 Running a workflow
 ==================
 
-We have set the run method on the AMWorkflowController as the target action for the run button.  Bindings based on the runningWorkflow flag control the availability of this button (by controlling its enabled state) for starting a new workflow.
+We have set the ``run`` method on the ``AMWorkflowController`` as the target action for the run button.  Bindings based on the ``runningWorkflow`` flag control the availability of this button (by controlling its enabled state) for starting a new workflow.
 
-We have set the stop method on the AMWorkflowController as the target action for the stop button.  Bindings based on the runningWorkflow flag control the availability of this button (by controlling its enabled state) for stopping a new workflow.
+We have set the ``stop`` method on the ``AMWorkflowController`` as the target action for the stop button.  Bindings based on the ``runningWorkflow`` flag control the availability of this button (by controlling its enabled state) for stopping a new workflow.
 
 
 
 Where to next?
 ==============
 
-Documentation for Automator AMWorkflowController and AMWorkflow can be found in the developer documentation.  To find the AMWorkflowController and AMWorkflow documentation, select 'Documentation' from the Help Menu in Xcode, and type AMWorkflow or AMWorkflowController into the search field near the top of the window.
-
-
+Documentation for Automator ``AMWorkflowController`` and ``AMWorkflow`` can be found in the developer documentation.

pyobjc-framework-Automator/Examples/AutoSample/summary.txt

+Overview
+========
+
+This sample displays a single window containing a list of workflows and a read only AMWorkflowView.  The workflows listed are the ones found in the Application's resources in the folder::
+
+        /AutoSample.app/Contents/Resources/workflows/
+
+When the application starts up it scans the workflows folder and loads each Automator workflow found there as an instance of ``AMWorkflow``.  It then stores these ``AMWorkflow`` instances in an array along with the file names.  That array is used as the backing store for the ``NSTableView`` in the window.
+
+When a click is received on the name of a workflow in the ``NSTableView``, the workflow is displayed in the ``AMWorkflowView`` on the right hand side of the window.
+
+When a double-click is received on the name of a workflow in the ``NSTableView`` (or, when the "run" button is pressed), the selected workflow is displayed in the ``AMWorkflowView`` on the right hand side of the window and it is run.

pyobjc-framework-Automator/Examples/Get Buddy Info/summary.txt

+An automator action that returns the current status for an iChat buddy.

pyobjc-framework-CalendarStore/Examples/Coding Headstart/00ReadMe.txt

-This is a Python version of the sample code in the
-CalendarStore Coding Headstart for WWDC'07.
-
-Note that this implementation is complete, without 
-bits that should be implemented by the reader.

pyobjc-framework-CalendarStore/Examples/Coding Headstart/summary.txt

+This is a Python version of the sample code in the
+CalendarStore Coding Headstart for WWDC'07.
+
+Note that this implementation is complete, without 
+bits that should be implemented by the reader.

pyobjc-framework-Cocoa/Examples/AppKit/CocoaBindings/MutableTableModel/summary.txt

+A mutable ``NSTableView`` using Cocoa Bindings.
Add a comment to this file

pyobjc-framework-Cocoa/Examples/AppKit/DatePicker/ReadMe.rtf

Binary file removed.

-{\rtf1\ansi\ansicpg1252\cocoartf909\cocoasubrtf800
-{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fnil\fcharset0 LucidaGrande;\f2\fnil\fcharset0 Monaco;
-}
-{\colortbl;\red255\green255\blue255;}
-\paperw11900\paperh16840\vieww9000\viewh8400\viewkind0
-\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\qj
-
-\f0\b\fs36 \cf0 DatePicker
-\b0\fs24 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-\cf0 October 10, 2006\
-\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qj
-
-\f1 \cf0 \
-\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\qj
-
-\f0 \cf0 "DatePicker" is a Cocoa sample application that demonstrates how to use 
-\f2\fs20 NSDatePicker
-\f0\fs24  control on Mac OS X.\
-\pard\pardeftab720\qj
-
-\f2\fs20 \cf0 NSDatePicker
-\f0\fs24  is a subclass of 
-\f2\fs20 NSControl
-\f0\fs24  that provides for visually displaying and editing an 
-\f2\fs20 NSDate
-\f0\fs24  instance.\
-This control uses an 
-\f2\fs20 NSDatePickerCell
-\f0\fs24  to implement much of the control\'92s functionality.\
-\
-\
-
-\b Sample Requirements
-\b0 \
-\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qj\pardirnatural
-\cf0 The supplied Xcode project was created using Xcode v2.3 running under Mac OS X 10.4.x or later. The project will create a Universal Binary.
-\f1\fs26 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-
-\f0\fs24 \cf0 \
-\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-
-\b \cf0 About the Sample
-\b0 \
-DatePicker shows how to manipulate the behaviors of 
-\f2\fs20 NSDatePicker
-\f0\fs24  in the following ways -\
-1. Changing the picker style.\
-2. Changing the picker font size.\
-3. Changing the background/text color as well as other appearance aspects.\
-4. Turning on and off the various date and time element flags.\
-5. Setting the minimum and maximum dates.\
-6. Overriding the set date as a delegate.\
-\
-The sample also shows how to use the various date and time formats using the 
-\f2\fs20 NSDateFormatter
-\f0\fs24  class.\
-}

pyobjc-framework-Cocoa/Examples/AppKit/DatePicker/ReadMe.txt

+"DatePicker" is a Cocoa sample application that demonstrates how to use 
+``NSDatePicker`` control on Mac OS X.  ``NSDatePicker`` is a subclass of 
+``NSControl`` that provides for visually displaying and editing an 
+``NSDate`` instance.
+
+This control uses an ``NSDatePickerCell`` to implement much of the 
+control’s functionality.
+
+About the Sample
+----------------
+
+DatePicker shows how to manipulate the behaviors of ``lNSDatePicker`` in the 
+following ways
+
+1. Changing the picker style.
+
+2. Changing the picker font size.
+
+3. Changing the background/text color as well as other appearance aspects.
+
+4. Turning on and off the various date and time element flags.
+
+5. Setting the minimum and maximum dates.
+
+6. Overriding the set date as a delegate.
+
+The sample also shows how to use the various date and time formats using the 
+``NSDateFormatter`` class.

pyobjc-framework-Cocoa/Examples/AppKit/DatePicker/summary.txt

+"DatePicker" is a Cocoa sample application that demonstrates how to use 
+``NSDatePicker`` control on Mac OS X.  ``NSDatePicker`` is a subclass of 
+``NSControl`` that provides for visually displaying and editing an 
+``NSDate`` instance.

pyobjc-framework-Cocoa/Examples/AppKit/DragItemAround/ReadMe.txt

-Port to python of the DragItemAround example at ADC.

pyobjc-framework-Cocoa/Examples/AppKit/DragItemAround/summary.txt

+Port to python of the DragItemAround example at ADC.

pyobjc-framework-Cocoa/Examples/AppKit/Formatter/summary.txt

+This example shows how to implement an ``NSFormatter`` subclass in Python.

pyobjc-framework-Cocoa/Examples/AppKit/Grady/summary.txt

+This example shows how to use ``NSGradient``.
Add a comment to this file

pyobjc-framework-Cocoa/Examples/AppKit/PredicateEditorSample/ReadMe.rtf

Binary file removed.

-{\rtf1\ansi\ansicpg1252\cocoartf902
-{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fnil\fcharset0 Monaco;}
-{\colortbl;\red255\green255\blue255;}
-\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\qj
-
-\f0\b\fs36 \cf0 PredicateEditorSample
-\b0\fs24 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-\cf0 October 10, 2006\
-\
-\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\qj
-\cf0 "PredicateEditorSample" is a Cocoa application that demonstrates how to use the 
-\f1\fs20 NSPredicateEditor
-\f0\fs24  class.  The 
-\f1\fs20 NSPredicateEditor
-\f0\fs24  class is a subclass of 
-\f1\fs20 NSRuleEditor
-\f0\fs24  that is specialized for editing 
-\f1\fs20 NSPredicate
-\f0\fs24  objects.  This sample is intended to show how to use the many different features and aspects of this control and leverages Spotlight to search your Address Book.\
-\
-It shows how to manage this control inside your window along with an 
-\f1\fs20 NSTableView
-\f0\fs24 , build Spotlight friendly queries based on 
-\f1\fs20 \CocoaLigature0 NSPredicate
-\f0\fs24  and 
-\f1\fs20 NSCompountPredicate
-\f0\fs24 \CocoaLigature1 , build search results based on 
-\f1\fs20 NSMetadataQuery
-\f0\fs24  object.\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-\cf0 \
-\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-
-\b \cf0 Sample Requirements
-\b0 \
-\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qj\pardirnatural
-\cf0 The supplied Xcode project was created using Xcode v3.0 running under Mac OS X 10.5.x or later. The project will create a Universal Binary.  Editing the nib files requires Interface Builder 3.0.\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-\cf0 \
-\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-
-\b \cf0 Using the Sample
-\b0 \
-Simply build and run the sample using Xcode.  Enter query information pertaining to your Address Book.  The application will display matches in its table view.\
-Note that this sample uses Interface Builder 3.0 to build the 
-\f1\fs20 NSPredicateEditorRowTemplates
-\f0\fs24  that make up the control's interface.\
-\
-AddressBook searches are achieved by specifically requesting the "kind" of data to search via the 
-\f1\fs20 kMDItemKind
-\f0\fs24  key constant.  This is the metadata attribute key that tells Spotlight to search for address book data only.  Together along with the other predicates from the NSPredicateEditor class we form a "compound predicate" and start the query.  The code snippet below found in this sample shows how this is done:\
-\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-
-\f1\fs18 \cf0 // always search for items in the Address Book\
-NSPredicate* addrBookPredicate = [NSPredicate predicateWithFormat:@"(kMDItemKind = 'Address Book Person Data')"];\
-predicate = [NSCompoundPredicate andPredicateWithSubpredicates:[NSArray arrayWithObjects:addrBookPredicate, predicate, nil]];\
-\
-[query setPredicate: predicate];\
-[query startQuery];
-\f0\fs24 \
-		\
-				\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-
-\b \cf0 Changes from Previous Versions
-\b0 \
-n/a\
-\
-\
-
-\b Feedback and Bug Reports
-\b0 \
-Please send all feedback about this sample to \
-<http://developer.apple.com/contact/feedback.html>.\
-\
-Please submit any bug reports about this sample to\
-<http://developer.apple.com/bugreporter>}

pyobjc-framework-Cocoa/Examples/AppKit/PredicateEditorSample/ReadMe.txt

+PredicateEditorSample
+=====================
+
+"PredicateEditorSample" is a Cocoa application that demonstrates how to use 
+the ``NSPredicateEditor`` class.  The ``NSPredicateEditor`` class is a 
+subclass of ``NSRuleEditor`` that is specialized for editing ``NSPredicate`` 
+objects.  This sample is intended to show how to use the many different 
+features and aspects of this control and leverages Spotlight to search your 
+Address Book.
+
+It shows how to manage this control inside your window along with an 
+``NSTableView``, build Spotlight friendly queries based on ``NSPredicate`` and 
+``NSCompountPredicate``, build search results based on ``NSMetadataQuery`` object.
+
+Using the Sample
+----------------
+
+Simply build the example using the supplied ``setup.py`` file.  Enter 
+query information pertaining to your Address Book.  The application will 
+display matches in its table view.
+
+Note that this sample uses Interface Builder 3.0 to build the 
+``NSPredicateEditorRowTemplates`` that make up the control's interface.
+
+AddressBook searches are achieved by specifically requesting the "kind" of data to search via the ``kMDItemKind`` key constant.  This is the metadata attribute key that tells Spotlight to search for address book data only.  Together along with the other predicates from the ``NSPredicateEditor`` class we form a "compound predicate" and start the query.  The code snippet below found in this sample shows how this is done::
+
+   # always search for items in the Address Book
+   addrBookPredicate = NSPredicate.predicateWithFormat_("(kMDItemKind = 'Address Book Person Data')")
+   predicate = NSCompoundPredicate.andPredicateWithSubpredicates_([addrBookPredicate, predicate])
+
+   query.setPredicate_(predicate)
+   query.startQuery()

pyobjc-framework-Cocoa/Examples/AppKit/PredicateEditorSample/summary.txt

+"PredicateEditorSample" is a Cocoa application that demonstrates how to use 
+the ``NSPredicateEditor`` class.  The ``NSPredicateEditor`` class is a 
+subclass of ``NSRuleEditor`` that is specialized for editing ``NSPredicate`` 
+objects.  This sample is intended to show how to use the many different 
+features and aspects of this control and leverages Spotlight to search your 
+Address Book.

pyobjc-framework-Cocoa/Examples/AppKit/RoundTransparentWindow/ReadMe.txt

-Port of the RoundTransparentWindow example at ADC.

pyobjc-framework-Cocoa/Examples/AppKit/RoundTransparentWindow/summary.txt

+Port of the RoundTransparentWindow example at ADC.

pyobjc-framework-Quartz/Examples/Core Graphics/CGRotation/Readme.txt

-CGRotation is a Cocoa application that demonstrates how to use the Current Transformation Matrix (CTM) to apply rotation, scaling and transformation to an image for display. It also demonstrates simple usage of ImageIO to load and save images and how to get the pixel data from a CGImageRef into an arbitrary buffer.

pyobjc-framework-Quartz/Examples/Core Graphics/CGRotation/summary.txt

+CGRotation is a Cocoa application that demonstrates how to use the Current Transformation Matrix (CTM) to apply rotation, scaling and transformation to an image for display. It also demonstrates simple usage of ImageIO to load and save images and how to get the pixel data from a CGImageRef into an arbitrary buffer.

pyobjc-framework-Quartz/Examples/Core Graphics/CGShading Demo/ReadMe.txt

-This is port to python of the "Cocoa CG shading demo" on ADC.
-
-This is currently not a good example of how to program in Python, but does
-show that the CGShading API's work from Python.

pyobjc-framework-Quartz/Examples/Core Graphics/CGShading Demo/summary.txt

+This is port to python of the "Cocoa CG shading demo" on ADC.
+
+This is currently not a good example of how to program in Python, but does
+show that the CGShading API's work from Python.

pyobjc-framework-Quartz/Examples/Core Graphics/Quartz2DBasics/00ReadMe.txt

-This sample code introduces some of the concepts and features of Quartz. It contains code that:
-
-* fills then strokes a rectangle and strokes then fills a rectangle
-* creates a CGPath object and then paints that path with varying degrees of alpha transparency
-* draws the contents of a TIFF file using Quartz
-* draws the contents of a TIFF file using Quartz clipped by an elliptical shape
-* caches content using a CGLayer object and then draws using that cache
-* exports any of the above drawing to a PDF file
-* exports any of the above drawing as a PNG file
-
-This is a translation of the Cocoa version of the ADC example with the same name.

pyobjc-framework-Quartz/Examples/Core Graphics/Quartz2DBasics/summary.txt

+This sample code introduces some of the concepts and features of Quartz. It contains code that:
+
+* fills then strokes a rectangle and strokes then fills a rectangle
+* creates a CGPath object and then paints that path with varying degrees of alpha transparency
+* draws the contents of a TIFF file using Quartz
+* draws the contents of a TIFF file using Quartz clipped by an elliptical shape
+* caches content using a CGLayer object and then draws using that cache
+* exports any of the above drawing to a PDF file
+* exports any of the above drawing as a PNG file
+
+This is a translation of the Cocoa version of the ADC example with the same name.

pyobjc-framework-Quartz/Examples/Core Image/CIBevelSample/summary.txt

+Translation into python of and ADC example of the same name.

pyobjc-framework-Quartz/Examples/Core Image/CIHazeFilterSample/summary.txt

+Translation into python of and ADC example of the same name.

pyobjc-framework-Quartz/Examples/Core Image/CIMicroPaint/summary.txt

+A simple paint application using Core Image.

pyobjc-framework-Quartz/Examples/Core Image/CITransitionSelectorSample/summary.txt

+Image transitions using Core Image.
Add a comment to this file

pyobjc-framework-Quartz/Examples/ImageKit/ImageBrowser/ReadMe.rtf

Binary file removed.

-{\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420
-{\fonttbl\f0\fswiss\fcharset77 Helvetica-Bold;\f1\fswiss\fcharset77 Helvetica;\f2\fnil\fcharset77 Monaco;
-}
-{\colortbl;\red255\green255\blue255;}
-\margl1440\margr1440\vieww15460\viewh17160\viewkind0
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
-
-\f0\b\fs36 \cf0 ImageBrowser
-\f1\b0\fs24 \
-\
-This sample demonstrates the ImageKit ImageBrowser in a basic Cocoa application. It uses IB to create a window an ImageBrowser and a zoom slider. \
-\
-- This sample should present a reasonably complete correctly formed Cocoa application which can be used as a starting point for using the ImageBrowser in a Cocoa applications. \
-\
-Usual steps to use the ImageKit image browser in your application :\
-\
-1) setup your nib file\
-    Add a custom view and set its class to IKImageBrowserView.\
-    Connect an IBOutlet from your controller to your image browser view \
-    and connect the IKImageBrowserView's _datasource IBOutlet to your controller (if you want your controller to be the data source)\
-\
-2) In the header of your controller, don't forget to include the Quartz header:\
-\
-
-\f2\fs18 	#import <Quartz/Quartz.h>
-\f1\fs24 \
-\
-3) create your own data source representation (here using a NSMutableArray). \
-\
-
-\f2\fs18 @interface MyController : NSWindowController \
-\{\
-    // my images to display and browse (ie my data source) \
-    NSMutableArray*     _myImages;\
-\
-    // my browser (connected in the nib file)\
-    IButlet id		_myImageView;\
-\}
-\f1\fs24 \
-\
-4) implement the required methods of the informal data source protocol (IKImageBrowserDataSource) :\
-\
-
-\f2\fs18 - (int) numberOfItemsInImageBrowser:(IKImageBrowserView *) browser\
-\{\
-    return [_images count];\
-\}\
-\
-- (id) imageBrowser:(IKImageBrowserView *) aBrowser itemAtIndex:(int)index\
-\{\
-    return [_myImages objectAtIndex:index];\
-\}
-\f1\fs24 \
-\
-\
-5)  The returned data source object must implement the 3 required methods \
-from the IKImageBrowserItemProtocol informal protocol:\
-\
-
-\f2\fs18 - (NSString *) imageUID;\
-- (NSString *) imageRepresentationType;\
-- (id) imageRepresentation;
-\f1\fs24 \
-\
-- the id returned by imageUID MUST be different for each item displayed in the image-view. Moreover, the\
-image browser build it's own internal cache according to this UID. the imageUID can be for exemple the absolute \
-path of an image existing on the filesystem or another UID based on your own data structures.\
-\
-- "imageRepresentationType" return one of the following string constant depending of the client's choice of representation:\
-\
-
-\f2\fs18 IKImageBrowserPathRepresentationType\
-IKImageBrowserNSImageRepresentationType\
-IKImageBrowserCGImageRepresentationType\
-IKImageBrowserNSDataRepresentationType\
-IKImageBrowserNSBitmapImageRepresentationType\
-IKImageBrowserQTMovieRepresentationType
-\f1\fs24 \
-	(see IKImageBrowserView.h for complete list)\
-\
-- "imageRepresentation" return an object depending of the representation type:\
-\
-a 
-\f2\fs20 NSString
-\f1\fs24  for 
-\f2\fs20 IKImageBrowserPathRepresentationType
-\f1\fs24 \
-a 
-\f2\fs20 NSImage
-\f1\fs24  for 
-\f2\fs20 IKImageBrowserNSImageRepresentationType
-\f1\fs24 \
-a 
-\f2\fs20 CGImageRef
-\f1\fs24  for 
-\f2\fs20 IKImageBrowserCGImageRepresentationType
-\f1\fs24 \
-...\
-\
-Here is a sample code of a simple implementation of a data source item:\
-\
-
-\f2\fs18 // the datasource object\
-@interface myItemObject : NSObject <IKImageBrowserItem>\
-\{\
-	NSString *_path; \
-\}\
-@end\
-\
-@implementation myItemObject\
-\
-- (void) dealloc\
-\{\
-	[_path release];\
-	[super dealloc];\
-\}\
-\
-- (NSString *) imageRepresentationType\
-\{\
-	return IKImageBrowserPathRepresentationType;\
-\}\
-\
-- (id) imageRepresentation\
-\{\
-	return _path;\
-\}\
-\
-- (NSString *) imageUID\
-\{\
-	return _path;\
-\}\
-\
-@end
-\f1\fs24 \
-\
-\
-6) Now to see your data displayed in your instance of the image browser view, you have to tell the browser to read your data using your IBOutlet connected to the browser and\
-invoke "reloadData" on it:\
-\
-
-\f2\fs18 [_myImageView reloadData];
-\f1\fs24 \
-\
-call reload data each time you want the image browser to reflect changes of your data source.\
-\
-That's all for a very basic use. \
-Then you may need to add a scroller or a scrollview and a slider to your interface\
-to let the user to scroll and zoom to browser his images. To do this\
-you will have to use some image browser public methods such as:\
-\
-
-\f2\fs18 - (void) setZoomValue:(float) zoomValue;\
-- (void) setScroller:(NSScroller *) scroller; // if you choose to manage independent scroller instead of having a scrollview
-\f1\fs24 \
-\
-\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qj\pardirnatural
-
-\f0\b \cf0 Changes from Previous Versions
-\f1\b0 \
-1.0 - First version\
-1.1 - Updated to the latest Leopard interfaces, minor adjustments according to the sample code guidelines.\
-\
-\
-
-\f0\b Feedback and Bug Reports
-\f1\b0 \
-Please send all feedback about this sample to:\
-<http://developer.apple.com/contact/feedback.html>\
-\
-Please submit any bug reports about this sample to:\
-<http://developer.apple.com/bugreporter>}

pyobjc-framework-Quartz/Examples/ImageKit/ImageBrowser/ReadMe.txt

+ImageBrowser
+============
+
+This sample demonstrates the ImageKit ``ImageBrowser`` in a basic Cocoa 
+application. It uses IB to create a window an ``ImageBrowser`` and a zoom 
+slider. 
+
+This sample should present a reasonably complete correctly formed Cocoa 
+application which can be used as a starting point for using the ``ImageBrowser``
+ in a Cocoa applications. 
+
+Usual steps to use the ImageKit image browser in your application:
+
+1. setup your nib file
+
+   Add a custom view and set its class to IKImageBrowserView.
+   Connect an IBOutlet from your controller to your image browser view 
+   and connect the ``IKImageBrowserView``'s ``_datasource`` ``IBOutlet`` to 
+   your controller (if you want your controller to be the data source)
+
+2. Don't forget to import the Quartz package::
+
+	from Quartz import *
+
+3. Create your own data source representation (here using a ``NSMutableArray``)::
+
+	class MyController (NSWindowController):
+	    _myImages = objc.ivar()
+	    _myImageView = objc.IBOutlet()
+
+4. implement the required methods of the informal data source protocol 
+   (``IKImageBrowserDataSource``)::
+
+	def numberOfItemsInImageBrowser_(self, browser):
+		return len(self._images)
+
+	def imageBrowser_itemAtIndex_(self, aBrowser, index):
+		return self._images[index]
+
+
+5.  The returned data source object must implement the 3 required 
+    methods from the ``IKImageBrowserItemProtocol`` informal protocol:
+
+	def imageUID(self): pass
+	def mageRepresentationType(self): pass
+	def imageRepresentation(self): pass
+
+    * the id returned by ``imageUID`` MUST be different for each item 
+      displayed in the image-view. Moreover, the image browser build it's 
+      own internal cache according to this UID. the ``imageUID`` can be for 
+      exemple the absolute path of an image existing on the filesystem or 
+      another UID based on your own data structures.
+
+    * ``imageRepresentationType`` return one of the following string constant 
+      depending of the client's choice of representation::
+
+	IKImageBrowserPathRepresentationType
+	IKImageBrowserNSImageRepresentationType
+	IKImageBrowserCGImageRepresentationType
+	IKImageBrowserNSDataRepresentationType
+	IKImageBrowserNSBitmapImageRepresentationType
+	IKImageBrowserQTMovieRepresentationType
+
+      (see IKImageBrowserView.h for complete list)
+
+    * ``imageRepresentation`` return an object depending of the representation 
+      type:
+
+      *	a ``NSString`` for ``IKImageBrowserPathRepresentationType``
+      * a ``NSImage`` for ``IKImageBrowserNSImageRepresentationType``
+      * a ``CGImageRef`` for ``IKImageBrowserCGImageRepresentationType``
+      * ...
+
+    Here is a sample code of a simple implementation of a data source item::
+
+    class myItemObject (NSObject, IKImageBrowserItem):
+	_path = objc.ivar()
+
+	def mageRepresentationType(self):
+	    return IKImageBrowserPathRepresentationType;
+
+	def mageRepresentation(self):
+            return self._path
+
+        def imageUID(self):
+            return self._path
+
+6. Now to see your data displayed in your instance of the image browser view, 
+   you have to tell the browser to read your data using your ``IBOutlet`` 
+   connected to the browser and invoke ``reloadData`` on it::
+
+    self._myImageView.reloadData()
+
+   Call ``reloadData`` each time you want the image browser to reflect changes 
+   of your data source.
+
+That's all for a very basic use.  Then you may need to add a scroller or a 
+scrollview and a slider to your interface to let the user to scroll and zoom 
+to browser his images. 

pyobjc-framework-Quartz/Examples/ImageKit/ImageBrowser/summary.txt

+This sample demonstrates the ImageKit ``ImageBrowser`` in a basic Cocoa 
+application. It uses IB to create a window an ``ImageBrowser`` and a zoom 
+slider. 

pyobjc-framework-Quartz/Examples/PDFKit/PDFKitViewer/summary.txt

+A simple PDF viewer application using the ``PDFKit`` framework.

pyobjc-framework-Quartz/Examples/PathDemo/summary.txt

+Using ``CGContextBeginPath`` and related APIs

pyobjc-framework-Quartz/Examples/Programming with Quartz/BasicDrawing/summary.txt

+A python version of the BasicDrawing example in the book 
+"Programming with Quartz". This shows how to use most of the core API's in
+Quartz/CoreGraphics.

pyobjc-framework-Quartz/Examples/Programming with Quartz/CocoaDrawingShell/summary.txt

+A python version of the CocoaDrawingShell example in the book 
+"Programming with Quartz". This shows how to use most of the core API's in
+Quartz/CoreGraphics in a Cocoa application.

pyobjc-framework-Quartz/Examples/QuartzComposer/Chart/summary.txt

+A simple application that displays a barchart using Quartz Composer.

pyobjc-framework-Quartz/Examples/TLayer/summary.txt

+A simple demo of Transparency Layers
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.