javafx.scene

Класс SubScene

java.lang.Object

javafx.scene.Node
- javafx.scene.SubScene

Все реализованные интерфейсы:

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-содержимого
Наложение для элементов управления пользовательского интерфейса
Подложка для фона
Информационное табло

По умолчанию будет добавлен источник света, направленный в центр, если подсцена содержит один или несколько 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, 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, 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, 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, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty

Наследуемые методы от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание свойства
- 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
  
  См. также:
  
  getWidth(), setWidth(double)
- height
```
public final DoubleProperty heightProperty
```
  Определяет высоту этой SubScene
  
  См. также:
  
  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 - Узел-корень графа сцены
  
  Исключения:
  
  NullPointerException - если root равен null
- SubScene
```
public SubScene(Parent root,
                double width,
                double height,
                boolean depthBuffer,
                SceneAntialiasing antiAliasing)
```
  Создаёт SubScene, состоящую из корня, с размерами width и height, указывает, создаётся ли буфер глубины для этой сцены, и запрашивается ли антиалиасинг сцены.
  Подсцена с только 2D-фигурами и без каких-либо 3D-преобразований не нуждается в буфере глубины или поддержке антиалиасинга сцены. Подсцена, содержащая 3D-фигуры или 2D-фигуры с 3D-преобразованиями, может использовать поддержку буфера глубины для правильного рендеринга с сортировкой по глубине; чтобы избежать конфликтов глубины (также известный как Z-конфликт), отключите тестирование глубины для 2D-фигур, не имеющих 3D-преобразований. Для получения дополнительной информации см. depthTest. Подсцена с 3D-фигурами может включить антиалиасинг сцены для повышения качества рендеринга.
  
  Параметры:
  
  root - Узел-корень графа сцены
  
  Исключения:
  
  NullPointerException - если root равен null
  
  См. также:
  
  Node.setDepthTest(DepthTest)

Подробное описание методов
- getAntiAliasing
```
public final SceneAntialiasing getAntiAliasing()
```
  Возвращает заданное SceneAntialiasing для этой SubScene.
  Примечание: эта функция является условной. Для получения дополнительной информации см. ConditionalFeature.SCENE3D и 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
- getWidth
```
public final double getWidth()
```
  Возвращает значение свойства width.
  
  Описание свойства:
  
  Определяет ширину этой SubScene
- widthProperty
```
public final DoubleProperty widthProperty()
```
  Определяет ширину этой SubScene
  
  См. также:
  
  getWidth(), setWidth(double)
- setHeight
```
public final void setHeight(double value)
```
  Устанавливает значение свойства height.
  
  Описание свойства:
  
  Определяет высоту этой SubScene
- getHeight
```
public final double getHeight()
```
  Возвращает значение свойства height.
  
  Описание свойства:
  
  Определяет высоту этой SubScene
- heightProperty
```
public final DoubleProperty heightProperty()
```
  Определяет высоту этой SubScene
  
  См. также:
  
  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

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

root

camera

width

height

fill

userAgentStylesheet

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

SubScene

SubScene

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

getAntiAliasing

isDepthBuffer

setRoot

getRoot

rootProperty

setCamera

getCamera

cameraProperty

setWidth

getWidth

widthProperty

setHeight

getHeight

heightProperty

setFill

getFill

fillProperty

userAgentStylesheetProperty

getUserAgentStylesheet

setUserAgentStylesheet