ReflectionView

ReflectionView

Released 3 years ago , Last update 3 years ago

A UIView subclass designed to make it easy to create "mirrored floor"-style reflections of views on iOS.

ReflectionView is a UIView subclass designed to make it easy to create "mirrored floor"-style reflections of views on iOS.

You may have noticed that Apple provides a Reflection sample project for this, but Apple's solution works only with images and involves fairly slow CPU-bound drawing to update the reflection, making it unsuitable for reflecting animated content. ReflectionView can operate in two modes; static mode - which works like Apple's sample code - or dynamic mode, which uses Core Animation and works in real-time on any view. This means you can use it to reflect the contents of a view containing dynamic elements such as controls or animation and the reflection will keep up in real-time.

4.7
  • 5 13
  • 4 4
  • 3 1
  • 2 0
  • 1 0
18 Reviews Read Reviews

Pricing

FREE

MIT license

The MIT license is an open-source license.

Documentation

Supported OS & SDK Versions

  • Supported build target - iOS 5.1 / Mac OS 10.7 (Xcode 4.3.1, Apple LLVM compiler 3.1)
  • Earliest supported deployment target - iOS 4.3 / Mac OS 10.6
  • Earliest compatible deployment target - iOS 4.0 / Mac OS 10.6

NOTE: 'Supported' means that the library has been tested with this version. 'Compatible' means that the library should work on this OS version (i.e. it doesn't rely on any unavailable SDK features) but is no longer being tested for compatibility and may require tweaking or bug fixes to run correctly.

ARC Compatibility

ReflectionView makes use of the ARC Helper library to automatically work with both ARC and non-ARC projects through conditional compilation. There is no need to exclude ReflectionView files from the ARC validation process, or to convert ReflectionView using the ARC conversion tool.

Installation

To use the ReflectionView in an app, just drag the ReflectionView class files into your project and add the QuartzCore framework.

Properties

You can configure a ReflectionView instance using the following properties:

@property (nonatomic, assign) CGFloat reflectionGap;

The gap between the view and its reflection, measured in pixels (or points on a Retina Display device). This defaults to 4 pixels.

@property (nonatomic, assign) CGFloat reflectionScale;

The height of the reflection relative to the view. Defaults to 0.5 (half the view height).

@property (nonatomic, assign) CGFloat reflectionAlpha;

The opacity of the reflection. Defaults to 0.5 (50% opaque).

@property (nonatomic, assign) BOOL dynamic;

Switches between dynamic and static mode. See 'Performance' for an explanation of the difference between modes. Defaults to 'NO' (static mode).

Methods

- (void)update;

Update redraws the view reflection. If the dynamic property is set to 'YES', it is not necessary to call update manually, as it is called automatically whenever any of the reflection properties are changed, or when the view is resized. If dynamic is set to 'NO' you may need to call update to redraw the reflection to match the new content.

Usage

To use the ReflectionView, simply add the views you want to reflect as subviews of an instance of ReflectionView and they will be automatically mirrored. You can also subclass ReflectionView to make new views.

Note that to function correctly, the ReflectionView instance must have `clipToBounds' disabled.

Performance

The trick to getting good performance with ReflectionView is to use the correct drawing mode. In dynamic mode, the reflection automatically updates whenever the content changes. This is good for content that changes often or which contains animation, but it carries a per-frame performance penalty.

For content that changes infrequently, set the dynamic property to 'NO' for better performance. With dynamic mode disabled, you will need to manually call the update method to update the reflection if the content changes.

2 licenses, starting from From » FREE View Licenses

Get A Quote

What do you need?
  • Custom development
  • Integration
  • Customization / Reskinning
  • Consultation
When do you need it?
  • Soon
  • Next week
  • Next month
  • Anytime

Thanks for getting in touch!

Your quote details have been received and we'll get back to you soon.


Or enter your name and Email
  • CC Christ O' Conner 2 years ago
    How is the performance if I use it to reflect a video player view?
  • O OnTheEasiestWay 2 years ago
    Great work, all the others reflect the image, not the view. But I have a problem when reflecting rotated UIView, the image for _reflectionView has white background, and some corner is cut. I set clipsToBounds to NO, and set background color to clear color for both original UIView and _reflectionView, but on luck. Could you give me some advise or reference?