Main Content


Set or get heading angle of camera for satellite scenario satellite scenario viewer



camheading(viewer,heading) sets the heading angle of the camera for the specified satellite scenario viewer. Setting the heading angle shifts the camera left or right about its z - axis.

Camera with double-headed arrow, pointing left and right in front of lens

outHeading = camheading(viewer,___) returns the heading angle of the camera. If the second input is heading, then the function sets the output equal to the input pitch.


collapse all

Create a satellite scenario object.

sc = satelliteScenario;

Add a ground station to the scenario.

latitude = 42.3001;                         % degrees
longitude = -71.3504;                       % degrees
groundStation(sc, latitude+0.05, longitude);

Launch the Satellite Scenario Viewer.

v = satelliteScenarioViewer(sc);

Set the height of the camera in the Satellite Scenario Viewer to 50 meters.

height = 50;                        % meters

Set the pitch angle of the camera in the Satellite Scenario Viewer to 0 degrees.

pitch = 0;

Set the heading angle of the camera in the Satellite Scenario Viewer to 20 degrees.

heading = 20;         % degrees

Input Arguments

collapse all

Satellite scenario viewer, specified as a satelliteScenarioViewer object. viewer must be specified as a scalar satelliteScenarioViewer object.1

Heading angle of the camera, specified as a scalar value in the range [–360, 360] degrees.


  • When the pitch angle is near –90 (the default value) or 90 degrees, the camera loses one rotational degree of freedom. As a result, when you change the roll angle, the heading angle might change instead. This phenomenon is called gimbal lock. To avoid the effects of gimbal lock, call the camheading function instead of the camroll function.

Version History

Introduced in R2021a

1 Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.