Update README.md

Author: ashqal

README.md

@@ -9,10 +9,17 @@ It is a lite library to render 360 degree panorama video for iOS.
 
 ## Pod
 ```
-pod 'MD360Player4iOS', '~> 0.2.0'
+pod 'MD360Player4iOS', '~> 0.3.0'
 ```
 
 ## Release Node
+**0.3.0**
+* Fix crucial bug(e.g. crash, black screen).
+* Custom director factory support.
+* Better way to render multi screen.
+* Add motion with touch strategy.
+* Add 360 bitmap support.
+
 **0.2.0**
 * Pinch gesture supported.
 
@@ -35,12 +42,15 @@ pod 'MD360Player4iOS', '~> 0.2.0'
     /////////////////////////////////////////////////////// MDVRLibrary
     MDVRConfiguration* config = [MDVRLibrary createConfig];
 
-    [config displayMode:MDModeDisplayNormal];
-    [config interactiveMode:MDModeInteractiveTouch];
-    // Worked with AVPlayerItem
-    [config asVideo:playerItem]; 
+    [config asVideo:playerItem];
     [config setContainer:self view:self.view];
 
+    // optional
+    [config displayMode:MDModeDisplayNormal];
+    [config interactiveMode:MDModeInteractiveMotion];
+    [config pinchEnabled:true];
+    [config setDirectorFactory:self];
+    
     self.vrLibrary = [config build];
     /////////////////////////////////////////////////////// MDVRLibrary
 }
@@ -51,6 +61,7 @@ pod 'MD360Player4iOS', '~> 0.2.0'
 typedef NS_ENUM(NSInteger, MDModeInteractive) {
     MDModeInteractiveTouch,
     MDModeInteractiveMotion,
+    MDModeInteractiveMotionWithTouch,
 };
 
 typedef NS_ENUM(NSInteger, MDModeDisplay) {
@@ -71,6 +82,89 @@ self.vrLibrary = [config build];
 /////////////////////////////////////////////////////// MDVRLibrary
 ```
 
+## Custom Director Factory
+```objc
+@interface VideoPlayerViewController ()<MD360DirectorFactory>
+@end
+
+@implementation VideoPlayerViewController
+...
+- (void) initPlayer{
+   	...
+    /////////////////////////////////////////////////////// MDVRLibrary
+    MDVRConfiguration* config = [MDVRLibrary createConfig];
+   	...
+    [config setDirectorFactory:self]; // pass in the custom factory
+    ...
+    self.vrLibrary = [config build];
+    /////////////////////////////////////////////////////// MDVRLibrary
+}
+
+// implement the MD360DirectorFactory protocol here.
+- (MD360Director*) createDirector:(int) index{
+    MD360Director* director = [[MD360Director alloc]init];
+    switch (index) {
+        case 1:
+            [director setEyeX:-2.0f];
+            [director setLookX:-2.0f];
+            break;
+        default:
+            break;
+    }
+    return director;
+}
+...
+@end
+
+```
+
+## 360 Bitmap Support
+```objc
+@interface BitmapPlayerViewController ()<IMDImageProvider>
+
+@end
+
+@implementation BitmapPlayerViewController
+
+...
+
+- (void) initPlayer{
+    ...
+    /////////////////////////////////////////////////////// MDVRLibrary
+    MDVRConfiguration* config = [MDVRLibrary createConfig];
+    ...
+    [config asImage:self];
+    ...
+    self.vrLibrary = [config build];
+    /////////////////////////////////////////////////////// MDVRLibrary
+   
+}
+
+// implement the IMDImageProvider protocol here.
+-(void) onProvideImage:(id<TextureCallback>)callback{
+    //
+    SDWebImageDownloader *downloader = [SDWebImageDownloader sharedDownloader];
+    [downloader downloadImageWithURL:self.mURL options:0
+                            progress:^(NSInteger receivedSize, NSInteger expectedSize) {
+                                NSLog(@"progress:%ld/%ld",receivedSize,expectedSize);
+                                // progression tracking code
+                            }
+                           completed:^(UIImage *image, NSData *data, NSError *error, BOOL finished) {
+                               if ( image && finished) {
+                                   // do something with image
+                                   if ([callback respondsToSelector:@selector(texture:)]) {
+                                       [callback texture:image];
+                                   }
+                               }
+                           }];
+    
+    
+}
+
+@end
+```
+See [BitmapPlayerViewController.m](https://github.com/ashqal/MD360Player4iOS/blob/master/MD360Player4iOS/BitmapPlayerViewController.m)
+
 ## Reference
 * [HTY360Player(360 VR Player for iOS)](https://github.com/hanton/HTY360Player)
 * [VideoPlayer-iOS](https://github.com/davidAgo4g/VideoPlayer-iOS)