CropTarget
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Screen Capture API")}}{{SeeCompatTable}}
The **CropTarget** interface of the {{domxref("Screen Capture API", "Screen Capture API", "", "nocode")}} provides a static method, {{domxref("CropTarget.fromElement_static", "fromElement()")}}, which returns a CropTarget instance that can be used to crop a captured video track to the area in which a specified element is rendered.
{{InheritanceDiagram}}
Static methods
- {{domxref("CropTarget.fromElement_static", "fromElement()")}} {{Experimental_Inline}}
- : Returns a
CropTargetinstance that can be used to crop a captured video track to the area in which a specified element is rendered.
Examples
js
// Options for getDisplayMedia()
const displayMediaOptions = {
preferCurrentTab: true,
};
// Create crop target from DOM element
const demoElem = document.querySelector("#demo");
const cropTarget = await CropTarget.fromElement(demoElem);
// Capture video stream from user's webcam and isolate video track
const stream =
await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
const [track] = stream.getVideoTracks();
// Crop video track
await track.cropTo(cropTarget);
// Broadcast cropped stream in <video> element
videoElem.srcObject = stream;See Using the Element Capture and Region Capture APIs for in-context example code.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Screen Capture API
- Using the Element Capture and Region Capture APIs