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.
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.
To use the ReflectionView in an app, just drag the ReflectionView class files into your project and add the QuartzCore framework.
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).
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.
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.
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.