Dark Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Zen-CODE/kivy3dgui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

97 Commits

Repository files navigation

kivy3dgui

Kivy 3D. A pure Kivy library to display and interact with Kivy widgets in a 3D mesh.

If you want to help with the development you can mail me: kpiorno@uci.cu

It's easy to test, just download the code a run the examples. Enjoy it!!!

You can watch a video example here. Another video for Tour3D Example.

How to use

Step 1

Import Layout3D

#:kivy 1.0
#: import Layout3D kivy3dgui.layout3d

Step 2

Creating the Layout3D, it is also possible to do from Python.

Layout3D:
id: par #id for Layout3D, could be referenced just like any Kivy Widget
size_hint: (1.0, 1.0)
canvas_size: (1366, 768) #Canvas resolution
post_processing: False #Post-processing effects (bloom, hdr,...)

Step 3

Creating nodes. Nodes may be a set of 3D meshes (obj format is only supported at now). Be sure to set the UV mapping correctly. If you add a FloatLayout to the node it will be used as texture for the meshes and as a bonus you will be able to interact with the widgets that are seen on the surface of the meshes, no matter the shape. The possibilities are endless. Just use your imagination.

Node:
id: Node1
name: 'Node 0'
rotate: (90, 0.3, 1, 0)
scale: (0.4, 0.4, 0.4)
translate: (20, -10.0, -110)
effect: True
meshes: ("./data/obj/sphere.obj", ) #List of meshes (obj only)

Step 4

Creating interaction widgets. The root widgets for node must be a Layout. All its children will be use as texture of the set of meshes and as aforementioned you will be able to interact with the widgets.

FloatLayout:
canvas:
Color:
rgb: 1, 1, 1,0.1
Rectangle:
size: self.size
pos: self.pos
source: "./data/imgs/background.jpg"
size_hint: (1.0, 1.0)
Button:
pos_hint: {"x":0, "y":0 }
size_hint: (None, None)
text: "Hello"

About

A set of widgets to display and interact with Kivy widgets in a 3D mesh.

Resources

Readme

License

MIT license

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

Languages

  • Python 77.9%
  • GLSL 22.1%