~ubuntu-branches/ubuntu/trusty/monodevelop/trusty-proposed

To record, you must create instances of the <see cref="T:MonoMac.AVFoundation.AVCaptureInput" /> class, usually by creating instances of the concrete <see cref="T:MonoMac.AVFoundation.AVCaptureDeviceInput" />.

</para>

<para>

You can the configure one or more output ports for the

captured data, and these can be still frames, video frames

with timing information, audio samples, quicktime movie files

or you can render it directly to a CoreAnimation layer.

</para>

<para>

Once you have configured the input and output components of

your session, you start the actual processing by calling the

method.

</para>

void SetupCapture ()

/ configure the capture session for low resolution, change this if your code

// can cope with more data or volume

session = new AVCaptureSession () {

SessionPreset = AVCaptureSession.PresetMedium

};

// create a device input and attach it to the session

var captureDevice = AVCaptureDevice.DefaultDeviceWithMediaType (AVMediaType.Video);

var input = AVCaptureDeviceInput.FromDevice (captureDevice);

if (input == null){

Console.WriteLine ("No video input device");

return false;

}

session.AddInput (input);

// create a VideoDataOutput and add it to the sesion

var output = new AVCaptureVideoDataOutput () {

VideoSettings = new AVVideoSettings (CVPixelFormatType.CV32BGRA),

// If you want to cap the frame rate at a given speed, in this sample: 15 frames per second

MinFrameDuration = new CMTime (1, 15)

};

// configure the output

queue = new MonoMac.CoreFoundation.DispatchQueue ("myQueue");

outputRecorder = new OutputRecorder ();

output.SetSampleBufferDelegateAndQueue (outputRecorder, queue);

session.AddOutput (output);

session.StartRunning ();

}

public class OutputRecorder : AVCaptureVideoDataOutputSampleBufferDelegate {

public override void DidOutputSampleBuffer (AVCaptureOutput captureOutput, CMSampleBuffer sampleBuffer, AVCaptureConnection connection)

{

try {

var image = ImageFromSampleBuffer (sampleBuffer);

// Do something with the image, we just stuff it in our main view.

AppDelegate.ImageView.BeginInvokeOnMainThread (delegate {

AppDelegate.ImageView.Image = image;

});

// Although this looks innocent "Oh, he is just optimizing this case away"

100

// this is incredibly important to call on this callback, because the AVFoundation

101

// has a fixed number of buffers and if it runs out of free buffers, it will stop

102

// delivering frames.

103

104

sampleBuffer.Dispose ();

105

} catch (Exception e){

106

Console.WriteLine (e);

107

}

108

}

109

110

UIImage ImageFromSampleBuffer (CMSampleBuffer sampleBuffer)

111

{

112

// Get the CoreVideo image

113

using (var pixelBuffer = sampleBuffer.GetImageBuffer () as CVPixelBuffer){

114

// Lock the base address

115

pixelBuffer.Lock (0);

116

// Get the number of bytes per row for the pixel buffer

117

var baseAddress = pixelBuffer.BaseAddress;

118

int bytesPerRow = pixelBuffer.BytesPerRow;

119

int width = pixelBuffer.Width;

120

int height = pixelBuffer.Height;

121

var flags = CGBitmapFlags.PremultipliedFirst | CGBitmapFlags.ByteOrder32Little;

122

// Create a CGImage on the RGB colorspace from the configured parameter above

123

using (var cs = CGColorSpace.CreateDeviceRGB ())

124

using (var context = new CGBitmapContext (baseAddress,width, height, 8, bytesPerRow, cs, (CGImageAlphaInfo) flags))

125

using (var cgImage = context.ToImage ()){

126

pixelBuffer.Unlock (0);

127

return UIImage.FromImage (cgImage);

128

}

129

}

130

}

131

}

132

133

</code>

134

</example>

135

</remarks>

136

<related type="sample" href="http://samples.xamarin.com/Samples/ByGuid?guid=9fa28988-64fe-4365-b2b7-95542daf4f9b">avcaptureframes</related>

137

</Docs>

138

139

140

141

142

<MemberType>Constructor</MemberType>

143

144

145

</AssemblyInfo>

146

147

148

