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.gltf_image_based`
              - Get glTF Image Based properties.
            * - :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.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.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.point_size`
              - A size of the point (in pixels). Dimensionless.
            * - :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.solar_panels_point_at_sun`
              - The model's solar panels are defaulted to point toward the sun.



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:: gltf_image_based
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.gltf_image_based
    :type: Graphics3DModelglTFImageBased

    Get glTF Image Based properties.

.. 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:: 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:: 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:: point_size
    :canonical: ansys.stk.core.stkobjects.SatelliteGraphics3DModel.point_size
    :type: typing.Any

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

.. 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:: 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.