101: Data types

This script demonstrates how to use the Easy3D vector classes:

• vec2: Represents 2D points

• vec3: Represents 3D points

• vec4: Represents 4D points

Well come to Python tutorials of Easy3D!
version_major: 2
version_minor: 6
version_patch: 1
version_string: 2.6.1
version_number: 1020601
release_date: 20250119
resource directory: /Users/lnan/Documents/Projects/Easy3D/resources
vec2 as NumPy array: [2. 2.]
vec3 as NumPy array: [3. 3. 3.]
vec4 as NumPy array: [4. 4. 4. 4.]

# -------------------------------------------------------------------------------
# Adding Easy3D Python Bindings to the System Path
# -------------------------------------------------------------------------------
# This is required if the bindings are not installed via `pip` but are located in
# a local build directory. For building and installing Python bindings of Easy3D,
# please refer to: https://github.com/LiangliangNan/Easy3D/blob/main/README.md
# -------------------------------------------------------------------------------
import sys
sys.path.append("../../cmake-build-release/lib/python")  # Update this path to point to your Easy3D build directory.

# -------------------------------------------------------------------------------
# Importing Necessary Libraries
# -------------------------------------------------------------------------------
# In case you encounter an error like "symbol not found in flat namespace '_PyCode_GetVarnames'", this typically
# happens the Python version used to run it doesn't match the Python version used to build the bindings of easy3d.
import easy3d

# -------------------------------------------------------------------------------
# Initializing Easy3D
# -------------------------------------------------------------------------------
# The `easy3d.initialize(False)` function initializes the Easy3D library.
# Use `True` to enable detailed logging, which is useful for debugging.
easy3d.initialize(False)

print("Well come to Python tutorials of Easy3D!")
print(f"version_major: {easy3d.version_major()}")
print(f"version_minor: {easy3d.version_minor()}")
print(f"version_patch: {easy3d.version_patch()}")
print(f"version_string: {easy3d.version_string()}")
print(f"version_number: {easy3d.version_number()}")
print(f"release_date: {easy3d.release_date()}")
print(f"resource directory: {easy3d.resource_directory()}")

# -------------------------------------------------------------------------------
# Creating and Converting a vec2 Object
# -------------------------------------------------------------------------------
# A `vec2` object represents a 2D point. We create a `vec2` object using two values.
# Optionally, the object can also be created using a list: `vec2([x, y])`.
v2 = easy3d.vec2(2.0, 2.0)              # or v2 = easy3d.vec2([2.0, 2.0])

# The `to_numpy()` method converts the `vec2` object into a NumPy array.
np_v2 = v2.to_numpy()  # Convert to NumPy array

# Output the NumPy array representation of the `vec2` object.
print("vec2 as NumPy array:", np_v2)    # Output: [2. 2.]

# -------------------------------------------------------------------------------
# Creating and Converting a vec3 Object
# -------------------------------------------------------------------------------
# A `vec3` object represents a 3D point. We create a `vec3` object using three values.
# Optionally, the object can also be created using a list: `vec3([x, y, z])`.
v3 = easy3d.vec3(3.0, 3.0, 3.0)         # or v3 = easy3d.vec3([3.0, 3.0, 3.0])

# The `to_numpy()` method converts the `vec3` object into a NumPy array.
np_v3 = v3.to_numpy()  # Convert to NumPy array

# Output the NumPy array representation of the `vec3` object.
print("vec3 as NumPy array:", np_v3)    # Output: [3. 3. 3.]

# -------------------------------------------------------------------------------
# Creating and Converting a vec4 Object
# -------------------------------------------------------------------------------
# A `vec4` object represents a 4D point. We create a `vec4` object using four values.
# Optionally, the object can also be created using a list: `vec4([x, y, z, w])`.
v4 = easy3d.vec4(4.0, 4.0, 4.0, 4.0)    # or v4 = easy3d.vec4([4.0, 4.0, 4.0, 4.0])

# The `to_numpy()` method converts the `vec4` object into a NumPy array.
np_v4 = v4.to_numpy()                   # Convert to NumPy array

# Output the NumPy array representation of the `vec4` object.
print("vec4 as NumPy array:", np_v4)    # Output: [4. 4. 4. 4.]