<AttributeName>MonoMac.Foundation.Export("init")</AttributeName>

149

</Attribute>

150

151

<AttributeName>System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)</AttributeName>

152

</Attribute>

153

</Attributes>

154

155

<Docs>

156

<summary>Default constructor that initializes a new instance of this class with no parameters.</summary>

157

158

</remarks>

159

</Docs>

160

</Member>

161

162

163

164

<MemberType>Constructor</MemberType>

165

166

167

</AssemblyInfo>

168

169

170

<AttributeName>MonoMac.Foundation.Export("initWithCoder:")</AttributeName>

171

</Attribute>

172

173

<AttributeName>System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)</AttributeName>

174

</Attribute>

175

</Attributes>

176

177

178

</Parameters>

179

<Docs>

180

<param name="coder">The unarchiver object.</param>

181

<summary>A constructor that initializes the object from the data stored in the unarchiver object.</summary>

182

<remarks>This constructor is provided to allow the class to be initialized from an unarchiver (for example, during NIB deserialization).</remarks>

183

</Docs>

184

</Member>

185

186

187

188

<MemberType>Constructor</MemberType>

189

190

191

</AssemblyInfo>

192

193

194

<AttributeName>System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)</AttributeName>

195

</Attribute>

196

</Attributes>

197

198

199

</Parameters>

200

<Docs>

201

<param name="t">Unused sentinel value, pass NSObjectFlag.Empty.</param>

202

<summary>Constructor to call on derived classes when the derived class has an [Export] constructor.</summary>

203

204

<para>This constructor should be called by derived classes when they are initialized using an [Export] attribute. The argument value is ignore, typically the chaining would look like this:</para>

205

206

207

public class MyClass : BaseClass {

208

[Export ("initWithFoo:")]

209

public MyClass (string foo) : base (NSObjectFlag.Empty)

210

{

211

...

212

}

213

</code>

214

</example>

215

</remarks>

216

</Docs>

217

</Member>

218

219

220

221

<MemberType>Constructor</MemberType>

222

223

224

</AssemblyInfo>

225

226

227

<AttributeName>System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)</AttributeName>

228

</Attribute>

229

</Attributes>

230

231

232

</Parameters>

233

<Docs>

234

<param name="handle">Pointer (handle) to the unmanaged object.</param>

235

<summary>A constructor used when creating managed representations of unmanaged objects; Called by the runtime.</summary>

236

237

<para>This constructor is invoked by the runtime infrastructure (<see cref="M:MonoMac.ObjCRuntime.GetNSObject (System.IntPtr)" />) to create a new managed representation for a pointer to an unmanaged Objective-C object. You should not invoke this method directly, instead you should call the GetNSObject method as it will prevent two instances of a managed object to point to the same native object.</para>

238

</remarks>

239

</Docs>

240

</Member>

241

242

243

244

<MemberType>Method</MemberType>

245

246

247

</AssemblyInfo>

248

249

250

<AttributeName>MonoMac.Foundation.Export("addInput:")</AttributeName>

251

</Attribute>

252

</Attributes>

253

254

<ReturnType>System.Void</ReturnType>

255

</ReturnValue>

256

257

258

</Parameters>

259

<Docs>

260

<param name="input">The AVCaptureInput to add to the session</param>

261

<summary>Adds an input to the Capture Session</summary>

262

<remarks>To be added.</remarks>

263

</Docs>

264

</Member>

265

266

267

268

<MemberType>Method</MemberType>

269

270

271

</AssemblyInfo>

272

273

274

<AttributeName>MonoMac.Foundation.Export("addOutput:")</AttributeName>

275

</Attribute>

276

</Attributes>

277

278

<ReturnType>System.Void</ReturnType>

279

</ReturnValue>

280

281

282

</Parameters>

283

<Docs>

284

<param name="output">To be added.</param>

285

<summary>Adds an output to the capture session.</summary>

286

<remarks>To be added.</remarks>

287

</Docs>

288

</Member>

289

290

291

292

<MemberType>Method</MemberType>

293

294

295

</AssemblyInfo>

296

297

298

<AttributeName>MonoMac.Foundation.Export("beginConfiguration")</AttributeName>

299

</Attribute>

300

</Attributes>

301

302

