DJICamera(SSDOperations)

@interface DJICamera (SSDOperations)

X5, X5R and X5S cameras are DSLR quality cameras that can save JPEG, lossless raw images, MP4 videos, and raw videos requiring very high amounts of storage in the range of 500 Gb or more. A Solid State Drive (SSD) provides such storage. Note that JPEG is a compressed format, and raw images store much more information and allow for a full range of postprocessing features.

  • Determines whether the SSD is supported by the camera. SSD is supported by X5R, X4S and X5S camera.

    Declaration

    Objective-C

    - (BOOL)isSSDSupported;

  • Formats the SSD by deleting all the data on the SSD. This does not change any settings the user may have set on the SSD.

    Declaration

    Objective-C

    - (void)formatSSDWithCompletion:(DJICompletionBlock)block;

  • Set SSD Video Resolution and Frame Rate when using the SSD.

    Only RAW, CinemaDNG, Apple ProRes 424 HQ and Apple ProRes 4444 XQ video is saved to the SSD. Other compressed videos and pictures (RAW or compressed) are all saved to the SD Card. During video capture, both SSD video and compressed video are saved simultaneously to the SSD and SD Card respectively.

    For X5R, the supported resolutions and frame rates for SSD Video are shown below:

    NTSC:
    Resolution_4096x2160, FrameRate_24fps
    Resolution_3840x2160, FrameRate_24fps
    Resolution_3840x2160, FrameRate_30fps
    Resolution_2704X1520, FrameRate_24fps
    Resolution_2704X1520, FrameRate_30fps
    Resolution_1920x1080, FrameRate_60fps
    Resolution_1920x1080, FrameRate_48fps
    Resolution_1920x1080, FrameRate_30fps
    Resolution_1920x1080, FrameRate_24fps



    PAL:
    Resolution_4096x2160, FrameRate_25fps
    Resolution_4096x2160, FrameRate_24fps
    Resolution_3840x2160, FrameRate_25fps
    Resolution_3840x2160, FrameRate_24fps
    Resolution_2704X1520, FrameRate_25fps
    Resolution_2704X1520, FrameRate_24fps
    Resolution_1920x1080, FrameRate_50fps
    Resolution_1920x1080, FrameRate_48fps
    Resolution_1920x1080, FrameRate_25fps
    Resolution_1920x1080, FrameRate_24fps

    For X5S, the possible frame rate and resolutions are determined by a combination of SD video frame rate, the SSD video license being used and the set analog video standard. The X5S SSD video frame rate is always the same as the SD video frame rate. Therefore the frameRate parameter is ignored for this method. The available X5S resolutions are determined by the analog video standard, the SSD video license being used (CinemaDNG can have higher frame rates than Apple ProRes) and the SD video frame rate (higher frame rates do not support the highest resolutions). The available SSD video resolutions can be queried using supportedCameraSSDVideoResolutionRange in DJICameraParameters.

    Declaration

    Objective-C

    - (void)setSSDVideoResolution:(DJICameraVideoResolution)resolution
                 andFrameRate:(DJICameraVideoFrameRate)frameRate
               withCompletion:(DJICompletionBlock)block;

    Parameters

    resolution

    Resolution to be set for the video.
    frameRate

    Frame rate to be set for the video.
    block

    Remote execution result error block.

  • Get SSD Video resolution and frame rate.

    Declaration

    Objective-C

    - (void)getSSDVideoResolutionAndFrameRateWithCompletion:
    (void (^_Nonnull)(DJICameraVideoResolution, DJICameraVideoFrameRate,
                      NSError *_Nullable))block;

    Parameters

    block

    Get raw video resolution and frame rate result callback block.

  • Sets the digital filter for video that will be stored in SSD. It is only used when the selected SSD video license is DJICameraSSDVideoLicenseProRes422HQ or DJICameraSSDVideoLicenseProRes4444XQ. Only supported by Inspire 2.

    Declaration

    Objective-C

    - (void)setSSDVideoDigitalFilter:(DJICameraSSDVideoDigitalFilter)filter
                  withCompletion:(DJICompletionBlock)block;

    Parameters

    filter

    Digital filter to set.
    block

    Completion block that receives the setter result.

  • Gets the digital filter to be used for SSD video. Only supported by Inspire 2.

    Declaration

    Objective-C

    - (void)getSSDVideoDigitalFilterWithCompletion:
    (void (^_Nonnull)(DJICameraSSDVideoDigitalFilter, NSError *_Nullable))block;

    Parameters

    block

    Completion block that receives the getter result.

  • Gets purchased SSD video licenses. An SSD video license permits usage of CinemaDNG or Apple ProRes inside CineCore 2.0 on an Inspire 2. Licenses can be purchased on DJI’s website, and downloaded to the Inspire 2 using DJI Assistant 2. Only supported by Inspire 2.

    Declaration

    Objective-C

    - (void)getSSDVideoLicensesWithCompletion:
    (void (^_Nonnull)(NSArray<NSNumber *> *_Nonnull, NSError *_Nullable))block;

    Parameters

    block

    Completion block that receives the setter result. Each element in licenses is a DJICameraPurchasedLicense instance of NSNumber.

  • Sets the SSD video license to be used. If an unpurchased license is selected then only SD video will be recorded. It is supported by Inspire 2.

    Declaration

    Objective-C

    - (void)activateSSDVideoLicense:(DJICameraSSDVideoLicense)license
                 withCompletion:(DJICompletionBlock)block;

    Parameters

    license

    License to used.
    block

    Completion block that receives the setter result.

  • Gets the SSD video license being used. It is supported by Inspire 2.

    Declaration

    Objective-C

    - (void)getSSDVideoLicenseWithCompletion:
    (void (^_Nonnull)(DJICameraSSDVideoLicense, NSError *_Nullable))block;

    Parameters

    block

    Completion block that receives the getter result.

  • Enables/disables the recording of SSD video. Other SSD video interfaces can only be used when it is enabled. Only supported by X5S. For X5R, SSD video recording is always enabled if there is SSD inserted.

    Declaration

    Objective-C

    - (void)setSSDVideoRecordingEnabled:(BOOL)enabled
                     withCompletion:(DJICompletionBlock)block;

    Parameters

    enabled

    YES to enable the SSD video recording.
    block

    Completion block that receives the setter result.

  • Gets if SSD video recording is enabled Only supported by X5S.

    Declaration

    Objective-C

    - (void)getSSDVideoRecordingEnabledWithCompletion:
    (void (^_Nonnull)(BOOL, NSError *_Nullable))block;

    Parameters

    block

    Completion block that receives the getter result.