AttitudePointing.md

 ---
 title: AttitudePointing
 ---
+
 This page describes the content of a CZML document. Please read [Get Started](Get-Started) for an explanation of how a CZML document is put together.
 
 # Attitude Pointing
@@ -58,15 +59,15 @@ These arguments can be used to build a attiude pointing object :
 
 **color** - [Color](https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html) : The color of the [Polyline](Polyline) that will link the satellite and the ground.
 
+**alwaysDisplayOnGround** - boolean : Director that manages the pointing or not at objects during the orbit. Put this parameter on `true` if the satellite is pointing at objects during the orbit. This boolean will project the attitude on the ground when it is not pointing at objects. When the attitude is pointing at objects, it will put the projection on the pointed object.
+
 ## Other parameters
 
 **satelliteOrientation** - [Orientation](Orientation) : The orientation object that allows to display the attitude in the czml file.
 
 **attitudePointingPolyline** - [Polyline](Polyline) : The polyline that will be dismlayed to link the ground and the satellite.
 
-**lines** - [List of Line](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Line.html) : A list of line objects that allows to build the direction of the pointing.
-
-\*_projectedAttitudes_ - [List of GeodeticPoint](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/GeodeticPoint.html) : A list of GeodeticPoint object, they represents the projection of the point targeted by the attitude on the surface of the body.
+**projectedAttitudes** - [List of GeodeticPoint](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/GeodeticPoint.html) : A list of GeodeticPoint object, they represents the projection of the point targeted by the attitude on the surface of the body.
 
 **julianDates** - [List of JulianDate](https://cesium.com/learn/cesiumjs/ref-doc/JulianDate.html) : The list of all the JulianDate objects, they represents the julian dates of all instants computed for the attitude pointing.
 
@@ -76,32 +77,24 @@ These arguments can be used to build a attiude pointing object :
 
 **satelliteCartesians** - [List of Cartesian](https://github.com/AnalyticalGraphicsInc/czml-writer/wiki/Cartesian3Value) : The list of the cartesian coordinates of the satellite in the ITR frame.
 
-# Build
+**displayPointingPath** - boolean : To display or not the path of the attitude pointing. By default, `false`.
 
-The attitude pointing object can be build with :
+**displayPeriodPointingPath** - boolean : To display or not the path with a period. By default, `false`.
 
-* A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html) :
+**periodPointingPath** - double : The period in seconds of the path if displayed. By default, 0.0.
 
-```Java
-AttitudePointing pointing = new AttitudePointing(satellite, body, direction);
-```
-
-* A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html), an [availability](https://cesium.com/learn/cesiumjs/ref-doc/TimeInterval.html) :
-
-```Java
-AttitudePointing pointing = new AttitudePointing(satellite, body, direction, availability);
-```
+# Build
 
-* A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html), a [Color](https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html) :
+The attitude pointing object can be build with only a satellite, a body and a direction. In order to build the attitude pointing you should use the [attitude pointing builder](AttitudePointingBuilder), you can use it like this :
 
-```Java
-AttitudePointing pointing = new AttitudePointing(satellite, body, direction, color);
+```java
+final AttitudePointing pointing = AttitudePointing.builder(satellite, body, direction).build();
 ```
 
-* A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html), an [availability](https://cesium.com/learn/cesiumjs/ref-doc/TimeInterval.html), a [Color](https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html) :
+This way you can add a color to the pointing, or an availability like this :
 
-```Java
-AttitudePointing pointing = new AttitudePointing(satellite, body, direction, availability, color);
+```java
+final AttitudePointing pointing = AttitudePointing.builder(satellite, body, direction).withColor(color).withAvailability(availability).build();
 ```
 
 # Functions