<ReturnType>System.Void</ReturnType>

303

</ReturnValue>

304

305

<Docs>

306

<summary>Initiates a transaction to change the configuration of the Capture Session.</summary>

307

<remarks>To be added.</remarks>

308

</Docs>

309

</Member>

310

311

312

313

<MemberType>Method</MemberType>

314

315

316

</AssemblyInfo>

317

318

319

<AttributeName>MonoMac.Foundation.Export("canAddInput:")</AttributeName>

320

</Attribute>

321

</Attributes>

322

323

<ReturnType>System.Boolean</ReturnType>

324

</ReturnValue>

325

326

327

</Parameters>

328

<Docs>

329

<param name="input">To be added.</param>

330

<summary>Returns whether the given input can be added to the session.</summary>

331

<returns>To be added.</returns>

332

<remarks>To be added.</remarks>

333

</Docs>

334

</Member>

335

336

337

338

<MemberType>Method</MemberType>

339

340

341

</AssemblyInfo>

342

343

344

<AttributeName>MonoMac.Foundation.Export("canAddOutput:")</AttributeName>

345

</Attribute>

346

</Attributes>

347

348

<ReturnType>System.Boolean</ReturnType>

349

</ReturnValue>

350

351

352

</Parameters>

353

<Docs>

354

<param name="output">To be added.</param>

355

<summary>Returns whether the given input can be added to the session.</summary>

356

<returns>To be added.</returns>

357

<remarks>To be added.</remarks>

358

</Docs>

359

</Member>

360

361

362

363

<MemberType>Method</MemberType>

364

365

366

</AssemblyInfo>

367

368

369

<AttributeName>MonoMac.Foundation.Export("canSetSessionPreset:")</AttributeName>

370

</Attribute>

371

</Attributes>

372

373

<ReturnType>System.Boolean</ReturnType>

374

</ReturnValue>

375

376

377

</Parameters>

378

<Docs>

379

<param name="preset">To be added.</param>

380

<summary>To be added.</summary>

381

<returns>To be added.</returns>

382

<remarks>To be added.</remarks>

383

</Docs>

384

</Member>

385

386

387

388

<MemberType>Property</MemberType>

389

390

391

</AssemblyInfo>

392

393

<ReturnType>System.IntPtr</ReturnType>

394

</ReturnValue>

395

<Docs>

396

<summary>The handle for this class.</summary>

397

<value>The pointer to the Objective-C class.</value>

398

<remarks>Each MonoMac class mirrors an unmanaged Objective-C class. This value contains the pointer to the Objective-C class, it is similar to calling objc_getClass with the object name.</remarks>

399

</Docs>

400

</Member>

401

402

403

404

<MemberType>Method</MemberType>

405

406

407

</AssemblyInfo>

408

409

410

<AttributeName>MonoMac.Foundation.Export("commitConfiguration")</AttributeName>

411

</Attribute>

412

</Attributes>

413

414

<ReturnType>System.Void</ReturnType>

415

</ReturnValue>

416

417

<Docs>

418

<summary>Applies atomically all the configuration changes that were made to the Capture Session since BeginConfiguration.</summary>

419

<remarks>To be added.</remarks>

420

</Docs>

421

</Member>

422

423

424

425

<MemberType>Property</MemberType>

426

427

428

</AssemblyInfo>

429

430

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

431

</ReturnValue>

432

<Docs>

433

<summary>Notification constant for DidStartRunning</summary>

434

<value>NSString constant, should be used as a token to NSNotificationCenter.</value>

435

436

<para id="tool-remark">This constant can be used with the <see cref="T:MonoTouch.Foundation.NSNotificationCenter" /> to register a listener for this notification. This is an NSString instead of a string, because these values can be used as tokens in some native libraries instead of being used purely for their actual string content. The 'notification' parameter to the callback contains extra information that is specific to the notification type.</para>

437

<para id="tool-remark">If you want to subscribe to this notification, you can use the convenience <see cref="T:AVCaptureSession+Notifications" />.<see cref="M:AVCaptureSession+Notifications.ObserveDidStartRunning" /> method which offers strongly typed access to the parameters of the notification.</para>

438

<para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>

439

440

441

442

// Lambda style

443

444

445

// listening

446

