SatelliteGraphics3DModel
========================

.. py:class:: ansys.stk.core.stkobjects.SatelliteGraphics3DModel

   Bases: :py:class:`~ansys.stk.core.stkobjects.IGraphics3DModel`

   All Satellite's VO Model properties.

.. py:currentmodule:: SatelliteGraphics3DModel

Overview
--------

.. tab-set::

    .. tab-item:: Properties

        .. list-table::
            :header-rows: 0
            :widths: auto

            * - :py:attr:`~ansys.stk.core.stkobjects.SatelliteGraphics3DModel.orbit_marker`
              - Define the display of the marker to represent the selected vehicle while traveling along its actual orbit, separate from that of its ground track. The orbit is the actual path that a vehicle follows.
            * - :py:attr:`~ansys.stk.core.stkobjects.SatelliteGraphics3DModel.ground_marker`
              - Define the display of the marker to represent the vehicle's position along its ground track, separate from that of its orbit. The ground track of a vehicle is the portion of the central body's surface that it covers while traveling along its track.
            * - :py:attr:`~ansys.stk.core.stkobjects.SatelliteGraphics3DModel.solar_panels_point_at_sun`
              - The model's solar panels are defaulted to point toward the sun.
            * - :py:attr:`~ansys.stk.core.stkobjects.SatelliteGraphics3DModel.show_point`
              - Whether the point that is shown at certain viewing distances to represent an object, is visible.
            * - :py:attr:`~ansys.stk.core.stkobjects.SatelliteGraphics3DModel.point_size`
              - A size of the point (in pixels). Dimensionless.
            * - :py:attr:`~ansys.stk.core.stkobjects.SatelliteGraphics3DModel.gltf_reflection_map_type`
              - Get or set the glTF reflection map type property. A member of the ModelGltfReflectionMapType enumeration.
            * - :py:attr:`~ansys.stk.core.stkobjects.SatelliteGraphics3DModel.gltf_image_based`
              - Get glTF Image Based properties.



Examples
--------

Change the 3D Model and marker properties

.. code-block:: python

    # Satellite satellite: Satellite object
    model = satellite.graphics_3d.model
    model.model_data.filename = r"STKData\VO\Models\Space\dsp.glb"
    orbitmarker = model.orbit_marker
    if os.name == "nt":
        installPath = r"C:\Program Files\AGI\STK 12"
    else:
        installPath = os.environ["STK_INSTALL_DIR"]
    orbitmarker.set_marker_image_filename(os.path.join(installPath, "STKData", "VO", "Markers", "Satellite.ppm"))
    orbitmarker.marker_data.is_transparent = True
    orbitmarker.pixel_size = 18
    orbitmarker.orientation_mode = Graphics3DMarkerOrientation.FOLLOW_DIRECTION


Import detail
-------------

.. code-block:: python

    from ansys.stk.core.stkobjects import SatelliteGraphics3DModel


Property detail
---------------

.. py:property:: orbit_marker
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.orbit_marker
    :type: Graphics3DMarker

    Define the display of the marker to represent the selected vehicle while traveling along its actual orbit, separate from that of its ground track. The orbit is the actual path that a vehicle follows.

.. py:property:: ground_marker
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.ground_marker
    :type: Graphics3DMarker

    Define the display of the marker to represent the vehicle's position along its ground track, separate from that of its orbit. The ground track of a vehicle is the portion of the central body's surface that it covers while traveling along its track.

.. py:property:: solar_panels_point_at_sun
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.solar_panels_point_at_sun
    :type: bool

    The model's solar panels are defaulted to point toward the sun.

.. py:property:: show_point
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.show_point
    :type: bool

    Whether the point that is shown at certain viewing distances to represent an object, is visible.

.. py:property:: point_size
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.point_size
    :type: typing.Any

    A size of the point (in pixels). Dimensionless.

.. py:property:: gltf_reflection_map_type
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.gltf_reflection_map_type
    :type: ModelGltfReflectionMapType

    Get or set the glTF reflection map type property. A member of the ModelGltfReflectionMapType enumeration.

.. py:property:: gltf_image_based
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.gltf_image_based
    :type: Graphics3DModelglTFImageBased

    Get glTF Image Based properties.