Aspose.3D FOSS for Java

के लिए API संदर्भ aspose-3d-foss 26.1.0 (Java 21+, MIT license).

सभी क्लासें स्थित हैं com.aspose.threed रूट पैकेज में। रूट इम्पोर्ट है:

import com.aspose.threed.*;

पैकेज लेआउट: लगभग सभी सार्वजनिक क्लासें स्थित हैं com.aspose.threed. आमतौर पर उपयोग किया जाने वाला एकमात्र सब-पैकेज है com.aspose.threed.shading (के लिए PbrMaterial). यह com.aspose.threed.formats सब-पैकेज में आंतरिक इम्पोर्टर/एक्सपोर्टर होते हैं और आमतौर पर सीधे इम्पोर्ट नहीं किया जाता।.

Java नामकरण सम्मेलन: सभी प्रॉपर्टीज़ गेटर/सेटर मेथड्स का उपयोग करती हैं। उदाहरण के लिए, उपयोग करें node.getTransform() के बजाय node.transform, और transform.setTranslation(...) के बजाय transform.translation = .... नोट करें कि Vector3, Vector4, Quaternion, Matrix4, और FVector प्रकार उपयोग करते हैं सार्वजनिक फ़ील्ड (v.x, v.y, v.z) घटक पहुँच के लिए गेटर्स के बजाय।.


कोर सीन ग्राफ

EnumerationsEnumerations
Sceneसभी 3D सीन डेटा के लिए शीर्ष-स्तर कंटेनर। रूट नोड, एसेट मेटाडेटा, और एनीमेशन क्लिप्स को रखता है। एक्सपोज़ करता है fromFile(), open(), और save() मुख्य I/O प्रवेश बिंदुओं के रूप में।.
Nodeसीन पदानुक्रम में एक नामित नोड। चाइल्ड नोड्स की सूची और संलग्न की गई Entity ऑब्जेक्ट्स जैसे मेषेज़, कैमरे, और लाइट्स। स्थानीय Transform.
Entityसभी ऑब्जेक्ट्स के लिए एब्स्ट्रैक्ट बेस क्लास जो एक Node. नाम और पहचान प्रदान करता है लेकिन अपनी कोई ज्योमेट्री नहीं।.
SceneObjectसाझा बेस क्लास द्वारा Node और Entity. उपयोगकर्ता-परिभाषित मेटाडेटा के लिए उपयोग की जाने वाली प्रॉपर्टी कलेक्शन इंटरफ़ेस प्रदान करता है।.
A3DObjectसभी Aspose.3D प्रबंधित ऑब्जेक्ट्स के लिए मूल बेस क्लास। नाम प्रॉपर्टी को उजागर करता है और Properties कलेक्शन।.
INamedObjectएक इंटरफ़ेस जो गारंटी देता है एक getName() मेथड। द्वारा लागू किया गया Node, Entity, और कई फ़ॉर्मेट-विशिष्ट डिस्क्रिप्टर प्रकार।.

ज्यामिति और मेष

