Welcome to Calibur🗡️!

Calibur is a sword against the many inconsistent and ambiguous conventions (viewport origins, depth range, camera coordinate systems, etc.) in computer graphics and vision.

It is a library that translates between these conventions for you. It also hosts as a library of documentation of different conventions and space definitions in CG and CV that would otherwise be hard to find.

Installation

The calibur package can be installed by:

pip install calibur

Tutorial

• Tutorial
  • Definition of Pose
  • Convert between Conventions
  • Detect and Debug Conventions of a Camera
  • Projection and Viewport Transforms
  • Conclusion

Development

Calibur is designed to be light-weight, and only depends on numpy and typing_extensions. However, to run tests, more dependencies are required. To install them:

pip install coverage trimesh opencv-contrib-python

API Reference

• calibur
  • Submodules
    • calibur.resources module
  • Module contents
    • GraphicsNDArray
    • BVH
    • CC
    • CameraConventions
    • Environment
    • NormalCaptureEnvironment
    • NumPyWarning
    • SHEnvironment
    • SampleEnvironments
    • SimpleRayTraceRP
    • WorldConventions
    • backcaster()
    • cast_graphics()
    • caster()
    • compute_tri3d_normals()
    • container_catamorphism()
    • convert_pose()
    • focal_to_fov()
    • fov_to_focal()
    • fov_y_to_x()
    • get_cam_rays_cv()
    • get_dx_viewport_rays()
    • get_ruf_basis()
    • get_view_ray_directions_cv()
    • gl_ndc_to_dx_ndc()
    • gl_ndc_to_dx_viewport()
    • gl_ndc_to_gl_viewport()
    • gl_viewport_to_dx_viewport()
    • homogeneous()
    • intrinsic_cv()
    • linear_depth_gl()
    • magnitude()
    • normalized()
    • point_in_tri2d()
    • projection_gl_persp()
    • sample2d()
    • supercat()
    • transform_point()
    • transform_vector()
    • treemap_backcaster()
    • treemap_cast_graphics()
    • unbind()