====== XYZ Points Object ====== The XYZ Points object is a general purpose object used to visualize point based data. Points can have many different shapes, colors, and be scaled in all three dimensions. The XYZ Point object visualizes a [[:geoscene3d:project_content:datasets:tabular_dataset|]]. NOTE: The "Refresh Data" button must be pressed to refresh the data from source. The "Apply" button will only affect the visual appearance. ==== General Tab ==== __Name:__ Object name as seen in the Object Manager\\ __Visible:__ Show/Hide the object\\ __Not Editable:__ When checked the object can not be edited and will not be included in the editable objects drop down list\\ __Visible Distance:__ Points beyond this distance will not be visible\\ __Statistics…:__ Shows [[:geoscene3d:project_content:objects:xyz_statistics_dialog|]].\\ __Remark:__ General purpose remark ==== Data Tab ==== __Dataset: __ The XYZ Point object visualizes a [[:geoscene3d:project_content:datasets:tabular_dataset|]]. ==== Geometry Tab ==== **3D Objects (slower) ** \\ Slower 3D performance\\ __Visible:__ If unchecked the points are not visible. This option should only be used when lines are visible.\\ __Point Type:__ Selects the point type or geometry. For some point types the number of slices can be changed. Note: Complex point types especially spheres may have great impact on performance if the dataset contains many points. Point types are cube, cone, dodecahedron, icosahedron, plane, disk, extrusion solid, and freeform. Most object geometries are self explanatory. However, see the description of extrusion solid and freeform below. **Extrusion Solid Point Type ** \\ The Extrusion solid geometry point type makes is possible to show an extruded polygon at every data point position. The polygon node coordinates should be entered in counter-clockwise order. **Freeform Point Type ** \\ With the Freeform geometry point type an imported geometry as in the [[:geoscene3d:project_content:objects:freeform_file|Freeform Object]] can be shown from a [[:geoscene3d:project_content:datasets:freeform_dataset|]] at every data point position. This could be any object, e.g., trees. Beware that complex objects have great impact on performance. **Simple Dots (faster) ** \\ Faster 3D performance\\ __Visible:__ If checked the points are visible as simple dots.\\ __Size (pixels):__ Size of dots in pixels ==== Fit Tab ==== Point centers, tops, or bottoms may be fitted to a surface or a fixed elevation value.\\ __Use Point Elevation (no fitting):__ The point elevation (or depth) from the dataset is used unchanged. The point is fitted to its own native position.\\ __Center Point To Surface:__ Point centers are fitted to a surface.\\ __Below Surface:__ Point tops are fitted to a surface, placing the point immediately below the surface.\\ __Above Surface:__ Point bottoms are fitted to a surface, placing the point immediately above the surface.\\ __Center Point To Elevation:__ Point centers are fitted to a specified elevation.\\ __Below Elevation:__ Point tops are fitted to a specified elevation.\\ __Above Elevation:__ Point bottoms are fitted to a specified elevation.\\ __Fit To Surface:__ Name of surface for use in fitting.\\ __Fit To Elevation:__ Elevation value used for fitting.\\ __Vertical Fit Offset:__ Positive or negative offset applied after fitting. This makes it possible to fit to a surface and show the points at a specified distance from the surface. NOTE: When fitting points above or below a surface or elevation the point Z scale value is used to position the point. When fitting "above" positive values are show above, but negative value are actually shown below. This pattern is opposite when fitting "below". ==== Scale Tab ==== Points are scaled in X, Y, and Z directions using two different scaling modes. In "Absolute" mode the point scale (size) is calculated by multiplying "Factor" with 1 or a "Dataset Field" value. In relative mode the point scale is calculated as relative to "Max Size" (when checking "Relative" the label "Factor" changes to "Max Size"). Relative mode should be used when field values are large. When selecting another Dataset Field you may have to press "Refresh Data" to read the selected field. ==== Material Tab ==== __Color Scale:__ Uses a color scale to color points using a dataset field. Press the "Color Scale…" button to select and/or edit a color scale with the [[:geoscene3d:application:misc:color_scale_editor|]].\\ __Show Legend:__ Show legend form\\ __Single Color:__ All points have the same color. Press the "Color" button to select a color.\\ __Dataset Field:__ The dataset field that is used to color the points using a color scale. When selecting another Dataset Field you may have to press "Refresh Data" to read the selected field.\\ __Opacity:__ Degree of opacity. 1=fully opaque, 0=fully transparent (enabled when Blending Mode = Transparency)\\ __Advanced:__ Shows the advanced [[:geoscene3d:application:misc:material_editor|]] ==== Line Tab ==== Lines may be drawn between points. Points may or may not be visible. The lines are simple 2D lines with no 3D appearance. They have the same width for all distances to the camera.\\ __Color Scale:__ Color lines using the colorscale selected in the Material Tab\\ __Single Color:__ The lines will be drawn with a single color\\ __Color:__ Line color used in single color mode\\ __Line Visible:__ When checked a line is drawn between points.\\ __Antialiased:__ Line is antialiased\\ __Line Width:__ Line width in pixels.\\ __Line Type:__ Type of line: Lines (straight) or Cubic Spline\\ __Separate Line Path Segments:__ Use this option to show multiple polyline segments from a single tabular dataset, e.g., ground water particle paths.\\ __Path ID Field:__ Field in dataset used to deparate path segments ==== Labels Tab ==== **Visibility ** \\ __Visible:__ Show/Hide the labels\\ __Visible Distance:__ Labels are shown within this distance from the camera. Keep low to improve performance. **Scale ** \\ __Horizontal:__ Horizontal text scale factor\\ __Vertical:__ Vertical text scale factor\\ __Depth:__ Text depth scale factor. Effective only when extrusion is greater than zero. **Position And Angle ** \\ __Rotate Towards Camera:__ Labels are rotated towards the active camera. Rotating a lot of labels will have a negative impact on performance.\\ __Rotation Angle:__ When the labels are not rotated towards the camera the label will have this rotation angle.\\ __Vertical Offset:__ Distance from the labeled object to the bottom of the label.\\ __Vertical Angle:__ Label rotation from horizontal (counter clockwise). **Font ** \\ __Font:__ Text font\\ __Color:__ Text color\\ __Text Height:__ Height of text (font size)\\ __Extrusion:__ 3D text depth. **Text Alignment ** \\ __Horizontal:__ Horizontal text alignment\\ __Vertical:__ vertical text alignment __Label Field:__ dataset field to use for label text ==== Profile Tab ==== The Profile tab contains settings used when XYZ Points are shown in [[:geoscene3d:project_content:objects:profile:profile_window|profile windows]]. **Points ** \\ __Horiz. Size:__ Horizontal size of points in pixels.\\ __Vert. Size:__ Vertical size of points in pixels.\\ __Style:__ Point shape **Line ** \\ __Visible:__ Show line between points when checked\\ __Width:__ Line width in pixels\\ __Style:__ Line style **Labels ** \\ __Visible:__ Show/Hide labels for XYZ points\\ __Color:__ Text color\\ __Background:__ Show/Hide text background\\ __Height:__ Text height\\ __Offset:__ Text offset in pixels in the offset direction\\ __Offset direction:__ Offset direction for the label text\\ __Up:__ Above point\\ __Down:__ Below point\\ __Left:__ Left of point\\ __Right:__ Right of point\\ __Orientation:__ Orientation of the label text\\ __Horizontal:__ Horizontal orientation of the label text\\ __Vertical:__ Vertical orientation of the label text **Projection Distance Label ** \\ __Visible:__ Label below point showing the distance the point has been moved when projected on to the profile center plane. Negative when the point is behind the profile and positive when the point is in front of the profile.\\ __Height:__ Text height\\ __Offset:__ Vertical text offset in pixels