IKCameraDeviceView Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/Quartz.framework/ImageKit.framework
Availability
Available in OS X v10.6 and later.
Declared in
IKCameraDeviceView.h

Overview

The IKCameraDeviceView class displays the contents of the selected camera.

Tasks

Getting and Setting the Camera Device

View Display Mode

Selecting the File Transfer Mode

Configuring Download Interface and Downloading Files

Getting and Setting the Post Processing Application

Deleting Selected Items

Selection Management

Getting and Setting the Delegate

Selected Item Rotation

Properties

cameraDevice

The current camera device.

@property(assign) ICCameraDevice *cameraDevice
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

canDeleteSelectedItems

Returns whether the selected items can be deleted. (read-only)

@property(readonly) BOOL canDeleteSelectedItems
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

canDownloadSelectedItems

Returns whether the selected items can be downloaded (read-only)

@property(readonly) BOOL canDownloadSelectedItems
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

canRotateSelectedItemsLeft

Returns whether the selected items can be rotated left. (read-only)

@property(readonly) BOOL canRotateSelectedItemsLeft
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

canRotateSelectedItemsRight

Returns whether the selected items can be rotated right. (read-only)

@property(readonly) BOOL canRotateSelectedItemsRight
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

delegate

The camera device view delegate.

@property(assign) id<IKCameraDeviceViewDelegate> delegate
Discussion

The delegate must conform to the IKCameraDeviceViewDelegate protocol.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

displaysDownloadsDirectoryControl

Specifies whether the downloads directory control should be displayed.

@property BOOL displaysDownloadsDirectoryControl
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

displaysPostProcessApplicationControl

Displays whether the post process application control should be displayed.

@property BOOL displaysPostProcessApplicationControl
Discussion

The post process application is only relevant when the transferMode is set to IKCameraDeviceViewTransferModeFileBased.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

downloadAllControlLabel

Allows the “Download All” control to be renamed.

@property(copy) NSString *downloadAllControlLabel
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

downloadsDirectory

Specifies the directory where files are downloaded

@property(retain) NSURL *downloadsDirectory
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

downloadSelectedControlLabel

Allows the “Download Selected” control to be renamed.

@property(copy) NSString *downloadSelectedControlLabel
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

hasDisplayModeIcon

Returns whether the device view is being displayed in icon mode.

@property BOOL hasDisplayModeIcon
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

hasDisplayModeTable

Returns whether the device view is being displayed in table mode.

@property BOOL hasDisplayModeTable
Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

iconSize

Specifies the icon size.

@property NSUInteger iconSize
Discussion

The icon is square, so only a single dimension is required.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

mode

Specifies the display mode of the camera device view.

Discussion

The possible values are listed in “Camera View Display Modes”

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

postProcessApplication

The URL of the application used to post process the image.

@property(retain) NSURL *postProcessApplication
Discussion

The post process application is only relevant when the transferMode is set to IKCameraDeviceViewTransferModeFileBased.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

transferMode

Determines how the contents are saved by the delegate.

@property IKCameraDeviceViewTransferMode transferMode
Discussion

The possible values are described in “Camera File Transfer Modes.”

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

Instance Methods

deleteSelectedItems:

Deletes the currently selected items.

- (void)deleteSelectedItems:(id)sender
Parameters
sender

The object that sent the message.

Discussion

This method is can be connected to a user interface item in Interface Builder.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

downloadAllItems:

Downloads all the items.

- (void)downloadAllItems:(id)sender
Parameters
sender

The object that sent the message.

Discussion

This method is can be connected to a user interface item in Interface Builder.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

downloadSelectedItems:

Deletes the selected items from the camera.

- (void)downloadSelectedItems:(id)sender
Parameters
sender

The object that sent the message.

Discussion

This method is can be connected to a user interface item in Interface Builder.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

rotateLeft:

Rotates the selected image to the left.

- (void)rotateLeft:(id)sender
Parameters
sender

The object that sent the message.

Discussion

This method is can be connected to a user interface item in Interface Builder.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

rotateRight:

Rotates the selected image to the right.

- (void)rotateRight:(id)sender
Parameters
sender

The object that sent the message.

Discussion

This method is can be connected to a user interface item in Interface Builder.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

selectedIndexes

The selected indexes of the camera files.

- (NSIndexSet *)selectedIndexes
Return Value

The indexes of the selected files.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

selectIndexes:byExtendingSelection:

Invoked to select the specified files, extending the selection if specified.

- (void)selectIndexes:(NSIndexSet *)indexes byExtendingSelection:(BOOL)extend
Parameters
indexes

The indexes of the files to select.

extend

YES if the selection should be extended, otherwise NO.

Availability
  • Available in OS X v10.6 and later.
Declared In
IKCameraDeviceView.h

Constants

Camera View Display Modes

These constants specify the display mode used by the camera view. These constants are used by mode.

enum
{
   IKCameraDeviceViewDisplayModeTable = 0,
   IKCameraDeviceViewDisplayModeIcon
};
typedef NSInteger IKCameraDeviceViewDisplayMode;
Constants
IKCameraDeviceViewDisplayModeTable

Display the devices in as a table.

Available in OS X v10.6 and later.

Declared in IKCameraDeviceView.h.

IKCameraDeviceViewDisplayModeIcon

Display the devices as icons.

Available in OS X v10.6 and later.

Declared in IKCameraDeviceView.h.

Camera File Transfer Modes

These constants specify the transfer mode used by the camera view. These constants are used by mode.

enum
{
   IKCameraDeviceViewTransferModeFileBased = 0,
   IKCameraDeviceViewTransferModeMemoryBased
};
typedef NSInteger IKCameraDeviceViewTransferMode;
   
Constants
IKCameraDeviceViewTransferModeFileBased

Transferred files will be saved to disk by the delegate.

Available in OS X v10.6 and later.

Declared in IKCameraDeviceView.h.

IKCameraDeviceViewTransferModeMemoryBased

Transferred files will be supplied to the delegate as an NSData object.

Available in OS X v10.6 and later.

Declared in IKCameraDeviceView.h.