Discussion

Set a delegate object, in order to get updates on HVTCamera object’s status.

The delegate is not retained.

Discussion

HVTCamera will adjust the orientation of the attached HVTView(s) and the angle returned by [HVTCameraDelegate hvtCamera:didUpdateParams:] to match the supplied interface orientation.

If your app supports multiple orientations, subscribe to the UIDeviceOrientationDidChangeNotification and set the property as shown in the following code fragment:

For iOS 8 devices:

// When you receive a UIDeviceOrientationDidChangeNotification:
_camera.interfaceOrientation = [[UIApplication sharedApplication] statusBarOrientation];

For iOS 7 devices:

// When you receive a UIDeviceOrientationDidChangeNotification:
 UIDeviceOrientation deviceOrientation = [UIDevice currentDevice].orientation;

 if (deviceOrientation == UIDeviceOrientationPortrait
        || deviceOrientation == UIDeviceOrientationLandscapeLeft
        || deviceOrientation == UIDeviceOrientationLandscapeRight) {
    _camera._hvtCameraInstance.interfaceOrientation = (UIInterfaceOrientation)deviceOrientation;
 }

The default value is UIInterfaceOrientationPortrait.

Discussion

Starts the flow of data from the camera device. If HVTView(s) have been added, they will receive updates when new video frames arrive. You can also start video recording.

If the receiver stops running due to an error, it will call the delegate’s [HVTCameraDelegate hvtCamera:didStopRunningWithError:] method.

This call blocks until the receiver has completely started up.

Discussion

Call this method to conserve battery life if you don’t need to update the attached HVTView(s) or if you are not recording.

You don’t need to call this explicitly when the apps goes to background. The HVTCamera instance will stop running automatically and resume upon entering foreground.

This call blocks until the receiver has completely stopped.

Discussion

The outputMovieSize can differ from the cameraResolution. For example, you can have a 1920x1080 camera resolution and a 640x640 final video file.

The default value matches the cameraResolution, until set explicetely via this property.

outputMovieSize cannot be set if the captureMode is set to HVTCaptureModePhoto.

Discussion

For example outputMovieSize cannot be set if the captureMode is set to HVTCaptureModePhoto. If you call just the property setter (setOutputMovieSize:) you will not get an error if the method doesn’t allow you to set this property while in photo mode.

This method will return NO and provide and NSError about it.

Discussion

You must call this method only if the instance isRunning, or an exception is thrown.

Discussion

You must call this method only if the instance isRunning, or an exception is thrown.

Discussion

If the video recorder is not active, this method returns 0.

Discussion

If the video recorder is not active, this method returns 0.

Discussion

If used while recording then you will receive a HVTErrorPhotoModeNotEnabled error by the hvtCamera:photoCapturingDidFailWithError: delegate method.

While recording, you can use the captureSnapshot method to take photos.

Discussion

If used while recording then you will hear the shutter sound.

If used while recording then you will receive a HVTErrorPhotoModeNotEnabled error by the hvtCamera:photoCapturingDidFailWithError: delegate method.

While recording, you can use the captureSnapshot method to take photos.

Discussion

You can change the camera device properties by first calling the AVCaptureDevice’s lockForConfiguration: method.

Discussion

The two capture modes are listed in the HVTCaptureMode enumeration. The default value is HVTCaptureModeVideo.

Capture mode changes automatically to HVTCaptureModeVideo value when setCameraResolution:error: or setCameraResolution:frameRate:error: methods are called

Discussion

You can set or query the current flash mode using this property. Horizon SDK takes care of the availability and the separation between torch/flash for you

Discussion

The default value is kCVPixelFormatType_32BGRA.

You can enter only the following two values for the outputPixelFormat:

kCVPixelFormatType_32BGRA and kCVPixelFormatType_420YpCbCr8BiPlanarVideoRange

Discussion

The value can be negative (for dark scenes) or positive (for bright scenes) and is updated in real-time.

You can observe the changes to this value using KVO.

e.g.

[self addObserver:self
        forKeyPath:@"_camera.brightnessValue"
            options:(NSKeyValueObservingOptionInitial | NSKeyValueObservingOptionOld | NSKeyValueObservingOptionNew)
            context:(__bridge void *)(self)];

Discussion

This is a class method so you can use it without first instanciating the HVTCamera object.

Discussion

To get notified on changes on the property, subscribe to receive NSNotifications with HVTFlashIsAvailableNotification name.

Discussion

Discussion

Discussion

The camera resolution and frame rate of the cameraDevice is set to its default value or to its previous value if it was explicetely set before.

Discussion

Discussion

Discussion

Discussion

Discussion

This methdod is a wrapper of AVCaptureDeviceFormat’s isVideoStabilizationModeSupported: method. It will not work on an iOS7 runtime.

Discussion

This property is a wrapper of AVCaptureConnection’s preferredVideoStabilizationMode property for iOS8 devices. In iOS7 devices, it sets AVCaptureConnection’s setEnablesVideoStabilizationWhenAvailable to YES when the preferredVideoStablizationMode is anything but AVCaptureVideoStabilizationModeOff.

The default value is AVCaptureVideoStabilizationModeOff.

Discussion

Every recording made after setting this property to a valid CMTime will respect the maxRecordingDuration In order to return to unlimited recording, user can set this property value to kCMTimeInvalid

Discussion

The leveler crops each video frame so that the resulting frame is leveled. This involves rotating and scaling the crop region, prior to cropping the frame, according to the device’s physical orientation at that time. The crop mode is the way the leveler adjusts the rotation and scale of the crop region.

Note that scaling the crop region equals to zooming in the original video frame.

The property is animated.

The default value is HVTLevelerCropModeFlex.

Discussion

The default value is HVTLevelerFlexSpeedSmooth.

Discussion

Since leveling is disabled when crop mode is HVTLevelerCropModeLocked, this property should match the device’s physical orientation. For example, if the user is intented to hold the device vertically, use HVTLevelerLockedOrientationVertical. However, if the user decides to turn the device horizontally, the recorded video’s orientation will be wrong.

The property is animated.

The default value is HVTLevelerLockedOrientationAuto.

Discussion

The active filter is applied after the Leveler corrects the video orientation.