Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class Shape extends Node
Shape
class provides definitions of common properties for
objects that represent some form of geometric shape. These properties
include:
Paint
to be applied to the fillable interior of the
shape (see setFill
).
Paint
to be applied to stroke the outline of the
shape (see setStroke
).
StrokeType
).
On the other hand, stroking those same shapes can often lead to fuzzy outlines because the default stroking attributes specify both that the default stroke width is 1.0 coordinates which often maps to exactly 1 device pixel and also that the stroke should straddle the border of the shape, falling half on either side of the border. Since the borders in many common shapes tend to fall directly on integer coordinates and those integer coordinates often map precisely to integer device locations, the borders tend to result in 50% coverage over the pixel rows and columns on either side of the border of the shape rather than 100% coverage on one or the other. Thus, fills may typically be crisp, but strokes are often fuzzy.
Two common solutions to avoid these fuzzy outlines are to use wider
strokes that cover more pixels completely - typically a stroke width of
2.0 will achieve this if there are no scale transforms in effect - or
to specify either the StrokeType.INSIDE
or StrokeType.OUTSIDE
stroke styles - which will bias the default single unit stroke onto one
of the full pixel rows or columns just inside or outside the border of
the shape.
Type | Property and Description |
---|---|
ObjectProperty<Paint> |
fill
Defines parameters to fill the interior of an
Shape
using the settings of the Paint context. |
BooleanProperty |
smooth
Defines whether antialiasing hints are used or not for this
Shape . |
DoubleProperty |
strokeDashOffset
Defines a distance specified in user coordinates that represents
an offset into the dashing pattern.
|
ObjectProperty<StrokeLineCap> |
strokeLineCap
The end cap style of this
Shape as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT , StrokeLineCap.ROUND ,
and StrokeLineCap.SQUARE . |
ObjectProperty<StrokeLineJoin> |
strokeLineJoin
Defines the decoration applied where path segments meet.
|
DoubleProperty |
strokeMiterLimit
Defines the limit for the
StrokeLineJoin.MITER line join style. |
ObjectProperty<Paint> |
stroke
Defines parameters of a stroke that is drawn around the outline of
a
Shape using the settings of the specified Paint . |
ObjectProperty<StrokeType> |
strokeType
Defines the direction (inside, outside, or both) that the strokeWidth
is applied to the boundary of the shape.
|
DoubleProperty |
strokeWidth
Defines a square pen line width.
|
blendModeProperty, boundsInLocalProperty, boundsInParentProperty, cacheHintProperty, cacheProperty, clipProperty, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectProperty, eventDispatcherProperty, focusedProperty, focusTraversableProperty, hoverProperty, idProperty, inputMethodRequestsProperty, layoutBoundsProperty, layoutXProperty, layoutYProperty, managedProperty, mouseTransparentProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDraggedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onScrollProperty, opacityProperty, parentProperty, pickOnBoundsProperty, pressedProperty, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, styleProperty, translateXProperty, translateYProperty, translateZProperty, visibleProperty
Constructor and Description |
---|
Shape() |
Modifier and Type | Method and Description |
---|---|
ObjectProperty<Paint> |
fillProperty()
Defines parameters to fill the interior of an
Shape
using the settings of the Paint context. |
Paint |
getFill()
Defines parameters to fill the interior of an
Shape
using the settings of the Paint context. |
Paint |
getStroke()
Defines parameters of a stroke that is drawn around the outline of
a
Shape using the settings of the specified Paint . |
ObservableList<java.lang.Double> |
getStrokeDashArray()
Defines the array representing the lengths of the dash segments.
|
double |
getStrokeDashOffset()
Defines a distance specified in user coordinates that represents
an offset into the dashing pattern.
|
StrokeLineCap |
getStrokeLineCap()
The end cap style of this
Shape as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT , StrokeLineCap.ROUND ,
and StrokeLineCap.SQUARE . |
StrokeLineJoin |
getStrokeLineJoin()
Defines the decoration applied where path segments meet.
|
double |
getStrokeMiterLimit()
Defines the limit for the
StrokeLineJoin.MITER line join style. |
StrokeType |
getStrokeType()
Defines the direction (inside, outside, or both) that the strokeWidth
is applied to the boundary of the shape.
|
double |
getStrokeWidth()
Defines a square pen line width.
|
static Shape |
intersect(Shape shape1,
Shape shape2)
Returns a new
Shape which is created as an intersection of the
specified input shapes. |
boolean |
isSmooth()
Defines whether antialiasing hints are used or not for this
Shape . |
void |
setFill(Paint value)
Defines parameters to fill the interior of an
Shape
using the settings of the Paint context. |
void |
setSmooth(boolean value)
Defines whether antialiasing hints are used or not for this
Shape . |
void |
setStroke(Paint value)
Defines parameters of a stroke that is drawn around the outline of
a
Shape using the settings of the specified Paint . |
void |
setStrokeDashOffset(double value)
Defines a distance specified in user coordinates that represents
an offset into the dashing pattern.
|
void |
setStrokeLineCap(StrokeLineCap value)
The end cap style of this
Shape as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT , StrokeLineCap.ROUND ,
and StrokeLineCap.SQUARE . |
void |
setStrokeLineJoin(StrokeLineJoin value)
Defines the decoration applied where path segments meet.
|
void |
setStrokeMiterLimit(double value)
Defines the limit for the
StrokeLineJoin.MITER line join style. |
void |
setStrokeType(StrokeType value)
Defines the direction (inside, outside, or both) that the strokeWidth
is applied to the boundary of the shape.
|
void |
setStrokeWidth(double value)
Defines a square pen line width.
|
BooleanProperty |
smoothProperty()
Defines whether antialiasing hints are used or not for this
Shape . |
DoubleProperty |
strokeDashOffsetProperty()
Defines a distance specified in user coordinates that represents
an offset into the dashing pattern.
|
ObjectProperty<StrokeLineCap> |
strokeLineCapProperty()
The end cap style of this
Shape as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT , StrokeLineCap.ROUND ,
and StrokeLineCap.SQUARE . |
ObjectProperty<StrokeLineJoin> |
strokeLineJoinProperty()
Defines the decoration applied where path segments meet.
|
DoubleProperty |
strokeMiterLimitProperty()
Defines the limit for the
StrokeLineJoin.MITER line join style. |
ObjectProperty<Paint> |
strokeProperty()
Defines parameters of a stroke that is drawn around the outline of
a
Shape using the settings of the specified Paint . |
ObjectProperty<StrokeType> |
strokeTypeProperty()
Defines the direction (inside, outside, or both) that the strokeWidth
is applied to the boundary of the shape.
|
DoubleProperty |
strokeWidthProperty()
Defines a square pen line width.
|
static Shape |
subtract(Shape shape1,
Shape shape2)
Returns a new
Shape which is created by subtracting the specified
second shape from the first shape. |
static Shape |
union(Shape shape1,
Shape shape2)
Returns a new
Shape which is created as a union of the specified
input shapes. |
addEventFilter, addEventHandler, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getBaselineOffset, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragged, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnScroll, getOpacity, getParent, getProperties, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getUserData, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isResizable, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToScene, localToScene, localToScene, lookup, lookupAll, managedProperty, maxHeight, maxWidth, minHeight, minWidth, mouseTransparentProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDraggedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onScrollProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, prefHeight, prefWidth, pressedProperty, relocate, removeEventFilter, removeEventHandler, requestFocus, resize, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragged, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnScroll, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, startDragAndDrop, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, visibleProperty
getStrokeType()
,
setStrokeType(StrokeType)
getStrokeWidth()
,
setStrokeWidth(double)
StrokeLineJoin.BEVEL
, StrokeLineJoin.MITER
,
and StrokeLineJoin.ROUND
.Shape
as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT
, StrokeLineCap.ROUND
,
and StrokeLineCap.SQUARE
.StrokeLineJoin.MITER
line join style.
A value of less than 1.0 will be treated as 1.0.Shape
using the settings of the Paint
context.
The default value is Color.BLACK
for all shapes except
Line, Polyline, and Path. The default value is null
for
those shapes.getFill()
,
setFill(Paint)
Shape
using the settings of the specified Paint
.
The default value is null
for all shapes except
Line, Polyline, and Path. The default value is Color.BLACK
for
those shapes.getStroke()
,
setStroke(Paint)
Shape
.
If the value equals true the rendering hints are applied.isSmooth()
,
setSmooth(boolean)
public final void setStrokeType(StrokeType value)
public final StrokeType getStrokeType()
public final ObjectProperty<StrokeType> strokeTypeProperty()
getStrokeType()
,
setStrokeType(StrokeType)
public final void setStrokeWidth(double value)
public final double getStrokeWidth()
public final DoubleProperty strokeWidthProperty()
getStrokeWidth()
,
setStrokeWidth(double)
public final void setStrokeLineJoin(StrokeLineJoin value)
StrokeLineJoin.BEVEL
, StrokeLineJoin.MITER
,
and StrokeLineJoin.ROUND
.public final StrokeLineJoin getStrokeLineJoin()
StrokeLineJoin.BEVEL
, StrokeLineJoin.MITER
,
and StrokeLineJoin.ROUND
.public final ObjectProperty<StrokeLineJoin> strokeLineJoinProperty()
StrokeLineJoin.BEVEL
, StrokeLineJoin.MITER
,
and StrokeLineJoin.ROUND
.public final void setStrokeLineCap(StrokeLineCap value)
Shape
as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT
, StrokeLineCap.ROUND
,
and StrokeLineCap.SQUARE
.public final StrokeLineCap getStrokeLineCap()
Shape
as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT
, StrokeLineCap.ROUND
,
and StrokeLineCap.SQUARE
.public final ObjectProperty<StrokeLineCap> strokeLineCapProperty()
Shape
as one of the following
values that define possible end cap styles:
StrokeLineCap.BUTT
, StrokeLineCap.ROUND
,
and StrokeLineCap.SQUARE
.public final void setStrokeMiterLimit(double value)
StrokeLineJoin.MITER
line join style.
A value of less than 1.0 will be treated as 1.0.public final double getStrokeMiterLimit()
StrokeLineJoin.MITER
line join style.
A value of less than 1.0 will be treated as 1.0.public final DoubleProperty strokeMiterLimitProperty()
StrokeLineJoin.MITER
line join style.
A value of less than 1.0 will be treated as 1.0.public final void setStrokeDashOffset(double value)
public final double getStrokeDashOffset()
public final DoubleProperty strokeDashOffsetProperty()
public final ObservableList<java.lang.Double> getStrokeDashArray()
Shape
to be stroked,
the user space distance that the pen travels is accumulated.
The distance value is used to index into the dash array.
The pen is opaque when its current cumulative distance maps
to an even element of the dash array and transparent otherwise.
An empty strokeDashArray indicates a solid line with no spaces.public final void setFill(Paint value)
Shape
using the settings of the Paint
context.
The default value is Color.BLACK
for all shapes except
Line, Polyline, and Path. The default value is null
for
those shapes.public final Paint getFill()
Shape
using the settings of the Paint
context.
The default value is Color.BLACK
for all shapes except
Line, Polyline, and Path. The default value is null
for
those shapes.public final ObjectProperty<Paint> fillProperty()
Shape
using the settings of the Paint
context.
The default value is Color.BLACK
for all shapes except
Line, Polyline, and Path. The default value is null
for
those shapes.getFill()
,
setFill(Paint)
public final void setStroke(Paint value)
Shape
using the settings of the specified Paint
.
The default value is null
for all shapes except
Line, Polyline, and Path. The default value is Color.BLACK
for
those shapes.public final Paint getStroke()
Shape
using the settings of the specified Paint
.
The default value is null
for all shapes except
Line, Polyline, and Path. The default value is Color.BLACK
for
those shapes.public final ObjectProperty<Paint> strokeProperty()
Shape
using the settings of the specified Paint
.
The default value is null
for all shapes except
Line, Polyline, and Path. The default value is Color.BLACK
for
those shapes.getStroke()
,
setStroke(Paint)
public final void setSmooth(boolean value)
Shape
.
If the value equals true the rendering hints are applied.public final boolean isSmooth()
Shape
.
If the value equals true the rendering hints are applied.public final BooleanProperty smoothProperty()
Shape
.
If the value equals true the rendering hints are applied.isSmooth()
,
setSmooth(boolean)
public static Shape union(Shape shape1, Shape shape2)
Shape
which is created as a union of the specified
input shapes.
The resulting shape will include areas that were contained in any of the input shapes.
shape1 + shape2 = result +----------------+ +----------------+ +----------------+ |################| |################| |################| |############## | | ##############| |################| |############ | | ############| |################| |########## | | ##########| |################| |######## | | ########| |################| |###### | | ######| |###### ######| |#### | | ####| |#### ####| |## | | ##| |## ##| +----------------+ +----------------+ +----------------+
shape1
- the first shapeshape2
- the second shapeShape
public static Shape subtract(Shape shape1, Shape shape2)
Shape
which is created by subtracting the specified
second shape from the first shape.
The resulting shape will include areas that were contained only in the first shape and not in the second shape.
shape1 - shape2 = result +----------------+ +----------------+ +----------------+ |################| |################| | | |############## | | ##############| |## | |############ | | ############| |#### | |########## | | ##########| |###### | |######## | | ########| |######## | |###### | | ######| |###### | |#### | | ####| |#### | |## | | ##| |## | +----------------+ +----------------+ +----------------+
shape1
- the first shapeshape2
- the second shapeShape
public static Shape intersect(Shape shape1, Shape shape2)
Shape
which is created as an intersection of the
specified input shapes.
The resulting shape will include only areas that were contained in both of the input shapes.
shape1 + shape2 = result +----------------+ +----------------+ +----------------+ |################| |################| |################| |############## | | ##############| | ############ | |############ | | ############| | ######## | |########## | | ##########| | #### | |######## | | ########| | | |###### | | ######| | | |#### | | ####| | | |## | | ##| | | +----------------+ +----------------+ +----------------+
shape1
- the first shapeshape2
- the second shapeShape
Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved. Use is subject to