From bc500fe417622a30bf6b2347a4986b3210c6cf5c Mon Sep 17 00:00:00 2001 From: mikeprimm Date: Tue, 14 Jul 2015 09:33:37 -0500 Subject: [PATCH] Updated Using markers (markdown) --- Using-markers.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/Using-markers.md b/Using-markers.md index 00a1480..5a3b352 100644 --- a/Using-markers.md +++ b/Using-markers.md @@ -86,6 +86,42 @@ To delete an area marker, use the `/dmarker deletearea id: set:` command. +### Circle Markers + +Circle markers are used to place 2-D circular (or elliptical) outlines on the world maps. The area defined by a circle marker is defined by a center point (x, y, z) and either a radius (for a circle, via radius setting) or an X vs Z radius (for an ellipse, via radiusx and radiusz setting). + +The appearance of the edges of the outline can be controlled by setting the color attribute (#RRGGBB), line weight (0-N), and opacity (0.0-1.0). The appearance of the filled area within the outlines can be controled by setting the fill color attribute (#RRGGBB), and fill opacity (0.0-1.0). + +A circle marker can be created using the `/dmarker addcircle set:` or `/dmarker addcircle id: set:` commands. Additional attributes can be set with these commands, or later updated using the `/dmarker updatecircle id: set:` or `/dmarker updatecircle set:` command. These settings include: + +* `x` - X coordinate of center (default is current location of player issuing command) + +* `y` - Y coordinate of center (default is current location of player issuing command) + +* `z` - Z coordinate of center (default is current location of player issuing command) + +* `radius` - radius of circle (default is 1) + +* 'radiusx' - radius of ellipse on X axis (default is 1) + +* 'radiusz' - radius of ellipse on Z axis (default is 1) + +* `world` - world of center (default is current location of player issuing command) + +* `color` - outline color (#RRGGBB format) + +* `fillcolor` - fill color (within the outlines) (#RRGGBB format) + +* 'opacity` - Opacity of the outline strokes (0.0 = transparent, 1.0 = solid) + +* 'fillopacity` - Opacity of the filled color areas (0.0 = transparent, 1.0 = solid) + +* `weight` - Stroke weight of outline (0=minimum, higher=thicker) + +To delete a circle marker, use the `/dmarker deletecircle id: set:` command. + +Existing circles, and their attributes, can be shown using the `/dmarker listcircles set:` command. + ### Poly-Line Markers Poly-line markers are used to place a sequence of connected line segments on the world maps. Each poly-line marker is defined by a sequence of 1 or more X,Y,Z coordinates, along with a label, an optional description popup, and associated line color, weight, and opacity settings.