EnumerationsEnumerations
Meshपॉलीगॉन मेष एंटिटी। कंट्रोल पॉइंट्स (वर्टेक्स पोज़िशन को रूप में Vector4), पॉलीगॉन फेस लिस्ट्स (कंट्रोल-पॉइंट इंडेक्स की सूचियाँ), और वर्टेक्स एलिमेंट लेयर्स (नॉर्मल्स, UVs, वर्टेक्स रंग)।.
Geometryमेश-सम प्रकार की ज्योमेट्री के लिए एब्स्ट्रैक्ट बेस। कंट्रोल-पॉइंट एरे और VertexElement लेयर्स का कलेक्शन परिभाषित करता है।. Mesh से विरासत में लेता है Geometry.
VertexElementज्यामिति (नॉर्मल्स, UVs, रंग, आदि) से जुड़ी डेटा लेयर के लिए सारभूत आधार। वह ले जाता है getMappingMode(), getReferenceMode(), और एक डेटा सूची।.
VertexElementNormalमैपिंग मोड के आधार पर प्रत्येक वर्टेक्स या प्रत्येक पॉलीगॉन कोने के लिए एक नॉर्मल वेक्टर संग्रहीत करता है। डेटा मान हैं Vector4 इंस्टेंस के साथ w अप्रयुक्त।.
VertexElementUVटेक्सचर-कोऑर्डिनेट जोड़े संग्रहीत करता है (Vector2) प्रत्येक वर्टेक्स या प्रत्येक पॉलीगॉन कोने के लिए। एक मेष विभिन्न टेक्सचर चैनलों के लिए कई UV लेयर ले जा सकता है।.
VertexElementVertexColorप्रति-वर्टेक्स या प्रति-कोने RGBA रंग डेटा को इस रूप में संग्रहीत करता है Vector4 (r, g, b, a 0–1 की सीमा में)।.
VertexElementTypeएक enumeration जो वर्टेक्स एलिमेंट लेयर की अर्थपूर्ण भूमिका को पहचानती है: NORMAL, UV, VERTEX_COLOR, और अन्य। मानों को पास करें Mesh.getElement().
MappingModeएक enumeration जो नियंत्रित करती है कि वर्टेक्स एलिमेंट मान किस प्रिमिटिव से मैप होता है: CONTROL_POINT, POLYGON_VERTEX, या POLYGON.
ReferenceModeएक enumeration जो नियंत्रित करती है कि मानों को कैसे इंडेक्स किया जाता है: DIRECT (प्रति मैपिंग प्रिमिटिव एक मान) या INDEX_TO_DIRECT (values array और एक अलग indices array).

ट्रांसफ़ॉर्म और स्पैशियल

EnumerationsEnumerations
Transformस्थानीय रूपांतरण जो एक से जुड़ा है Node. अनुवाद, घूर्णन (के रूप में Quaternion), और स्केल घटक, साथ ही Euler angles के लिए सुविधा विधियाँ।.
GlobalTransformसभी पूर्वज ट्रांसफ़ॉर्म को संयोजित करने के बाद नोड के विश्व-स्थान परिवर्तन का केवल‑पढ़ने योग्य दृश्य। एक्सेस किया जाता है द्वारा node.getGlobalTransform().
AssetInfoएक … से जुड़ा मेटाडेटा ब्लॉक Scene. लेखन एप्लिकेशन का नाम, इकाई का नाम, इकाई स्केल फ़ैक्टर, निर्देशांक प्रणाली अक्ष परिभाषाएँ, और निर्माण/संशोधन टाइमस्टैम्प संग्रहीत करता है।.

मैटेरियल्स और शेडिंग

EnumerationsEnumerations
Materialसभी सामग्री प्रकारों के लिए सारभूत बेस क्लास। एक नाम और संख्यात्मक तथा रंग पैरामीटरों के लिए प्रॉपर्टी संग्रह प्रदान करती है।.
PbrMaterialभौतिक रूप से आधारित रेंडरिंग (Physically Based Rendering) सामग्री। अल्बीडो, धातु कारक, रफ़नेस कारक, उत्सर्जित रंग, पारदर्शिता, और संबंधित टेक्सचर संग्रहीत करता है। glTF 2.0 और अन्य PBR‑सक्षम फ़ॉर्मैट द्वारा उपयोग किया जाता है। आयात: com.aspose.threed.shading.PbrMaterial.

Enumerations

EnumerationsEnumerations
Cameraकैमरा एंटिटी। … से विरासत में प्राप्त करता है Entity. विरासत में प्राप्त नाम और प्रॉपर्टी संग्रह के अलावा Java FOSS संस्करण में कोई फ़ॉर्मेट‑विशिष्ट प्रॉपर्टी उजागर नहीं की गई हैं। … से जुड़ा है Node दृष्टिकोण ट्रांसफ़ॉर्म को परिभाषित करने के लिए।.

नोट: Enumerations Light क्लास Java संस्करण में Aspose.3D FOSS का उपलब्ध नहीं है। आयातित फ़ाइलों से सीन लाइटिंग डेटा को सामान्य रूप में संग्रहीत किया जाता है। Entity ऑब्जेक्ट्स।.


गणित उपयोगिताएँ

