Класс Camera

java.lang.Object

javafx.scene.Node

javafx.scene.Camera

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

Прямые известные подклассы:: ParallelCamera, PerspectiveCamera

public abstract class Camera extends Node

Базовый класс для камеры, используемой для отрисовки сцены. Камера определяет отображение координатного пространства сцены на окно. Camera — абстрактный класс с двумя конкретными подклассами: ParallelCamera и PerspectiveCamera.

По умолчанию камера расположена в сцене таким образом, что её плоскость проекции в координатном пространстве сцены находится в Z = 0, и она смотрит на экран в положительном направлении Z. Расстояние по оси Z от камеры до плоскости проекции определяется width и height сцены, к которой она прикреплена, и её fieldOfView.

nearClip и farClip этой камеры задаются в пространстве взгляда. Это пространство определяется таким образом, что глаз находится в его начале координат, а плоскость проекции находится на одном единичном расстоянии перед глазом в положительном направлении Z.

Следующий псевдокод представляет собой математику, используемую для вычисления ближней и дальней плоскостей обрезки в координатном пространстве сцены:

 final double tanOfHalfFOV = Math.tan(Math.toRadians(FOV) / 2.0);
 final double halfHeight = HEIGHT / 2;
 final double focalLenght = halfHeight / tanOfHalfFOV;
 final double eyePositionZ = -1.0 * focalLenght;
 final double nearClipDistance = focalLenght * NEAR + eyePositionZ;
 final double farClipDistance = focalLenght * FAR + eyePositionZ;

где FOV — это fieldOfView в градусах, NEAR — это nearClip, заданное в пространстве взгляда, и FAR — это farClip, заданное в пространстве взгляда.

Примечание: так как класс ParallelCamera не имеет свойства fieldOfView, используется вертикальное поле зрения в 30 градусов.

Примечание: в случае с PerspectiveCamera, где атрибут fixedEyeAtCameraZero имеет значение true, координатное пространство сцены нормализуется для того, чтобы поместиться в усечение обзора (см. PerspectiveCamera для получения дополнительной информации). В этом режиме пространство взгляда совпадает с локальным пространством координат узла Camera. Таким образом, формула преобразования, упомянутая выше, не используется.

Приложение не должно напрямую расширять класс Camera. Это может привести к тому, что будет брошено исключение UnsupportedOperationException.

С момента:: JavaFX 2.0

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

Тип	Свойство	Описание
`final DoubleProperty`	`farClip`	Определяет расстояние от глаза до дальней плоскости обрезки этой `Camera` в пространстве взгляда.
`final DoubleProperty`	`nearClip`	Определяет расстояние от глаза до ближней плоскости обрезки этой `Camera` в пространстве взгляда.

Свойства, объявленные в классе 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

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

Camera()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`final DoubleProperty`	`farClipProperty()`	Определяет расстояние от глаза до дальней плоскости обрезки этой `Camera` в пространстве взгляда.
`final double`	`getFarClip()`	Возвращает значение свойства `farClip`.
`final double`	`getNearClip()`	Возвращает значение свойства `nearClip`.
`final DoubleProperty`	`nearClipProperty()`	Определяет расстояние от глаза до ближней плоскости обрезки этой `Camera` в пространстве взгляда.
`final void`	`setFarClip(double value)`	Устанавливает значение свойства `farClip`.
`final void`	`setNearClip(double value)`	Устанавливает значение свойства `nearClip`.

Методы, объявленные в классе 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

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

nearClip

public final DoubleProperty nearClipProperty

Указывает расстояние от глаза до ближней плоскости обрезания этого Camera в пространстве координат глаза. Объекты, расположенные ближе к глазу, чем nearClip, не отображаются. nearClip задаётся значением, большим нуля. Значение, меньшее или равное нулю, обрабатывается как очень малое положительное число.

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

0.1

С версии:

JavaFX 8.0

См. также:

getNearClip()
setNearClip(double)
nearClipProperty()

farClip

public final DoubleProperty farClipProperty

Указывает расстояние от глаза до дальней плоскости обрезания этого Camera в пространстве координат глаза. Объекты, расположенные дальше от глаза, чем farClip, не отображаются. farClip задаётся значением, большим, чем nearClip. Значение, меньшее или равное nearClip, обрабатывается как nearClip плюс очень малое положительное число.

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

100.0

С версии:

JavaFX 8.0

См. также:

getFarClip()
setFarClip(double)
farClipProperty()

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

Camera

protected Camera()

Конструктор для вызова подклассами.

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

setNearClip

public final void setNearClip(double value)

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

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

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

0.1

Параметры:

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

С версии:

JavaFX 8.0

См. также:

getNearClip()
nearClipProperty()

getNearClip

public final double getNearClip()

Возвращает значение свойства nearClip.

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

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

0.1

Возвращает:

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

С версии:

JavaFX 8.0

См. также:

setNearClip(double)
nearClipProperty()

nearClipProperty

public final DoubleProperty nearClipProperty()

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

0.1

Возвращает:

свойство nearClip

С версии:

JavaFX 8.0

См. также:

getNearClip()
setNearClip(double)

setFarClip

public final void setFarClip(double value)

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

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

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

100.0

Параметры:

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

С версии:

JavaFX 8.0

См. также:

getFarClip()
farClipProperty()

getFarClip

public final double getFarClip()

Возвращает значение свойства farClip.

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

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

100.0

Возвращает:

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

С версии:

JavaFX 8.0

См. также:

setFarClip(double)
farClipProperty()

farClipProperty

public final DoubleProperty farClipProperty()

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

100.0

Возвращает:

свойство farClip

С версии:

JavaFX 8.0

См. также:

getFarClip()
setFarClip(double)

© 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.