CentralBodyGraphics =================== .. py:class:: ansys.stk.core.graphics.CentralBodyGraphics The graphical properties associated with a particular central body. Changing the central body graphics will affect how the associated central body is rendered in a scene. For instance, to show or hide the central body, use the show property... .. py:currentmodule:: CentralBodyGraphics Overview -------- .. tab-set:: .. tab-item:: Properties .. list-table:: :header-rows: 0 :widths: auto * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.color` - Get or set the color of the central body in the scene. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.specular_color` - Get or set the specular color of the central body in the scene. The specular color is associated with the specular overlay. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.shininess` - Get or set the shininess of the central body in the scene. The shininess affects the size and brightness of specular reflection associated with the specular overlay. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.show_imagery` - Get or set whether the imagery for central body in the scene is shown or hidden. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.show` - Get or set whether the central body is shown or hidden in the scene. This only affects the central body itself, not the primitives that are associated with it. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.show_label` - Get or set whether a label with the name of the central body should be rendered in the scene when the camera is at certain distance away from the central body. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.altitude_offset` - Get or set the altitude that all terrain and imagery will be offset from the surface of the central body in the scene. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.base_overlay` - Get or set the base globe image overlay associated with the central body in the scene. The base overlay is always rendered before any other imagery... * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.night_overlay` - Get or set the night globe image overlay associated with the central body in the scene. The night overlay is displayed only on parts of the central body that are not in sun light... * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.specular_overlay` - Get or set the specular globe image overlay associated with the central body in the scene. The specular overlay is displayed only in the specular highlight of the central body. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.terrain` - Get the collection of terrain overlay associated with the central body in the scene. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.imagery` - Get the collection of imagery associated with the central body in the scene. * - :py:attr:`~ansys.stk.core.graphics.CentralBodyGraphics.kml` - Get the kml graphics associated with the central body in the scene. Examples -------- Add Imagery and Terrain to the Scene .. code-block:: python # Scenario scenario: Scenario object # Retrieve the boundaries of the imported files manager = scenario.scene_manager # Add Terrain installPath = r"C:\Program Files\AGI\STK 12" if os.name == "nt" else os.environ["STK_INSTALL_DIR"] terrainTile = manager.scenes.item(0).central_bodies.earth.terrain.add_uri_string( os.path.join(installPath, "Data", "Resources", "stktraining", "samples", "SRTM_Skopje.pdtt") ) extentTerrain = terrainTile.extent print( "Terrain boundaries: LatMin: %s LatMax: %s LonMin: %s LonMax: %s" % (str(extentTerrain[0]), str(extentTerrain[2]), str(extentTerrain[1]), str(extentTerrain[3])) ) # Add Imagery imageryTile = manager.scenes.item(0).central_bodies.earth.imagery.add_uri_string( os.path.join(installPath, "Data", "Resources", "stktraining", "imagery", "NPS_OrganPipeCactus_Map.pdttx") ) extentImagery = imageryTile.extent print( "Imagery boundaries: LatMin: %s LatMax: %s LonMin: %s LonMax: %s" % (str(extentImagery[0]), str(extentImagery[2]), str(extentImagery[1]), str(extentImagery[3])) ) Import detail ------------- .. code-block:: python from ansys.stk.core.graphics import CentralBodyGraphics Property detail --------------- .. py:property:: color :canonical: ansys.stk.core.graphics.CentralBodyGraphics.color :type: Color Get or set the color of the central body in the scene. .. py:property:: specular_color :canonical: ansys.stk.core.graphics.CentralBodyGraphics.specular_color :type: Color Get or set the specular color of the central body in the scene. The specular color is associated with the specular overlay. .. py:property:: shininess :canonical: ansys.stk.core.graphics.CentralBodyGraphics.shininess :type: float Get or set the shininess of the central body in the scene. The shininess affects the size and brightness of specular reflection associated with the specular overlay. .. py:property:: show_imagery :canonical: ansys.stk.core.graphics.CentralBodyGraphics.show_imagery :type: bool Get or set whether the imagery for central body in the scene is shown or hidden. .. py:property:: show :canonical: ansys.stk.core.graphics.CentralBodyGraphics.show :type: bool Get or set whether the central body is shown or hidden in the scene. This only affects the central body itself, not the primitives that are associated with it. .. py:property:: show_label :canonical: ansys.stk.core.graphics.CentralBodyGraphics.show_label :type: bool Get or set whether a label with the name of the central body should be rendered in the scene when the camera is at certain distance away from the central body. .. py:property:: altitude_offset :canonical: ansys.stk.core.graphics.CentralBodyGraphics.altitude_offset :type: float Get or set the altitude that all terrain and imagery will be offset from the surface of the central body in the scene. .. py:property:: base_overlay :canonical: ansys.stk.core.graphics.CentralBodyGraphics.base_overlay :type: IGlobeImageOverlay Get or set the base globe image overlay associated with the central body in the scene. The base overlay is always rendered before any other imagery... .. py:property:: night_overlay :canonical: ansys.stk.core.graphics.CentralBodyGraphics.night_overlay :type: IGlobeImageOverlay Get or set the night globe image overlay associated with the central body in the scene. The night overlay is displayed only on parts of the central body that are not in sun light... .. py:property:: specular_overlay :canonical: ansys.stk.core.graphics.CentralBodyGraphics.specular_overlay :type: IGlobeImageOverlay Get or set the specular globe image overlay associated with the central body in the scene. The specular overlay is displayed only in the specular highlight of the central body. .. py:property:: terrain :canonical: ansys.stk.core.graphics.CentralBodyGraphics.terrain :type: TerrainOverlayCollection Get the collection of terrain overlay associated with the central body in the scene. .. py:property:: imagery :canonical: ansys.stk.core.graphics.CentralBodyGraphics.imagery :type: ImageCollection Get the collection of imagery associated with the central body in the scene. .. py:property:: kml :canonical: ansys.stk.core.graphics.CentralBodyGraphics.kml :type: KmlGraphics Get the kml graphics associated with the central body in the scene.