Cylinder - Zudokakikuto/OreCZML GitHub Wiki
This page describes the content of a CZMLSecondaryObject document. Please read CZMLSecondaryObject for the intern architecture of CZMLPrimaryObjects.
The cylinder object is used here in order to create a geometric cone to display the Visibility Cone, but has a builder that allows other usages if needed.
Implements : CZMLSecondaryObject
Example :
"cylinder":{
"bottomRadius":10,
"topRadius":31188660.731582925,
"length":3464000,
"material":{
"solidColor":{
"color":{
"rgba":[
0,0,0,0
]
}
}
},
"heightReference":"CLAMP_TO_GROUND"
}
availability - TimeInterval : Time interval when the cylinder is displayed.
lenght - double : The lenght base-to-base of the cylinder. default : (Let a
the semi major axis of the satellite) \frac{a}{2} .
topRadius - double : The radius of the top base of the cylinder. default : lenght * \tan{angleOfAperture} .
bottomRadius - double : The radius of the bottom base of the cylinder. default : 10.0
cesiumHeightReference - CesiumHeightReference : The height reference of an object, which indicates if the object's position is relative to terrain or not. It can take several values :
-
NONE
: The position is absolute. -
CLAMP_TO_GROUND
: -
RELATIVE_TO_GROUND
: The position is clamped to the terrain -
default :
CLAMP_TO_GROUND
: The position height is the height above the terrain.
color - Color : The RGBA color of the cylinder. default : red = 255, green = 255, blue = 255, alpha = 50.
show - boolean : Whether or not the cylinder is shown. default : true.
position - Position : The position of the cylinder in a given frame.
These arguments can be used to build a cylinder object :
angle of aperture - Double : The angle of aperture of the station.
topocentricFrame - TopocentricFrame : An Orekit Topocentric Frame object
The cylinder object can be build with :
- A lenght, a radius of the top base, a radius of the bottom base, a color, a position, a cesiumHeightReference :
Cylinder cylinder = new Cylinder(lenght, topRadius, bottomRadius, color, position, cesiumHeightReference);
- A CZMLGroundStation, a Satellite, an angle of aperture :
Cylinder cylinder = new Cylinder(groundStation, satellite, angleOfAperture);
- A CZMLGroundStation, an angle of aperture :
Cylinder cylinder = new Cylinder(groundStation,angleOfAperture);
- A TopocentricFrame, a Header, an angleOfAperture :
Cylinder cylinder = new Cylinder(topocentricFrame, header, angleOfAperture);