diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
commit | 074785cea106179cb3305637055ab0a009ca74f2 (patch) | |
tree | e6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/pt-br/web/api/cameracontrol | |
parent | da78a9e329e272dedb2400b79a3bdeebff387d47 (diff) | |
download | translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2 translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip |
initial commit
Diffstat (limited to 'files/pt-br/web/api/cameracontrol')
-rw-r--r-- | files/pt-br/web/api/cameracontrol/autofocus/index.html | 61 | ||||
-rw-r--r-- | files/pt-br/web/api/cameracontrol/index.html | 108 |
2 files changed, 169 insertions, 0 deletions
diff --git a/files/pt-br/web/api/cameracontrol/autofocus/index.html b/files/pt-br/web/api/cameracontrol/autofocus/index.html new file mode 100644 index 0000000000..1ce3b547d3 --- /dev/null +++ b/files/pt-br/web/api/cameracontrol/autofocus/index.html @@ -0,0 +1,61 @@ +--- +title: CameraControl.autoFocus() +slug: Web/API/CameraControl/autoFocus +translation_of: Archive/B2G_OS/API/CameraControl/autoFocus +--- +<p>{{APIRef("Camera API")}}{{ non-standard_header() }}{{B2GOnlyHeader2('privileged')}}</p> + +<h2 id="Resumo">Resumo</h2> + +<p>This method attempts to focus the camera. If the camera is able to attempt to focus, a success callback is issued, regardless of whether or not the focusing attempt succeeds. If unable to attempt to focus, an error callback is performed instead.</p> + +<p>The success or failure of the focus operation is indicated by the value of a parameter passed into the callback function.</p> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre>CameraControl.autoFocus(onsuccess[, onerror]);</pre> + +<h3 id="Parametros">Parametros</h3> + +<dl> + <dt><code>onsuccess</code></dt> + <dd>A callback function called when a focus attempt is made</dd> + <dt><code>onerror</code> {{optional_inline()}}</dt> + <dd>An optional callback function that accepts an error string as an input parameter; this is called if it's not possible to attempt to focus the camera.</dd> +</dl> + +<h2 id="Exemplo">Exemplo</h2> + +<pre class="brush: js">function onFocusPossible( success ) { + if ( success ) { + console.log("The image has been focused"); + } else { + console.log("The image has not been focused"); + } +} + +function onFocusNotPossible( error ) { + console.log("The camera is not able to focus anything"); + console.log( error ); +} + +function onAccessCamera( camera ) { + camera.autoFocus(onFocusPossible, onFocusNotPossible); +}; + +var options = { + camera: navigator.mozCameras.getListOfCameras()[0] +}; + +navigator.mozCameras.getCamera(options, onAccessCamera) +</pre> + +<h2 id="Specification" name="Specification">Especificações</h2> + +<p>Not part of any specification; however, this API should be removed when the <a class="external" href="http://dev.w3.org/2011/webrtc/editor/getusermedia.html" rel="external" title="http://dev.w3.org/2011/webrtc/editor/getusermedia.html">WebRTC Capture and Stream API</a> has been implemented.</p> + +<h2 id="Leia_mais">Leia mais</h2> + +<ul> + <li>{{domxref("CameraControl")}}</li> +</ul> diff --git a/files/pt-br/web/api/cameracontrol/index.html b/files/pt-br/web/api/cameracontrol/index.html new file mode 100644 index 0000000000..e0b5bdd2c0 --- /dev/null +++ b/files/pt-br/web/api/cameracontrol/index.html @@ -0,0 +1,108 @@ +--- +title: CameraControl +slug: Web/API/CameraControl +tags: + - API + - B2G + - DOM + - DOM Reference + - Firefox OS + - Graphics + - JavaScript + - NeedsTranslation + - Non-standard + - Reference + - TopicStub + - WebAPI + - camera +translation_of: Archive/B2G_OS/API/CameraControl +--- +<p>{{APIRef("Camera API")}}</p> + +<p>{{ non-standard_header() }}</p> + +<p>{{B2GOnlyHeader2('privileged')}}</p> + +<p><span class="seoSummary">When you use the {{domxref("CameraManager.getCamera()")}} method to get a reference to a camera, you specify a callback function to be invoked on success. That function receives as a parameter a <code>CameraControl</code> object. You can use its methods and properties to manage and make use of the camera.</span></p> + +<h2 id="Properties">Properties</h2> + +<dl> + <dt>{{domxref("CameraControl.capabilities")}} {{readonlyinline}}</dt> + <dd>A {{domxref("CameraCapabilities")}} object indicating all the capabilities for the given camera.</dd> + <dt>{{domxref("CameraControl.effect")}}</dt> + <dd>A string defining the effect to be used by the camera (<code>none</code> by default). Its value must be one of the values available in {{domxref("CameraCapabilities.effects")}}.</dd> + <dt>{{domxref("CameraControl.exposureCompensation")}} {{readonlyinline}}</dt> + <dd>A value used to compensate the camera exposure. This attribute is read-only; to change the exposure, you need to call the {{domxref("CameraControl.setExposureCompensation()")}} method.</dd> + <dt>{{domxref("CameraControl.flashMode")}}</dt> + <dd>A string that defines how the flash, if any, is to be used; this is <code>auto</code> by default if the device has a flash, <code>none</code> otherwise. When set, its value must be chosen from the list of options specified by {{domxref("CameraCapabilities.flashModes")}}<code>.</code></dd> + <dt>{{domxref("CameraControl.focalLength")}} {{readonlyinline}}</dt> + <dd>A number that express the camera's focal length in millimeters.</dd> + <dt>{{domxref("CameraControl.focusAreas")}}</dt> + <dd>An <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array" title="/en-US/docs/JavaScript/Reference/Global_Objects/Array"><code>Array</code></a> of one or more objects that define where the camera will perform auto-focusing.</dd> + <dt>{{domxref("CameraControl.focusDistanceFar")}} {{readonlyinline}}</dt> + <dd>This value is a distance in meter used with {{domxref("CameraControl.focusDistanceNear")}} to defined the image's depth of field. The value for this property may be <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Infinity" title="/en-US/docs/JavaScript/Reference/Global_Objects/Infinity">Infinity</a></code>.</dd> + <dt>{{domxref("CameraControl.focusDistanceNear")}} {{readonlyinline}}</dt> + <dd>This value is a distance in meter used with {{domxref("CameraControl.focusDistanceFar")}} to defined the image's depth of field.</dd> + <dt>{{domxref("CameraControl.focusDistanceOptimum")}} {{readonlyinline}}</dt> + <dd>This value is a distance in meter where the subject will appear sharpest.</dd> + <dt>{{domxref("CameraControl.focusMode")}}</dt> + <dd>A string that defines which kind of focus mode the camera should use (<code>auto</code> or <code>fixed</code> by default). Its value must be chosen from {{domxref("CameraCapabilities.focusModes")}}.</dd> + <dt>{{domxref("CameraControl.meteringAreas")}}</dt> + <dd>An <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array" title="/en-US/docs/JavaScript/Reference/Global_Objects/Array"><code>Array</code></a> of one or more objects that define where the camera will perform auto-focusing.</dd> + <dt>{{domxref("CameraControl.onShutter")}}</dt> + <dd>A handler for the camera's "shutter" event, to trigger a shutter sound and/or a visual shutter indicator.</dd> + <dt>{{domxref("CameraControl.onClosed")}}</dt> + <dd>A handler called when a new <code>CameraControl</code> object in the same app takes over the camera.</dd> + <dt>{{domxref("CameraControl.onRecorderStateChange")}}</dt> + <dd>A function to call when the recorder changes state, either because the recording process encountered an error, or because one of the recording limits (see {{domxref("CameraControl.startRecording()")}}) was reached.</dd> + <dt>{{domxref("CameraControl.sceneMode")}}</dt> + <dd>A string that defines which scene mode the camera is to use (<code>auto</code> by default). Its value must be chosen from {{domxref("CameraCapabilities.sceneModes")}}.</dd> + <dt>{{domxref("CameraControl.whiteBalanceMode")}}</dt> + <dd>A string that defines which white balance mode the camera is to use (<code>auto</code> by default). Its value must be chosen from {{domxref("CameraCapabilities.whiteBalanceModes")}}.</dd> + <dt>{{domxref("CameraControl.zoom")}}</dt> + <dd>A number that defines which kind of zoom factor mode the camera is to use (1 by default). Its value must be chosen from {{domxref("CameraCapabilities.zoomRatios")}}.</dd> +</dl> + +<h2 id="Methods">Methods</h2> + +<dl> + <dt>{{ domxref("CameraControl.autoFocus()") }}</dt> + <dd>Tells the camera to attempt to focus the image.</dd> + <dt>{{ domxref("CameraControl.getPreviewStream()") }}</dt> + <dd>Gets a video stream from the camera; you can use this in an arbitrary context.</dd> + <dt>{{ domxref("CameraControl.getPreviewStreamVideoMode()") }}</dt> + <dd>Gets a video stream from the camera based on a specific video mode.</dd> + <dt>{{ domxref("CameraControl.release()") }}</dt> + <dd>Releases the camera so that other applications can use it.</dd> + <dt>{{ domxref("CameraControl.resumePreview()") }}</dt> + <dd>Resumes the preview video stream after it's been paused by a call to {{domxref("CameraControl.takePicture()")}}.</dd> + <dt>{{ domxref("CameraControl.setExposureCompensation()") }}</dt> + <dd>Lets you specify the exposure compensation factor.</dd> + <dt>{{ domxref("CameraControl.startRecording()") }}</dt> + <dd>Lets you start recording a video stream.</dd> + <dt>{{ domxref("CameraControl.stopRecording()") }}</dt> + <dd>Lets you stop recording a video stream.</dd> + <dt>{{ domxref("CameraControl.pauseRecording()") }}</dt> + <dd>Pauses the recording of a video stream.</dd> + <dt>{{ domxref("CameraControl.resumeRecording()") }}</dt> + <dd>Resumes the recording of a video stream that has previously been paused.</dd> + <dt>{{ domxref("CameraControl.takePicture()") }}</dt> + <dd>Lets you capture a single image, receiving it as a {{domxref("Blob")}}.</dd> +</dl> + +<h2 id="Specification" name="Specification">Specification</h2> + +<p>{{page("/en-US/docs/Web/API/Navigator.MozCameras","Specification")}}</p> + +<h2 id="Permissions">Permissions</h2> + +<p>{{page("/en-US/docs/Web/API/Navigator.MozCameras","Permissions")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{ domxref("CameraManager") }}</li> + <li>{{ domxref("CameraCapabilities") }}</li> + <li>{{ domxref("navigator.mozCamera") }}</li> +</ul> |