notification = AVCaptureSession.Notifications.ObserveDidStartRunning ((sender, args) => {

447

/* Access strongly typed args */

448

Console.WriteLine ("Notification: {0}", args.Notification);

449

});

450

451

// To stop listening:

452

notification.Dispose ();

453

454

455

// Method style

456

457

NSObject notification;

458

void Callback (object sender, DidStartRunning args)

459

{

460

// Access strongly typed args

461

Console.WriteLine ("Notification: {0}", args.Notification);

462

}

463

464

void Setup ()

465

{

466

notification = AVCaptureSession.Notifications.ObserveDidStartRunning (Callback);

467

}

468

469

void Teardown ()

470

{

471

notification.Dispose ();

472

}</code>

473

</example>

474

<para>The following example shows how to use the notification with the DefaultCenter API:</para>

475

476

477

// Lambda style

478

NSNotificationCenter.DefaultCenter.AddObserver (

479

AVCaptureSession.DidStartRunningNotification, (notification) => {Console.WriteLine ("Received the notification AVCaptureSession", notification); }

480

481

482

// Method style

483

void Callback (NSNotification notification)

484

{

485

Console.WriteLine ("Received a notification AVCaptureSession", notification);

486

}

487

488

void Setup ()

489

{

490

NSNotificationCenter.DefaultCenter.AddObserver (AVCaptureSession.DidStartRunningNotification, Callback);

491

}

492

</code>

493

</example>

494

</remarks>

495

</Docs>

496

</Member>

497

498

499

500

<MemberType>Property</MemberType>

501

502

503

</AssemblyInfo>

504

505

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

506

</ReturnValue>

507

<Docs>

508

<summary>Notification constant for DidStopRunning</summary>

509

<value>NSString constant, should be used as a token to NSNotificationCenter.</value>

510

511

512

<para id="tool-remark">If you want to subscribe to this notification, you can use the convenience <see cref="T:AVCaptureSession+Notifications" />.<see cref="M:AVCaptureSession+Notifications.ObserveDidStopRunning" /> method which offers strongly typed access to the parameters of the notification.</para>

513

<para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>

514

515

516

517

// Lambda style

518

519

520

// listening

521

notification = AVCaptureSession.Notifications.ObserveDidStopRunning ((sender, args) => {

522

/* Access strongly typed args */

523

Console.WriteLine ("Notification: {0}", args.Notification);

524

});

525

526

// To stop listening:

527

notification.Dispose ();

528

529

530

// Method style

531

532

NSObject notification;

533

void Callback (object sender, DidStopRunning args)

534

{

535

// Access strongly typed args

536

Console.WriteLine ("Notification: {0}", args.Notification);

537

}

538

539

void Setup ()

540

{

541

notification = AVCaptureSession.Notifications.ObserveDidStopRunning (Callback);

542

}

543

544

void Teardown ()

545

{

546

notification.Dispose ();

547

}</code>

548

</example>

549

<para>The following example shows how to use the notification with the DefaultCenter API:</para>

550

551

552

// Lambda style

553

NSNotificationCenter.DefaultCenter.AddObserver (

554

AVCaptureSession.DidStopRunningNotification, (notification) => {Console.WriteLine ("Received the notification AVCaptureSession", notification); }

555

556

557

// Method style

558

void Callback (NSNotification notification)

559

{

560

Console.WriteLine ("Received a notification AVCaptureSession", notification);

561

}

562

563

void Setup ()

564

{

565

NSNotificationCenter.DefaultCenter.AddObserver (AVCaptureSession.DidStopRunningNotification, Callback);

566

}

567

</code>

568

</example>

569

</remarks>

570

</Docs>

571

</Member>

572

573

574

575

<MemberType>Method</MemberType>

576

577

578

</AssemblyInfo>

579

580

<ReturnType>System.Void</ReturnType>

581

</ReturnValue>

582

583

584

</Parameters>

585

<Docs>

586

587

<para>If set to <see langword="true" />, the method is invoked directly and will dispose manage and unmanaged resources; If set to <see langword="false" /> the method is being called by the garbage collector finalizer and should only release unmanaged resources.</para>

588

</param>

589

<summary>Releases the resources used by the AVCaptureSession object.</summary>

590

591

<para>This Dispose method releases the resources used by the AVCaptureSession class.</para>

592

<para>This method is called by both the Dispose() method and the object finalizer (Finalize). When invoked by the Dispose method, the parameter disposting <paramref name="disposing" /> is set to <see langword="true" /> and any managed object references that this object holds are also disposed or released; when invoked by the object finalizer, on the finalizer thread the value is set to <see langword="false" />. </para>

593

<para>Calling the Dispose method when you are finished using the AVCaptureSession ensures that all external resources used by this managed object are released as soon as possible. Once you have invoked the Dispose method, the object is no longer useful and you should no longer make any calls to it.</para>

594

<para> For more information on how to override this method and on the Dispose/IDisposable pattern, read the ``Implementing a Dispose Method'' document at http://msdn.microsoft.com/en-us/library/fs2xkftw.aspx</para>

595

</remarks>

596

</Docs>

597

</Member>

598

599

600

601

<MemberType>Property</MemberType>

602

603

604

</AssemblyInfo>

605

606

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

607

</ReturnValue>

608

<Docs>

609

<summary>Represents the value associated with the constant AVCaptureSessionErrorKey</summary>

610

<value>

611

</value>

612

<remarks>To be added.</remarks>

613

</Docs>

614

</Member>

615

616

617

618

<MemberType>Property</MemberType>

619

620

621

</AssemblyInfo>

622

623

624

<AttributeName>get: MonoMac.Foundation.Export("inputs")</AttributeName>

625

</Attribute>

626

</Attributes>

627

628

<ReturnType>MonoMac.AVFoundation.AVCaptureInput[]</ReturnType>

629

</ReturnValue>

630

<Docs>

631

<summary>Inputs to the capture session.</summary>

632

<value>To be added.</value>

633

<remarks>To be added.</remarks>

634

</Docs>

635

</Member>

636

637

638

639

<MemberType>Property</MemberType>

640

641

642

</AssemblyInfo>

643

644

645

<AttributeName>get: MonoMac.Foundation.Export("isInterrupted")</AttributeName>

646

</Attribute>

647

</Attributes>

648

649

<ReturnType>System.Boolean</ReturnType>

650

</ReturnValue>

651

<Docs>

652

<summary>Whether the session has been interrupted.</summary>

653

<value>To be added.</value>

654

<remarks>To be added.</remarks>

655

</Docs>

656

</Member>

657

658

659

660

<MemberType>Property</MemberType>

661

662

663

</AssemblyInfo>

664

665

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

666

</ReturnValue>

667

<Docs>

668

<summary>Notification constant for InterruptionEnded</summary>

669

<value>NSString constant, should be used as a token to NSNotificationCenter.</value>

670

671

672

<para id="tool-remark">If you want to subscribe to this notification, you can use the convenience <see cref="T:AVCaptureSession+Notifications" />.<see cref="M:AVCaptureSession+Notifications.ObserveInterruptionEnded" /> method which offers strongly typed access to the parameters of the notification.</para>

673

<para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>

674

675

676

677

// Lambda style

678

679

680

// listening

681

notification = AVCaptureSession.Notifications.ObserveInterruptionEnded ((sender, args) => {

682

/* Access strongly typed args */

683

Console.WriteLine ("Notification: {0}", args.Notification);

684

});

685

686

// To stop listening:

687

notification.Dispose ();

688

689

690

// Method style

691

692

NSObject notification;

693

void Callback (object sender, InterruptionEnded args)

694

{

695

// Access strongly typed args

696

Console.WriteLine ("Notification: {0}", args.Notification);

697

}

698

699

void Setup ()

700

{

701

notification = AVCaptureSession.Notifications.ObserveInterruptionEnded (Callback);

702

}

703

704

void Teardown ()

705

{

706

notification.Dispose ();

707

}</code>

708

</example>

709

<para>The following example shows how to use the notification with the DefaultCenter API:</para>

710

711

712

// Lambda style

713

NSNotificationCenter.DefaultCenter.AddObserver (

714

AVCaptureSession.InterruptionEndedNotification, (notification) => {Console.WriteLine ("Received the notification AVCaptureSession", notification); }

715

716

717

// Method style

718

void Callback (NSNotification notification)

719

{

720

Console.WriteLine ("Received a notification AVCaptureSession", notification);

721

}

722

723

void Setup ()

724

{

725

NSNotificationCenter.DefaultCenter.AddObserver (AVCaptureSession.InterruptionEndedNotification, Callback);

726

}

727

</code>

728

</example>

729

</remarks>

730

</Docs>

731

</Member>

732

733

734

735

<MemberType>Property</MemberType>

736

737

738

</AssemblyInfo>

739

740

741

<AttributeName>get: MonoMac.Foundation.Export("outputs")</AttributeName>

742

</Attribute>

743

</Attributes>

744

745

<ReturnType>MonoMac.AVFoundation.AVCaptureOutput[]</ReturnType>

746

</ReturnValue>

747

<Docs>

748

<summary>Outputs for the capture session.</summary>

749

<value>To be added.</value>

750

<remarks>To be added.</remarks>

751

</Docs>

752

</Member>

753

754

755

756

<MemberType>Property</MemberType>

757

758

759

</AssemblyInfo>

760

761

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

762

</ReturnValue>

763

<Docs>

764

<summary>Represents the value associated with the constant AVCaptureSessionPreset1280x720</summary>

765

<value>

766

</value>

767

<remarks>To be added.</remarks>

768

</Docs>

769

</Member>

770

771

772

773

<MemberType>Property</MemberType>

774

775

776

</AssemblyInfo>

777

778

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

779

</ReturnValue>

780

<Docs>

781

<summary>Represents the value associated with the constant AVCaptureSessionPreset352x288</summary>

782

<value>

783

</value>

784

<remarks>To be added.</remarks>

785

</Docs>

786

</Member>

787

788

789

790

<MemberType>Property</MemberType>

791

792

793

</AssemblyInfo>

794

795

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

796

</ReturnValue>

797

<Docs>

798

<summary>Represents the value associated with the constant AVCaptureSessionPreset640x480</summary>

799

<value>

800

</value>

801

<remarks>To be added.</remarks>

802

</Docs>

803

</Member>

804

805

806

807

<MemberType>Property</MemberType>

808

809

810

</AssemblyInfo>

811

812

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

813

</ReturnValue>

814

<Docs>

815

<summary>Represents the value associated with the constant AVCaptureSessionPresetHigh</summary>

816

<value>

817

</value>

818

<remarks>To be added.</remarks>

819

</Docs>

820

</Member>

821

822

823

824

<MemberType>Property</MemberType>

825

826

827

</AssemblyInfo>

828

829

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

830

</ReturnValue>

831

<Docs>

832

<summary>Represents the value associated with the constant AVCaptureSessionPresetiFrame1280x720</summary>

833

<value>

834

</value>

835

<remarks>To be added.</remarks>

836

</Docs>

837

</Member>

838

839

840

841

<MemberType>Property</MemberType>

842

843

844

</AssemblyInfo>

845

846

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

847

</ReturnValue>

848

<Docs>

849

<summary>Represents the value associated with the constant AVCaptureSessionPresetiFrame960x540</summary>

850

<value>

851

</value>

852

<remarks>To be added.</remarks>

853

</Docs>

854

</Member>

855

856

857

858

<MemberType>Property</MemberType>

859

860

861

</AssemblyInfo>

862

863

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

864

</ReturnValue>

865

<Docs>

866

<summary>Represents the value associated with the constant AVCaptureSessionPresetLow</summary>

867

<value>

868

</value>

869

<remarks>To be added.</remarks>

870

</Docs>

871

</Member>

872

873

874

875

<MemberType>Property</MemberType>

876

877

878

</AssemblyInfo>

879

880

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

881

</ReturnValue>

882

<Docs>

883

<summary>Represents the value associated with the constant AVCaptureSessionPresetMedium</summary>

884

<value>

885

</value>

886

<remarks>To be added.</remarks>

887

</Docs>

888

</Member>

889

890

891

892

<MemberType>Property</MemberType>

893

894

895

</AssemblyInfo>

896

897

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

898

</ReturnValue>

899

<Docs>

900

<summary>Represents the value associated with the constant AVCaptureSessionPresetPhoto</summary>

901

<value>

902

</value>

903

<remarks>To be added.</remarks>

904

</Docs>

905

</Member>

906

907

908

909

<MemberType>Method</MemberType>

910

911

912

</AssemblyInfo>

913

914

915

<AttributeName>MonoMac.Foundation.Export("removeInput:")</AttributeName>

916

</Attribute>

917

</Attributes>

918

919

<ReturnType>System.Void</ReturnType>

920

</ReturnValue>

921

922

923

</Parameters>

924

<Docs>

925

<param name="input">To be added.</param>

926

<summary>Removes the specified input source.</summary>

927

<remarks>To be added.</remarks>

928

</Docs>

929

</Member>

930

931

932

933

<MemberType>Method</MemberType>

934

935

936

</AssemblyInfo>

937

938

939

<AttributeName>MonoMac.Foundation.Export("removeOutput:")</AttributeName>

940

</Attribute>

941

</Attributes>

942

943

<ReturnType>System.Void</ReturnType>

944

</ReturnValue>

945

946

947

</Parameters>

948

<Docs>

949

<param name="output">To be added.</param>

950

<summary>Removes the specified output.</summary>

951

<remarks>To be added.</remarks>

952

</Docs>

953

</Member>

954

955

956

957

<MemberType>Property</MemberType>

958

959

960

</AssemblyInfo>

961

962

963

<AttributeName>get: MonoMac.Foundation.Export("isRunning")</AttributeName>

964

</Attribute>

965

</Attributes>

966

967

<ReturnType>System.Boolean</ReturnType>

968

</ReturnValue>

969

<Docs>

970

<summary>Whether the capture session is currently running.</summary>

971

<value>To be added.</value>

972

<remarks>To be added.</remarks>

973

</Docs>

974

</Member>

975

976

977

978

<MemberType>Property</MemberType>

979

980

981

</AssemblyInfo>

982

983

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

984

</ReturnValue>

985

<Docs>

986

<summary>Notification constant for RuntimeError</summary>

987

<value>NSString constant, should be used as a token to NSNotificationCenter.</value>

988

989

990

<para id="tool-remark">If you want to subscribe to this notification, you can use the convenience <see cref="T:AVCaptureSession+Notifications" />.<see cref="M:AVCaptureSession+Notifications.ObserveRuntimeError" /> method which offers strongly typed access to the parameters of the notification.</para>

991

<para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>

992

993

994

995

// Lambda style

996

997

998

// listening

999

notification = AVCaptureSession.Notifications.ObserveRuntimeError ((sender, args) => {

1000

/* Access strongly typed args */

1001

Console.WriteLine ("Notification: {0}", args.Notification);

1002

1003

Console.WriteLine ("Error", args.Error);

1004

});

1005

1006

// To stop listening:

1007

notification.Dispose ();

1008

1009

1010

// Method style

1011

1012

NSObject notification;

1013

void Callback (object sender, RuntimeError args)

1014

{

1015

// Access strongly typed args

1016

Console.WriteLine ("Notification: {0}", args.Notification);

1017

1018

Console.WriteLine ("Error", args.Error);

1019

}

1020

1021

void Setup ()

1022

{

1023

notification = AVCaptureSession.Notifications.ObserveRuntimeError (Callback);

1024

}

1025

1026

void Teardown ()

1027

{

1028

notification.Dispose ();

1029

}</code>

1030

</example>

1031

<para>The following example shows how to use the notification with the DefaultCenter API:</para>

1032

1033

1034

// Lambda style

1035

NSNotificationCenter.DefaultCenter.AddObserver (

1036

AVCaptureSession.RuntimeErrorNotification, (notification) => {Console.WriteLine ("Received the notification AVCaptureSession", notification); }

1037

1038

1039

// Method style

1040

void Callback (NSNotification notification)

1041

{

1042

Console.WriteLine ("Received a notification AVCaptureSession", notification);

1043

}

1044

1045

void Setup ()

1046

{

1047

NSNotificationCenter.DefaultCenter.AddObserver (AVCaptureSession.RuntimeErrorNotification, Callback);

1048

}

1049

</code>

1050

</example>

1051

</remarks>

1052

</Docs>

1053

</Member>

1054

1055

1056

1057

<MemberType>Property</MemberType>

1058

1059

1060

</AssemblyInfo>

1061

1062

1063

<AttributeName>get: MonoMac.Foundation.Export("sessionPreset")</AttributeName>

1064

</Attribute>

1065

1066

<AttributeName>set: MonoMac.Foundation.Export("setSessionPreset:")</AttributeName>

1067

</Attribute>

1068

</Attributes>

1069

1070

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

1071

</ReturnValue>

1072

<Docs>

1073

<summary>The session preset.</summary>

1074

<value>To be added.</value>

1075

<remarks>To be added.</remarks>

1076

</Docs>

1077

</Member>

1078

1079

1080

1081

<MemberType>Method</MemberType>

1082

1083

1084

</AssemblyInfo>

1085

1086

1087

<AttributeName>MonoMac.Foundation.Export("startRunning")</AttributeName>

1088

</Attribute>

1089

</Attributes>

1090

1091

<ReturnType>System.Void</ReturnType>

1092

</ReturnValue>

1093

1094

<Docs>

1095

<summary>Starts the flow of inputs and outputs.</summary>

1096

<remarks>To be added.</remarks>

1097

</Docs>

1098

</Member>

1099

1100

1101

1102

<MemberType>Method</MemberType>

1103

1104

1105

</AssemblyInfo>

1106

1107

1108

<AttributeName>MonoMac.Foundation.Export("stopRunning")</AttributeName>

1109

</Attribute>

1110

</Attributes>

1111

1112

<ReturnType>System.Void</ReturnType>

1113

</ReturnValue>

1114

1115

<Docs>

1116

<summary>Stops the flow of inputs and outputs.</summary>

1117

<remarks>To be added.</remarks>

1118

</Docs>

1119

</Member>

1120

1121

1122

1123

<MemberType>Property</MemberType>

1124

1125

1126

</AssemblyInfo>

1127

1128

<ReturnType>MonoMac.Foundation.NSString</ReturnType>

1129

</ReturnValue>

1130

<Docs>

1131

<summary>Notification constant for WasInterrupted</summary>

1132

<value>NSString constant, should be used as a token to NSNotificationCenter.</value>

1133

1134

1135

<para id="tool-remark">If you want to subscribe to this notification, you can use the convenience <see cref="T:AVCaptureSession+Notifications" />.<see cref="M:AVCaptureSession+Notifications.ObserveWasInterrupted" /> method which offers strongly typed access to the parameters of the notification.</para>

1136

<para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>

1137

1138

1139

1140

// Lambda style

1141

1142

1143

// listening

1144

notification = AVCaptureSession.Notifications.ObserveWasInterrupted ((sender, args) => {

1145

/* Access strongly typed args */

1146

Console.WriteLine ("Notification: {0}", args.Notification);

1147

});

1148

1149

// To stop listening:

1150

notification.Dispose ();

1151

1152

1153

// Method style

1154

1155

NSObject notification;

1156

void Callback (object sender, WasInterrupted args)

1157

{

1158

// Access strongly typed args

1159

Console.WriteLine ("Notification: {0}", args.Notification);

1160

}

1161

1162

void Setup ()

1163

{

1164

notification = AVCaptureSession.Notifications.ObserveWasInterrupted (Callback);

1165

}

1166

1167

void Teardown ()

1168

{

1169

notification.Dispose ();

1170

}</code>

1171

</example>

1172

<para>The following example shows how to use the notification with the DefaultCenter API:</para>

1173

1174

1175

// Lambda style

1176

NSNotificationCenter.DefaultCenter.AddObserver (

1177

AVCaptureSession.WasInterruptedNotification, (notification) => {Console.WriteLine ("Received the notification AVCaptureSession", notification); }

1178

1179

1180

// Method style

1181

void Callback (NSNotification notification)

1182

{

1183

Console.WriteLine ("Received a notification AVCaptureSession", notification);

1184

}

1185

1186

void Setup ()

1187

{

1188

NSNotificationCenter.DefaultCenter.AddObserver (AVCaptureSession.WasInterruptedNotification, Callback);

1189

}

1190

</code>

1191

</example>

1192

</remarks>

1193

</Docs>

1194

</Member>

1195

</Members>

1196

</Type>

Older »