Camera

Methods: com.aspose.threed (aspose-3d-foss 26.1.0)

Camera یک Entity که یک نقطه‌نظر را در یک صحنهٔ سه‌بعدی تعریف می‌کند. کنترل می‌کند که صحنه چگونه بر روی صفحهٔ تصویر دو‌بعدی پروجکت شود. یک دوربین به یک Node برای موقعیت‌یابی و جهت‌دهی آن در صحنه.

public class Camera extends Entity

Methods

A3DObject -> SceneObject -> Entity -> Camera


نکات پیاده‌سازی

در نسخهٔ Java FOSS، Camera کلاس فقط سازنده‌ها را دارد — هیچ ویژگی خاص دوربین (field-of-view, near/far plane, projection mode) پیاده‌سازی نشده است.

محدودیت صادرات: نهادهای دوربین نوشته نمی‌شوند هنگام صادرات صحنه‌ها. صادرکنندهٔ glTF (GltfExporter) فقط پردازش می‌کند Mesh entities — گره‌های دوربین به‌صورت ساکت نادیده گرفته می‌شوند. این به این معنی است که دوربینی که به یک گره متصل است در هیچ فایل صادرشده‌ای ظاهر نخواهد شد. مثال “Read Camera After Import” در زیر نشان می‌دهد چگونه نام‌های دوربین را از یک فایل واردشده بخوانید؛ اما نوشتن دوربین‌ها به یک فایل جدید در این نسخه پشتیبانی نمی‌شود.


Methods

Camera()
Camera(String name)
NameTypeAccessDescription
apertureModeApertureModeReadGets the aperture mode.
fieldOfViewdoubleReadGets the field of view.
fieldOfViewXdoubleReadGets the field of view x.
fieldOfViewYdoubleReadGets the field of view y.
widthdoubleReadGets the width.
heightdoubleReadGets the height.
aspectRatiodoubleReadGets the aspect ratio.
magnificationVector2ReadGets the magnification.
projectionTypeProjectionTypeReadGets the projection type.
rotationModeRotationModeReadGets the frustum’s orientation mode This property only works when the getTarget() is null.
nearPlanedoubleReadGets the frustum’s near plane distance.
farPlanedoubleReadGets the frustum’s far plane distance.
aspectdoubleReadGets the aspect ratio of the frustum @return the aspect ratio of the frustum /
orthoHeightdoubleReadGets the height when frustum in orthographic projection.
upVector3ReadGets the up direction of the camera @return the up direction of the camera /
lookAtVector3ReadGets the the interested position that the camera is looking at.
directionVector3ReadGets the direction that the camera is looking at.
targetNodeReadGets the target that the camera is looking at.
parentNodeNodeReadGets the parent node.
parentNodesArrayList<Node>ReadGets the parent nodes.
excludedbooleanReadGets the excluded.
boundingBoxBoundingBoxReadGets the bounding box.
sceneSceneReadGets the scene.
nameStringReadGets the name.
propertiesPropertyCollectionReadGets the properties.

Methods

دوربین تمام ویژگی‌ها را از Entity و A3DObject. هیچ ویژگی خاص فرمت اضافی در این نسخه نمایش داده نمی‌شود.

