Класс SubScene

java.lang.Object

javafx.scene.Node

javafx.scene.SubScene

Все реализуемые интерфейсы:: Styleable, EventTarget

public class SubScene extends Node

Класс SubScene — это контейнер для содержимого в графе сцены. SubScene обеспечивает разделение различных частей сцены, каждая из которых может быть отображена с помощью разных камер, буфера глубины или антиалиасинга сцены. SubScene встраивается в основную сцену или другую подсцену.

Приложение может запросить поддержку буфера глубины или поддержку антиалиасинга сцены при создании SubScene. Подсцена, содержащая только 2D-фигуры и без каких-либо 3D-преобразований, не нуждается в буфере глубины или антиалиасинге сцены. Подсцена, содержащая 3D-фигуры или 2D-фигуры с 3D-преобразованиями, может использовать поддержку буфера глубины для правильного рендеринга с сортировкой по глубине; чтобы избежать борьбы за глубину (также известной как Z-борьба), отключите проверку глубины для 2D-фигур, которые не имеют 3D-преобразований. См. depthTest для получения дополнительной информации. Подсцена с 3D-фигурами может включить антиалиасинг сцены для улучшения качества рендеринга.

Флаги depthBuffer и antiAliasing — это условные функции. Соответствующие значения по умолчанию: false и SceneAntialiasing.DISABLED. См. ConditionalFeature.SCENE3D для получения дополнительной информации.

Возможные варианты использования:

Смешивание 2D и 3D контента
Наложение для элементов управления пользовательского интерфейса
Подложка для фона
Виджет отображения на экране

По умолчанию будет добавлен источник света "прожектор" к SubScene, который содержит один или несколько узлов Shape3D, но не содержит узлов света. Этот источник света представляет собой Color.WHITE PointLight, размещённый в позиции камеры.

С:: JavaFX 8.0

Краткое описание свойств

Тип	Свойство	Описание
`final ObjectProperty<Camera>`	`camera`	Указывает тип камеры, используемой для рендеринга этой `SubScene`.
`final ObjectProperty<Paint>`	`fill`	Определяет заполнение фона этой `SubScene`.
`final DoubleProperty`	`height`	Определяет высоту этой `SubScene`
`final ObjectProperty<Parent>`	`root`	Определяет корневой `Node` графа сцены `SubScene`.
`final ObjectProperty<String>`	`userAgentStylesheet`	Возвращает свойство userAgentStylesheet.
`final DoubleProperty`	`width`	Определяет ширину этой `SubScene`

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, focusVisible, focusWithin, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

Краткое описание полей

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

Краткое описание конструкторов