EnumerationsEnumerations
Vector2डबल‑प्रिसीजन 2‑घटक वेक्टर (x, y). यूवी टेक्सचर कॉर्डिनेट्स के लिए उपयोग किया जाता है।.
Vector3डबल‑प्रिसीजन 3‑घटक वेक्टर (x, y, z). स्थितियों, दिशाओं, और स्केल के लिए उपयोग किया जाता है।.
Vector4डबल‑प्रिसीजन 4‑घटक वेक्टर (x, y, z, w). नियंत्रण बिंदुओं (homogeneous positions) और normal data के लिए उपयोग किया जाता है।.
FVector3Single-precision 3-घटक फ़्लोट वेक्टर। यह normals और tangents के लिए vertex element data arrays में प्रकट होता है।.
FVector4Single-precision 4-घटक फ़्लोट वेक्टर। इसका संग्रह प्रकार VertexElementFVector डेटा।.
Quaternionरोटेशन को दर्शाने के लिए यूनिट क्वाटरनियन (w, x, y, z) द्वारा उपयोग किया जाता है Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxएक्सिस-एलाइन्ड बाउंडिंग बॉक्स जिसे परिभाषित किया गया है getMinimum() और getMaximum() Vector3 कोनों। स्थानिक क्वेरीज़ और फ्रस्टम क्यूलिंग हेल्पर्स के लिए उपयोग किया जाता है।.

Enumerations

EnumerationsEnumerations
AnimationClipएक एनीमेशन रेंज के लिए नामित कंटेनर। एक Scene में कई क्लिप्स रख सकता है (जैसे, “Walk”, “Run”)।. घोषणा स्टब — कीफ़्रेम डेटा और प्लेबैक अभी तक लागू नहीं किए गए हैं।.

फ़ॉर्मेट I/O

EnumerationsEnumerations
Scene.fromFile(path)स्थैतिक मेथड। फ़ाइल को इस स्थान पर खोलता है path, एक्सटेंशन से फ़ॉर्मेट का पता लगाता है, और एक भरा हुआ Scene. फ़ाइल न मिलने या असमर्थित फ़ॉर्मेट पर थ्रो करता है।.
Scene.open(path, options)इंस्टेंस मेथड। एक फ़ाइल को मौजूदा Scene इंस्टेंस में खोलता है, वैकल्पिक रूप से फ़ॉर्मेट-विशिष्ट LoadOptions सबक्लास।.
Scene.save(path, options)इंस्टेंस मेथड। सीन को यहाँ सीरियलाइज़ करता है path एक्सटेंशन से अनुमानित format का उपयोग करके, वैकल्पिक रूप से format-विशिष्ट का उपयोग करते हुए SaveOptions subclass।.
FileFormatसमर्थित file formats का रजिस्ट्री। इसमें entries जैसे FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceफ़ॉर्मेट इम्पोर्टर्स और एक्सपोर्टर्स द्वारा उपयोग किया जाने वाला आंतरिक I/O एब्स्ट्रैक्शन। आमतौर पर एप्लिकेशन कोड द्वारा सीधे उपयोग नहीं किया जाता।.
LoadOptionsसभी फ़ॉर्मेट-विशिष्ट लोड-ऑप्शन ऑब्जेक्ट्स के लिए बेस क्लास। के द्वारा उपवर्गित। ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsसभी फ़ॉर्मेट-विशिष्ट सेव-ऑप्शन ऑब्जेक्ट्स के लिए बेस क्लास। के द्वारा उपवर्गित। ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

OBJ फ़ॉर्मेट

EnumerationsEnumerations
ObjImporterवेवफ़्रंट OBJ और MTL फ़ाइलों को पार्स करने वाली आंतरिक इम्पोर्टर क्लास। इसे स्वचालित रूप से द्वारा कॉल किया जाता है। Scene.fromFile() के लिए .obj एक्सटेंशन।.
ObjLoadOptionsवेवफ़्रंट OBJ फ़ाइलों के लिए लोड विकल्प। मुख्य गुण: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsवेवफ़्रंट OBJ आउटपुट के लिए सेव विकल्प। नॉर्मल्स, UVs, मैटेरियल रेफ़रेंसेज़, और पॉइंट-क्लाउड मोड को नियंत्रित करता है।.
ObjFormatवेवफ़्रंट OBJ के लिए फ़ॉर्मेट डिस्क्रिप्टर। इस रूप में उपलब्ध है FileFormat.WAVEFRONT_OBJ().

