Free Go Library for 3D Wireframe Drawing

Open Source Go 3D Library for 3D Wireframe Drawing. It allows Software Developers to Render 3D Files with a very simple API for Visualizing Data Structures.

What is Pinhole Library?

Programming is a field that is always changing, providing us with new tools and libraries that expand our skills. The Go programming language's "Pinhole" is a fantastic 3D wireframe drawing package. Software developers may easily start creating beautiful 3D wireframe representations with Pinhole. With the help of the open-source Go package Pinhole, programmers may create complicated 3D wireframe drawings without the need for sophisticated graphics techniques. Because of its intuitive interface, software developers may concentrate on the artistic side of creating visually stunning sceneries. Pinhole is an interesting addition to the Go ecosystem since it makes the world of 3D graphics accessible to both novice and seasoned developers.

Pinhole's user-friendly and intuitive API is one of its best qualities. Without a significant learning curve, developers may quickly convert their ideas into graphics by creating 3D objects, specifying views, and displaying scenes. For Go developers, the library provides access to the captivating realm of 3D wireframe drawing. By removing the complexity of 3D graphics algorithms, Pinhole enables developers to concentrate on the artistic side of creating visually stunning scenarios. The collection encourages you to investigate the potential of 3D wireframe visualization, regardless of your background—educator, designer, artist, or just an inquisitive coder. So why not use the power of "Pinhole" to explore, try new things, and see where your imagination leads you?

At A Glance

An overview of Pinhole features.

Features Overview

Render 3D Scenes
3d geometry
Load 3D models
Creating animations
Render 3D drawings
Loading 3D Models
Mesh simplification
Remeshing animations
3D lattices
Integrate 3D rendering
Handle lighting
Mesh Selections
Handling shadows

Pinhole

Pinhole supports popular 3D file formats listed below.

Reader

OBJ, SVG, HTML

Writer

TXT, SVG, HTML

Pinhole

Platform Independence

Pinhole only requires Go version 1.5 & above.

Go 1.5 and later.

Pinhole

Getting Started with Pinhole

The recommend way to install Pinhole is using GitHub. Please use the following command for a smooth installation.

Install Pinhole API via Get command

$ go get -u github.com/tidwall/pinhole

You can download the compiled shared library from Github repository.

Create and Manage 3D Scene via Go API

The open source Pinhole library allows software developers to create and manage 3D scene inside their own Go applications. The library has included support for several important features, such as creating a basic 3D scene, adding objects, configuring the camera, rendering the scene and many more. The library has provides a variety of primitive 3D shapes that you can use in your scene. It is also possible to create custom objects by defining vertices, edges, or faces and add them to your scene. The following example shows how software developers can create a 3D scene using Go commands.

How to Create a Basic 3D Scene via Go Library?

import "github.com/tidwall/pinhole"

// Initialize the Scene
scene := pinhole.NewScene()

// Create 3D Objects:
cube := pinhole.NewCube()

//create custom objects and added to the scene
triangle := pinhole.NewObject()
triangle.Vertices = []pinhole.Vertex{
    {X: 0, Y: 0, Z: 0},
    {X: 1, Y: 0, Z: 0},
    {X: 0, Y: 1, Z: 0},
}
triangle.Edges = []pinhole.Edge{
    {0, 1},
    {1, 2},
    {2, 0},
}

scene.AddObject(cube)
scene.AddObject(triangle)

// Configure the Camera

camera := pinhole.NewCamera()
camera.Position = pinhole.Vector{X: 0, Y: 0, Z: 5} // Adjust the camera position
camera.Target = pinhole.Vector{X: 0, Y: 0, Z: 0}   // Set the camera's target (where it's looking)
scene.SetCamera(camera)

// Render the Scene and display out

renderer := pinhole.NewRenderer(scene)
renderer.Render()

Rendering Customization & Camera Control

Software Developers can customize the rendering style of wireframe scenes with options for line colors, thickness, and background settings. This flexibility empowers software developers to achieve their desired visual aesthetics. Moreover, the library provides powerful camera controls, enabling software developers to adjust camera position, orientation, and projection settings. This feature allows for dynamic exploration of 3D scenes and enhances user interactivity.

Versatile Object Creation via Go API

The Pinhole library has included a wide range of primitive shapes such as cubes, spheres, and cones, making it easy to create common 3D objects. Additionally, developers can define custom objects by specifying vertices, edges, and faces, allowing for the creation of complex and unique wireframe scenes. Engineers and designers can use the library to quickly prototype and visualize 3D models, aiding in the evaluation of designs and identification of potential issues before committing to full-scale development.

How to Add, Rotate, and Transform a Circle via Go API?

p := pinhole.New()
p.DrawCube(-0.3, -0.3, -0.3, 0.3, 0.3, 0.3)
p.Rotate(math.Pi/3, math.Pi/6, 0)

p.Begin()
p.DrawCircle(0, 0, 0, 0.2)
p.Rotate(0, math.Pi/2, 0)
p.Translate(-0.6, -0.4, 0)
p.Colorize(color.RGBA{255, 0, 0, 255})
p.End()

p.SavePNG("cube.png", 500, 500, nil)