Конструктор	Описание
`SubScene(Parent root, double width, double height)`	Создаёт `SubScene` для определённого корневого узла с определённым размером.
`SubScene(Parent root, double width, double height, boolean depthBuffer, SceneAntialiasing antiAliasing)`	Создаёт `SubScene`, состоящий из корня, с размером ширины и высоты, указывает, создаётся ли буфер глубины для этой сцены, и указывает, запрашивается ли антиалиасинг сцены.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final ObjectProperty<Camera>`	`cameraProperty()`	Указывает тип камеры, используемой для рендеринга этой `SubScene`.
`final ObjectProperty<Paint>`	`fillProperty()`	Определяет заполнение фона этой `SubScene`.
`final SceneAntialiasing`	`getAntiAliasing()`	Возвращает определённый `SceneAntialiasing` для этой `SubScene`.
`final Camera`	`getCamera()`	Возвращает значение свойства `camera`.
`final Paint`	`getFill()`	Возвращает значение свойства `fill`.
`final double`	`getHeight()`	Возвращает значение свойства `height`.
`final Parent`	`getRoot()`	Возвращает значение свойства `root`.
`final String`	`getUserAgentStylesheet()`	Возвращает URL пользовательского стиля, который будет использоваться этой SubScene.
`final double`	`getWidth()`	Возвращает значение свойства `width`.
`final DoubleProperty`	`heightProperty()`	Определяет высоту этой `SubScene`
`final boolean`	`isDepthBuffer()`	Возвращает атрибут буфера глубины для этой `SubScene`.
`final ObjectProperty<Parent>`	`rootProperty()`	Определяет корневой `Node` графа сцены `SubScene`.
`final void`	`setCamera(Camera value)`	Устанавливает значение свойства `camera`.
`final void`	`setFill(Paint value)`	Устанавливает значение свойства `fill`.
`final void`	`setHeight(double value)`	Устанавливает значение свойства `height`.
`final void`	`setRoot(Parent value)`	Устанавливает значение свойства `root`.
`final void`	`setUserAgentStylesheet(String url)`	Устанавливает URL пользовательского стиля, который будет использоваться этой SubScene вместо платформенно-стандартного.
`final void`	`setWidth(double value)`	Устанавливает значение свойства `width`.
`final ObjectProperty<String>`	`userAgentStylesheetProperty()`	Возвращает свойство userAgentStylesheet.
`final DoubleProperty`	`widthProperty()`	Определяет ширину этой `SubScene`

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBaselineOffset, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClassCssMetaData, getClip, getContentBias, getCssMetaData, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInitialFocusTraversable, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isResizable, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, maxHeight, maxWidth, minHeight, minWidth, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, prefHeight, prefWidth, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, resize, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode

Подробности свойств

root

public final ObjectProperty<Parent> rootProperty

Определяет корневой Node графа сцены. Если в качестве корня используется Group, содержимое графа сцены будет обрезано по ширине и высоте SubScene. SubScene не принимает нулевое значение корня.

См. также:

getRoot()
setRoot(Parent)
rootProperty()

camera

public final ObjectProperty<Camera> cameraProperty

Указывает тип камеры, используемой для отрисовки этого SubScene. Если camera равно null, для отрисовки используется параллельная камера. Запрещено устанавливать камеру, принадлежащую другой Scene или SubScene.

Примечание: это условная функция. Подробности см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

См. также:

getCamera()
setCamera(Camera)
cameraProperty()

width

public final DoubleProperty widthProperty

Определяет ширину этого SubScene

Значение по умолчанию:

0.0

См. также:

getWidth()
setWidth(double)
widthProperty()

height

public final DoubleProperty heightProperty

Определяет высоту этого SubScene

Значение по умолчанию:

0.0

См. также:

getHeight()
setHeight(double)
heightProperty()

fill

public final ObjectProperty<Paint> fillProperty

Определяет фоновый цвет заливки этого SubScene. Поддерживаются как значение null, означающее отсутствие фона, так и Paint с прозрачностью. Значение по умолчанию — null.

Значение по умолчанию:

null

См. также:

getFill()
setFill(Paint)
fillProperty()

userAgentStylesheet

public final ObjectProperty<String> userAgentStylesheetProperty

Получает свойство userAgentStylesheet.

С:

JavaFX 8u20

См. также:

getUserAgentStylesheet()
setUserAgentStylesheet(String)
userAgentStylesheetProperty()

Подробности конструкторов

SubScene

public SubScene(Parent root, double width, double height)

Создает SubScene для определенного узла корня с определенными размерами.

Параметры:: root - корневой узел графа сцены; width - ширина подсцены; height - высота подсцены
Исключения:: NullPointerException - если root равен null

SubScene

public SubScene(Parent root, double width, double height, boolean depthBuffer, SceneAntialiasing antiAliasing)

Создаёт SubScene, состоящий из корня, с размером ширины и высоты, определяет, создаётся ли буфер глубины для этой сцены, и указывает, запрашивается ли сглаживание сцены.

Подсцена, содержащая только 2D-фигуры и без каких-либо 3D-преобразований, не нуждается в буфере глубины или поддержке сглаживания сцены. Подсцена, содержащая 3D-фигуры или 2D-фигуры с 3D-преобразованиями, может использовать поддержку буфера глубины для правильной сортировки отрисовки по глубине; чтобы избежать конфликтов глубины (также известное как Z-борьба), отключите проверку глубины для 2D-фигур, которые не имеют 3D-преобразований. Подробнее см. depthTest. Подсцена с 3D-фигурами может включить сглаживание сцены для улучшения качества отрисовки.

Параметры:

root - корневой узел графа сцены

width - ширина подсцены

height - высота подсцены

depthBuffer - флаг буфера глубины

antiAliasing - атрибут сглаживания подсцены. Значение null обрабатывается как DISABLED.

Флаги depthBuffer и antiAliasing являются условными функциями. С соответствующими значениями по умолчанию: false и SceneAntialiasing.DISABLED. Подробнее см. ConditionalFeature.SCENE3D.

Исключения:

NullPointerException - если root равен null

См. также:

Node.setDepthTest(DepthTest)

Подробности методов

getAntiAliasing

public final SceneAntialiasing getAntiAliasing()

Возвращает заданное SceneAntialiasing для этого SubScene.

Примечание: это условная функция. Подробнее см. ConditionalFeature.SCENE3D и SceneAntialiasing.

Возвращает:: SceneAntialiasing для этой подсцены
С:: JavaFX 8.0

isDepthBuffer

public final boolean isDepthBuffer()

Возвращает атрибут буфера глубины для этой SubScene.

Возвращает:: атрибут буфера глубины.

setRoot

public final void setRoot(Parent value)

Устанавливает значение свойства root.

Описание свойства:

Параметры:

value - значение для свойства root

См. также:

getRoot()
rootProperty()

getRoot

public final Parent getRoot()

Получает значение свойства root.

Описание свойства:

Возвращает:

значение свойства root

См. также:

setRoot(Parent)
rootProperty()

rootProperty

public final ObjectProperty<Parent> rootProperty()

Возвращает:

свойство root

См. также:

getRoot()
setRoot(Parent)

setCamera

public final void setCamera(Camera value)

Устанавливает значение свойства camera.

Описание свойства:

Примечание: это условная функция. Подробнее см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

Параметры:

value - значение для свойства camera

См. также:

getCamera()
cameraProperty()

getCamera

public final Camera getCamera()

Получает значение свойства camera.

Описание свойства:

Примечание: это условная функция. Подробнее см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

Возвращает:

значение свойства camera

См. также:

setCamera(Camera)
cameraProperty()

cameraProperty

public final ObjectProperty<Camera> cameraProperty()

Указывает тип камеры, используемой для отрисовки этого SubScene. Если camera равно null, используется параллельная камера для отрисовки. Запрещено устанавливать камеру, принадлежащую другому Scene или SubScene.

Примечание: эта функция является условной. Дополнительную информацию см. в ConditionalFeature.SCENE3D.

Значение по умолчанию:

null

Возвращает:

свойство camera

См. также:

getCamera()
setCamera(Camera)

setWidth

public final void setWidth(double value)

Устанавливает значение свойства width.

Описание свойства:

Определяет ширину этого SubScene

Значение по умолчанию:

0.0

Параметры:

value - значение для свойства width

См. также:

getWidth()
widthProperty()

getWidth

public final double getWidth()

Получает значение свойства width.

Описание свойства:

Определяет ширину этого SubScene

Значение по умолчанию:

0.0

Возвращает:

значение свойства width

См. также:

setWidth(double)
widthProperty()

widthProperty

public final DoubleProperty widthProperty()

Определяет ширину этого SubScene

Значение по умолчанию:

0.0

Возвращает:

свойство width

См. также:

getWidth()
setWidth(double)

setHeight

public final void setHeight(double value)

Устанавливает значение свойства height.

Описание свойства:

Определяет высоту этого SubScene

Значение по умолчанию:

0.0

Параметры:

value - значение для свойства height

См. также:

getHeight()
heightProperty()

getHeight

public final double getHeight()

Получает значение свойства height.

Описание свойства:

Определяет высоту этого SubScene

Значение по умолчанию:

0.0

Возвращает:

значение свойства height

См. также:

setHeight(double)
heightProperty()

heightProperty

public final DoubleProperty heightProperty()

Определяет высоту этого SubScene

Значение по умолчанию:

0.0

Возвращает:

свойство height

См. также:

getHeight()
setHeight(double)

setFill

public final void setFill(Paint value)

Устанавливает значение свойства fill.

Описание свойства:

Определяет заполнение фона этого SubScene. Поддерживаются оба значения null, означающие отсутствие фона, и Paint с прозрачностью. Значение по умолчанию — null.

Значение по умолчанию:

null

Параметры:

value - значение для свойства fill

См. также:

getFill()
fillProperty()

getFill

public final Paint getFill()

Получает значение свойства fill.

Описание свойства:

Значение по умолчанию:

null

Возвращает:

значение свойства fill

См. также:

setFill(Paint)
fillProperty()

fillProperty

public final ObjectProperty<Paint> fillProperty()

Значение по умолчанию:

null

Возвращает:

свойство fill

См. также:

getFill()
setFill(Paint)

userAgentStylesheetProperty

public final ObjectProperty<String> userAgentStylesheetProperty()

Получает свойство userAgentStylesheet.

Возвращает:

свойство userAgentStylesheet

С:

JavaFX 8u20

См. также:

getUserAgentStylesheet()
setUserAgentStylesheet(String)

getUserAgentStylesheet

public final String getUserAgentStylesheet()

Получает URL пользовательского стиля пользователя, который будет использоваться этим SubScene. Если URL не установлен, будет использоваться пользовательский стиль пользователя по умолчанию для платформы.

Дополнительную информацию об использовании CSS с деревом сцены см. в Руководстве по CSS.

Возвращает:: URL пользовательского стиля пользователя, который будет использоваться этим SubScene, или null, если он не установлен.
С:: JavaFX 8u20

setUserAgentStylesheet

public final void setUserAgentStylesheet(String url)

Устанавливает URL пользовательского стиля пользователя, который будет использоваться этим SubScene вместо пользовательского стиля по умолчанию для платформы. Если URL не указывает на допустимое расположение, будет использоваться пользовательский стиль пользователя по умолчанию для платформы.

URL имеет иерархический формат URI: [схема:][//авторизация][путь]. Если у URL нет компонента [схема:], URL считается только компонентом [путь]. Любой ведущий символ '/' в [пути] игнорируется, и [путь] обрабатывается как путь, относительный к корню пути класса приложения.

Поддерживается схема URL RFC 2397 "data", а также обработчики протоколов, зарегистрированные для приложения. Если URL использует схему "data", а тип MIME пустой, "text/plain" или "text/css", содержимое будет интерпретироваться как файл CSS. Если тип MIME равен "application/octet-stream", содержимое будет интерпретироваться как двоичный файл CSS (см. Stylesheet.convertToBinary(File, File)).

Дополнительную информацию об использовании CSS с деревом сцены см. в Руководстве по CSS.

Параметры:: url - URL пользовательского стиля пользователя
С:: JavaFX 8u20

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.