STL फ़ॉर्मेट

EnumerationsEnumerations
StlImporterबाइनरी और ASCII दोनों STL फ़ाइलों को पढ़ने वाला आंतरिक इम्पोर्टर। एक्सटेंशन द्वारा स्वचालित रूप से चुना जाता है।.
StlExporterSTL लिखने वाला आंतरिक एक्सपोर्टर।.
StlLoadOptionsSTL फ़ाइलों के लिए लोड विकल्प। समर्थन करता है setFlipCoordinateSystem(), setRecalculateNormal(), और setContentType().
StlSaveOptionsSTL आउटपुट के लिए सेव विकल्प। नियंत्रित करता है setFlipCoordinateSystem(), setAxisSystem(), और setContentType().
StlFormatSTL के लिए फ़ॉर्मेट डिस्क्रिप्टर।.

glTF फ़ॉर्मेट

EnumerationsEnumerations
GltfLoadOptionsglTF 2.0 और GLB फ़ाइलों के लिए लोड विकल्प। प्रमुख गुण: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsglTF 2.0 और GLB आउटपुट के लिए सहेजने के विकल्प। उपयोग करें setContentType(FileContentType.BINARY) एक स्व-समाहित बनाने के लिए .glb पैकेज।.
GltfFormatglTF 2.0 / GLB के लिए फ़ॉर्मेट विवरणक। इसे इस रूप में पहुँचा जा सकता है FileFormat.GLTF2().

FBX फ़ॉर्मेट

FBX का समर्थन है केवल आयात के लिए. FBX में निर्यात Java FOSS संस्करण में उपलब्ध नहीं है।.

EnumerationsEnumerations
FbxLoadOptionsFBX फ़ाइलों के लिए लोड विकल्प। मुख्य गुण: setFlipCoordinateSystem().
FbxFormatFBX के लिए फ़ॉर्मेट विवरणक। इसे इस रूप में पहुँचा जा सकता है FileFormat.FBX7400ASCII().

Enumerations

EnumerationsEnumerations
Axisएक निर्देशांक अक्ष की पहचान करता है: X_AXIS, Y_AXIS, Z_AXIS. निर्देशांक‑प्रणाली पुनःमैपिंग विकल्पों में उपयोग किया जाता है।.
CoordinateSystemहैंडेडनेस सम्मेलन निर्दिष्ट करता है: RIGHT_HANDED या LEFT_HANDED.
TextureMappingयह पहचानता है कि टेक्सचर को ज्यामिति पर कैसे मैप किया जाता है: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, आदि।.
BooleanOperationCSG बूलियन ऑपरेशन प्रकार: UNION, DIFFERENCE, INTERSECTION.

गुण प्रणाली

EnumerationsEnumerations
Propertyएक पर एकल नामित टाइप्ड प्रॉपर्टी A3DObject. प्रॉपर्टी का नाम, टाइप विवरणक, और वर्तमान मान संग्रहीत करता है।.
PropertyCollectionका इटेरेबल संग्रह Property ऑब्जेक्ट्स जो एक से जुड़े हैं A3DObject. नाम द्वारा लुकअप और सभी परिभाषित प्रॉपर्टीज़ पर इटरेशन का समर्थन करता है।.
CustomObjectएक हल्का A3DObject सबक्लास जो केवल एक नाम और एक मनमाना PropertyCollection. उपयोगकर्ता-परिभाषित मेटाडेटा को सीन ऑब्जेक्ट्स पर संग्रहीत करने के लिए उपयोग किया जाता है।.

छवि और रेंडर

EnumerationsEnumerations
ImageRenderOptionssoftware rasterisation के विकल्प जब सीन को image buffer में रेंडर किया जाता है। background colour, image dimensions, और camera reference को संग्रहीत करता है। यह फीचर समर्थित configurations में उपलब्ध है।.

संबंधित देखें

 हिन्दी