Advanced Search

Log In | Not a Member?

Contact ADC

< Previous PageNext Page > Hide TOC

Painting With Shadows

Follow these steps to paint with shadows:

1. Save the graphics state.

2. Call the function CGContextSetShadow, passing the appropriate values.

3. Perform all the drawing to which you want to apply shadows.

4. Restore the graphics state

Follow these steps to paint with colored shadows:

1. Save the graphics state.

2. Create a CGColorSpace object to ensure that Quartz interprets the shadow color values correctly.

3. Create a CGColor object that specifies the shadow color you want to use.

4. Call the function CGContextSetShadowWithColor, passing the appropriate values.

5. Perform all the drawing to which you want to apply shadows.

6. Restore the graphics state.

The two rectangles in Figure 7-3 are drawn with shadows—one with a colored shadow.

Figure 7-3  A colored shadow compared to a gray one

The function in Listing 7-1 shows how to set up shadows to draw the rectangles shown in Figure 7-3. A detailed explanation for each numbered line of code appears following the listing.

Listing 7-1  A function that sets up shadows

void MyDrawWithShadows (CGContextRef myContext, // 1

                         float wd, float ht);

{

    CGSize          myShadowOffset = CGSizeMake (-15,  20);// 2

    float           myColorValues[] = {1, 0, 0, .6};// 3

    CGColorRef      myColor;// 4

    CGColorSpaceRef myColorSpace;// 5

    CGContextSaveGState(myContext);// 6

    CGContextSetShadow (myContext, myShadowOffset, 5); // 7

    // Your drawing code here// 8

    CGContextSetRGBFillColor (myContext, 0, 1, 0, 1);

    CGContextFillRect (myContext, CGRectMake (wd/3 + 75, ht/2 , wd/4, ht/4));

    myColorSpace = CGColorSpaceCreateDeviceRGB ();// 9

    myColor = CGColorCreate (myColorSpace, myColorValues);// 10

    CGContextSetShadowWithColor (myContext, myShadowOffset, 5, myColor);// 11

    // Your drawing code here// 12

    CGContextSetRGBFillColor (myContext, 0, 0, 1, 1);

    CGContextFillRect (myContext, CGRectMake (wd/3-75,ht/2-100,wd/4,ht/4));

    CGColorRelease (myColor);// 13

    CGColorSpaceRelease (myColorSpace); // 14

    CGContextRestoreGState(myContext);// 15

}

Here’s what the code does:

1. Takes three parameters—a graphics context and a width and height to use when constructing the rectangles.

2. Declares and creates a CGSize object that contains offset values for the shadow. These values specify a shadow offset 15 units to the left of the object and 20 units above the object.

3. Declares an array of color values. This example uses RGBA, but these values won’t take on any meaning until they are passed to Quartz along with a color space, which is necessary for Quartz to interpret the values correctly.

4. Declares storage for a color reference.

5. Declares storage for a color space reference.

6. Saves the current graphics state so that you can restore it later.

7. Sets a shadow to have the previously declared offset values and a blur value of 5, which indicates a soft shadow edge. The shadow will appear gray, having an RGBA value of {0, 0, 0, 1/3}.

8. The next two lines of code draw the rectangle on the right side of Figure 7-3. You replace these lines with your own drawing code.

9. Creates a DeviceRGB color space. You need to supply a color space when you create a CGColor object.

10. Creates a CGColor object, supplying the DeviceRGB color space and the RGBA values declared previously. This object specifies the shadow color, which in this case is red with an alpha value of 0.6.

11. Sets up a color shadow, supplying the red color you just created. The shadow uses the offset created previously and a blur value of 5, which indicates a soft shadow edge.

12. The next two lines of code draw the rectangle on the left side of Figure 7-3. You replace these lines with your own drawing code.

13. Releases the color object because it is no longer needed.

14. Releases the color space object because it is no longer needed.

15. Restores the graphics state to what it was prior to setting up the shadows.

< Previous PageNext Page > Hide TOC

Did this document help you? Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.

	Get information on Apple products. Visit the Apple Store online or at retail locations. 1-800-MY-APPLE Copyright © 2007 Apple Inc. All rights reserved. | Terms of use | Privacy Notice