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

Сводка свойств

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

Сводка методов

Все методыМетоды экземпляраКонкретные методы
Модификатор и тип	Метод	Описание
`ObjectProperty<Camera>`	`cameraProperty()`	Указывает тип использования камеры для отрисовки этого `SubScene`.
`ObjectProperty<Paint>`	`fillProperty()`	Определяет заполнение фона этого `SubScene`.
`SceneAntialiasing`	`getAntiAliasing()`	Возвращает заданное `SceneAntialiasing` для этого `SubScene`.
`Camera`	`getCamera()`	Возвращает значение свойства camera.
`Paint`	`getFill()`	Возвращает значение свойства fill.
`double`	`getHeight()`	Возвращает значение свойства height.
`Parent`	`getRoot()`	Возвращает значение свойства root.
`String`	`getUserAgentStylesheet()`	Возвращает URL пользовательского стиля, который будет использоваться этим SubScene.
`double`	`getWidth()`	Возвращает значение свойства width.
`DoubleProperty`	`heightProperty()`	Определяет высоту этого `SubScene`
`boolean`	`isDepthBuffer()`	Возвращает атрибут буфера глубины для этого `SubScene`.
`ObjectProperty<Parent>`	`rootProperty()`	Определяет корневой `Node` графа сцены `SubScene`.
`void`	`setCamera(Camera value)`	Устанавливает значение свойства camera.
`void`	`setFill(Paint value)`	Устанавливает значение свойства fill.
`void`	`setHeight(double value)`	Устанавливает значение свойства height.
`void`	`setRoot(Parent value)`	Устанавливает значение свойства root.
`void`	`setUserAgentStylesheet(String url)`	Устанавливает URL пользовательского стиля, который будет использоваться этим SubScene вместо платформенного по умолчанию.
`void`	`setWidth(double value)`	Устанавливает значение свойства width.
`ObjectProperty<String>`	`userAgentStylesheetProperty()`
`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, 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, 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 не принимает null в качестве корня.
  
  См. также:
  
  getRoot(), setRoot(Parent)
- camera
```
public final ObjectProperty<Camera> cameraProperty
```
  Указывает тип камеры, используемой для рендеринга этой SubScene. Если camera равно null, для рендеринга используется параллельная камера. Не допускается установка камеры, принадлежащей другому Scene или SubScene.
  Примечание: это условная функция. Подробнее см. ConditionalFeature.SCENE3D.
  
  Значение по умолчанию:
  
  null
  
  См. также:
  
  getCamera(), setCamera(Camera)
- width
```
public final DoubleProperty widthProperty
```
  Определяет ширину этой SubScene
  
  Значение по умолчанию:
  
  0.0
  
  См. также:
  
  getWidth(), setWidth(double)
- height
```
public final DoubleProperty heightProperty
```
  Определяет высоту этой SubScene
  
  Значение по умолчанию:
  
  0.0
  
  См. также:
  
  getHeight(), setHeight(double)
- fill
```
public final ObjectProperty<Paint> fillProperty
```
  Определяет заполнение фоном этой SubScene. Поддерживаются как значение null, означающее отсутствие фона, так и Paint с прозрачностью. Значение по умолчанию — null.
  
  Значение по умолчанию:
  
  null
  
  См. также:
  
  getFill(), setFill(Paint)
- userAgentStylesheet
```
public final ObjectProperty<String> userAgentStylesheetProperty
```
  С:
  
  JavaFX 8u20
  
  См. также:
  
  getUserAgentStylesheet(), setUserAgentStylesheet(String)

Подробности конструкторов
- 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.
  
  Описание свойства:
  
  Определяет корневой Node графа сцены SubScene. Если в качестве корня используется Group, содержимое графа сцены будет обрезано по ширине и высоте SubScene. SubScene не принимает корень со значением null.
- getRoot
```
public final Parent getRoot()
```
  Получает значение свойства root.
  
  Описание свойства:
  
  Определяет корневой Node графа сцены SubScene. Если в качестве корня используется Group, содержимое графа сцены будет обрезано по ширине и высоте SubScene. SubScene не принимает корень со значением null.
- rootProperty
```
public final ObjectProperty<Parent> rootProperty()
```
  Определяет корневой Node графа сцены SubScene. Если в качестве корня используется Group, содержимое графа сцены будет обрезано по ширине и высоте SubScene. SubScene не принимает корень со значением null.
  
  См. также:
  
  getRoot(), setRoot(Parent)
- setCamera
```
public final void setCamera(Camera value)
```
  Устанавливает значение свойства camera.
  
  Описание свойства:
  
  Указывает тип камеры, используемой для рендеринга этой SubScene. Если camera равно null, используется параллельная камера для рендеринга. Запрещено устанавливать камеру, принадлежащую другой Scene или SubScene.
  Примечание: это условная функция. Для получения дополнительной информации см. ConditionalFeature.SCENE3D.
  
  Значение по умолчанию:
  
  null
- getCamera
```
public final Camera getCamera()
```
  Получает значение свойства camera.
  
  Описание свойства:
  
  Указывает тип камеры, используемой для рендеринга этой SubScene. Если camera равно null, используется параллельная камера для рендеринга. Запрещено устанавливать камеру, принадлежащую другой Scene или SubScene.
  Примечание: это условная функция. Для получения дополнительной информации см. ConditionalFeature.SCENE3D.
  
  Значение по умолчанию:
  
  null
- cameraProperty
```
public final ObjectProperty<Camera> cameraProperty()
```
  Указывает тип камеры, используемой для рендеринга этой SubScene. Если camera равно null, используется параллельная камера для рендеринга. Запрещено устанавливать камеру, принадлежащую другой Scene или SubScene.
  Примечание: это условная функция. Для получения дополнительной информации см. ConditionalFeature.SCENE3D.
  
  Значение по умолчанию:
  
  null
  
  См. также:
  
  getCamera(), setCamera(Camera)
- setWidth
```
public final void setWidth(double value)
```
  Устанавливает значение свойства width.
  
  Описание свойства:
  
  Определяет ширину этой SubScene
  
  Значение по умолчанию:
  
  0.0
- getWidth
```
public final double getWidth()
```
  Получает значение свойства width.
  
  Описание свойства:
  
  Определяет ширину этой SubScene
  
  Значение по умолчанию:
  
  0.0
- widthProperty
```
public final DoubleProperty widthProperty()
```
  Определяет ширину этой SubScene
  
  Значение по умолчанию:
  
  0.0
  
  См. также:
  
  getWidth(), setWidth(double)
- setHeight
```
public final void setHeight(double value)
```
  Устанавливает значение свойства height.
  
  Описание свойства:
  
  Определяет высоту этой SubScene
  
  Значение по умолчанию:
  
  0.0
- getHeight
```
public final double getHeight()
```
  Получает значение свойства height.
  
  Описание свойства:
  
  Определяет высоту этой SubScene
  
  Значение по умолчанию:
  
  0.0
- heightProperty
```
public final DoubleProperty heightProperty()
```
  Определяет высоту этой SubScene
  
  Значение по умолчанию:
  
  0.0
  
  См. также:
  
  getHeight(), setHeight(double)
- setFill
```
public final void setFill(Paint value)
```
  Устанавливает значение свойства fill.
  
  Описание свойства:
  
  Определяет фоновый цвет заливки этой SubScene. Поддерживаются как значение null, означающее отсутствие фоновой заливки, так и Paint с прозрачностью. Значение по умолчанию — null.
  
  Значение по умолчанию:
  
  null
- getFill
```
public final Paint getFill()
```
  Получает значение свойства fill.
  
  Описание свойства:
  
  Определяет фоновый цвет заливки этой SubScene. Поддерживаются как значение null, означающее отсутствие фоновой заливки, так и Paint с прозрачностью. Значение по умолчанию — null.
  
  Значение по умолчанию:
  
  null
- fillProperty
```
public final ObjectProperty<Paint> fillProperty()
```
  Определяет фоновый цвет заливки этой SubScene. Поддерживаются как значение null, означающее отсутствие фоновой заливки, так и Paint с прозрачностью. Значение по умолчанию — null.
  
  Значение по умолчанию:
  
  null
  
  См. также:
  
  getFill(), setFill(Paint)
- userAgentStylesheetProperty
```
public final ObjectProperty<String> userAgentStylesheetProperty()
```
  С:
  
  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 не указывает на допустимый ресурс, будет использоваться платформенный стиль по умолчанию.
  Дополнительная информация об использовании CSS с графическим деревом сцены доступна в Руководстве по CSS.
  
  Параметры:
  
  url - URL — иерархический URI вида [схема:][//авторизация][путь]. Если в 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.

Класс SubScene

Сводка свойств

Свойства, унаследованные от класса javafx.scene.Node

Сводка полей

Поля, унаследованные от класса javafx.scene.Node

Сводка конструкторов

Сводка методов

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

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

Методы, унаследованные от интерфейса javafx.css.Styleable

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

root

camera

width

height

fill

userAgentStylesheet

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

SubScene

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

getAntiAliasing

isDepthBuffer

setRoot

getRoot

rootProperty

setCamera

getCamera

cameraProperty

setWidth

getWidth

widthProperty

setHeight

getHeight

heightProperty

setFill

getFill

fillProperty

userAgentStylesheetProperty

getUserAgentStylesheet

setUserAgentStylesheet