Module cam2: Extended Camera Functions

Compatibility of module cam2 Nokia S60 3rd Edition phones and Nokia S60 5th Edition phones. ok

This module provides extended camera functions for S60 3rd (5th) via the CameraWrapper module, like setting flash and exposure modes, zoom level and performing autofocusing.

• Note 1: To use this module in m, the camera wrapper DLL must be installed on the device (this comes in a separate SISX which can be downloaded from Nokia.
• Note 2: This module should not be used together with module module cam.

• cam2.bright
• cam2.contrast
• cam2.exposure
• cam2.flash
• cam2.focus
• cam2.index
• cam2.off
• cam2.on
• cam2.take
• cam2.view
• cam2.zoom
• Constants

cam2.bright

Same as cam.bright - Set and get the brightness.

cam2.contrast

Same as cam.contrast - Set and get the contrast.

cam2.exposure

Set and get the exposure mode (see Constants). With first parameter null, returns the (theoretically) supported exposure modes (bits). Without parameter, returns the current exposure mode. With numeric parameter, set the corresponding exposure mode.

cam2.flash

Set and get the flash mode (see Constants). With the first parameter null, returns the (theoretically) supported flash modes (bits). Without parameter, returns the current flash mode. With a numeric parameter, set the corresponding flash mode.

cam2.focus

Get the supported focus ranges (bits), and perform focusing. With first parameter null, returns the (theoretically) supported focus ranges (these are often not reliable). A value of 0 indicates that focusing is not supported. With the first parameter numeric, waits until focusing has completed. If timeout>=0, waits up to that many milliseconds. Returns true if focusing completed, false otherwise. With the first parameter boolean, starts (start=true) or cancels (start=false) focusing. If start=true, range indicates the focusing range, i.e. one of the bits returned by cam2.focus(null).

cam2.index

Same as cam.index - Set and get the selected camera.

cam2.off

Same as cam.off - Turns the camera off.

cam2.on

Turns the camera on and prepares it to take images of width (close to) w and height (close to) h. Returns the actual size of the images taken.

cam2.take

Take an image and save it in JPEG/EXIF format with the given JPEG quality. Returns the size of the created file. Unlike cam.take, cam2.take does not support taking images as graph.icons. They can however be loaded using graph.icon.

cam2.view

Show the viewfinder on the current control at the given position, after scaling the image (size requested with cam2.on()) by scale and rotating it counterclockwise by rotate degrees (must be a multiple of 90). Returns the actual size of the rectangle (in view coordinates). With a single boolean parameter, turns the view finder on (on=true) or off (on=false).

cam2.zoom

Set and get the zoom level. Without parameter, return the current zoom level. With parameter, sets the current zoom level to z, and returns the old level.

cam2 Constants