Modify Default Drawing Settings
drawSettings(...)Default settings to modify draw package settings stored in an environment.
A list of the current draw settings with changes.
The following parameters are available to change:
*
units [default = "inches"]: Character value of default measurement unit for applicable draw function parameters (such as width, height, radius, x, y, etc).
arrowAngle [default = 30]: Numeric value of the angle for arrows. Smaller numbers create narrower arrows, and larger numbers produce wider arrows.
arrowLength [default = 0]: Numeric value of the length for arrows.
arrowUnits [default = units]: Character value of the measurement unit for arrows. Default is the same as units parameter under *.
arrowEnds [default = "last"]: Character value indicating which end to draw arrows on lines. Must be one of "last", "first" or "both".
arrowType [default = "open"]: Character value indicating if the arrow heads should be closed or open. Must be one of "open" or "closed".
boxWidth [default = 1]: Numeric value of the width for boxes.
boxHeight [default = 1]: Numeric value of the height for boxes.
boxRadius [default = 0]: Numeric value of the radius for boxes to create rounded corners.
boxFillColor [default = "transparent"]: Character value of the color to fill boxes with.
boxOpacity [default = 1]: Numeric value of transparency for boxes ranging from 0 (transparent) to 1 (non-transparent).
boxLineWidth [default = 1]: Numeric value of the width for the box lines.
boxLineType [default = "solid"]: Character value of the type of line for the boxes. One of "blank", "solid", "dashed", "dotted", "dotdash", "longdash", or "twodash" (see "lty" in par).
boxLineColor [default = "black"]: Character value of the color for the box lines.
circleRadius [default = 0.5]: Numeric value of the radius for circles.
circleFillColor [default = "transparent"]: Character value of the color to fill circles with.
circleOpacity [default = 1]: Numeric value of the transparency for circles ranging from 0 (transparent) to 1 (non-transparent).
circleLineWidth [default = 1]: Numeric value of the width for the circle lines.
circleLineType [default = "solid"]: Character value of the type of line for the circles. One of "blank", "solid", "dashed", "dotted", "dotdash", "longdash", or "twodash" (see "lty" in par).
circleLineColor [default = "black"]: Character value of the color for the circle lines.
curveCurvature [default = 1]: Numeric value of the curvature for the curves. Values of 0 create a straight line, negative values create left-hand curves, and positive values create right-hand curves.
curveAngle [default = 90]: Numeric value of the curve control point skewness ranging from 0 to 180. Values less than 90 skew towards the start point, and values more than 90 skew towards the end point.
curvePoints [default = 1]: Numeric value of the number of control points for the curves, where higher values create smoother curves.
curveShape [default = 0.5]: Numeric value of the shape for the curves ranging from -1 to 1 (See grid.xspline).
curveSquare [default = TRUE]: Logical value indicating whether curve control points are created in a city-block or oblique way. It is recommended to set this to TRUE if curvePoints is 1 and curveAngle is 90, and FALSE otherwise (see grid.curve).
curveSquareShape [default = 1]: Numeric value controlling curve behaviours relative to control points. Applies if curveSquare is TRUE.
curveOpacity [default = 1]: Numeric value of the transparency for the curves ranging from 0 (transparent) to 1 (non-transparent).
curveLineColor [default = "black"]: Character value of the color for the curve lines.
curveLineWidth [default = 1]: Character value of the width for the curve lines.
curveLineType [default = "solid"]: Character value of the type of line for the curves. One of "blank", "solid", "dashed", "dotted", "dotdash", "longdash", or "twodash" (see "lty" in par).
curveInflect [default = FALSE]: Logical value indicating if curve should be cut in half and inverted (TRUE) or not (FALSE).
curveOpen [default = TRUE]: Logical value indicating whether to open the curves (TRUE) or close the curves (FALSE).
exportUnits [default = units]: Character value of measurement unit for exporting. Default is the same as units parameter under *.
exportPPI [default = 150]: Numeric value of the image quality measured in Pixels Per Inch (PPI).
lineOpacity [default = 1]: Numeric value of the transparency of the lines ranging from 0 (transparent) to 1 (non-transparent).
lineWidth [default = 1]: Numeric value of the width of the lines.
lineType [default = "solid"]: Character value of the type for the lines. One of "blank", "solid", "dashed", "dotted", "dotdash", "longdash", or "twodash" (see "lty" in par).
lineColor [default = "black"]: Character value of the color of the lines.
pageWidth [default = 8.5]: Numeric value of the width of the drawing page.
pageHeight [default = 11]: Numeric value of the height of the drawing page.
pointPCH [default = 20]: Numeric value indicating which plotting symbol to use (see points). Some examples include 0 for square, 1 for circle, 2 for triangle, and 4 for X.
pointSize [default = 1]: Numeric value of the point size.
pointFillColor [default = "transparent"]: Character value of the color to fill each point.
pointOpacity [default = 1]: Numeric value of the transparency for the points ranging from 0 (transparent) to 1 (non-transparent).
pointLineColor [default = "black"]: Character value of the color of the points.
pointLineType [default = "solid"]: Character value of the type for the lines. One of "blank", "solid", "dashed", "dotted", "dotdash", "longdash", or "twodash" (see "lty" in par).
pointLineWidth [default = 1]: Numeric value of the width of the point lines.
text [default = "text"]: Character value of the text to display at the defined position.
textJust [default = "centre"]: Character value of the text justification. One of "left", "right", "centre", "center", "bottom", or "top".
textHjust [default = NULL]: Numeric value of the horizontal justification.
textVjust [default = NULL]: Numeric value of the vertical justification.
textAngle [default = 0]: Numeric value of the angle to rotate text.
textOverlap [default = FALSE]: Logical value indicating if overlapping text should be removed (TRUE) or not (FALSE).
textOpacity [default = 1]: Numeric value of the transparency for text ranging from 0 (transparent) to 1 (non-transparent).
textColor [default = "black"]: Character value of the color for text.
textSize [default = 12]: Numeric value of the text font size in pt.
textFace [default = "plain"]: Character value of the text font face. One of "plain", "bold", "italic", "oblique", and "bold.italic" (see fontface in gpar).
textFamily [default = "sans"]: Character value of text font family to use (see family in par). Common values are "serif", "sans" and "mono".
textLineHeight [default = 1.2]: Numeric value of text line height as a multiple of the size of the text.
# NOT RUN {
library(draw)
# Set page dimensions and units to inches
drawSettings(pageWidth = 5, pageHeight = 5, units = "inches")
# Set export resolution in Pixels Per Inch (PPI)
drawSettings(exportPPI = 300)
# Set default width and height for all boxes in inches
drawSettings(boxWidth = 1, boxHeight = 1)
# Create a new drawing page
drawPage()
# Draw default 1 by 1 inch boxes near the center
drawBox(x = 2, y = 2.5)
drawBox(x = 3, y = 2.5)
# Draw a non-default 2 by 2 inch box in the center
drawBox(x = 2.5, y = 2.5, width = 2, height = 2)
# Export the current drawing page
drawExport("drawSettingsExample.pdf")
# }
Run the code above in your browser using DataLab