SignatureDescription
Camera()Creates a new camera instance with default name and properties
Camera(projectionType: ProjectionType)Calls Camera(projectionType) on this Camera instance.
Camera(name: String)Calls Camera(name) on this Camera instance.
Camera(name: String, projectionType: ProjectionType)Calls Camera(name, projectionType) on this Camera instance.
getApertureMode()ApertureModeReturns the aperture mode.
setApertureMode(value: ApertureMode)Sets the aperture mode value.
getFieldOfView()doubleReturns the field of view.
setFieldOfView(value: double)Sets the field of view value.
getFieldOfViewX()doubleReturns the field of view x.
setFieldOfViewX(value: double)Sets the field of view x value.
getFieldOfViewY()doubleReturns the field of view y.
setFieldOfViewY(value: double)Sets the field of view y value.
getWidth()doubleReturns the width.
setWidth(value: double)Sets the width value.
getHeight()doubleReturns the height.
setHeight(value: double)Sets the height value.
getAspectRatio()doubleReturns the aspect ratio.
setAspectRatio(value: double)Sets the aspect ratio value.
getMagnification()Vector2Returns the magnification.
setMagnification(value: Vector2)Sets the magnification value.
getProjectionType()ProjectionTypeReturns the projection type.
setProjectionType(value: ProjectionType)Sets the projection type value.
getRotationMode()RotationModeGets the frustum’s orientation mode This property only works when the getTarget() is null.
setRotationMode(value: RotationMode)Sets the frustum’s orientation mode This property only works when the getTarget() is null.
getNearPlane()doubleGets the frustum’s near plane distance.
setNearPlane(value: double)Sets the frustum’s near plane distance.
getFarPlane()doubleGets the frustum’s far plane distance.
setFarPlane(value: double)Sets the frustum’s far plane distance.
getAspect()doubleGets the aspect ratio of the frustum @return the aspect ratio of the frustum /
setAspect(value: double)Sets the aspect ratio of the frustum @param value New value /
getOrthoHeight()doubleGets the height when frustum in orthographic projection.
setOrthoHeight(value: double)Sets the height when frustum in orthographic projection.
getUp()Vector3Gets the up direction of the camera @return the up direction of the camera /
setUp(value: Vector3)Sets the up direction of the camera @param value New value /
getLookAt()Vector3Gets the the interested position that the camera is looking at.
setLookAt(value: Vector3)Sets the the interested position that the camera is looking at.
getDirection()Vector3Gets the direction that the camera is looking at.
setDirection(value: Vector3)Sets the direction that the camera is looking at.
getTarget()NodeGets the target that the camera is looking at.
setTarget(value: Node)Sets the target that the camera is looking at.
Entity()NURBS curve is a curve represented by NURBS(Non-uniform rational basis spline), A NURBS curve is defined by its getOrder(), a set of weighted Geometry.getControlPoints() and a getKnotVectors() The w component in control point is used as control point’s weight, whatever it is a CurveDimension.TWO_DIMENSIONAL or CurveDimension.THREE_DIMENSIONAL
getParentNode()NodeConstructor of instance.
setParentNode(value: Node)The Boolean operator used in the operation to create the result mesh.
getParentNodes()ArrayList<Node>Protected constructor to allow derived classes to set name.
getExcluded()booleanThe Boolean operator used in the operation to create the result mesh.
setExcluded(value: boolean)Sets the excluded value.
getBoundingBox()BoundingBoxThe first operand of the Boolean operator.
SceneObject()Boolean operator allows you to apply Boolean operation on two IMeshConvertible instances.
getScene()SceneConstructor of BooleanOperator.
A3DObject()سیلندر پارامتر شده. همچنین می تواند برای نشان دادن مخروط استفاده شود زمانی که یکی از شعاع بالا / شععه پایین صفر است.
getName()StringThe segments of the curve.
setName(name: String)Constructs a CircleShape profile with specified radius.
getProperties()PropertyCollectionInitializes a new instance of Cylinder class.
findProperty(name: String)PropertyInitializes a new instance of the Bone class.
getProperty(name: String)ObjectGets the transform matrix of the node in current pose.
setProperty(name: String, value: Object)Gets the width segments.
removeProperty(name: String)booleanGets flip coordinate system of control points/normal during importing/exporting.

مثال‌های استفاده

اتصال یک Camera به یک صحنه

import com.aspose.threed.*;

Scene scene = new Scene();

Camera cam = new Camera("MainCamera");

Node node = scene.getRootNode().createChildNode("camera", cam);
node.getTransform().setTranslation(0.0, 5.0, 20.0);

scene.save("scene-with-camera.glb");

خواندن Camera پس از وارد کردن

import com.aspose.threed.*;

Scene scene = new Scene();
scene.open("model.glb");

for (Node node : scene.getRootNode().getChildNodes()) {
    if (node.getEntity() instanceof Camera) {
        Camera cam = (Camera) node.getEntity();
        System.out.println("Camera: " + cam.getName());
    }
}

موارد مرتبط

 فارسی