Docs / Camera USB SDK for .NET

Show Category

Camera Settings

This page describes how to set and get various camera settings of connected camera device using RICOH Camera USB SDK.

Contents

Supported Camera Settings

Core Class

The core class of camera settings is:

CameraDeviceSetting

  • The CameraDeviceSetting class represents various camera settings of the connected camera device.
  • Supported camera settings are provided as derived class of the CameraDeviceSetting class.

Date and Time

Use the CameraTime class to set and get date and time of connected camera.

Get the Current Value

The following example demonstrates how to get the current date and time of connected camera and System.DateTime object of the same value.

CameraTime cameraTime = new CameraTime();
cameraDevice.GetCameraDeviceSettings(
    new List<CameraDeviceSetting>() { cameraTime });
CameraTimeValue cameraTimeValue = (CameraTimeValue)cameraTime.Value;
DateTime cameraDateTime = cameraTimeValue.Get();

If you want to obtain a System.DateTime object from the acquired CameraTime, use the Get method of CameraTimeValue, which stores the actual value in the CameraTime object.

Set Value

The following example demonstrates how to set camera device’s date and time.

CameraTime cameraTime = new CameraTime(DateTime.Now);
cameraDevice.SetCameraDeviceSettings(
    new List<CameraDeviceSetting>() { cameraTime });

You can use the CameraTime class and the SetCameraDeviceSettings method to set a specified DateTime object.

Live View Specification

Use the LiveViewSpecification class to get current live view specification.

Get Value

The following example demonstrates how to get live view specification.

LiveViewSpecification liveViewSpecification = new LiveViewSpecification();
cameraDevice.GetCameraDeviceSettings(
    new List<CameraDeviceSetting>() { liveViewSpecification }); ;
LiveViewSpecificationValue liveViewSpecificationValue =
    (LiveViewSpecificationValue)liveViewSpecification.Value;
LiveViewImage liveViewImage = liveViewSpecificationValue.Get();
// Image: 720x480,
// FocusArea:
//     (0.1, 0.166666), (0.9, 0.166666),
//     (0.1, 0.833333), (0.9, 0.833333)

If you want to obtain a LiveViewImage object from the acquired LiveViewSpecification, use the Get method of LiveViewSpecificationValue, which stores the actual value in the LiveViewSpecification object.

LiveViewImage object has height and width size of the live view image and the range where focus position can be specified on the live view image. FocusArea represents the upper left corner of the live view image as (0.0, 0.0), the upper right as (1.0, 0.0), the lower left as (0.0, 1.0), and the lower right as (1.0, 1.0). The inside of the area represented by each point included in FocusArea is the position specifiable range.

This information is used by Focus with Specified Position.