sim3d.sensors.IdealCamera

Capture an image and make it available in MATLAB

Description

Use the sim3d.sensors.IdealCamera class to capture an image with the virtual ideal camera in the 3D simulation environment and return the image to MATLAB^®.

Creation

Syntax

camera = sim3d.sensors.IdealCamera('ActorName',actor)

camera = sim3d.sensors.IdealCamera('ImageSize',[VerticalResolution, HorizontalResolution])

camera = sim3d.sensors.IdealCamera('HorizontalFieldOfView',fieldOfView)

Description

camera = sim3d.sensors.IdealCamera('ActorName',actor) returns a sim3d.sensors.IdealCamera object with the actor specified by ActorName.

camera = sim3d.sensors.IdealCamera('ImageSize',[VerticalResolution, HorizontalResolution]) returns an image of the size specified by 'ImageSize'.

camera = sim3d.sensors.IdealCamera('HorizontalFieldOfView',fieldOfView) returns the horizontal field of view in degrees, specified by 'HorizontalFieldOfView's.

Input Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Camera = sim3d.sensors.IdealCamera('ActorName',Camera2)

'ActorName' — Name of camera actor

'Camera1' (default) | character vector | string

Name of camera actor, specified as a character vector or string.

Example: Camera = sim3d.sensors.IdealCamera('ActorName',Camera2)

'ImageSize' — Image size returned by camera

[768,1024] (default) | 1-by-2 vector of real positive integers

Image size returned by camera, specified as a 1-by-2 vector of real positive integers. The unit is in Pixels.

'HorizontalFieldOfView' — Horizontal field of view in degrees

90 (default) | real nonnegative scalar

Horizontal field of view in degrees, specified as a real nonnegative scalar.

Properties

Parent — Parent of actor

handle to parent sim3d.actor object

Parent of actor, specified as a handle to the parent sim3d.Actor object.

Children — Children of actor

handle to sim3d.actor children object

Children of actor, specified as a handle to the children sim3d.Actor object.

ParentWorld — Parent world method handle

handle to parent sim3d.World object

This property is read only.

Parent world method handle, specified as a handle to the sim3d.World object.

SensorIdentifier — Unique ID of sensor

real positive scalar

Unique ID of the sensor, specified as a real positive scalar.

Data Types: uint32

Translation — Translation of the sensor

[0,0,0] (default) | real 1-by-3 vector

Translation of sensor relative to the parent vehicle, specified as a real 1-by-3 vector, in meters.

Rotation — Rotation of the sensor

[0,0,0] (default) | real 1-by-3 vector

Rotation (roll, pitch, yaw) of sensor relative to the parent vehicle, specified as a real 1-by-3 vector, in radians.

Object Functions

read	Return image captured with camera

Version History

Introduced in R2022b