ImagePlane

Optical image plane properties

Since R2026a

expand all in page

    Description

    Add-On Required: This feature requires the Optical Design and Simulation Library for Image Processing Toolbox add-on.

    An ImagePlane object specifies the properties of an image plane in an optical system, such as its shape, position, and angular orientation. Add an image plane to an optical system using the addImagePlane object function, which creates an ImagePlane object.

    Creation

    There are two ways to create an ImagePlane object.

    • Use the addImagePlane object function when you want to add an image plane as the next component to an optical system in a single command. You can specify its properties, such as surface shape and spatial position, using name-value arguments.

    • Use the optics.component.ImagePlane function described here. Use this function when you want to create an image plane without adding it to the optical system, or modify the properties of an image plane already in the system. After creating the object, you can specify the image plane properties by modifying the properties of the object.

    Syntax

    iplane = optics.component.ImagePlane
    iplane = optics.surface.Surface(PropertyName=Value)

    Description

    iplane = optics.component.ImagePlane creates an ImagePlane object with default properties.

    iplane = optics.surface.Surface(PropertyName=Value) sets writeable properties using one or more name-value arguments.

    Example: optics.component.ImagePlane(Position=[2 0 4]) creates an ImagePlane object representing an image plane at a position [2 0 4] relative to the optical axis.

    Properties

    expand all

    Name of the image plane, specified as a scalar or character vector.

    Shape of the image plane surface, specified as one of these options.

    By default, the shape of the image plane surface is circular, with a semi-diameter of 1.

    Position of the image plane, specified as a 3-element row vector. The vector is in the form [x y z], where each element is the optical system x-, y-, and z-coordinate.

    To learn more about optical coordinate systems, see Coordinate Systems in Optical Design.

    Tilt angles of the image plane, specified as a 3-element row vector. The vector is in the form [θx θy θz], where θx, θy, and θz are tilt angles with respect to the optical system x, y, and z-axes, respectively.

    To learn more about optical coordinate systems, see Coordinate Systems in Optical Design.

    Note

    The TiltAngles property represents Euler angles. If you specify angles that are multiples of 90 degrees, visually verify the orientation of the optical system. Gimbal lock can occur, in which two of the three rotational axes become aligned. This alignment results in the loss of one degree of freedom, and can lead to ambiguous or unintended orientations.

    Version History

    Introduced in R2026a

    See Also

    |